universal-parcel-scraper 0.368.0-main.2003 → 0.372.0-main.2012

package/README.md

@@ -13,7 +13,7 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
 [![License: Apache-2.0](https://img.shields.io/badge/core-Apache--2.0-blue.svg)](LICENSE)
 
 <!-- GENERATED:summary -->
-**3,500+ carriers** through **398 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **402 dedicated adapters** and **5 universal fallbacks**
 
 <sub>727 catalog entries · 133 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 13,540 such statuses, each filed under one stage.
+The carrier folders record 13,584 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/data/catalog.json

@@ -6581,7 +6581,7 @@
   },
   "atlantic-courier": {
     "displayName": "Atlantic International Express",
-    "color": "#0066b3",
+    "color": "#e31e24",
     "aliases": [
       "Atlantic International Express Courier"
     ],
@@ -8881,7 +8881,9 @@
     "timezone": "Europe/Malta",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "connect-couriers",
+      "recognitionRank": 831,
+      "localClocks": true
     },
     "canaryUrl": "https://www.connectcouriers.eu/tracking/",
     "trackingUrlTemplate": "https://www.connectcouriers.eu/tracking/?tracking_number={trackingNumber}",
@@ -16391,7 +16393,9 @@
     "timezone": "Europe/Jersey",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "jersey-post",
+      "recognitionRank": 832,
+      "localClocks": true
     },
     "canaryUrl": "https://www.jerseypost.com/tools/track-trace/",
     "trackingUrlTemplate": "https://www.jerseypost.com/tools/track-trace/?tq={trackingNumber}",
@@ -16407,7 +16411,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}JE$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "jet-logistic": {
     "displayName": "Jet Logistic",
@@ -19892,7 +19903,7 @@
   },
   "ocs-ana": {
     "displayName": "OCS ANA Group",
-    "color": "#004c9a",
+    "color": "#0a3382",
     "aliases": [
       "OCS",
       "Overseas Courier Service",
@@ -24198,7 +24209,9 @@
     "timezone": "Europe/Istanbul",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "shipentegra",
+      "recognitionRank": 833,
+      "localClocks": true
     },
     "canaryUrl": "https://track.shipentegra.com/",
     "trackingUrlTemplate": "https://track.shipentegra.com/?trackno={trackingNumber}",
@@ -27747,7 +27760,7 @@
     "timezone": "America/Bogota",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "veloces"
     },
     "canaryUrl": "https://tracking.veloces.app/",
     "trackingUrlTemplate": "https://tracking.veloces.app/tracking-client/{trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 727,
-  "activeAdapters": 398,
+  "activeAdapters": 402,
   "countries": 133,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -74750,6 +74750,7 @@
       "intl-post"
     ],
     "asked": [
+      "jersey-post",
       "chronopost"
     ]
   },
@@ -74788,6 +74789,7 @@
       "intl-post"
     ],
     "asked": [
+      "jersey-post",
       "chronopost"
     ]
   },
@@ -84900,6 +84902,7 @@
       "intl-post"
     ],
     "asked": [
+      "jersey-post",
       "chronopost"
     ]
   },

package/dist/browser/scraper.js

@@ -5376,7 +5376,7 @@ var Pe = {
 	},
 	"atlantic-courier": {
 		displayName: "Atlantic International Express",
-		color: "#0066b3",
+		color: "#e31e24",
 		aliases: ["Atlantic International Express Courier"],
 		countries: ["IN"],
 		selectable: !0,
@@ -7015,7 +7015,9 @@ var Pe = {
 		timezone: "Europe/Malta",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "connect-couriers",
+			recognitionRank: 831,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.connectcouriers.eu/tracking/",
 		trackingUrlTemplate: "https://www.connectcouriers.eu/tracking/?tracking_number={trackingNumber}",
@@ -12556,7 +12558,9 @@ var Pe = {
 		timezone: "Europe/Jersey",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "jersey-post",
+			recognitionRank: 832,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.jerseypost.com/tools/track-trace/",
 		trackingUrlTemplate: "https://www.jerseypost.com/tools/track-trace/?tq={trackingNumber}",
@@ -12566,7 +12570,12 @@ var Pe = {
 			pathPattern: "^/tools/track-trace/?$",
 			params: ["tq"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}JE$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	"jet-logistic": {
 		displayName: "Jet Logistic",
@@ -15162,7 +15171,7 @@ var Pe = {
 	},
 	"ocs-ana": {
 		displayName: "OCS ANA Group",
-		color: "#004c9a",
+		color: "#0a3382",
 		aliases: [
 			"OCS",
 			"Overseas Courier Service",
@@ -18319,7 +18328,9 @@ var Pe = {
 		timezone: "Europe/Istanbul",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "shipentegra",
+			recognitionRank: 833,
+			localClocks: !0
 		},
 		canaryUrl: "https://track.shipentegra.com/",
 		trackingUrlTemplate: "https://track.shipentegra.com/?trackno={trackingNumber}",
@@ -20875,7 +20886,7 @@ var Pe = {
 		timezone: "America/Bogota",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "veloces"
 		},
 		canaryUrl: "https://tracking.veloces.app/",
 		trackingUrlTemplate: "https://tracking.veloces.app/tracking-client/{trackingNumber}",
@@ -22467,7 +22478,7 @@ var Pe = {
 	"jamaica-post": [],
 	janio: ["janio-1"],
 	jeebly: ["jeebly-1"],
-	"jersey-post": [],
+	"jersey-post": ["jersey-post-s10"],
 	"jet-logistic": [],
 	"jetline-couriers": [],
 	jhgj: ["jhgj-1"],
@@ -27989,6 +28000,7 @@ var pl = {
 	"cj-packet": 956,
 	"closer-logistics": 849,
 	"colis-prive": 740,
+	"connect-couriers": 831,
 	coordinadora: 973,
 	"correo-argentino": 978,
 	"correos-de-mexico": 30,
@@ -28086,6 +28098,7 @@ var pl = {
 	"israel-post": 81,
 	"j-and-t": 530,
 	"j-and-t-cargo": 910,
+	"jersey-post": 832,
 	jhgj: 907,
 	jitsu: 85,
 	"jordan-post": 881,
@@ -28174,6 +28187,7 @@ var pl = {
 	seur: 870,
 	sfc: 955,
 	shadowfax: 595,
+	shipentegra: 833,
 	"skroutz-last-mile": 913,
 	"slovak-parcel-service": 180,
 	"slovenska-posta": 170,

package/dist/carriers/atlantic-courier/carrier.json

@@ -10,7 +10,7 @@
     ]
   },
   "brand": {
-    "color": "#0066b3"
+    "color": "#e31e24"
   },
   "selectable": true,
   "timezone": "Asia/Kolkata",

package/dist/carriers/connect-couriers/adapter.d.ts

@@ -0,0 +1,17 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+/** The WordPress endpoint the tracking page on connectcouriers.eu posts the number to. */
+export declare const CONNECT_COURIERS_API = "https://www.connectcouriers.eu/wp-admin/admin-ajax.php";
+/** The tracking plugin's action. */
+export declare const CONNECT_COURIERS_ACTION = "public_connect_tracking_tracking_action";
+export declare class ConnectCouriersTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/connect-couriers/adapter.js

@@ -0,0 +1,63 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, SchemaError, TransportError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { CONNECT_COURIERS_MAX_BYTES, normalizeConnectCouriersNumber, parseConnectCouriers, PROVIDER } from './parser.js';
+/** The WordPress endpoint the tracking page on connectcouriers.eu posts the number to. */
+export const CONNECT_COURIERS_API = 'https://www.connectcouriers.eu/wp-admin/admin-ajax.php';
+/** The tracking plugin's action. */
+export const CONNECT_COURIERS_ACTION = 'public_connect_tracking_tracking_action';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// Bot checks Cloudflare, in front of the site, could put in place of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|challenge-platform|<title>\s*Just a moment|<title>\s*Attention Required/i;
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Connect Couriers answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned a reply that is not JSON', { cause });
+    }
+}
+export class ConnectCouriersTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeConnectCouriersNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(CONNECT_COURIERS_API, { method: 'POST', signal, headers: {
+                    Accept: 'application/json', 'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8', 'User-Agent': userAgentOf(this.options.userAgent),
+                }, body: new URLSearchParams({ action: CONNECT_COURIERS_ACTION, tracking_number: number }).toString() }, { provider: PROVIDER,
+                timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: CONNECT_COURIERS_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher,
+                allowHttpStatuses: [...REDIRECTS, 400, 404, 410] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Connect Couriers redirected its tracking lookup');
+            // The tracker answers every number with HTTP 200. WordPress answers an
+            // action no plugin registers with HTTP 400 and `0`; a 404 is a moved route.
+            if (response.status === 400 || response.status === 404 || response.status === 410) {
+                throw new TransportError(PROVIDER, 'Connect Couriers tracking lookup is unavailable');
+            }
+            return parseConnectCouriers(json(decodeText(bytes)), number);
+        };
+        // A request that fails to reach the site, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'connect-couriers', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => read(signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => read(signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new ConnectCouriersTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'connect-couriers', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeConnectCouriersNumber(number))),
+    };
+};

package/dist/carriers/connect-couriers/carrier.json

@@ -18,18 +18,63 @@
   "timezone": "Europe/Malta",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "connect-couriers",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 831
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "destination_country"
+  ],
   "portal": {
     "url": "https://www.connectcouriers.eu/tracking/?tracking_number={trackingNumber}",
     "searchUrl": "https://www.connectcouriers.eu/tracking/",
     "canaryUrl": "https://www.connectcouriers.eu/tracking/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "progress_rail",
+      "origin",
+      "destination",
+      "destination_country",
+      "parcel_count",
+      "departure_date",
+      "weight",
+      "dimensions"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "destination_country"
+    ],
+    "discarded": [
+      "progress_rail",
+      "origin",
+      "destination",
+      "parcel_count",
+      "departure_date",
+      "weight",
+      "dimensions"
+    ],
+    "unavailable": [
+      "location",
+      "provider_code",
+      "eta",
+      "delivered_at",
+      "offset_timestamps",
+      "service_name",
+      "pickup_point",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

package/dist/carriers/connect-couriers/numbers.json

@@ -12,7 +12,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -28,7 +28,7 @@
           "ppl"
         ]
       },
-      "note": "An archived lookup on Connect Couriers' own tracker; the capture was opened but shows only the page shell, so the history is not visible."
+      "note": "An archived lookup on Connect Couriers' own tracker address; the capture shows only the page shell, and Connect Couriers' tracker returns a delivered history for it."
     }
   ]
 }

package/dist/carriers/connect-couriers/parser.d.ts

@@ -0,0 +1,15 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Connect Couriers";
+export declare const CONNECT_COURIERS_MAX_BYTES: number;
+/** A number for Connect Couriers' tracker, digits only; anything else is not one it issues. */
+export declare function normalizeConnectCouriersNumber(raw: string): string;
+/** A scan's wording without a signatory or phone numbers. */
+export declare function connectCouriersWording(raw: string): string;
+/**
+ * The reply of the tracking page's WordPress action for one number. It
+ * answers HTTP 200 with `{"success":false}` for a number it does not know,
+ * which the page reports as an invalid tracking number. A found reply has
+ * the consignment's pieces, a progress rail and the scans grouped by day;
+ * the reply and the piece must both name the number asked.
+ */
+export declare function parseConnectCouriers(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/connect-couriers/parser.js

@@ -0,0 +1,188 @@
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { countryCode } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { connectCouriersStage } from './status.js';
+export const PROVIDER = 'Connect Couriers';
+// A long history is a few kilobytes.
+export const CONNECT_COURIERS_MAX_BYTES = 256 * 1024;
+// Digits only: the tracking page's field takes nothing else.
+const NUMBER = /^\d{8,20}$/;
+// The scan's wall clock, to the second; a fraction of a second is dropped.
+const WALL_CLOCK = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})(?:\.\d{1,7})?$/;
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+/** A number for Connect Couriers' tracker, digits only; anything else is not one it issues. */
+export function normalizeConnectCouriersNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Connect Couriers numbers are eight to twenty digits');
+    return number;
+}
+/** A required text field; anything but a string is a changed reply. */
+function text(row, key, maxLength = 300) {
+    const value = row[key];
+    if (typeof value !== 'string')
+        throw new SchemaError(PROVIDER, `Connect Couriers returned an invalid ${key}`);
+    return clean(value, maxLength);
+}
+/** Whether a tracking number in the reply is the number asked. */
+function sameNumber(value, number) {
+    return typeof value === 'string' && value.length <= 64 && normalizeTrackingNumber(value) === number;
+}
+// A run of nine or more digits, with spaces, brackets, dots or hyphens
+// between them, as phone numbers are written.
+const PHONE = /(?<![A-Z\d])\+?\d(?:[\s().-]{0,2}\d){8,}(?![A-Z\d])/gi;
+// Who signed for the parcel, after a delivery's wording.
+const SIGNATORY = /\s*[,;:.\-–(]?\s*\bsigned\s+(?:for\s+)?by\b[\s\S]*$/i;
+/** A scan's wording without a signatory or phone numbers. */
+export function connectCouriersWording(raw) {
+    return clean(raw.replace(SIGNATORY, '').replace(PHONE, '')).replace(/^[\s,;:.\-–/]+|[\s,;:\-–/]+$/g, '');
+}
+/**
+ * A scan's clock. `stageDateTime` is a wall clock with no zone, which the
+ * page shows as it is, so it stays local.
+ */
+function scanClock(row) {
+    const match = WALL_CLOCK.exec(text(row, 'stageDateTime', 40));
+    const local = match?.[1] ?? '';
+    // Parsing in UTC checks the calendar digits only; the wall clock keeps no offset.
+    const parsed = DateTime.fromISO(local, { zone: 'UTC' });
+    // Luxon rolls 24:00:00 over to the next day; only a clock that reads back unchanged is kept.
+    if (!match || !parsed.isValid || parsed.year < 2000 || parsed.toFormat("yyyy-MM-dd'T'HH:mm:ss") !== local) {
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid scan time');
+    }
+    return local;
+}
+/**
+ * Whether a scan concerns the parcel asked. A scan lists the pieces of the
+ * consignment it was made for; one that lists none concerns them all.
+ */
+function concerns(row, number) {
+    const pieces = row.packages ?? [];
+    if (!Array.isArray(pieces) || pieces.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned a scan with invalid pieces');
+    if (!pieces.length)
+        return true;
+    return pieces.some((piece) => {
+        if (!isRecord(piece) || typeof piece.trackingNumber !== 'string')
+            throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid piece');
+        return sameNumber(piece.trackingNumber, number);
+    });
+}
+function projectRow(row) {
+    const description = connectCouriersWording(text(row, 'stageStatus'));
+    if (!description)
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned a scan without wording');
+    const local = scanClock(row);
+    const staged = connectCouriersStage(description);
+    const event = {
+        local_time: local,
+        description,
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+    return { key: JSON.stringify([local, description]), event };
+}
+/** The scans of the parcel asked, from the history's date groups. */
+function scans(data, number) {
+    const groups = data.trackingHistory ?? [];
+    if (!Array.isArray(groups) || groups.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid history');
+    const seen = new Set();
+    const events = [];
+    for (const group of groups) {
+        if (!isRecord(group))
+            throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid history group');
+        // The page skips a group without items.
+        const rows = group.items ?? [];
+        if (!Array.isArray(rows) || rows.length > MAX_ROWS)
+            throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid history group');
+        for (const row of rows) {
+            if (!isRecord(row))
+                throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid scan');
+            if (!concerns(row, number))
+                continue;
+            const scan = projectRow(row);
+            if (seen.has(scan.key))
+                continue;
+            seen.add(scan.key);
+            events.push(scan.event);
+            if (events.length > MAX_ROWS)
+                throw new SchemaError(PROVIDER, 'Connect Couriers returned an oversized history');
+        }
+    }
+    // Newest first; the groups are by day, and the scans within one are in no order.
+    return events
+        .map((event, index) => ({ event, index }))
+        .sort((a, b) => b.event.local_time.localeCompare(a.event.local_time) || a.index - b.index)
+        .map(({ event }) => event);
+}
+/** The piece of the consignment that is the parcel asked. */
+function piece(data, number) {
+    const pieces = data.packageData;
+    if (!Array.isArray(pieces) || pieces.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned a shipment without its pieces');
+    const found = pieces.find((entry) => isRecord(entry) && sameNumber(entry.trackingNumber, number));
+    if (!isRecord(found))
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned a shipment without the parcel asked');
+    return found;
+}
+/** The headline status's word for a parcel whose journey ended or stopped. */
+function headlineStage(found) {
+    if (typeof found.stageStatus !== 'string')
+        return undefined;
+    const stage = connectCouriersStage(connectCouriersWording(found.stageStatus))?.stage;
+    return stage === 'delivered' || stage === 'returned' || stage === 'exception' ? stage : undefined;
+}
+/** The destination country the page flags, from the recipient's country code. */
+function destination(found) {
+    if (!isRecord(found.recipient))
+        return null;
+    return countryCode(clean(found.recipient.countryCode, 8)) ?? countryCode(clean(found.recipient.country, 60));
+}
+/**
+ * The reply of the tracking page's WordPress action for one number. It
+ * answers HTTP 200 with `{"success":false}` for a number it does not know,
+ * which the page reports as an invalid tracking number. A found reply has
+ * the consignment's pieces, a progress rail and the scans grouped by day;
+ * the reply and the piece must both name the number asked.
+ */
+export function parseConnectCouriers(payload, raw) {
+    const number = normalizeConnectCouriersNumber(raw);
+    if (!isRecord(payload) || typeof payload.success !== 'boolean')
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned an invalid envelope');
+    if (!payload.success) {
+        // WordPress's error reply carries its reason in `data`; the tracker sends none for an unknown number.
+        if (payload.data !== undefined && payload.data !== null)
+            throw new IndeterminateError(PROVIDER, 'Connect Couriers did not complete the lookup');
+        throw new NotFoundError(PROVIDER);
+    }
+    const data = payload.data;
+    if (!isRecord(data) || typeof data.trackingNumber !== 'string')
+        throw new SchemaError(PROVIDER, 'Connect Couriers returned a shipment without its number');
+    if (!sameNumber(data.trackingNumber, number))
+        throw new IndeterminateError(PROVIDER, 'Connect Couriers answered for another shipment');
+    const found = piece(data, number);
+    const events = scans(data, number);
+    if (!events.length)
+        throw new NoHistoryError(PROVIDER);
+    const newest = events[0];
+    const scanned = events.find((event) => event.stage);
+    const headline = headlineStage(found);
+    const stage = (headline ?? scanned?.stage);
+    const source = headline && headline !== scanned?.stage ? 'carrier_map' : scanned?.stage_source;
+    const country = destination(found);
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: source ?? 'carrier_map' } : {}),
+        last_status_text: newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        ...(country ? { destination_country: country } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/connect-couriers/status.d.ts

@@ -0,0 +1,8 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage Connect Couriers' map gives a scan's wording in `normalizeStatusWording` form. */
+export declare function connectCouriersMappedStage(wording: string): Stage | undefined;
+/** A scan's stage: the map, else the shared wording rules, else nothing. */
+export declare function connectCouriersStage(wording: string): ClassifiedWording | null;
+/** Every wording seen is mapped. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/connect-couriers/status.js

@@ -0,0 +1,33 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The wordings Connect Couriers' tracker gives its scans, which carry no
+ * code. Only wordings seen in replies are mapped; another falls to the
+ * shared wording rules.
+ */
+const WORDINGS = new Map([
+    ['shipment data received', 'registered'], // The sender's data came before the parcel.
+    ['arrived at operations facility - malta', 'in_transit'],
+    ['out for delivery', 'out_for_delivery'],
+    ['attempted delivery / client not home', 'failed_attempt'],
+    // Kept at the depot for the recipient to collect, at their request.
+    ['awaiting collection by recipient as requested', 'ready_for_pickup'],
+    ['delivered', 'delivered'],
+]);
+/** The stage Connect Couriers' map gives a scan's wording in `normalizeStatusWording` form. */
+export function connectCouriersMappedStage(wording) {
+    return WORDINGS.get(wording);
+}
+/** A scan's stage: the map, else the shared wording rules, else nothing. */
+export function connectCouriersStage(wording) {
+    const mapped = connectCouriersMappedStage(normalizeStatusWording(wording));
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** Every wording seen is mapped. */
+export const statusMap = {
+    stage: (_code, wording) => connectCouriersMappedStage(wording),
+    gaps: [],
+};