shipflow 0.1.0

package/dist/carriers/smsaexpress/adapter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SMSA Express Carrier Adapter
+ * Full implementation of the CarrierAdapter interface for SMSA Express API.
+ */
+import type { CarrierConfig, City, CreateShipmentInput, Location, Shipment, TrackingResult, WebhookConfig, WebhookEvent } from "../../core/types.js";
+import { BaseCarrierAdapter } from "../base.js";
+import type { SMSAPushIdDetailsRequest, SMSAPushIdDetailsResponse, SMSASendInvoiceRequest, SMSAShortAddressResponse } from "./types.js";
+export interface SMSAExpressConfig extends CarrierConfig {
+    credentials: {
+        apiKey: string;
+    };
+}
+export declare class SMSAExpressAdapter extends BaseCarrierAdapter {
+    readonly name = "smsaexpress";
+    readonly supportedCountries: string[];
+    private http;
+    constructor(config: SMSAExpressConfig);
+    protected getBaseUrl(): string;
+    protected executeCreateShipment(input: CreateShipmentInput): Promise<Shipment>;
+    private createC2BShipment;
+    /**
+     * Cancel a reverse-pickup (C2B) shipment.
+     *
+     * **Important:** SMSA only supports cancellation for C2B/reverse-pickup shipments.
+     * Calling this on a B2C shipment will result in an API error or return `false`.
+     * B2C shipments cannot be cancelled via the SMSA API.
+     */
+    cancelShipment(trackingNumber: string): Promise<boolean>;
+    track(trackingNumber: string): Promise<TrackingResult>;
+    trackMultiple(trackingNumbers: string[]): Promise<TrackingResult[]>;
+    trackByReference(reference: string): Promise<TrackingResult>;
+    getLabel(trackingNumber: string, _format?: "PDF" | "PNG"): Promise<string>;
+    getCities(countryCode?: string): Promise<City[]>;
+    getDropoffLocations(): Promise<Location[]>;
+    create2WayShipment(input: CreateShipmentInput): Promise<Shipment>;
+    sendInvoice(request: SMSASendInvoiceRequest): Promise<string>;
+    validateShortAddress(shortCode: string): Promise<SMSAShortAddressResponse>;
+    pushIdDetails(request: SMSAPushIdDetailsRequest): Promise<SMSAPushIdDetailsResponse>;
+    parseWebhook(payload: unknown, options?: {
+        headers?: Record<string, string>;
+        queryParams?: Record<string, string>;
+        config?: WebhookConfig;
+    }): WebhookEvent;
+    /**
+     * Parse a batch SMSA webhook payload into multiple events.
+     *
+     * SMSA sends webhook payloads as an array of shipments, each with their own
+     * tracking scans. This method returns a WebhookEvent for every shipment
+     * in the payload.
+     */
+    parseWebhookBatch(payload: unknown, options?: {
+        headers?: Record<string, string>;
+        queryParams?: Record<string, string>;
+        config?: WebhookConfig;
+    }): WebhookEvent[];
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/carriers/smsaexpress/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/carriers/smsaexpress/adapter.ts"],"names":[],"mappings":"AACA;;;GAGG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,IAAI,EACJ,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAY7C,OAAO,KAAK,EAGV,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EAEtB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAQjB,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,kBAAkB,WASzB;IAEF,OAAO,CAAC,IAAI,CAAa;gBAEb,MAAM,EAAE,iBAAiB;IAWrC,SAAS,CAAC,UAAU,IAAI,MAAM;cAUd,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC;YAgBN,iBAAiB;IAY/B;;;;;;OAMG;IACG,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcxD,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQtD,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAUnE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAY5D,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GACtB,OAAO,CAAC,MAAM,CAAC;IAsCZ,SAAS,CAAC,WAAW,SAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAQ9C,mBAAmB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAY1C,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcjE,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7D,oBAAoB,CACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,wBAAwB,CAAC;IAM9B,aAAa,CACjB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC;IAWrC,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,aAAa,CAAC;KACxB,GACA,YAAY;IAIf;;;;;;OAMG;IACH,iBAAiB,CACf,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,aAAa,CAAC;KACxB,GACA,YAAY,EAAE;CAGlB"}

package/dist/carriers/smsaexpress/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SMSA Express Carrier Exports
+ * Import from 'shipflow/carriers/smsaexpress' for tree-shaking.
+ */
+export { SMSAExpressAdapter, type SMSAExpressConfig } from "./adapter.js";
+export { SMSAService, SMSAStatusCodes, type SMSAServiceType } from "./services.js";
+export { mapSMSAStatus, parseSMSAWebhook, parseSMSAWebhookBatch, } from "./mappers.js";
+export type { SMSACreate2WayShipmentRequest, SMSACreateB2CShipmentRequest, SMSACreateC2BShipmentRequest, SMSAPushIdDetailsRequest, SMSAPushIdDetailsResponse, SMSASendInvoiceRequest, SMSAShipmentResponse, SMSAShortAddressResponse, SMSATrackingResponse, SMSATrackingScan, SMSAWebhookShipment, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/carriers/smsaexpress/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/carriers/smsaexpress/index.ts"],"names":[],"mappings":"AACA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/carriers/smsaexpress/index.js

@@ -0,0 +1,408 @@
+import {
+  APIError,
+  BaseCarrierAdapter,
+  HttpClient,
+  ValidationError,
+  WebhookVerificationError
+} from "../../index-x8sk1kw9.js";
+
+// src/carriers/smsaexpress/services.ts
+var SMSAService = {
+  ECOMMERCE_DELIVERY: "EDDL",
+  EXPRESS_DELIVERY: "EDEL",
+  C2B_REVERSE: "EDCR"
+};
+var SMSAStatusCodes = {
+  DL: "delivered",
+  OD: "out_for_delivery",
+  AF: "at_warehouse",
+  HOP: "in_transit",
+  HOR: "in_transit",
+  HOT: "in_transit",
+  PU: "picked_up",
+  PKD: "picked_up",
+  CR: "in_transit",
+  CH: "in_transit",
+  DE: "exception",
+  DMG: "exception",
+  MISS: "exception",
+  CAN: "cancelled",
+  RTO: "returned",
+  RTN: "returned",
+  CC: "at_warehouse",
+  PP: "pending",
+  BK: "created",
+  NEW: "created"
+};
+
+// src/carriers/smsaexpress/mappers.ts
+function mapSMSAStatus(scanType) {
+  return SMSAStatusCodes[scanType] ?? "in_transit";
+}
+function deriveStatusFromScans(scans, isDelivered) {
+  if (isDelivered) {
+    return { status: "delivered", statusLabel: "Delivered" };
+  }
+  if (scans.length === 0) {
+    return { status: "unknown", statusLabel: "Unknown" };
+  }
+  const sorted = [...scans].sort((a, b) => new Date(b.ScanDateTime).getTime() - new Date(a.ScanDateTime).getTime());
+  const latest = sorted[0];
+  return {
+    status: mapSMSAStatus(latest.ScanType),
+    statusLabel: latest.ScanDescription
+  };
+}
+function mapAddress(addr) {
+  const result = {
+    ContactName: addr.name,
+    ContactPhoneNumber: addr.phone,
+    Country: addr.countryCode,
+    City: addr.city,
+    AddressLine1: addr.line1,
+    AddressLine2: addr.line2,
+    District: addr.neighbourhood ?? addr.state,
+    PostalCode: addr.postalCode
+  };
+  if (addr.coordinates) {
+    result.Coordinates = `${addr.coordinates.latitude},${addr.coordinates.longitude}`;
+  }
+  if (addr.nationalAddress?.shortCode) {
+    result.ShortCode = addr.nationalAddress.shortCode;
+  }
+  return result;
+}
+function mapCreateB2CRequest(input) {
+  const totalPieces = input.parcels.reduce((sum, p) => sum + p.pieces, 0);
+  const totalWeight = input.parcels.reduce((sum, p) => sum + (p.weight.unit === "lb" ? p.weight.value * 0.453592 : p.weight.value), 0);
+  const consigneeAddress = mapAddress(input.consignee);
+  if (input.options?.metadata?.consigneeId) {
+    consigneeAddress.ConsigneeID = input.options.metadata.consigneeId;
+  }
+  return {
+    ConsigneeAddress: consigneeAddress,
+    ShipperAddress: mapAddress(input.shipper),
+    OrderNumber: input.reference ?? `ORD-${Date.now()}`,
+    CODAmount: input.cod?.enabled ? input.cod.amount : 0,
+    DeclaredValue: input.declaredValue?.amount ?? 0,
+    ContentDescription: input.parcels[0]?.description ?? "Shipment contents",
+    Parcels: totalPieces,
+    ShipDate: new Date().toISOString().slice(0, 19),
+    ShipmentCurrency: input.declaredValue?.currency ?? input.cod?.currency ?? "SAR",
+    Weight: totalWeight,
+    WeightUnit: "KG",
+    WaybillType: input.labelFormat === "ZPL" ? "ZPL" : "PDF",
+    ServiceCode: input.serviceType,
+    SMSARetailID: input.options?.metadata?.smsaRetailId ?? "0",
+    VatPaid: input.options?.metadata?.vatPaid ?? true,
+    DutyPaid: input.options?.metadata?.dutyPaid ?? false
+  };
+}
+function mapCreateC2BRequest(input) {
+  const totalPieces = input.parcels.reduce((sum, p) => sum + p.pieces, 0);
+  const totalWeight = input.parcels.reduce((sum, p) => sum + (p.weight.unit === "lb" ? p.weight.value * 0.453592 : p.weight.value), 0);
+  return {
+    PickupAddress: mapAddress(input.consignee),
+    ReturnToAddress: mapAddress(input.shipper),
+    OrderNumber: input.reference ?? `ORD-${Date.now()}`,
+    DeclaredValue: input.declaredValue?.amount ?? 0.1,
+    ContentDescription: input.parcels[0]?.description ?? "Return shipment contents",
+    Parcels: totalPieces,
+    ShipDate: new Date().toISOString().slice(0, 19),
+    ShipmentCurrency: input.declaredValue?.currency ?? input.cod?.currency ?? "SAR",
+    Weight: totalWeight,
+    WeightUnit: "KG",
+    WaybillType: input.labelFormat === "ZPL" ? "ZPL" : "PDF",
+    ServiceCode: input.serviceType ?? "EDCR",
+    SMSARetailID: input.options?.metadata?.smsaRetailId ?? "0"
+  };
+}
+function mapShipmentResponse(data, input) {
+  const firstWaybill = data.waybills?.[0];
+  const trackingNumber = firstWaybill?.awb ?? data.sawb;
+  if (!trackingNumber) {
+    throw new APIError("No tracking number in shipment response", {
+      carrier: "smsaexpress",
+      raw: data
+    });
+  }
+  return {
+    carrier: "smsaexpress",
+    trackingNumber,
+    reference: input.reference,
+    status: "created",
+    statusLabel: "Created",
+    codAmount: input.cod?.enabled ? input.cod.amount : undefined,
+    declaredValue: input.declaredValue?.amount,
+    currency: input.declaredValue?.currency ?? input.cod?.currency ?? "SAR",
+    returnLabel: firstWaybill?.returnBarcode ? `data:application/pdf;base64,${firstWaybill.returnBarcode}` : undefined,
+    createdAt: new Date(/[Z]$|[+-]\d{2}(:\d{2})?$/.test(data.createDate) ? data.createDate : `${data.createDate}+03:00`),
+    raw: data
+  };
+}
+function mapTrackingEvent(scan) {
+  return {
+    timestamp: new Date(scan.ScanTimeZone ? `${scan.ScanDateTime}${scan.ScanTimeZone}` : scan.ScanDateTime),
+    statusCode: scan.ScanType,
+    status: mapSMSAStatus(scan.ScanType),
+    description: scan.ScanDescription,
+    location: scan.City
+  };
+}
+function mapTrackingResult(data) {
+  const { status, statusLabel } = deriveStatusFromScans(data.Scans, data.isDelivered);
+  const deliveredScan = data.Scans.find((s) => s.ScanType === "DL");
+  const deliveredTimestamp = deliveredScan ? new Date(deliveredScan.ScanTimeZone ? `${deliveredScan.ScanDateTime}${deliveredScan.ScanTimeZone}` : deliveredScan.ScanDateTime) : undefined;
+  return {
+    trackingNumber: data.AWB,
+    carrier: "smsaexpress",
+    reference: data.Reference || undefined,
+    status,
+    statusLabel,
+    events: data.Scans.map(mapTrackingEvent),
+    deliveryDate: deliveredTimestamp,
+    codAmount: data.CODAmount > 0 ? data.CODAmount : undefined,
+    pieces: data.Pieces,
+    raw: data
+  };
+}
+function mapCity(city) {
+  return {
+    nameEn: city.cityName,
+    code: city.cityCode
+  };
+}
+function mapOffice(office) {
+  const [lat, lng] = (office.coordinates || "").split(",").map((s) => parseFloat(s.trim()));
+  return {
+    id: office.code,
+    name: office.address,
+    nameAr: office.addressAR,
+    city: office.cityName,
+    latitude: Number.isNaN(lat) ? undefined : lat,
+    longitude: Number.isNaN(lng) ? undefined : lng
+  };
+}
+function mapCreate2WayRequest(input) {
+  const totalPieces = input.parcels.reduce((sum, p) => sum + p.pieces, 0);
+  const totalWeight = input.parcels.reduce((sum, p) => sum + (p.weight.unit === "lb" ? p.weight.value * 0.453592 : p.weight.value), 0);
+  const consigneeAddress = mapAddress(input.consignee);
+  if (input.options?.metadata?.consigneeId) {
+    consigneeAddress.ConsigneeID = input.options.metadata.consigneeId;
+  }
+  return {
+    ConsigneeAddress: consigneeAddress,
+    ShipperAddress: mapAddress(input.shipper),
+    OrderNumber: input.reference ?? `ORD-${Date.now()}`,
+    DeclaredValue: input.declaredValue?.amount ?? 0,
+    ContentDescription: input.parcels[0]?.description ?? "Shipment contents",
+    Parcels: totalPieces,
+    ShipDate: new Date().toISOString().slice(0, 19),
+    ShipmentCurrency: input.declaredValue?.currency ?? "SAR",
+    Weight: totalWeight,
+    WeightUnit: "KG",
+    WaybillType: input.labelFormat === "ZPL" ? "ZPL" : "PDF",
+    SMSARetailID: input.options?.metadata?.smsaRetailId ?? "0",
+    VatPaid: input.options?.metadata?.vatPaid ?? true,
+    DutyPaid: input.options?.metadata?.dutyPaid ?? false
+  };
+}
+function timingSafeEqual(a, b) {
+  const encoder = new TextEncoder;
+  const bufA = encoder.encode(a);
+  const bufB = encoder.encode(b);
+  if (bufA.byteLength !== bufB.byteLength)
+    return false;
+  let mismatch = 0;
+  for (let i = 0;i < bufA.byteLength; i++) {
+    mismatch |= bufA[i] ^ bufB[i];
+  }
+  return mismatch === 0;
+}
+function verifyWebhookAuth(options) {
+  const { headers = {}, queryParams = {}, config } = options ?? {};
+  if (config?.authHeader && config?.authValue) {
+    const lowerKey = config.authHeader.toLowerCase();
+    const headerValue = Object.entries(headers).find(([k]) => k.toLowerCase() === lowerKey)?.[1];
+    if (!headerValue || !timingSafeEqual(headerValue, config.authValue)) {
+      throw new WebhookVerificationError("Invalid webhook auth header", {
+        carrier: "smsaexpress"
+      });
+    }
+  }
+  if (config?.authQueryParam && config?.authQueryValue) {
+    const paramValue = queryParams[config.authQueryParam];
+    if (!paramValue || !timingSafeEqual(paramValue, config.authQueryValue)) {
+      throw new WebhookVerificationError("Invalid webhook auth query param", {
+        carrier: "smsaexpress"
+      });
+    }
+  }
+}
+function mapWebhookShipmentToEvent(shipment) {
+  const { status, statusLabel } = deriveStatusFromScans(shipment.Scans, shipment.isDelivered);
+  const sorted = [...shipment.Scans].sort((a, b) => new Date(b.ScanDateTime).getTime() - new Date(a.ScanDateTime).getTime());
+  const latestScan = sorted[0];
+  const timestamp = latestScan ? new Date(latestScan.ScanTimeZone ? `${latestScan.ScanDateTime}${latestScan.ScanTimeZone}` : latestScan.ScanDateTime) : new Date;
+  return {
+    carrier: "smsaexpress",
+    eventType: "status_update",
+    trackingNumber: shipment.AWB,
+    reference: shipment.Reference || undefined,
+    status,
+    statusCode: latestScan?.ScanType ?? "unknown",
+    statusLabel,
+    timestamp,
+    raw: shipment
+  };
+}
+function validateWebhookPayload(payload) {
+  if (!Array.isArray(payload)) {
+    throw new ValidationError("Invalid SMSA webhook payload: expected an array of shipments", { raw: payload });
+  }
+  if (payload.length === 0) {
+    throw new ValidationError("Invalid SMSA webhook payload: empty array", {
+      raw: payload
+    });
+  }
+  for (const item of payload) {
+    if (!item || typeof item !== "object" || !("AWB" in item) || !("Scans" in item)) {
+      throw new ValidationError("Invalid SMSA webhook payload: shipment missing required fields (AWB, Scans)", { raw: item });
+    }
+  }
+  return payload;
+}
+function parseSMSAWebhook(payload, options) {
+  verifyWebhookAuth(options);
+  const shipments = validateWebhookPayload(payload);
+  return mapWebhookShipmentToEvent(shipments[0]);
+}
+function parseSMSAWebhookBatch(payload, options) {
+  verifyWebhookAuth(options);
+  const shipments = validateWebhookPayload(payload);
+  return shipments.map(mapWebhookShipmentToEvent);
+}
+
+// src/carriers/smsaexpress/adapter.ts
+var SMSA_SANDBOX_URL = "https://ecomapis-sandbox.azurewebsites.net";
+var SMSA_PRODUCTION_URL = "https://ecomapis.smsaexpress.com";
+var C2B_SERVICE_CODES = new Set(["EDCR"]);
+
+class SMSAExpressAdapter extends BaseCarrierAdapter {
+  name = "smsaexpress";
+  supportedCountries = [
+    "SA",
+    "AE",
+    "BH",
+    "EG",
+    "KW",
+    "OM",
+    "QA",
+    "JO"
+  ];
+  http;
+  constructor(config) {
+    super(config);
+    this.http = new HttpClient({
+      baseUrl: this.getBaseUrl(),
+      carrier: "smsaexpress",
+      headers: {
+        apikey: config.credentials.apiKey
+      }
+    });
+  }
+  getBaseUrl() {
+    return this.config.mode === "production" ? SMSA_PRODUCTION_URL : SMSA_SANDBOX_URL;
+  }
+  async executeCreateShipment(input) {
+    const isC2B = C2B_SERVICE_CODES.has(input.serviceType);
+    if (isC2B) {
+      return this.createC2BShipment(input);
+    }
+    const request = mapCreateB2CRequest(input);
+    const response = await this.http.post("/api/shipment/b2c/new", request);
+    return mapShipmentResponse(response, input);
+  }
+  async createC2BShipment(input) {
+    const request = mapCreateC2BRequest(input);
+    const response = await this.http.post("/api/c2b/new", request);
+    return mapShipmentResponse(response, input);
+  }
+  async cancelShipment(trackingNumber) {
+    const response = await this.http.post(`/api/c2b/cancel/${encodeURIComponent(trackingNumber)}`);
+    return typeof response === "string" ? response.toLowerCase().includes("cancelled") : true;
+  }
+  async track(trackingNumber) {
+    const response = await this.http.get(`/api/track/single/${encodeURIComponent(trackingNumber)}`);
+    return mapTrackingResult(response);
+  }
+  async trackMultiple(trackingNumbers) {
+    const response = await this.http.post("/api/track/bulk/", trackingNumbers, { retry: true });
+    return response.map(mapTrackingResult);
+  }
+  async trackByReference(reference) {
+    const response = await this.http.get(`/api/track/reference/${encodeURIComponent(reference)}`);
+    return mapTrackingResult(response);
+  }
+  async getLabel(trackingNumber, _format) {
+    const encoded = encodeURIComponent(trackingNumber);
+    for (const path of [
+      `/api/shipment/b2c/query/${encoded}`,
+      `/api/c2b/query/${encoded}`
+    ]) {
+      try {
+        const response = await this.http.get(path);
+        const waybill = response.waybills?.[0];
+        if (waybill?.awbFile) {
+          return `data:application/pdf;base64,${waybill.awbFile}`;
+        }
+      } catch (error) {
+        if (!(error instanceof APIError) || error.statusCode === 401 || error.statusCode !== undefined && error.statusCode >= 500) {
+          throw error;
+        }
+      }
+    }
+    throw new APIError("No label found for shipment", {
+      carrier: "smsaexpress",
+      raw: { trackingNumber }
+    });
+  }
+  async getCities(countryCode = "SA") {
+    const response = await this.http.get(`/api/lookup/cities/${encodeURIComponent(countryCode)}`);
+    return response.map(mapCity);
+  }
+  async getDropoffLocations() {
+    const response = await this.http.get("/api/lookup/smsaoffices");
+    return response.map(mapOffice);
+  }
+  async create2WayShipment(input) {
+    const request = mapCreate2WayRequest(input);
+    const response = await this.http.post("/api/TwoWayShipment/new", request);
+    return mapShipmentResponse(response, input);
+  }
+  async sendInvoice(request) {
+    return this.http.post("/api/invoice", request);
+  }
+  async validateShortAddress(shortCode) {
+    return this.http.get(`/api/Lookup/FullAddressByShortCode/${encodeURIComponent(shortCode)}`);
+  }
+  async pushIdDetails(request) {
+    return this.http.post("/api/shipment/identity-details", request);
+  }
+  parseWebhook(payload, options) {
+    return parseSMSAWebhook(payload, options);
+  }
+  parseWebhookBatch(payload, options) {
+    return parseSMSAWebhookBatch(payload, options);
+  }
+}
+export {
+  parseSMSAWebhookBatch,
+  parseSMSAWebhook,
+  mapSMSAStatus,
+  SMSAStatusCodes,
+  SMSAService,
+  SMSAExpressAdapter
+};
+
+//# debugId=C9233984938A6D4764756E2164756E21

package/dist/carriers/smsaexpress/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/carriers/smsaexpress/services.ts", "../src/carriers/smsaexpress/mappers.ts", "../src/carriers/smsaexpress/adapter.ts"],
+  "sourcesContent": [
+    "// file: src/carriers/smsaexpress/services.ts\n/**\n * SMSA Express Service Type Codes\n * Use these constants for type-safe service selection.\n */\n\nexport const SMSAService = {\n  /** E-commerce delivery */\n  ECOMMERCE_DELIVERY: \"EDDL\",\n  /** Express delivery */\n  EXPRESS_DELIVERY: \"EDEL\",\n  /** C2B / Reverse pickup */\n  C2B_REVERSE: \"EDCR\",\n} as const;\n\nexport type SMSAServiceType = (typeof SMSAService)[keyof typeof SMSAService];\n\n/**\n * SMSA Express Scan Type Codes → Unified ShipmentStatus mapping.\n *\n * Based on /api/track/statuslookup response.\n * Scan types not explicitly listed default to \"in_transit\".\n */\nexport const SMSAStatusCodes: Record<string, string> = {\n  // Delivery\n  DL: \"delivered\",\n\n  // Out for delivery\n  OD: \"out_for_delivery\",\n\n  // Arrived at facility\n  AF: \"at_warehouse\",\n\n  // Hub / sorting\n  HOP: \"in_transit\",\n  HOR: \"in_transit\",\n  HOT: \"in_transit\",\n\n  // Picked up / collected\n  PU: \"picked_up\",\n  PKD: \"picked_up\",\n\n  // Customs\n  CR: \"in_transit\",\n  CH: \"in_transit\",\n\n  // Exceptions\n  DE: \"exception\",\n  DMG: \"exception\",\n  MISS: \"exception\",\n\n  // Cancelled / returned\n  CAN: \"cancelled\",\n  RTO: \"returned\",\n  RTN: \"returned\",\n\n  // Processing\n  CC: \"at_warehouse\",\n  PP: \"pending\",\n\n  // Created / booked\n  BK: \"created\",\n  NEW: \"created\",\n};\n",
+    "// file: src/carriers/smsaexpress/mappers.ts\n/**\n * SMSA Express Data Mappers\n * Transform between unified ShipFlow types and SMSA Express API formats.\n */\n\nimport {\n  APIError,\n  ValidationError,\n  WebhookVerificationError,\n} from \"../../core/errors\";\nimport type {\n  City,\n  CreateShipmentInput,\n  Location,\n  Shipment,\n  ShipmentStatus,\n  TrackingEvent,\n  TrackingResult,\n  WebhookConfig,\n  WebhookEvent,\n} from \"../../core/types\";\nimport { SMSAStatusCodes } from \"./services\";\nimport type {\n  SMSACityLookupItem,\n  SMSACreate2WayShipmentRequest,\n  SMSACreateB2CShipmentRequest,\n  SMSACreateC2BShipmentRequest,\n  SMSAOfficeLookupItem,\n  SMSAShipmentAddress,\n  SMSAShipmentResponse,\n  SMSATrackingResponse,\n  SMSATrackingScan,\n  SMSAWebhookShipment,\n} from \"./types\";\n\n// ============================================================================\n// STATUS MAPPING\n// ============================================================================\n\nexport function mapSMSAStatus(scanType: string): ShipmentStatus {\n  return (SMSAStatusCodes[scanType] as ShipmentStatus) ?? \"in_transit\";\n}\n\n/**\n * Derive the current shipment status from tracking scans.\n * Defensively sorts by ScanDateTime descending before taking the latest.\n */\nfunction deriveStatusFromScans(\n  scans: SMSATrackingScan[],\n  isDelivered?: boolean,\n): { status: ShipmentStatus; statusLabel: string } {\n  if (isDelivered) {\n    return { status: \"delivered\", statusLabel: \"Delivered\" };\n  }\n  if (scans.length === 0) {\n    return { status: \"unknown\", statusLabel: \"Unknown\" };\n  }\n  const sorted = [...scans].sort(\n    (a, b) =>\n      new Date(b.ScanDateTime).getTime() -\n      new Date(a.ScanDateTime).getTime(),\n  );\n  const latest = sorted[0]!;\n  return {\n    status: mapSMSAStatus(latest.ScanType),\n    statusLabel: latest.ScanDescription,\n  };\n}\n\n// ============================================================================\n// REQUEST MAPPERS\n// ============================================================================\n\nfunction mapAddress(\n  addr: CreateShipmentInput[\"shipper\"] | CreateShipmentInput[\"consignee\"],\n): SMSAShipmentAddress {\n  const result: SMSAShipmentAddress = {\n    ContactName: addr.name,\n    ContactPhoneNumber: addr.phone,\n    Country: addr.countryCode,\n    City: addr.city,\n    AddressLine1: addr.line1,\n    AddressLine2: addr.line2,\n    District: addr.neighbourhood ?? addr.state,\n    PostalCode: addr.postalCode,\n  };\n\n  if (addr.coordinates) {\n    result.Coordinates = `${addr.coordinates.latitude},${addr.coordinates.longitude}`;\n  }\n\n  if (addr.nationalAddress?.shortCode) {\n    result.ShortCode = addr.nationalAddress.shortCode;\n  }\n\n  return result;\n}\n\nexport function mapCreateB2CRequest(\n  input: CreateShipmentInput,\n): SMSACreateB2CShipmentRequest {\n  const totalPieces = input.parcels.reduce((sum, p) => sum + p.pieces, 0);\n  const totalWeight = input.parcels.reduce(\n    (sum, p) =>\n      sum +\n      (p.weight.unit === \"lb\" ? p.weight.value * 0.453592 : p.weight.value),\n    0,\n  );\n\n  const consigneeAddress = mapAddress(input.consignee);\n  if (input.options?.metadata?.consigneeId) {\n    consigneeAddress.ConsigneeID = input.options.metadata.consigneeId as string;\n  }\n\n  return {\n    ConsigneeAddress: consigneeAddress,\n    ShipperAddress: mapAddress(input.shipper),\n    OrderNumber: input.reference ?? `ORD-${Date.now()}`,\n    CODAmount: input.cod?.enabled ? input.cod.amount : 0,\n    DeclaredValue: input.declaredValue?.amount ?? 0,\n    ContentDescription: input.parcels[0]?.description ?? \"Shipment contents\",\n    Parcels: totalPieces,\n    ShipDate: new Date().toISOString().slice(0, 19),\n    ShipmentCurrency:\n      input.declaredValue?.currency ?? input.cod?.currency ?? \"SAR\",\n    Weight: totalWeight,\n    WeightUnit: \"KG\",\n    WaybillType: input.labelFormat === \"ZPL\" ? \"ZPL\" : \"PDF\",\n    ServiceCode: input.serviceType,\n    SMSARetailID: (input.options?.metadata?.smsaRetailId as string) ?? \"0\",\n    VatPaid: (input.options?.metadata?.vatPaid as boolean) ?? true,\n    DutyPaid: (input.options?.metadata?.dutyPaid as boolean) ?? false,\n  };\n}\n\n/**\n * Map to C2B (reverse pickup) request.\n * In C2B flow, the consignee is the pickup point (customer returning),\n * and the shipper is the return-to address (merchant warehouse).\n */\nexport function mapCreateC2BRequest(\n  input: CreateShipmentInput,\n): SMSACreateC2BShipmentRequest {\n  const totalPieces = input.parcels.reduce((sum, p) => sum + p.pieces, 0);\n  const totalWeight = input.parcels.reduce(\n    (sum, p) =>\n      sum +\n      (p.weight.unit === \"lb\" ? p.weight.value * 0.453592 : p.weight.value),\n    0,\n  );\n\n  return {\n    PickupAddress: mapAddress(input.consignee),\n    ReturnToAddress: mapAddress(input.shipper),\n    OrderNumber: input.reference ?? `ORD-${Date.now()}`,\n    DeclaredValue: input.declaredValue?.amount ?? 0.1,\n    ContentDescription:\n      input.parcels[0]?.description ?? \"Return shipment contents\",\n    Parcels: totalPieces,\n    ShipDate: new Date().toISOString().slice(0, 19),\n    ShipmentCurrency:\n      input.declaredValue?.currency ?? input.cod?.currency ?? \"SAR\",\n    Weight: totalWeight,\n    WeightUnit: \"KG\",\n    WaybillType: input.labelFormat === \"ZPL\" ? \"ZPL\" : \"PDF\",\n    ServiceCode: input.serviceType ?? \"EDCR\",\n    SMSARetailID: (input.options?.metadata?.smsaRetailId as string) ?? \"0\",\n  };\n}\n\n// ============================================================================\n// RESPONSE MAPPERS\n// ============================================================================\n\nexport function mapShipmentResponse(\n  data: SMSAShipmentResponse,\n  input: CreateShipmentInput,\n): Shipment {\n  const firstWaybill = data.waybills?.[0];\n  const trackingNumber = firstWaybill?.awb ?? data.sawb;\n\n  if (!trackingNumber) {\n    throw new APIError(\"No tracking number in shipment response\", {\n      carrier: \"smsaexpress\",\n      raw: data,\n    });\n  }\n\n  return {\n    carrier: \"smsaexpress\",\n    trackingNumber,\n    reference: input.reference,\n    status: \"created\",\n    statusLabel: \"Created\",\n    codAmount: input.cod?.enabled ? input.cod.amount : undefined,\n    declaredValue: input.declaredValue?.amount,\n    currency: input.declaredValue?.currency ?? input.cod?.currency ?? \"SAR\",\n    returnLabel: firstWaybill?.returnBarcode\n      ? `data:application/pdf;base64,${firstWaybill.returnBarcode}`\n      : undefined,\n    createdAt: new Date(\n      /[Z]$|[+-]\\d{2}(:\\d{2})?$/.test(data.createDate)\n        ? data.createDate\n        : `${data.createDate}+03:00`,\n    ),\n    raw: data,\n  };\n}\n\nexport function mapTrackingEvent(scan: SMSATrackingScan): TrackingEvent {\n  return {\n    timestamp: new Date(\n      scan.ScanTimeZone\n        ? `${scan.ScanDateTime}${scan.ScanTimeZone}`\n        : scan.ScanDateTime,\n    ),\n    statusCode: scan.ScanType,\n    status: mapSMSAStatus(scan.ScanType),\n    description: scan.ScanDescription,\n    location: scan.City,\n  };\n}\n\nexport function mapTrackingResult(data: SMSATrackingResponse): TrackingResult {\n  const { status, statusLabel } = deriveStatusFromScans(\n    data.Scans,\n    data.isDelivered,\n  );\n\n  const deliveredScan = data.Scans.find((s) => s.ScanType === \"DL\");\n  const deliveredTimestamp = deliveredScan\n    ? new Date(\n      deliveredScan.ScanTimeZone\n        ? `${deliveredScan.ScanDateTime}${deliveredScan.ScanTimeZone}`\n        : deliveredScan.ScanDateTime,\n    )\n    : undefined;\n\n  return {\n    trackingNumber: data.AWB,\n    carrier: \"smsaexpress\",\n    reference: data.Reference || undefined,\n    status,\n    statusLabel,\n    events: data.Scans.map(mapTrackingEvent),\n    deliveryDate: deliveredTimestamp,\n    codAmount: data.CODAmount > 0 ? data.CODAmount : undefined,\n    pieces: data.Pieces,\n    raw: data,\n  };\n}\n\nexport function mapCity(city: SMSACityLookupItem): City {\n  return {\n    nameEn: city.cityName,\n    code: city.cityCode,\n  };\n}\n\nexport function mapOffice(office: SMSAOfficeLookupItem): Location {\n  const [lat, lng] = (office.coordinates || \"\")\n    .split(\",\")\n    .map((s) => parseFloat(s.trim()));\n\n  return {\n    id: office.code,\n    name: office.address,\n    nameAr: office.addressAR,\n    city: office.cityName,\n    latitude: Number.isNaN(lat) ? undefined : lat,\n    longitude: Number.isNaN(lng) ? undefined : lng,\n  };\n}\n\nexport function mapCreate2WayRequest(\n  input: CreateShipmentInput,\n): SMSACreate2WayShipmentRequest {\n  const totalPieces = input.parcels.reduce((sum, p) => sum + p.pieces, 0);\n  const totalWeight = input.parcels.reduce(\n    (sum, p) =>\n      sum +\n      (p.weight.unit === \"lb\" ? p.weight.value * 0.453592 : p.weight.value),\n    0,\n  );\n\n  const consigneeAddress = mapAddress(input.consignee);\n  if (input.options?.metadata?.consigneeId) {\n    consigneeAddress.ConsigneeID = input.options.metadata.consigneeId as string;\n  }\n\n  return {\n    ConsigneeAddress: consigneeAddress,\n    ShipperAddress: mapAddress(input.shipper),\n    OrderNumber: input.reference ?? `ORD-${Date.now()}`,\n    DeclaredValue: input.declaredValue?.amount ?? 0,\n    ContentDescription: input.parcels[0]?.description ?? \"Shipment contents\",\n    Parcels: totalPieces,\n    ShipDate: new Date().toISOString().slice(0, 19),\n    ShipmentCurrency: input.declaredValue?.currency ?? \"SAR\",\n    Weight: totalWeight,\n    WeightUnit: \"KG\",\n    WaybillType: input.labelFormat === \"ZPL\" ? \"ZPL\" : \"PDF\",\n    SMSARetailID: (input.options?.metadata?.smsaRetailId as string) ?? \"0\",\n    VatPaid: (input.options?.metadata?.vatPaid as boolean) ?? true,\n    DutyPaid: (input.options?.metadata?.dutyPaid as boolean) ?? false,\n  };\n}\n\n// ============================================================================\n// WEBHOOK MAPPERS\n// ============================================================================\n\n/**\n * Timing-safe string comparison to prevent timing attacks on auth tokens.\n */\nfunction timingSafeEqual(a: string, b: string): boolean {\n  const encoder = new TextEncoder();\n  const bufA = encoder.encode(a);\n  const bufB = encoder.encode(b);\n  if (bufA.byteLength !== bufB.byteLength) return false;\n  let mismatch = 0;\n  for (let i = 0; i < bufA.byteLength; i++) {\n    mismatch |= bufA[i]! ^ bufB[i]!;\n  }\n  return mismatch === 0;\n}\n\nfunction verifyWebhookAuth(options?: {\n  headers?: Record<string, string>;\n  queryParams?: Record<string, string>;\n  config?: WebhookConfig;\n}): void {\n  const { headers = {}, queryParams = {}, config } = options ?? {};\n\n  // Verify auth via header (case-insensitive lookup, timing-safe comparison)\n  if (config?.authHeader && config?.authValue) {\n    const lowerKey = config.authHeader.toLowerCase();\n    const headerValue = Object.entries(headers).find(\n      ([k]) => k.toLowerCase() === lowerKey,\n    )?.[1];\n    if (!headerValue || !timingSafeEqual(headerValue, config.authValue)) {\n      throw new WebhookVerificationError(\"Invalid webhook auth header\", {\n        carrier: \"smsaexpress\",\n      });\n    }\n  }\n\n  // Verify auth via query param (SMSA uses API key as query param, timing-safe)\n  if (config?.authQueryParam && config?.authQueryValue) {\n    const paramValue = queryParams[config.authQueryParam];\n    if (!paramValue || !timingSafeEqual(paramValue, config.authQueryValue)) {\n      throw new WebhookVerificationError(\"Invalid webhook auth query param\", {\n        carrier: \"smsaexpress\",\n      });\n    }\n  }\n}\n\nfunction mapWebhookShipmentToEvent(\n  shipment: SMSAWebhookShipment,\n): WebhookEvent {\n  const { status, statusLabel } = deriveStatusFromScans(\n    shipment.Scans,\n    shipment.isDelivered,\n  );\n\n  // Sort scans descending to get the latest one for timestamp/statusCode\n  const sorted = [...shipment.Scans].sort(\n    (a, b) =>\n      new Date(b.ScanDateTime).getTime() -\n      new Date(a.ScanDateTime).getTime(),\n  );\n  const latestScan = sorted[0];\n  const timestamp = latestScan\n    ? new Date(\n      latestScan.ScanTimeZone\n        ? `${latestScan.ScanDateTime}${latestScan.ScanTimeZone}`\n        : latestScan.ScanDateTime,\n    )\n    : new Date();\n\n  return {\n    carrier: \"smsaexpress\",\n    eventType: \"status_update\",\n    trackingNumber: shipment.AWB,\n    reference: shipment.Reference || undefined,\n    status,\n    statusCode: latestScan?.ScanType ?? \"unknown\",\n    statusLabel,\n    timestamp,\n    raw: shipment,\n  };\n}\n\nfunction validateWebhookPayload(payload: unknown): SMSAWebhookShipment[] {\n  if (!Array.isArray(payload)) {\n    throw new ValidationError(\n      \"Invalid SMSA webhook payload: expected an array of shipments\",\n      { raw: payload },\n    );\n  }\n\n  if (payload.length === 0) {\n    throw new ValidationError(\"Invalid SMSA webhook payload: empty array\", {\n      raw: payload,\n    });\n  }\n\n  for (const item of payload) {\n    if (\n      !item ||\n      typeof item !== \"object\" ||\n      !(\"AWB\" in item) ||\n      !(\"Scans\" in item)\n    ) {\n      throw new ValidationError(\n        \"Invalid SMSA webhook payload: shipment missing required fields (AWB, Scans)\",\n        { raw: item },\n      );\n    }\n  }\n\n  return payload as SMSAWebhookShipment[];\n}\n\n/**\n * Parse an SMSA webhook payload and return a single WebhookEvent\n * for the first shipment in the batch.\n *\n * SMSA sends webhooks as an array of shipments. This function returns\n * only the first item — use `parseSMSAWebhookBatch()` for full batch parsing.\n */\nexport function parseSMSAWebhook(\n  payload: unknown,\n  options?: {\n    headers?: Record<string, string>;\n    queryParams?: Record<string, string>;\n    config?: WebhookConfig;\n  },\n): WebhookEvent {\n  verifyWebhookAuth(options);\n  const shipments = validateWebhookPayload(payload);\n  return mapWebhookShipmentToEvent(shipments[0]!);\n}\n\n/**\n * Parse an SMSA webhook payload and return a WebhookEvent for every\n * shipment in the batch.\n *\n * SMSA sends webhook payloads as an array of shipments, each with\n * their own tracking scans.\n */\nexport function parseSMSAWebhookBatch(\n  payload: unknown,\n  options?: {\n    headers?: Record<string, string>;\n    queryParams?: Record<string, string>;\n    config?: WebhookConfig;\n  },\n): WebhookEvent[] {\n  verifyWebhookAuth(options);\n  const shipments = validateWebhookPayload(payload);\n  return shipments.map(mapWebhookShipmentToEvent);\n}\n",
+    "// file: src/carriers/smsaexpress/adapter.ts\n/**\n * SMSA Express Carrier Adapter\n * Full implementation of the CarrierAdapter interface for SMSA Express API.\n */\n\nimport { APIError } from \"../../core/errors\";\nimport { HttpClient } from \"../../core/http\";\nimport type {\n  CarrierConfig,\n  City,\n  CreateShipmentInput,\n  Location,\n  Shipment,\n  TrackingResult,\n  WebhookConfig,\n  WebhookEvent,\n} from \"../../core/types\";\nimport { BaseCarrierAdapter } from \"../base\";\nimport {\n  mapCity,\n  mapCreate2WayRequest,\n  mapCreateB2CRequest,\n  mapCreateC2BRequest,\n  mapOffice,\n  mapShipmentResponse,\n  mapTrackingResult,\n  parseSMSAWebhook,\n  parseSMSAWebhookBatch,\n} from \"./mappers\";\nimport type {\n  SMSACityLookupItem,\n  SMSAOfficeLookupItem,\n  SMSAPushIdDetailsRequest,\n  SMSAPushIdDetailsResponse,\n  SMSASendInvoiceRequest,\n  SMSAShipmentResponse,\n  SMSAShortAddressResponse,\n  SMSATrackingResponse,\n} from \"./types\";\n\nconst SMSA_SANDBOX_URL = \"https://ecomapis-sandbox.azurewebsites.net\";\nconst SMSA_PRODUCTION_URL = \"https://ecomapis.smsaexpress.com\";\n\n/** Reverse-pickup / C2B service codes */\nconst C2B_SERVICE_CODES = new Set([\"EDCR\"]);\n\nexport interface SMSAExpressConfig extends CarrierConfig {\n  credentials: {\n    apiKey: string;\n  };\n}\n\nexport class SMSAExpressAdapter extends BaseCarrierAdapter {\n  readonly name = \"smsaexpress\";\n  readonly supportedCountries = [\n    \"SA\",\n    \"AE\",\n    \"BH\",\n    \"EG\",\n    \"KW\",\n    \"OM\",\n    \"QA\",\n    \"JO\",\n  ];\n\n  private http: HttpClient;\n\n  constructor(config: SMSAExpressConfig) {\n    super(config);\n    this.http = new HttpClient({\n      baseUrl: this.getBaseUrl(),\n      carrier: \"smsaexpress\",\n      headers: {\n        apikey: config.credentials.apiKey,\n      },\n    });\n  }\n\n  protected getBaseUrl(): string {\n    return this.config.mode === \"production\"\n      ? SMSA_PRODUCTION_URL\n      : SMSA_SANDBOX_URL;\n  }\n\n  // =========================================================================\n  // SHIPPING\n  // =========================================================================\n\n  protected async executeCreateShipment(\n    input: CreateShipmentInput,\n  ): Promise<Shipment> {\n    const isC2B = C2B_SERVICE_CODES.has(input.serviceType);\n\n    if (isC2B) {\n      return this.createC2BShipment(input);\n    }\n\n    const request = mapCreateB2CRequest(input);\n    const response = await this.http.post<SMSAShipmentResponse>(\n      \"/api/shipment/b2c/new\",\n      request,\n    );\n\n    return mapShipmentResponse(response, input);\n  }\n\n  private async createC2BShipment(\n    input: CreateShipmentInput,\n  ): Promise<Shipment> {\n    const request = mapCreateC2BRequest(input);\n    const response = await this.http.post<SMSAShipmentResponse>(\n      \"/api/c2b/new\",\n      request,\n    );\n\n    return mapShipmentResponse(response, input);\n  }\n\n  /**\n   * Cancel a reverse-pickup (C2B) shipment.\n   *\n   * **Important:** SMSA only supports cancellation for C2B/reverse-pickup shipments.\n   * Calling this on a B2C shipment will result in an API error or return `false`.\n   * B2C shipments cannot be cancelled via the SMSA API.\n   */\n  async cancelShipment(trackingNumber: string): Promise<boolean> {\n    const response = await this.http.post<string>(\n      `/api/c2b/cancel/${encodeURIComponent(trackingNumber)}`,\n    );\n    // API returns a string message on success\n    return typeof response === \"string\"\n      ? response.toLowerCase().includes(\"cancelled\")\n      : true;\n  }\n\n  // =========================================================================\n  // TRACKING\n  // =========================================================================\n\n  async track(trackingNumber: string): Promise<TrackingResult> {\n    const response = await this.http.get<SMSATrackingResponse>(\n      `/api/track/single/${encodeURIComponent(trackingNumber)}`,\n    );\n\n    return mapTrackingResult(response);\n  }\n\n  async trackMultiple(trackingNumbers: string[]): Promise<TrackingResult[]> {\n    const response = await this.http.post<SMSATrackingResponse[]>(\n      \"/api/track/bulk/\",\n      trackingNumbers,\n      { retry: true },\n    );\n\n    return response.map(mapTrackingResult);\n  }\n\n  async trackByReference(reference: string): Promise<TrackingResult> {\n    const response = await this.http.get<SMSATrackingResponse>(\n      `/api/track/reference/${encodeURIComponent(reference)}`,\n    );\n\n    return mapTrackingResult(response);\n  }\n\n  // =========================================================================\n  // LABELS\n  // =========================================================================\n\n  async getLabel(\n    trackingNumber: string,\n    _format?: \"PDF\" | \"PNG\",\n  ): Promise<string> {\n    // SMSA returns the waybill file (base64 PDF) as part of the shipment query.\n    // Try B2C first (most common), then C2B as fallback.\n    const encoded = encodeURIComponent(trackingNumber);\n\n    for (const path of [\n      `/api/shipment/b2c/query/${encoded}`,\n      `/api/c2b/query/${encoded}`,\n    ]) {\n      try {\n        const response = await this.http.get<SMSAShipmentResponse>(path);\n        const waybill = response.waybills?.[0];\n        if (waybill?.awbFile) {\n          return `data:application/pdf;base64,${waybill.awbFile}`;\n        }\n      } catch (error) {\n        // Only swallow 4xx API errors (shipment type mismatch / not found).\n        // Re-throw auth, network, server, and unexpected errors immediately.\n        if (\n          !(error instanceof APIError) ||\n          error.statusCode === 401 ||\n          (error.statusCode !== undefined && error.statusCode >= 500)\n        ) {\n          throw error;\n        }\n      }\n    }\n\n    throw new APIError(\"No label found for shipment\", {\n      carrier: \"smsaexpress\",\n      raw: { trackingNumber },\n    });\n  }\n\n  // =========================================================================\n  // CITIES & LOCATIONS\n  // =========================================================================\n\n  async getCities(countryCode = \"SA\"): Promise<City[]> {\n    const response = await this.http.get<SMSACityLookupItem[]>(\n      `/api/lookup/cities/${encodeURIComponent(countryCode)}`,\n    );\n\n    return response.map(mapCity);\n  }\n\n  async getDropoffLocations(): Promise<Location[]> {\n    const response = await this.http.get<SMSAOfficeLookupItem[]>(\n      \"/api/lookup/smsaoffices\",\n    );\n\n    return response.map(mapOffice);\n  }\n\n  // =========================================================================\n  // 2-WAY SHIPMENT\n  // =========================================================================\n\n  async create2WayShipment(input: CreateShipmentInput): Promise<Shipment> {\n    const request = mapCreate2WayRequest(input);\n    const response = await this.http.post<SMSAShipmentResponse>(\n      \"/api/TwoWayShipment/new\",\n      request,\n    );\n\n    return mapShipmentResponse(response, input);\n  }\n\n  // =========================================================================\n  // INVOICE & ID OPERATIONS (SMSA-specific)\n  // =========================================================================\n\n  async sendInvoice(request: SMSASendInvoiceRequest): Promise<string> {\n    return this.http.post<string>(\"/api/invoice\", request);\n  }\n\n  async validateShortAddress(\n    shortCode: string,\n  ): Promise<SMSAShortAddressResponse> {\n    return this.http.get<SMSAShortAddressResponse>(\n      `/api/Lookup/FullAddressByShortCode/${encodeURIComponent(shortCode)}`,\n    );\n  }\n\n  async pushIdDetails(\n    request: SMSAPushIdDetailsRequest,\n  ): Promise<SMSAPushIdDetailsResponse> {\n    return this.http.post<SMSAPushIdDetailsResponse>(\n      \"/api/shipment/identity-details\",\n      request,\n    );\n  }\n\n  // =========================================================================\n  // WEBHOOKS\n  // =========================================================================\n\n  parseWebhook(\n    payload: unknown,\n    options?: {\n      headers?: Record<string, string>;\n      queryParams?: Record<string, string>;\n      config?: WebhookConfig;\n    },\n  ): WebhookEvent {\n    return parseSMSAWebhook(payload, options);\n  }\n\n  /**\n   * Parse a batch SMSA webhook payload into multiple events.\n   *\n   * SMSA sends webhook payloads as an array of shipments, each with their own\n   * tracking scans. This method returns a WebhookEvent for every shipment\n   * in the payload.\n   */\n  parseWebhookBatch(\n    payload: unknown,\n    options?: {\n      headers?: Record<string, string>;\n      queryParams?: Record<string, string>;\n      config?: WebhookConfig;\n    },\n  ): WebhookEvent[] {\n    return parseSMSAWebhookBatch(payload, options);\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C9233984938A6D4764756E2164756E21",
+  "names": []
+}

package/dist/carriers/smsaexpress/mappers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SMSA Express Data Mappers
+ * Transform between unified ShipFlow types and SMSA Express API formats.
+ */
+import type { City, CreateShipmentInput, Location, Shipment, ShipmentStatus, TrackingEvent, TrackingResult, WebhookConfig, WebhookEvent } from "../../core/types.js";
+import type { SMSACityLookupItem, SMSACreate2WayShipmentRequest, SMSACreateB2CShipmentRequest, SMSACreateC2BShipmentRequest, SMSAOfficeLookupItem, SMSAShipmentResponse, SMSATrackingResponse, SMSATrackingScan } from "./types.js";
+export declare function mapSMSAStatus(scanType: string): ShipmentStatus;
+export declare function mapCreateB2CRequest(input: CreateShipmentInput): SMSACreateB2CShipmentRequest;
+/**
+ * Map to C2B (reverse pickup) request.
+ * In C2B flow, the consignee is the pickup point (customer returning),
+ * and the shipper is the return-to address (merchant warehouse).
+ */
+export declare function mapCreateC2BRequest(input: CreateShipmentInput): SMSACreateC2BShipmentRequest;
+export declare function mapShipmentResponse(data: SMSAShipmentResponse, input: CreateShipmentInput): Shipment;
+export declare function mapTrackingEvent(scan: SMSATrackingScan): TrackingEvent;
+export declare function mapTrackingResult(data: SMSATrackingResponse): TrackingResult;
+export declare function mapCity(city: SMSACityLookupItem): City;
+export declare function mapOffice(office: SMSAOfficeLookupItem): Location;
+export declare function mapCreate2WayRequest(input: CreateShipmentInput): SMSACreate2WayShipmentRequest;
+/**
+ * Parse an SMSA webhook payload and return a single WebhookEvent
+ * for the first shipment in the batch.
+ *
+ * SMSA sends webhooks as an array of shipments. This function returns
+ * only the first item — use `parseSMSAWebhookBatch()` for full batch parsing.
+ */
+export declare function parseSMSAWebhook(payload: unknown, options?: {
+    headers?: Record<string, string>;
+    queryParams?: Record<string, string>;
+    config?: WebhookConfig;
+}): WebhookEvent;
+/**
+ * Parse an SMSA webhook payload and return a WebhookEvent for every
+ * shipment in the batch.
+ *
+ * SMSA sends webhook payloads as an array of shipments, each with
+ * their own tracking scans.
+ */
+export declare function parseSMSAWebhookBatch(payload: unknown, options?: {
+    headers?: Record<string, string>;
+    queryParams?: Record<string, string>;
+    config?: WebhookConfig;
+}): WebhookEvent[];
+//# sourceMappingURL=mappers.d.ts.map

package/dist/carriers/smsaexpress/mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../../../src/carriers/smsaexpress/mappers.ts"],"names":[],"mappings":"AACA;;;GAGG;AAOH,OAAO,KAAK,EACV,IAAI,EACJ,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EAEpB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAMjB,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAE9D;AAyDD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GACzB,4BAA4B,CAiC9B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GACzB,4BAA4B,CA0B9B;AAMD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,mBAAmB,GACzB,QAAQ,CA8BV;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAYtE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CA2B5E;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAKtD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAahE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,GACzB,6BAA6B,CA8B/B;AAuHD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,GACA,YAAY,CAId;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,GACA,YAAY,EAAE,CAIhB"}

package/dist/carriers/smsaexpress/services.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SMSA Express Service Type Codes
+ * Use these constants for type-safe service selection.
+ */
+export declare const SMSAService: {
+    /** E-commerce delivery */
+    readonly ECOMMERCE_DELIVERY: "EDDL";
+    /** Express delivery */
+    readonly EXPRESS_DELIVERY: "EDEL";
+    /** C2B / Reverse pickup */
+    readonly C2B_REVERSE: "EDCR";
+};
+export type SMSAServiceType = (typeof SMSAService)[keyof typeof SMSAService];
+/**
+ * SMSA Express Scan Type Codes → Unified ShipmentStatus mapping.
+ *
+ * Based on /api/track/statuslookup response.
+ * Scan types not explicitly listed default to "in_transit".
+ */
+export declare const SMSAStatusCodes: Record<string, string>;
+//# sourceMappingURL=services.d.ts.map

package/dist/carriers/smsaexpress/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/carriers/smsaexpress/services.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,eAAO,MAAM,WAAW;IACtB,0BAA0B;;IAE1B,uBAAuB;;IAEvB,2BAA2B;;CAEnB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwClD,CAAC"}