universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/mondial-relay/carrier.json

@@ -0,0 +1,94 @@
+{
+  "id": "mondial-relay",
+  "displayName": "Mondial Relay",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "FR",
+      "BE",
+      "ES",
+      "LU",
+      "PT"
+    ]
+  },
+  "brand": {
+    "color": "#ef3026"
+  },
+  "selectable": true,
+  "timezone": "Europe/Paris",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "mondial-relay",
+    "requirements": [
+      {
+        "field": "dpdPostcode",
+        "whenTrackingNumber": "^(?![0-9]{26}$).*$",
+        "validator": "francePostcode",
+        "label": "Delivery postcode",
+        "type": "text",
+        "placeholder": "75001",
+        "help": "Short Mondial Relay shipment numbers require the recipient postcode; validated 26-digit label barcodes do not.",
+        "pattern": "^[0-9]{5}$",
+        "maxLength": 5,
+        "inputMode": "numeric",
+        "autoComplete": "postal-code"
+      }
+    ],
+    "steps": [
+      "trawl"
+    ]
+  },
+  "capabilities": [
+    "history",
+    "eta"
+  ],
+  "portal": {
+    "url": "https://www.mondialrelay.fr/suivi-de-colis/?numeroExpedition={trackingNumber}",
+    "canaryUrl": "https://www.mondialrelay.fr/suivi-de-colis/",
+    "shows": [
+      "status",
+      "history",
+      "eta",
+      "pickup_point",
+      "recipient_name",
+      "recipient_address"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "eta"
+    ],
+    "discarded": [
+      "pickup_point",
+      "recipient_name",
+      "recipient_address"
+    ],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "mondialrelay.fr"
+      ],
+      "params": [
+        "shipment",
+        "numeroExpedition",
+        "numero",
+        "trackingNumber"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "mondial-relay-1",
+      "pattern": "^[0-9]{26}$",
+      "confidence": "high",
+      "checksum": "mondial-relay"
+    },
+    {
+      "id": "mondial-relay-2",
+      "pattern": "^(?:\\d{8}|\\d{10}|\\d{12})$",
+      "confidence": "low"
+    }
+  ]
+}

package/dist/carriers/mondial-relay/numbers.json

@@ -0,0 +1,130 @@
+{
+  "carrier": "mondial-relay",
+  "records": [
+    {
+      "number": "12123456780101006623123454",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "mondial-relay",
+        "confidence": "high"
+      },
+      "note": "Made-up number that follows the published format."
+    },
+    {
+      "number": "4744000791",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://suivi-colis.org/mondial-relay/"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl",
+          "mondial-relay",
+          "relais-colis",
+          "tipsa",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Mondial Relay, which stays one candidate among several."
+    },
+    {
+      "number": "87778793",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://suivi-colis.org/mondial-relay/"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "mondial-relay",
+          "heppner"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Mondial Relay, which stays one candidate among several."
+    },
+    {
+      "number": "98911884",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://suivi-colis.org/mondial-relay/"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "mondial-relay",
+          "heppner"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Mondial Relay, which stays one candidate among several."
+    },
+    {
+      "number": "73800244620101503002000732",
+      "role": "full_barcode",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://forum.quechoisir.org/probleme-colis-mondial-relay-gls-t286523-40.html",
+        "date": "2022-04-25"
+      },
+      "expect": {
+        "carrier": "mondial-relay",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Full label barcode rather than the number a user types."
+    },
+    {
+      "number": "00000000000000000000000000",
+      "role": "negative",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none",
+        "not": [
+          "mondial-relay"
+        ]
+      },
+      "note": "All-zero 26-digit string; the checksum gate rejects it. Filed under Mondial Relay; no rule matches this shape."
+    },
+    {
+      "number": "12123456780101006623123455",
+      "role": "negative",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none",
+        "not": [
+          "mondial-relay"
+        ]
+      },
+      "note": "Valid barcode with the final check digit changed. Filed under Mondial Relay; no rule matches this shape."
+    },
+    {
+      "number": "12123456780101106623123454",
+      "role": "negative",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none",
+        "not": [
+          "mondial-relay"
+        ]
+      },
+      "note": "Valid barcode with the first check digit changed. Filed under Mondial Relay; no rule matches this shape."
+    }
+  ]
+}

package/dist/carriers/mondial-relay/status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Mondial Relay status vocabulary.
+ *
+ * The tracking endpoint carries no status code: every state is French prose,
+ * in `SuiviContextuel` (the headline), in each event's `Libelle`, and in the
+ * `SuiviParEtapes` milestone labels. Matching is therefore done on
+ * accent-folded, punctuation-free phrases so that "Retour à l'expéditeur",
+ * "retour a l expediteur" and "RETOUR A L'EXPEDITEUR" are one entry.
+ *
+ * Phrases are grouped most specific first: a return and a failed delivery both
+ * mention "livraison", and a pickup that has happened must outrank the parcel
+ * merely being available. Wording that matches nothing yields `unknown` with an
+ * `in_transit` stage placeholder, which the adapter only uses as an event stage
+ * when a more specific source has already set the shipment status.
+ */
+import type { ClassifiedStatus } from '../../core/status/index.js';
+/** Fold a French label to the form the phrase lists are written in. */
+export declare function comparableText(value: string): string;
+/** Ordered rules; the first phrase that appears in the folded label wins. */
+export declare const MONDIAL_RELAY_WORDING: readonly {
+    phrases: readonly string[];
+    classified: ClassifiedStatus;
+}[];
+/** The status and stage a Mondial Relay label denotes. */
+export declare function classifyStatus(description: string): ClassifiedStatus;
+/**
+ * `SuiviParEtapes` milestone numbers, used only when no wording on the
+ * shipment classified. The numbers are positions on the page's own progress
+ * bar, so they are read as "at least this far".
+ */
+export declare function milestoneNumberStatus(number: number): ClassifiedStatus;

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

@@ -0,0 +1,98 @@
+/** Fold a French label to the form the phrase lists are written in. */
+export function comparableText(value) {
+    return value
+        .toLocaleLowerCase('fr-FR')
+        .normalize('NFD')
+        .replace(/\p{Diacritic}/gu, '')
+        .replace(/[^\p{Letter}\p{Number}]+/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Ordered rules; the first phrase that appears in the folded label wins. */
+export const MONDIAL_RELAY_WORDING = [
+    {
+        phrases: ['retour a l expediteur', 'retourne a l expediteur', 'retour expediteur', 'retour en cours'],
+        classified: { status: 'exception', stage: 'returned' },
+    },
+    {
+        // Carrier-reported problems that are neither a missed attempt nor a return.
+        phrases: [
+            'anomalie', 'incident', 'adresse incorrecte', 'colis endommage',
+            'colis refuse', 'colis perdu',
+        ],
+        classified: { status: 'exception', stage: 'exception' },
+    },
+    {
+        phrases: ['echec de livraison', 'livraison impossible', 'n a pas pu etre livre'],
+        classified: { status: 'exception', stage: 'failed_attempt' },
+    },
+    {
+        phrases: [
+            'retire par le destinataire', 'retrait effectue', 'remis au destinataire',
+            'livraison effectuee au destinataire', 'colis livre au destinataire',
+        ],
+        classified: { status: 'delivered', stage: 'delivered' },
+    },
+    {
+        phrases: [
+            'disponible dans votre point relais', 'disponible au point relais',
+            'disponible dans votre locker', 'disponible au locker',
+            'disponible au point de retrait', 'disponible en consigne',
+            'vous attend au point relais', 'vous attend dans le locker', 'pret a etre retire',
+            // The locker countdown: "5 jours restants pour retirer le colis en Locker".
+            'restants pour retirer', 'restant pour retirer',
+        ],
+        classified: { status: 'out_for_delivery', stage: 'ready_for_pickup' },
+    },
+    {
+        phrases: [
+            'en cours de livraison', 'livraison en cours', 'en cours de distribution',
+            'en cours de mise a disposition',
+        ],
+        classified: { status: 'out_for_delivery', stage: 'out_for_delivery' },
+    },
+    {
+        phrases: [
+            'information transmise par l expediteur', 'en cours de preparation par l expediteur',
+            'en preparation chez l expediteur', 'etiquette creee', 'colis enregistre',
+        ],
+        classified: { status: 'pending', stage: 'registered' },
+    },
+    {
+        // Physical acceptance by the carrier, which is not the same event as the
+        // shipper announcing the parcel electronically.
+        phrases: ['pris en charge', 'prise en charge'],
+        classified: { status: 'in_transit', stage: 'accepted' },
+    },
+    {
+        phrases: [
+            'en cours d acheminement', 'en transit', 'arrive sur l agence', 'arrive a l agence',
+            'arrive au centre', 'depart de l agence', 'expedie vers', 'achemine vers',
+            'expedie depuis', 'en cours de traitement sur le site', 'en route vers le point de livraison',
+        ],
+        classified: { status: 'in_transit', stage: 'in_transit' },
+    },
+];
+/** The status and stage a Mondial Relay label denotes. */
+export function classifyStatus(description) {
+    const value = comparableText(description);
+    for (const rule of MONDIAL_RELAY_WORDING) {
+        if (rule.phrases.some((phrase) => value.includes(phrase)))
+            return rule.classified;
+    }
+    return { status: 'unknown', stage: 'in_transit' };
+}
+/**
+ * `SuiviParEtapes` milestone numbers, used only when no wording on the
+ * shipment classified. The numbers are positions on the page's own progress
+ * bar, so they are read as "at least this far".
+ */
+export function milestoneNumberStatus(number) {
+    if (number >= 5)
+        return { status: 'delivered', stage: 'delivered' };
+    if (number === 4)
+        return { status: 'out_for_delivery', stage: 'ready_for_pickup' };
+    if (number >= 2)
+        return { status: 'in_transit', stage: 'in_transit' };
+    return { status: 'pending', stage: 'registered' };
+}

package/dist/carriers/mondial-relay/statuses.json

@@ -0,0 +1,50 @@
+{
+  "carrier": "mondial-relay",
+  "entries": [
+    { "wording": "Retour à l'expéditeur", "language": "fr", "stage": "returned", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Matched accent- and punctuation-free, so \"retourné à l'expéditeur\" and \"retour expéditeur\" are the same entry." },
+    { "wording": "Retour en cours", "language": "fr", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception." },
+    { "wording": "Anomalie", "language": "fr", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Reclassified to exception 2026-09-12." },
+    { "wording": "Incident", "language": "fr", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Reclassified to exception 2026-09-12." },
+    { "wording": "Échec de livraison", "language": "fr", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception." },
+    { "wording": "Livraison impossible", "language": "fr", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception." },
+    { "wording": "N'a pas pu être livré", "language": "fr", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception." },
+    { "wording": "Adresse incorrecte", "language": "fr", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Reclassified to exception 2026-09-12." },
+    { "wording": "Colis endommagé", "language": "fr", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Reclassified to exception 2026-09-12." },
+    { "wording": "Colis refusé", "language": "fr", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Reclassified to exception 2026-09-12." },
+    { "wording": "Colis perdu", "language": "fr", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: exception. Reclassified to exception 2026-09-12." },
+    { "wording": "Retiré par le destinataire", "language": "fr", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Collection from the Point Relais is this carrier's delivery event." },
+    { "wording": "Retrait effectué", "language": "fr", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Remis au destinataire", "language": "fr", "stage": "delivered", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Livraison effectuée au destinataire", "language": "fr", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Colis livré au destinataire", "language": "fr", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Disponible dans votre Point Relais", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "Adapter result status: out_for_delivery. Exercised by fixtures/available-at-relay.json." },
+    { "wording": "Disponible au Point Relais", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "Milestone label in fixtures/available-at-relay.json." },
+    { "wording": "Disponible dans votre locker", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Disponible en consigne", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Vous attend au Point Relais", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Vous attend dans le locker", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Prêt à être retiré", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "En cours de livraison", "language": "fr", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Home-delivery offers; also matched as \"livraison en cours\"." },
+    { "wording": "En cours de distribution", "language": "fr", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "En cours de mise à disposition", "language": "fr", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Information transmise par l'expéditeur", "language": "fr", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: pending." },
+    { "wording": "Colis en cours de préparation par l'expéditeur", "language": "fr", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "Adapter result status: pending." },
+    { "wording": "Étiquette créée", "language": "fr", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Adapter result status: pending." },
+    { "wording": "Colis enregistré", "language": "fr", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "Milestone label in fixtures/available-at-relay.json." },
+    { "wording": "Prise en charge", "language": "fr", "stage": "accepted", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "Physical acceptance by the carrier, deliberately distinct from the shipper's electronic registration. Also matched as \"pris en charge\"." },
+    { "wording": "En cours d'acheminement", "language": "fr", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "En transit", "language": "fr", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Arrivé sur l'agence", "language": "fr", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Also matched as \"arrivé à l'agence\" and \"arrivé au centre\"." },
+    { "wording": "Départ de l'agence", "language": "fr", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "" },
+    { "wording": "Expédié vers", "language": "fr", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "Also matched as \"acheminé vers\"." },
+    { "code": "5", "language": "fr", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "SuiviParEtapes milestone number, used only when no wording on the shipment classified. Read as \"at least this far\", so any number above 5 is delivered too." },
+    { "code": "4", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "SuiviParEtapes milestone number; adapter result status out_for_delivery." },
+    { "code": "2", "language": "fr", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-12", "note": "SuiviParEtapes milestone number, 2 or 3." },
+    { "code": "1", "language": "fr", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-09-12", "note": "SuiviParEtapes milestone number; adapter result status pending." },
+    { "wording": "jours restants pour retirer le colis", "language": "fr", "stage": "ready_for_pickup", "confirmedBy": "live", "firstSeen": "2026-09-20", "note": "Locker countdown; matched as \"restant(s) pour retirer\". Adapter result status: out_for_delivery." },
+    { "wording": "Colis en préparation chez l'expéditeur", "language": "fr", "stage": "registered", "confirmedBy": "live", "firstSeen": "2026-09-20", "note": "Adapter result status: pending." },
+    { "wording": "Colis expédié depuis le site", "language": "fr", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-09-20", "note": "Followed by the name of the logistics site." },
+    { "wording": "Colis en cours de traitement sur le site", "language": "fr", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-09-20", "note": "Followed by the name of the logistics site." },
+    { "wording": "Colis en route vers le point de livraison", "language": "fr", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-09-20", "note": "" }
+  ]
+}

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

@@ -0,0 +1,13 @@
+import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+export declare class MrwTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        paceMs?: number;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/mrw/adapter.js

@@ -0,0 +1,131 @@
+import { BudgetExceededError, IndeterminateError, RateLimitedError, SchemaError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded } from '../../core/transport/index.js';
+import { normalizeMrwNumber, parseMrwBootstrap, parseMrwHistory, parseMrwSummary } from './parser.js';
+const ORIGIN = 'https://www.mrw.es';
+const LANDING = `${ORIGIN}/seguimiento/`;
+const POST = `${ORIGIN}/seguimiento/validar-envio.asp`;
+const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36';
+const PACE_MS = 1_200;
+const MAX_BYTES = 500_000;
+function addSessionCookies(response, jar) {
+    for (const header of response.headers.getSetCookie()) {
+        const part = header.split(';', 1)[0] ?? '';
+        const separator = part.indexOf('=');
+        if (separator < 1)
+            continue;
+        const name = part.slice(0, separator);
+        const value = part.slice(separator + 1);
+        if (/^(?:ASPSESSIONID[A-Z0-9]{8}|TS[0-9a-f]{6,32})$/.test(name) && /^[^\s;]{1,256}$/.test(value))
+            jar.set(name, value);
+    }
+}
+function nextLocation(response, sourceUrl, expected) {
+    if (response.status !== 302)
+        throw new IndeterminateError('MRW', 'MRW did not continue the tracking session');
+    let next;
+    try {
+        next = new URL(response.headers.get('location') ?? '', sourceUrl);
+    }
+    catch {
+        throw new SchemaError('MRW', 'MRW tracking redirect is invalid');
+    }
+    if (next.origin === ORIGIN && next.pathname === '/error/429.asp')
+        throw new RateLimitedError('MRW');
+    if (next.origin !== ORIGIN || next.pathname !== expected || next.search || next.hash || next.username || next.password) {
+        throw new IndeterminateError('MRW', 'MRW tracking session changed route');
+    }
+    return next.toString();
+}
+export class MrwTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    fetch(raw, context = {}) {
+        const number = normalizeMrwNumber(raw);
+        const budgetMs = context.budgetMs ?? 18_000;
+        return runSteps({ carrier: 'mrw', budgetMs, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    const deadline = performance.now() + remainingMs;
+                    const jar = new Map();
+                    let requests = 0;
+                    const ensureTime = () => {
+                        if (performance.now() >= deadline)
+                            throw new BudgetExceededError('MRW', budgetMs);
+                        signal.throwIfAborted();
+                    };
+                    const pace = async () => {
+                        if (!requests)
+                            return;
+                        ensureTime();
+                        await new Promise((resolve, reject) => {
+                            const abort = () => {
+                                clearTimeout(timer);
+                                signal.removeEventListener('abort', abort);
+                                reject(signal.reason);
+                            };
+                            const timer = setTimeout(() => {
+                                signal.removeEventListener('abort', abort);
+                                resolve();
+                            }, this.options.paceMs ?? PACE_MS);
+                            signal.addEventListener('abort', abort, { once: true });
+                        }).catch(error => {
+                            if (performance.now() >= deadline)
+                                throw new BudgetExceededError('MRW', budgetMs, { cause: error });
+                            throw error;
+                        });
+                        ensureTime();
+                    };
+                    const read = async (url, init = {}) => {
+                        await pace();
+                        ensureTime();
+                        const left = deadline - performance.now();
+                        const cookies = [...jar].map(([name, value]) => `${name}=${value}`).join('; ');
+                        const headers = new Headers(init.headers);
+                        headers.set('User-Agent', USER_AGENT);
+                        headers.set('Accept', 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8');
+                        headers.set('Accept-Language', 'es-ES,es;q=0.9');
+                        if (cookies)
+                            headers.set('Cookie', cookies);
+                        const result = await fetchBounded(url, { ...init, headers, signal }, {
+                            provider: 'MRW', timeoutMs: Math.max(1, Math.floor(left)), maxBytes: MAX_BYTES,
+                            redirect: 'manual', allowHttpStatuses: [302, 404, 410], fetcher: this.options.fetcher,
+                        });
+                        requests += 1;
+                        ensureTime();
+                        addSessionCookies(result.response, jar);
+                        if (result.response.status === 404 || result.response.status === 410) {
+                            throw new IndeterminateError('MRW', 'MRW tracking page is unavailable');
+                        }
+                        return { response: result.response, html: decodeText(result.bytes) };
+                    };
+                    const landing = await read(LANDING);
+                    if (landing.response.status !== 200)
+                        throw new IndeterminateError('MRW', 'MRW tracking form is unavailable');
+                    parseMrwBootstrap(landing.html);
+                    if (![...jar.keys()].some(name => name.startsWith('ASPSESSIONID'))) {
+                        throw new IndeterminateError('MRW', 'MRW did not establish an anonymous session');
+                    }
+                    const submitted = await read(POST, { method: 'POST', headers: {
+                            'Content-Type': 'application/x-www-form-urlencoded', Origin: ORIGIN, Referer: LANDING,
+                        }, body: new URLSearchParams({ 'mrw-finder-follow-code': number, enviar_numenvio_bt: 'Enviar' }) });
+                    const summaryUrl = nextLocation(submitted.response, POST, '/seguimiento/envio-actual.asp');
+                    const summaryPage = await read(summaryUrl, { headers: { Referer: POST } });
+                    if (summaryPage.response.status !== 200)
+                        throw new IndeterminateError('MRW', 'MRW did not return a shipment summary');
+                    const summary = parseMrwSummary(summaryPage.html, number);
+                    const historyJump = await read(summary.historyUrl, { headers: { Referer: summaryUrl } });
+                    const historyUrl = nextLocation(historyJump.response, summary.historyUrl, '/seguimiento/envio-historico.asp');
+                    const historyPage = await read(historyUrl, { headers: { Referer: summaryUrl } });
+                    if (historyPage.response.status !== 200)
+                        throw new IndeterminateError('MRW', 'MRW did not return shipment history');
+                    return parseMrwHistory(historyPage.html, number, summary);
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new MrwTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    return { id: 'mrw', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context) };
+};

package/dist/carriers/mrw/carrier.json

@@ -0,0 +1,60 @@
+{
+  "id": "mrw",
+  "displayName": "MRW",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "ES",
+      "PT"
+    ]
+  },
+  "brand": {
+    "color": "#19133b"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "mrw",
+    "steps": [
+      "direct"
+    ],
+    "localClocks": true
+  },
+  "capabilities": [
+    "history",
+    "location"
+  ],
+  "portal": {
+    "url": "https://www.mrw.es/seguimiento",
+    "canaryUrl": "https://www.mrw.es/seguimiento/",
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "pickup_point_address"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "pickup_point_address"
+    ],
+    "unavailable": []
+  },
+  "links": [],
+  "detection": [
+    {
+      "id": "mrw-1",
+      "pattern": "^\\d{12}$",
+      "confidence": "low"
+    },
+    {
+      "id": "mrw-2",
+      "pattern": "^\\d{5}[A-Z]\\d{6}$",
+      "confidence": "high"
+    }
+  ]
+}