universal-parcel-scraper 0.861.0-main.4621 → 0.862.0-main.4623

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 **658 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **661 dedicated adapters** and **5 universal fallbacks**
 
 <sub>1045 catalog entries · 145 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -163,7 +163,7 @@ the command line's `track --source ParcelsApp` does the same.
 <!-- 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 17,879 such statuses, each filed under one stage.
+The carrier folders record 17,895 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

@@ -11611,7 +11611,9 @@
     "timezone": "Asia/Manila",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "consegnia",
+      "recognitionRank": 57,
+      "localClocks": true
     },
     "canaryUrl": "https://clc-express.com/",
     "trackingUrlTemplate": "https://clc-express.com/track-delivery?awb={trackingNumber}",
@@ -18128,7 +18130,9 @@
     "timezone": "Asia/Kuala_Lumpur",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "fmx",
+      "recognitionRank": 147,
+      "localClocks": true
     },
     "canaryUrl": "https://www.fmx.asia/",
     "trackingUrlTemplate": "https://www.fmx.asia/result_detail.php?p=1&conno={trackingNumber}",
@@ -20577,7 +20581,9 @@
     "timezone": "Asia/Manila",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "hitch",
+      "recognitionRank": 117,
+      "localClocks": true
     },
     "canaryUrl": "https://hitch.com.ph/",
     "trackingUrlTemplate": "https://hitch.com.ph/tracking?no={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 1045,
-  "activeAdapters": 658,
+  "activeAdapters": 661,
   "countries": 145,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -87063,6 +87063,9 @@
     "confidence": "low",
     "candidates": [
       "fmx"
+    ],
+    "asked": [
+      "fmx"
     ]
   },
   {
@@ -87071,6 +87074,9 @@
     "confidence": "low",
     "candidates": [
       "fmx"
+    ],
+    "asked": [
+      "fmx"
     ]
   },
   {
@@ -87079,6 +87085,9 @@
     "confidence": "low",
     "candidates": [
       "fmx"
+    ],
+    "asked": [
+      "fmx"
     ]
   },
   {
@@ -100584,6 +100593,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100592,6 +100604,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100600,6 +100615,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100608,6 +100626,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100616,6 +100637,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100624,6 +100648,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100632,6 +100659,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100640,6 +100670,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {
@@ -100648,6 +100681,9 @@
     "confidence": "low",
     "candidates": [
       "hitch"
+    ],
+    "asked": [
+      "hitch"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -9243,7 +9243,9 @@ var tt = {
 		timezone: "Asia/Manila",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "consegnia",
+			recognitionRank: 57,
+			localClocks: !0
 		},
 		canaryUrl: "https://clc-express.com/",
 		trackingUrlTemplate: "https://clc-express.com/track-delivery?awb={trackingNumber}",
@@ -14105,7 +14107,9 @@ var tt = {
 		timezone: "Asia/Kuala_Lumpur",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "fmx",
+			recognitionRank: 147,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.fmx.asia/",
 		trackingUrlTemplate: "https://www.fmx.asia/result_detail.php?p=1&conno={trackingNumber}",
@@ -15930,7 +15934,9 @@ var tt = {
 		timezone: "Asia/Manila",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "hitch",
+			recognitionRank: 117,
+			localClocks: !0
 		},
 		canaryUrl: "https://hitch.com.ph/",
 		trackingUrlTemplate: "https://hitch.com.ph/tracking?no={trackingNumber}",
@@ -39169,6 +39175,7 @@ var ed = {
 	"closer-logistics": 849,
 	"colis-prive": 740,
 	"connect-couriers": 831,
+	consegnia: 57,
 	coordinadora: 973,
 	"copa-courier": 773,
 	corre: 587,
@@ -39259,6 +39266,7 @@ var ed = {
 	fleetex: 571,
 	fleetoptics: 763,
 	flippost: 568,
+	fmx: 147,
 	"forward-air": 755,
 	"forza-delivery": 633,
 	"four-px": 570,
@@ -39301,6 +39309,7 @@ var ed = {
 	hermes: 602,
 	"hermes-at": 876,
 	"hermes-de": 840,
+	hitch: 117,
 	"houng-ah-loun": 637,
 	hovership: 687,
 	"hr-parcel": 887,

package/dist/carriers/consegnia/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 tracking page, which opens the session its lookup needs and carries the session's token. */
+export declare const CONSEGNIA_PAGE = "https://clc-express.com/track-delivery";
+/** The lookup the tracking page's script posts the number to. */
+export declare const CONSEGNIA_LOOKUP = "https://clc-express.com/track-delivery-result";
+export declare class ConsegniaTracker {
+    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/consegnia/adapter.js

@@ -0,0 +1,107 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, NotFoundError, 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 { CARRIER, CONSEGNIA_MAX_BYTES, consegniaJson, consegniaToken, isBlockPage, isUnknownShipment, normalizeConsegniaNumber, parseConsegnia, PROVIDER, } from './parser.js';
+const ORIGIN = 'https://clc-express.com';
+/** The tracking page, which opens the session its lookup needs and carries the session's token. */
+export const CONSEGNIA_PAGE = `${ORIGIN}/track-delivery`;
+/** The lookup the tracking page's script posts the number to. */
+export const CONSEGNIA_LOOKUP = `${ORIGIN}/track-delivery-result`;
+const REDIRECTS = [301, 302, 303, 307, 308];
+// The lookup answers an unknown number with its own HTTP 404; any other is a missing route.
+const GONE = [404, 410];
+// Laravel's refusal of a token or session it did not issue, or one that expired.
+const REFUSED_SESSION = 419;
+const COOKIE_NAME = /^[A-Za-z0-9!#$%&'*+.^_`|~-]{1,128}$/;
+const COOKIE_VALUE = /^[^\s;,]{1,4096}$/;
+const MAX_COOKIES = 8;
+const DEFAULT_BUDGET_MS = 15_000;
+/**
+ * The cookies the tracking page sets, as the lookup sends them back: Laravel's
+ * session, its token cookie and the site's own. Null without the session.
+ */
+function sessionCookies(response) {
+    const pairs = [];
+    for (const header of response.headers.getSetCookie()) {
+        const pair = header.split(';', 1)[0].trim();
+        const separator = pair.indexOf('=');
+        const name = pair.slice(0, separator);
+        if (separator > 0 && COOKIE_NAME.test(name) && COOKIE_VALUE.test(pair.slice(separator + 1)) && pairs.length < MAX_COOKIES)
+            pairs.push(pair);
+    }
+    return pairs.some((pair) => /^[^=]+_session=/.test(pair)) ? pairs.join('; ') : null;
+}
+export class ConsegniaTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeConsegniaNumber(raw);
+        const userAgent = userAgentOf(this.options.userAgent);
+        // One attempt opens a session on the tracking page and posts the number with its token, as the page's script does.
+        const attempt = async (signal, timeoutMs) => {
+            const deadline = performance.now() + timeoutMs;
+            // A request left without time fails as a timeout, which the retry can recover.
+            const left = () => Math.max(1, Math.floor(deadline - performance.now()));
+            const page = await fetchBounded(CONSEGNIA_PAGE, { method: 'GET', signal, headers: {
+                    Accept: 'text/html,application/xhtml+xml', 'User-Agent': userAgent,
+                } }, { provider: PROVIDER, timeoutMs: left(), maxBytes: CONSEGNIA_MAX_BYTES, redirect: 'manual',
+                allowHttpStatuses: [...REDIRECTS, ...GONE, 403], fetcher: this.options.fetcher });
+            if (page.response.status === 403)
+                throw new ChallengeError(PROVIDER, 'Consegnia refused its tracking page', { status: 403 });
+            if (page.response.status !== 200) {
+                throw new TransportError(PROVIDER, 'Consegnia tracking page is unavailable', { status: page.response.status });
+            }
+            const html = decodeText(page.bytes);
+            const token = consegniaToken(html);
+            if (!token) {
+                if (isBlockPage(html))
+                    throw new ChallengeError(PROVIDER, 'Consegnia answered the tracking page with a browser check');
+                throw new SchemaError(PROVIDER, 'Consegnia tracking page carries no lookup token');
+            }
+            const cookie = sessionCookies(page.response);
+            if (!cookie)
+                throw new SchemaError(PROVIDER, 'Consegnia tracking page opened no session');
+            const lookup = await fetchBounded(CONSEGNIA_LOOKUP, { method: 'POST', signal, headers: {
+                    Accept: 'application/json, text/javascript, */*; q=0.01', 'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
+                    'User-Agent': userAgent, Cookie: cookie, 'X-Requested-With': 'XMLHttpRequest', Origin: ORIGIN, Referer: CONSEGNIA_PAGE,
+                }, body: new URLSearchParams({ _token: token, awb_number: number }).toString() }, { provider: PROVIDER, timeoutMs: left(),
+                maxBytes: CONSEGNIA_MAX_BYTES, redirect: 'manual', allowHttpStatuses: [...REDIRECTS, ...GONE, 403, REFUSED_SESSION],
+                fetcher: this.options.fetcher });
+            const { status } = lookup.response;
+            const body = decodeText(lookup.bytes).replace(/^\uFEFF/, '').trim();
+            if (REDIRECTS.includes(status) || status === 410)
+                throw new TransportError(PROVIDER, 'Consegnia tracking lookup is unavailable', { status });
+            if (status === 403)
+                throw new ChallengeError(PROVIDER, 'Consegnia refused the lookup', { status });
+            // The session the page just opened was refused: it says nothing about the shipment.
+            if (status === REFUSED_SESSION)
+                throw new IndeterminateError(PROVIDER, 'Consegnia refused the tracking page’s session', { status });
+            if (status === 404) {
+                if (isUnknownShipment(body))
+                    throw new NotFoundError(PROVIDER);
+                throw new TransportError(PROVIDER, 'Consegnia tracking lookup is unavailable', { status });
+            }
+            return parseConsegnia(consegniaJson(body), number);
+        };
+        // An attempt that fails to reach Consegnia, or hangs, gets one more in a new
+        // session: the first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: CARRIER, budgetMs: context.budgetMs ?? DEFAULT_BUDGET_MS, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => attempt(signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => attempt(signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new ConsegniaTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: CARRIER, recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeConsegniaNumber(number))),
+    };
+};

package/dist/carriers/consegnia/carrier.json

@@ -18,18 +18,49 @@
   "timezone": "Asia/Manila",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "consegnia",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 57
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history"
+  ],
   "portal": {
     "url": "https://clc-express.com/track-delivery?awb={trackingNumber}",
     "searchUrl": "https://clc-express.com/track-delivery",
     "canaryUrl": "https://clc-express.com/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "failed_delivery_reason",
+      "awb_date",
+      "delivered_at"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "failed_delivery_reason"
+    ],
+    "discarded": [
+      "awb_date",
+      "delivered_at"
+    ],
+    "unavailable": [
+      "location",
+      "eta",
+      "offset_timestamps",
+      "provider_code",
+      "weight",
+      "sender_name",
+      "recipient_name",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

package/dist/carriers/consegnia/parser.d.ts

@@ -0,0 +1,29 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Consegnia Logistics";
+export declare const CARRIER = "consegnia";
+export declare const CONSEGNIA_MAX_BYTES: number;
+/** A number for Consegnia's tracker: CLC and nine digits. */
+export declare function normalizeConsegniaNumber(raw: string): string;
+/** A firewall or bot-check page in place of the tracking page or the lookup's JSON. */
+export declare function isBlockPage(body: string): boolean;
+/** The token the tracking page's form sends with a number, or null when the page has none. */
+export declare function consegniaToken(html: string): string | null;
+/**
+ * The lookup's reply for one number, `{ success, data: { html } }`: a fragment
+ * its server renders with the number, the current status, the last update, the
+ * booking day, the delivery clock once delivered, and the history, newest
+ * first, each row a status, the reason for a failed delivery and a wall clock
+ * to the minute with no zone. It names no person, place or phone number.
+ *
+ * The fragment must carry the whole number asked. The delivery clock is not
+ * read: a delivered parcel's newest row gives it, and it has no zone either.
+ */
+export declare function parseConsegnia(payload: unknown, raw: string): CarrierResult;
+/**
+ * The lookup's answer to a number it does not hold: HTTP 404 with `success`
+ * false and its message. The message does not quote the number. Any other 404
+ * is a missing route.
+ */
+export declare function isUnknownShipment(body: string): boolean;
+/** The lookup's reply as JSON, or the reason it is not one. */
+export declare function consegniaJson(body: string): unknown;

package/dist/carriers/consegnia/parser.js

@@ -0,0 +1,169 @@
+import { load } from 'cheerio';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, NoHistoryError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { consegniaStage } from './status.js';
+export const PROVIDER = 'Consegnia Logistics';
+export const CARRIER = 'consegnia';
+// The tracking page is about 20 kB and a reply with its history a few.
+export const CONSEGNIA_MAX_BYTES = 256 * 1024;
+// CLC and nine digits, as its tracker prints them.
+const NUMBER = /^CLC\d{9}$/;
+const MONTHS = new Map(['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'].map((month, index) => [month, index + 1]));
+// "Nov 18, 2025" and "06:05 PM": a wall clock with no zone.
+const DAY = /^([A-Z][a-z]{2}) (\d{1,2}), (\d{4})$/;
+const TIME = /^(\d{1,2}):(\d{2}) ([AP]M)$/;
+const DAY_AND_TIME = /^(.+, \d{4}) (\d{1,2}:\d{2} [AP]M)$/;
+// The token Laravel puts in the page's form for its session.
+const TOKEN = /^[A-Za-z0-9]{20,128}$/;
+// Firewall and bot-check pages that could stand in for the page or the lookup's JSON. Cloudflare's
+// script for its challenge platform also runs on the ordinary page, so this is read only where the
+// page's form or the lookup's JSON is missing.
+const BLOCK = /<title>\s*(?:Just a moment|Attention Required|Access Denied)|_cf_chl_opt|cf-turnstile|challenge-platform|captcha/i;
+// The lookup's answer to a number it does not hold.
+const NOT_FOUND = /^No information about your package\b/;
+const MAX_EVENTS = 200;
+/** A number for Consegnia's tracker: CLC and nine digits. */
+export function normalizeConsegniaNumber(raw) {
+    const number = typeof raw === 'string' && raw.length <= 64 ? normalizeTrackingNumber(raw).toUpperCase() : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Consegnia tracking numbers are CLC and nine digits');
+    return number;
+}
+/** A firewall or bot-check page in place of the tracking page or the lookup's JSON. */
+export function isBlockPage(body) {
+    return BLOCK.test(body.slice(0, 64_000));
+}
+/** The token the tracking page's form sends with a number, or null when the page has none. */
+export function consegniaToken(html) {
+    const $ = load(html);
+    const token = clean($('form#track-form input[name="_token"]').attr('value'), 200) || clean($('meta[name="csrf-token"]').attr('content'), 200);
+    return TOKEN.test(token) ? token : null;
+}
+/** A day the tracker prints, "Nov 18, 2025", as `YYYY-MM-DD`. */
+function dayOf(text) {
+    const match = DAY.exec(text);
+    const month = match ? MONTHS.get(match[1]) : undefined;
+    const date = match && month && Number(match[3]) >= 2000 ? calendarDay(Number(match[3]), month, Number(match[2])) : null;
+    if (!date)
+        throw new SchemaError(PROVIDER, 'Consegnia returned an invalid scan time');
+    return date;
+}
+/** A day and a time of day on twelve hours, "06:05 PM", as one wall time. The tracker names no zone. */
+function wallClock(day, time) {
+    const date = dayOf(day);
+    const match = TIME.exec(time);
+    const hour = match ? Number(match[1]) : 0;
+    if (!match || hour < 1 || hour > 12 || Number(match[2]) > 59)
+        throw new SchemaError(PROVIDER, 'Consegnia returned an invalid scan time');
+    const hours = (hour % 12) + (match[3] === 'PM' ? 12 : 0);
+    return `${date}T${String(hours).padStart(2, '0')}:${match[2]}:00`;
+}
+/** The summary's fields by their label, lower case. */
+function summaryFields($) {
+    const fields = new Map();
+    for (const row of $('dl.track-details > .track-details__row').toArray()) {
+        const name = clean($(row).children('dt').text(), 40).toLowerCase();
+        const value = clean($(row).children('dd').text(), 200);
+        if (name && !fields.has(name))
+            fields.set(name, value);
+    }
+    return fields;
+}
+/** A history row: its day and time, its status and the reason shown beside a failed delivery. */
+function scan($, item) {
+    const clock = item.children('.track-timeline__date').children('span').toArray().map((span) => clean($(span).text(), 40));
+    const content = item.children('.track-timeline__content');
+    const status = clean(content.children('.track-timeline__status').text(), 120);
+    if (clock.length !== 2 || !status)
+        throw new SchemaError(PROVIDER, 'Consegnia returned an invalid history row');
+    const reasons = [...new Set(content.find('.track-pill').toArray().map((pill) => clean($(pill).text(), 160)).filter(Boolean))];
+    const staged = consegniaStage(status);
+    return {
+        local_time: wallClock(clock[0], clock[1]),
+        description: reasons.length ? `${status}: ${reasons.join(', ')}` : status,
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+}
+/**
+ * The lookup's reply for one number, `{ success, data: { html } }`: a fragment
+ * its server renders with the number, the current status, the last update, the
+ * booking day, the delivery clock once delivered, and the history, newest
+ * first, each row a status, the reason for a failed delivery and a wall clock
+ * to the minute with no zone. It names no person, place or phone number.
+ *
+ * The fragment must carry the whole number asked. The delivery clock is not
+ * read: a delivered parcel's newest row gives it, and it has no zone either.
+ */
+export function parseConsegnia(payload, raw) {
+    const number = normalizeConsegniaNumber(raw);
+    if (!isRecord(payload) || payload.success !== true || !isRecord(payload.data) || typeof payload.data.html !== 'string') {
+        throw new SchemaError(PROVIDER, 'Consegnia returned an unexpected reply');
+    }
+    const $ = load(payload.data.html);
+    const shown = $('.track-card__awb');
+    if (shown.length !== 1)
+        throw new SchemaError(PROVIDER, 'Consegnia returned a shipment without its number');
+    if (normalizeTrackingNumber(clean(shown.text(), 64)).toUpperCase() !== number) {
+        throw new IndeterminateError(PROVIDER, 'Consegnia answered for another shipment');
+    }
+    const fields = summaryFields($);
+    const summary = clean(fields.get('current status'), 120);
+    if (!summary)
+        throw new SchemaError(PROVIDER, 'Consegnia returned a shipment without its status');
+    const rows = $('ol.track-timeline').children('li.track-timeline__item').toArray();
+    if (rows.length > MAX_EVENTS || (!rows.length && !$('.track-card__empty').length)) {
+        throw new SchemaError(PROVIDER, 'Consegnia returned an invalid history');
+    }
+    // Newest first, as the tracker lists them: the sort keeps rows of one minute in its order.
+    const events = rows.map((row) => scan($, $(row))).sort((left, right) => right.local_time.localeCompare(left.local_time));
+    // The summary is the carrier's current status; the newest staged row decides only one no rule reads.
+    const staged = events.find((event) => event.stage);
+    const current = consegniaStage(summary) ?? (staged ? { stage: staged.stage, source: staged.stage_source } : null);
+    const state = current
+        ? { status: languageStageStatus(current.stage), current_stage: current.stage, current_stage_source: current.source }
+        : { status: 'unknown' };
+    const newest = events[0];
+    if (!newest) {
+        // A shipment with a status and no history yet, dated by its last update, else its booking day.
+        if (!current)
+            throw new NoHistoryError(PROVIDER);
+        const update = DAY_AND_TIME.exec(fields.get('last update') ?? '');
+        const booked = fields.get('booked on');
+        const clock = update ? wallClock(update[1], update[2]) : booked ? dayOf(booked) : null;
+        return {
+            ...state, last_status_text: summary, last_update: null, ...(clock ? { last_update_local: clock } : {}),
+            expected_delivery: null, summary_only: true, events: [],
+        };
+    }
+    return { ...state, last_status_text: newest.description, last_update: null, last_update_local: newest.local_time, expected_delivery: null, events };
+}
+/**
+ * The lookup's answer to a number it does not hold: HTTP 404 with `success`
+ * false and its message. The message does not quote the number. Any other 404
+ * is a missing route.
+ */
+export function isUnknownShipment(body) {
+    let payload;
+    try {
+        payload = JSON.parse(body);
+    }
+    catch {
+        return false;
+    }
+    return isRecord(payload) && payload.success === false && NOT_FOUND.test(clean(payload.message, 300));
+}
+/** The lookup's reply as JSON, or the reason it is not one. */
+export function consegniaJson(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (isBlockPage(body))
+            throw new ChallengeError(PROVIDER, 'Consegnia answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Consegnia returned a reply that is not JSON', { cause });
+    }
+}

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

@@ -0,0 +1,7 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage Consegnia's map gives a status, with or without the reason after it; one it does not list has none. */
+export declare function consegniaMappedStage(wording: string): Stage | undefined;
+/** A status's stage from the map, else from the shared English wording rules, else nothing. */
+export declare function consegniaStage(status: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/consegnia/status.js

@@ -0,0 +1,23 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+import statuses from './statuses.json' with { type: 'json' };
+// The statuses Consegnia's tracker shows, as it words them. The adapter writes a
+// failed delivery's reason after its status and a colon.
+const STAGES = new Map(statuses.entries.map((entry) => [normalizeStatusWording(entry.wording), entry.stage]));
+/** The stage Consegnia's map gives a status, with or without the reason after it; one it does not list has none. */
+export function consegniaMappedStage(wording) {
+    const key = normalizeStatusWording(wording);
+    return STAGES.get(key) ?? STAGES.get(key.split(': ', 1)[0]);
+}
+/** A status's stage from the map, else from the shared English wording rules, else nothing. */
+export function consegniaStage(status) {
+    const mapped = consegniaMappedStage(status);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(status);
+    return worded.source === 'none' ? null : worded;
+}
+export const statusMap = {
+    stage: (_code, wording) => consegniaMappedStage(wording),
+    gaps: [],
+};

package/dist/carriers/consegnia/statuses.json

@@ -1,4 +1,11 @@
 {
   "carrier": "consegnia",
-  "entries": []
+  "entries": [
+    {"wording": "Ready for Pick-up", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "Booked and waiting for Consegnia's rider to collect it from the shipper: a new booking's first and only scan, at its booking clock. Histories copied from its former tracker list it among their other scans at the copy's one clock."},
+    {"wording": "Arrived at Hub", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
+    {"wording": "Out for Delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "live"},
+    {"wording": "Delivery Failed", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "note": "The tracker shows the reason beside the status; the adapter adds it after a colon."},
+    {"wording": "Delivery Failed: COT - Courier Out of Time", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "note": "The courier ran out of time on the round."},
+    {"wording": "Delivered", "language": "en", "stage": "delivered", "confirmedBy": "live"}
+  ]
 }