shipflow 0.1.1 → 0.3.0

package/dist/carriers/smsaexpress/index.js

@@ -4,7 +4,7 @@ import {
   HttpClient,
   ValidationError,
   WebhookVerificationError
-} from "../../index-qjtxhwzv.js";
+} from "../../index-qnxj8bct.js";
 
 // src/carriers/smsaexpress/services.ts
 var SMSAService = {
@@ -43,16 +43,20 @@ function deriveStatusFromScans(scans, isDelivered) {
   if (isDelivered) {
     return { status: "delivered", statusLabel: "Delivered" };
   }
-  if (scans.length === 0) {
+  const safeScans = scans ?? [];
+  if (safeScans.length === 0) {
     return { status: "unknown", statusLabel: "Unknown" };
   }
-  const sorted = [...scans].sort((a, b) => new Date(b.ScanDateTime).getTime() - new Date(a.ScanDateTime).getTime());
+  const sorted = [...safeScans].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 roundWeight(weight) {
+  return Math.round(weight * 1000) / 1000;
+}
 function mapAddress(addr, opts) {
   const result = {
     ContactName: addr.name,
@@ -90,8 +94,8 @@ function mapCreateB2CRequest(input) {
     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,
+    ShipmentCurrency: (input.cod?.enabled ? input.cod.currency : undefined) ?? input.declaredValue?.currency ?? input.cod?.currency ?? "SAR",
+    Weight: roundWeight(totalWeight),
     WeightUnit: "KG",
     WaybillType: input.labelFormat === "ZPL" ? "ZPL" : "PDF",
     ServiceCode: input.serviceType,
@@ -111,8 +115,8 @@ function mapCreateC2BRequest(input) {
     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,
+    ShipmentCurrency: (input.cod?.enabled ? input.cod.currency : undefined) ?? input.declaredValue?.currency ?? input.cod?.currency ?? "SAR",
+    Weight: roundWeight(totalWeight),
     WeightUnit: "KG",
     WaybillType: input.labelFormat === "ZPL" ? "ZPL" : "PDF",
     ServiceCode: input.serviceType ?? "EDCR",
@@ -136,9 +140,9 @@ function mapShipmentResponse(data, input) {
     statusLabel: "Created",
     codAmount: input.cod?.enabled ? input.cod.amount : undefined,
     declaredValue: input.declaredValue?.amount,
-    currency: input.declaredValue?.currency ?? input.cod?.currency ?? "SAR",
+    currency: (input.cod?.enabled ? input.cod.currency : undefined) ?? 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`),
+    createdAt: data.createDate ? new Date(/[Z]$|[+-]\d{2}(:\d{2})?$/.test(data.createDate) ? data.createDate : `${data.createDate}+03:00`) : new Date,
     raw: data
   };
 }
@@ -152,8 +156,9 @@ function mapTrackingEvent(scan) {
   };
 }
 function mapTrackingResult(data) {
-  const { status, statusLabel } = deriveStatusFromScans(data.Scans, data.isDelivered);
-  const deliveredScan = data.Scans.find((s) => s.ScanType === "DL");
+  const scans = data.Scans ?? [];
+  const { status, statusLabel } = deriveStatusFromScans(scans, data.isDelivered);
+  const deliveredScan = scans.find((s) => s.ScanType === "DL");
   const deliveredTimestamp = deliveredScan ? new Date(deliveredScan.ScanTimeZone ? `${deliveredScan.ScanDateTime}${deliveredScan.ScanTimeZone}` : deliveredScan.ScanDateTime) : undefined;
   return {
     trackingNumber: data.AWB,
@@ -161,7 +166,7 @@ function mapTrackingResult(data) {
     reference: data.Reference || undefined,
     status,
     statusLabel,
-    events: data.Scans.map(mapTrackingEvent),
+    events: scans.map(mapTrackingEvent),
     deliveryDate: deliveredTimestamp,
     codAmount: data.CODAmount > 0 ? data.CODAmount : undefined,
     pieces: data.Pieces,
@@ -203,7 +208,7 @@ function mapCreate2WayRequest(input) {
     Parcels: totalPieces,
     ShipDate: new Date().toISOString().slice(0, 19),
     ShipmentCurrency: input.declaredValue?.currency ?? "SAR",
-    Weight: totalWeight,
+    Weight: roundWeight(totalWeight),
     WeightUnit: "KG",
     WaybillType: input.labelFormat === "ZPL" ? "ZPL" : "PDF",
     SMSARetailID: input.options?.metadata?.smsaRetailId ?? "0",
@@ -244,8 +249,9 @@ function verifyWebhookAuth(options) {
   }
 }
 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 scans = shipment.Scans ?? [];
+  const { status, statusLabel } = deriveStatusFromScans(scans, shipment.isDelivered);
+  const sorted = [...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 {
@@ -409,4 +415,4 @@ export {
   SMSAExpressAdapter
 };
 
-//# debugId=9C8E3EA596675B1E64756E2164756E21
+//# debugId=D913394BAA446A3064756E2164756E21

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

@@ -3,10 +3,10 @@
   "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  opts?: { includeShortCode?: boolean },\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  // ShortCode is valid only on the consignee address per the SMSA spec.\n  if (opts?.includeShortCode && 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    includeShortCode: true,\n  });\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, { includeShortCode: true }),\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    includeShortCode: true,\n  });\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/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[] | undefined,\n  isDelivered?: boolean,\n): { status: ShipmentStatus; statusLabel: string } {\n  if (isDelivered) {\n    return { status: \"delivered\", statusLabel: \"Delivered\" };\n  }\n  // Records may omit Scans entirely (freshly-booked AWB, partial bulk record).\n  const safeScans = scans ?? [];\n  if (safeScans.length === 0) {\n    return { status: \"unknown\", statusLabel: \"Unknown\" };\n  }\n  const sorted = [...safeScans].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\n/**\n * Round a weight to 3 decimal places to avoid float-arithmetic noise\n * (e.g. 0.1 + 0.2 = 0.30000000000000004) leaking into the API payload.\n */\nfunction roundWeight(weight: number): number {\n  return Math.round(weight * 1000) / 1000;\n}\n\nfunction mapAddress(\n  addr: CreateShipmentInput[\"shipper\"] | CreateShipmentInput[\"consignee\"],\n  opts?: { includeShortCode?: boolean },\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  // ShortCode is valid only on the consignee address per the SMSA spec.\n  if (opts?.includeShortCode && 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    includeShortCode: true,\n  });\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    // When COD is enabled, its currency is the amount physically collected\n    // and must win over the declared-value currency.\n    ShipmentCurrency:\n      (input.cod?.enabled ? input.cod.currency : undefined) ??\n      input.declaredValue?.currency ??\n      input.cod?.currency ??\n      \"SAR\",\n    Weight: roundWeight(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, { includeShortCode: true }),\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    // When COD is enabled, its currency is the amount physically collected\n    // and must win over the declared-value currency.\n    ShipmentCurrency:\n      (input.cod?.enabled ? input.cod.currency : undefined) ??\n      input.declaredValue?.currency ??\n      input.cod?.currency ??\n      \"SAR\",\n    Weight: roundWeight(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    // When COD is enabled, its currency is the amount physically collected\n    // and must win over the declared-value currency.\n    currency:\n      (input.cod?.enabled ? input.cod.currency : undefined) ??\n      input.declaredValue?.currency ??\n      input.cod?.currency ??\n      \"SAR\",\n    returnLabel: firstWaybill?.returnBarcode\n      ? `data:application/pdf;base64,${firstWaybill.returnBarcode}`\n      : undefined,\n    // Guard a missing createDate so we never build `new Date(\"undefined+03:00\")`\n    // (Invalid Date). Append the SMSA timezone (+03:00) only to bare timestamps.\n    createdAt: data.createDate\n      ? new Date(\n          /[Z]$|[+-]\\d{2}(:\\d{2})?$/.test(data.createDate)\n            ? data.createDate\n            : `${data.createDate}+03:00`,\n        )\n      : new Date(),\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  // Real API records (freshly-booked AWB, partial bulk record) may omit Scans\n  // entirely; default to [] so a scan-less record yields \"unknown\" instead of\n  // throwing (and failing the whole trackMultiple batch).\n  const scans = data.Scans ?? [];\n  const { status, statusLabel } = deriveStatusFromScans(scans, data.isDelivered);\n\n  const deliveredScan = 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: 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    includeShortCode: true,\n  });\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: roundWeight(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  // A webhook record may arrive without Scans; default to [] so a scan-less\n  // shipment yields \"unknown\" instead of throwing.\n  const scans = shipment.Scans ?? [];\n  const { status, statusLabel } = deriveStatusFromScans(\n    scans,\n    shipment.isDelivered,\n  );\n\n  // Sort scans descending to get the latest one for timestamp/statusCode\n  const sorted = [...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 =\n      input.serviceType !== undefined &&\n      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 plain-text message on success (e.g. \"Shipment Cancelled\n    // Successfully!\"); inspect it for confirmation. A non-string (JSON) success\n    // response is treated as 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\" | \"ZPL\" | \"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": "9C8E3EA596675B1E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "D913394BAA446A3064756E2164756E21",
   "names": []
 }

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

@@ -1 +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;AA2DD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GACzB,4BAA4B,CAmC9B;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,CAgC/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"}
+{"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;AAqED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GACzB,4BAA4B,CAwC9B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GACzB,4BAA4B,CA+B9B;AAMD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,mBAAmB,GACzB,QAAQ,CAwCV;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAYtE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CA4B5E;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,CAgC/B;AA0HD;;;;;;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/core/errors.d.ts

@@ -32,7 +32,25 @@ export declare class APIError extends ShipFlowError {
         raw?: unknown;
     });
 }
-/** Validation failed before sending request (Zod parse failure) */
+/**
+ * Carrier rate-limited the request (HTTP 429, 503, or a carrier-specific throttle
+ * such as Aramex's "fake 200" envelope). Extends APIError so existing
+ * `instanceof APIError` handling keeps working, while `retryAfterMs` lets callers
+ * (and the retry helper) honor or reschedule against the carrier's wait window.
+ */
+export declare class RateLimitError extends APIError {
+    /** Suggested wait before retrying, in ms (parsed from Retry-After when present). */
+    readonly retryAfterMs?: number;
+    constructor(message: string, options?: {
+        carrier?: string;
+        code?: string;
+        statusCode?: number;
+        errors?: Record<string, string[]>;
+        retryAfterMs?: number;
+        raw?: unknown;
+    });
+}
+/** Validation failed before sending request (Valibot parse failure) */
 export declare class ValidationError extends ShipFlowError {
     readonly field?: string;
     readonly issues?: Array<{

package/dist/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAQ9E;AAED,8DAA8D;AAC9D,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAI3E;AAED,8FAA8F;AAC9F,qBAAa,QAAS,SAAQ,aAAa;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAClC,GAAG,CAAC,EAAE,OAAO,CAAC;KACf;CAOJ;AAED,mEAAmE;AACnE,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAGzD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClD,GAAG,CAAC,EAAE,OAAO,CAAC;KACf;CAOJ;AAED,qCAAqC;AACrC,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3E;AAED,iDAAiD;AACjD,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAI5D;AAED,8CAA8C;AAC9C,qBAAa,yBAA0B,SAAQ,aAAa;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAK/C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/core/http.d.ts

@@ -1,9 +1,10 @@
 /**
- * Bun-native HTTP client for ShipFlow
- * - Uses native fetch (optimized in Bun)
+ * HTTP client for ShipFlow
+ * - Uses the runtime's global `fetch` (Node 18+, Deno, Bun, edge/workers)
  * - Handles "Fake 200 OK" responses (Aramex pattern)
  * - Automatic JSON parsing with error extraction
- * - Retry with exponential backoff via p-retry (GET only by default)
+ * - Native retry with jittered exponential backoff (GET only by default)
+ * - Honors Retry-After on 429/503 within an inline cap (see ./retry)
  *
  * SAFETY: Mutating requests (POST/PUT/DELETE/PATCH) are NOT retried by default
  * because retrying e.g. createShipment after a 500 could create duplicate
@@ -15,6 +16,17 @@ export interface RetryConfig {
     retries?: number;
     /** HTTP status codes to retry on (default: [429, 500, 502, 503, 504]) */
     retryableStatuses?: number[];
+    /** Base delay (ms) for exponential backoff (default: 500) */
+    baseMs?: number;
+    /** Ceiling (ms) for the exponential-backoff window (default: 20_000) */
+    maxMs?: number;
+    /**
+     * Largest Retry-After delay (ms) we sleep on inline (default: 15_000).
+     * A 429/503 asking us to wait longer than this is surfaced as a
+     * `RateLimitError` (carrying `retryAfterMs`) instead of being retried inline,
+     * so a durable queue/workflow can reschedule it.
+     */
+    inlineCapMs?: number;
 }
 export interface HttpClientConfig {
     baseUrl: string;
@@ -35,11 +47,20 @@ export interface RequestOptions {
      * - omitted → auto (GET retries, mutating methods do not)
      */
     retry?: boolean;
+    /**
+     * Caller cancellation. Aborts both the in-flight request and any
+     * inter-attempt retry sleep, so one signal tears down the whole operation.
+     */
+    signal?: AbortSignal;
     /** Custom error extractor for carriers with non-standard error formats */
     errorExtractor?: (json: unknown) => {
         hasError: boolean;
         message?: string;
         errors?: Record<string, string[]>;
+        /** Carrier signalled throttling inside an otherwise-OK response. */
+        rateLimited?: boolean;
+        /** Suggested wait (ms) if the carrier provided one in-band. */
+        retryAfterMs?: number;
     };
 }
 export declare class HttpClient {

package/dist/core/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAUH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAClC,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACnC,CAAC;CACH;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAmD;IAEtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAuC;gBAE/D,MAAM,EAAE,gBAAgB;IAc9B,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAe5E;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;YAQL,cAAc;IA+G5B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,uBAAuB;IAc/B,yBAAyB;IACzB,GAAG,CAAC,CAAC,EACH,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,OAAO,CAAC,CAAC,CAAC;IAIb,0BAA0B;IAC1B,IAAI,CAAC,CAAC,EACJ,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,OAAO,CAAC,CAAC,CAAC;IAIb,yBAAyB;IACzB,GAAG,CAAC,CAAC,EACH,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,OAAO,CAAC,CAAC,CAAC;IAIb,4BAA4B;IAC5B,MAAM,CAAC,CAAC,EACN,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC;CAGd"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"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"}

package/dist/core/retry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Native, dependency-free retry helper for ShipFlow's HTTP client (replaces p-retry).
+ *
+ * Delay policy per failed-but-retryable attempt:
+ * - explicit Retry-After ≤ inlineCap → wait the window out + small positive jitter
+ * - explicit Retry-After > inlineCap → stop now, surface the error so a durable
+ *   queue/workflow can reschedule (a long inline sleep is unsafe in serverless /
+ *   request-bound contexts, and Retry-After is a contract — don't retry early)
+ * - otherwise → full-jitter exponential backoff
+ *
+ * The inter-attempt sleep uses `node:timers/promises` with an AbortSignal so a
+ * caller cancellation cleans up the timer (no zombie retries, no leaked `abort`
+ * listeners). Never hand-roll `new Promise(r => setTimeout(r, ms))` here.
+ */
+export interface RetryOptions {
+    /** Max number of retries after the first attempt. */
+    retries: number;
+    /** Base delay (ms) for exponential backoff. Default 500. */
+    baseMs?: number;
+    /** Ceiling (ms) for the exponential-backoff window. Default 20_000. */
+    maxMs?: number;
+    /**
+     * Largest Retry-After delay (ms) we sleep on inline. Beyond this we stop
+     * retrying and surface the error so the caller can reschedule durably.
+     * Default 15_000.
+     */
+    inlineCapMs?: number;
+    /** Whether a thrown error is retryable at all. */
+    shouldRetry: (error: unknown) => boolean;
+    /** Extracts an explicit Retry-After delay (ms) from the error, if any. */
+    retryAfterMs?: (error: unknown) => number | undefined;
+    /** Caller cancellation — aborts the in-flight request and the inter-attempt sleep. */
+    signal?: AbortSignal;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+/**
+ * Parse an HTTP `Retry-After` header into milliseconds.
+ * Supports both delay-seconds (`"120"`) and HTTP-date forms. Returns undefined
+ * when absent or unparseable; clamps past dates to 0.
+ */
+export declare function parseRetryAfter(headerValue: string | null | undefined): number | undefined;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACzC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACtD,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAuCZ;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS,CAUpB"}