@shopickup/adapters-mpl 0.0.1

package/dist/validation.d.ts

@@ -0,0 +1,1890 @@
+import { z } from 'zod';
+import type { Parcel, FetchPickupPointsRequest as CoreFetchPickupPointsRequest } from '@shopickup/core';
+/**
+ * Injects authType discriminant based on presence of oAuth2Token or apiKey.
+ * Allows callers to pass credentials without explicitly setting authType.
+ */
+export declare const MPLCredentialsSchema: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    authType: z.ZodLiteral<"apiKey">;
+    apiKey: z.ZodString;
+    apiSecret: z.ZodString;
+    accountingCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    authType: z.ZodLiteral<"oauth2">;
+    oAuth2Token: z.ZodString;
+    accountingCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "authType">>;
+export type MPLCredentials = z.infer<typeof MPLCredentialsSchema>;
+/**
+ * Schema for servicePointTypes
+ *
+ * 'PM' - Postán Maradó (Post Office)
+ * 'HA' - Házhozszállítás (Home Delivery)
+ * 'RA' - Raklapos Kézbesítés (Pallet Delivery)
+ * 'PP' - PostaPont (Post Point)
+ * 'CS' - Csomagautomata (Parcel Locker)
+ */
+declare const ServicePointTypeSchema: z.ZodEnum<{
+    PM: "PM";
+    PP: "PP";
+    CS: "CS";
+    HA: "HA";
+    RA: "RA";
+}>;
+export type ServicePointType = z.infer<typeof ServicePointTypeSchema>;
+declare const PickupServicePointTypeSchema: z.ZodEnum<{
+    PM: "PM";
+    PP: "PP";
+    CS: "CS";
+}>;
+export type PickupServicePointType = z.infer<typeof PickupServicePointTypeSchema>;
+export declare const FetchPickupPointsMPLCarrierOptionsSchema: z.ZodObject<{
+    accountingCode: z.ZodString;
+    postCode: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    city: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    servicePointType: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        PM: "PM";
+        PP: "PP";
+        CS: "CS";
+    }>>>;
+}, z.core.$strip>;
+export type FetchPickupPointsMPLCarrierOptions = z.infer<typeof FetchPickupPointsMPLCarrierOptionsSchema>;
+export declare const FetchPickupPointsMPLOptionsSchema: z.ZodObject<{
+    useTestApi: z.ZodOptional<z.ZodBoolean>;
+    mpl: z.ZodObject<{
+        accountingCode: z.ZodString;
+        postCode: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        city: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+        servicePointType: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            PM: "PM";
+            PP: "PP";
+            CS: "CS";
+        }>>>;
+    }, z.core.$strip>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type FetchPickupPointsMPLOptions = z.infer<typeof FetchPickupPointsMPLOptionsSchema>;
+export interface FetchPickupPointsRequestMPL extends Omit<CoreFetchPickupPointsRequest, 'options' | 'credentials'> {
+    credentials: MPLCredentials;
+    options: FetchPickupPointsMPLOptions;
+}
+/**
+ * Schema for fetchPickupPoints request
+ *
+ * Requires MPLCredentials
+ *
+ * Optional filters:
+ * - postCode: 4-character string
+ * - city: string
+ * - servicePointType: one of the defined ServicePointType values
+ */
+export declare const FetchPickupPointsMPLSchema: z.ZodObject<{
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+        mpl: z.ZodObject<{
+            accountingCode: z.ZodString;
+            postCode: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+            city: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+            servicePointType: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                PM: "PM";
+                PP: "PP";
+                CS: "CS";
+            }>>>;
+        }, z.core.$strip>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type FetchPickupPointsMPLRequest = FetchPickupPointsRequestMPL;
+/**
+ * Schema for exchangeAuthToken request
+ *
+ * Requires Basic auth credentials (apiKey + apiSecret)
+ * Optional: useTestApi flag to use sandbox OAuth endpoint
+ */
+export declare const ExchangeAuthTokenRequestSchema: z.ZodObject<{
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">> & z.ZodType<{
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    }, unknown>>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExchangeAuthTokenRequest = z.infer<typeof ExchangeAuthTokenRequestSchema>;
+/**
+ * OAuth token response from MPL /oauth2/token endpoint
+ */
+export interface MPLOAuthTokenResponse {
+    access_token: string;
+    token_type: 'Bearer';
+    expires_in: number;
+    issued_at?: number;
+}
+/**
+ * Normalized response for exchangeAuthToken capability
+ */
+export interface ExchangeAuthTokenResponse {
+    access_token: string;
+    token_type: 'Bearer';
+    expires_in: number;
+    issued_at?: number;
+    raw: MPLOAuthTokenResponse;
+}
+/**
+ * Types for the MPL fetchPickupPoints response
+ * Returns either an array of pickup points (200 OK) or a gateway error (4xx/5xx)
+ */
+export type MPLPickupPointResponse = MPLAPIGatewayErrorResponse | MPLPickupPointEntry[];
+/**
+ * Single delivery place entry from the 200 response
+ */
+export interface MPLPickupPointEntry {
+    deliveryplacesQueryResult: {
+        deliveryplace: string;
+        postCode: string;
+        city: string;
+        address: string;
+        geocodeLat: number;
+        geocodeLong: number;
+        id: string;
+        errors: MPLPickupPointEntryError[] | null;
+    };
+    servicePointType: PickupServicePointType[];
+}
+/**
+ * Error details within a pickup point entry
+ */
+export interface MPLPickupPointEntryError {
+    code: string;
+    parameter: string;
+    text: string;
+    text_eng: string;
+}
+/**
+ * Gateway error response structure
+ *
+ * Returned for HTTP error statuses:
+ * - 400 Bad request.           - Invalid request format or parameters.
+ * - 401 Unauthorized.          - The provided access token is not valid.
+ * - 403 Forbidden.             - The caller client is not configured to call the APIs published on the requested host:port.
+ * - 404 Not found.             - The given path is not mapped to any valid path in the API Proxy.
+ * - 429 Too many requests.     - Spike Arrest Fault or Quota Limit Fault. Check X-Quota-Reset, X-Quota-Allowed, X-Quota-Available response headers.
+ * - 500 Internal server error. - An unexpected error occurred in the backend system.
+ * - 503 Service unavailable.   - The backend service is unavailable for some reason.
+ *
+ * Check the value of the X-Error-Source response header:
+ * - If "Backend", the error was generated in the backend system.
+ * - If "Gateway", the error was generated in the API Gateway.
+ */
+export interface MPLAPIGatewayErrorResponse {
+    fault: {
+        faultstring: string;
+        detail: {
+            errorcode: string;
+        };
+    };
+}
+/**
+ * Helper functions to validate MPL adapter requests
+ */
+/**
+ * Helper: validate credentials in one pass and get authType
+ */
+export declare function safeValidateCredentials(input: unknown): z.ZodSafeParseResult<{
+    authType: "apiKey";
+    apiKey: string;
+    apiSecret: string;
+    accountingCode?: string | undefined;
+} | {
+    authType: "oauth2";
+    oAuth2Token: string;
+    accountingCode?: string | undefined;
+}>;
+/**
+ * Helper: validate full fetchPickupPoints request
+ */
+export declare function safeValidateFetchPickupPointsRequest(input: unknown): z.ZodSafeParseResult<{
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options: {
+        [x: string]: unknown;
+        mpl: {
+            accountingCode: string;
+            postCode?: string | undefined;
+            city?: string | undefined;
+            servicePointType?: ("PM" | "PP" | "CS")[] | undefined;
+        };
+        useTestApi?: boolean | undefined;
+    };
+}>;
+/**
+ * Helper: validate exchangeAuthToken request
+ */
+export declare function safeValidateExchangeAuthTokenRequest(input: unknown): z.ZodSafeParseResult<{
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    };
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Type guard: check if response is a gateway error
+ */
+export declare function isGatewayError(response: unknown): response is MPLAPIGatewayErrorResponse;
+/**
+ * Type guard: check if response is a successful 200 response
+ *
+ * Strict validation: response MUST be an array of MPL pickup point entries.
+ * Follows Foxpost pattern for consistency across adapters.
+ */
+export declare function isSuccessResponse(response: unknown): response is MPLPickupPointEntry[];
+/**
+ * Basic service codes from OpenAPI
+ * Represents available postal services
+ */
+export declare const BasicServiceCodeSchema: z.ZodEnum<{
+    A_175_UZL: "A_175_UZL";
+    A_177_MPC: "A_177_MPC";
+    A_176_NET: "A_176_NET";
+    A_176_NKP: "A_176_NKP";
+    A_122_ECS: "A_122_ECS";
+    A_121_CSG: "A_121_CSG";
+    A_13_EMS: "A_13_EMS";
+    A_123_EUP: "A_123_EUP";
+    A_123_HAR: "A_123_HAR";
+    A_123_HAI: "A_123_HAI";
+    A_125_HAR: "A_125_HAR";
+    A_125_HAI: "A_125_HAI";
+}>;
+export type BasicServiceCode = z.infer<typeof BasicServiceCodeSchema>;
+/**
+ * Delivery modes from OpenAPI
+ * HA  - Házhozszállítás (Home Delivery)
+ * RA  - Raklapos Kézbesítés (Pallet Delivery)
+ * PP  - PostaPont (Post Point)
+ * CS  - Csomagautomata (Parcel Locker)
+ * PM  - Postán Maradó (Post Office)
+ */
+export declare const DeliveryModeSchema: z.ZodEnum<{
+    PM: "PM";
+    PP: "PP";
+    CS: "CS";
+    HA: "HA";
+    RA: "RA";
+}>;
+export type DeliveryMode = z.infer<typeof DeliveryModeSchema>;
+/**
+ * Label type/format for address labels
+ */
+export declare const LabelTypeSchema: z.ZodEnum<{
+    A4: "A4";
+    A5: "A5";
+    A5inA4: "A5inA4";
+    A5E: "A5E";
+    A5E_EXTRA: "A5E_EXTRA";
+    A5E_STAND: "A5E_STAND";
+    A6: "A6";
+    A6inA4: "A6inA4";
+    A4ONE: "A4ONE";
+}>;
+export type LabelType = z.infer<typeof LabelTypeSchema>;
+/**
+ * Label file format
+ */
+export declare const LabelFormatSchema: z.ZodEnum<{
+    PDF: "PDF";
+    ZPL: "ZPL";
+}>;
+export type LabelFormat = z.infer<typeof LabelFormatSchema>;
+/**
+ * Package size enum
+ */
+export declare const PackageSizeSchema: z.ZodEnum<{
+    S: "S";
+    M: "M";
+    L: "L";
+    PRINT: "PRINT";
+    PACK: "PACK";
+}>;
+export type PackageSize = z.infer<typeof PackageSizeSchema>;
+/**
+ * Extra services codes (subset relevant for CREATE_SHIPMENT)
+ * These are additional paid services that can be added to shipments
+ */
+export declare const ExtraServiceCodeSchema: z.ZodEnum<{
+    K_ENY: "K_ENY";
+    K_TER: "K_TER";
+    K_UVT: "K_UVT";
+    K_TOR: "K_TOR";
+    K_ORZ: "K_ORZ";
+    K_IDO: "K_IDO";
+    K_RLC: "K_RLC";
+    K_TEV: "K_TEV";
+    K_CSE: "K_CSE";
+    K_CSA: "K_CSA";
+    K_IDA: "K_IDA";
+    K_FNK: "K_FNK";
+}>;
+export type ExtraServiceCode = z.infer<typeof ExtraServiceCodeSchema>;
+/**
+ * Delivery time preference (for time window delivery)
+ */
+export declare const DeliveryTimeSchema: z.ZodEnum<{
+    earlyMorning: "earlyMorning";
+    morning: "morning";
+    afternoon: "afternoon";
+    evening: "evening";
+}>;
+export type DeliveryTime = z.infer<typeof DeliveryTimeSchema>;
+/**
+ * UnitValue - weight/size with unit
+ */
+export declare const UnitValueSchema: z.ZodObject<{
+    value: z.ZodNumber;
+    unit: z.ZodOptional<z.ZodEnum<{
+        kg: "kg";
+        g: "g";
+    }>>;
+}, z.core.$strip>;
+export type UnitValue = z.infer<typeof UnitValueSchema>;
+/**
+ * Contact information (name, organization, phone, email)
+ */
+export declare const ContactSchema: z.ZodObject<{
+    name: z.ZodString;
+    organization: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Contact = z.infer<typeof ContactSchema>;
+/**
+ * Address information
+ */
+export declare const AddressSchema: z.ZodObject<{
+    postCode: z.ZodString;
+    city: z.ZodString;
+    address: z.ZodString;
+}, z.core.$strip>;
+export type Address = z.infer<typeof AddressSchema>;
+/**
+ * Delivery address (same as regular address but includes optional parcelPickupSite)
+ */
+export declare const DeliveryAddressSchema: z.ZodObject<{
+    postCode: z.ZodString;
+    city: z.ZodString;
+    address: z.ZodString;
+    parcelPickupSite: z.ZodOptional<z.ZodString>;
+    countryCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeliveryAddress = z.infer<typeof DeliveryAddressSchema>;
+/**
+ * Recipient information
+ */
+export declare const RecipientSchema: z.ZodObject<{
+    contact: z.ZodObject<{
+        name: z.ZodString;
+        organization: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    address: z.ZodObject<{
+        postCode: z.ZodString;
+        city: z.ZodString;
+        address: z.ZodString;
+        parcelPickupSite: z.ZodOptional<z.ZodString>;
+        countryCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    luaCode: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type Recipient = z.infer<typeof RecipientSchema>;
+/**
+ * Sender information
+ */
+export declare const SenderSchema: z.ZodObject<{
+    agreement: z.ZodString;
+    accountNo: z.ZodOptional<z.ZodString>;
+    contact: z.ZodObject<{
+        name: z.ZodString;
+        organization: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    address: z.ZodObject<{
+        postCode: z.ZodString;
+        city: z.ZodString;
+        address: z.ZodString;
+    }, z.core.$strip>;
+    parcelTerminal: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type Sender = z.infer<typeof SenderSchema>;
+/**
+ * Service configuration for a shipment item
+ */
+export declare const ServiceSchema: z.ZodObject<{
+    basic: z.ZodEnum<{
+        A_175_UZL: "A_175_UZL";
+        A_177_MPC: "A_177_MPC";
+        A_176_NET: "A_176_NET";
+        A_176_NKP: "A_176_NKP";
+        A_122_ECS: "A_122_ECS";
+        A_121_CSG: "A_121_CSG";
+        A_13_EMS: "A_13_EMS";
+        A_123_EUP: "A_123_EUP";
+        A_123_HAR: "A_123_HAR";
+        A_123_HAI: "A_123_HAI";
+        A_125_HAR: "A_125_HAR";
+        A_125_HAI: "A_125_HAI";
+    }>;
+    deliveryMode: z.ZodEnum<{
+        PM: "PM";
+        PP: "PP";
+        CS: "CS";
+        HA: "HA";
+        RA: "RA";
+    }>;
+    extra: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        K_ENY: "K_ENY";
+        K_TER: "K_TER";
+        K_UVT: "K_UVT";
+        K_TOR: "K_TOR";
+        K_ORZ: "K_ORZ";
+        K_IDO: "K_IDO";
+        K_RLC: "K_RLC";
+        K_TEV: "K_TEV";
+        K_CSE: "K_CSE";
+        K_CSA: "K_CSA";
+        K_IDA: "K_IDA";
+        K_FNK: "K_FNK";
+    }>>>;
+    cod: z.ZodOptional<z.ZodNumber>;
+    value: z.ZodOptional<z.ZodNumber>;
+    codCurrency: z.ZodOptional<z.ZodString>;
+    customsValue: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Service = z.infer<typeof ServiceSchema>;
+/**
+ * Item/Parcel information
+ */
+export declare const ItemSchema: z.ZodObject<{
+    customData1: z.ZodOptional<z.ZodString>;
+    customData2: z.ZodOptional<z.ZodString>;
+    weight: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNumber;
+        unit: z.ZodOptional<z.ZodEnum<{
+            kg: "kg";
+            g: "g";
+        }>>;
+    }, z.core.$strip>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        S: "S";
+        M: "M";
+        L: "L";
+        PRINT: "PRINT";
+        PACK: "PACK";
+    }>>;
+    services: z.ZodObject<{
+        basic: z.ZodEnum<{
+            A_175_UZL: "A_175_UZL";
+            A_177_MPC: "A_177_MPC";
+            A_176_NET: "A_176_NET";
+            A_176_NKP: "A_176_NKP";
+            A_122_ECS: "A_122_ECS";
+            A_121_CSG: "A_121_CSG";
+            A_13_EMS: "A_13_EMS";
+            A_123_EUP: "A_123_EUP";
+            A_123_HAR: "A_123_HAR";
+            A_123_HAI: "A_123_HAI";
+            A_125_HAR: "A_125_HAR";
+            A_125_HAI: "A_125_HAI";
+        }>;
+        deliveryMode: z.ZodEnum<{
+            PM: "PM";
+            PP: "PP";
+            CS: "CS";
+            HA: "HA";
+            RA: "RA";
+        }>;
+        extra: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            K_ENY: "K_ENY";
+            K_TER: "K_TER";
+            K_UVT: "K_UVT";
+            K_TOR: "K_TOR";
+            K_ORZ: "K_ORZ";
+            K_IDO: "K_IDO";
+            K_RLC: "K_RLC";
+            K_TEV: "K_TEV";
+            K_CSE: "K_CSE";
+            K_CSA: "K_CSA";
+            K_IDA: "K_IDA";
+            K_FNK: "K_FNK";
+        }>>>;
+        cod: z.ZodOptional<z.ZodNumber>;
+        value: z.ZodOptional<z.ZodNumber>;
+        codCurrency: z.ZodOptional<z.ZodString>;
+        customsValue: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    senderParcelPickupSite: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Item = z.infer<typeof ItemSchema>;
+/**
+ * Invoice information (optional, for billing)
+ */
+export declare const InvoiceSchema: z.ZodObject<{
+    name: z.ZodString;
+    postCode: z.ZodString;
+    city: z.ZodString;
+    address: z.ZodString;
+    vatIdentificationNumber: z.ZodString;
+}, z.core.$strip>;
+export type Invoice = z.infer<typeof InvoiceSchema>;
+/**
+ * Shipment creation request (maps to OpenAPI ShipmentCreateRequest)
+ * This is ONE shipment that can contain multiple items (parcels)
+ */
+export declare const ShipmentCreateRequestSchema: z.ZodObject<{
+    developer: z.ZodString;
+    sender: z.ZodObject<{
+        agreement: z.ZodString;
+        accountNo: z.ZodOptional<z.ZodString>;
+        contact: z.ZodObject<{
+            name: z.ZodString;
+            organization: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        address: z.ZodObject<{
+            postCode: z.ZodString;
+            city: z.ZodString;
+            address: z.ZodString;
+        }, z.core.$strip>;
+        parcelTerminal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    recipient: z.ZodObject<{
+        contact: z.ZodObject<{
+            name: z.ZodString;
+            organization: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        address: z.ZodObject<{
+            postCode: z.ZodString;
+            city: z.ZodString;
+            address: z.ZodString;
+            parcelPickupSite: z.ZodOptional<z.ZodString>;
+            countryCode: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        luaCode: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    webshopId: z.ZodString;
+    orderId: z.ZodOptional<z.ZodString>;
+    shipmentDate: z.ZodOptional<z.ZodString>;
+    labelType: z.ZodOptional<z.ZodEnum<{
+        A4: "A4";
+        A5: "A5";
+        A5inA4: "A5inA4";
+        A5E: "A5E";
+        A5E_EXTRA: "A5E_EXTRA";
+        A5E_STAND: "A5E_STAND";
+        A6: "A6";
+        A6inA4: "A6inA4";
+        A4ONE: "A4ONE";
+    }>>;
+    labelFormat: z.ZodOptional<z.ZodEnum<{
+        PDF: "PDF";
+        ZPL: "ZPL";
+    }>>;
+    tag: z.ZodOptional<z.ZodString>;
+    groupTogether: z.ZodOptional<z.ZodBoolean>;
+    deliveryTime: z.ZodOptional<z.ZodEnum<{
+        earlyMorning: "earlyMorning";
+        morning: "morning";
+        afternoon: "afternoon";
+        evening: "evening";
+    }>>;
+    deliveryDate: z.ZodOptional<z.ZodString>;
+    item: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        customData1: z.ZodOptional<z.ZodString>;
+        customData2: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodObject<{
+            value: z.ZodNumber;
+            unit: z.ZodOptional<z.ZodEnum<{
+                kg: "kg";
+                g: "g";
+            }>>;
+        }, z.core.$strip>>;
+        size: z.ZodOptional<z.ZodEnum<{
+            S: "S";
+            M: "M";
+            L: "L";
+            PRINT: "PRINT";
+            PACK: "PACK";
+        }>>;
+        services: z.ZodObject<{
+            basic: z.ZodEnum<{
+                A_175_UZL: "A_175_UZL";
+                A_177_MPC: "A_177_MPC";
+                A_176_NET: "A_176_NET";
+                A_176_NKP: "A_176_NKP";
+                A_122_ECS: "A_122_ECS";
+                A_121_CSG: "A_121_CSG";
+                A_13_EMS: "A_13_EMS";
+                A_123_EUP: "A_123_EUP";
+                A_123_HAR: "A_123_HAR";
+                A_123_HAI: "A_123_HAI";
+                A_125_HAR: "A_125_HAR";
+                A_125_HAI: "A_125_HAI";
+            }>;
+            deliveryMode: z.ZodEnum<{
+                PM: "PM";
+                PP: "PP";
+                CS: "CS";
+                HA: "HA";
+                RA: "RA";
+            }>;
+            extra: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                K_ENY: "K_ENY";
+                K_TER: "K_TER";
+                K_UVT: "K_UVT";
+                K_TOR: "K_TOR";
+                K_ORZ: "K_ORZ";
+                K_IDO: "K_IDO";
+                K_RLC: "K_RLC";
+                K_TEV: "K_TEV";
+                K_CSE: "K_CSE";
+                K_CSA: "K_CSA";
+                K_IDA: "K_IDA";
+                K_FNK: "K_FNK";
+            }>>>;
+            cod: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodOptional<z.ZodNumber>;
+            codCurrency: z.ZodOptional<z.ZodString>;
+            customsValue: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        senderParcelPickupSite: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    paymentMode: z.ZodOptional<z.ZodEnum<{
+        UV_AT: "UV_AT";
+        UV_KP: "UV_KP";
+    }>>;
+    packageRetention: z.ZodOptional<z.ZodNumber>;
+    printRecipientData: z.ZodOptional<z.ZodEnum<{
+        PRINTALL: "PRINTALL";
+        PRINTPHONENUMBER: "PRINTPHONENUMBER";
+        PRINTEMAIL: "PRINTEMAIL";
+        PRINTNOTHING: "PRINTNOTHING";
+    }>>;
+}, z.core.$strip>;
+export type ShipmentCreateRequest = z.infer<typeof ShipmentCreateRequestSchema>;
+/**
+ * Replacement label information in response
+ */
+export declare const ReplacementLabelSchema: z.ZodObject<{
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReplacementLabel = z.infer<typeof ReplacementLabelSchema>;
+/**
+ * Error descriptor from MPL API
+ */
+export declare const ErrorDescriptorSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    parameter: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    text_eng: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ErrorDescriptor = z.infer<typeof ErrorDescriptorSchema>;
+/**
+ * Warning descriptor from MPL API
+ */
+export declare const WarningDescriptorSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    parameter: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    text_eng: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WarningDescriptor = z.infer<typeof WarningDescriptorSchema>;
+/**
+ * Shipment creation result (maps to OpenAPI ShipmentCreateResult)
+ * Response for ONE shipment
+ */
+export declare const ShipmentCreateResultSchema: z.ZodObject<{
+    webshopId: z.ZodOptional<z.ZodString>;
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    replacementTrackingNumber: z.ZodOptional<z.ZodString>;
+    replacementLabels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        trackingNumber: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    packageTrackingNumbers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dispatchId: z.ZodOptional<z.ZodNumber>;
+    suggestedRecipientPostCode: z.ZodOptional<z.ZodString>;
+    suggestedRecipientCity: z.ZodOptional<z.ZodString>;
+    suggestedRecipientAddress: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ShipmentCreateResult = z.infer<typeof ShipmentCreateResultSchema>;
+/**
+ * Helper: validate shipment creation request
+ */
+export declare function safeValidateShipmentCreateRequest(input: unknown): z.ZodSafeParseResult<{
+    developer: string;
+    sender: {
+        agreement: string;
+        contact: {
+            name: string;
+            organization?: string | undefined;
+            phone?: string | undefined;
+            email?: string | undefined;
+        };
+        address: {
+            postCode: string;
+            city: string;
+            address: string;
+        };
+        accountNo?: string | undefined;
+        parcelTerminal?: boolean | undefined;
+    };
+    recipient: {
+        contact: {
+            name: string;
+            organization?: string | undefined;
+            phone?: string | undefined;
+            email?: string | undefined;
+        };
+        address: {
+            postCode: string;
+            city: string;
+            address: string;
+            parcelPickupSite?: string | undefined;
+            countryCode?: string | undefined;
+        };
+        luaCode?: string | undefined;
+        disabled?: boolean | undefined;
+    };
+    webshopId: string;
+    orderId?: string | undefined;
+    shipmentDate?: string | undefined;
+    labelType?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+    labelFormat?: "PDF" | "ZPL" | undefined;
+    tag?: string | undefined;
+    groupTogether?: boolean | undefined;
+    deliveryTime?: "earlyMorning" | "morning" | "afternoon" | "evening" | undefined;
+    deliveryDate?: string | undefined;
+    item?: {
+        services: {
+            basic: "A_175_UZL" | "A_177_MPC" | "A_176_NET" | "A_176_NKP" | "A_122_ECS" | "A_121_CSG" | "A_13_EMS" | "A_123_EUP" | "A_123_HAR" | "A_123_HAI" | "A_125_HAR" | "A_125_HAI";
+            deliveryMode: "PM" | "PP" | "CS" | "HA" | "RA";
+            extra?: ("K_ENY" | "K_TER" | "K_UVT" | "K_TOR" | "K_ORZ" | "K_IDO" | "K_RLC" | "K_TEV" | "K_CSE" | "K_CSA" | "K_IDA" | "K_FNK")[] | undefined;
+            cod?: number | undefined;
+            value?: number | undefined;
+            codCurrency?: string | undefined;
+            customsValue?: number | undefined;
+        };
+        customData1?: string | undefined;
+        customData2?: string | undefined;
+        weight?: {
+            value: number;
+            unit?: "kg" | "g" | undefined;
+        } | undefined;
+        size?: "S" | "M" | "L" | "PRINT" | "PACK" | undefined;
+        senderParcelPickupSite?: string | undefined;
+    }[] | undefined;
+    paymentMode?: "UV_AT" | "UV_KP" | undefined;
+    packageRetention?: number | undefined;
+    printRecipientData?: "PRINTALL" | "PRINTPHONENUMBER" | "PRINTEMAIL" | "PRINTNOTHING" | undefined;
+}>;
+/**
+ * Helper: validate shipment creation result
+ */
+export declare function safeValidateShipmentCreateResult(input: unknown): z.ZodSafeParseResult<{
+    webshopId?: string | undefined;
+    trackingNumber?: string | undefined;
+    replacementTrackingNumber?: string | undefined;
+    replacementLabels?: {
+        trackingNumber?: string | undefined;
+        label?: string | undefined;
+    }[] | undefined;
+    packageTrackingNumbers?: string[] | undefined;
+    dispatchId?: number | undefined;
+    suggestedRecipientPostCode?: string | undefined;
+    suggestedRecipientCity?: string | undefined;
+    suggestedRecipientAddress?: string | undefined;
+    label?: string | undefined;
+    errors?: {
+        code?: string | undefined;
+        parameter?: string | undefined;
+        text?: string | undefined;
+        text_eng?: string | undefined;
+    }[] | undefined;
+    warnings?: {
+        code?: string | undefined;
+        parameter?: string | undefined;
+        text?: string | undefined;
+        text_eng?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * MPL-specific request options for CREATE_PARCELS.
+ *
+ * Cross-cutting fields stay at options root (e.g. useTestApi),
+ * while carrier-specific fields are namespaced under `options.mpl`.
+ * `accountingCode` is required for MPL.
+ */
+export declare const CreateParcelsMPLCarrierOptionsSchema: z.ZodObject<{
+    accountingCode: z.ZodString;
+    agreementCode: z.ZodString;
+    bankAccountNumber: z.ZodString;
+    labelType: z.ZodOptional<z.ZodEnum<{
+        A4: "A4";
+        A5: "A5";
+        A5inA4: "A5inA4";
+        A5E: "A5E";
+        A5E_EXTRA: "A5E_EXTRA";
+        A5E_STAND: "A5E_STAND";
+        A6: "A6";
+        A6inA4: "A6inA4";
+        A4ONE: "A4ONE";
+    }>>;
+}, z.core.$strip>;
+export type CreateParcelsMPLCarrierOptions = z.infer<typeof CreateParcelsMPLCarrierOptionsSchema>;
+export declare const CreateParcelsMPLOptionsSchema: z.ZodObject<{
+    useTestApi: z.ZodOptional<z.ZodBoolean>;
+    mpl: z.ZodObject<{
+        accountingCode: z.ZodString;
+        agreementCode: z.ZodString;
+        bankAccountNumber: z.ZodString;
+        labelType: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            A5: "A5";
+            A5inA4: "A5inA4";
+            A5E: "A5E";
+            A5E_EXTRA: "A5E_EXTRA";
+            A5E_STAND: "A5E_STAND";
+            A6: "A6";
+            A6inA4: "A6inA4";
+            A4ONE: "A4ONE";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type CreateParcelsMPLOptions = z.infer<typeof CreateParcelsMPLOptionsSchema>;
+/**
+ * Full CREATE_PARCELS request validator for MPL.
+ *
+ * This validates request envelope + credentials first, then capability-specific
+ * shipment payload validation continues in the mapper/Shipment schemas.
+ */
+export declare const CreateParcelsMPLRequestSchema: z.ZodObject<{
+    parcels: z.ZodArray<z.ZodCustom<Parcel, Parcel>>;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+        mpl: z.ZodObject<{
+            accountingCode: z.ZodString;
+            agreementCode: z.ZodString;
+            bankAccountNumber: z.ZodString;
+            labelType: z.ZodOptional<z.ZodEnum<{
+                A4: "A4";
+                A5: "A5";
+                A5inA4: "A5inA4";
+                A5E: "A5E";
+                A5E_EXTRA: "A5E_EXTRA";
+                A5E_STAND: "A5E_STAND";
+                A6: "A6";
+                A6inA4: "A6inA4";
+                A4ONE: "A4ONE";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CreateParcelsMPLRequest = z.infer<typeof CreateParcelsMPLRequestSchema>;
+/**
+ * Helper: validate full createParcels request
+ */
+export declare function safeValidateCreateParcelsRequest(input: unknown): z.ZodSafeParseResult<{
+    parcels: Parcel[];
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options: {
+        [x: string]: unknown;
+        mpl: {
+            accountingCode: string;
+            agreementCode: string;
+            bankAccountNumber: string;
+            labelType?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+        };
+        useTestApi?: boolean | undefined;
+    };
+}>;
+/**
+ * Full CREATE_PARCEL request validator for MPL.
+ *
+ * Mirrors CREATE_PARCELS requirements for a single parcel envelope.
+ */
+export declare const CreateParcelMPLRequestSchema: z.ZodObject<{
+    parcel: z.ZodCustom<Parcel, Parcel>;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+        mpl: z.ZodObject<{
+            accountingCode: z.ZodString;
+            agreementCode: z.ZodString;
+            bankAccountNumber: z.ZodString;
+            labelType: z.ZodOptional<z.ZodEnum<{
+                A4: "A4";
+                A5: "A5";
+                A5inA4: "A5inA4";
+                A5E: "A5E";
+                A5E_EXTRA: "A5E_EXTRA";
+                A5E_STAND: "A5E_STAND";
+                A6: "A6";
+                A6inA4: "A6inA4";
+                A4ONE: "A4ONE";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CreateParcelMPLRequest = z.infer<typeof CreateParcelMPLRequestSchema>;
+/**
+ * Helper: validate full createParcel request
+ */
+export declare function safeValidateCreateParcelRequest(input: unknown): z.ZodSafeParseResult<{
+    parcel: Parcel;
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options: {
+        [x: string]: unknown;
+        mpl: {
+            accountingCode: string;
+            agreementCode: string;
+            bankAccountNumber: string;
+            labelType?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+        };
+        useTestApi?: boolean | undefined;
+    };
+}>;
+/**
+ * Label order type from OpenAPI
+ * SENDING - Order by sending sequence
+ * IDENTIFIER - Order by tracking number identifier
+ */
+export declare const LabelOrderBySchema: z.ZodEnum<{
+    SENDING: "SENDING";
+    IDENTIFIER: "IDENTIFIER";
+}>;
+export type LabelOrderBy = z.infer<typeof LabelOrderBySchema>;
+/**
+ * Single label query result from MPL API
+ * Response for each tracking number requested
+ */
+export declare const LabelQueryResultSchema: z.ZodObject<{
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LabelQueryResult = z.infer<typeof LabelQueryResultSchema>;
+/**
+ * Request for creating labels via GET /shipments/label
+ *
+ * Pattern: cross-cutting options (e.g. `size`) live at `options.size` and
+ * MPL-specific knobs (accountingCode, labelFormat, singleFile, orderBy)
+ * live under `options.mpl`.
+ */
+export declare const CreateLabelsMPLCarrierOptionsSchema: z.ZodObject<{
+    accountingCode: z.ZodString;
+    labelFormat: z.ZodOptional<z.ZodEnum<{
+        PDF: "PDF";
+        ZPL: "ZPL";
+    }>>;
+    singleFile: z.ZodOptional<z.ZodBoolean>;
+    orderBy: z.ZodOptional<z.ZodEnum<{
+        SENDING: "SENDING";
+        IDENTIFIER: "IDENTIFIER";
+    }>>;
+    labelType: z.ZodOptional<z.ZodEnum<{
+        A4: "A4";
+        A5: "A5";
+        A5inA4: "A5inA4";
+        A5E: "A5E";
+        A5E_EXTRA: "A5E_EXTRA";
+        A5E_STAND: "A5E_STAND";
+        A6: "A6";
+        A6inA4: "A6inA4";
+        A4ONE: "A4ONE";
+    }>>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type CreateLabelsMPLCarrierOptions = z.infer<typeof CreateLabelsMPLCarrierOptionsSchema>;
+export declare const CreateLabelsMPLOptionsSchema: z.ZodObject<{
+    useTestApi: z.ZodBoolean;
+    size: z.ZodOptional<z.ZodEnum<{
+        A4: "A4";
+        A5: "A5";
+        A5inA4: "A5inA4";
+        A5E: "A5E";
+        A5E_EXTRA: "A5E_EXTRA";
+        A5E_STAND: "A5E_STAND";
+        A6: "A6";
+        A6inA4: "A6inA4";
+        A4ONE: "A4ONE";
+    }>>;
+    mpl: z.ZodObject<{
+        accountingCode: z.ZodString;
+        labelFormat: z.ZodOptional<z.ZodEnum<{
+            PDF: "PDF";
+            ZPL: "ZPL";
+        }>>;
+        singleFile: z.ZodOptional<z.ZodBoolean>;
+        orderBy: z.ZodOptional<z.ZodEnum<{
+            SENDING: "SENDING";
+            IDENTIFIER: "IDENTIFIER";
+        }>>;
+        labelType: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            A5: "A5";
+            A5inA4: "A5inA4";
+            A5E: "A5E";
+            A5E_EXTRA: "A5E_EXTRA";
+            A5E_STAND: "A5E_STAND";
+            A6: "A6";
+            A6inA4: "A6inA4";
+            A4ONE: "A4ONE";
+        }>>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type CreateLabelsMPLOptions = z.infer<typeof CreateLabelsMPLOptionsSchema>;
+export declare const CreateLabelsMPLRequestSchema: z.ZodObject<{
+    parcelCarrierIds: z.ZodArray<z.ZodString>;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodObject<{
+        useTestApi: z.ZodBoolean;
+        size: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            A5: "A5";
+            A5inA4: "A5inA4";
+            A5E: "A5E";
+            A5E_EXTRA: "A5E_EXTRA";
+            A5E_STAND: "A5E_STAND";
+            A6: "A6";
+            A6inA4: "A6inA4";
+            A4ONE: "A4ONE";
+        }>>;
+        mpl: z.ZodObject<{
+            accountingCode: z.ZodString;
+            labelFormat: z.ZodOptional<z.ZodEnum<{
+                PDF: "PDF";
+                ZPL: "ZPL";
+            }>>;
+            singleFile: z.ZodOptional<z.ZodBoolean>;
+            orderBy: z.ZodOptional<z.ZodEnum<{
+                SENDING: "SENDING";
+                IDENTIFIER: "IDENTIFIER";
+            }>>;
+            labelType: z.ZodOptional<z.ZodEnum<{
+                A4: "A4";
+                A5: "A5";
+                A5inA4: "A5inA4";
+                A5E: "A5E";
+                A5E_EXTRA: "A5E_EXTRA";
+                A5E_STAND: "A5E_STAND";
+                A6: "A6";
+                A6inA4: "A6inA4";
+                A4ONE: "A4ONE";
+            }>>;
+        }, z.core.$catchall<z.ZodUnknown>>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CreateLabelsMPLRequest = z.infer<typeof CreateLabelsMPLRequestSchema>;
+/**
+ * Helper: validate label creation request
+ */
+export declare function safeValidateCreateLabelsRequest(input: unknown): z.ZodSafeParseResult<{
+    parcelCarrierIds: string[];
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options: {
+        [x: string]: unknown;
+        useTestApi: boolean;
+        mpl: {
+            [x: string]: unknown;
+            accountingCode: string;
+            labelFormat?: "PDF" | "ZPL" | undefined;
+            singleFile?: boolean | undefined;
+            orderBy?: "SENDING" | "IDENTIFIER" | undefined;
+            labelType?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+        };
+        size?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+    };
+}>;
+/**
+ * Single-label request schema (carrier-specific)
+ * Mirrors the batch request but for a single `parcelCarrierId`.
+ */
+export declare const CreateLabelMPLRequestSchema: z.ZodObject<{
+    parcelCarrierId: z.ZodString;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodObject<{
+        useTestApi: z.ZodBoolean;
+        size: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            A5: "A5";
+            A5inA4: "A5inA4";
+            A5E: "A5E";
+            A5E_EXTRA: "A5E_EXTRA";
+            A5E_STAND: "A5E_STAND";
+            A6: "A6";
+            A6inA4: "A6inA4";
+            A4ONE: "A4ONE";
+        }>>;
+        mpl: z.ZodObject<{
+            accountingCode: z.ZodString;
+            labelFormat: z.ZodOptional<z.ZodEnum<{
+                PDF: "PDF";
+                ZPL: "ZPL";
+            }>>;
+            singleFile: z.ZodOptional<z.ZodBoolean>;
+            orderBy: z.ZodOptional<z.ZodEnum<{
+                SENDING: "SENDING";
+                IDENTIFIER: "IDENTIFIER";
+            }>>;
+            labelType: z.ZodOptional<z.ZodEnum<{
+                A4: "A4";
+                A5: "A5";
+                A5inA4: "A5inA4";
+                A5E: "A5E";
+                A5E_EXTRA: "A5E_EXTRA";
+                A5E_STAND: "A5E_STAND";
+                A6: "A6";
+                A6inA4: "A6inA4";
+                A4ONE: "A4ONE";
+            }>>;
+        }, z.core.$catchall<z.ZodUnknown>>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CreateLabelMPLRequest = z.infer<typeof CreateLabelMPLRequestSchema>;
+export declare function safeValidateCreateLabelRequest(input: unknown): z.ZodSafeParseResult<{
+    parcelCarrierId: string;
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options: {
+        [x: string]: unknown;
+        useTestApi: boolean;
+        mpl: {
+            [x: string]: unknown;
+            accountingCode: string;
+            labelFormat?: "PDF" | "ZPL" | undefined;
+            singleFile?: boolean | undefined;
+            orderBy?: "SENDING" | "IDENTIFIER" | undefined;
+            labelType?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+        };
+        size?: "A4" | "A5" | "A5inA4" | "A5E" | "A5E_EXTRA" | "A5E_STAND" | "A6" | "A6inA4" | "A4ONE" | undefined;
+    };
+}>;
+/**
+ * ShipmentCloseRequest mirrors OpenAPI components.schemas.ShipmentCloseRequest
+ * Only includes fields we need for building the MPL /shipments/close request.
+ */
+export declare const ShipmentCloseRequestSchema: z.ZodObject<{
+    fromDate: z.ZodOptional<z.ZodString>;
+    toDate: z.ZodOptional<z.ZodString>;
+    trackingNumbers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    checkList: z.ZodOptional<z.ZodBoolean>;
+    checkListWithPrice: z.ZodOptional<z.ZodBoolean>;
+    tag: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodOptional<z.ZodString>;
+    summaryList: z.ZodOptional<z.ZodBoolean>;
+    singleFile: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ShipmentCloseRequest = z.infer<typeof ShipmentCloseRequestSchema>;
+/**
+ * Full CLOSE_SHIPMENTS request envelope for MPL adapter
+ */
+export declare const CloseShipmentsMPLRequestSchema: z.ZodObject<{
+    close: z.ZodOptional<z.ZodObject<{
+        fromDate: z.ZodOptional<z.ZodString>;
+        toDate: z.ZodOptional<z.ZodString>;
+        trackingNumbers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        checkList: z.ZodOptional<z.ZodBoolean>;
+        checkListWithPrice: z.ZodOptional<z.ZodBoolean>;
+        tag: z.ZodOptional<z.ZodString>;
+        requestId: z.ZodOptional<z.ZodString>;
+        summaryList: z.ZodOptional<z.ZodBoolean>;
+        singleFile: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    trackingNumbers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+        mpl: z.ZodOptional<z.ZodObject<{
+            accountingCode: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type CloseShipmentsMPLRequest = z.infer<typeof CloseShipmentsMPLRequestSchema>;
+export declare function safeValidateCloseShipmentsRequest(input: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    close?: {
+        fromDate?: string | undefined;
+        toDate?: string | undefined;
+        trackingNumbers?: string[] | undefined;
+        checkList?: boolean | undefined;
+        checkListWithPrice?: boolean | undefined;
+        tag?: string | undefined;
+        requestId?: string | undefined;
+        summaryList?: boolean | undefined;
+        singleFile?: boolean | undefined;
+    } | undefined;
+    trackingNumbers?: string[] | undefined;
+    options?: {
+        useTestApi?: boolean | undefined;
+        mpl?: {
+            accountingCode: string;
+        } | undefined;
+    } | undefined;
+}>;
+/**
+ * Schema for GET_SHIPMENT_DETAILS request
+ * Retrieves shipment metadata by tracking number
+ */
+export declare const GetShipmentDetailsRequestSchema: z.ZodObject<{
+    trackingNumber: z.ZodString;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GetShipmentDetailsRequest = z.infer<typeof GetShipmentDetailsRequestSchema>;
+/**
+ * Helper: validate get shipment details request
+ */
+export declare function safeValidateGetShipmentDetailsRequest(input: unknown): z.ZodSafeParseResult<{
+    trackingNumber: string;
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Helper: validate shipment query response
+ */
+export declare function safeValidateShipmentQueryResponse(input: unknown): z.ZodSafeParseResult<{
+    shipment?: {
+        trackingNumber?: string | undefined;
+        orderId?: string | undefined;
+        tag?: string | undefined;
+        shipmentDate?: string | undefined;
+        packageRetention?: number | undefined;
+        paymentMode?: "UV_AT" | "UV_KP" | undefined;
+        sender?: {
+            name?: string | undefined;
+            street?: string | undefined;
+            city?: string | undefined;
+            postalCode?: string | undefined;
+            country?: string | undefined;
+            phone?: string | undefined;
+        } | undefined;
+        recipient?: {
+            name?: string | undefined;
+            street?: string | undefined;
+            city?: string | undefined;
+            postalCode?: string | undefined;
+            country?: string | undefined;
+            phone?: string | undefined;
+        } | undefined;
+        items?: {
+            [x: string]: unknown;
+            id?: string | undefined;
+            weight?: number | undefined;
+        }[] | undefined;
+    } | null | undefined;
+    errors?: {
+        code?: string | undefined;
+        parameter?: string | undefined;
+        text?: string | undefined;
+        text_eng?: string | undefined;
+    }[] | null | undefined;
+    metadata?: any;
+}>;
+/**
+ * Schema for Shipment query response
+ * Response from GET /shipments/{trackingNumber}
+ */
+export declare const ShipmentStateSchema: z.ZodObject<{
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    orderId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    shipmentDate: z.ZodOptional<z.ZodString>;
+    packageRetention: z.ZodOptional<z.ZodNumber>;
+    paymentMode: z.ZodOptional<z.ZodEnum<{
+        UV_AT: "UV_AT";
+        UV_KP: "UV_KP";
+    }>>;
+    sender: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    recipient: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>>;
+}, z.core.$strip>;
+export type ShipmentState = z.infer<typeof ShipmentStateSchema>;
+/**
+ * Schema for the response from GET /shipments/{trackingNumber}
+ */
+export declare const MPLShipmentQueryResultSchema: z.ZodObject<{
+    shipment: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        trackingNumber: z.ZodOptional<z.ZodString>;
+        orderId: z.ZodOptional<z.ZodString>;
+        tag: z.ZodOptional<z.ZodString>;
+        shipmentDate: z.ZodOptional<z.ZodString>;
+        packageRetention: z.ZodOptional<z.ZodNumber>;
+        paymentMode: z.ZodOptional<z.ZodEnum<{
+            UV_AT: "UV_AT";
+            UV_KP: "UV_KP";
+        }>>;
+        sender: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            street: z.ZodOptional<z.ZodString>;
+            city: z.ZodOptional<z.ZodString>;
+            postalCode: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        recipient: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            street: z.ZodOptional<z.ZodString>;
+            city: z.ZodOptional<z.ZodString>;
+            postalCode: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            weight: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+    }, z.core.$strip>>>;
+    errors: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    metadata: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+export type MPLShipmentQueryResult = z.infer<typeof MPLShipmentQueryResultSchema>;
+/**
+ * Schema for tracking request (Pull-1 endpoint)
+ * Retrieves tracking/trace information for one or more parcels
+ *
+ * Required:
+ * - trackingNumbers: array of one or more tracking numbers
+ * - credentials: MPLCredentials
+ *
+ * Optional:
+ * - state: 'last' (latest event only, faster) or 'all' (complete history)
+ * - useRegisteredEndpoint: false (Guest) or true (Registered with financial data)
+ * - useTestApi: use sandbox API instead of production
+ */
+export declare const TrackingRequestMPLSchema: z.ZodObject<{
+    trackingNumbers: z.ZodArray<z.ZodString>;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        last: "last";
+        all: "all";
+    }>>>;
+    useRegisteredEndpoint: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TrackingRequestMPL = z.infer<typeof TrackingRequestMPLSchema>;
+/**
+ * Helper: validate tracking request
+ */
+export declare function safeValidateTrackingRequest(input: unknown): z.ZodSafeParseResult<{
+    trackingNumbers: string[];
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    state: "last" | "all";
+    useRegisteredEndpoint: boolean;
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * MPL C-Code Tracking Record from Pull-1 API response
+ *
+ * Contains C0-C63 fields representing different tracking data.
+ * Guest endpoint excludes financial data (C2, C5, C41, C42, C58)
+ * Registered endpoint includes all fields
+ */
+export declare const MPLTrackingRecordSchema: z.ZodObject<{
+    c0: z.ZodOptional<z.ZodString>;
+    c1: z.ZodString;
+    c2: z.ZodOptional<z.ZodString>;
+    c4: z.ZodOptional<z.ZodString>;
+    c5: z.ZodOptional<z.ZodString>;
+    c6: z.ZodOptional<z.ZodString>;
+    c8: z.ZodOptional<z.ZodString>;
+    c9: z.ZodOptional<z.ZodString>;
+    c10: z.ZodOptional<z.ZodString>;
+    c11: z.ZodOptional<z.ZodString>;
+    c12: z.ZodOptional<z.ZodString>;
+    c13: z.ZodOptional<z.ZodString>;
+    c38: z.ZodOptional<z.ZodString>;
+    c39: z.ZodOptional<z.ZodString>;
+    c41: z.ZodOptional<z.ZodString>;
+    c42: z.ZodOptional<z.ZodString>;
+    c43: z.ZodOptional<z.ZodString>;
+    c49: z.ZodOptional<z.ZodString>;
+    c53: z.ZodOptional<z.ZodString>;
+    c55: z.ZodOptional<z.ZodString>;
+    c56: z.ZodOptional<z.ZodString>;
+    c57: z.ZodOptional<z.ZodString>;
+    c59: z.ZodOptional<z.ZodString>;
+    c60: z.ZodOptional<z.ZodString>;
+    c61: z.ZodOptional<z.ZodString>;
+    c63: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type MPLTrackingRecord = z.infer<typeof MPLTrackingRecordSchema>;
+/**
+ * Schema for tracking response from Pull-1 API
+ * Returns array of tracking records (one per tracking number) or error
+ */
+export declare const TrackingResponseMPLSchema: z.ZodObject<{
+    trackAndTrace: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        c0: z.ZodOptional<z.ZodString>;
+        c1: z.ZodString;
+        c2: z.ZodOptional<z.ZodString>;
+        c4: z.ZodOptional<z.ZodString>;
+        c5: z.ZodOptional<z.ZodString>;
+        c6: z.ZodOptional<z.ZodString>;
+        c8: z.ZodOptional<z.ZodString>;
+        c9: z.ZodOptional<z.ZodString>;
+        c10: z.ZodOptional<z.ZodString>;
+        c11: z.ZodOptional<z.ZodString>;
+        c12: z.ZodOptional<z.ZodString>;
+        c13: z.ZodOptional<z.ZodString>;
+        c38: z.ZodOptional<z.ZodString>;
+        c39: z.ZodOptional<z.ZodString>;
+        c41: z.ZodOptional<z.ZodString>;
+        c42: z.ZodOptional<z.ZodString>;
+        c43: z.ZodOptional<z.ZodString>;
+        c49: z.ZodOptional<z.ZodString>;
+        c53: z.ZodOptional<z.ZodString>;
+        c55: z.ZodOptional<z.ZodString>;
+        c56: z.ZodOptional<z.ZodString>;
+        c57: z.ZodOptional<z.ZodString>;
+        c59: z.ZodOptional<z.ZodString>;
+        c60: z.ZodOptional<z.ZodString>;
+        c61: z.ZodOptional<z.ZodString>;
+        c63: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export type TrackingResponseMPL = z.infer<typeof TrackingResponseMPLSchema>;
+/**
+ * Helper: validate tracking response
+ */
+export declare function safeValidateTrackingResponse(input: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    trackAndTrace?: {
+        [x: string]: unknown;
+        c1: string;
+        c0?: string | undefined;
+        c2?: string | undefined;
+        c4?: string | undefined;
+        c5?: string | undefined;
+        c6?: string | undefined;
+        c8?: string | undefined;
+        c9?: string | undefined;
+        c10?: string | undefined;
+        c11?: string | undefined;
+        c12?: string | undefined;
+        c13?: string | undefined;
+        c38?: string | undefined;
+        c39?: string | undefined;
+        c41?: string | undefined;
+        c42?: string | undefined;
+        c43?: string | undefined;
+        c49?: string | undefined;
+        c53?: string | undefined;
+        c55?: string | undefined;
+        c56?: string | undefined;
+        c57?: string | undefined;
+        c59?: string | undefined;
+        c60?: string | undefined;
+        c61?: string | undefined;
+        c63?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for Pull-500 start request (batch tracking submission)
+ *
+ * Required:
+ * - trackingNumbers: array of 1-500 tracking numbers
+ * - credentials: MPLCredentials
+ *
+ * Optional:
+ * - language: 'hu' (Hungarian, default) or 'en' (English)
+ * - useTestApi: use sandbox API
+ */
+export declare const Pull500StartRequestSchema: z.ZodObject<{
+    trackingNumbers: z.ZodArray<z.ZodString>;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    language: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        hu: "hu";
+        en: "en";
+    }>>>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Pull500StartRequest = z.infer<typeof Pull500StartRequestSchema>;
+/**
+ * Helper: validate Pull-500 start request
+ */
+export declare function safeValidatePull500StartRequest(input: unknown): z.ZodSafeParseResult<{
+    trackingNumbers: string[];
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    language?: "hu" | "en" | undefined;
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Schema for Pull-500 start response
+ * Returns trackingGUID for polling, plus any submission errors
+ */
+export declare const Pull500StartResponseSchema: z.ZodObject<{
+    trackingGUID: z.ZodString;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+export type Pull500StartResponse = z.infer<typeof Pull500StartResponseSchema>;
+/**
+ * Helper: validate Pull-500 start response
+ */
+export declare function safeValidatePull500StartResponse(input: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    trackingGUID: string;
+    errors?: {
+        code?: string | undefined;
+        parameter?: string | undefined;
+        text?: string | undefined;
+        text_eng?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for Pull-500 check request (poll for results)
+ *
+ * Required:
+ * - trackingGUID: UUID returned from start request
+ * - credentials: MPLCredentials
+ */
+export declare const Pull500CheckRequestSchema: z.ZodObject<{
+    trackingGUID: z.ZodString;
+    credentials: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        authType: z.ZodLiteral<"apiKey">;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        authType: z.ZodLiteral<"oauth2">;
+        oAuth2Token: z.ZodString;
+        accountingCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "authType">>;
+    options: z.ZodOptional<z.ZodObject<{
+        useTestApi: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Pull500CheckRequest = z.infer<typeof Pull500CheckRequestSchema>;
+/**
+ * Helper: validate Pull-500 check request
+ */
+export declare function safeValidatePull500CheckRequest(input: unknown): z.ZodSafeParseResult<{
+    trackingGUID: string;
+    credentials: {
+        authType: "apiKey";
+        apiKey: string;
+        apiSecret: string;
+        accountingCode?: string | undefined;
+    } | {
+        authType: "oauth2";
+        oAuth2Token: string;
+        accountingCode?: string | undefined;
+    };
+    options?: {
+        useTestApi?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Status values for Pull-500 check response
+ * NEW - Request received, queued
+ * INPROGRESS - Processing
+ * READY - Results available
+ * ERROR - Processing failed
+ */
+export declare const Pull500StatusSchema: z.ZodEnum<{
+    NEW: "NEW";
+    INPROGRESS: "INPROGRESS";
+    READY: "READY";
+    ERROR: "ERROR";
+}>;
+export type Pull500Status = z.infer<typeof Pull500StatusSchema>;
+/**
+ * Schema for Pull-500 check response
+ *
+ * Status progression: NEW -> INPROGRESS -> READY (or ERROR)
+ * When status=READY, report contains CSV-formatted tracking data
+ * report_fields contains column headers
+ */
+export declare const Pull500CheckResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        NEW: "NEW";
+        INPROGRESS: "INPROGRESS";
+        READY: "READY";
+        ERROR: "ERROR";
+    }>;
+    report: z.ZodOptional<z.ZodString>;
+    report_fields: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        parameter: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        text_eng: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+export type Pull500CheckResponse = z.infer<typeof Pull500CheckResponseSchema>;
+/**
+ * Helper: validate Pull-500 check response
+ */
+export declare function safeValidatePull500CheckResponse(input: unknown): z.ZodSafeParseResult<{
+    [x: string]: unknown;
+    status: "NEW" | "INPROGRESS" | "READY" | "ERROR";
+    report?: string | undefined;
+    report_fields?: string | undefined;
+    errors?: {
+        code?: string | undefined;
+        parameter?: string | undefined;
+        text?: string | undefined;
+        text_eng?: string | undefined;
+    }[] | undefined;
+}>;
+export {};
+//# sourceMappingURL=validation.d.ts.map