import {z} from 'zod' export type CreateApiApiV1AdminShipmentsShipmentIdRefreshTrackingArgs = {shipment_id: string}; export type CreateApiApiV1AdminShipmentsShipmentIdRefreshTrackingOptions = {baseUrl: string, OAuth2PasswordBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const shipmentStatus = z.enum(["pending", "processing", "ready_to_ship", "shipped", "in_transit", "out_for_delivery", "delivered", "failed_delivery", "returned", "cancelled"]); export const labelStatus = z.enum(["not_created", "creating", "created", "voiding", "voided", "failed"]); export const carrierSyncStatus = z.enum(["never_synced", "syncing", "synced", "failed"]); export const shippingAddressSnapshot = z.object({name: z.string().nullable().optional(), company: z.string().nullable().optional(), contact_name: z.string().nullable().optional(), phone: z.string().nullable().optional(), email: z.string().nullable().optional(), address_line1: z.string().nullable().optional(), address_line2: z.string().nullable().optional(), city: z.string().nullable().optional(), state: z.string().nullable().optional(), postal_code: z.string().nullable().optional(), country: z.string().nullable().optional()}); export const shipmentEventResponse = z.object({id: z.string(), shipment_id: z.string(), status: z.string(), description: z.string(), location: z.string().nullable().optional(), occurred_at: z.string(), created_at: z.string()}); export const shipmentPackageSource = z.enum(["manual", "inbound_seeded"]); export const shipmentPackageResponse = z.object({id: z.string(), shipment_id: z.string(), package_index: z.number().int(), weight: z.string().nullable().optional(), weight_unit: z.string().nullable().optional(), length: z.string().nullable().optional(), width: z.string().nullable().optional(), height: z.string().nullable().optional(), dimension_unit: z.string().nullable().optional(), contents_summary: z.string().nullable().optional(), source: shipmentPackageSource, source_inbound_package_id: z.string().nullable().optional(), carrier_package_id: z.string().nullable().optional(), tracking_number: z.string().nullable().optional(), tracking_url: z.string().nullable().optional(), label_status: labelStatus, label_pdf_url: z.string().nullable().optional(), label_format: z.string().nullable().optional(), label_created_at: z.string().nullable().optional(), label_voided_at: z.string().nullable().optional(), label_cost_cents: z.number().int().nullable().optional(), label_currency: z.string().nullable().optional(), created_at: z.string(), updated_at: z.string()}); export const carrierCode = z.enum(["ups", "dhl", "fedex", "usps", "other"]); export const pickupStatus = z.enum(["not_scheduled", "scheduled", "cancelled", "failed"]); export const shipmentPickupResponse = z.object({id: z.string(), shipment_id: z.string(), carrier: carrierCode, pickup_confirmation_number: z.string().nullable().optional(), status: pickupStatus, window_start: z.string().nullable().optional(), window_end: z.string().nullable().optional(), location: z.string().nullable().optional(), instructions: z.string().nullable().optional(), cancelled_at: z.string().nullable().optional(), created_at: z.string(), updated_at: z.string()}); export const outboundShipmentResponse = z.object({id: z.string(), project_id: z.string(), carrier: z.string().nullable().optional(), carrier_code: z.string().nullable().optional(), carrier_service_code: z.string().nullable().optional(), carrier_shipment_id: z.string().nullable().optional(), tracking_number: z.string().nullable().optional(), tracking_url: z.string().nullable().optional(), status: shipmentStatus, estimated_delivery: z.string().nullable().optional(), actual_delivery: z.string().nullable().optional(), shipped_at: z.string().nullable().optional(), notes: z.string().nullable().optional(), label_status: labelStatus, tracking_sync_status: carrierSyncStatus, tracking_last_synced_at: z.string().nullable().optional(), tracking_sync_error: z.string().nullable().optional(), origin_snapshot: shippingAddressSnapshot.nullable().optional(), destination_snapshot: shippingAddressSnapshot.nullable().optional(), events: z.array(shipmentEventResponse).optional(), packages: z.array(shipmentPackageResponse).optional(), pickups: z.array(shipmentPickupResponse).optional(), created_at: z.string(), updated_at: z.string()}); 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 }; /** * Refresh Outbound Tracking * * POST /api/v1/admin/shipments/{shipment_id}/refresh-tracking */ export const createApiApiV1AdminShipmentsShipmentIdRefreshTracking = async (args: CreateApiApiV1AdminShipmentsShipmentIdRefreshTrackingArgs, options: CreateApiApiV1AdminShipmentsShipmentIdRefreshTrackingOptions) => { const {baseUrl, fetch: fetchFn = fetch, OAuth2PasswordBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (OAuth2PasswordBearer !== undefined) headers.set('authorization', `Bearer ${OAuth2PasswordBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/admin/shipments/${encodeURIComponent(String(args.shipment_id))}/refresh-tracking${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(outboundShipmentResponse, await res.json()) };