universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/paack/carrier.json

@@ -0,0 +1,79 @@
+{
+  "id": "paack",
+  "displayName": "Paack",
+  "aliases": [
+    "Paack Logistics"
+  ],
+  "region": {
+    "countries": [
+      "ES",
+      "PT",
+      "FR",
+      "GB"
+    ]
+  },
+  "brand": {
+    "color": "#5b2dee"
+  },
+  "selectable": true,
+  "timezone": "Europe/Paris",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "paack",
+    "requirements": [
+      {
+        "field": "dpdPostcode",
+        "validator": "paackPostcode",
+        "label": "Delivery postcode",
+        "type": "text",
+        "placeholder": "75001",
+        "help": "Paack requires the recipient postcode together with the order number.",
+        "pattern": "^(?=.{3,10}$)(?=.*[0-9])[A-Za-z0-9]+(?:[ -][A-Za-z0-9]+)*$",
+        "maxLength": 10,
+        "inputMode": "text",
+        "autoComplete": "postal-code"
+      }
+    ],
+    "steps": [
+      "direct"
+    ]
+  },
+  "capabilities": [
+    "history",
+    "eta"
+  ],
+  "portal": {
+    "url": "https://mydeliveries.paack.app/tracking?tracking_number={trackingNumber}",
+    "canaryUrl": "https://mydeliveries.paack.app/tracking",
+    "shows": [
+      "status",
+      "history",
+      "eta",
+      "sender_name",
+      "recipient_name",
+      "recipient_address"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "eta"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "recipient_address"
+    ],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "mydeliveries.paack.app"
+      ],
+      "params": [
+        "tracking_number"
+      ]
+    }
+  ],
+  "detection": []
+}

package/dist/carriers/paack/numbers.json

@@ -0,0 +1,106 @@
+{
+  "carrier": "paack",
+  "records": [
+    {
+      "number": "00100909086360120251130131718",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/mucho-retraso-en-entrega/3e6c4a88d9208bdbc4",
+        "date": "2025-12-23"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Paack; no rule matches this shape."
+    },
+    {
+      "number": "437650784",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/falso-intento-de-entrega/373a062914965f9e1b",
+        "date": "2025-01-23"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tnt"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Paack, which no rule claims."
+    },
+    {
+      "number": "534000021250958171",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/incumplimient-reiterado-y-bloq/23dcce3eced56549b3",
+        "date": "2025-12-08"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Paack, which no rule claims."
+    },
+    {
+      "number": "534000021265325582",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/dos-semanas-despues!!!!/3a0638ce2147eda441",
+        "date": "2026-09-22"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Paack, which no rule claims. Amazon order."
+    },
+    {
+      "number": "9451162004086887",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/no-me-llega-el-pedido/4032cceef0a358e05d",
+        "date": "2025-12-11"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl-ecommerce",
+          "correos-express",
+          "canada-post",
+          "tnt"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Paack, which no rule claims."
+    },
+    {
+      "number": "C25062001456003",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/entrega-no-recibida/4d61e00924bdfeea75",
+        "date": "2025-07-10"
+      },
+      "expect": {
+        "carrier": "ontrac",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Paack; detection selects OnTrac."
+    }
+  ]
+}

package/dist/carriers/paack/status.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Paack event identifiers → product stage.
+ *
+ * The recipient page ships a timeline whose entries carry a stable `id` and a
+ * translation `label`; the visible text is localized per viewer, so the map
+ * keys on the identifiers instead. Both fields are reduced to lower-case
+ * letters and digits and concatenated, then matched by substring, which keeps
+ * suffixed variants ("scannedAtOriginHeader", "pudoAssignedHeader") on the
+ * same stage as their base identifier.
+ *
+ * Order matters: return and failure identifiers are tested before the broader
+ * delivery ones, so "notDelivered" can never match the "delivered" substring.
+ * The provider's own wording is never returned; each mapped entry supplies the
+ * English description we display.
+ */
+import type { CarrierStatus } from '../../core/result/index.js';
+import type { Stage } from '../../generated/catalog.js';
+import type { JsonObject } from '../../core/types.js';
+export interface ClassifiedPaackStatus {
+    status: CarrierStatus;
+    stage: Stage;
+    description: string;
+}
+/** Reduce a provider identifier or label to lower-case letters and digits. */
+export declare function statusKey(value: unknown): string;
+export declare function classifyPaackEvent(value: JsonObject): ClassifiedPaackStatus;

package/dist/carriers/paack/status.js

@@ -0,0 +1,82 @@
+/** Reduce a provider identifier or label to lower-case letters and digits. */
+export function statusKey(value) {
+    return typeof value === 'string'
+        ? value.toLocaleLowerCase('en-US').replace(/[^a-z0-9]+/g, '')
+        : '';
+}
+function includesAny(value, candidates) {
+    return candidates.some((candidate) => value.includes(candidate));
+}
+export function classifyPaackEvent(value) {
+    const key = `${statusKey(value.label)} ${statusKey(value.id)}`;
+    if (includesAny(key, [
+        'returnedsender',
+        'returnedtosender',
+        'returnedtoretailer',
+    ])) {
+        return { status: 'exception', stage: 'returned', description: 'Shipment returned' };
+    }
+    if (includesAny(key, [
+        'incorrectaddress',
+        'notaccepted',
+        'rejected',
+        'damaged',
+        'lost',
+        'nondeliverable',
+        'integrationerror',
+        'cancelled',
+        'canceled',
+    ]))
+        return { status: 'exception', stage: 'exception', description: 'Shipment exception' };
+    if (includesAny(key, [
+        'returntosenderscheduled',
+        'returnabsent',
+        'returnother',
+        'absent',
+        'attempted',
+        'deliveryfailed',
+        'failedattempt',
+        'notdelivered',
+        'undelivered',
+    ]))
+        return { status: 'exception', stage: 'failed_attempt', description: 'Delivery issue' };
+    if (includesAny(key, ['delivered', 'deliverycompleted'])) {
+        return { status: 'delivered', stage: 'delivered', description: 'Delivered' };
+    }
+    if (includesAny(key, ['readyforpickup', 'atpickuppoint'])) {
+        return { status: 'out_for_delivery', stage: 'ready_for_pickup', description: 'Ready for pickup' };
+    }
+    if (includesAny(key, ['outfordelivery', 'driverassigned', 'inprogress'])) {
+        return {
+            status: 'out_for_delivery',
+            stage: 'out_for_delivery',
+            description: 'Out for delivery',
+        };
+    }
+    if (includesAny(key, [
+        'manifested',
+        'created',
+        'notreceivedfromretailer',
+        'additionaldeliveryattemptscheduled',
+        'orderreactivated',
+        'appointmentbroughtforward',
+        'appointmentrescheduled',
+        'appointmentscheduled',
+    ]))
+        return { status: 'pending', stage: 'registered', description: 'Shipment registered' };
+    if (includesAny(key, ['scannedatorigin'])) {
+        return { status: 'in_transit', stage: 'accepted', description: 'Shipment accepted' };
+    }
+    if (includesAny(key, [
+        'received',
+        'collected',
+        'transit',
+        'hub',
+        'warehouse',
+        'sorted',
+        'pudoassigned',
+    ])) {
+        return { status: 'in_transit', stage: 'in_transit', description: 'In transit' };
+    }
+    return { status: 'unknown', stage: 'in_transit', description: 'Shipment update' };
+}

package/dist/carriers/paack/statuses.json

@@ -0,0 +1,357 @@
+{
+  "carrier": "paack",
+  "entries": [
+    {
+      "code": "returnedsender",
+      "language": "en",
+      "stage": "returned",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "returnedtosender",
+      "language": "en",
+      "stage": "returned",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline test's returnedToSender scenario."
+    },
+    {
+      "code": "returnedtoretailer",
+      "language": "en",
+      "stage": "returned",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "returntosenderscheduled",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Return scheduled, not yet returned: kept non-final so the parcel stays active."
+    },
+    {
+      "code": "returnabsent",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Return scheduled after an absence: kept non-final."
+    },
+    {
+      "code": "returnother",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Return scheduled for another reason: kept non-final."
+    },
+    {
+      "code": "incorrectaddress",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the delivered-order fixture's earlier attempt row. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "absent",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline test's absent scenario."
+    },
+    {
+      "code": "attempted",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "deliveryfailed",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "failedattempt",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "notdelivered",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Tested before the delivered rule so it can never match the 'delivered' substring."
+    },
+    {
+      "code": "undelivered",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "notaccepted",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "rejected",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "damaged",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "lost",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "nondeliverable",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "integrationerror",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline active-label table. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "cancelled",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "canceled",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "delivered",
+      "language": "en",
+      "stage": "delivered",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the delivered-order fixture."
+    },
+    {
+      "code": "deliverycompleted",
+      "language": "en",
+      "stage": "delivered",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "readyforpickup",
+      "language": "en",
+      "stage": "ready_for_pickup",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "atpickuppoint",
+      "language": "en",
+      "stage": "ready_for_pickup",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "outfordelivery",
+      "language": "en",
+      "stage": "out_for_delivery",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "driverassigned",
+      "language": "en",
+      "stage": "out_for_delivery",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the delivered-order fixture's inProgress row."
+    },
+    {
+      "code": "inprogress",
+      "language": "en",
+      "stage": "out_for_delivery",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the delivered-order fixture's inProgress row."
+    },
+    {
+      "code": "manifested",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "created",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "notreceivedfromretailer",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "additionaldeliveryattemptscheduled",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "orderreactivated",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline active-label table."
+    },
+    {
+      "code": "appointmentbroughtforward",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline active-label table."
+    },
+    {
+      "code": "appointmentrescheduled",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline active-label table."
+    },
+    {
+      "code": "appointmentscheduled",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "scannedatorigin",
+      "language": "en",
+      "stage": "accepted",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline active-label table via scannedAtOriginHeader."
+    },
+    {
+      "code": "received",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline receivedAtHub scenario."
+    },
+    {
+      "code": "collected",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "transit",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "hub",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline receivedAtHub scenario."
+    },
+    {
+      "code": "warehouse",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "sorted",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "firstSeen": "2026-09-12",
+      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+    },
+    {
+      "code": "pudoassigned",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Exercised by the offline active-label table via pudoAssignedHeader."
+    }
+  ]
+}

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

@@ -0,0 +1,15 @@
+import type { AdapterFactory } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizePacketaTrackingNumber(raw: string): string;
+export declare function packetaTrackingUrl(rawTrackingNumber: string): string;
+export declare function parsePacketaTrackingResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare class PacketaTracker {
+    readonly timeoutMs: number;
+    readonly fetcher: typeof fetch | undefined;
+    constructor(options?: {
+        timeoutMs?: number;
+        fetcher?: typeof fetch;
+    });
+    fetch(rawTrackingNumber: string): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;