universal-parcel-scraper 0.49.0-main.533 → 0.49.0-main.541

package/NOTICE

@@ -12,4 +12,5 @@ The places gazetteer includes GeoNames data (https://www.geonames.org),
 licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).
 Facility coordinates include OpenStreetMap data (https://www.openstreetmap.org/copyright),
 licensed under the Open Database License. Natural Earth country label points
-(https://www.naturalearthdata.com) are public domain.
+(https://www.naturalearthdata.com) and OurAirports airports
+(https://ourairports.com/data/) are public domain.

package/README.md

@@ -149,7 +149,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 2,725 such statuses, each filed under one stage.
+The carrier folders record 2,744 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/dist/app.d.ts

@@ -1,9 +1,10 @@
 /**
  * Helpers shaped for the parcel app this package was extracted from: its
  * parcel view, carrier-name hints for provider results, the clock helpers
- * its sync uses, carrier scan-identity policies, and the country a scan's
- * location names. They change with that app and carry no stability promise;
- * the tracking contract is the other entry points.
+ * its sync uses, carrier scan-identity policies, what a carrier's status map
+ * says about a scan the app reviews, and the country a scan's location
+ * names. They change with that app and carry no stability promise; the
+ * tracking contract is the other entry points.
  */
 export * from './core/catalog/parcel.js';
 export * from './core/catalog/hints.js';
@@ -11,4 +12,6 @@ export * from './core/time/result.js';
 export { sameInstantIdentityPolicy, type SameInstantIdentityPolicy, type SameInstantScan } from './core/catalog/eventIdentity.js';
 export { universalCarrierHints } from './providers/shared/hints.js';
 export { recognitionAskedCarriers } from './core/catalog/recognition.js';
+export { statusMapAnswer, type ObservedStatus, type StatusMapAnswer } from './core/catalog/statusMaps.js';
+export { normalizeStatusWording } from './core/status/statusMap.js';
 export { countryFlag, countryName, trackingLocationCountry, trackingPlace, type TrackingPlace } from './places/trackingLocation.js';

package/dist/app.js

@@ -1,9 +1,10 @@
 /**
  * Helpers shaped for the parcel app this package was extracted from: its
  * parcel view, carrier-name hints for provider results, the clock helpers
- * its sync uses, carrier scan-identity policies, and the country a scan's
- * location names. They change with that app and carry no stability promise;
- * the tracking contract is the other entry points.
+ * its sync uses, carrier scan-identity policies, what a carrier's status map
+ * says about a scan the app reviews, and the country a scan's location
+ * names. They change with that app and carry no stability promise; the
+ * tracking contract is the other entry points.
  */
 export * from './core/catalog/parcel.js';
 export * from './core/catalog/hints.js';
@@ -11,4 +12,6 @@ export * from './core/time/result.js';
 export { sameInstantIdentityPolicy } from './core/catalog/eventIdentity.js';
 export { universalCarrierHints } from './providers/shared/hints.js';
 export { recognitionAskedCarriers } from './core/catalog/recognition.js';
+export { statusMapAnswer } from './core/catalog/statusMaps.js';
+export { normalizeStatusWording } from './core/status/statusMap.js';
 export { countryFlag, countryName, trackingLocationCountry, trackingPlace } from './places/trackingLocation.js';

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

@@ -1,6 +1,9 @@
 import { type ClassifiedWording } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
 export declare function isChronopostNotification(label: string): boolean;
 /** The courier's drop-off scan, which can follow the pickup point's own arrival scan. */
 export declare function isPickupDropOff(code: string, label: string): boolean;
 /** Partner events can reuse codes; the observed wording must agree with the code. */
 export declare function chronopostStage(code: string, label: string): ClassifiedWording;
+/** What the map says about one scan: a code whose observed wording it carries. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/chronopost/status.js

@@ -1,4 +1,5 @@
 import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
 const observed = new Map([
     ['DC', { label: "Colis en cours de préparation chez l'expéditeur", stage: 'registered' }],
     ['DB', { label: "Colis déposé par l'expéditeur", stage: 'accepted' }],
@@ -14,8 +15,9 @@ const observed = new Map([
     ['P', { label: "Echec de livraison suite à l'absence du destinataire.", stage: 'failed_attempt' }],
     ['SK', { label: "Colis en attente d'informations complémentaires de votre part", stage: 'exception' }],
 ]);
+const NOTIFICATION = 'Destinataire informé par SMS ou mail';
 export function isChronopostNotification(label) {
-    return label === 'Destinataire informé par SMS ou mail';
+    return label === NOTIFICATION;
 }
 /** The courier's drop-off scan, which can follow the pickup point's own arrival scan. */
 export function isPickupDropOff(code, label) {
@@ -28,3 +30,14 @@ export function chronopostStage(code, label) {
         return { stage: known.stage, source: 'carrier_map' };
     return classifyWording(label, 'pending');
 }
+/** What the map says about one scan: a code whose observed wording it carries. */
+export const statusMap = {
+    stage: (code, wording) => {
+        const known = code ? observed.get(code) : undefined;
+        return known && normalizeStatusWording(known.label) === wording ? known.stage : undefined;
+    },
+    gaps: [{
+            code: 'SM', wording: normalizeStatusWording(NOTIFICATION),
+            note: 'A notice to the recipient, not a scan: it keeps the stage the parcel already had.',
+        }],
+};

package/dist/carriers/dhl-express/adapter.js

@@ -4,12 +4,12 @@ import { accepted, lookupBudget, recognizeFromBrowserLookup, recognizeFromLookup
 import { isValidDhlExpressWaybill } from '../../core/detection/numericChecksums.js';
 import { BudgetExceededError, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, RateLimitedError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
 import { runSteps } from '../../core/runner/index.js';
-import { classifyWording } from '../../core/status/index.js';
 import { explicitOffsetTime, zonedTime } from '../../core/time/index.js';
 import { clean, parseJsonBytes } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { facilityZone } from './clock.js';
 import { mobileTracking } from './mobile.js';
+import { dhlExpressStage } from './status.js';
 const PROVIDER = 'DHL Express';
 const BROWSER_API = 'https://www.dhl.com/utapi';
 const MAX_BYTES = 1_000_000;
@@ -42,22 +42,6 @@ function clock(date, time, location) {
     const instant = zone ? zonedTime(wall, CLOCK_FORMAT, zone, { locale: 'en' }) : null;
     return instant ? { time: instant.iso } : { local_time: local.toFormat("yyyy-MM-dd'T'HH:mm:ss") };
 }
-function stage(description) {
-    const text = description.toLowerCase();
-    if (text === 'delivered')
-        return { stage: 'delivered', source: 'carrier_map' };
-    if (text === 'shipment is out with courier for delivery')
-        return { stage: 'out_for_delivery', source: 'carrier_map' };
-    if (text.startsWith('delivery attempted'))
-        return { stage: 'failed_attempt', source: 'carrier_map' };
-    if (text === 'shipment is on hold')
-        return { stage: 'exception', source: 'carrier_map' };
-    if (text === 'shipment picked up')
-        return { stage: 'accepted', source: 'carrier_map' };
-    if (text.startsWith('clearance processing') || text.startsWith('customs clearance'))
-        return { stage: 'customs', source: 'carrier_map' };
-    return classifyWording(description, 'pending');
-}
 /** Public DHL web tracking: bind both the waybill and the Express division. */
 export function parseUnified(payload, raw) {
     const number = normalizeNumber(raw);
@@ -80,7 +64,7 @@ export function parseUnified(payload, raw) {
         if (!isRecord(row) || typeof row.description !== 'string' || !row.description.trim())
             throw new SchemaError(PROVIDER, 'DHL returned an invalid event');
         const description = row.statusCode === 'delivered' ? 'Delivered' : clean(row.description).slice(0, 1000);
-        const mapped = stage(description);
+        const mapped = dhlExpressStage(description);
         const time = typeof row.timestamp === 'string' && /(?:Z|[+-](?:[01]\d|2[0-3]):?[0-5]\d)$/i.test(row.timestamp)
             ? explicitOffsetTime(row.timestamp)?.iso : undefined;
         const address = isRecord(row.location) && isRecord(row.location.address) ? row.location.address : {};
@@ -124,7 +108,7 @@ export function parse(payload, raw) {
         if (!isRecord(row) || typeof row.description !== 'string' || !row.description.trim())
             throw new SchemaError(PROVIDER, 'DHL Express returned an invalid checkpoint');
         const description = clean(row.description).slice(0, 1000);
-        const mapped = stage(description);
+        const mapped = dhlExpressStage(description);
         const location = typeof row.location === 'string' ? clean(row.location).slice(0, 300) : '';
         return { description, ...clock(row.date, row.time, location), ...(typeof row.location === 'string' ? { location } : {}),
             stage: mapped.stage, stage_source: mapped.source };

package/dist/carriers/dhl-express/status.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DHL Express checkpoint wording. Both the guest mobile API and the public
+ * web tracking send DHL's English checkpoint sentences, several of which end
+ * with the facility ("Processed at PARIS - FRANCE"), so those are matched on
+ * their fixed start. Other wording goes to the shared classifier.
+ */
+import { type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The checkpoint's stage from DHL's own wording, if the wording is one of DHL's checkpoints. */
+export declare function dhlExpressCheckpointStage(description: string): Stage | undefined;
+export declare function dhlExpressStage(description: string): {
+    stage: Stage;
+    source: string;
+};
+/** What the map says about one scan: the web feed's codes are not read, only the checkpoint wording. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/dhl-express/status.js

@@ -0,0 +1,38 @@
+/**
+ * DHL Express checkpoint wording. Both the guest mobile API and the public
+ * web tracking send DHL's English checkpoint sentences, several of which end
+ * with the facility ("Processed at PARIS - FRANCE"), so those are matched on
+ * their fixed start. Other wording goes to the shared classifier.
+ */
+import { classifyWording } from '../../core/status/index.js';
+const EXACT = new Map([
+    ['shipment information received', 'registered'],
+    ['shipment picked up', 'accepted'],
+    ['shipment is in transit to destination', 'in_transit'],
+    ['shipment is out with courier for delivery', 'out_for_delivery'],
+    ['shipment is on hold', 'exception'],
+    ['delivered', 'delivered'],
+]);
+const PREFIXES = [
+    ['delivery attempted', 'failed_attempt'],
+    ['clearance processing', 'customs'],
+    ['customs clearance', 'customs'],
+    ['processed at ', 'in_transit'],
+    ['arrived at dhl sort facility', 'in_transit'],
+    ['arrived at dhl delivery facility', 'in_transit'],
+    ['shipment has departed from a dhl facility', 'in_transit'],
+];
+/** The checkpoint's stage from DHL's own wording, if the wording is one of DHL's checkpoints. */
+export function dhlExpressCheckpointStage(description) {
+    const text = description.toLowerCase();
+    return EXACT.get(text) ?? PREFIXES.find(([start]) => text.startsWith(start))?.[1];
+}
+export function dhlExpressStage(description) {
+    const stage = dhlExpressCheckpointStage(description);
+    return stage ? { stage, source: 'carrier_map' } : classifyWording(description, 'pending');
+}
+/** What the map says about one scan: the web feed's codes are not read, only the checkpoint wording. */
+export const statusMap = {
+    stage: (_code, wording) => dhlExpressCheckpointStage(wording),
+    gaps: [],
+};

package/dist/carriers/dhl-express/statuses.json

@@ -42,6 +42,45 @@
       "stage": "in_transit",
       "confirmedBy": "live",
       "firstSeen": "2026-10-05"
+    },
+    {
+      "wording": "Shipment information received",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05"
+    },
+    {
+      "wording": "Processed at",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05",
+      "note": "Followed by the facility, as in \"Processed at <city> - <country>\"; matched on its start."
+    },
+    {
+      "wording": "Arrived at DHL Sort Facility",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05",
+      "note": "Followed by the facility; matched on its start."
+    },
+    {
+      "wording": "Arrived at DHL Delivery Facility",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05",
+      "note": "Followed by the facility; matched on its start."
+    },
+    {
+      "wording": "Shipment has departed from a DHL facility",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05",
+      "note": "Followed by the facility; matched on its start."
     }
   ]
 }

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

@@ -13,8 +13,10 @@
  * `PARCEL_HANDED`, `IN_TRANSIT` and `AT_DELIVERY_CENTER` deliberately yield no
  * stage: they move the result status to `in_transit` but leave the event
  * unmapped so the sync's classifier records the wording for review instead of
- * this map inventing a milestone. Scan codes are mapped only where a live
- * lookup paired them with an enumeration value (see `scanStage`).
+ * this map inventing a milestone. Scan codes are mapped where a live lookup
+ * paired them with an enumeration value, or where DPD's own label names one
+ * movement inside its network (see `scanStage`). `statusMap` lists the codes
+ * and labels left unmapped on purpose.
  *
  * Provenance: the enumeration, the scan codes and their English labels are
  * what the myDPD guest API returns for Swiss consignee lookups; the wording
@@ -22,6 +24,7 @@
  */
 import type { CarrierStatus } from '../../core/result/index.js';
 import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 /** English labels for the guest API enumeration, used when the API sends no translation. */
 export declare const API_LABELS: Record<string, string>;
 /** Wording classifier for the rendered page, which carries no status codes. */
@@ -37,3 +40,10 @@ export declare function scanStage(code: string): Stage | null;
  * with no place. Paperwork, not a movement of the parcel.
  */
 export declare const PROOF_OF_DELIVERY_SCAN = "DEYY";
+/**
+ * What the map says about one scan. A scan code or an enumeration value is all
+ * it reads: the rendered page's prose has no code and gets no stage here, and
+ * a code staged by its enumeration twin depends on the reply, so it is not
+ * answered by the code alone.
+ */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/dpd/status.js

@@ -73,6 +73,8 @@ export function apiStage(description) {
  * `parcelEvents[].eventType` scan codes. On 2026-09-26 a verified lookup
  * listed ORI, DLI, DLO and DEY at the same wall clock as the `parcelHistory`
  * enumeration named beside them. CCO has no twin; it ends customs clearance.
+ * HUI, HUS, DLS and DLQ are the hub and delivery-depot scans a verified
+ * domestic history lists between ORI and DLO, each labelled with one movement.
  * ORI ("Origin depot - In") stays unmapped like its twin PARCEL_HANDED: the
  * result stage then comes from the same wording as the scan's, and an import
  * that cleared customs does not step back to accepted. Other codes stay
@@ -80,7 +82,11 @@ export function apiStage(description) {
  */
 const SCAN_STAGES = {
     CCO: 'in_transit', // "Customs - Out"
+    HUI: 'in_transit', // "Your parcel arrived at our hub"
+    HUS: 'in_transit', // "Your parcel is ready to be transported to our next premises"
     DLI: 'in_transit', // "Destination depot - Inbound", twin AT_DELIVERY_CENTER
+    DLS: 'in_transit', // "Your parcel has been sorted and is ready for delivery"
+    DLQ: 'in_transit', // "Your parcel is at our delivery depot, it will soon be on its way"
     DLO: 'out_for_delivery', // "Destination depot - Out for delivery", twin PARCEL_OUT_FOR_DELIVERY
     DEY: 'delivered', // "Delivery - Delivered", twin DELIVERED
 };
@@ -93,3 +99,27 @@ export function scanStage(code) {
  * with no place. Paperwork, not a movement of the parcel.
  */
 export const PROOF_OF_DELIVERY_SCAN = 'DEYY';
+const MOVES_WITHOUT_MILESTONE = "DPD's map leaves it unmapped on purpose: it moves the parcel in transit without a milestone of its own.";
+/**
+ * What the map says about one scan. A scan code or an enumeration value is all
+ * it reads: the rendered page's prose has no code and gets no stage here, and
+ * a code staged by its enumeration twin depends on the reply, so it is not
+ * answered by the code alone.
+ */
+export const statusMap = {
+    stage: (code) => (code ? scanStage(code) ?? apiStage(code) : null) ?? undefined,
+    gaps: [
+        { code: 'PARCEL_HANDED', note: MOVES_WITHOUT_MILESTONE },
+        { code: 'IN_TRANSIT', note: MOVES_WITHOUT_MILESTONE },
+        { code: 'AT_DELIVERY_CENTER', note: MOVES_WITHOUT_MILESTONE },
+        { code: 'ORI', note: "DPD's map leaves it unmapped on purpose, like its twin PARCEL_HANDED, so an import that cleared customs does not step back to accepted." },
+        { wording: 'parcel handed to dpd', note: "The label of PARCEL_HANDED, which DPD's map leaves unmapped on purpose." },
+        { wording: 'your parcel is on its way', note: "The label of IN_TRANSIT, which DPD's map leaves unmapped on purpose." },
+        { wording: 'at delivery center', note: "The label of AT_DELIVERY_CENTER, which DPD's map leaves unmapped on purpose." },
+        { code: 'SPL', note: 'Worded like IN_TRANSIT and seen on both sides of the origin depot, so it names no movement of its own.' },
+        { code: 'OTHER', note: "The guest API's catch-all, which names no movement." },
+        { code: 'SPE', note: 'A delivery estimate or a changed delivery day, not a scan.' },
+        { code: 'MSDLO', note: 'The notice DPD emailed for the delivery round, not a scan.' },
+        { code: 'MIDLI', note: "The recipient's delivery instruction, not a scan." },
+    ],
+};

package/dist/carriers/dpd/statuses.json

@@ -104,6 +104,32 @@
       "firstSeen": "2026-09-26",
       "note": "Scan code (Origin depot - In), at the same instant as PARCEL_HANDED. Unmapped like its twin, so the event and the result stage both come from this wording; a stage here would disagree with the result stage and put accepted after customs on imports."
     },
+    {
+      "code": "SPL",
+      "wording": "Your parcel is on its way",
+      "language": "en",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05",
+      "note": "Scan code worded like IN_TRANSIT, seen both before and after ORI. Unmapped like IN_TRANSIT: it names no milestone of its own."
+    },
+    {
+      "code": "HUI",
+      "wording": "Your parcel arrived at our hub",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-07",
+      "note": "Scan code: arrival at a hub."
+    },
+    {
+      "code": "HUS",
+      "wording": "Your parcel is ready to be transported to our next premises",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-07",
+      "note": "Scan code: the hub sends the parcel on."
+    },
     {
       "code": "DLI",
       "wording": "Your parcel arrived at our delivery depot",
@@ -113,6 +139,24 @@
       "firstSeen": "2026-09-26",
       "note": "Scan code (Destination depot - Inbound), at the same instant as AT_DELIVERY_CENTER."
     },
+    {
+      "code": "DLS",
+      "wording": "Your parcel has been sorted and is ready for delivery",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-07",
+      "note": "Scan code: sorted at the delivery depot, before DLO."
+    },
+    {
+      "code": "DLQ",
+      "wording": "Your parcel is at our delivery depot, it will soon be on its way",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-07",
+      "note": "Scan code: waiting at the delivery depot, before DLO."
+    },
     {
       "code": "DLO",
       "wording": "Your parcel is out for delivery",
@@ -139,6 +183,30 @@
       "confirmedBy": "live",
       "firstSeen": "2026-09-26",
       "note": "Scan code (Delivery - Proof of delivery), minutes after DEY with no place. Dropped when a delivery scan is listed or the enumeration is not DELIVERED; staged delivered only when it is the sole delivery evidence of a delivered parcel. Its podUrl is never kept."
+    },
+    {
+      "code": "SPE",
+      "wording": "Your parcel is estimated to be delivered on: <date>",
+      "language": "en",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-07",
+      "note": "A delivery estimate or a changed delivery day, not a scan; the date follows the colon."
+    },
+    {
+      "code": "MSDLO",
+      "wording": "We informed you via email that your parcel will be delivered on <date>",
+      "language": "en",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-06",
+      "note": "The notice DPD emailed for the delivery round, not a scan."
+    },
+    {
+      "code": "MIDLI",
+      "wording": "Your parcel will be delivered to a safe place according to your instructions",
+      "language": "en",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-05",
+      "note": "The recipient's delivery instruction, not a scan."
     }
   ]
 }

package/dist/carriers/la-poste/status.d.ts

@@ -17,6 +17,7 @@
  */
 import type { CarrierStatus } from '../../core/result/index.js';
 import { type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 /** Progress-bar groups, the coarse key every event carries. */
 export declare const GROUP_STATUSES: Map<string, CarrierStatus>;
 /**
@@ -25,7 +26,9 @@ export declare const GROUP_STATUSES: Map<string, CarrierStatus>;
  * être livré ce jour ... sera mis en livraison au plus tôt", which reads as a
  * future delivery round, so the code decides. `DO2` is the customs release,
  * whose "il sera livré contre paiement" otherwise reads as an announcement, and
- * `RE1` the decision to send the item back.
+ * `RE1` the decision to send the item back. `MD1` under `DISTOU` is the morning
+ * sort into the delivery round: "nous le préparons pour le mettre en
+ * livraison" is followed the same day by the delivery or a failed attempt.
  */
 export declare const CODE_STATUSES: Map<string, CarrierStatus>;
 /** Lowercase, accent-free form used for every wording comparison. */
@@ -35,3 +38,10 @@ export declare function labelStatus(label: string, hasEvents: boolean): CarrierS
 export declare function eventStatus(group: string, code: string, label: string, hasEvents: boolean): CarrierStatus;
 /** The stage for one event; returns and pickup readiness are recognized before the status. */
 export declare function eventStage(group: string, code: string, label: string): Stage;
+/**
+ * What the map says about one scan. Its provider code is `GROUP/CODE`, or the
+ * group or the code alone. The answer covers the groups and codes the map
+ * reads; under keys it does not know, a scan's stage comes from its wording
+ * and a default, which stay open for review.
+ */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/la-poste/status.js

@@ -1,5 +1,5 @@
 import { languageStageStatus, trackingLanguageStage } from '../../core/status/index.js';
-import { clean } from '../../core/transport/index.js';
+import { clean } from '../../core/transport/text.js';
 /** Progress-bar groups, the coarse key every event carries. */
 export const GROUP_STATUSES = new Map([
     ['EXPANN', 'pending'],
@@ -20,7 +20,9 @@ export const GROUP_STATUSES = new Map([
  * être livré ce jour ... sera mis en livraison au plus tôt", which reads as a
  * future delivery round, so the code decides. `DO2` is the customs release,
  * whose "il sera livré contre paiement" otherwise reads as an announcement, and
- * `RE1` the decision to send the item back.
+ * `RE1` the decision to send the item back. `MD1` under `DISTOU` is the morning
+ * sort into the delivery round: "nous le préparons pour le mettre en
+ * livraison" is followed the same day by the delivery or a failed attempt.
  */
 export const CODE_STATUSES = new Map([
     ['DR1', 'pending'],
@@ -85,10 +87,6 @@ export function eventStatus(group, code, label, hasEvents) {
     const described = labelStatus(label, false);
     if (described === 'exception')
         return described;
-    if (code.toUpperCase() === 'MD1'
-        && comparable(label) === 'votre envoi est sur son site de distribution. nous le preparons pour le mettre en livraison.') {
-        return 'in_transit';
-    }
     return CODE_STATUSES.get(code.toLocaleUpperCase('en-US'))
         ?? GROUP_STATUSES.get(group.toLocaleUpperCase('en-US'))
         ?? (described !== 'unknown' ? described : labelStatus(label, hasEvents));
@@ -130,3 +128,21 @@ export function eventStage(group, code, label) {
         return 'accepted';
     return 'in_transit';
 }
+/** The codes the map reads on their own, beside those of `CODE_STATUSES`. */
+const KNOWN_CODES = new Set([...CODE_STATUSES.keys(), PICKUP_CODE, CUSTOMS_ENTRY_CODE, ...ACCEPTANCE_CODES]);
+/**
+ * What the map says about one scan. Its provider code is `GROUP/CODE`, or the
+ * group or the code alone. The answer covers the groups and codes the map
+ * reads; under keys it does not know, a scan's stage comes from its wording
+ * and a default, which stay open for review.
+ */
+export const statusMap = {
+    stage: (providerCode, wording) => {
+        const keys = (providerCode ?? '').toLocaleUpperCase('en-US').split('/');
+        const single = keys.length === 1 ? keys[0] : null;
+        const group = single === null ? keys[0] : KNOWN_CODES.has(single) ? '' : single;
+        const code = single === null ? keys.slice(1).join('/') : KNOWN_CODES.has(single) ? single : '';
+        return GROUP_STATUSES.has(group) || KNOWN_CODES.has(code) ? eventStage(group, code, wording) : undefined;
+    },
+    gaps: [],
+};

package/dist/carriers/la-poste/statuses.json

@@ -159,14 +159,23 @@
       "firstSeen": "2026-09-20",
       "note": "Resolved by the shared classifier; \"sont terminees\" is the release and stays in_transit."
     },
+    {
+      "wording": "Votre colis est sur son site de distribution. Nous le préparons pour le mettre en livraison.",
+      "language": "fr",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live",
+      "firstSeen": "2026-09-10",
+      "code": "MD1",
+      "note": "DISTOU/MD1, the sort into the morning's round: every live history shows the delivery or a failed attempt the same day, with no scan between."
+    },
     {
       "wording": "Votre envoi est sur son site de distribution. Nous le préparons pour le mettre en livraison.",
       "language": "fr",
-      "stage": "in_transit",
-      "confirmedBy": "fixture",
-      "firstSeen": "2026-10-04",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live",
+      "firstSeen": "2026-09-10",
       "code": "MD1",
-      "note": "DISTOU/MD1 also covers preparation before the delivery round."
+      "note": "The tracked-letter wording of the same DISTOU/MD1 scan."
     },
     {
       "code": "PB1",

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

@@ -8,6 +8,7 @@
  */
 import type { CarrierStatus } from '../../core/result/index.js';
 import type { Stage } from '../../generated/catalog.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 /** Codes that mean the parcel reached its recipient. */
 export declare const POSTLOGISTICS_DELIVERED_CODES: readonly ["DEL", "DLV", "POD", "SIG"];
 /** The code that means the shipment is announced but not yet moving. */
@@ -18,3 +19,5 @@ export declare const POSTLOGISTICS_IMAGE_CODE = "IMG";
 export declare function postlogisticsStage(code: string): Stage | undefined;
 /** The shipment status the newest history code implies. */
 export declare function postlogisticsStatus(code: string): CarrierStatus;
+/** What the map says about one scan, by its code. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/postlogistics/status.js

@@ -25,3 +25,8 @@ export function postlogisticsStatus(code) {
         return 'pending';
     return 'in_transit';
 }
+/** What the map says about one scan, by its code. */
+export const statusMap = {
+    stage: (code) => (code ? postlogisticsStage(code) : undefined),
+    gaps: [{ code: POSTLOGISTICS_IMAGE_CODE, note: 'A picture taken with a scan, not a movement of the parcel.' }],
+};

package/dist/carriers/swiss-post/status.d.ts

@@ -12,6 +12,7 @@
  */
 import type { CarrierStatus } from '../../core/result/index.js';
 import type { Stage } from '../../generated/catalog.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 /** Shipment-level `globalStatus` → status. The event codes below refine it. */
 export declare const STATUS_MAP: Map<string, CarrierStatus>;
 /** Wording for codes the translation service does not resolve. */
@@ -32,3 +33,9 @@ export declare const STAGE_STATUS: Record<string, CarrierStatus>;
 export declare function swissPostEventStage(eventCode: string, subEventId?: string): Stage | undefined;
 /** The stage the shipment-level `globalStatus` implies, used when the newest scan has none. */
 export declare const GLOBAL_STATUS_STAGE: Record<string, Stage>;
+/**
+ * What the map says about one scan. The map reads the last segment of the
+ * dotted event code. A revoked scan's wording ends with its sub-event's label,
+ * "— Revocation", and takes no stage.
+ */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/swiss-post/status.js

@@ -108,3 +108,13 @@ export const GLOBAL_STATUS_STAGE = {
     RETURNED: 'returned',
     CUSTOMS: 'customs',
 };
+/**
+ * What the map says about one scan. The map reads the last segment of the
+ * dotted event code. A revoked scan's wording ends with its sub-event's label,
+ * "— Revocation", and takes no stage.
+ */
+export const statusMap = {
+    codeKey: (code) => code.split('.').at(-1) ?? code,
+    stage: (code, wording) => (code && !wording.includes('— revocation') ? swissPostEventStage(code) : undefined),
+    gaps: [{ code: '9112', note: 'An enquiry note, not a movement: the shipment summary decides the stage.' }],
+};

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

@@ -1,3 +1,6 @@
 import type { ClassifiedStatus } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 export declare function tntFranceStatus(text: string): ClassifiedStatus | undefined;
 export declare function tntExpressStatus(code: string): ClassifiedStatus | undefined;
+/** What the map says about one scan: tnt.com scans carry a code, TNT France's rows only wording. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/tnt/status.js

@@ -26,6 +26,7 @@ const EXPRESS_CODES = {
     RC: { status: 'in_transit', stage: 'in_transit' },
     OD: { status: 'out_for_delivery', stage: 'out_for_delivery' },
     OK: { status: 'delivered', stage: 'delivered' },
+    RES: { status: 'delivered', stage: 'delivered' },
     LP: { status: 'exception', stage: 'exception' },
     MR: { status: 'exception', stage: 'exception' },
     WL: { status: 'exception', stage: 'exception' },
@@ -34,3 +35,8 @@ const EXPRESS_CODES = {
 export function tntExpressStatus(code) {
     return Object.hasOwn(EXPRESS_CODES, code) ? EXPRESS_CODES[code] : undefined;
 }
+/** What the map says about one scan: tnt.com scans carry a code, TNT France's rows only wording. */
+export const statusMap = {
+    stage: (code, wording) => (code ? tntExpressStatus(code) : tntFranceStatus(wording))?.stage,
+    gaps: [],
+};