universal-parcel-scraper 0.451.1-main.2245 → 0.453.0-main.2249

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 **485 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **487 dedicated adapters** and **5 universal fallbacks**
 
 <sub>772 catalog entries · 134 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 14,854 such statuses, each filed under one stage.
+The carrier folders record 14,875 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

@@ -19255,7 +19255,8 @@
     "timezone": "Asia/Karachi",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "m-and-p",
+      "recognitionRank": 746
     },
     "canaryUrl": "https://www.mulphilog.com/",
     "trackingUrlTemplate": "https://www.mulphilog.com/tracking/{trackingNumber}",
@@ -23673,7 +23674,8 @@
     "timezone": "Asia/Karachi",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "postex",
+      "recognitionRank": 745
     },
     "canaryUrl": "https://postex.pk/tracking",
     "trackingUrlTemplate": "https://postex.pk/tracking?cn={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 772,
-  "activeAdapters": 485,
+  "activeAdapters": 487,
   "countries": 134,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -11295,6 +11295,35 @@
       "delhivery"
     ]
   },
+  {
+    "input": "10388820331824",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dpd-fr",
+      "dpd",
+      "ciblex",
+      "seur",
+      "brt",
+      "delhivery",
+      "dhl-ecommerce-uk",
+      "dpd-be",
+      "dpd-de",
+      "dpd-nl",
+      "dpd-uk",
+      "xpressbees"
+    ],
+    "preferred": [
+      "dpd-fr"
+    ],
+    "asked": [
+      "seur",
+      "brt",
+      "ciblex",
+      "dhl-ecommerce-uk",
+      "delhivery"
+    ]
+  },
   {
     "input": "1040200044620",
     "carrier": "unknown",
@@ -11937,6 +11966,35 @@
       "dhl-ecommerce-es"
     ]
   },
+  {
+    "input": "10740270012959",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dpd-fr",
+      "dpd",
+      "ciblex",
+      "seur",
+      "brt",
+      "delhivery",
+      "dhl-ecommerce-uk",
+      "dpd-be",
+      "dpd-de",
+      "dpd-nl",
+      "dpd-uk",
+      "xpressbees"
+    ],
+    "preferred": [
+      "dpd-fr"
+    ],
+    "asked": [
+      "seur",
+      "brt",
+      "ciblex",
+      "dhl-ecommerce-uk",
+      "delhivery"
+    ]
+  },
   {
     "input": "10764000276716",
     "carrier": "unknown",
@@ -24336,6 +24394,31 @@
       "colis-prive"
     ]
   },
+  {
+    "input": "21294400207049",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dpd",
+      "ciblex",
+      "seur",
+      "brt",
+      "delhivery",
+      "dhl-ecommerce-uk",
+      "dpd-be",
+      "dpd-de",
+      "dpd-nl",
+      "dpd-uk",
+      "nova-poshta"
+    ],
+    "asked": [
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de",
+      "seur"
+    ]
+  },
   {
     "input": "2130900025704001IVC001BS",
     "carrier": "nz-post",
@@ -26774,6 +26857,30 @@
       "heppner"
     ]
   },
+  {
+    "input": "24579690103460",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dpd",
+      "ciblex",
+      "seur",
+      "brt",
+      "delhivery",
+      "dhl-ecommerce-uk",
+      "dpd-be",
+      "dpd-de",
+      "dpd-nl",
+      "dpd-uk"
+    ],
+    "asked": [
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de",
+      "seur"
+    ]
+  },
   {
     "input": "24622447660SE",
     "carrier": "postnord",
@@ -44061,6 +44168,18 @@
     "confidence": "none",
     "candidates": []
   },
+  {
+    "input": "556656610052013",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "brt",
+      "yunda"
+    ],
+    "asked": [
+      "brt"
+    ]
+  },
   {
     "input": "558 265 735",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -14670,7 +14670,8 @@ var ze = {
 		timezone: "Asia/Karachi",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "m-and-p",
+			recognitionRank: 746
 		},
 		canaryUrl: "https://www.mulphilog.com/",
 		trackingUrlTemplate: "https://www.mulphilog.com/tracking/{trackingNumber}",
@@ -17926,7 +17927,8 @@ var ze = {
 		timezone: "Asia/Karachi",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "postex",
+			recognitionRank: 745
 		},
 		canaryUrl: "https://postex.pk/tracking",
 		trackingUrlTemplate: "https://postex.pk/tracking?cn={trackingNumber}",
@@ -29571,6 +29573,7 @@ var xl = {
 	logistiq: 768,
 	logoix: 869,
 	"loomis-express": 285,
+	"m-and-p": 746,
 	"m-one": 825,
 	mailamericas: 985,
 	mainfreight: 923,
@@ -29622,6 +29625,7 @@ var xl = {
 	"posta-slovenije": 130,
 	"posta-srbije": 110,
 	"poste-italiane": 900,
+	postex: 745,
 	posti: 710,
 	postlogistics: 700,
 	postnord: 510,

package/dist/carriers/m-and-p/adapter.d.ts

@@ -0,0 +1,16 @@
+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's page, which the server renders for the consignment number that ends its path. */
+export declare const M_AND_P_TRACKING = "https://www.mulphilog.com/tracking/";
+export declare class MAndPTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    private read;
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/m-and-p/adapter.js

@@ -0,0 +1,48 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { 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 { M_AND_P_MAX_BYTES, normalizeMAndPNumber, parseMAndP, PROVIDER } from './parser.js';
+/** The tracker's page, which the server renders for the consignment number that ends its path. */
+export const M_AND_P_TRACKING = 'https://www.mulphilog.com/tracking/';
+const REDIRECTS = [301, 302, 303, 307, 308];
+const GONE = [404, 410];
+const DEFAULT_BUDGET_MS = 20_000;
+export class MAndPTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async read(number, signal, timeoutMs) {
+        const { response, bytes } = await fetchBounded(`${M_AND_P_TRACKING}${number}`, { method: 'GET', signal,
+            headers: { Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER,
+            timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: M_AND_P_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher,
+            allowHttpStatuses: [...REDIRECTS, ...GONE] });
+        // The tracker answers a known and an unknown number alike with HTTP 200.
+        if (REDIRECTS.includes(response.status))
+            throw new TransportError(PROVIDER, 'M&P redirected its tracker', { status: response.status });
+        if (GONE.includes(response.status))
+            throw new TransportError(PROVIDER, 'M&P tracker is unavailable', { status: response.status });
+        return parseMAndP(decodeText(bytes), number);
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeMAndPNumber(raw);
+        // A read that fails to reach M&P, or hangs, is sent once more: the first
+        // try gets half of the budget.
+        return runSteps({ carrier: 'm-and-p', budgetMs: context.budgetMs ?? DEFAULT_BUDGET_MS, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => this.read(number, signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => this.read(number, signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new MAndPTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'm-and-p', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeMAndPNumber(number))),
+    };
+};

package/dist/carriers/m-and-p/carrier.json

@@ -19,18 +19,60 @@
   "timezone": "Asia/Karachi",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "m-and-p",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 746
+    }
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "delivered_at",
+    "offset_timestamps"
+  ],
   "portal": {
     "url": "https://www.mulphilog.com/tracking/{trackingNumber}",
     "searchUrl": "https://www.mulphilog.com/",
     "canaryUrl": "https://www.mulphilog.com/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "origin",
+      "destination",
+      "sender_name",
+      "recipient_name",
+      "customer_reference",
+      "booking_details",
+      "delivered_at",
+      "signatory"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "delivered_at",
+      "offset_timestamps"
+    ],
+    "discarded": [
+      "origin",
+      "destination",
+      "sender_name",
+      "recipient_name",
+      "customer_reference",
+      "booking_details",
+      "signatory"
+    ],
+    "unavailable": [
+      "eta",
+      "service_name",
+      "weight",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

package/dist/carriers/m-and-p/numbers.json

@@ -169,7 +169,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -189,7 +189,30 @@
           "metropolitan-warehouse"
         ]
       },
-      "note": "A customer's Trustpilot review of M&P (mulphilog.com) gives it as the tracking ID of the parcel the review is about."
+      "note": "A customer's Trustpilot review of M&P (mulphilog.com) gives it as the tracking ID of the parcel the review is about; M&P's tracker shows the consignment delivered with its scan history."
+    },
+    {
+      "number": "556656610052013",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/review/mulphilog.com",
+        "date": "2026-05-12",
+        "dateKind": "publication",
+        "access": "full_page"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "brt",
+          "yunda"
+        ]
+      },
+      "note": "Customers' Trustpilot reviews of M&P (mulphilog.com) give it as the order ID of their complaint; M&P's tracker shows the consignment delivered with its scan history."
     }
   ]
 }

package/dist/carriers/m-and-p/parser.d.ts

@@ -0,0 +1,16 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "M&P";
+export declare const M_AND_P_MAX_BYTES = 1000000;
+/** An M&P consignment number: twelve to fifteen digits. */
+export declare function normalizeMAndPNumber(raw: string): string;
+/** A scan's sentence without who took the parcel, phone numbers or an amount to collect. */
+export declare function mAndPSentence(text: string): string;
+/**
+ * The tracker's page for one consignment, which the server renders: a form
+ * with the number as asked, the booking date, the shipper and consignee with
+ * their cities, then the scans newest first, each with a date, a clock, a
+ * status label, the city and a sentence. A consignment the tracker has no
+ * record of gets its notice instead of scans. The booking details, names,
+ * cities and the order reference are not read, nor who took the parcel.
+ */
+export declare function parseMAndP(html: string, rawNumber: string): CarrierResult;

package/dist/carriers/m-and-p/parser.js

@@ -0,0 +1,150 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { firstOccurrence } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { mAndPStage } from './status.js';
+export const PROVIDER = 'M&P';
+// A page is about 250 kB, most of it menus, script and a chat widget.
+export const M_AND_P_MAX_BYTES = 1_000_000;
+// Consignment numbers seen are twelve or fifteen digits.
+const NUMBER = /^\d{12,15}$/;
+const ZONE = 'Asia/Karachi';
+// The day, the month's short name, the year and a twelve-hour clock, as "04 Jun 2026 05:14 pm".
+const CLOCK = /^(\d{1,2}) ([A-Za-z]{3}) (\d{4}) (\d{1,2}):(\d{2}) ([AaPp][Mm])$/;
+const NOT_FOUND = /^No tracking record found with the provided consignment number\.?$/i;
+// A firewall's or bot check's page, read only on a page without the tracker's
+// result area. The site's quote form draws its own captcha, so the word alone
+// is no block.
+const BLOCKED = /<title>\s*(?:Just a moment|Attention Required|Access Denied|Request Rejected|403 Forbidden)|_cf_chl_opt|cf-turnstile|g-recaptcha|hcaptcha|_Incapsula_Resource|AwsWafIntegration|awswaf\.com/i;
+// Who took a delivered parcel, from where the sentence names them to its end.
+const RECEIVER = /[\s,]*(?:\band\s+)?(?:has been\s+)?\b(?:rec(?:ie|ei)ved|signed|collected)\s+by\b.*$/i;
+// A run of ten or more digits with spaces or hyphens, as phone numbers are written.
+const PHONE = /(?<![A-Z\d])\+?\d(?:[\s-]?\d){9,}(?![A-Z\d])/gi;
+// An amount to collect in rupees.
+const AMOUNT = /\b(?:Rs\.?|PKR)\s*\d[\d,]*(?:\.\d+)?/gi;
+// Stands for a line break while a sentence's text is read.
+const BREAK = '\u2029';
+const MAX_ROWS = 200;
+const MAX_EVENTS = 100;
+/** An M&P consignment number: twelve to fifteen digits. */
+export function normalizeMAndPNumber(raw) {
+    const number = typeof raw === 'string' && raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'M&P consignment numbers are twelve to fifteen digits');
+    return number;
+}
+/** A scan's sentence without who took the parcel, phone numbers or an amount to collect. */
+export function mAndPSentence(text) {
+    return clean(text.replace(RECEIVER, '').replace(PHONE, '').replace(AMOUNT, ''), 300)
+        .replace(/\s+([,.;:])/g, '$1').replace(/[\s,;:]+$/, '');
+}
+/**
+ * The text of a node, a line break read as the end of a sentence: a failed
+ * attempt's reason is followed by a line on the next try.
+ */
+function sentences(node) {
+    const copy = node.clone();
+    copy.find('br').replaceWith(BREAK);
+    return copy.text().split(BREAK).map((line) => clean(line, 300)).filter(Boolean)
+        .map((line, index, lines) => (index < lines.length - 1 && !/[.!?:]$/.test(line) ? `${line}.` : line)).join(' ');
+}
+function unexpected(html, message) {
+    if (BLOCKED.test(html.slice(0, 64_000)))
+        throw new ChallengeError(PROVIDER, 'M&P answered with a browser check');
+    throw new SchemaError(PROVIDER, message);
+}
+/**
+ * A wall clock to the minute without an offset, read in Karachi time: M&P's
+ * network is in Pakistan, which keeps one offset without daylight saving.
+ */
+function clock(text) {
+    const match = CLOCK.exec(text);
+    const written = match ? `${match[1].padStart(2, '0')} ${match[2]} ${match[3]} ${match[4].padStart(2, '0')}:${match[5]} ${match[6].toUpperCase()}` : '';
+    // UTC only checks the calendar fields.
+    const checked = DateTime.fromFormat(written, 'dd LLL yyyy hh:mm a', { zone: 'UTC', locale: 'en-US' });
+    if (!checked.isValid || checked.toFormat('dd LLL yyyy hh:mm a', { locale: 'en-US' }) !== written) {
+        throw new SchemaError(PROVIDER, 'M&P returned an invalid scan time');
+    }
+    const zoned = firstOccurrence(DateTime.fromISO(checked.toFormat("yyyy-MM-dd'T'HH:mm"), { zone: ZONE }));
+    return { time: zoned.toISO({ suppressMilliseconds: true }), at: zoned.toMillis() };
+}
+/**
+ * The tracker's page for one consignment, which the server renders: a form
+ * with the number as asked, the booking date, the shipper and consignee with
+ * their cities, then the scans newest first, each with a date, a clock, a
+ * status label, the city and a sentence. A consignment the tracker has no
+ * record of gets its notice instead of scans. The booking details, names,
+ * cities and the order reference are not read, nor who took the parcel.
+ */
+export function parseMAndP(html, rawNumber) {
+    const number = normalizeMAndPNumber(rawNumber);
+    const $ = load(html);
+    const section = $('#orderTrackSection .order-track');
+    const asked = $('form#trackingForm input#consignmentInput');
+    if (section.length !== 1 || asked.length !== 1)
+        unexpected(html, 'M&P returned a page without its tracking result');
+    // The form shows the number the page was opened for.
+    const shown = clean(asked.attr('value'), 64);
+    if (!shown)
+        throw new SchemaError(PROVIDER, 'M&P returned a result without its number');
+    if (shown !== number)
+        throw new IndeterminateError(PROVIDER, 'M&P answered for another consignment');
+    const steps = section.children('.order-track-step');
+    if (!steps.length) {
+        if (section.find('p').toArray().some((node) => NOT_FOUND.test(clean($(node).text(), 200))))
+            throw new NotFoundError(PROVIDER);
+        if (clean(section.text(), 200))
+            throw new SchemaError(PROVIDER, 'M&P returned a result it did not explain');
+        throw new NoHistoryError(PROVIDER);
+    }
+    if (steps.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'M&P returned an oversized history');
+    const seen = new Set();
+    const scans = [];
+    steps.each((order, node) => {
+        const step = $(node);
+        const date = step.find('.order-track-text-sub');
+        const label = step.find('.order-track-text-stat.status');
+        const place = step.find('.order-track-text-stat.location');
+        const message = step.find('.order-track-text-stat.status-message');
+        if (date.length !== 1 || label.length !== 1 || place.length > 1 || message.length > 1) {
+            throw new SchemaError(PROVIDER, 'M&P returned an invalid scan');
+        }
+        const when = clock(clean(date.text(), 40));
+        const status = clean(label.text(), 80);
+        const sentence = message.length ? mAndPSentence(sentences(message)) : '';
+        const description = sentence || status;
+        if (!description)
+            throw new SchemaError(PROVIDER, 'M&P returned a scan without wording');
+        const location = clean(place.text(), 120);
+        const staged = mAndPStage(status, sentence);
+        const event = {
+            time: when.time, description, ...(location ? { location } : {}),
+            ...(status ? { provider_code: status } : {}),
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        };
+        const identity = JSON.stringify([event.time, status, description, location]);
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        scans.push({ event, at: when.at, order });
+    });
+    // Newest first; scans at the same minute keep the page's order, which is newest first.
+    const events = scans.sort((a, b) => b.at - a.at || a.order - b.order).map(({ event }) => event);
+    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,
+        last_update: newest.time,
+        expected_delivery: null,
+        ...(stage === 'delivered' ? { delivered_at: current.time } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/m-and-p/status.d.ts

@@ -0,0 +1,7 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives a label or sentence, read case-insensitively. */
+export declare function mAndPMappedStage(wording: string): Stage | undefined;
+/** A scan's stage: its label's, else its sentence's, else the shared wording rules', else nothing. */
+export declare function mAndPStage(label: string, sentence: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/m-and-p/status.js

@@ -0,0 +1,62 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The tracker's status labels and the fixed sentences under them, current and
+ * from the earlier page, whose table had a status and a details column and a
+ * CN Status summary. A sentence that goes on with a name or a reason is read
+ * by its label.
+ */
+const WORDINGS = new Map([
+    ['Booked', 'registered'],
+    ['Your order has been placed. It will be packed and prepared for shipment.', 'registered'],
+    ['Booking', 'registered'],
+    ['Shipment is booked.', 'registered'],
+    // Taken in at the origin hub.
+    ['Arrived at OPS Facility', 'accepted'],
+    ['The shipment has been arrived at M&P operations at the origin hub and will be scheduled for transit', 'accepted'],
+    ['Arrived at OPS', 'accepted'],
+    ['Shipment has arrived at origin facility.', 'accepted'],
+    ['In-transit', 'in_transit'],
+    ['The shipment has been dispatched and is on its way to the destination city', 'in_transit'],
+    ['Loading', 'in_transit'],
+    ['Shipment has departed.', 'in_transit'],
+    ['LOADED', 'in_transit'],
+    ['Reached at Destination', 'in_transit'],
+    ['The shipment has been arrived at the destination city and will be scheduled for delivery', 'in_transit'],
+    ['Unloading', 'in_transit'],
+    ['Shipment has arrived at hub.', 'in_transit'],
+    ['Out-for-Delivery', 'out_for_delivery'],
+    ['On Delivery', 'out_for_delivery'],
+    ['Shipment is Out for Delivery.', 'out_for_delivery'],
+    ['Delivered', 'delivered'],
+    ['Shipment has been Delivered.', 'delivered'],
+    ['Unsuccessful Delivery Attempt', 'failed_attempt'],
+    ['Refused Delivery', 'failed_attempt'],
+    ['Shipment is undelivered as delivery was refused by consignee.', 'failed_attempt'],
+    // Delivery stopped and the parcel is to go back to the shipper.
+    ['Ready to Return', 'exception'],
+    ['Shipment is undelivered due to Ready to Return.', 'exception'],
+    ['Return to Shipper', 'returned'],
+    ['Shipment has been Returned to Shipper.', 'returned'],
+    ['RETURNED', 'returned'],
+].map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+/** The stage the map gives a label or sentence, read case-insensitively. */
+export function mAndPMappedStage(wording) {
+    return WORDINGS.get(normalizeStatusWording(wording));
+}
+/** A scan's stage: its label's, else its sentence's, else the shared wording rules', else nothing. */
+export function mAndPStage(label, sentence) {
+    const mapped = (label ? mAndPMappedStage(label) : undefined) ?? (sentence ? mAndPMappedStage(sentence) : undefined);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    for (const wording of [label, sentence]) {
+        const worded = wording ? classifyWording(wording, 'in_transit') : null;
+        if (worded && worded.source !== 'none')
+            return worded;
+    }
+    return null;
+}
+export const statusMap = {
+    stage: (code, wording) => (code ? mAndPMappedStage(code) : undefined) ?? mAndPMappedStage(wording),
+    gaps: [],
+};