import {z} from 'zod' export type PackageRequirements = 'photo_proof_of_delivery' | 'signature_proof_of_delivery' | 'photo_proof_of_pickup' | 'photo_reference_on_dropoff' | 'photo_reference_capture_on_dropoff' | 'signature_proof_of_pickup' | 'photo_pre_delivery_verification' | 'age_verification_on_delivery' | 'id_verification_on_delivery' | 'barcode_scan_on_pickup' | 'barcode_scan_on_dropoff' | 'barcode_scan_on_return' | 'meet_on_delivery' | 'shipping_label' | 'two_person_team' | 'pincode_verification' | 'schedule_ii_controlled_substances' | 'alcohol' | 'tobacco' | 'vapes' | 'parking_check_in' | 'display_barcode_on_pickup' | 'pick_and_pack'; export type Dimensions = {height?: (number | number | null) | undefined, width?: (number | number | null) | undefined, depth?: (number | number | null) | undefined}; export type SubstituteItemObject = {id?: (string | null) | undefined, sku?: (string | null) | undefined, quantity?: (number | null) | undefined}; export type SubstitutionObject = {preference?: (string | null) | undefined, source?: (string | null) | undefined, substituteItems?: (Array | null) | undefined}; export type SubItemInput = {id?: (string | null) | undefined, description?: (string | null) | undefined, count?: (number | null) | undefined, dimensions?: (Dimensions | null) | undefined, weight?: (number | number | null) | undefined, valueCents?: (number | null) | undefined, requirements?: (Array | null) | undefined, category?: (string | null) | undefined, barcode?: (string | null) | undefined, metadata?: ({[key: string]: unknown} | null) | undefined, sku?: (string | null) | undefined, substitution?: (SubstitutionObject | null) | undefined, subItems?: (Array | null) | undefined}; export type ItemInput = {id?: (string | null) | undefined, description?: (string | null) | undefined, count?: (number | null) | undefined, dimensions?: (Dimensions | null) | undefined, weight?: (number | number | null) | undefined, valueCents?: (number | null) | undefined, requirements?: (Array | null) | undefined, category?: (string | null) | undefined, barcode?: (string | null) | undefined, metadata?: ({[key: string]: unknown} | null) | undefined, volume?: (number | number | null) | undefined, subItems?: (Array | null) | undefined}; export type AlternativeDropoffTimeWindow = {start: string, end: string}; export type OptimizationParameters = {pickupDoorstepTimeSeconds?: (number | null) | undefined, dropoffDoorstepTimeSeconds?: (number | null) | undefined, costsByMetric?: ({[key: string]: unknown} | null) | undefined, clusterLabel?: (string | null) | undefined, mxLabel?: (string | null) | undefined, assignmentPriority?: (number | null) | undefined, sequencePriority?: (number | null) | undefined, sequenceGroup?: (string | null) | undefined, pickupOnly?: (boolean | null) | undefined, alternativeDropoffTimeWindows?: (Array | null) | undefined}; export type PickupPaymentBarcode = {type?: (string | null) | undefined, value?: (string | null) | undefined}; export type PickupPayment = {barcode?: (PickupPaymentBarcode | null) | undefined, providerCard?: (boolean | null) | undefined}; export type OrderInput = {externalId?: (string | null) | undefined, pickupAddress?: (string | null) | undefined, pickupPlaceId?: (string | null) | undefined, pickupPhoneNumber?: (string | null) | undefined, pickupBusinessName?: (string | null) | undefined, pickupFirstName?: (string | null) | undefined, pickupLastName?: (string | null) | undefined, pickupInstructions?: (string | null) | undefined, pickupStoreLocationId?: (string | null) | undefined, pickupExternalStoreLocationId?: (string | null) | undefined, pickupStoreLocationIds?: (Array | null) | undefined, pickupZoneIds?: (Array | null) | undefined, pickupBarcodes?: (Array | null) | undefined, pickupEmail?: (string | null) | undefined, dropoffAddress?: (string | null) | undefined, dropoffPlaceId?: (string | null) | undefined, dropoffPhoneNumber?: (string | null) | undefined, dropoffBusinessName?: (string | null) | undefined, dropoffFirstName?: (string | null) | undefined, dropoffLastName?: (string | null) | undefined, dropoffInstructions?: (string | null) | undefined, dropoffStoreLocationId?: (string | null) | undefined, dropoffExternalStoreLocationId?: (string | null) | undefined, dropoffBarcodes?: (Array | null) | undefined, dropoffEmail?: (string | null) | undefined, deliveryMode?: (string | null) | undefined, pickupStartTime?: (string | null) | undefined, pickupEndTime?: (string | null) | undefined, dropoffStartTime?: (string | null) | undefined, dropoffEndTime?: (string | null) | undefined, deliveryWindowId?: (string | null) | undefined, description?: (string | null) | undefined, itemsCount?: (number | null) | undefined, currency?: (string | null) | undefined, valueCents?: (number | string | null) | undefined, tipAmountCents?: (number | null) | undefined, dueAmountCents?: (number | null) | undefined, requirements?: (Array | Array | null) | undefined, minimumVehicleSize?: ('any' | 'bike' | 'motorbike' | 'cargobike' | 'cargo_bike' | 'sedan' | 'car' | 'suv' | 'pickup_truck' | 'pickup' | 'van' | 'large_van' | 'extra_large_van' | 'truck' | null) | undefined, dispatchStrategyId?: (string | null) | undefined, orderMetadata?: ({[key: string]: unknown} | null) | undefined, tags?: (Array | null) | undefined, referenceId?: (string | null) | undefined, pickupAddressNumber?: (string | null) | undefined, pickupAddressSecondarynumber?: (string | null) | undefined, pickupAddressFormattedStreet?: (string | null) | undefined, pickupAddressCity?: (string | null) | undefined, pickupAddressCounty?: (string | null) | undefined, pickupAddressState?: (string | null) | undefined, pickupAddressZip?: (string | null) | undefined, pickupAddressCountry?: (string | null) | undefined, pickupLat?: (number | null) | undefined, pickupLng?: (number | null) | undefined, dropoffAddressNumber?: (string | null) | undefined, dropoffAddressSecondarynumber?: (string | null) | undefined, dropoffAddressFormattedStreet?: (string | null) | undefined, dropoffAddressCity?: (string | null) | undefined, dropoffAddressCounty?: (string | null) | undefined, dropoffAddressState?: (string | null) | undefined, dropoffAddressZip?: (string | null) | undefined, dropoffAddressCountry?: (string | null) | undefined, dropoffLat?: (number | null) | undefined, dropoffLng?: (number | null) | undefined, weight?: (number | number | string | null) | undefined, weightUnit?: (string | null) | undefined, height?: (number | number | null) | undefined, width?: (number | number | null) | undefined, depth?: (number | number | null) | undefined, volume?: (number | number | null) | undefined, lengthUnit?: (string | null) | undefined, items?: (Array | null) | undefined, optimizationParameters?: (OptimizationParameters | null) | undefined, pickupPayment?: (PickupPayment | null) | undefined, reapplyAutomations?: (boolean | null) | undefined, maxDeliveryFeeCents?: (number | null) | undefined}; export type CreateOrdersInput = {orders: Array}; export type CreateApiV2OrdersUpsertBulkArgs = {body: CreateOrdersInput}; export type CreateApiV2OrdersUpsertBulkOptions = {baseUrl?: string | undefined, fetch?: typeof fetch | undefined}; export const bulkUpsertStatus = z.enum(["success", "failed"]); export const pickupPaymentBarcode = z.object({type: z.string().nullable().optional(), value: z.string().nullable().optional()}); export const pickupPayment = z.object({barcode: pickupPaymentBarcode.nullable().optional(), providerCard: z.boolean().nullable().optional()}); export const dimensions = z.object({height: z.union([z.number(), z.number().int()]).nullable().optional(), width: z.union([z.number(), z.number().int()]).nullable().optional(), depth: z.union([z.number(), z.number().int()]).nullable().optional()}); export const substituteItemObject = z.object({id: z.string().nullable().optional(), sku: z.string().nullable().optional(), quantity: z.number().int().nullable().optional()}); export const substitutionObject = z.object({preference: z.string().nullable().optional(), source: z.string().nullable().optional(), substituteItems: z.array(substituteItemObject).nullable().optional()}); export const subItemInput: z.ZodType = z.object({id: z.string().nullable().optional(), description: z.string().nullable().optional(), count: z.number().int().nullable().optional(), dimensions: dimensions.nullable().optional(), weight: z.union([z.number(), z.number().int()]).nullable().optional(), valueCents: z.number().int().nullable().optional(), requirements: z.array(z.string()).nullable().optional(), category: z.string().nullable().optional(), barcode: z.string().nullable().optional(), metadata: z.record(z.string(), z.unknown()).nullable().optional(), sku: z.string().nullable().optional(), substitution: substitutionObject.nullable().optional(), subItems: z.array(z.lazy(() => subItemInput)).nullable().optional()}); export const itemInput = z.object({id: z.string().nullable().optional(), description: z.string().nullable().optional(), count: z.number().int().nullable().optional(), dimensions: dimensions.nullable().optional(), weight: z.union([z.number(), z.number().int()]).nullable().optional(), valueCents: z.number().int().nullable().optional(), requirements: z.array(z.string()).nullable().optional(), category: z.string().nullable().optional(), barcode: z.string().nullable().optional(), metadata: z.record(z.string(), z.unknown()).nullable().optional(), volume: z.union([z.number(), z.number().int()]).nullable().optional(), subItems: z.array(subItemInput).nullable().optional()}); export const documentType = z.enum(["shipping_label", "pickup_label", "manifest", "packing_slip_label", "proof_of_delivery"]); export const orderDocumentOutput = z.object({createdAt: z.string(), id: z.string(), type: documentType, contentType: z.string(), url: z.string().nullable().optional(), data: z.string().nullable().optional()}); export const quoteSerializer = z.object({id: z.string(), type: z.string().nullable().optional(), providerId: z.string(), providerName: z.string(), providerLogo: z.string().nullable().optional(), providerIsInternal: z.boolean().nullable().optional(), createdTime: z.string(), expireTime: z.string().nullable().optional(), priceCents: z.number().int(), taxAmountCents: z.number().int().nullable().optional(), tollFeeCents: z.number().int().nullable().optional(), nashFeeCents: z.number().int().nullable().optional(), insuranceFeeCents: z.number().int().nullable().optional(), currency: z.string().nullable().optional(), pickupWindow: z.string().nullable().optional(), dropoffEta: z.string().nullable().optional(), tags: z.array(z.string()).nullable().optional(), costSplitCustomerCents: z.number().int().nullable().optional(), costSplitBusinessCents: z.number().int().nullable().optional(), totalPriceBreakdown: z.record(z.string(), z.unknown()).nullable().optional(), totalPriceCents: z.number().int().nullable().optional(), rank: z.number().int().nullable().optional(), price: z.number().nullable().optional(), isSuccessful: z.boolean().nullable().optional(), errorMessage: z.string().nullable().optional(), errorCode: z.string().nullable().optional(), errorDetails: z.record(z.string(), z.unknown()).nullable().optional()}); export const bulkUpsertOrderData = z.object({id: z.string(), createdAt: z.string(), externalId: z.string().nullable().optional(), externalGroupId: z.string().nullable().optional(), referenceId: z.string().nullable().optional(), portalUrl: z.string(), publicTrackingUrl: z.string(), status: z.string(), tags: z.array(z.string()).nullable(), orderMetadata: z.record(z.string(), z.unknown()).nullable().optional(), pickupAddress: z.string().nullable().optional(), pickupPlaceId: z.string().nullable().optional(), pickupAddressNumber: z.string().nullable().optional(), pickupAddressSecondarynumber: z.string().nullable().optional(), pickupAddressFormattedStreet: z.string().nullable().optional(), pickupAddressCity: z.string().nullable().optional(), pickupAddressCounty: z.string().nullable().optional(), pickupAddressState: z.string().nullable().optional(), pickupAddressZip: z.string().nullable().optional(), pickupAddressCountry: z.string().nullable().optional(), pickupLat: z.number().nullable().optional(), pickupLng: z.number().nullable().optional(), pickupPhoneNumber: z.string().nullable().optional(), pickupEmail: z.string().nullable().optional(), pickupFirstName: z.string().nullable().optional(), pickupLastName: z.string().nullable().optional(), pickupBusinessName: z.string().nullable().optional(), pickupInstructions: z.string().nullable().optional(), pickupStoreLocationId: z.string().nullable().optional(), pickupExternalStoreLocationId: z.string().nullable().optional(), pickupZoneIds: z.array(z.string()).nullable().optional(), pickupBarcodes: z.array(z.string()).nullable().optional(), pickupPayment: pickupPayment.nullable().optional(), dropoffAddress: z.string().nullable().optional(), dropoffPlaceId: z.string().nullable().optional(), dropoffAddressNumber: z.string().nullable().optional(), dropoffAddressSecondarynumber: z.string().nullable().optional(), dropoffAddressFormattedStreet: z.string().nullable().optional(), dropoffAddressCity: z.string().nullable().optional(), dropoffAddressCounty: z.string().nullable().optional(), dropoffAddressState: z.string().nullable().optional(), dropoffAddressZip: z.string().nullable().optional(), dropoffAddressCountry: z.string().nullable().optional(), dropoffLat: z.number().nullable().optional(), dropoffLng: z.number().nullable().optional(), dropoffPhoneNumber: z.string().nullable().optional(), dropoffEmail: z.string().nullable().optional(), dropoffFirstName: z.string().nullable().optional(), dropoffLastName: z.string().nullable().optional(), dropoffBusinessName: z.string().nullable().optional(), dropoffInstructions: z.string().nullable().optional(), dropoffStoreLocationId: z.string().nullable().optional(), dropoffBarcodes: z.array(z.string()).nullable().optional(), deliveryMode: z.string().nullable().optional(), pickupStartTime: z.string().nullable().optional(), pickupEndTime: z.string().nullable().optional(), dropoffStartTime: z.string().nullable().optional(), dropoffEndTime: z.string().nullable().optional(), description: z.string().nullable().optional(), itemsCount: z.string().nullable().optional(), requirements: z.array(z.string()).nullable().optional(), minimumVehicleSize: z.enum(["any", "bike", "motorbike", "cargobike", "cargo_bike", "sedan", "car", "suv", "pickup_truck", "pickup", "van", "large_van", "extra_large_van", "truck"]).nullable().optional(), currency: z.string().nullable().optional(), valueCents: z.string().nullable().optional(), tipAmountCents: z.string().nullable().optional(), dueAmountCents: z.string().nullable().optional(), width: z.string().nullable().optional(), depth: z.string().nullable().optional(), height: z.string().nullable().optional(), volume: z.string().nullable().optional(), weight: z.string().nullable().optional(), items: z.array(itemInput).nullable().optional(), dispatchStrategyId: z.string().nullable().optional(), maxDeliveryFeeCents: z.string().nullable().optional(), documents: z.array(orderDocumentOutput).nullable().optional(), validationErrors: z.record(z.string(), z.string()).nullable().optional(), quotes: z.array(quoteSerializer).nullable().optional(), failedQuotes: z.array(z.string()).nullable().optional(), quoteFailure: z.record(z.string(), z.unknown()).nullable().optional()}); export const bulkUpsertError = z.object({code: z.string(), message: z.string()}); export const bulkUpsertResultBulkUpsertOrderData = z.object({externalId: z.string().nullable().optional(), status: bulkUpsertStatus, id: z.string().nullable().optional(), data: bulkUpsertOrderData.nullable().optional(), errors: z.array(bulkUpsertError).nullable().optional()}); export const bulkUpsertSummary = z.object({success: z.number().int(), failed: z.number().int()}); export const bulkUpsertOrdersResponse = z.object({results: z.array(bulkUpsertResultBulkUpsertOrderData), summary: bulkUpsertSummary}); 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 }; /** * Create or update orders by external identifier (v2) * * POST /v2/orders/upsert/bulk */ export const createApiV2OrdersUpsertBulk = async (args: CreateApiV2OrdersUpsertBulkArgs, options?: CreateApiV2OrdersUpsertBulkOptions) => { const {baseUrl = "https://api.sandbox.usenash.com", fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/v2/orders/upsert/bulk${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(bulkUpsertOrdersResponse, await res.json()) };