universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/india-post/statuses.json

@@ -0,0 +1,18 @@
+{
+  "carrier": "india-post",
+  "entries": [
+    { "code": "ItemBooked", "wording": "Item Booked", "language": "en", "stage": "accepted", "confirmedBy": "fixture", "firstSeen": "2026-09-01", "note": "Substring key `itembooked`; `articlebooked` and `bookingconfirmed` map the same way." },
+    { "code": "ItemDispatched", "wording": "Item Dispatched", "language": "en", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-09-01", "note": "Substring key `itemdispatched`." },
+    { "wording": "Item Bagged", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring key `itembagged`." },
+    { "wording": "Item Received", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `itemreceived`, `receivedat`." },
+    { "wording": "Departed / Arrived / Forwarded / In Transit / Handed Over", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `departed`, `arrived`, `forwarded`, `intransit`, `handedover`." },
+    { "wording": "Shipment Information Received / Label Created / Article Created / Consignment Created", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `shipmentinformationreceived`, `labelcreated`, `articlecreated`, `consignmentcreated`." },
+    { "wording": "Customs / Custom Clearance", "language": "en", "stage": "customs", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `customs`, `customclearance`." },
+    { "code": "OutForDelivery", "wording": "Out For Delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `outfordelivery`, `itemoutfordelivery`, `sentfordelivery`." },
+    { "wording": "Ready For Pickup / Ready For Collection / Awaiting Collection", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `readyforpickup`, `readyforcollection`, `awaitingcollection`." },
+    { "code": "ItemDelivered", "wording": "Item Delivered", "language": "en", "stage": "delivered", "confirmedBy": "fixture", "firstSeen": "2026-09-01", "note": "Substring keys `itemdelivered`, `deliveredtorecipient`, `delivereddelivery`." },
+    { "code": "DeliveryAttempted", "wording": "Delivery Attempted", "language": "en", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `deliveryattempted`, `deliveryfailed`, `notdelivered`, `undelivered`." },
+    { "code": "InsufficientAddress", "wording": "Insufficient Address", "language": "en", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `insufficientaddress`, `addresseecannotbelocated`, `damaged`, `refused`, `lost`. Reclassified to exception 2026-09-12." },
+    { "code": "ReturnToSender", "wording": "Return To Sender", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring keys `returntosender`, `returnedtocustomer`, `returnedtobookingoffice`, `returnitem`." }
+  ]
+}

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

@@ -0,0 +1,14 @@
+import { type AdapterFactory } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeInpostTrackingNumber(raw: string): string;
+export declare function parseInpostTrackingResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare class InpostTracker {
+    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;

package/dist/carriers/inpost/adapter.js

@@ -0,0 +1,143 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { explicitOffsetTime } from '../../core/time/index.js';
+import { clean, fetchBounded, parseJsonBytes, UpstreamHttpError } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { classifyInpostStatus } from './status.js';
+// Protocol provenance:
+// - Prior art (structure + vocabulary, verified independently below, MIT):
+//   https://github.com/ha-parcel-integrations/ha-inpost (const.py,
+//   parcels.py normalize_tracking_parcel/TRACKING_STATUS_MAP, tests).
+//   Two public surfaces exist: the ShipX tracking endpoint
+//   (api-shipx-pl.easypack24.net, keyless, but its success shape is
+//   unconfirmed) and the inposteasy.com per-country hubs below. Only the
+//   inposteasy hub is implemented here; ShipX remains a future lead.
+// - Live verification 2026-09-10: GET
+//   https://inposteasy.com/api/tracking/000000000000000000000000 returns
+//   HTTP 404 with a structured NOT_FOUND problem body in ~0.2s, no cookies,
+//   headers or account. Long-expired corpus numbers return the same 404.
+// - Public cross-border status vocabulary live-confirmed on IT/PT/GB
+//   consignments 2026-08-31 by the prior-art client; the map lives in status.ts.
+const TRACKING_ENDPOINT = 'https://inposteasy.com/api/tracking';
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_RESPONSE_BYTES = 1_000_000;
+const MAX_EVENTS_TO_RETURN = 20;
+function statusCode(value) {
+    return clean(value, 32).toLocaleUpperCase('en-US');
+}
+export function normalizeInpostTrackingNumber(raw) {
+    const value = raw.toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
+    if (!/^(?:\d{24}|JJD\d{16}|JD\d{16}|8YDR\d{9})$/.test(value)) {
+        throw new TypeError('InPost tracking requires a 24-digit, JJD/JD legacy or 8YDR identifier');
+    }
+    return value;
+}
+export function parseInpostTrackingResponse(payload, trackingNumber) {
+    const requested = normalizeInpostTrackingNumber(trackingNumber);
+    if (!isRecord(payload))
+        throw new SchemaError('InPost', 'InPost returned an invalid tracking response');
+    const returned = clean(payload.trackingNumber, 64).toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
+    if (!returned)
+        throw new SchemaError('InPost', 'InPost did not return a shipment identifier');
+    if (returned !== requested)
+        throw new SchemaError('InPost', 'InPost returned a different shipment');
+    const code = statusCode(payload.status);
+    const classified = classifyInpostStatus(code);
+    const rawDetails = payload.trackingDetails;
+    if (rawDetails !== undefined && !Array.isArray(rawDetails)) {
+        throw new SchemaError('InPost', 'InPost returned invalid tracking history');
+    }
+    const parsed = [];
+    const seen = new Set();
+    (Array.isArray(rawDetails) ? rawDetails : []).filter(isRecord).slice(0, 500).forEach((rawEvent, index) => {
+        const eventCode = statusCode(rawEvent.status);
+        const eventClassified = classifyInpostStatus(eventCode);
+        // Observed event datetimes carry explicit offsets; require them rather than
+        // assigning a zone to a multi-country lane (PL/IT/PT/GB hubs share this API).
+        const time = explicitOffsetTime(rawEvent.datetime);
+        // statusTitle is the backend's fixed English wording for the requested hub.
+        // Origin/destination country codes travel alongside the parcel but feed no
+        // retained field: only normalized status and timeline fields are projected.
+        const description = clean(rawEvent.statusTitle, 500) || eventCode;
+        if (!time || !description)
+            return;
+        const identity = `${time.iso}\u0000${description}\u0000${eventCode}`;
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        parsed.push({
+            // An unmapped code keeps no stage: the sync classifies the wording and
+            // records where the stage came from instead of assuming movement here.
+            event: {
+                time: time.iso,
+                location: '',
+                description,
+                ...(eventClassified ? { stage: eventClassified.stage } : {}),
+            },
+            timestamp: time.timestamp,
+            index,
+        });
+    });
+    parsed.sort((left, right) => right.timestamp - left.timestamp || left.index - right.index);
+    const events = parsed.slice(0, MAX_EVENTS_TO_RETURN).map(({ event }) => event);
+    if (!classified) {
+        return {
+            status: 'unknown',
+            last_status_text: clean(payload.statusTitle, 500) || clean(payload.statusDescription, 500) || code || 'Tracking information received',
+            last_update: events[0]?.time ?? null,
+            expected_delivery: null,
+            events,
+        };
+    }
+    return {
+        status: classified.status,
+        current_stage: classified.stage,
+        last_status_text: clean(payload.statusTitle, 500) || clean(payload.statusDescription, 500) || code,
+        last_update: events[0]?.time ?? null,
+        expected_delivery: null,
+        events,
+    };
+}
+export class InpostTracker {
+    timeoutMs;
+    fetcher;
+    constructor(options = {}) {
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetcher = options.fetcher;
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
+            throw new TypeError('InPost timeout must be positive');
+        }
+    }
+    async fetch(rawTrackingNumber) {
+        const trackingNumber = normalizeInpostTrackingNumber(rawTrackingNumber);
+        const url = `${TRACKING_ENDPOINT}/${encodeURIComponent(trackingNumber)}`;
+        const { response, bytes } = await fetchBounded(url, {
+            headers: {
+                Accept: 'application/json, text/plain, */*',
+                'Accept-Language': 'en-US,en;q=0.9',
+                'User-Agent': 'Mozilla/5.0 (compatible; DeliveryTracker/1.0)',
+            },
+        }, {
+            provider: 'InPost tracking',
+            timeoutMs: this.timeoutMs,
+            maxBytes: MAX_RESPONSE_BYTES,
+            retryTransient: true,
+            allowHttpError: true,
+            fetcher: this.fetcher,
+        });
+        if (response.status === 404)
+            throw new NotFoundError('InPost');
+        if (!response.ok)
+            throw new UpstreamHttpError('InPost tracking', response.status);
+        return parseInpostTrackingResponse(parseJsonBytes(bytes, 'InPost tracking'), trackingNumber);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new InpostTracker({ fetcher: environment.fetcher });
+    return {
+        id: 'inpost',
+        steps: ['direct'],
+        track: (input) => tracker.fetch(input.number),
+        recognize: (number) => recognizeFromLookup(() => tracker.fetch(number), () => accepted(() => normalizeInpostTrackingNumber(number))),
+    };
+};

package/dist/carriers/inpost/carrier.json

@@ -0,0 +1,75 @@
+{
+  "id": "inpost",
+  "displayName": "InPost",
+  "aliases": [
+    "InPost Paczkomaty",
+    "Paczkomaty",
+    "InPost Easy"
+  ],
+  "region": {
+    "countries": [
+      "PL",
+      "IT",
+      "PT",
+      "GB"
+    ]
+  },
+  "brand": {
+    "color": "#ffcc05"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "inpost",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 38
+    }
+  },
+  "capabilities": [
+    "history"
+  ],
+  "portal": {
+    "url": "https://inpost.pl/sledzenie-przesylek",
+    "canaryUrl": "https://inposteasy.com/",
+    "shows": [
+      "status",
+      "history"
+    ],
+    "scraped": [
+      "status",
+      "history"
+    ],
+    "discarded": [
+      "origin_country",
+      "destination_country"
+    ],
+    "unavailable": []
+  },
+  "links": [],
+  "detection": [
+    {
+      "id": "inpost-1",
+      "pattern": "^\\d{24}$",
+      "confidence": "low"
+    },
+    {
+      "id": "inpost-2",
+      "pattern": "^JJD\\d{16}$",
+      "confidence": "low"
+    },
+    {
+      "id": "inpost-3",
+      "pattern": "^JD\\d{16}$",
+      "confidence": "low"
+    },
+    {
+      "id": "inpost-4",
+      "pattern": "^8YDR\\d{9}$",
+      "confidence": "high"
+    }
+  ]
+}

package/dist/carriers/inpost/numbers.json

@@ -0,0 +1,130 @@
+{
+  "carrier": "inpost",
+  "records": [
+    {
+      "number": "0980982.1",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/issues/91"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "mondial-relay",
+          "heppner"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to InPost, which no rule claims."
+    },
+    {
+      "number": "620999677033395439338699",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://pl.trustpilot.com/reviews/6a847d65986657d4111d520e"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "ciblex",
+          "inpost",
+          "bpost"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Quoted in a merchant's reply. The source attributes it to InPost, which stays one candidate among several."
+    },
+    {
+      "number": "640000000000000000000001",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "ciblex",
+          "inpost",
+          "bpost"
+        ]
+      },
+      "note": "Invented number following the 24-digit InPost format. Filed under InPost, which stays one candidate among several."
+    },
+    {
+      "number": "642600027844200234823732",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/alufers/inpost-cli"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "ciblex",
+          "inpost",
+          "bpost"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to InPost, which stays one candidate among several."
+    },
+    {
+      "number": "8YDR098765432",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/issues/91"
+      },
+      "expect": {
+        "carrier": "inpost",
+        "confidence": "high"
+      },
+      "note": "Open-source project example, not a real shipment."
+    },
+    {
+      "number": "JD0002123456789012",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/issues/91"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "inpost"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to InPost, which stays one candidate among several."
+    },
+    {
+      "number": "JJD0002123456789012",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/issues/91"
+      },
+      "expect": {
+        "carrier": "dhl",
+        "confidence": "high"
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to InPost; detection selects DHL."
+    },
+    {
+      "number": "JJD0002233564270287",
+      "role": "shipment",
+      "evidence": "merchant_published_example",
+      "source": {
+        "url": "https://wobaaa.com/aliexpress-uk-tracking-numbers/"
+      },
+      "expect": {
+        "carrier": "dhl",
+        "confidence": "high"
+      },
+      "note": "Published integration example, not a real shipment. The source attributes it to InPost; detection selects DHL."
+    }
+  ]
+}

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

@@ -0,0 +1,16 @@
+/**
+ * InPost status vocabulary for the public inposteasy.com hub.
+ *
+ * Codes are `<PHASE>.<NNNN>` strings (CRE creation, FMD first mile, MMD middle
+ * mile, LMD last mile, RTS return to sender, EOL end of life). The
+ * cross-border vocabulary is explicitly still being observed, so an unmapped
+ * code yields no stage at all: the event keeps its raw wording, the result
+ * reports `unknown`, and the sync classifies and records it.
+ *
+ * Provenance: derived from the prior-art client
+ * https://github.com/ha-parcel-integrations/ha-inpost (MIT,
+ * `TRACKING_STATUS_MAP`), live-confirmed on IT/PT/GB consignments 2026-08-31.
+ */
+import type { ClassifiedStatus } from '../../core/status/index.js';
+/** The stage and status for an InPost hub status code, or undefined when unmapped. */
+export declare function classifyInpostStatus(code: string): ClassifiedStatus | undefined;

package/dist/carriers/inpost/status.js

@@ -0,0 +1,31 @@
+const TRACKING_STATUS = {
+    // Creation and handover.
+    'CRE.1001': { status: 'pending', stage: 'registered' },
+    'FMD.1001': { status: 'pending', stage: 'registered' },
+    'FMD.1002': { status: 'in_transit', stage: 'in_transit' },
+    // Logistics-centre movement.
+    'MMD.1001': { status: 'in_transit', stage: 'in_transit' },
+    'MMD.1002': { status: 'in_transit', stage: 'in_transit' },
+    'MMD.1003': { status: 'in_transit', stage: 'in_transit' },
+    'MMD.1004': { status: 'in_transit', stage: 'in_transit' },
+    // Last-mile, redirects and collection.
+    'LMD.1001': { status: 'in_transit', stage: 'in_transit' },
+    'LMD.1002': { status: 'in_transit', stage: 'in_transit' },
+    'LMD.3006': { status: 'in_transit', stage: 'in_transit' },
+    'LMD.3014': { status: 'in_transit', stage: 'in_transit' },
+    'LMD.1004': { status: 'out_for_delivery', stage: 'ready_for_pickup' },
+    'LMD.1005': { status: 'out_for_delivery', stage: 'ready_for_pickup' },
+    'LMD.9001': { status: 'out_for_delivery', stage: 'ready_for_pickup' },
+    'LMD.9002': { status: 'exception', stage: 'failed_attempt' },
+    'LMD.9014': { status: 'exception', stage: 'returned' },
+    // Terminal outcomes.
+    'EOL.1001': { status: 'delivered', stage: 'delivered' },
+    'EOL.1003': { status: 'delivered', stage: 'delivered' },
+    'EOL.9001': { status: 'exception', stage: 'failed_attempt' },
+    'RTS.1001': { status: 'exception', stage: 'returned' },
+    'RTS.1002': { status: 'exception', stage: 'returned' },
+};
+/** The stage and status for an InPost hub status code, or undefined when unmapped. */
+export function classifyInpostStatus(code) {
+    return TRACKING_STATUS[code];
+}

package/dist/carriers/inpost/statuses.json

@@ -0,0 +1,26 @@
+{
+  "carrier": "inpost",
+  "entries": [
+    { "code": "CRE.1001", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Shipment created." },
+    { "code": "FMD.1001", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "First mile: awaiting handover." },
+    { "code": "FMD.1002", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "First mile: collected." },
+    { "code": "MMD.1001", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Middle mile." },
+    { "code": "MMD.1002", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Middle mile." },
+    { "code": "MMD.1003", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Middle mile." },
+    { "code": "MMD.1004", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Middle mile." },
+    { "code": "LMD.1001", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Last mile." },
+    { "code": "LMD.1002", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Last mile." },
+    { "code": "LMD.3006", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Last mile redirect." },
+    { "code": "LMD.3014", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Last mile redirect." },
+    { "code": "LMD.1004", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "In the locker or pickup point." },
+    { "code": "LMD.1005", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "In the locker or pickup point." },
+    { "code": "LMD.9001", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Awaiting collection." },
+    { "code": "LMD.9002", "language": "en", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "" },
+    { "code": "LMD.9014", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "" },
+    { "code": "EOL.1001", "language": "en", "wording": "Delivered", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "" },
+    { "code": "EOL.1003", "language": "en", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "" },
+    { "code": "EOL.9001", "language": "en", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "" },
+    { "code": "RTS.1001", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Return to sender." },
+    { "code": "RTS.1002", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-31", "note": "Return to sender." }
+  ]
+}

package/dist/carriers/intl-post/carrier.json

@@ -0,0 +1,46 @@
+{
+  "id": "intl-post",
+  "displayName": "Unknown postal carrier",
+  "displayNames": {
+    "en": "Unknown postal carrier",
+    "de": "Postanbieter unbekannt",
+    "fr": "Transporteur postal inconnu",
+    "it": "Corriere postale sconosciuto",
+    "es": "Operador postal desconocido",
+    "pt": "Operador postal desconhecido",
+    "pl": "Nieznany operator pocztowy"
+  },
+  "aliases": [],
+  "region": {
+    "countries": []
+  },
+  "brand": {
+    "color": "#2c6fb5"
+  },
+  "selectable": false,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "universal",
+    "steps": []
+  },
+  "capabilities": [],
+  "portal": {
+    "url": "https://t.17track.net/en#nums={trackingNumber}",
+    "siteName": "17TRACK",
+    "canaryUrl": "https://parcelsapp.com/en",
+    "shows": [],
+    "scraped": [],
+    "discarded": [],
+    "unavailable": []
+  },
+  "links": [],
+  "detection": [
+    {
+      "id": "intl-post-1",
+      "pattern": "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}(?!CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|CL$)[A-Z]{2}$",
+      "confidence": "high",
+      "checksum": "s10"
+    }
+  ]
+}

package/dist/carriers/intl-post/numbers.json

@@ -0,0 +1,29 @@
+{
+  "carrier": "intl-post",
+  "records": [
+    {
+      "number": "CN987654326US",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "intl-post",
+        "confidence": "high"
+      },
+      "note": "Made-up number that follows the published format."
+    },
+    {
+      "number": "RA123456785DE",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "intl-post",
+        "confidence": "high"
+      },
+      "note": "Made-up number that follows the published format."
+    }
+  ]
+}

package/dist/carriers/j-and-t/carrier.json

@@ -0,0 +1,66 @@
+{
+  "id": "j-and-t",
+  "displayName": "J&T Express",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "PH",
+      "ID",
+      "MY",
+      "TH",
+      "VN",
+      "SG"
+    ]
+  },
+  "brand": {
+    "color": "#ff0000"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "universal",
+    "steps": []
+  },
+  "capabilities": [],
+  "portal": {
+    "url": "https://www.jtexpress.ph/track-and-trace?flag=1&waybillNo={trackingNumber}",
+    "canaryUrl": "https://t.17track.net/",
+    "shows": [],
+    "scraped": [],
+    "discarded": [],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "jtexpress.ph"
+      ],
+      "params": [
+        "waybillNo"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "j-and-t-1",
+      "pattern": "^\\d{12}$",
+      "confidence": "low"
+    },
+    {
+      "id": "j-and-t-2",
+      "pattern": "^JT\\d{13}$",
+      "confidence": "high"
+    },
+    {
+      "id": "j-and-t-3",
+      "pattern": "^JY\\d{10}$",
+      "confidence": "high"
+    },
+    {
+      "id": "j-and-t-4",
+      "pattern": "^JD\\d{10}$",
+      "confidence": "low"
+    }
+  ]
+}