@shopickup/adapters-mpl 0.0.1

package/README.md

@@ -0,0 +1,43 @@
+# @shopickup/adapters-mpl
+
+MPL adapter for Shopickup.
+
+[GitHub repo](https://github.com/shopickup/shopickup-integration-layer)
+[Issues](https://github.com/shopickup/shopickup-integration-layer/issues)
+
+## What it does
+
+- `CREATE_PARCEL`
+- `CREATE_PARCELS`
+- `CREATE_LABEL`
+- `CREATE_LABELS`
+- `LIST_PICKUP_POINTS`
+- OAuth/basic auth exchange helpers
+
+## Install
+
+```bash
+pnpm add @shopickup/adapters-mpl @shopickup/core
+```
+
+## Quick start
+
+```ts
+import { MPLAdapter } from '@shopickup/adapters-mpl';
+import { createAxiosHttpClient } from '@shopickup/core';
+
+const adapter = new MPLAdapter();
+const http = createAxiosHttpClient();
+
+const result = await adapter.exchangeAuthToken(
+  {
+    credentials: { apiKey: 'your-api-key', apiSecret: 'your-api-secret' },
+    options: { useTestApi: true },
+  },
+  { http, logger: console }
+);
+```
+
+## Status
+
+Published as `0.x.x` while the adapter API is still evolving.

package/dist/capabilities/auth.d.ts

@@ -0,0 +1,39 @@
+/**
+ * MPL OAuth Token Exchange Capability
+ *
+ * Exchanges Basic auth credentials (apiKey + apiSecret) for an OAuth2 Bearer token.
+ *
+ * This capability allows integrators to:
+ * 1. Proactively exchange credentials for OAuth tokens
+ * 2. Cache tokens on their side (Redis, database, etc.)
+ * 3. Pass OAuth tokens on subsequent API calls instead of Basic auth
+ *
+ * Use cases:
+ * - Integrator wants to avoid Basic auth if disabled at account level
+ * - Integrator wants to cache tokens to reduce network calls
+ * - Integrator wants to manage token lifecycle explicitly
+ */
+import type { AdapterContext } from "@shopickup/core";
+import type { ResolveOAuthUrl } from "../utils/resolveBaseUrl.js";
+import { type ExchangeAuthTokenRequest, type ExchangeAuthTokenResponse } from "../validation.js";
+/**
+ * Exchange Basic auth credentials for an OAuth2 Bearer token
+ *
+ * POST to /oauth2/token with:
+ * - Authorization: Basic <base64(apiKey:apiSecret)>
+ * - Content-Type: application/x-www-form-urlencoded
+ * - Body: grant_type=client_credentials
+ * - X-Accounting-Code header (required by MPL)
+ * - X-Request-ID header (for tracking)
+ *
+ * Returns token with expiry information (typically 1 hour / 3600 seconds)
+ *
+ * @param req Request with apiKey + apiSecret credentials
+ * @param ctx Adapter context with HTTP client and logger
+ * @param resolveOAuthUrl Function to resolve OAuth endpoint URL (test vs. production)
+ * @param accountingCode Customer accounting code from MPL
+ * @returns ExchangeAuthTokenResponse with access_token, expires_in, etc.
+ * @throws CarrierError on invalid credentials or network failure
+ */
+export declare function exchangeAuthToken(req: ExchangeAuthTokenRequest, ctx: AdapterContext, resolveOAuthUrl: ResolveOAuthUrl, accountingCode: string): Promise<ExchangeAuthTokenResponse>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/capabilities/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/capabilities/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAG/B,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,yBAAyB,CAAC,CAuKpC"}

package/dist/capabilities/auth.js

@@ -0,0 +1,130 @@
+/**
+ * MPL OAuth Token Exchange Capability
+ *
+ * Exchanges Basic auth credentials (apiKey + apiSecret) for an OAuth2 Bearer token.
+ *
+ * This capability allows integrators to:
+ * 1. Proactively exchange credentials for OAuth tokens
+ * 2. Cache tokens on their side (Redis, database, etc.)
+ * 3. Pass OAuth tokens on subsequent API calls instead of Basic auth
+ *
+ * Use cases:
+ * - Integrator wants to avoid Basic auth if disabled at account level
+ * - Integrator wants to cache tokens to reduce network calls
+ * - Integrator wants to manage token lifecycle explicitly
+ */
+import { CarrierError, safeLog, createLogEntry, serializeForLog } from "@shopickup/core";
+import { safeValidateExchangeAuthTokenRequest, isGatewayError, } from "../validation.js";
+import { buildMPLHeaders } from "../utils/httpUtils.js";
+/**
+ * Exchange Basic auth credentials for an OAuth2 Bearer token
+ *
+ * POST to /oauth2/token with:
+ * - Authorization: Basic <base64(apiKey:apiSecret)>
+ * - Content-Type: application/x-www-form-urlencoded
+ * - Body: grant_type=client_credentials
+ * - X-Accounting-Code header (required by MPL)
+ * - X-Request-ID header (for tracking)
+ *
+ * Returns token with expiry information (typically 1 hour / 3600 seconds)
+ *
+ * @param req Request with apiKey + apiSecret credentials
+ * @param ctx Adapter context with HTTP client and logger
+ * @param resolveOAuthUrl Function to resolve OAuth endpoint URL (test vs. production)
+ * @param accountingCode Customer accounting code from MPL
+ * @returns ExchangeAuthTokenResponse with access_token, expires_in, etc.
+ * @throws CarrierError on invalid credentials or network failure
+ */
+export async function exchangeAuthToken(req, ctx, resolveOAuthUrl, accountingCode) {
+    if (!ctx.http) {
+        throw new CarrierError("HTTP client not provided in adapter context", "Permanent", { raw: "Missing ctx.http" });
+    }
+    try {
+        // Validate request format and credentials
+        const validated = safeValidateExchangeAuthTokenRequest(req);
+        if (!validated.success) {
+            // Extract detailed error messages from Zod validation
+            const errors = validated.error.issues.map((issue) => {
+                const path = issue.path.length > 0 ? `${issue.path.join('.')}` : 'root';
+                return `${path}: ${issue.message}`;
+            }).join('; ');
+            throw new CarrierError(`Invalid request: ${errors}`, "Validation", { raw: serializeForLog(validated.error) });
+        }
+        // Only apiKey credentials can be exchanged
+        if (validated.data.credentials.authType !== 'apiKey') {
+            throw new CarrierError("exchangeAuthToken requires apiKey credentials (apiKey + apiSecret), not oauth2 token", "Validation");
+        }
+        const useTestApi = validated.data.options?.useTestApi ?? false;
+        const oauthUrl = resolveOAuthUrl(validated.data.options);
+        safeLog(ctx.logger, 'debug', 'Exchanging Basic auth credentials for OAuth token', createLogEntry({ useTestApi, endpoint: '/oauth2/token' }, null, ctx, ['exchangeAuthToken']), ctx, ['exchangeAuthToken']);
+        // Make the OAuth token exchange request
+        // Body: application/x-www-form-urlencoded with grant_type=client_credentials
+        const httpResponse = await ctx.http.post(oauthUrl, new URLSearchParams({
+            grant_type: 'client_credentials',
+        }).toString(), {
+            headers: {
+                ...buildMPLHeaders(validated.data.credentials, accountingCode),
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+        });
+        // Handle non-200 responses (auth failures)
+        if (httpResponse.status !== 200) {
+            const body = httpResponse.body;
+            if (isGatewayError(body)) {
+                const faultString = body.fault?.faultstring || 'Unknown error';
+                const errorCode = body.fault?.detail?.errorcode || 'UNKNOWN';
+                ctx.logger?.warn("OAuth token exchange failed", {
+                    status: httpResponse.status,
+                    errorCode,
+                    faultString,
+                });
+                throw new CarrierError(`OAuth token exchange failed: ${faultString} (${errorCode})`, "Auth", {
+                    carrierCode: errorCode,
+                    raw: body,
+                });
+            }
+            else {
+                // Unexpected response format for error status
+                throw new CarrierError(`OAuth token exchange returned status ${httpResponse.status} with unexpected response format`, "Transient", { raw: body });
+            }
+        }
+        // Validate 200 response structure
+        const body = httpResponse.body;
+        if (!body || typeof body !== 'object' || !('access_token' in body)) {
+            throw new CarrierError("Invalid OAuth token response: missing access_token", "Permanent", { raw: body });
+        }
+        const tokenResponse = body;
+        if (!tokenResponse.access_token || typeof tokenResponse.access_token !== 'string') {
+            throw new CarrierError("Invalid OAuth token response: access_token is not a string", "Permanent", { raw: tokenResponse });
+        }
+        if (!tokenResponse.expires_in || typeof tokenResponse.expires_in !== 'number') {
+            throw new CarrierError("Invalid OAuth token response: expires_in is not a number", "Permanent", { raw: tokenResponse });
+        }
+        const result = {
+            access_token: tokenResponse.access_token,
+            token_type: tokenResponse.token_type || 'Bearer',
+            expires_in: tokenResponse.expires_in,
+            issued_at: tokenResponse.issued_at,
+            raw: tokenResponse,
+        };
+        safeLog(ctx.logger, 'info', 'OAuth token exchanged successfully', {
+            expiresIn: result.expires_in,
+            tokenType: result.token_type,
+            useTestApi,
+        }, ctx, ['exchangeAuthToken']);
+        return result;
+    }
+    catch (err) {
+        // Handle caught CarrierErrors
+        if (err instanceof CarrierError) {
+            throw err;
+        }
+        // Convert unknown errors to CarrierError
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        ctx.logger?.error("Failed to exchange OAuth token", {
+            error: errorMessage,
+            type: err instanceof Error ? err.constructor.name : typeof err,
+        });
+        throw new CarrierError(`Failed to exchange OAuth token: ${errorMessage}`, "Transient", { raw: err });
+    }
+}

package/dist/capabilities/close.d.ts

@@ -0,0 +1,8 @@
+import type { AdapterContext, CloseShipmentsRequest, CloseShipmentsResponse } from '@shopickup/core';
+import { ResolveBaseUrl } from '../utils/resolveBaseUrl.js';
+/**
+ * Close shipments for MPL
+ * Accepts core CloseShipmentsRequest-like shape but uses MPL-specific schema
+ */
+export declare function closeShipments(req: CloseShipmentsRequest | unknown, ctx: AdapterContext, resolveBaseUrl: ResolveBaseUrl): Promise<CloseShipmentsResponse>;
+//# sourceMappingURL=close.d.ts.map

package/dist/capabilities/close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../src/capabilities/close.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAIrG,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,qBAAqB,GAAG,OAAO,EACpC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAyEjC"}

package/dist/capabilities/close.js

@@ -0,0 +1,70 @@
+import { CarrierError, serializeForLog } from '@shopickup/core';
+import { safeValidateCloseShipmentsRequest } from '../validation.js';
+import { buildMPLHeaders } from '../utils/httpUtils.js';
+/**
+ * Close shipments for MPL
+ * Accepts core CloseShipmentsRequest-like shape but uses MPL-specific schema
+ */
+export async function closeShipments(req, ctx, resolveBaseUrl) {
+    try {
+        // Validate full request envelope against MPL-shaped schema if possible
+        const validatedReq = safeValidateCloseShipmentsRequest(req);
+        if (!validatedReq.success) {
+            throw new CarrierError('Invalid close shipments request', 'Validation', { raw: validatedReq });
+        }
+        const validated = validatedReq.data;
+        // MPL expects trackingNumbers array + mpl accounting code under options
+        const body = {
+            fromDate: validated.close?.fromDate ?? undefined,
+            toDate: validated.close?.toDate ?? undefined,
+            trackingNumbers: validated.trackingNumbers ?? validated.close?.trackingNumbers,
+            checkList: validated.close?.checkList,
+            checkListWithPrice: validated.close?.checkListWithPrice,
+            tag: validated.close?.tag,
+            requestId: validated.close?.requestId,
+            summaryList: validated.close?.summaryList,
+            singleFile: validated.close?.singleFile,
+        };
+        if (!ctx.http) {
+            throw new CarrierError('HTTP client not provided in context', 'Permanent');
+        }
+        // Resolve base URL (supports useTestApi via options.useTestApi)
+        const baseUrl = resolveBaseUrl({ useTestApi: (validated.options?.useTestApi) ?? false });
+        const url = `${baseUrl}/shipments/close`;
+        const accountingCode = validated.options?.mpl?.accountingCode;
+        // Build headers (uses validated credentials + accounting code)
+        const headers = buildMPLHeaders(validated.credentials, accountingCode ?? '');
+        ctx.logger?.debug('MPL: Closing shipments', { trackingNumbers: (body.trackingNumbers || []).length });
+        const httpRes = await ctx.http.post(url, body, { headers });
+        const parsed = httpRes.body;
+        // If response is array of ShipmentCloseResult per OpenAPI, normalize
+        const results = Array.isArray(parsed) ? parsed : [parsed];
+        // Build core CloseShipmentsResponse
+        const closeResults = results.map((r) => ({
+            manifestId: r.dispatchId?.toString?.() ?? undefined,
+            manifest: r.manifest ?? r.manifestSUM ?? r.manifestRA ?? undefined,
+            errors: r.errors,
+            warnings: r.warnings,
+            raw: r,
+        }));
+        const successCount = closeResults.filter((c) => !c.errors || c.errors.length === 0).length;
+        const failureCount = closeResults.length - successCount;
+        return {
+            results: closeResults,
+            successCount,
+            failureCount,
+            totalCount: closeResults.length,
+            allSucceeded: failureCount === 0 && closeResults.length > 0,
+            allFailed: successCount === 0 && closeResults.length > 0,
+            someFailed: failureCount > 0 && successCount > 0,
+            summary: `${successCount} manifests generated, ${failureCount} failed`,
+            rawCarrierResponse: serializeForLog(httpRes),
+        };
+    }
+    catch (err) {
+        if (err instanceof CarrierError)
+            throw err;
+        ctx.logger?.error('MPL: Close shipments failed', { error: err?.message });
+        throw new CarrierError(`Close shipments failed: ${err?.message ?? 'Unknown'}`, 'Transient', { raw: serializeForLog(err) });
+    }
+}

package/dist/capabilities/get-shipment-details.d.ts

@@ -0,0 +1,63 @@
+/**
+ * MPL Adapter: Get Shipment Details Capability
+ * Handles GET_SHIPMENT_DETAILS operation via GET /shipments/{trackingNumber}
+ *
+ * Retrieves shipment metadata including sender, recipient, items, and shipment state.
+ * Note: This returns shipment details/metadata, not tracking event history.
+ */
+import type { AdapterContext } from '@shopickup/core';
+import type { ResolveBaseUrl } from '../utils/resolveBaseUrl.js';
+/**
+ * Response type for GET_SHIPMENT_DETAILS operation
+ * Contains normalized shipment metadata from MPL API
+ */
+export interface ShipmentDetailsResponse {
+    /** Tracking/shipment number */
+    trackingNumber?: string;
+    /** Order ID if applicable */
+    orderId?: string;
+    /** Shipment date if available */
+    shipmentDate?: string;
+    /** Sender details */
+    sender?: {
+        name?: string;
+        street?: string;
+        city?: string;
+        postalCode?: string;
+        country?: string;
+        phone?: string;
+    };
+    /** Recipient details */
+    recipient?: {
+        name?: string;
+        street?: string;
+        city?: string;
+        postalCode?: string;
+        country?: string;
+        phone?: string;
+    };
+    /** Items in shipment */
+    items?: Array<{
+        id?: string;
+        weight?: number;
+        [key: string]: any;
+    }>;
+    /** Full raw response from MPL API */
+    raw: any;
+}
+/**
+ * Get shipment details by tracking number via GET /shipments/{trackingNumber}
+ *
+ * Returns shipment metadata (sender, recipient, items, dates).
+ * This is NOT a tracking operation - it retrieves shipment state and details.
+ *
+ * To use test API, pass in request with options.useTestApi = true
+ */
+export declare function getShipmentDetails(req: {
+    trackingNumber: string;
+    credentials?: any;
+    options?: {
+        useTestApi?: boolean;
+    };
+}, ctx: AdapterContext, resolveBaseUrl: ResolveBaseUrl): Promise<ShipmentDetailsResponse>;
+//# sourceMappingURL=get-shipment-details.d.ts.map

package/dist/capabilities/get-shipment-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-shipment-details.d.ts","sourceRoot":"","sources":["../../src/capabilities/get-shipment-details.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,wBAAwB;IACxB,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,wBAAwB;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC,CAAC;IACH,qCAAqC;IACrC,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpC,EACD,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAmHlC"}

package/dist/capabilities/get-shipment-details.js

@@ -0,0 +1,97 @@
+/**
+ * MPL Adapter: Get Shipment Details Capability
+ * Handles GET_SHIPMENT_DETAILS operation via GET /shipments/{trackingNumber}
+ *
+ * Retrieves shipment metadata including sender, recipient, items, and shipment state.
+ * Note: This returns shipment details/metadata, not tracking event history.
+ */
+import { CarrierError, serializeForLog, errorToLog } from '@shopickup/core';
+import { safeValidateGetShipmentDetailsRequest, safeValidateShipmentQueryResponse } from '../validation.js';
+import { buildMPLHeaders } from '../utils/httpUtils.js';
+/**
+ * Get shipment details by tracking number via GET /shipments/{trackingNumber}
+ *
+ * Returns shipment metadata (sender, recipient, items, dates).
+ * This is NOT a tracking operation - it retrieves shipment state and details.
+ *
+ * To use test API, pass in request with options.useTestApi = true
+ */
+export async function getShipmentDetails(req, ctx, resolveBaseUrl) {
+    try {
+        // Validate request format and credentials
+        const validated = safeValidateGetShipmentDetailsRequest(req);
+        if (!validated.success) {
+            throw new CarrierError(`Invalid request: ${validated.error.message}`, 'Validation', { raw: serializeForLog(validated.error) });
+        }
+        if (!ctx.http) {
+            throw new CarrierError('HTTP client not provided in context', 'Permanent');
+        }
+        // Extract accountingCode from credentials (required for MPL)
+        const accountingCode = validated.data.credentials?.accountingCode;
+        if (!accountingCode) {
+            throw new CarrierError('accountingCode is required in credentials', 'Validation');
+        }
+        // Extract useTestApi from validated request
+        const useTestApi = validated.data.options?.useTestApi ?? false;
+        const baseUrl = resolveBaseUrl(validated.data.options);
+        const trackingNumber = validated.data.trackingNumber;
+        ctx.logger?.debug('MPL: Getting shipment details', {
+            trackingNumber,
+            testMode: useTestApi,
+        });
+        // Get shipment details via GET /shipments/{trackingNumber} endpoint
+        const url = `${baseUrl}/shipments/${encodeURIComponent(trackingNumber)}`;
+        const httpResponse = await ctx.http.get(url, {
+            headers: buildMPLHeaders(validated.data.credentials, accountingCode),
+        });
+        // Extract body from normalized HttpResponse
+        const response = httpResponse.body;
+        // Validate response against Zod schema
+        const responseValidation = safeValidateShipmentQueryResponse(response);
+        if (!responseValidation.success) {
+            throw new CarrierError(`Invalid shipment response: ${responseValidation.error.message}`, 'Validation', { raw: serializeForLog(responseValidation.error) });
+        }
+        const validatedResponse = responseValidation.data;
+        // Check for errors in response
+        if (validatedResponse.errors && validatedResponse.errors.length > 0) {
+            const errorMsg = validatedResponse.errors
+                .map((e) => e.text || e.code)
+                .join('; ');
+            const notFound = validatedResponse.errors.some((e) => {
+                const code = String(e.code || '').toUpperCase();
+                const text = String(e.text || '').toLowerCase();
+                return code.includes('NOT_FOUND') || text.includes('not found');
+            });
+            throw new CarrierError(`MPL error: ${errorMsg}`, notFound ? 'NotFound' : 'Validation', { raw: validatedResponse.errors });
+        }
+        if (!validatedResponse.shipment) {
+            throw new CarrierError(`No shipment found for tracking number ${trackingNumber}`, 'NotFound');
+        }
+        const shipment = validatedResponse.shipment;
+        ctx.logger?.info('MPL: Shipment details retrieved', {
+            trackingNumber,
+            itemCount: shipment.items?.length || 0,
+            testMode: useTestApi,
+        });
+        // Return shipment details normalized to response type
+        return {
+            trackingNumber: shipment.trackingNumber,
+            orderId: shipment.orderId,
+            shipmentDate: shipment.shipmentDate,
+            sender: shipment.sender,
+            recipient: shipment.recipient,
+            items: shipment.items,
+            raw: validatedResponse,
+        };
+    }
+    catch (error) {
+        if (error instanceof CarrierError) {
+            throw error;
+        }
+        ctx.logger?.error('MPL: Error getting shipment details', {
+            trackingNumber: req.trackingNumber,
+            error: errorToLog(error),
+        });
+        throw new CarrierError(`Failed to get shipment details: ${error?.message || "Unknown error"}`, "Transient", { raw: serializeForLog(error) });
+    }
+}

package/dist/capabilities/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Foxpost Adapter: Capabilities Export
+ * Re-exports all capability methods for clean imports
+ */
+export { createParcel, createParcels } from './parcels.js';
+export { createLabel, createLabels } from './label.js';
+export { fetchPickupPoints } from './pickup-points.js';
+export { exchangeAuthToken } from './auth.js';
+export { closeShipments } from './close.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/capabilities/index.js

@@ -0,0 +1,9 @@
+/**
+ * Foxpost Adapter: Capabilities Export
+ * Re-exports all capability methods for clean imports
+ */
+export { createParcel, createParcels } from './parcels.js';
+export { createLabel, createLabels } from './label.js';
+export { fetchPickupPoints } from './pickup-points.js';
+export { exchangeAuthToken } from './auth.js';
+export { closeShipments } from './close.js';

package/dist/capabilities/label.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MPL Adapter: Label Generation Capability
+ * Handles CREATE_LABEL and CREATE_LABELS operations
+ *
+ * Key differences from Foxpost:
+ * - Uses GET request instead of POST
+ * - Returns JSON array with base64-encoded label data
+ * - Multiple query parameters including labelType, labelFormat, orderBy, singleFile
+ * - Per-item error handling in the response array
+ */
+import type { AdapterContext, CreateLabelResponse, CreateLabelsResponse } from "@shopickup/core";
+import type { CreateLabelMPLRequest, CreateLabelsMPLRequest } from '../validation.js';
+import type { ResolveBaseUrl } from '../utils/resolveBaseUrl.js';
+/**
+ * Create a label (generate PDF) for a single parcel
+ * Delegates to createLabels to reuse batching logic
+ *
+ * Returns Promise<LabelResult> with file mapping and metadata
+ */
+export declare function createLabel(req: CreateLabelMPLRequest, ctx: AdapterContext, resolveBaseUrl: ResolveBaseUrl): Promise<CreateLabelResponse>;
+/**
+ * Create labels for multiple parcels in one call
+ *
+ * MPL GET /shipments/label endpoint:
+ * - Takes array of tracking numbers (query params)
+ * - Optional labelType, labelFormat, orderBy, singleFile params
+ * - Returns JSON array of LabelQueryResult objects with base64-encoded label data
+ * - Each result has trackingNumber, label (base64), errors/warnings arrays
+ *
+ * Returns structured response with files array and per-item results
+ */
+export declare function createLabels(req: CreateLabelsMPLRequest, ctx: AdapterContext, resolveBaseUrl: ResolveBaseUrl): Promise<CreateLabelsResponse>;
+//# sourceMappingURL=label.d.ts.map

package/dist/capabilities/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../src/capabilities/label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAkB,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAoEjE;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAiD9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmP/B"}