import {z} from 'zod' export type GetApiApiV1ExternalShipmentsShipmentIdDetailsArgs = {shipmentId: string}; export type GetApiApiV1ExternalShipmentsShipmentIdDetailsOptions = {baseUrl?: string | undefined, bearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const entityCreationInfo = z.object({source: z.enum(["user", "email", "document_upload", "bulk_upload", "tms_import", "api", "system", "null"]).nullable().optional()}); export const shipmentEmailUpdates = z.object({threads: z.number().int().optional(), lastAt: z.string().nullable().optional()}); export const entitySyncInfo = z.object({method: z.enum(["automation", "manual", "webhook"]).optional(), status: z.string().optional(), syncedAt: z.string().nullable().optional(), syncedBy: z.object({userId: z.string().optional(), name: z.string().nullable().optional(), email: z.string().nullable().optional()}).nullable().optional(), tmsReference: z.string().nullable().optional()}).nullable(); export const portLocation = z.object({portCode: z.string(), portName: z.string().optional(), countryCode: z.string().optional()}); export const airportLocation = z.object({airportCode: z.string(), airportName: z.string().optional(), countryCode: z.string().optional()}); export const addressLocation = z.object({address1: z.string().optional(), address2: z.string().optional(), city: z.string().optional(), province: z.string().optional(), postalCode: z.string().optional(), country: z.string().optional()}); export const carrier = z.object({code: z.string(), name: z.string()}); export const referenceNumber = z.object({id: z.string(), type: z.string(), displayNumber: z.string(), cleanedNumber: z.string().optional()}); export const organization = z.object({name: z.string(), code: z.string().nullable().optional()}); export const address = z.object({street1: z.string().nullable().optional(), street2: z.string().nullable().optional(), city: z.string().nullable().optional(), state: z.string().nullable().optional(), postalCode: z.string().nullable().optional(), country: z.string().nullable().optional()}); export const shipmentDetails = z.object({creation: entityCreationInfo.optional(), emailUpdates: shipmentEmailUpdates.optional(), sync: entitySyncInfo.optional(), id: z.string().optional(), status: z.enum(["draft", "pending", "booked", "in_transit", "delivered", "cancelled"]).optional(), name: z.string().optional(), shipmentType: z.enum(["FCL", "LCL", "AIR", "LTL", "FTL", "RAIL"]).optional(), commodity: z.string().optional(), portOfLoading: portLocation.optional(), portOfDischarge: portLocation.optional(), placeOfReceiptType: z.enum(["Port", "Airport", "Door"]).optional(), placeOfReceiptPort: portLocation.optional(), placeOfReceiptAirport: airportLocation.optional(), placeOfReceiptAddress: addressLocation.optional(), placeOfDeliveryType: z.enum(["Port", "Airport", "Door"]).optional(), placeOfDeliveryPort: portLocation.optional(), placeOfDeliveryAirport: airportLocation.optional(), placeOfDeliveryAddress: addressLocation.optional(), createdAt: z.string().optional(), updatedAt: z.string().optional(), documentCount: z.number().int().optional(), carrier: carrier.optional(), vessel: z.string().optional(), voyage: z.string().optional(), incoterm: z.string().optional(), serviceType: z.string().optional(), invoiceDate: z.string().optional(), dueDate: z.string().optional(), issueDate: z.string().optional(), shipmentDate: z.string().optional(), expectedDeliveryDate: z.string().optional(), readyDate: z.string().optional(), dateOfSignature: z.string().optional(), referenceNumbers: z.array(referenceNumber).optional(), consigneeName: organization.optional(), consigneeAddress: address.optional(), consigneeContactName: z.string().nullable().optional(), consigneeContactPhone: z.string().nullable().optional(), consigneeContactEmail: z.string().nullable().optional(), consignorName: organization.optional(), consignorAddress: address.optional(), consignorContactName: z.string().nullable().optional(), consignorContactPhone: z.string().nullable().optional(), consignorContactEmail: z.string().nullable().optional(), notifyPartyName: organization.optional(), notifyPartyAddress: address.optional(), notifyPartyContactName: z.string().nullable().optional(), notifyPartyContactPhone: z.string().nullable().optional(), notifyPartyContactEmail: z.string().nullable().optional(), destinationAgentName: organization.optional(), destinationAgentAddress: address.optional(), destinationAgentContactName: z.string().nullable().optional(), destinationAgentContactPhone: z.string().nullable().optional(), destinationAgentContactEmail: z.string().nullable().optional(), totalWeight: z.number().nullable().optional(), weightUnit: z.string().nullable().optional(), totalVolume: z.number().nullable().optional(), volumeUnit: z.string().nullable().optional(), totalPieces: z.number().nullable().optional(), totalPacks: z.number().nullable().optional(), totalPacksPackageType: z.string().nullable().optional(), totalValue: z.number().nullable().optional(), currency: z.string().nullable().optional()}); export const shipmentItem = z.object({id: z.string().optional(), lineNumber: z.number().int().optional(), sku: z.string().optional(), partNumber: z.string().optional(), description: z.string().optional(), quantity: z.number().optional(), unitOfMeasure: z.string().optional(), unitPrice: z.number().optional(), amount: z.number().optional(), currency: z.string().optional(), countryOfOrigin: z.string().optional(), hsCode: z.string().optional(), weight: z.number().optional(), weightUnit: z.string().optional(), volume: z.number().optional(), volumeUnit: z.string().optional(), packageNumber: z.string().optional(), dimensions: z.object({length: z.number().optional(), width: z.number().optional(), height: z.number().optional(), unit: z.string().optional()}).optional()}); export const shipmentPackage = z.object({id: z.string().optional(), containerId: z.string().nullable().optional(), packageNumber: z.string().optional(), packageType: z.string().optional(), description: z.string().nullable().optional(), packageCount: z.number().int().optional(), lineNumber: z.number().int().nullable().optional(), grossWeight: z.number().nullable().optional(), netWeight: z.number().nullable().optional(), volume: z.number().nullable().optional(), weightUnit: z.string().nullable().optional(), volumeUnit: z.string().nullable().optional(), items: z.array(shipmentItem).optional()}); export const container = z.object({id: z.string().optional(), number: z.string().optional(), size: z.string().optional(), type: z.string().optional(), sizeType: z.string().optional(), sealNumber: z.string().optional(), quantity: z.number().int().optional(), packages: z.array(shipmentPackage).optional()}); export const getApiApiV1ExternalShipmentsShipmentIdDetailsResponse = z.object({success: z.boolean().optional(), data: z.object({shipment: shipmentDetails.optional(), items: z.array(shipmentItem).optional(), containers: z.array(container).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 detailed shipment information * * GET /api/v1/external/shipments/{shipmentId}/details */ export const getApiApiV1ExternalShipmentsShipmentIdDetails = async (args: GetApiApiV1ExternalShipmentsShipmentIdDetailsArgs, options?: GetApiApiV1ExternalShipmentsShipmentIdDetailsOptions) => { const {baseUrl = "https://api.wove.com", fetch: fetchFn = fetch, bearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (bearerAuth !== undefined) headers.set('authorization', `Bearer ${bearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/external/shipments/${encodeURIComponent(String(args.shipmentId))}/details${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(getApiApiV1ExternalShipmentsShipmentIdDetailsResponse, await res.json()) };