shipflow 0.1.0

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

@@ -0,0 +1,197 @@
+/**
+ * SMSA Express Raw API Types
+ * These directly mirror the SMSA Express API request/response formats.
+ */
+export interface SMSAShipmentAddress {
+    AddressLine1: string;
+    AddressLine2?: string;
+    City: string;
+    ConsigneeID?: string;
+    ContactName: string;
+    ContactPhoneNumber: string;
+    Coordinates?: string;
+    Country: string;
+    District?: string;
+    PostalCode?: string;
+    ShortCode?: string;
+}
+export interface SMSACreateB2CShipmentRequest {
+    CODAmount: number;
+    ConsigneeAddress: SMSAShipmentAddress;
+    ContentDescription: string;
+    DeclaredValue: number;
+    DutyPaid?: boolean;
+    OrderNumber: string;
+    Parcels: number;
+    ServiceCode?: string;
+    ShipDate: string;
+    ShipmentCurrency: string;
+    ShipperAddress: SMSAShipmentAddress;
+    SMSARetailID?: string;
+    VatPaid?: boolean;
+    WaybillType?: "PDF" | "ZPL";
+    Weight: number;
+    WeightUnit: "KG" | "LB";
+}
+export interface SMSACreateC2BShipmentRequest {
+    ContentDescription: string;
+    DeclaredValue: number;
+    OrderNumber: string;
+    Parcels: number;
+    PickupAddress: SMSAShipmentAddress;
+    ReturnToAddress: SMSAShipmentAddress;
+    ServiceCode?: string;
+    ShipDate: string;
+    ShipmentCurrency: string;
+    SMSARetailID?: string;
+    WaybillType?: "PDF" | "ZPL";
+    Weight: number;
+    WeightUnit: "KG" | "LB";
+}
+export interface SMSACreate2WayShipmentRequest {
+    ConsigneeAddress: SMSAShipmentAddress;
+    ContentDescription: string;
+    DeclaredValue: number;
+    DutyPaid?: boolean;
+    OrderNumber: string;
+    Parcels: number;
+    ShipDate: string;
+    ShipmentCurrency: string;
+    ShipperAddress: SMSAShipmentAddress;
+    SMSARetailID?: string;
+    VatPaid?: boolean;
+    WaybillType?: "PDF" | "ZPL";
+    Weight: number;
+    WeightUnit: "KG" | "LB";
+}
+export interface SMSAInvoiceItem {
+    CountryOfOrigin?: string;
+    ItemDescription: string;
+    ItemHSCode: string;
+    ItemReference: string;
+    ItemValue: number;
+    Quantity: number;
+    QuantityUnit: string;
+    sequence: number;
+    Weight: number;
+}
+export interface SMSASendInvoiceRequest {
+    AWB: string;
+    Currency: string;
+    InvoiceDate: string;
+    Items: SMSAInvoiceItem[];
+    WeightUnit: "KG" | "LB";
+}
+export interface SMSAPushIdDetailsRequest {
+    awb: string;
+    birthDate: string;
+    documentType: "PASSPORT" | "ID_CARD" | "RESIDENCE_PERMIT";
+    idName: string;
+    idNumber: string;
+    issueDate: string;
+    nationality: string;
+    shipmentReference?: string;
+}
+export interface SMSAWaybill {
+    awb: string;
+    awbFile: string;
+    returnBarcode?: string;
+}
+export interface SMSAShipmentResponse {
+    sawb: string;
+    createDate: string;
+    shipmentParcelsCount: number;
+    waybills: SMSAWaybill[];
+}
+export interface SMSATrackingScan {
+    ReceivedBy?: string;
+    City: string;
+    ScanType: string;
+    ScanDescription: string;
+    ScanDateTime: string;
+    ScanTimeZone: string;
+}
+export interface SMSATrackingResponse {
+    AWB: string;
+    Reference: string;
+    Pieces: number;
+    CODAmount: number;
+    ContentDesc: string;
+    RecipientName: string;
+    OriginCity: string;
+    OriginCountry: string;
+    DesinationCity: string;
+    DesinationCountry: string;
+    isDelivered?: boolean;
+    Scans: SMSATrackingScan[];
+}
+export interface SMSAStatusLookupItem {
+    Code: string;
+    ScanDescEN: string;
+    ScanDescAR: string;
+}
+export interface SMSACityLookupItem {
+    cityName: string;
+    cityCode: string;
+    countryCode: string;
+    currencyCode: string;
+    currencyName: string;
+}
+export interface SMSACountryCurrencyItem {
+    countryName: string;
+    countryCode: string;
+    currency: string;
+    currencyCode: string;
+}
+export interface SMSAOfficeLookupItem {
+    code: string;
+    address: string;
+    cityName: string;
+    addressAR: string;
+    coordinates: string;
+    firstShift: string;
+    secondShift: string;
+    weekendShift: string;
+}
+export interface SMSAShortAddressResponse {
+    address1: string;
+    address2: string;
+    buildingNumber: string;
+    street: string;
+    district: string;
+    city: string;
+    postCode: string;
+    additionalNumber: string;
+    regionName: string;
+    latitude: string;
+    longitude: string;
+}
+export interface SMSAPushIdDetailsResponse {
+    id: number;
+    awb: string;
+    message: string;
+}
+/** SMSA webhook scan includes a ReferenceID field not present in regular tracking scans */
+export interface SMSAWebhookScan extends SMSATrackingScan {
+    ReferenceID: number;
+}
+/**
+ * SMSA webhook shipment payload.
+ * Same structure as SMSATrackingResponse but scans include ReferenceID.
+ * SMSA sends an array of these as the webhook payload.
+ */
+export interface SMSAWebhookShipment {
+    AWB: string;
+    Reference: string;
+    Pieces: number;
+    CODAmount: number;
+    ContentDesc: string;
+    RecipientName: string;
+    OriginCity: string;
+    OriginCountry: string;
+    DesinationCity: string;
+    DesinationCountry: string;
+    isDelivered?: boolean;
+    Scans: SMSAWebhookScan[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/carriers/smsaexpress/types.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ShipFlow Client
+ * Tree-shakeable factory that accepts carrier adapters via dependency injection.
+ * Only the carriers you inject will be bundled in your final application.
+ */
+import type { CarrierAdapter } from "./carriers/base.js";
+import type { CreateShipmentInput, Rate, TrackingResult } from "./core/types.js";
+export interface ShipFlowOptions {
+    adapters: CarrierAdapter[];
+}
+export declare class ShipFlow {
+    private adapters;
+    constructor(options: ShipFlowOptions);
+    /**
+     * Get a specific carrier adapter by name.
+     * @throws ShipFlowError if carrier is not configured
+     */
+    carrier(name: string): CarrierAdapter;
+    /**
+     * Get all configured carrier names.
+     */
+    get carriers(): string[];
+    /**
+     * Check if a carrier is configured.
+     */
+    hasCarrier(name: string): boolean;
+    /**
+     * Get rates from all configured carriers that support rate calculation.
+     * Returns a map of carrier name to rates (or error).
+     */
+    getRatesFromAll(input: CreateShipmentInput): Promise<Map<string, Rate[] | Error>>;
+    /**
+     * Try to track a shipment across all configured carriers in parallel.
+     * Useful when you don't know which carrier handles a tracking number.
+     * Returns the first successful result with a known status.
+     */
+    trackAcrossCarriers(trackingNumber: string): Promise<TrackingResult | null>;
+}
+/**
+ * Factory function for creating ShipFlow client.
+ * This is the recommended way to instantiate the client.
+ */
+export declare function createShipFlow(options: ShipFlowOptions): ShipFlow;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAA8B;gBAElC,OAAO,EAAE,eAAe;IAQpC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAUrC;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;OAGG;IACG,eAAe,CACnB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;IAyBvC;;;;OAIG;IACG,mBAAmB,CACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAiBlC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAEjE"}

package/dist/core/errors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ShipFlow Error Hierarchy
+ * All errors extend ShipFlowError for consistent catch/handle patterns
+ */
+export declare class ShipFlowError extends Error {
+    readonly carrier?: string;
+    readonly code?: string;
+    readonly raw?: unknown;
+    constructor(message: string, options?: {
+        carrier?: string;
+        code?: string;
+        raw?: unknown;
+        cause?: Error;
+    });
+}
+/** Network-level errors (timeout, DNS, connection refused) */
+export declare class NetworkError extends ShipFlowError {
+    constructor(message: string, options?: {
+        carrier?: string;
+        cause?: Error;
+    });
+}
+/** API returned an error response (4xx, 5xx, or logical error like Aramex HasErrors: true) */
+export declare class APIError extends ShipFlowError {
+    readonly statusCode?: number;
+    readonly errors?: Record<string, string[]>;
+    constructor(message: string, options?: {
+        carrier?: string;
+        code?: string;
+        statusCode?: number;
+        errors?: Record<string, string[]>;
+        raw?: unknown;
+    });
+}
+/** Validation failed before sending request (Zod parse failure) */
+export declare class ValidationError extends ShipFlowError {
+    readonly field?: string;
+    readonly issues?: Array<{
+        path: string;
+        message: string;
+    }>;
+    constructor(message: string, options?: {
+        field?: string;
+        issues?: Array<{
+            path: string;
+            message: string;
+        }>;
+        raw?: unknown;
+    });
+}
+/** Invalid or missing credentials */
+export declare class AuthenticationError extends ShipFlowError {
+    constructor(message: string, options?: {
+        carrier?: string;
+        raw?: unknown;
+    });
+}
+/** Webhook signature/auth verification failed */
+export declare class WebhookVerificationError extends ShipFlowError {
+    constructor(message: string, options?: {
+        carrier?: string;
+    });
+}
+/** Carrier does not support this operation */
+export declare class UnsupportedOperationError extends ShipFlowError {
+    readonly operation: string;
+    constructor(carrier: string, operation: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/http.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Bun-native HTTP client for ShipFlow
+ * - Uses native fetch (optimized in Bun)
+ * - Handles "Fake 200 OK" responses (Aramex pattern)
+ * - Automatic JSON parsing with error extraction
+ * - Retry with exponential backoff via p-retry (GET only by default)
+ *
+ * SAFETY: Mutating requests (POST/PUT/DELETE/PATCH) are NOT retried by default
+ * because retrying e.g. createShipment after a 500 could create duplicate
+ * shipments on the carrier side. Use `retry: true` in RequestOptions to
+ * explicitly opt-in for safe POST endpoints (e.g. bulk tracking).
+ */
+export interface RetryConfig {
+    /** Max number of retries (default: 2) */
+    retries?: number;
+    /** HTTP status codes to retry on (default: [429, 500, 502, 503, 504]) */
+    retryableStatuses?: number[];
+}
+export interface HttpClientConfig {
+    baseUrl: string;
+    carrier: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retry?: RetryConfig | false;
+}
+export interface RequestOptions {
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    headers?: Record<string, string>;
+    body?: unknown;
+    params?: Record<string, string | number | boolean | undefined>;
+    /**
+     * Override default retry behavior for this request.
+     * - `true`  → allow retries (use for safe/idempotent POST endpoints like tracking)
+     * - `false` → never retry this request
+     * - omitted → auto (GET retries, mutating methods do not)
+     */
+    retry?: boolean;
+    /** Custom error extractor for carriers with non-standard error formats */
+    errorExtractor?: (json: unknown) => {
+        hasError: boolean;
+        message?: string;
+        errors?: Record<string, string[]>;
+    };
+}
+export declare class HttpClient {
+    private config;
+    private retryConfig;
+    private static readonly DEFAULT_RETRYABLE;
+    private static readonly SAFE_METHODS;
+    constructor(config: HttpClientConfig);
+    request<T>(endpoint: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Determine if a request should be retried.
+     * - Explicit `retry` option on the request takes priority
+     * - Otherwise: only safe/idempotent methods (GET) are retried
+     */
+    private shouldRetry;
+    private isRetryable;
+    private executeRequest;
+    private handleHttpError;
+    private extractErrorMessage;
+    private extractValidationErrors;
+    /** Create GET request */
+    get<T>(endpoint: string, options?: Omit<RequestOptions, "method" | "body">): Promise<T>;
+    /** Create POST request */
+    post<T>(endpoint: string, body?: unknown, options?: Omit<RequestOptions, "method" | "body">): Promise<T>;
+    /** Create PUT request */
+    put<T>(endpoint: string, body?: unknown, options?: Omit<RequestOptions, "method" | "body">): Promise<T>;
+    /** Create DELETE request */
+    delete<T>(endpoint: string, options?: Omit<RequestOptions, "method">): Promise<T>;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +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;IA6G5B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,mBAAmB;IAa3B,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"}