universal-parcel-scraper 0.684.2-main.3246 → 0.686.0-main.3253

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 **616 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **617 dedicated adapters** and **5 universal fallbacks**
 
 <sub>792 catalog entries · 135 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 16,579 such statuses, each filed under one stage.
+The carrier folders record 16,560 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

@@ -9934,7 +9934,8 @@
     "timezone": "America/Havana",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "correos-cuba",
+      "localClocks": true
     },
     "canaryUrl": "https://www.correos.cu/rastreador-de-envios/",
     "trackingSearchUrl": "https://www.correos.cu/rastreador-de-envios/",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 792,
-  "activeAdapters": 616,
+  "activeAdapters": 617,
   "countries": 135,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -7881,7 +7881,8 @@ var Ze = {
 		timezone: "America/Havana",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "correos-cuba",
+			localClocks: !0
 		},
 		canaryUrl: "https://www.correos.cu/rastreador-de-envios/",
 		trackingSearchUrl: "https://www.correos.cu/rastreador-de-envios/",

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

@@ -1,5 +1,5 @@
 /**
- * Asendia tracking through Asendia USA's A1 platform, then Asendia UK's tracker.
+ * Asendia tracking through Asendia USA's A1 platform.
  *
  * Protocol provenance (inspected 2026-09-22):
  * - The official public page https://a1.asendiausa.com/tracking/ (the same
@@ -24,12 +24,10 @@
  *   backend/src/sources/implementations/asendia.ts) and deingithub/beanstalk
  *   (beanstalk/parcel.py).
  *
- * Coverage: A1 answers for parcels on Asendia USA's platform. The adapter
- * then asks Asendia UK's tracker (uk.ts), which serves parcels Asendia UK
- * carries, when A1 does not know the number, fails, or holds its registration
- * alone. Asendia's global portal track.asendia.com, which serves the
- * other subsidiaries, uses an optional browser recovery step (browser.ts).
- * Without that service, a number neither HTTP tracker knows is a
+ * Coverage: A1 answers for parcels on Asendia USA's platform. Asendia's
+ * global portal track.asendia.com, which serves the other subsidiaries and
+ * replaced Asendia UK's own tracker, uses an optional browser recovery step
+ * (browser.ts). Without that service, a number A1 does not know is a
  * not-found for this adapter only; routing then tries the universal providers
  * in the same check.
  *

package/dist/carriers/asendia/adapter.js

@@ -1,5 +1,5 @@
 /**
- * Asendia tracking through Asendia USA's A1 platform, then Asendia UK's tracker.
+ * Asendia tracking through Asendia USA's A1 platform.
  *
  * Protocol provenance (inspected 2026-09-22):
  * - The official public page https://a1.asendiausa.com/tracking/ (the same
@@ -24,12 +24,10 @@
  *   backend/src/sources/implementations/asendia.ts) and deingithub/beanstalk
  *   (beanstalk/parcel.py).
  *
- * Coverage: A1 answers for parcels on Asendia USA's platform. The adapter
- * then asks Asendia UK's tracker (uk.ts), which serves parcels Asendia UK
- * carries, when A1 does not know the number, fails, or holds its registration
- * alone. Asendia's global portal track.asendia.com, which serves the
- * other subsidiaries, uses an optional browser recovery step (browser.ts).
- * Without that service, a number neither HTTP tracker knows is a
+ * Coverage: A1 answers for parcels on Asendia USA's platform. Asendia's
+ * global portal track.asendia.com, which serves the other subsidiaries and
+ * replaced Asendia UK's own tracker, uses an optional browser recovery step
+ * (browser.ts). Without that service, a number A1 does not know is a
  * not-found for this adapter only; routing then tries the universal providers
  * in the same check.
  *
@@ -38,7 +36,7 @@
  * read, and nothing else from the summary is copied except the destination
  * country, weight and the declared last-mile reference.
  */
-import { accepted, lookupBudget, recognizeFromLookup } from '../../core/adapter/index.js';
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
 import { carrierIdFromPartner } from '../../core/catalog/hints.js';
 import { BudgetExceededError, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError, UpstreamHttpError, UpstreamNetworkError } from '../../core/errors/index.js';
 import { languageStageStatus, wordingStage } from '../../core/status/index.js';
@@ -47,7 +45,6 @@ import { clean, cleanScalar, decodeText, fetchBounded, parseJsonBytes, userAgent
 import { isRecord } from '../../core/types.js';
 import { daiPostScanZone } from '../dai-post/clock.js';
 import { classifyAsendiaA1Event, comparableText } from './status.js';
-import { AsendiaUkTracker } from './uk.js';
 import { asendiaBrowser } from './browser.js';
 import { recoverableByDefault, runSteps } from '../../core/runner/index.js';
 const PROVIDER = 'Asendia';
@@ -458,73 +455,20 @@ export class AsendiaA1Tracker {
         return remaining;
     }
 }
-/** The part of a lookup's budget kept for Asendia UK's tracker, at most a third. */
-const UK_RESERVE_MS = 8_000;
-/** Whether a result shows the parcel past its registration. */
-function progressed(result) {
-    return result.status !== 'pending' && result.status !== 'unknown';
-}
-/**
- * A1 first, then Asendia UK. A1 can hold a UK parcel's registration alone
- * while Asendia UK's tracker shows its progress, so a parcel A1 has not seen
- * past registration is also looked up there, and the UK history is returned
- * when it has progressed further. A not-found means both said so: any other
- * A1 failure is reported instead when the UK tracker does not know the number
- * either, and the first failure is the one reported when both fail.
- */
-async function trackEverywhere(a1, uk, rawTrackingNumber, context = {}) {
-    const trackingNumber = normalizeAsendiaA1TrackingNumber(rawTrackingNumber);
-    const budget = lookupBudget(context, DEFAULT_BUDGET_MS, PROVIDER);
-    const reserve = Math.min(UK_RESERVE_MS, Math.floor(budget.remainingMs() / 3));
-    let failure = null;
-    let registered = null;
-    try {
-        const result = await a1.fetch(trackingNumber, { signal: budget.signal, budgetMs: Math.max(1, budget.remainingMs() - reserve) });
-        if (progressed(result))
-            return result;
-        registered = result;
-    }
-    catch (error) {
-        if (context.signal?.aborted || !(error instanceof Error))
-            throw error;
-        if (!(error instanceof NotFoundError))
-            failure = error;
-    }
-    if (budget.signal.aborted) {
-        if (registered)
-            return registered;
-        throw failure ?? new BudgetExceededError(PROVIDER, budget.budgetMs);
-    }
-    try {
-        const result = await uk.fetch(trackingNumber, { signal: budget.signal, budgetMs: budget.remainingMs() });
-        return registered && !progressed(result) ? registered : result;
-    }
-    catch (error) {
-        if (context.signal?.aborted)
-            throw error;
-        // A1's answer stands whatever the UK tracker says.
-        if (registered)
-            return registered;
-        if (error instanceof NotFoundError)
-            throw failure ?? new NotFoundError(PROVIDER);
-        throw failure ?? error;
-    }
-}
 export const adapter = (environment) => {
     const a1 = new AsendiaA1Tracker({ fetcher: environment.fetcher, userAgent: environment.userAgent });
-    const uk = new AsendiaUkTracker({ fetcher: environment.fetcher, userAgent: environment.userAgent });
     return {
         id: 'asendia',
         recordsSteps: true,
         steps: ['direct', 'trawl'],
-        // A1 and Asendia UK only: recognition never opens the global portal's browser.
-        recognize: (number, context) => recognizeFromLookup(() => trackEverywhere(a1, uk, number, context), () => accepted(() => normalizeAsendiaA1TrackingNumber(number))),
+        // A1 only: recognition never opens the global portal's browser.
+        recognize: (number, context) => recognizeFromLookup(() => a1.fetch(number, context), () => accepted(() => normalizeAsendiaA1TrackingNumber(number))),
         track: (input, context) => {
             const number = normalizeAsendiaA1TrackingNumber(input.number);
             const browserEligible = !!environment.trawl && /^[A-Z0-9]{8,40}$/.test(number) && /\d/.test(number);
             return runSteps({ carrier: 'asendia', signal: context?.signal,
                 budgetMs: context?.budgetMs ?? (browserEligible ? 65_000 : DEFAULT_BUDGET_MS), recorder: environment.recorder }, [
-                { id: 'direct', run: ({ signal, remainingMs }) => trackEverywhere(a1, uk, number, { signal, budgetMs: Math.min(DEFAULT_BUDGET_MS, browserEligible ? Math.max(1, Math.floor(remainingMs * 0.4)) : remainingMs) }) },
+                { id: 'direct', run: ({ signal, remainingMs }) => a1.fetch(number, { signal, budgetMs: Math.min(DEFAULT_BUDGET_MS, browserEligible ? Math.max(1, Math.floor(remainingMs * 0.4)) : remainingMs) }) },
                 { id: 'trawl', enabled: browserEligible,
                     recovers: error => error instanceof NotFoundError || recoverableByDefault(error),
                     run: async ({ signal, remainingMs, previousError }) => {
@@ -532,7 +476,7 @@ export const adapter = (environment) => {
                             return await asendiaBrowser(environment.trawl, number, signal, remainingMs, input.postcode?.trim() || null);
                         }
                         catch (error) {
-                            // The global portal cannot erase a failure from either HTTP source.
+                            // The global portal cannot erase a failure from A1.
                             if (error instanceof NotFoundError && !(previousError instanceof NotFoundError))
                                 throw previousError;
                             throw error;

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

@@ -1,10 +1,9 @@
 /**
  * Asendia event vocabularies → product stage.
  *
- * Three sources, three maps. The registered adapter reads Asendia USA's A1
- * platform through `classifyAsendiaA1Event` and Asendia UK's tracker through
- * `classifyAsendiaUkEvent`; `classifyAsendiaStatus` serves the global-portal
- * probe.
+ * Two sources, two maps. The registered adapter reads Asendia USA's A1
+ * platform through `classifyAsendiaA1Event`; `classifyAsendiaStatus` serves
+ * the global-portal probe.
  *
  * A1: Asendia's own scans carry numeric codes (`1`, `2`, `2.1`, …) and are
  * mapped by code. Last-mile partners' scans arrive through the same list with
@@ -13,9 +12,6 @@
  * no event stage, leaving it to the sync's shared wording rules and the
  * unmapped-wording review.
  *
- * Asendia UK: one fixed English vocabulary for Asendia's own scans and the
- * last-mile partner's, mapped by exact wording.
- *
  * Global portal: Asendia's branded portal harmonizes the wording of every partner post into
  * one English vocabulary (`harmonizedEvent`), which is what this map keys on;
  * the numeric `harmonizedCode` is retained as the event's `provider_code` but
@@ -43,7 +39,3 @@ export declare function classifyAsendiaStatus(description: string): ClassifiedAs
  * "10" or "B1" for unrelated scans.
  */
 export declare function classifyAsendiaA1Event(source: string, code: string, description: string): ClassifiedAsendiaStatus | null;
-/** The explicit mapping for one Asendia UK event, or null when the map does not know its wording. */
-export declare function classifyAsendiaUkEvent(description: string): ClassifiedAsendiaStatus | null;
-/** Whether an Asendia UK event is a notice rather than a scan. */
-export declare function isAsendiaUkNotice(description: string): boolean;

package/dist/carriers/asendia/status.js

@@ -158,42 +158,3 @@ export function classifyAsendiaA1Event(source, code, description) {
     const wording = comparableText(description);
     return Object.hasOwn(PARTNER_WORDING, wording) ? PARTNER_WORDING[wording] : null;
 }
-/** Asendia UK tracker wording seen live or in archived captures, compared with `comparableText`. */
-const UK_WORDING = {
-    'manifest received': REGISTERED,
-    // Asendia's own hub sort: the parcel's first physical scan.
-    'processed down packet line': ACCEPTED,
-    // Both follow the hub sort, so the parcel is already with Asendia.
-    'not yet received by carrier': IN_TRANSIT,
-    'awaiting despatch': IN_TRANSIT,
-    'scanned to container': IN_TRANSIT,
-    // The last-mile partner's pre-advice, recorded after the parcel left the hub.
-    'elec advice recd by carrier': IN_TRANSIT,
-    'arrived at import gateway': IN_TRANSIT,
-    'awaiting customs clearance': CUSTOMS,
-    'customs clearance in progress': CUSTOMS,
-    'held by customs or governing body': CUSTOMS,
-    'customs cleared': IN_TRANSIT,
-    'handover by broker to delivery partner': IN_TRANSIT,
-    'received by carrier': IN_TRANSIT,
-    'received at carrier facility': IN_TRANSIT,
-    'sub contractor received': IN_TRANSIT,
-    // Seen between the partner's own receipt scans, not as a first pickup.
-    'collection made': IN_TRANSIT,
-    'internal hub scan': IN_TRANSIT,
-    'in transit': IN_TRANSIT,
-    'arrival at delivery depot': IN_TRANSIT,
-    'out for delivery': OUT_FOR_DELIVERY,
-    delivered: DELIVERED,
-};
-/** Notices the tracker interleaves with scans, even before the hub sort: they never set the current stage. */
-const UK_NOTICES = new Set(['information', 'carrier delays']);
-/** The explicit mapping for one Asendia UK event, or null when the map does not know its wording. */
-export function classifyAsendiaUkEvent(description) {
-    const wording = comparableText(description);
-    return Object.hasOwn(UK_WORDING, wording) ? UK_WORDING[wording] : null;
-}
-/** Whether an Asendia UK event is a notice rather than a scan. */
-export function isAsendiaUkNotice(description) {
-    return UK_NOTICES.has(comparableText(description));
-}

package/dist/carriers/asendia/statuses.json

@@ -928,174 +928,6 @@
       "confirmedBy": "live",
       "firstSeen": "2026-10-10",
       "note": "A1 partner scan wording (DAI FP05, Australia), matched exactly; the shared rules read the delivery to come as no scan."
-    },
-    {
-      "wording": "Manifest received",
-      "language": "en",
-      "stage": "registered",
-      "confirmedBy": "live",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Processed down packet line",
-      "language": "en",
-      "stage": "accepted",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker. Sorting at Asendia's hub, the first physical scan."
-    },
-    {
-      "wording": "Not yet received by carrier",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker. Follows the hub sort; the parcel is with Asendia."
-    },
-    {
-      "wording": "Awaiting Despatch",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker. Follows the hub sort; the parcel is with Asendia."
-    },
-    {
-      "wording": "Scanned to container",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker. Also written \"Scanned to Container\"."
-    },
-    {
-      "wording": "Elec Advice recd by carrier",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker. The last-mile partner's pre-advice, recorded after the parcel left the hub."
-    },
-    {
-      "wording": "Arrived at Import Gateway",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Awaiting Customs Clearance",
-      "language": "en",
-      "stage": "customs",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Customs Clearance in Progress",
-      "language": "en",
-      "stage": "customs",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Held by customs or governing body",
-      "language": "en",
-      "stage": "customs",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Customs cleared",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Handover by Broker to Delivery Partner",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Received by carrier",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Received at carrier facility",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Sub-contractor received",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Collection made",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker. Seen between the partner's own receipt scans, not as a first pickup."
-    },
-    {
-      "wording": "Internal Hub Scan",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "In transit",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Arrival At Delivery Depot",
-      "language": "en",
-      "stage": "in_transit",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Out for delivery",
-      "language": "en",
-      "stage": "out_for_delivery",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
-    },
-    {
-      "wording": "Delivered",
-      "language": "en",
-      "stage": "delivered",
-      "confirmedBy": "portal",
-      "firstSeen": "2026-10-13",
-      "note": "Asendia UK tracker."
     }
   ]
 }

package/dist/carriers/correos-cuba/adapter.d.ts

@@ -0,0 +1,20 @@
+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 tracker page, which gives every visitor the token its lookups carry. */
+export declare const CORREOS_CUBA_PAGE = "https://www.correos.cu/rastreador-de-envios/";
+/** The lookup the page's script posts the code, the year and the token to. */
+export declare const CORREOS_CUBA_LOOKUP = "https://www.correos.cu/wp-json/correos-api/enviosweb/";
+export declare class CorreosCubaTracker {
+    private readonly options;
+    private token;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+        now?: () => number;
+    });
+    private pageToken;
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/correos-cuba/adapter.js

@@ -0,0 +1,93 @@
+import { DateTime } from 'luxon';
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, 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 { assertNotChallenged, CORREOS_CUBA_MAX_BYTES, correosCubaPageToken, isExpiredCorreosCubaToken, normalizeCorreosCubaNumber, parseCorreosCuba, PROVIDER, } from './parser.js';
+/** The tracker page, which gives every visitor the token its lookups carry. */
+export const CORREOS_CUBA_PAGE = 'https://www.correos.cu/rastreador-de-envios/';
+/** The lookup the page's script posts the code, the year and the token to. */
+export const CORREOS_CUBA_LOOKUP = 'https://www.correos.cu/wp-json/correos-api/enviosweb/';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// The tracker answers an unknown code in its reply: a missing route is not a missing item.
+const GONE = [404, 410];
+const DEFAULT_BUDGET_MS = 20_000;
+const ZONE = 'America/Havana';
+export class CorreosCubaTracker {
+    options;
+    // The page gives every visitor the same token, which lasts beyond one lookup.
+    token;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async pageToken(signal, timeoutMs) {
+        const { response, bytes } = await fetchBounded(CORREOS_CUBA_PAGE, { method: 'GET', signal, headers: {
+                Accept: 'text/html,application/xhtml+xml', 'Accept-Language': 'es', 'User-Agent': userAgentOf(this.options.userAgent),
+            } }, { provider: PROVIDER, timeoutMs, maxBytes: CORREOS_CUBA_MAX_BYTES, redirect: 'manual',
+            allowHttpStatuses: [...REDIRECTS, ...GONE], fetcher: this.options.fetcher });
+        if (REDIRECTS.includes(response.status) || GONE.includes(response.status)) {
+            throw new TransportError(PROVIDER, 'The Correos de Cuba tracker moved', { status: response.status });
+        }
+        this.token = correosCubaPageToken(decodeText(bytes));
+        return this.token;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeCorreosCubaNumber(raw);
+        // The tracker finds an item in the year asked and the one before; the page asks Havana's current year.
+        const year = String(DateTime.fromMillis(this.options.now?.() ?? Date.now(), { zone: ZONE }).year);
+        const read = async (signal, timeoutMs) => {
+            const deadline = Date.now() + timeoutMs;
+            const left = () => Math.max(1, Math.floor(deadline - Date.now()));
+            const lookup = async (token) => {
+                const { response, bytes } = await fetchBounded(CORREOS_CUBA_LOOKUP, { method: 'POST', signal, headers: {
+                        Accept: 'application/json, text/javascript, */*; q=0.01', 'Accept-Language': 'es',
+                        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8', 'X-Requested-With': 'XMLHttpRequest',
+                        Referer: CORREOS_CUBA_PAGE, 'User-Agent': userAgentOf(this.options.userAgent),
+                    }, body: new URLSearchParams({ codigo: number, anno: year, token, user: '' }).toString() }, { provider: PROVIDER, timeoutMs: left(), maxBytes: CORREOS_CUBA_MAX_BYTES, redirect: 'manual',
+                    allowHttpStatuses: [...REDIRECTS, ...GONE], fetcher: this.options.fetcher });
+                if (REDIRECTS.includes(response.status) || GONE.includes(response.status)) {
+                    throw new TransportError(PROVIDER, 'The Correos de Cuba lookup moved', { status: response.status });
+                }
+                const body = decodeText(bytes);
+                if (!body.trim())
+                    throw new IndeterminateError(PROVIDER, 'Correos de Cuba returned an empty reply');
+                try {
+                    return JSON.parse(body);
+                }
+                catch (cause) {
+                    assertNotChallenged(body);
+                    throw new SchemaError(PROVIDER, 'Correos de Cuba returned a reply that is not JSON', { cause });
+                }
+            };
+            const cached = this.token;
+            let payload = await lookup(cached ?? await this.pageToken(signal, left()));
+            // A reused token the tracker has dropped is replaced once.
+            if (isExpiredCorreosCubaToken(payload) && cached) {
+                this.token = undefined;
+                payload = await lookup(await this.pageToken(signal, left()));
+            }
+            if (isExpiredCorreosCubaToken(payload)) {
+                this.token = undefined;
+                throw new ChallengeError(PROVIDER, 'Correos de Cuba refused its own page token');
+            }
+            return parseCorreosCuba(payload, number);
+        };
+        // A request that fails to reach the tracker, or hangs, gets one more try:
+        // the first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'correos-cuba', budgetMs: context.budgetMs ?? DEFAULT_BUDGET_MS, 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 CorreosCubaTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'correos-cuba', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeCorreosCubaNumber(number))),
+    };
+};

package/dist/carriers/correos-cuba/carrier.json

@@ -17,17 +17,48 @@
   "timezone": "America/Havana",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "correos-cuba",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location"
+  ],
   "portal": {
     "searchUrl": "https://www.correos.cu/rastreador-de-envios/",
     "canaryUrl": "https://www.correos.cu/rastreador-de-envios/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "origin_country",
+      "destination_country",
+      "progress_rail"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "origin_country",
+      "destination_country",
+      "progress_rail"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "delivered_at",
+      "offset_timestamps",
+      "recipient_name",
+      "sender_name",
+      "proof_of_delivery"
+    ]
   },
   "links": [],
   "detection": []

package/dist/carriers/correos-cuba/parser.d.ts

@@ -0,0 +1,24 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Correos de Cuba";
+export declare const CORREOS_CUBA_MAX_BYTES: number;
+/** The tracker looks up S10 item codes, Correos de Cuba's own ending CU and those of the posts that send items to Cuba. */
+export declare function normalizeCorreosCubaNumber(raw: string): string;
+/** A firewall's page in place of the site's, which is no answer about the item. */
+export declare function assertNotChallenged(body: string): void;
+/**
+ * The token the tracker page gives every visitor for its lookups. The page
+ * styles a security plugin's captcha for its other forms, so only a page
+ * without the token is checked for a firewall's, by its vendor's markers.
+ */
+export declare function correosCubaPageToken(html: string): string;
+/** The tracker's refusal of the page token, which a fresh page replaces. */
+export declare function isExpiredCorreosCubaToken(payload: unknown): boolean;
+/**
+ * The tracker's reply to `enviosweb`: the item's scans, newest first, each
+ * with a state, a date, the office it left and the one it went to, and the
+ * countries and progress rail the page shows above them. The tracker matches
+ * the whole code, in the year asked and the one before, and its reply does
+ * not repeat the code. It answers a code it holds nothing for in those years
+ * with no scans and no error, so an empty history is inconclusive.
+ */
+export declare function parseCorreosCuba(payload: unknown, rawNumber: string): CarrierResult;

package/dist/carriers/correos-cuba/parser.js

@@ -0,0 +1,129 @@
+import { load } from 'cheerio';
+import { isValidS10TrackingNumber, 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 { correosCubaStage } from './status.js';
+export const PROVIDER = 'Correos de Cuba';
+// The tracker page is about seventy kilobytes, most of it the site's frame; a reply is a few.
+export const CORREOS_CUBA_MAX_BYTES = 1024 * 1024;
+const MAX_ROWS = 500;
+// A firewall's, CDN's or bot check's page in place of the site's, which can come back with HTTP 200.
+const BLOCKED = /<title>\s*(?:Request Rejected|Access Denied|Attention Required|Just a moment|Web Page Blocked)|requested URL was rejected|_cf_chl_opt|cf-turnstile|g-recaptcha|h-captcha/i;
+// The tracker's answer to a page token it does not take, or to none.
+const EXPIRED_TOKEN = /token ha caducado/i;
+// "2026-05-04 09:12:30", the office's wall clock, which the tracker gives without a zone.
+const DATE = /^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2})(?::(\d{2}))?)?$/;
+// The office the tracker names for an item sent abroad; the page shows the destination country in its place.
+const EXPORT_OFFICE = 'exportacionIPS';
+// The scan for an item an office received; the page names the receiving office, the other scans the one they left.
+const RECEIVED = 'RECEPCIONADO';
+/** The tracker looks up S10 item codes, Correos de Cuba's own ending CU and those of the posts that send items to Cuba. */
+export function normalizeCorreosCubaNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (isValidS10TrackingNumber(number))
+        return number;
+    throw new InvalidInputError(PROVIDER, 'Correos de Cuba tracks S10 item codes with a valid check digit');
+}
+/** A firewall's page in place of the site's, which is no answer about the item. */
+export function assertNotChallenged(body) {
+    if (BLOCKED.test(body.slice(0, 64_000)))
+        throw new ChallengeError(PROVIDER, 'Correos de Cuba answered with a firewall page');
+}
+/**
+ * The token the tracker page gives every visitor for its lookups. The page
+ * styles a security plugin's captcha for its other forms, so only a page
+ * without the token is checked for a firewall's, by its vendor's markers.
+ */
+export function correosCubaPageToken(html) {
+    const token = load(html)('input#side').attr('value')?.trim() ?? '';
+    if (/^[A-Za-z0-9]{6,64}$/.test(token))
+        return token;
+    assertNotChallenged(html);
+    throw new SchemaError(PROVIDER, 'Correos de Cuba returned a tracker page without its token');
+}
+/** The tracker's refusal of the page token, which a fresh page replaces. */
+export function isExpiredCorreosCubaToken(payload) {
+    return isRecord(payload) && typeof payload.error === 'string' && EXPIRED_TOKEN.test(payload.error);
+}
+/** A scan's date as the tracker gives it: the office's wall clock, without an offset. */
+function localTime(value) {
+    const match = typeof value === 'string' ? DATE.exec(value.trim()) : null;
+    const day = match ? calendarDay(Number(match[1]), Number(match[2]), Number(match[3])) : null;
+    if (!match || !day)
+        throw new SchemaError(PROVIDER, 'Correos de Cuba returned an invalid scan date');
+    const [hours, minutes, seconds = '00'] = match.slice(4);
+    if (hours === undefined || minutes === undefined)
+        return day;
+    if (Number(hours) > 23 || Number(minutes) > 59 || Number(seconds) > 59) {
+        throw new SchemaError(PROVIDER, 'Correos de Cuba returned an invalid scan time');
+    }
+    return `${day}T${hours}:${minutes}:${seconds}`;
+}
+function text(value, maxLength) {
+    if (value != null && typeof value !== 'string')
+        throw new SchemaError(PROVIDER, 'Correos de Cuba returned an invalid scan field');
+    return clean(value, maxLength);
+}
+/**
+ * The tracker's reply to `enviosweb`: the item's scans, newest first, each
+ * with a state, a date, the office it left and the one it went to, and the
+ * countries and progress rail the page shows above them. The tracker matches
+ * the whole code, in the year asked and the one before, and its reply does
+ * not repeat the code. It answers a code it holds nothing for in those years
+ * with no scans and no error, so an empty history is inconclusive.
+ */
+export function parseCorreosCuba(payload, rawNumber) {
+    normalizeCorreosCubaNumber(rawNumber);
+    if (!isRecord(payload) || !Array.isArray(payload.datos))
+        throw new SchemaError(PROVIDER, 'Correos de Cuba returned an unexpected reply');
+    if (payload.datos.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Correos de Cuba returned an oversized history');
+    if (!payload.datos.length) {
+        if (payload.error != null && typeof payload.error !== 'string')
+            throw new SchemaError(PROVIDER, 'Correos de Cuba returned an invalid error');
+        if (clean(payload.error, 200))
+            throw new IndeterminateError(PROVIDER, 'Correos de Cuba refused the lookup');
+        throw new NoHistoryError(PROVIDER, 'Correos de Cuba holds no scans for the item this year or last');
+    }
+    const country = text(payload.p_destino, 80);
+    const events = [];
+    const seen = new Set();
+    for (const row of payload.datos) {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'Correos de Cuba returned an invalid history row');
+        const description = text(row.estado, 200);
+        if (!description)
+            throw new SchemaError(PROVIDER, 'Correos de Cuba returned a scan without a state');
+        const local = localTime(row.fecha);
+        const from = text(row.oficina_origen, 120), to = text(row.oficina_destino, 120);
+        // Where the page puts the scan: the office that received the item, else the one it left, the destination country for an export.
+        const location = description.toUpperCase() === RECEIVED ? to || from : from === EXPORT_OFFICE ? country : from;
+        const key = [local, location, description].join('\n');
+        // A scan listed twice is kept once.
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const staged = correosCubaStage(description);
+        events.push({
+            local_time: local,
+            ...(location ? { location } : {}),
+            description,
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        });
+    }
+    const newest = events[0];
+    const current = events.find((event) => event.stage);
+    const stage = current?.stage;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.stage_source } : {}),
+        last_status_text: newest.description ?? null,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: null,
+        events,
+    };
+}

package/dist/carriers/correos-cuba/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 the map gives a scan's state, if it knows it. */
+export declare function correosCubaMappedStage(wording: string): Stage | undefined;
+/** A scan's stage from its state, else the shared wording rules, else nothing, which keeps it visible for review. */
+export declare function correosCubaStage(wording: string): ClassifiedWording | null;
+/** The tracker shows states only; the map leaves none out on purpose. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/correos-cuba/status.js

@@ -0,0 +1,41 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The states of the Correos de Cuba tracker, which carries no codes. Only
+ * states seen on the tracker or explained in a guide to it are mapped;
+ * another falls to the wording rules.
+ */
+const WORDINGS = new Map([
+    // Posted: "imponer" is to post an item, not a tax.
+    ['Impuesto', 'accepted'],
+    ['Clasificado', 'in_transit'],
+    // Sent on to the office the scan names.
+    ['Facturado', 'in_transit'],
+    // Handed to a private small business that distributes parcels for the post.
+    ['Facturado a mipyme', 'in_transit'],
+    ['Recepcionado', 'in_transit'],
+    ['Entregado a aduana', 'customs'],
+    ['Entregado a aduana en exportaciones', 'customs'],
+    // Released by customs, which sends the item on.
+    ['Salida aduana', 'in_transit'],
+    ['Entregado', 'delivered'],
+].map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+/** The stage the map gives a scan's state, if it knows it. */
+export function correosCubaMappedStage(wording) {
+    return WORDINGS.get(normalizeStatusWording(wording));
+}
+/** A scan's stage from its state, else the shared wording rules, else nothing, which keeps it visible for review. */
+export function correosCubaStage(wording) {
+    if (!wording)
+        return null;
+    const mapped = correosCubaMappedStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** The tracker shows states only; the map leaves none out on purpose. */
+export const statusMap = {
+    stage: (_code, wording) => correosCubaMappedStage(wording),
+    gaps: [],
+};

package/dist/carriers/correos-cuba/statuses.json

@@ -1,12 +1,14 @@
 {
   "carrier": "correos-cuba",
   "entries": [
-    {"wording": "Recepción", "stage": "accepted", "language": "es", "confirmedBy": "official-doc", "note": "Step label of the progress rail on the carrier's tracker page."},
-    {"wording": "En camino", "stage": "in_transit", "language": "es", "confirmedBy": "official-doc", "note": "Step label of the progress rail on the carrier's tracker page."},
-    {"wording": "En entrega", "stage": "out_for_delivery", "language": "es", "confirmedBy": "official-doc", "note": "Step label of the progress rail on the carrier's tracker page."},
-    {"wording": "Entregado", "stage": "delivered", "language": "es", "confirmedBy": "official-doc", "note": "Step label of the progress rail on the carrier's tracker page."},
-    {"wording": "Clasificado", "stage": "in_transit", "language": "es", "confirmedBy": "source", "note": "Processed at the international office of exchange in Havana and ready for the sorting or delivery centre. Explained in a Cuban guide to the tracker's messages."},
+    {"wording": "IMPUESTO", "stage": "accepted", "language": "es", "confirmedBy": "portal", "note": "Posted at the office the scan names."},
+    {"wording": "CLASIFICADO", "stage": "in_transit", "language": "es", "confirmedBy": "portal", "note": "Sorted at an office, including the international office of exchange in Havana."},
+    {"wording": "FACTURADO", "stage": "in_transit", "language": "es", "confirmedBy": "portal", "note": "Sent on to the office the scan names."},
     {"wording": "Facturado a mipyme", "stage": "in_transit", "language": "es", "confirmedBy": "source", "note": "Delivery handed to a private small business that distributes parcels for the post. Explained in a Cuban guide to the tracker's messages."},
-    {"wording": "entregado a aduana en exportaciones", "stage": "customs", "language": "es", "confirmedBy": "source", "note": "Handed to export customs, for an item leaving Cuba. Quoted in a sender's comment on a Cuban tracking guide."}
+    {"wording": "RECEPCIONADO", "stage": "in_transit", "language": "es", "confirmedBy": "portal", "note": "Received at the office the scan names."},
+    {"wording": "ENTREGADO A ADUANA", "stage": "customs", "language": "es", "confirmedBy": "portal"},
+    {"wording": "entregado a aduana en exportaciones", "stage": "customs", "language": "es", "confirmedBy": "source", "note": "Handed to export customs, for an item leaving Cuba. Quoted in a sender's comment on a Cuban tracking guide."},
+    {"wording": "SALIDA ADUANA", "stage": "in_transit", "language": "es", "confirmedBy": "portal", "note": "Released by customs, which sends the item on."},
+    {"wording": "ENTREGADO", "stage": "delivered", "language": "es", "confirmedBy": "portal"}
   ]
 }

package/dist/carriers/mondial-relay/app.js

@@ -150,6 +150,8 @@ export function parseMondialRelayApp(payload, uid) {
         throw new IndeterminateError('Mondial Relay', 'Mondial Relay app returned no shipment activity');
     // The delivery point, while the parcel waits there.
     const pickup = current?.stage === 'ready_for_pickup' ? deliveryPoint(parcel.detail) : '';
+    // As on the website, a delivered parcel takes its delivery scan's clock.
+    const deliveredAt = current?.status === 'delivered' ? events.find((event) => event.stage === 'delivered')?.time : undefined;
     return {
         status: current?.status ?? 'unknown',
         ...(current ? { current_stage: current.stage } : {}),
@@ -157,6 +159,7 @@ export function parseMondialRelayApp(payload, uid) {
         last_update: events[0]?.time ?? null,
         expected_delivery: null,
         ...(pickup ? { pickup_point: pickup } : {}),
+        ...(deliveredAt ? { delivered_at: deliveredAt } : {}),
         timezone: ZONE,
         events,
         source: 'mondial_relay_app',

package/dist/core/catalog/statusMaps.js

@@ -106,6 +106,7 @@ import { statusMap as copaCourier } from '../../carriers/copa-courier/status.js'
 import { statusMap as corre } from '../../carriers/corre/status.js';
 import { statusMap as correoArgentino } from '../../carriers/correo-argentino/status.js';
 import { statusMap as correoUruguayo } from '../../carriers/correo-uruguayo/status.js';
+import { statusMap as correosCuba } from '../../carriers/correos-cuba/status.js';
 import { statusMap as correosDeMexico } from '../../carriers/correos-de-mexico/status.js';
 import { statusMap as correosElSalvador } from '../../carriers/correos-el-salvador/status.js';
 import { statusMap as correosExpress } from '../../carriers/correos-express/status.js';
@@ -574,7 +575,7 @@ export const STATUS_MAPS = {
     'chit-chats': chitChats, chronodiali, chronopost, chukou1, 'chunghwa-post': chunghwaPost, chunil, 'city-express-rs': cityExpressRs, 'citylink-express': citylinkExpress, citymail,
     'cj-logistics': cjLogistics, 'cj-packet': cjPacket, 'closer-logistics': closerLogistics, 'connect-couriers': connectCouriers, coordinadora,
     'copa-courier': copaCourier, corre,
-    'correo-argentino': correoArgentino, 'correo-uruguayo': correoUruguayo, 'correos-de-mexico': correosDeMexico, 'correos-el-salvador': correosElSalvador, 'correos-express': correosExpress, 'correos-spain': correosSpain,
+    'correo-argentino': correoArgentino, 'correo-uruguayo': correoUruguayo, 'correos-cuba': correosCuba, 'correos-de-mexico': correosDeMexico, 'correos-el-salvador': correosElSalvador, 'correos-express': correosExpress, 'correos-spain': correosSpain,
     'courier-center': courierCenter, couriersplease: couriersPlease, 'cruz-del-sur': cruzDelSur, 'cse-russia': cseRussia, cttyex,
     'cyprus-post': cyprusPost, 'd-express': dExpress, 'dai-post': daiPost, 'danske-fragtmaend': danskeFragtmaend, dao, 'day-ross': dayRoss,
     dayone, 'daylight-transport': daylightTransport, 'dayton-freight': daytonFreight, dellin, delnext, deppon, 'dhl-express': dhlExpress,

package/dist/data/catalog.json

@@ -9934,7 +9934,8 @@
         "timezone": "America/Havana",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "correos-cuba",
+            "localClocks": true
         },
         "canaryUrl": "https://www.correos.cu/rastreador-de-envios/",
         "trackingSearchUrl": "https://www.correos.cu/rastreador-de-envios/",

package/dist/generated/catalog.d.ts

@@ -6474,7 +6474,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "America/Havana";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "correos-cuba";
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.correos.cu/rastreador-de-envios/";
         readonly trackingSearchUrl: "https://www.correos.cu/rastreador-de-envios/";

package/dist/generated/catalog.js

@@ -9935,7 +9935,8 @@ export const CARRIER_CATALOG = {
         "timezone": "America/Havana",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "correos-cuba",
+            "localClocks": true
         },
         "canaryUrl": "https://www.correos.cu/rastreador-de-envios/",
         "trackingSearchUrl": "https://www.correos.cu/rastreador-de-envios/",

package/dist/generated/registry.js

@@ -109,6 +109,7 @@ import { adapter as correiosBr } from '../carriers/correios-br/adapter.js';
 import { adapter as correoArgentino } from '../carriers/correo-argentino/adapter.js';
 import { adapter as correoUruguayo } from '../carriers/correo-uruguayo/adapter.js';
 import { adapter as correosChile } from '../carriers/correos-chile/adapter.js';
+import { adapter as correosCuba } from '../carriers/correos-cuba/adapter.js';
 import { adapter as correosDeMexico } from '../carriers/correos-de-mexico/adapter.js';
 import { adapter as correosElSalvador } from '../carriers/correos-el-salvador/adapter.js';
 import { adapter as correosExpress } from '../carriers/correos-express/adapter.js';
@@ -727,6 +728,7 @@ export const REGISTRY = {
         "correo-argentino": correoArgentino,
         "correo-uruguayo": correoUruguayo,
         "correos-chile": correosChile,
+        "correos-cuba": correosCuba,
         "correos-de-mexico": correosDeMexico,
         "correos-el-salvador": correosElSalvador,
         "correos-express": correosExpress,
@@ -1373,7 +1375,7 @@ export const REGISTRY = {
         "correos-bolivia": "universal",
         "correos-chile": "correos-chile",
         "correos-costa-rica": "universal",
-        "correos-cuba": "universal",
+        "correos-cuba": "correos-cuba",
         "correos-de-mexico": "correos-de-mexico",
         "correos-el-salvador": "correos-el-salvador",
         "correos-express": "correos-express",

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.684.2"
+    "version": "0.686.0"
   },
   "paths": {
     "/health": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-parcel-scraper",
-  "version": "0.684.2-main.3246",
+  "version": "0.686.0-main.3253",
   "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
   "type": "module",
   "license": "Apache-2.0",

package/dist/carriers/asendia/uk.d.ts

@@ -1,20 +0,0 @@
-import { type TrackingContext } from '../../core/adapter/index.js';
-import type { CarrierResult } from '../../core/result/index.js';
-export declare function normalizeAsendiaUkTrackingNumber(raw: string): string;
-/** The tracker's own result page for one number. */
-export declare function asendiaUkTrackingUrl(rawTrackingNumber: string): string;
-/** Pure projection of the tracker's result page for the requested number. */
-export declare function parseAsendiaUkTrackingPage(html: string, rawTrackingNumber: string): CarrierResult;
-export interface AsendiaUkTrackerOptions {
-    /** Test seam; production uses the global fetch. */
-    fetcher?: typeof fetch;
-    budgetMs?: number;
-    userAgent?: string;
-}
-export declare class AsendiaUkTracker {
-    private readonly fetcher?;
-    private readonly budgetMs;
-    private readonly userAgent;
-    constructor(options?: AsendiaUkTrackerOptions);
-    fetch(rawTrackingNumber: string, context?: TrackingContext): Promise<CarrierResult>;
-}

package/dist/carriers/asendia/uk.js

@@ -1,222 +0,0 @@
-/**
- * Asendia tracking through Asendia UK's own tracker.
- *
- * Protocol provenance:
- * - Asendia UK (formerly wnDirect) runs https://uktracking.asendia.com/
- *   tracking.php on the group's domain; archived shipper links point to it.
- *   The page's form is a plain GET with `ref` and `submit`; the reply is
- *   server-rendered HTML with no challenge, cookie or session. `tracking-pb.php` and `tracking-dpd.php` are skins of the same
- *   search.
- * - It covers parcels Asendia UK carries, whichever post or courier delivers
- *   them, with Asendia's harmonized history. Parcels of the other European
- *   subsidiaries are not on it: their only public tracker is track.asendia.com,
- *   which needs a Turnstile token for every search (see probe.ts).
- * - The search also matches order and other references that the page does not
- *   echo, so a parcel is bound only through its echoed "Tracking Code".
- * - A number the tracker does not know answers HTTP 200 with the notice
- *   "No tracking information found". Parcels drop off the tracker some months
- *   after posting and then get the same notice.
- *
- * Clocks: event times have no offset and do not share one zone (the same scan
- * can be listed twice an hour apart), so they are kept as wall clocks in
- * `local_time`, in page order.
- *
- * Privacy: the destination block's order reference, city, state and postal
- * code are never read; only its country code is.
- */
-import { load } from 'cheerio';
-import { DateTime } from 'luxon';
-import { lookupBudget } from '../../core/adapter/index.js';
-import { carrierIdFromPartner } from '../../core/catalog/hints.js';
-import { ChallengeError, IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
-import { languageStageStatus, wordingStage } from '../../core/status/index.js';
-import { clean, decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
-import { classifyAsendiaUkEvent, isAsendiaUkNotice } from './status.js';
-const PROVIDER = 'Asendia UK';
-const PAGE_URL = 'https://uktracking.asendia.com/tracking.php';
-const DEFAULT_BUDGET_MS = 15_000;
-const MAX_REQUEST_MS = 10_000;
-const MAX_RESPONSE_BYTES = 1_000_000;
-const MAX_EVENTS_TO_INSPECT = 500;
-const MAX_EVENTS_TO_RETURN = 100;
-const NOT_FOUND_NOTICE = 'No tracking information found';
-const HISTORY_HEADINGS = '|Description|Date';
-const ASENDIA_HOST = /(?:^|\.)asendia\.(?:com|co\.uk)$/i;
-/** Letters and digits only, upper-cased: how tracking codes are compared. */
-function comparable(value) {
-    return value.toLocaleUpperCase('en-US').replace(/[^A-Z0-9]/g, '');
-}
-export function normalizeAsendiaUkTrackingNumber(raw) {
-    const value = comparable(clean(raw, 80));
-    if (!/^[A-Z0-9]{6,40}$/.test(value)) {
-        throw new InvalidInputError(PROVIDER, 'Asendia tracking numbers must contain 6 to 40 ASCII letters and digits');
-    }
-    return value;
-}
-/** The tracker's own result page for one number. */
-export function asendiaUkTrackingUrl(rawTrackingNumber) {
-    const url = new URL(PAGE_URL);
-    url.searchParams.set('ref', normalizeAsendiaUkTrackingNumber(rawTrackingNumber));
-    url.searchParams.set('submit', '');
-    return url.toString();
-}
-/** "08:09 Mon 12 Oct 2026" → "2026-10-12T08:09:00", validated without assigning a zone. */
-function wallTime(raw) {
-    const date = /^\d{2}:\d{2} [A-Z][a-z]{2} \d{2} [A-Z][a-z]{2} \d{4}$/.test(raw)
-        ? DateTime.fromFormat(raw, 'HH:mm EEE dd MMM yyyy', { zone: 'UTC', locale: 'en-US' })
-        : null;
-    // Luxon also rejects a weekday that does not match the date.
-    if (!date?.isValid)
-        throw new SchemaError(PROVIDER, 'Asendia UK returned an invalid event date');
-    return date.toFormat("yyyy-MM-dd'T'HH:mm:ss");
-}
-function cellTexts($, cells) {
-    return cells.map((_, cell) => clean($(cell).text(), 500)).get();
-}
-function historyEvents($, parcelRow) {
-    const tables = parcelRow.next('tr').children('td.parcel-right[colspan="2"]').find('table');
-    if (tables.length !== 1)
-        throw new SchemaError(PROVIDER, 'Asendia UK returned no history table');
-    const rows = tables.find('tr');
-    const headings = rows.first().children('th');
-    if (cellTexts($, headings).join('|') !== HISTORY_HEADINGS) {
-        throw new SchemaError(PROVIDER, 'Asendia UK returned an unexpected history table');
-    }
-    const scans = rows.slice(1);
-    if (scans.length > MAX_EVENTS_TO_INSPECT)
-        throw new SchemaError(PROVIDER, 'Asendia UK returned too many events');
-    const events = [];
-    const seen = new Set();
-    for (const row of scans.toArray()) {
-        const cells = $(row).children('td');
-        if (cells.length !== 3 || cells.filter('[colspan], [rowspan]').length) {
-            throw new SchemaError(PROVIDER, 'Asendia UK returned an invalid event row');
-        }
-        const [location, description, date] = cellTexts($, cells);
-        if (!description)
-            throw new SchemaError(PROVIDER, 'Asendia UK returned an empty event');
-        const localTime = wallTime(date);
-        const key = JSON.stringify([localTime, description, location]);
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        const classified = classifyAsendiaUkEvent(description);
-        events.push({
-            local_time: localTime,
-            description,
-            ...(location ? { location: clean(location, 200) } : {}),
-            ...(classified ? { stage: classified.stage } : {}),
-        });
-    }
-    return events;
-}
-/** The destination country code, the one field of the order block that is read. */
-function destinationCountry($, parcelRow) {
-    const order = parcelRow.closest('td.order');
-    const labels = order.children('span.order-field').filter((_, field) => clean($(field).text()) === 'Country Code:');
-    if (labels.length !== 1)
-        return null;
-    const value = clean(labels.next('span.order-data').text(), 8).toUpperCase();
-    return /^[A-Z]{2}$/.test(value) ? value : null;
-}
-function deliveryCarrier(parcelRow) {
-    const links = parcelRow.children('td.parcel-right').find('span.carrier-link a');
-    if (links.length !== 1)
-        return null;
-    const name = clean(links.text(), 80);
-    let href = clean(links.attr('href'), 500);
-    try {
-        // Some partners are linked through Asendia's own portal: name them by the label alone.
-        if (href && ASENDIA_HOST.test(new URL(href).hostname))
-            href = '';
-    }
-    catch {
-        href = '';
-    }
-    const partner = carrierIdFromPartner(name, href);
-    return partner && partner !== 'asendia' ? partner : null;
-}
-/** Pure projection of the tracker's result page for the requested number. */
-export function parseAsendiaUkTrackingPage(html, rawTrackingNumber) {
-    const number = normalizeAsendiaUkTrackingNumber(rawTrackingNumber);
-    const $ = load(html);
-    if (/just a moment|attention required|access denied|captcha/i.test($('title').text())
-        || $('.g-recaptcha, .h-captcha, .cf-turnstile, iframe[src*="captcha"]').length)
-        throw new ChallengeError(PROVIDER);
-    $('script, style, noscript').remove();
-    const results = $('div#tracking-results').first();
-    if ($('form#subForm input[name="ref"]').length !== 1 || results.length !== 1) {
-        throw new SchemaError(PROVIDER, 'Asendia UK returned an unexpected page');
-    }
-    const parcels = results.find('td.parcel-left');
-    const notices = results.find('h3').filter((_, heading) => clean($(heading).text()) === NOT_FOUND_NOTICE);
-    if (!parcels.length) {
-        if (notices.length === 1)
-            throw new NotFoundError(PROVIDER);
-        throw new SchemaError(PROVIDER, 'Asendia UK did not answer the search');
-    }
-    if (notices.length)
-        throw new SchemaError(PROVIDER, 'Asendia UK returned parcels and a not-found notice');
-    const matches = parcels.filter((_, cell) => {
-        const parcel = /^Parcel: \d+ of \d+ Tracking Code: (\S{1,60})$/.exec(clean($(cell).text(), 200));
-        if (!parcel)
-            throw new SchemaError(PROVIDER, 'Asendia UK returned an invalid parcel');
-        return comparable(parcel[1]) === number;
-    });
-    // The search matched another reference, such as an order number: the page
-    // names no parcel this number identifies.
-    if (!matches.length)
-        throw new IndeterminateError(PROVIDER, 'Asendia UK listed parcels under other tracking codes');
-    if (matches.length > 1)
-        throw new SchemaError(PROVIDER, 'Asendia UK listed the tracking code more than once');
-    const parcelRow = matches.closest('tr');
-    const events = historyEvents($, parcelRow);
-    if (!events.length)
-        throw new NoHistoryError(PROVIDER);
-    // Newest first on the page. Clocks are not sorted: they do not share a zone.
-    const current = events.find((event) => !isAsendiaUkNotice(event.description)) ?? events[0];
-    const explicit = classifyAsendiaUkEvent(current.description);
-    const stage = explicit?.stage ?? wordingStage(current.description);
-    const status = explicit?.status ?? languageStageStatus(stage);
-    const country = destinationCountry($, parcelRow);
-    const partner = deliveryCarrier(parcelRow);
-    return {
-        status,
-        ...(explicit ? { current_stage: explicit.stage } : {}),
-        last_status_text: current.description,
-        last_update: null,
-        last_update_local: events[0].local_time,
-        expected_delivery: null,
-        ...(country ? { destination_country: country } : {}),
-        ...(partner ? { delivery_carrier: partner } : {}),
-        events: events.slice(0, MAX_EVENTS_TO_RETURN),
-    };
-}
-export class AsendiaUkTracker {
-    fetcher;
-    budgetMs;
-    userAgent;
-    constructor(options = {}) {
-        this.fetcher = options.fetcher;
-        this.budgetMs = options.budgetMs ?? DEFAULT_BUDGET_MS;
-        if (!Number.isFinite(this.budgetMs) || this.budgetMs <= 0)
-            throw new TypeError('Asendia UK budget must be positive');
-        this.userAgent = userAgentOf(options.userAgent);
-    }
-    async fetch(rawTrackingNumber, context = {}) {
-        const trackingNumber = normalizeAsendiaUkTrackingNumber(rawTrackingNumber);
-        const budget = lookupBudget(context, this.budgetMs, PROVIDER);
-        const url = asendiaUkTrackingUrl(trackingNumber);
-        const { bytes } = await fetchBounded(url, {
-            signal: budget.signal,
-            headers: { Accept: 'text/html', 'User-Agent': this.userAgent },
-        }, {
-            provider: 'Asendia UK tracker', timeoutMs: Math.min(MAX_REQUEST_MS, budget.remainingMs()),
-            maxBytes: MAX_RESPONSE_BYTES, fetcher: this.fetcher,
-        });
-        const result = parseAsendiaUkTrackingPage(decodeText(bytes), trackingNumber);
-        result.tracking_url = url;
-        result.tracking_source = 'rendered-page';
-        return result;
-    }
-}