import {z} from 'zod' export type CreateApiPublicV1TrackingSearchArgs = {body: {trackingNumber?: string | undefined, originCountryCode?: unknown | undefined, destinationCountryCode?: unknown | undefined, destinationPostCode?: string | undefined, shippingDate?: string | undefined, courierCode?: (Array | string) | undefined}}; export type CreateApiPublicV1TrackingSearchOptions = {baseUrl?: string | undefined, Authorization?: string | undefined, fetch?: typeof fetch | undefined}; export const shipment = z.object({shipmentId: z.string().nullable().optional(), statusCode: z.string().nullable().optional(), statusCategory: z.string().nullable().optional(), statusMilestone: z.string().optional(), originCountryCode: z.string().nullable().optional(), destinationCountryCode: z.string().nullable().optional(), delivery: z.object({estimatedDeliveryDate: z.string().nullable().optional(), service: z.string().nullable().optional(), signedBy: z.string().nullable().optional()}).optional(), trackingNumbers: z.array(z.object({tn: z.string().optional()})).optional(), recipient: z.object({name: z.string().nullable().optional(), address: z.string().nullable().optional(), postCode: z.string().nullable().optional(), city: z.string().nullable().optional(), subdivision: z.string().nullable().optional()}).nullable().optional()}); export const event = z.object({eventId: z.string().optional(), trackingNumber: z.string().optional(), eventTrackingNumber: z.string().optional(), status: z.string().nullable().optional(), occurrenceDatetime: z.string().optional(), order: z.number().int().nullable().optional(), location: z.string().nullable().optional(), sourceCode: z.string().nullable().optional(), courierCode: z.string().nullable().optional(), statusCode: z.string().nullable().optional(), statusCategory: z.string().nullable().optional(), statusMilestone: z.string().optional(), datetime: z.string().optional(), utcOffset: z.string().optional(), hasNoTime: z.boolean().optional()}); export const statistics = z.object({timestamps: z.object({infoReceivedDatetime: z.string().nullable().optional(), inTransitDatetime: z.string().nullable().optional(), outForDeliveryDatetime: z.string().nullable().optional(), failedAttemptDatetime: z.string().nullable().optional(), availableForPickupDatetime: z.string().nullable().optional(), exceptionDatetime: z.string().nullable().optional(), deliveredDatetime: z.string().nullable().optional()}).optional()}); export const createApiPublicV1TrackingSearchResponse = z.object({data: z.object({trackings: z.array(z.object({shipment: shipment.optional(), events: z.array(event).optional(), statistics: statistics.optional()})).optional()}).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get tracking results by tracking number * * POST /public/v1/tracking/search */ export const createApiPublicV1TrackingSearch = async (args: CreateApiPublicV1TrackingSearchArgs, options?: CreateApiPublicV1TrackingSearchOptions) => { const {baseUrl = "https://api.ship24.com", fetch: fetchFn = fetch, Authorization} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (Authorization !== undefined) headers.set("Authorization", Authorization) const url = `${baseUrl.replace(/\/+$/, '')}/public/v1/tracking/search${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(createApiPublicV1TrackingSearchResponse, await res.json()) };