@shopickup/adapters-foxpost 0.0.1

package/dist/validation.d.ts

@@ -0,0 +1,1723 @@
+import { z } from 'zod';
+import type { CreateParcelRequest as CoreCreateParcelRequest, CreateParcelsRequest as CoreCreateParcelsRequest, CreateLabelRequest as CoreCreateLabelRequest, CreateLabelsRequest as CoreCreateLabelsRequest } from '@shopickup/core';
+/**
+ * Foxpost-specific credentials
+ * Requires both API key and basic auth together
+ * Extends Record<string, unknown> for compatibility with core types
+ */
+export interface FoxpostCredentials extends Record<string, unknown> {
+    apiKey: string;
+    basicUsername: string;
+    basicPassword: string;
+}
+/**
+ * Foxpost package size schema (used in both HD and APM)
+ */
+declare const FoxpostPackageSizeSchema: z.ZodEnum<{
+    XS: "XS";
+    S: "S";
+    1: "1";
+    M: "M";
+    2: "2";
+    L: "L";
+    3: "3";
+    XL: "XL";
+    4: "4";
+    5: "5";
+}>;
+export type FoxpostPackageSize = z.infer<typeof FoxpostPackageSizeSchema>;
+/**
+ * Home Delivery parcel schema with discriminator
+ */
+declare const FoxpostParcelHDSchema: z.ZodObject<{
+    type: z.ZodLiteral<"HD">;
+    cod: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    comment: z.ZodOptional<z.ZodString>;
+    deliveryNote: z.ZodOptional<z.ZodString>;
+    fragile: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    label: z.ZodOptional<z.ZodBoolean>;
+    recipientAddress: z.ZodString;
+    recipientCity: z.ZodString;
+    recipientCountry: z.ZodOptional<z.ZodString>;
+    recipientEmail: z.ZodEmail;
+    recipientName: z.ZodString;
+    recipientPhone: z.ZodString;
+    recipientZip: z.ZodString;
+    refCode: z.ZodOptional<z.ZodString>;
+    size: z.ZodEnum<{
+        XS: "XS";
+        S: "S";
+        1: "1";
+        M: "M";
+        2: "2";
+        L: "L";
+        3: "3";
+        XL: "XL";
+        4: "4";
+        5: "5";
+    }>;
+}, z.core.$strict>;
+/**
+ * APM (Automated Parcel Machine) parcel schema with discriminator
+ */
+declare const FoxpostParcelAPMSchema: z.ZodObject<{
+    type: z.ZodLiteral<"APM">;
+    cod: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    comment: z.ZodOptional<z.ZodString>;
+    destination: z.ZodString;
+    label: z.ZodOptional<z.ZodBoolean>;
+    recipientEmail: z.ZodEmail;
+    recipientName: z.ZodString;
+    recipientPhone: z.ZodString;
+    refCode: z.ZodOptional<z.ZodString>;
+    size: z.ZodEnum<{
+        XS: "XS";
+        S: "S";
+        1: "1";
+        M: "M";
+        2: "2";
+        L: "L";
+        3: "3";
+        XL: "XL";
+        4: "4";
+        5: "5";
+    }>;
+    uniqueBarcode: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Discriminated union of HD and APM parcel types
+ */
+export declare const FoxpostParcelSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"HD">;
+    cod: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    comment: z.ZodOptional<z.ZodString>;
+    deliveryNote: z.ZodOptional<z.ZodString>;
+    fragile: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    label: z.ZodOptional<z.ZodBoolean>;
+    recipientAddress: z.ZodString;
+    recipientCity: z.ZodString;
+    recipientCountry: z.ZodOptional<z.ZodString>;
+    recipientEmail: z.ZodEmail;
+    recipientName: z.ZodString;
+    recipientPhone: z.ZodString;
+    recipientZip: z.ZodString;
+    refCode: z.ZodOptional<z.ZodString>;
+    size: z.ZodEnum<{
+        XS: "XS";
+        S: "S";
+        1: "1";
+        M: "M";
+        2: "2";
+        L: "L";
+        3: "3";
+        XL: "XL";
+        4: "4";
+        5: "5";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"APM">;
+    cod: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    comment: z.ZodOptional<z.ZodString>;
+    destination: z.ZodString;
+    label: z.ZodOptional<z.ZodBoolean>;
+    recipientEmail: z.ZodEmail;
+    recipientName: z.ZodString;
+    recipientPhone: z.ZodString;
+    refCode: z.ZodOptional<z.ZodString>;
+    size: z.ZodEnum<{
+        XS: "XS";
+        S: "S";
+        1: "1";
+        M: "M";
+        2: "2";
+        L: "L";
+        3: "3";
+        XL: "XL";
+        4: "4";
+        5: "5";
+    }>;
+    uniqueBarcode: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">;
+/**
+ * Exported types inferred from Zod schemas (single source of truth)
+ */
+export type FoxpostParcel = z.infer<typeof FoxpostParcelSchema>;
+export type FoxpostParcelHD = z.infer<typeof FoxpostParcelHDSchema>;
+export type FoxpostParcelAPM = z.infer<typeof FoxpostParcelAPMSchema>;
+/**
+ * Foxpost-specific CreateParcelRequest (narrowed credentials)
+ */
+export interface CreateParcelRequestFoxpost extends CoreCreateParcelRequest {
+    credentials: FoxpostCredentials;
+}
+/**
+ * Foxpost-specific CreateParcelsRequest (narrowed credentials)
+ */
+export interface CreateParcelsRequestFoxpost extends CoreCreateParcelsRequest {
+    credentials: FoxpostCredentials;
+}
+/**
+ * Foxpost-specific CreateLabelRequest (narrowed credentials + nested foxpost options)
+ */
+export interface CreateLabelRequestFoxpost extends CoreCreateLabelRequest {
+    credentials: FoxpostCredentials;
+    options?: {
+        useTestApi?: boolean;
+        size?: 'A6' | 'A7' | '_85X85';
+        foxpost?: {
+            startPos?: number;
+            isPortrait?: boolean;
+        };
+    };
+}
+/**
+ * Foxpost-specific CreateLabelsRequest (narrowed credentials + nested foxpost options)
+ */
+export interface CreateLabelsRequestFoxpost extends CoreCreateLabelsRequest {
+    credentials: FoxpostCredentials;
+    options?: {
+        useTestApi?: boolean;
+        size?: 'A6' | 'A7' | '_85X85';
+        foxpost?: {
+            startPos?: number;
+            isPortrait?: boolean;
+        };
+    };
+}
+/**
+ * CreateParcelRequest Zod schema
+ */
+export declare const CreateParcelRequestFoxpostSchema: z.ZodObject<{
+    parcel: z.ZodObject<{
+        id: z.ZodString;
+        shipper: z.ZodObject<{
+            contact: z.ZodObject<{
+                name: z.ZodString;
+                phone: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodString>;
+                company: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            address: z.ZodObject<{
+                name: z.ZodString;
+                street: z.ZodString;
+                city: z.ZodString;
+                postalCode: z.ZodString;
+                country: z.ZodString;
+                phone: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodEmail>;
+                company: z.ZodOptional<z.ZodString>;
+                province: z.ZodOptional<z.ZodString>;
+                isPoBox: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        recipient: z.ZodObject<{
+            contact: z.ZodObject<{
+                name: z.ZodString;
+                phone: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodString>;
+                company: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            delivery: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                method: z.ZodLiteral<"HOME">;
+                address: z.ZodObject<{
+                    name: z.ZodString;
+                    street: z.ZodString;
+                    city: z.ZodString;
+                    postalCode: z.ZodString;
+                    country: z.ZodString;
+                    phone: z.ZodOptional<z.ZodString>;
+                    email: z.ZodOptional<z.ZodEmail>;
+                    company: z.ZodOptional<z.ZodString>;
+                    province: z.ZodOptional<z.ZodString>;
+                    isPoBox: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>;
+                instructions: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                method: z.ZodLiteral<"PICKUP_POINT">;
+                pickupPoint: z.ZodObject<{
+                    id: z.ZodString;
+                    provider: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                    address: z.ZodOptional<z.ZodObject<{
+                        name: z.ZodString;
+                        street: z.ZodString;
+                        city: z.ZodString;
+                        postalCode: z.ZodString;
+                        country: z.ZodString;
+                        phone: z.ZodOptional<z.ZodString>;
+                        email: z.ZodOptional<z.ZodEmail>;
+                        company: z.ZodOptional<z.ZodString>;
+                        province: z.ZodOptional<z.ZodString>;
+                        isPoBox: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                    type: z.ZodOptional<z.ZodEnum<{
+                        LOCKER: "LOCKER";
+                        SHOP: "SHOP";
+                        POST_OFFICE: "POST_OFFICE";
+                        OTHER: "OTHER";
+                    }>>;
+                }, z.core.$strip>;
+                instructions: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "method">;
+        }, z.core.$strip>;
+        carrierIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        service: z.ZodEnum<{
+            standard: "standard";
+            express: "express";
+            economy: "economy";
+            overnight: "overnight";
+        }>;
+        carrierServiceCode: z.ZodOptional<z.ZodString>;
+        package: z.ZodObject<{
+            weightGrams: z.ZodNumber;
+            dimensionsCm: z.ZodOptional<z.ZodObject<{
+                length: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        handling: z.ZodOptional<z.ZodObject<{
+            fragile: z.ZodOptional<z.ZodBoolean>;
+            perishables: z.ZodOptional<z.ZodBoolean>;
+            batteries: z.ZodOptional<z.ZodEnum<{
+                NONE: "NONE";
+                LITHIUM_ION: "LITHIUM_ION";
+                LITHIUM_METAL: "LITHIUM_METAL";
+            }>>;
+        }, z.core.$strip>>;
+        cod: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+            }, z.core.$strip>;
+            reference: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        declaredValue: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        insurance: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        references: z.ZodOptional<z.ZodObject<{
+            orderId: z.ZodOptional<z.ZodString>;
+            customerReference: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            sku: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodNumber;
+            description: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            draft: "draft";
+            created: "created";
+            closed: "closed";
+            label_generated: "label_generated";
+            shipped: "shipped";
+            delivered: "delivered";
+            exception: "exception";
+        }>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        createdAt: z.ZodOptional<z.ZodDate>;
+        updatedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strict>;
+    credentials: z.ZodObject<{
+        apiKey: z.ZodString;
+        basicUsername: z.ZodString;
+        basicPassword: z.ZodString;
+    }, z.core.$strict>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CreateParcelsRequestFoxpostSchema: z.ZodObject<{
+    parcels: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        shipper: z.ZodObject<{
+            contact: z.ZodObject<{
+                name: z.ZodString;
+                phone: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodString>;
+                company: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            address: z.ZodObject<{
+                name: z.ZodString;
+                street: z.ZodString;
+                city: z.ZodString;
+                postalCode: z.ZodString;
+                country: z.ZodString;
+                phone: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodEmail>;
+                company: z.ZodOptional<z.ZodString>;
+                province: z.ZodOptional<z.ZodString>;
+                isPoBox: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        recipient: z.ZodObject<{
+            contact: z.ZodObject<{
+                name: z.ZodString;
+                phone: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodString>;
+                company: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            delivery: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                method: z.ZodLiteral<"HOME">;
+                address: z.ZodObject<{
+                    name: z.ZodString;
+                    street: z.ZodString;
+                    city: z.ZodString;
+                    postalCode: z.ZodString;
+                    country: z.ZodString;
+                    phone: z.ZodOptional<z.ZodString>;
+                    email: z.ZodOptional<z.ZodEmail>;
+                    company: z.ZodOptional<z.ZodString>;
+                    province: z.ZodOptional<z.ZodString>;
+                    isPoBox: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>;
+                instructions: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                method: z.ZodLiteral<"PICKUP_POINT">;
+                pickupPoint: z.ZodObject<{
+                    id: z.ZodString;
+                    provider: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                    address: z.ZodOptional<z.ZodObject<{
+                        name: z.ZodString;
+                        street: z.ZodString;
+                        city: z.ZodString;
+                        postalCode: z.ZodString;
+                        country: z.ZodString;
+                        phone: z.ZodOptional<z.ZodString>;
+                        email: z.ZodOptional<z.ZodEmail>;
+                        company: z.ZodOptional<z.ZodString>;
+                        province: z.ZodOptional<z.ZodString>;
+                        isPoBox: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                    type: z.ZodOptional<z.ZodEnum<{
+                        LOCKER: "LOCKER";
+                        SHOP: "SHOP";
+                        POST_OFFICE: "POST_OFFICE";
+                        OTHER: "OTHER";
+                    }>>;
+                }, z.core.$strip>;
+                instructions: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "method">;
+        }, z.core.$strip>;
+        carrierIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        service: z.ZodEnum<{
+            standard: "standard";
+            express: "express";
+            economy: "economy";
+            overnight: "overnight";
+        }>;
+        carrierServiceCode: z.ZodOptional<z.ZodString>;
+        package: z.ZodObject<{
+            weightGrams: z.ZodNumber;
+            dimensionsCm: z.ZodOptional<z.ZodObject<{
+                length: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        handling: z.ZodOptional<z.ZodObject<{
+            fragile: z.ZodOptional<z.ZodBoolean>;
+            perishables: z.ZodOptional<z.ZodBoolean>;
+            batteries: z.ZodOptional<z.ZodEnum<{
+                NONE: "NONE";
+                LITHIUM_ION: "LITHIUM_ION";
+                LITHIUM_METAL: "LITHIUM_METAL";
+            }>>;
+        }, z.core.$strip>>;
+        cod: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+            }, z.core.$strip>;
+            reference: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        declaredValue: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        insurance: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        references: z.ZodOptional<z.ZodObject<{
+            orderId: z.ZodOptional<z.ZodString>;
+            customerReference: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            sku: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodNumber;
+            description: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            draft: "draft";
+            created: "created";
+            closed: "closed";
+            label_generated: "label_generated";
+            shipped: "shipped";
+            delivered: "delivered";
+            exception: "exception";
+        }>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        createdAt: z.ZodOptional<z.ZodDate>;
+        updatedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strict>>;
+    credentials: z.ZodObject<{
+        apiKey: z.ZodString;
+        basicUsername: z.ZodString;
+        basicPassword: z.ZodString;
+    }, z.core.$strict>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CreateLabelRequestFoxpostSchema: z.ZodObject<{
+    parcelCarrierId: z.ZodString;
+    credentials: z.ZodObject<{
+        apiKey: z.ZodString;
+        basicUsername: z.ZodString;
+        basicPassword: z.ZodString;
+    }, z.core.$strict>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+        size: z.ZodDefault<z.ZodEnum<{
+            A6: "A6";
+            A7: "A7";
+            _85X85: "_85X85";
+        }>>;
+        foxpost: z.ZodOptional<z.ZodObject<{
+            startPos: z.ZodOptional<z.ZodNumber>;
+            isPortrait: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Batch label request schema
+ * Similar to CreateParcelsRequest but for labels
+ */
+export declare const CreateLabelsRequestFoxpostSchema: z.ZodObject<{
+    parcelCarrierIds: z.ZodArray<z.ZodString>;
+    credentials: z.ZodObject<{
+        apiKey: z.ZodString;
+        basicUsername: z.ZodString;
+        basicPassword: z.ZodString;
+    }, z.core.$strict>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+        size: z.ZodDefault<z.ZodEnum<{
+            A6: "A6";
+            A7: "A7";
+            _85X85: "_85X85";
+        }>>;
+        foxpost: z.ZodOptional<z.ZodObject<{
+            startPos: z.ZodOptional<z.ZodNumber>;
+            isPortrait: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Foxpost-specific TrackingRequest (narrowed credentials)
+ */
+export interface TrackingRequestFoxpost {
+    trackingNumber: string;
+    credentials: FoxpostCredentials;
+    options?: {
+        useTestApi?: boolean;
+    };
+}
+/**
+ * TrackingRequest Zod schema
+ */
+export declare const TrackingRequestFoxpostSchema: z.ZodObject<{
+    trackingNumber: z.ZodString;
+    credentials: z.ZodObject<{
+        apiKey: z.ZodString;
+        basicUsername: z.ZodString;
+        basicPassword: z.ZodString;
+    }, z.core.$strict>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Helper to validate and extract credentials from a request
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostCredentials(credentials: unknown): FoxpostCredentials;
+/**
+ * Helper to safely validate credentials without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostCredentials(credentials: unknown): z.ZodSafeParseResult<{
+    apiKey: string;
+    basicUsername: string;
+    basicPassword: string;
+}>;
+/**
+ * Helper to validate a CreateParcelRequest
+ * Returns parsed and validated request or throws ZodError
+ */
+export declare function validateCreateParcelRequest(req: unknown): CreateParcelRequestFoxpost;
+/**
+ * Helper to validate a CreateParcelsRequest
+ * Returns parsed and validated request or throws ZodError
+ */
+export declare function validateCreateParcelsRequest(req: unknown): CreateParcelsRequestFoxpost;
+/**
+ * Helper to safely validate without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateCreateParcelRequest(req: unknown): z.ZodSafeParseResult<{
+    parcel: {
+        id: string;
+        shipper: {
+            contact: {
+                name: string;
+                phone?: string | undefined;
+                email?: string | undefined;
+                company?: string | undefined;
+            };
+            address: {
+                name: string;
+                street: string;
+                city: string;
+                postalCode: string;
+                country: string;
+                phone?: string | undefined;
+                email?: string | undefined;
+                company?: string | undefined;
+                province?: string | undefined;
+                isPoBox?: boolean | undefined;
+            };
+        };
+        recipient: {
+            contact: {
+                name: string;
+                phone?: string | undefined;
+                email?: string | undefined;
+                company?: string | undefined;
+            };
+            delivery: {
+                method: "HOME";
+                address: {
+                    name: string;
+                    street: string;
+                    city: string;
+                    postalCode: string;
+                    country: string;
+                    phone?: string | undefined;
+                    email?: string | undefined;
+                    company?: string | undefined;
+                    province?: string | undefined;
+                    isPoBox?: boolean | undefined;
+                };
+                instructions?: string | undefined;
+            } | {
+                method: "PICKUP_POINT";
+                pickupPoint: {
+                    id: string;
+                    provider?: string | undefined;
+                    name?: string | undefined;
+                    address?: {
+                        name: string;
+                        street: string;
+                        city: string;
+                        postalCode: string;
+                        country: string;
+                        phone?: string | undefined;
+                        email?: string | undefined;
+                        company?: string | undefined;
+                        province?: string | undefined;
+                        isPoBox?: boolean | undefined;
+                    } | undefined;
+                    type?: "LOCKER" | "SHOP" | "POST_OFFICE" | "OTHER" | undefined;
+                };
+                instructions?: string | undefined;
+            };
+        };
+        service: "standard" | "express" | "economy" | "overnight";
+        package: {
+            weightGrams: number;
+            dimensionsCm?: {
+                length: number;
+                width: number;
+                height: number;
+            } | undefined;
+        };
+        carrierIds?: Record<string, string> | undefined;
+        carrierServiceCode?: string | undefined;
+        handling?: {
+            fragile?: boolean | undefined;
+            perishables?: boolean | undefined;
+            batteries?: "NONE" | "LITHIUM_ION" | "LITHIUM_METAL" | undefined;
+        } | undefined;
+        cod?: {
+            amount: {
+                amount: number;
+                currency: string;
+            };
+            reference?: string | undefined;
+        } | undefined;
+        declaredValue?: {
+            amount: number;
+            currency: string;
+        } | undefined;
+        insurance?: {
+            amount: {
+                amount: number;
+                currency: string;
+            };
+        } | undefined;
+        references?: {
+            orderId?: string | undefined;
+            customerReference?: string | undefined;
+        } | undefined;
+        items?: {
+            quantity: number;
+            sku?: string | undefined;
+            description?: string | undefined;
+            weight?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        status?: "draft" | "created" | "closed" | "label_generated" | "shipped" | "delivered" | "exception" | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: Date | undefined;
+        updatedAt?: Date | undefined;
+    };
+    credentials: {
+        apiKey: string;
+        basicUsername: string;
+        basicPassword: string;
+    };
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+export declare function safeValidateCreateParcelsRequest(req: unknown): z.ZodSafeParseResult<{
+    parcels: {
+        id: string;
+        shipper: {
+            contact: {
+                name: string;
+                phone?: string | undefined;
+                email?: string | undefined;
+                company?: string | undefined;
+            };
+            address: {
+                name: string;
+                street: string;
+                city: string;
+                postalCode: string;
+                country: string;
+                phone?: string | undefined;
+                email?: string | undefined;
+                company?: string | undefined;
+                province?: string | undefined;
+                isPoBox?: boolean | undefined;
+            };
+        };
+        recipient: {
+            contact: {
+                name: string;
+                phone?: string | undefined;
+                email?: string | undefined;
+                company?: string | undefined;
+            };
+            delivery: {
+                method: "HOME";
+                address: {
+                    name: string;
+                    street: string;
+                    city: string;
+                    postalCode: string;
+                    country: string;
+                    phone?: string | undefined;
+                    email?: string | undefined;
+                    company?: string | undefined;
+                    province?: string | undefined;
+                    isPoBox?: boolean | undefined;
+                };
+                instructions?: string | undefined;
+            } | {
+                method: "PICKUP_POINT";
+                pickupPoint: {
+                    id: string;
+                    provider?: string | undefined;
+                    name?: string | undefined;
+                    address?: {
+                        name: string;
+                        street: string;
+                        city: string;
+                        postalCode: string;
+                        country: string;
+                        phone?: string | undefined;
+                        email?: string | undefined;
+                        company?: string | undefined;
+                        province?: string | undefined;
+                        isPoBox?: boolean | undefined;
+                    } | undefined;
+                    type?: "LOCKER" | "SHOP" | "POST_OFFICE" | "OTHER" | undefined;
+                };
+                instructions?: string | undefined;
+            };
+        };
+        service: "standard" | "express" | "economy" | "overnight";
+        package: {
+            weightGrams: number;
+            dimensionsCm?: {
+                length: number;
+                width: number;
+                height: number;
+            } | undefined;
+        };
+        carrierIds?: Record<string, string> | undefined;
+        carrierServiceCode?: string | undefined;
+        handling?: {
+            fragile?: boolean | undefined;
+            perishables?: boolean | undefined;
+            batteries?: "NONE" | "LITHIUM_ION" | "LITHIUM_METAL" | undefined;
+        } | undefined;
+        cod?: {
+            amount: {
+                amount: number;
+                currency: string;
+            };
+            reference?: string | undefined;
+        } | undefined;
+        declaredValue?: {
+            amount: number;
+            currency: string;
+        } | undefined;
+        insurance?: {
+            amount: {
+                amount: number;
+                currency: string;
+            };
+        } | undefined;
+        references?: {
+            orderId?: string | undefined;
+            customerReference?: string | undefined;
+        } | undefined;
+        items?: {
+            quantity: number;
+            sku?: string | undefined;
+            description?: string | undefined;
+            weight?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        status?: "draft" | "created" | "closed" | "label_generated" | "shipped" | "delivered" | "exception" | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: Date | undefined;
+        updatedAt?: Date | undefined;
+    }[];
+    credentials: {
+        apiKey: string;
+        basicUsername: string;
+        basicPassword: string;
+    };
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Helper to safely validate a CreateLabelRequest without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateCreateLabelRequest(req: unknown): z.ZodSafeParseResult<{
+    parcelCarrierId: string;
+    credentials: {
+        apiKey: string;
+        basicUsername: string;
+        basicPassword: string;
+    };
+    options?: {
+        size: "A6" | "A7" | "_85X85";
+        useTestApi?: boolean | undefined;
+        foxpost?: {
+            isPortrait: boolean;
+            startPos?: number | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+/**
+ * Helper to safely validate a CreateLabelsRequest without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateCreateLabelsRequest(req: unknown): z.ZodSafeParseResult<{
+    parcelCarrierIds: string[];
+    credentials: {
+        apiKey: string;
+        basicUsername: string;
+        basicPassword: string;
+    };
+    options?: {
+        size: "A6" | "A7" | "_85X85";
+        useTestApi?: boolean | undefined;
+        foxpost?: {
+            isPortrait: boolean;
+            startPos?: number | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+/**
+ * Helper to safely validate a TrackingRequest without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateTrackingRequest(req: unknown): z.ZodSafeParseResult<{
+    trackingNumber: string;
+    credentials: {
+        apiKey: string;
+        basicUsername: string;
+        basicPassword: string;
+    };
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Validate a Foxpost parcel payload (after mapping from canonical Parcel)
+ * Used to catch mapping errors before sending to the carrier
+ */
+export declare function validateFoxpostParcel(parcel: unknown): FoxpostParcel;
+/**
+ * Safely validate a Foxpost parcel payload without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostParcel(parcel: unknown): z.ZodSafeParseResult<{
+    type: "HD";
+    cod: number;
+    fragile: boolean;
+    recipientAddress: string;
+    recipientCity: string;
+    recipientEmail: string;
+    recipientName: string;
+    recipientPhone: string;
+    recipientZip: string;
+    size: "XS" | "S" | "1" | "M" | "2" | "L" | "3" | "XL" | "4" | "5";
+    comment?: string | undefined;
+    deliveryNote?: string | undefined;
+    label?: boolean | undefined;
+    recipientCountry?: string | undefined;
+    refCode?: string | undefined;
+} | {
+    type: "APM";
+    cod: number;
+    destination: string;
+    recipientEmail: string;
+    recipientName: string;
+    recipientPhone: string;
+    size: "XS" | "S" | "1" | "M" | "2" | "L" | "3" | "XL" | "4" | "5";
+    comment?: string | undefined;
+    label?: boolean | undefined;
+    refCode?: string | undefined;
+    uniqueBarcode?: string | undefined;
+}>;
+/**
+ * ============================================================================
+ * Foxpost Tracking Schemas (from OpenAPI /api/tracking/{barcode})
+ * ============================================================================
+ */
+/**
+ * Trace enum from OpenAPI Trace.status
+ */
+declare const TraceStatusEnum: z.ZodEnum<{
+    CREATE: "CREATE";
+    OPERIN: "OPERIN";
+    OPEROUT: "OPEROUT";
+    RECEIVE: "RECEIVE";
+    RETURN: "RETURN";
+    REDIRECT: "REDIRECT";
+    OVERTIMEOUT: "OVERTIMEOUT";
+    SORTIN: "SORTIN";
+    SORTOUT: "SORTOUT";
+    SLOTCHANGE: "SLOTCHANGE";
+    OVERTIMED: "OVERTIMED";
+    MPSIN: "MPSIN";
+    C2CIN: "C2CIN";
+    HDSENT: "HDSENT";
+    HDDEPO: "HDDEPO";
+    HDINTRANSIT: "HDINTRANSIT";
+    HDRETURN: "HDRETURN";
+    HDRECEIVE: "HDRECEIVE";
+    WBXREDIRECT: "WBXREDIRECT";
+    BACKTOSENDER: "BACKTOSENDER";
+    HDHUBIN: "HDHUBIN";
+    HDHUBOUT: "HDHUBOUT";
+    HDCOURIER: "HDCOURIER";
+    HDUNDELIVERABLE: "HDUNDELIVERABLE";
+    PREPAREDFORPD: "PREPAREDFORPD";
+    INWAREHOUSE: "INWAREHOUSE";
+    COLLECTSENT: "COLLECTSENT";
+    C2BIN: "C2BIN";
+    RETURNED: "RETURNED";
+    COLLECTED: "COLLECTED";
+    BACKLOGINFULL: "BACKLOGINFULL";
+    BACKLOGINFAIL: "BACKLOGINFAIL";
+    MISSORT: "MISSORT";
+    EMPTYSLOT: "EMPTYSLOT";
+    RESENT: "RESENT";
+    PREREDIRECT: "PREREDIRECT";
+}>;
+export type FoxpostTraceStatus = z.infer<typeof TraceStatusEnum>;
+/**
+ * Trace schema (from OpenAPI components/schemas/Trace)
+ *
+ * Uses lenient validation with coercion to handle real API responses:
+ * - statusDate: coerces various date string formats to Date objects
+ * - statusStationId: coerces numbers to strings (API inconsistency)
+ * - Other fields: optional, pass through extra fields
+ */
+declare const TraceSchema: z.ZodObject<{
+    statusDate: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    statusStationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>;
+    shortName: z.ZodOptional<z.ZodString>;
+    longName: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        CREATE: "CREATE";
+        OPERIN: "OPERIN";
+        OPEROUT: "OPEROUT";
+        RECEIVE: "RECEIVE";
+        RETURN: "RETURN";
+        REDIRECT: "REDIRECT";
+        OVERTIMEOUT: "OVERTIMEOUT";
+        SORTIN: "SORTIN";
+        SORTOUT: "SORTOUT";
+        SLOTCHANGE: "SLOTCHANGE";
+        OVERTIMED: "OVERTIMED";
+        MPSIN: "MPSIN";
+        C2CIN: "C2CIN";
+        HDSENT: "HDSENT";
+        HDDEPO: "HDDEPO";
+        HDINTRANSIT: "HDINTRANSIT";
+        HDRETURN: "HDRETURN";
+        HDRECEIVE: "HDRECEIVE";
+        WBXREDIRECT: "WBXREDIRECT";
+        BACKTOSENDER: "BACKTOSENDER";
+        HDHUBIN: "HDHUBIN";
+        HDHUBOUT: "HDHUBOUT";
+        HDCOURIER: "HDCOURIER";
+        HDUNDELIVERABLE: "HDUNDELIVERABLE";
+        PREPAREDFORPD: "PREPAREDFORPD";
+        INWAREHOUSE: "INWAREHOUSE";
+        COLLECTSENT: "COLLECTSENT";
+        C2BIN: "C2BIN";
+        RETURNED: "RETURNED";
+        COLLECTED: "COLLECTED";
+        BACKLOGINFULL: "BACKLOGINFULL";
+        BACKLOGINFAIL: "BACKLOGINFAIL";
+        MISSORT: "MISSORT";
+        EMPTYSLOT: "EMPTYSLOT";
+        RESENT: "RESENT";
+        PREREDIRECT: "PREREDIRECT";
+    }>>;
+}, z.core.$loose>;
+export type FoxpostTrace = z.infer<typeof TraceSchema>;
+/**
+ * TrackDTO schema (from OpenAPI components/schemas/TrackDTO)
+ * Note: TrackDTO mirrors Trace but with trackId and slightly different names
+ */
+declare const TrackDTOSchema: z.ZodObject<{
+    trackId: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodString>;
+    statusDate: z.ZodPipe<z.ZodUnion<[z.ZodString, z.ZodString]>, z.ZodTransform<Date, string>>;
+}, z.core.$strict>;
+export type FoxpostTrackDTO = z.infer<typeof TrackDTOSchema>;
+/**
+ * Parcel type enum from OpenAPI Tracking.parcelType
+ */
+declare const FoxpostParcelTypeEnum: z.ZodEnum<{
+    NORMAL: "NORMAL";
+    RE: "RE";
+    XRE: "XRE";
+    IRE: "IRE";
+    C2B: "C2B";
+}>;
+export type FoxpostParcelType = z.infer<typeof FoxpostParcelTypeEnum>;
+/**
+ * Send type enum from OpenAPI Tracking.sendType
+ */
+declare const FoxpostSendTypeEnum: z.ZodEnum<{
+    HD: "HD";
+    APM: "APM";
+    COLLECT: "COLLECT";
+}>;
+export type FoxpostSendType = z.infer<typeof FoxpostSendTypeEnum>;
+/**
+ * Tracking schema (from OpenAPI components/schemas/Tracking)
+ * This is the response from GET /api/tracking/{barcode}
+ *
+ * Uses lenient validation to handle API quirks:
+ * - All fields optional
+ * - estimatedDelivery can be null or string
+ * - Passes through extra fields from API
+ */
+declare const FoxpostTrackingSchema: z.ZodObject<{
+    clFox: z.ZodOptional<z.ZodString>;
+    parcelType: z.ZodOptional<z.ZodEnum<{
+        NORMAL: "NORMAL";
+        RE: "RE";
+        XRE: "XRE";
+        IRE: "IRE";
+        C2B: "C2B";
+    }>>;
+    sendType: z.ZodOptional<z.ZodEnum<{
+        HD: "HD";
+        APM: "APM";
+        COLLECT: "COLLECT";
+    }>>;
+    traces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        statusDate: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+        statusStationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>;
+        shortName: z.ZodOptional<z.ZodString>;
+        longName: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            CREATE: "CREATE";
+            OPERIN: "OPERIN";
+            OPEROUT: "OPEROUT";
+            RECEIVE: "RECEIVE";
+            RETURN: "RETURN";
+            REDIRECT: "REDIRECT";
+            OVERTIMEOUT: "OVERTIMEOUT";
+            SORTIN: "SORTIN";
+            SORTOUT: "SORTOUT";
+            SLOTCHANGE: "SLOTCHANGE";
+            OVERTIMED: "OVERTIMED";
+            MPSIN: "MPSIN";
+            C2CIN: "C2CIN";
+            HDSENT: "HDSENT";
+            HDDEPO: "HDDEPO";
+            HDINTRANSIT: "HDINTRANSIT";
+            HDRETURN: "HDRETURN";
+            HDRECEIVE: "HDRECEIVE";
+            WBXREDIRECT: "WBXREDIRECT";
+            BACKTOSENDER: "BACKTOSENDER";
+            HDHUBIN: "HDHUBIN";
+            HDHUBOUT: "HDHUBOUT";
+            HDCOURIER: "HDCOURIER";
+            HDUNDELIVERABLE: "HDUNDELIVERABLE";
+            PREPAREDFORPD: "PREPAREDFORPD";
+            INWAREHOUSE: "INWAREHOUSE";
+            COLLECTSENT: "COLLECTSENT";
+            C2BIN: "C2BIN";
+            RETURNED: "RETURNED";
+            COLLECTED: "COLLECTED";
+            BACKLOGINFULL: "BACKLOGINFULL";
+            BACKLOGINFAIL: "BACKLOGINFAIL";
+            MISSORT: "MISSORT";
+            EMPTYSLOT: "EMPTYSLOT";
+            RESENT: "RESENT";
+            PREREDIRECT: "PREREDIRECT";
+        }>>;
+    }, z.core.$loose>>>;
+    relatedParcel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    estimatedDelivery: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+export type FoxpostTracking = z.infer<typeof FoxpostTrackingSchema>;
+/**
+ * Helper to validate a Foxpost tracking response
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostTracking(res: unknown): FoxpostTracking;
+/**
+ * Helper to safely validate a Foxpost tracking response without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostTracking(res: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    clFox?: string | undefined;
+    parcelType?: "NORMAL" | "RE" | "XRE" | "IRE" | "C2B" | undefined;
+    sendType?: "HD" | "APM" | "COLLECT" | undefined;
+    traces?: {
+        [x: string]: unknown;
+        statusDate: Date;
+        statusStationId?: string | undefined;
+        shortName?: string | undefined;
+        longName?: string | undefined;
+        status?: "CREATE" | "OPERIN" | "OPEROUT" | "RECEIVE" | "RETURN" | "REDIRECT" | "OVERTIMEOUT" | "SORTIN" | "SORTOUT" | "SLOTCHANGE" | "OVERTIMED" | "MPSIN" | "C2CIN" | "HDSENT" | "HDDEPO" | "HDINTRANSIT" | "HDRETURN" | "HDRECEIVE" | "WBXREDIRECT" | "BACKTOSENDER" | "HDHUBIN" | "HDHUBOUT" | "HDCOURIER" | "HDUNDELIVERABLE" | "PREPAREDFORPD" | "INWAREHOUSE" | "COLLECTSENT" | "C2BIN" | "RETURNED" | "COLLECTED" | "BACKLOGINFULL" | "BACKLOGINFAIL" | "MISSORT" | "EMPTYSLOT" | "RESENT" | "PREREDIRECT" | undefined;
+    }[] | undefined;
+    relatedParcel?: string | null | undefined;
+    estimatedDelivery?: string | null | undefined;
+}>;
+/**
+ * ============================================================================
+ * Foxpost Parcel Creation Request/Response Schemas (from OpenAPI /api/parcel)
+ * ============================================================================
+ *
+ * Schemas for request body and response shapes, modeled after Foxpost OpenAPI
+ * but kept lenient to handle real-world API quirks and future changes.
+ */
+/**
+ * FieldError schema (from OpenAPI components/schemas/FieldError)
+ * Represents a validation error on a specific field
+ * Uses lenient validation to accept any field name or error code
+ */
+declare const FieldErrorSchema: z.ZodObject<{
+    field: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type FoxFieldError = z.infer<typeof FieldErrorSchema>;
+/**
+ * Package schema (from OpenAPI components/schemas/Package)
+ * Represents a single parcel result in the CreateResponse
+ *
+ * Uses lenient validation:
+ * - All fields optional to handle partial responses
+ * - Passes through extra fields from carrier
+ * - Lenient with field types (clFoxId may be string or number fallback)
+ */
+declare const PackageSchema: z.ZodObject<{
+    clFoxId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>;
+    barcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    newBarcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    refCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uniqueBarcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        field: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+}, z.core.$loose>;
+export type FoxPackage = z.infer<typeof PackageSchema>;
+/**
+ * CreateResponse schema (from OpenAPI components/schemas/CreateResponse)
+ * Response from POST /api/parcel
+ *
+ * Uses lenient validation:
+ * - valid: boolean indicating if all parcels succeeded or not
+ * - parcels: array of Package results
+ * - errors: top-level validation errors (optional)
+ * - Passes through extra fields for extensibility
+ */
+declare const CreateResponseSchema: z.ZodObject<{
+    valid: z.ZodOptional<z.ZodBoolean>;
+    parcels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        clFoxId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>>;
+        barcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        newBarcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        refCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        uniqueBarcode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>>;
+    }, z.core.$loose>>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export type FoxCreateResponse = z.infer<typeof CreateResponseSchema>;
+/**
+ * CreateParcelRequest schema (from OpenAPI components/schemas/CreateParcelRequest)
+ * Request body for POST /api/parcel (single or batch)
+ *
+ * Uses lenient validation:
+ * - Required: recipientName, recipientEmail, recipientPhone (for all parcels)
+ * - HD parcels: also require recipientCity, recipientZip, recipientAddress
+ * - APM parcels: also require destination
+ * - Optional fields accept any string/value, not strict enums
+ * - size defaults to 's' if missing
+ * - cod: coerced to number, defaults to 0
+ * - Passes through extra fields for future extensibility
+ */
+declare const CreateParcelRequestItemSchema: z.ZodObject<{
+    recipientName: z.ZodOptional<z.ZodString>;
+    recipientEmail: z.ZodOptional<z.ZodString>;
+    recipientPhone: z.ZodOptional<z.ZodString>;
+    recipientCountry: z.ZodOptional<z.ZodString>;
+    recipientCity: z.ZodOptional<z.ZodString>;
+    recipientZip: z.ZodOptional<z.ZodString>;
+    recipientAddress: z.ZodOptional<z.ZodString>;
+    destination: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        XS: "XS";
+        S: "S";
+        M: "M";
+        L: "L";
+        XL: "XL";
+    }>, z.ZodPipe<z.ZodEnum<{
+        xs: "xs";
+        s: "s";
+        m: "m";
+        l: "l";
+        xl: "xl";
+    }>, z.ZodTransform<string, "xs" | "s" | "m" | "l" | "xl">>, z.ZodString]>>>;
+    cod: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>>;
+    comment: z.ZodOptional<z.ZodString>;
+    deliveryNote: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodBoolean>;
+    fragile: z.ZodOptional<z.ZodBoolean>;
+    refCode: z.ZodOptional<z.ZodString>;
+    uniqueBarcode: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type FoxCreateParcelRequestItem = z.infer<typeof CreateParcelRequestItemSchema>;
+/**
+ * Helper to validate a Foxpost CreateResponse
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostCreateResponse(res: unknown): FoxCreateResponse;
+/**
+ * Helper to safely validate a Foxpost CreateResponse without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostCreateResponse(res: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    valid?: boolean | undefined;
+    parcels?: {
+        [x: string]: unknown;
+        clFoxId?: string | undefined;
+        barcode?: string | null | undefined;
+        newBarcode?: string | null | undefined;
+        refCode?: string | null | undefined;
+        uniqueBarcode?: string | null | undefined;
+        errors?: {
+            [x: string]: unknown;
+            field?: string | undefined;
+            message?: string | undefined;
+        }[] | null | undefined;
+    }[] | undefined;
+    errors?: {
+        [x: string]: unknown;
+        field?: string | undefined;
+        message?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Helper to validate a Foxpost Package entry
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostPackage(pkg: unknown): FoxPackage;
+/**
+ * Helper to safely validate a Foxpost Package entry without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostPackage(pkg: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    clFoxId?: string | undefined;
+    barcode?: string | null | undefined;
+    newBarcode?: string | null | undefined;
+    refCode?: string | null | undefined;
+    uniqueBarcode?: string | null | undefined;
+    errors?: {
+        [x: string]: unknown;
+        field?: string | undefined;
+        message?: string | undefined;
+    }[] | null | undefined;
+}>;
+/**
+ * Helper to validate a single Foxpost CreateParcelRequest item
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostCreateParcelRequestItem(item: unknown): FoxCreateParcelRequestItem;
+/**
+ * Helper to safely validate a Foxpost CreateParcelRequest item without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostCreateParcelRequestItem(item: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    size: string;
+    cod: number;
+    recipientName?: string | undefined;
+    recipientEmail?: string | undefined;
+    recipientPhone?: string | undefined;
+    recipientCountry?: string | undefined;
+    recipientCity?: string | undefined;
+    recipientZip?: string | undefined;
+    recipientAddress?: string | undefined;
+    destination?: string | undefined;
+    comment?: string | undefined;
+    deliveryNote?: string | undefined;
+    label?: boolean | undefined;
+    fragile?: boolean | undefined;
+    refCode?: string | undefined;
+    uniqueBarcode?: string | undefined;
+}>;
+/**
+ * ============================================================================
+ * Foxpost Label Generation Schemas (from OpenAPI /api/label/{pageSize})
+ * ============================================================================
+ *
+ * Schemas for label generation request parameters, response metadata,
+ * error handling, and label info (from /api/label/info/{barcode})
+ */
+/**
+ * ApiError schema (from OpenAPI components/schemas/ApiError)
+ * Carrier returns this on error responses (400, 401, etc.)
+ * Uses lenient validation to accept any structure
+ */
+declare const ApiErrorSchema: z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type FoxpostApiError = z.infer<typeof ApiErrorSchema>;
+/**
+ * Helper to safely validate a Foxpost API error response without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostApiError(res: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    timestamp?: string | undefined;
+    error?: string | undefined;
+    status?: number | undefined;
+}>;
+export type FoxpostLabelPdfRaw = unknown;
+/**
+ * Helper to safely validate PDF raw response without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostLabelPdfRaw(raw: unknown): z.ZodSafeParseResult<any>;
+/**
+ * PDF metadata schema for label generation
+ * Describes the PDF file properties and generation options
+ */
+declare const FoxpostLabelPdfMetadataSchema: z.ZodObject<{
+    size: z.ZodOptional<z.ZodEnum<{
+        A6: "A6";
+        A7: "A7";
+        _85X85: "_85X85";
+    }>>;
+    barcodesCount: z.ZodOptional<z.ZodNumber>;
+    startPos: z.ZodOptional<z.ZodNumber>;
+    isPortrait: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export type FoxpostLabelPdfMetadata = z.infer<typeof FoxpostLabelPdfMetadataSchema>;
+/**
+ * Helper to validate PDF metadata
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostLabelPdfMetadata(metadata: unknown): FoxpostLabelPdfMetadata;
+/**
+ * Helper to safely validate PDF metadata without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostLabelPdfMetadata(metadata: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    size?: "A6" | "A7" | "_85X85" | undefined;
+    barcodesCount?: number | undefined;
+    startPos?: number | undefined;
+    isPortrait?: boolean | undefined;
+}>;
+/**
+ * LabelInfo schema (from OpenAPI components/schemas/LabelInfo)
+ * Response from GET /api/label/info/{barcode}
+ * Contains pre-label metadata about the parcel
+ */
+declare const LabelInfoSchema: z.ZodObject<{
+    senderName: z.ZodOptional<z.ZodString>;
+    senderZip: z.ZodOptional<z.ZodString>;
+    senderCity: z.ZodOptional<z.ZodString>;
+    senderAddress: z.ZodOptional<z.ZodString>;
+    recipientName: z.ZodOptional<z.ZodString>;
+    recipientEmail: z.ZodOptional<z.ZodString>;
+    recipientPhone: z.ZodOptional<z.ZodString>;
+    recipientZip: z.ZodOptional<z.ZodString>;
+    recipientCity: z.ZodOptional<z.ZodString>;
+    recipientAddress: z.ZodOptional<z.ZodString>;
+    apm: z.ZodOptional<z.ZodString>;
+    cod: z.ZodOptional<z.ZodNumber>;
+    isFragile: z.ZodOptional<z.ZodBoolean>;
+    barcode: z.ZodOptional<z.ZodString>;
+    refCode: z.ZodOptional<z.ZodString>;
+    depoCode: z.ZodOptional<z.ZodString>;
+    courierCode: z.ZodOptional<z.ZodString>;
+    sendType: z.ZodOptional<z.ZodEnum<{
+        HD: "HD";
+        APM: "APM";
+        COLLECT: "COLLECT";
+    }>>;
+}, z.core.$loose>;
+export type FoxpostLabelInfo = z.infer<typeof LabelInfoSchema>;
+/**
+ * Helper to validate a Foxpost LabelInfo response
+ * Throws ZodError if validation fails
+ */
+export declare function validateFoxpostLabelInfo(res: unknown): FoxpostLabelInfo;
+/**
+ * Helper to safely validate a Foxpost LabelInfo response without throwing
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostLabelInfo(res: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    senderName?: string | undefined;
+    senderZip?: string | undefined;
+    senderCity?: string | undefined;
+    senderAddress?: string | undefined;
+    recipientName?: string | undefined;
+    recipientEmail?: string | undefined;
+    recipientPhone?: string | undefined;
+    recipientZip?: string | undefined;
+    recipientCity?: string | undefined;
+    recipientAddress?: string | undefined;
+    apm?: string | undefined;
+    cod?: number | undefined;
+    isFragile?: boolean | undefined;
+    barcode?: string | undefined;
+    refCode?: string | undefined;
+    depoCode?: string | undefined;
+    courierCode?: string | undefined;
+    sendType?: "HD" | "APM" | "COLLECT" | undefined;
+}>;
+/**
+ * ============================================================================
+ * Foxpost APM/Pickup-Points Schemas (from foxplus.json feed)
+ * ============================================================================
+ */
+/**
+ * Opening hours schema - Hungarian day names with optional string values
+ * Uses passthrough to allow extra fields and lenient validation
+ */
+declare const OpeningHoursSchema: z.ZodObject<{
+    hetfo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    kedd: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    szerda: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    csutortok: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    pentek: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    szombat: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    vasarnap: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>;
+export type FoxpostOpeningHours = z.infer<typeof OpeningHoursSchema>;
+/**
+ * Fill/empty schedule entry
+ */
+declare const FillEmptyEntrySchema: z.ZodObject<{
+    emptying: z.ZodOptional<z.ZodString>;
+    filling: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type FoxpostFillEmptyEntry = z.infer<typeof FillEmptyEntrySchema>;
+/**
+ * Foxpost APM substitute entry
+ * When a pickup point is closed or unavailable, these are alternative locations
+ * where the customer can pick up/drop off their parcel.
+ */
+declare const FoxpostSubstituteSchema: z.ZodObject<{
+    place_id: z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>;
+    operator_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>;
+export type FoxpostSubstitute = z.infer<typeof FoxpostSubstituteSchema>;
+/**
+ * Foxpost APM metadata schema - carrier-specific fields
+ * Uses lenient validation with passthrough for future extensibility
+ */
+declare const FoxpostApmMetadataSchema: z.ZodObject<{
+    depot: z.ZodOptional<z.ZodString>;
+    load: z.ZodOptional<z.ZodString>;
+    apmType: z.ZodOptional<z.ZodString>;
+    substitutes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        place_id: z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>;
+        operator_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$loose>>>;
+    variant: z.ZodOptional<z.ZodString>;
+    fillEmptyList: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        emptying: z.ZodOptional<z.ZodString>;
+        filling: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    ssapt: z.ZodOptional<z.ZodString>;
+    sdapt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type FoxpostApmMetadata = z.infer<typeof FoxpostApmMetadataSchema>;
+declare const FoxpostApmEntrySchema: z.ZodObject<{
+    place_id: z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>;
+    operator_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    name: z.ZodOptional<z.ZodString>;
+    ssapt: z.ZodOptional<z.ZodString>;
+    sdapt: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    zip: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    street: z.ZodOptional<z.ZodString>;
+    findme: z.ZodOptional<z.ZodString>;
+    geolat: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    geolng: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    allowed2: z.ZodOptional<z.ZodEnum<{
+        ALL: "ALL";
+        C2C: "C2C";
+        B2C: "B2C";
+    }>>;
+    depot: z.ZodOptional<z.ZodString>;
+    load: z.ZodOptional<z.ZodString>;
+    isOutdoor: z.ZodOptional<z.ZodBoolean>;
+    apmType: z.ZodOptional<z.ZodString>;
+    substitutes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        place_id: z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodNumber, z.ZodTransform<string, number>>]>;
+        operator_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$loose>>>;
+    open: z.ZodOptional<z.ZodObject<{
+        hetfo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        kedd: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        szerda: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        csutortok: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        pentek: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        szombat: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        vasarnap: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$loose>>;
+    fillEmptyList: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        emptying: z.ZodOptional<z.ZodString>;
+        filling: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    cardPayment: z.ZodOptional<z.ZodBoolean>;
+    cashPayment: z.ZodOptional<z.ZodBoolean>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    paymentOptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paymentOptionsString: z.ZodOptional<z.ZodString>;
+    service: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    serviceString: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type FoxpostApmEntry = z.infer<typeof FoxpostApmEntrySchema>;
+declare const FoxpostFetchPickupPointsRequestSchema: z.ZodObject<{
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    options: z.ZodOptional<z.ZodObject<{
+        foxpost: z.ZodOptional<z.ZodObject<{
+            country: z.ZodOptional<z.ZodString>;
+            bbox: z.ZodOptional<z.ZodObject<{
+                north: z.ZodNumber;
+                south: z.ZodNumber;
+                east: z.ZodNumber;
+                west: z.ZodNumber;
+            }, z.core.$strip>>;
+            updatedSince: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type FoxpostFetchPickupPointsRequest = z.infer<typeof FoxpostFetchPickupPointsRequestSchema>;
+/**
+ * Helper to safely validate a Foxpost APM feed (array of entries)
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostApmFeed(feed: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    place_id: string;
+    operator_id?: string | null | undefined;
+    name?: string | undefined;
+    ssapt?: string | undefined;
+    sdapt?: string | undefined;
+    country?: string | undefined;
+    address?: string | undefined;
+    zip?: string | undefined;
+    city?: string | undefined;
+    street?: string | undefined;
+    findme?: string | undefined;
+    geolat?: number | undefined;
+    geolng?: number | undefined;
+    allowed2?: "ALL" | "C2C" | "B2C" | undefined;
+    depot?: string | undefined;
+    load?: string | undefined;
+    isOutdoor?: boolean | undefined;
+    apmType?: string | undefined;
+    substitutes?: {
+        [x: string]: unknown;
+        place_id: string;
+        operator_id?: string | null | undefined;
+    }[] | undefined;
+    open?: {
+        [x: string]: unknown;
+        hetfo?: string | null | undefined;
+        kedd?: string | null | undefined;
+        szerda?: string | null | undefined;
+        csutortok?: string | null | undefined;
+        pentek?: string | null | undefined;
+        szombat?: string | null | undefined;
+        vasarnap?: string | null | undefined;
+    } | undefined;
+    fillEmptyList?: {
+        [x: string]: unknown;
+        emptying?: string | undefined;
+        filling?: string | undefined;
+    }[] | undefined;
+    cardPayment?: boolean | undefined;
+    cashPayment?: boolean | undefined;
+    iconUrl?: string | undefined;
+    variant?: string | undefined;
+    paymentOptions?: string[] | undefined;
+    paymentOptionsString?: string | undefined;
+    service?: string[] | undefined;
+    serviceString?: string | undefined;
+}[]>;
+/**
+ * Helper to safely validate a single Foxpost APM entry
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function safeValidateFoxpostApmEntry(entry: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    place_id: string;
+    operator_id?: string | null | undefined;
+    name?: string | undefined;
+    ssapt?: string | undefined;
+    sdapt?: string | undefined;
+    country?: string | undefined;
+    address?: string | undefined;
+    zip?: string | undefined;
+    city?: string | undefined;
+    street?: string | undefined;
+    findme?: string | undefined;
+    geolat?: number | undefined;
+    geolng?: number | undefined;
+    allowed2?: "ALL" | "C2C" | "B2C" | undefined;
+    depot?: string | undefined;
+    load?: string | undefined;
+    isOutdoor?: boolean | undefined;
+    apmType?: string | undefined;
+    substitutes?: {
+        [x: string]: unknown;
+        place_id: string;
+        operator_id?: string | null | undefined;
+    }[] | undefined;
+    open?: {
+        [x: string]: unknown;
+        hetfo?: string | null | undefined;
+        kedd?: string | null | undefined;
+        szerda?: string | null | undefined;
+        csutortok?: string | null | undefined;
+        pentek?: string | null | undefined;
+        szombat?: string | null | undefined;
+        vasarnap?: string | null | undefined;
+    } | undefined;
+    fillEmptyList?: {
+        [x: string]: unknown;
+        emptying?: string | undefined;
+        filling?: string | undefined;
+    }[] | undefined;
+    cardPayment?: boolean | undefined;
+    cashPayment?: boolean | undefined;
+    iconUrl?: string | undefined;
+    variant?: string | undefined;
+    paymentOptions?: string[] | undefined;
+    paymentOptionsString?: string | undefined;
+    service?: string[] | undefined;
+    serviceString?: string | undefined;
+}>;
+/**
+ * Helper to validate Foxpost fetchPickupPoints request envelope.
+ */
+export declare function safeValidateFetchPickupPointsRequest(input: unknown): z.ZodSafeParseResult<{
+    credentials?: Record<string, unknown> | undefined;
+    options?: {
+        [x: string]: unknown;
+        foxpost?: {
+            [x: string]: unknown;
+            country?: string | undefined;
+            bbox?: {
+                north: number;
+                south: number;
+                east: number;
+                west: number;
+            } | undefined;
+            updatedSince?: string | Date | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export {};
+//# sourceMappingURL=validation.d.ts.map