universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/mrw/numbers.json

@@ -0,0 +1,116 @@
+{
+  "carrier": "mrw",
+  "records": [
+    {
+      "number": "02673I145025",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/reembolso/6d4f300aa0dd6d5c26",
+        "date": "2025-10-13"
+      },
+      "expect": {
+        "carrier": "mrw",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "02680I390427",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/mi-paquete-lleva-en-22transito-22/3ca104c95fcd6886da",
+        "date": "2025-10-23"
+      },
+      "expect": {
+        "carrier": "mrw",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "02692M027981",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/paquete-no-entregado/fd09f6a9ec09f35aab",
+        "date": "2025-07-07"
+      },
+      "expect": {
+        "carrier": "mrw",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "02692S094204",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6ab63070e0b0b4688bf95e67",
+        "date": "2026-09-25"
+      },
+      "expect": {
+        "carrier": "mrw",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "038233020970",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/paquete-perdido/f8b8fd62addc12cbed",
+        "date": "2025-03-04"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "fedex",
+          "dpd-fr",
+          "mondial-relay",
+          "colis-prive",
+          "mrw",
+          "purolator",
+          "sf-express",
+          "sto",
+          "zto",
+          "yamato",
+          "j-and-t"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to MRW, which stays one candidate among several."
+    },
+    {
+      "number": "04319F171575",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/demora-del-env-C3-ADo-sumado-a-malt/635ef0c643dc08ba3e",
+        "date": "2026-09-10"
+      },
+      "expect": {
+        "carrier": "mrw",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "08203F557102",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/alguien-recibi-C3-B3-mi-paquete/f4db963472379569e8",
+        "date": "2025-04-30"
+      },
+      "expect": {
+        "carrier": "mrw",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    }
+  ]
+}

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

@@ -0,0 +1,12 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeMrwNumber(raw: string): string;
+export interface MrwSummary {
+    number: string;
+    status: string;
+    date: string;
+    hour: string;
+    historyUrl: string;
+}
+export declare function parseMrwBootstrap(html: string): void;
+export declare function parseMrwSummary(html: string, raw: string): MrwSummary;
+export declare function parseMrwHistory(html: string, raw: string, summary: MrwSummary): CarrierResult;

package/dist/carriers/mrw/parser.js

@@ -0,0 +1,149 @@
+import { load } from 'cheerio';
+import { IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { classifyMrwStatus } from './status.js';
+const ORIGIN = 'https://www.mrw.es';
+const SUMMARY_HEADERS = 'Número de albarán|Fecha|Hora|Estado envío|Histórico de envío';
+const HISTORY_HEADERS = 'Fecha|Hora|Estado envío|Ubicación';
+const NEUTRAL = 'Actualización de seguimiento';
+export function normalizeMrwNumber(raw) {
+    if (raw.length > 48)
+        throw new TypeError('MRW tracking number is too long');
+    const number = raw.toUpperCase().replace(/[\s.-]/g, '');
+    if (/^(?:\d{12}|\d{5}[A-Z]\d{6})$/.test(number))
+        return number;
+    throw new TypeError('MRW requires a complete 12-character tracking number');
+}
+export function parseMrwBootstrap(html) {
+    const $ = load(html);
+    const form = $('form#seguimiento_envios');
+    if (form.length !== 1 || form.attr('action') !== 'validar-envio.asp'
+        || form.find('input[name="mrw-finder-follow-code"]').length !== 1) {
+        throw new SchemaError('MRW', 'Anonymous tracking form changed');
+    }
+}
+export function parseMrwSummary(html, raw) {
+    const number = normalizeMrwNumber(raw);
+    const $ = load(html);
+    const tables = $('#seguimientoEnvio table.zebra');
+    if (!tables.length) {
+        // The anonymous portal echoes even synthetic unknown references and does
+        // not distinguish them from shipments outside its lookup range.
+        throw new IndeterminateError('MRW', 'MRW returned no identifiable shipment');
+    }
+    if (tables.length !== 1 || tables.find('thead th').map((_, el) => clean($(el).text(), 64)).get().join('|') !== SUMMARY_HEADERS) {
+        throw new SchemaError('MRW', 'Summary table changed');
+    }
+    const rows = tables.find('tbody tr');
+    if (rows.length !== 1)
+        throw new IndeterminateError('MRW', 'MRW returned an ambiguous shipment group');
+    const cells = rows.first().children('td');
+    if (cells.length !== 5 || clean(cells.eq(0).text(), 48) !== number) {
+        throw new SchemaError('MRW', 'Summary does not identify the requested shipment');
+    }
+    const status = clean(cells.eq(3).text(), 200);
+    const date = clean(cells.eq(1).text(), 32);
+    const hour = clean(cells.eq(2).text(), 16);
+    if (!status || status.length > 160)
+        throw new SchemaError('MRW', 'Summary has no bounded status');
+    const button = cells.eq(4).find('button[title="Consultar histórico"]');
+    const relative = /^javascript:location\.href='([^'\r\n]{1,300})'$/.exec(button.attr('onclick') ?? '')?.[1];
+    let url;
+    try {
+        url = new URL(relative ?? '', `${ORIGIN}/seguimiento/`);
+    }
+    catch {
+        throw new SchemaError('MRW', 'History link is invalid');
+    }
+    if (button.length !== 1 || !relative || url.origin !== ORIGIN || url.pathname !== '/seguimiento/envio-historico.asp'
+        || url.searchParams.get('envio') !== number || url.searchParams.get('Inter') !== 'false'
+        || [...url.searchParams.keys()].sort().join('|') !== 'Inter|envio') {
+        throw new SchemaError('MRW', 'History link does not bind the requested shipment');
+    }
+    return { number, status, date, hour, historyUrl: url.toString() };
+}
+function buildLocalDate(rawDate, rawHour) {
+    const date = clean(rawDate, 32);
+    const hour = clean(rawHour, 16);
+    const match = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(date);
+    const clock = /^([01]\d|2[0-3]):([0-5]\d)$/.exec(hour);
+    if (match && clock) {
+        const day = calendarDay(Number(match[3]), Number(match[2]), Number(match[1]));
+        if (day)
+            return { local_time: `${day}T${clock[1]}:${clock[2]}:00` };
+    }
+    const text = clean(`${date} ${hour}`, 64);
+    return text ? { provider_time_text: text } : {};
+}
+function officeLabel(value) {
+    const text = clean(value, 80);
+    return /^(?:\d{5}|\d{4}-\d{3})\s+[\p{L} .'-]{2,70}$/u.test(text) ? text : '';
+}
+function summaryOnly(summary) {
+    const mapped = classifyMrwStatus(summary.status);
+    if (!mapped)
+        throw new IndeterminateError('MRW', 'MRW returned only an unrecognized summary');
+    return { status: mapped.status, current_stage: mapped.stage, last_status_text: clean(summary.status, 160),
+        last_update: null, expected_delivery: null, summary_only: true, events: [] };
+}
+export function parseMrwHistory(html, raw, summary) {
+    const number = normalizeMrwNumber(raw);
+    if (summary.number !== number)
+        throw new SchemaError('MRW', 'Summary reference changed');
+    const $ = load(html);
+    const tables = $('#seguimientoEnvio table#grdHistorico');
+    if (!tables.length) {
+        const text = clean($('#seguimientoEnvio').text(), 200);
+        if (/^Histórico de envío nacional ?VOLVER$/.test(text))
+            return summaryOnly(summary);
+        throw new IndeterminateError('MRW', 'MRW returned no usable history page');
+    }
+    const subtitle = clean($('#seguimientoEnvio h2.page-subtitle').text(), 120);
+    if (tables.length !== 1 || subtitle !== `Seguimiento del número de envío ${number}`
+        || tables.find('thead th').map((_, el) => clean($(el).text(), 64)).get().join('|') !== HISTORY_HEADERS) {
+        throw new SchemaError('MRW', 'History does not identify the requested shipment');
+    }
+    const rows = tables.find('tbody tr');
+    if (!rows.length)
+        throw new IndeterminateError('MRW', 'Shipment history is empty');
+    if (rows.length > 500)
+        throw new SchemaError('MRW', 'Shipment history is unexpectedly large');
+    const events = [];
+    const seen = new Set();
+    // MRW renders the current row first. Do not promote an older dated row when
+    // the current scan has an unresolved clock or unrecognized status.
+    for (const row of rows.toArray()) {
+        const cells = $(row).children('td');
+        if (cells.length !== 4)
+            throw new SchemaError('MRW', 'Incomplete history row');
+        const date = clean(cells.eq(0).text(), 32);
+        const hour = clean(cells.eq(1).text(), 16);
+        const rawStatus = clean(cells.eq(2).text(), 500);
+        if (!rawStatus || rawStatus.length > 160)
+            throw new SchemaError('MRW', 'History row lacks a bounded status');
+        const clock = buildLocalDate(date, hour);
+        // Read visible text only. The PointCorner link embeds a full store address
+        // and map arguments in onclick; they must never enter the result.
+        const location = officeLabel(cells.eq(3).text());
+        const key = JSON.stringify([date, hour, rawStatus, location]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const mapped = classifyMrwStatus(rawStatus);
+        events.push({ description: mapped ? rawStatus : NEUTRAL,
+            ...(mapped ? { provider_status: rawStatus, stage: mapped.stage } : {}),
+            ...clock, ...(location ? { location } : {}) });
+    }
+    const latest = events[0];
+    const firstRawStatus = clean(rows.first().children('td').eq(2).text(), 500);
+    const firstDate = clean(rows.first().children('td').eq(0).text(), 32);
+    const firstHour = clean(rows.first().children('td').eq(1).text(), 16);
+    if (summary.status !== firstRawStatus || summary.date !== firstDate || summary.hour !== firstHour) {
+        throw new IndeterminateError('MRW', 'Current summary and history disagree');
+    }
+    const mapped = classifyMrwStatus(firstRawStatus);
+    return { status: mapped?.status ?? 'unknown', ...(mapped ? { current_stage: mapped.stage } : {}),
+        last_status_text: latest.description, last_update: null, last_update_local: latest.local_time ?? null,
+        expected_delivery: null, events: events.slice(0, 100) };
+}

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

@@ -0,0 +1,2 @@
+import type { ClassifiedStatus } from '../../core/status/index.js';
+export declare function classifyMrwStatus(value: string): ClassifiedStatus | undefined;

package/dist/carriers/mrw/status.js

@@ -0,0 +1,14 @@
+const LABELS = {
+    'PENDIENTE DE RECOGER': { status: 'pending', stage: 'registered' },
+    'ENVIO RECOGIDO EN ORIGEN': { status: 'in_transit', stage: 'accepted' },
+    'EN TRANSITO': { status: 'in_transit', stage: 'in_transit' },
+    'ENVIO EN REPARTO': { status: 'out_for_delivery', stage: 'out_for_delivery' },
+    'DESTINATARIO AUSENTE O CERRADO': { status: 'exception', stage: 'failed_attempt' },
+    'DEPOSITADO EN PUNTO MRW': { status: 'in_transit', stage: 'ready_for_pickup' },
+    'DEPOSITADO EN POINTCORNER DESTINO': { status: 'in_transit', stage: 'ready_for_pickup' },
+    'ENVIO ENTREGADO': { status: 'delivered', stage: 'delivered' },
+};
+export function classifyMrwStatus(value) {
+    const key = value.normalize('NFD').replace(/\p{Diacritic}/gu, '').toUpperCase().replace(/\s+/g, ' ').trim();
+    return Object.hasOwn(LABELS, key) ? LABELS[key] : undefined;
+}

package/dist/carriers/mrw/statuses.json

@@ -0,0 +1,13 @@
+{
+  "carrier": "mrw",
+  "entries": [
+    { "wording": "Pendiente de recoger", "language": "es", "stage": "registered", "confirmedBy": "live" },
+    { "wording": "Envío recogido en origen", "language": "es", "stage": "accepted", "confirmedBy": "live" },
+    { "wording": "En tránsito", "language": "es", "stage": "in_transit", "confirmedBy": "live" },
+    { "wording": "Envío en reparto", "language": "es", "stage": "out_for_delivery", "confirmedBy": "live" },
+    { "wording": "Destinatario ausente o cerrado", "language": "es", "stage": "failed_attempt", "confirmedBy": "live" },
+    { "wording": "Depositado en punto MRW", "language": "es", "stage": "ready_for_pickup", "confirmedBy": "live" },
+    { "wording": "Depositado en PointCorner destino", "language": "es", "stage": "ready_for_pickup", "confirmedBy": "live" },
+    { "wording": "Envío entregado", "language": "es", "stage": "delivered", "confirmedBy": "live" }
+  ]
+}

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

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

package/dist/carriers/nacex/adapter.js

@@ -0,0 +1,99 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { BudgetExceededError, IndeterminateError, 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 { normalizeNacexNumber, parseNacex, validateNacexBootstrap } from './parser.js';
+const ORIGIN = 'https://www.nacex.es';
+const DETAIL_KEYS = new Set(['agencia_origen', 'numero_albaran', 'estado', 'internacional', 'externo', 'usr', 'pas']);
+function sessionCookie(response, previous) {
+    let cookie = previous;
+    for (const header of response.headers.getSetCookie()) {
+        if (!header.startsWith('JSESSIONID='))
+            continue;
+        const match = /^JSESSIONID=("[A-Za-z0-9._:-]{1,256}"|[A-Za-z0-9._:-]{1,256})(?:;|$)/.exec(header);
+        if (!match)
+            throw new SchemaError('NACEX', 'NACEX returned an invalid anonymous session');
+        cookie = `JSESSIONID=${match[1]}`;
+    }
+    if (!cookie)
+        throw new IndeterminateError('NACEX', 'NACEX did not establish an anonymous session');
+    return cookie;
+}
+function htmlText(response, bytes) {
+    const charset = /charset\s*=\s*["']?([A-Za-z0-9_-]+)/i.exec(response.headers.get('content-type') ?? '')?.[1].toLowerCase();
+    if (charset && !['utf-8', 'utf8', 'iso-8859-1', 'windows-1252'].includes(charset))
+        throw new SchemaError('NACEX', 'NACEX response encoding changed');
+    return decodeText(bytes, charset?.startsWith('utf') ? 'utf-8' : 'windows-1252');
+}
+function detailUrl(location, number) {
+    if (!location || location.length > 2_000)
+        throw new SchemaError('NACEX', 'NACEX returned an incomplete redirect');
+    let url;
+    try {
+        url = new URL(location, ORIGIN);
+    }
+    catch {
+        throw new SchemaError('NACEX', 'NACEX returned an invalid redirect');
+    }
+    const [agency, albaran] = number.split('/');
+    if (url.origin !== ORIGIN || url.username || url.password || url.hash || url.pathname !== '/seguimientoDetalle.do'
+        || [...url.searchParams.keys()].some(key => !DETAIL_KEYS.has(key) || url.searchParams.getAll(key).length !== 1)
+        || url.searchParams.get('agencia_origen') !== agency || url.searchParams.get('numero_albaran') !== albaran
+        || !/^\d{1,2}$/.test(url.searchParams.get('estado') ?? '') || url.searchParams.get('internacional') !== '0'
+        || url.searchParams.get('externo') !== 'N' || url.searchParams.get('usr') !== 'null' || url.searchParams.get('pas') !== 'null') {
+        throw new SchemaError('NACEX', 'NACEX returned a different or unsupported shipment redirect');
+    }
+    return url;
+}
+export class NacexTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    fetch(raw, context = {}) {
+        const number = normalizeNacexNumber(raw);
+        const [agency, albaran] = number.split('/');
+        return runSteps({ carrier: 'nacex', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    signal.throwIfAborted();
+                    const deadline = performance.now() + remainingMs;
+                    const read = async (url, init = {}) => {
+                        const left = deadline - performance.now();
+                        if (left <= 0)
+                            throw new BudgetExceededError('NACEX', context.budgetMs ?? 15_000);
+                        signal.throwIfAborted();
+                        const result = await fetchBounded(url, { ...init, signal }, {
+                            provider: 'NACEX', timeoutMs: Math.max(1, Math.floor(left)), maxBytes: 1_000_000,
+                            redirect: 'manual', allowHttpStatuses: [302, 404, 410], fetcher: this.options.fetcher,
+                        });
+                        if (performance.now() >= deadline)
+                            throw new BudgetExceededError('NACEX', context.budgetMs ?? 15_000);
+                        signal.throwIfAborted();
+                        return result;
+                    };
+                    const bootstrap = await read(`${ORIGIN}/irSeguimiento.do`);
+                    if (bootstrap.response.status !== 200)
+                        throw new IndeterminateError('NACEX', 'NACEX tracking form is unavailable');
+                    validateNacexBootstrap(htmlText(bootstrap.response, bootstrap.bytes));
+                    let cookie = sessionCookie(bootstrap.response);
+                    const submitted = await read(`${ORIGIN}/seguimientoFormulario.do`, { method: 'POST', headers: { Cookie: cookie },
+                        body: new URLSearchParams({ agencia_origen: agency, numero_albaran: albaran }) });
+                    if (submitted.response.status === 200)
+                        return parseNacex(htmlText(submitted.response, submitted.bytes), number);
+                    if (submitted.response.status !== 302)
+                        throw new IndeterminateError('NACEX', 'NACEX tracking submission is unavailable');
+                    const url = detailUrl(submitted.response.headers.get('location'), number);
+                    cookie = sessionCookie(submitted.response, cookie);
+                    const detail = await read(url, { headers: { Cookie: cookie } });
+                    if (detail.response.status !== 200)
+                        throw new IndeterminateError('NACEX', 'NACEX shipment detail is unavailable');
+                    return parseNacex(htmlText(detail.response, detail.bytes), number);
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new NacexTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    return { id: 'nacex', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeNacexNumber(number))) };
+};

package/dist/carriers/nacex/carrier.json

@@ -0,0 +1,78 @@
+{
+  "id": "nacex",
+  "displayName": "NACEX",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "ES",
+      "PT",
+      "AD"
+    ]
+  },
+  "brand": {
+    "color": "#fe5000"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "nacex",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 41
+    },
+    "localClocks": true
+  },
+  "capabilities": [
+    "history",
+    "location"
+  ],
+  "portal": {
+    "url": "https://www.nacex.es/seguimientoFormularioExterno.do?intcli={trackingNumber}",
+    "canaryUrl": "https://www.nacex.es/irSeguimiento.do",
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "recipient",
+      "proof_of_delivery"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "recipient",
+      "proof_of_delivery",
+      "delivery_comments",
+      "contact_details",
+      "merchant_reference"
+    ],
+    "unavailable": [
+      "scan_times",
+      "offset_timestamps"
+    ]
+  },
+  "links": [
+    {
+      "domains": [
+        "www.nacex.es",
+        "nacex.es"
+      ],
+      "path": "^/seguimientoFormularioExterno\\.do$",
+      "params": [
+        "intcli"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "nacex-1",
+      "pattern": "^\\d{4}/\\d{8}$",
+      "confidence": "high"
+    }
+  ]
+}

package/dist/carriers/nacex/numbers.json

@@ -0,0 +1,47 @@
+{
+  "carrier": "nacex",
+  "records": [
+    {
+      "number": "0833/11354347",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/desconocimiento-falta-de-info/f097c972cba9d3c984",
+        "date": "2026-09-25"
+      },
+      "expect": {
+        "carrier": "nacex",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "2103/11207088",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/no-entrega-de-envio-a-tiempo/dca1c166a05005867c",
+        "date": "2025-03-07"
+      },
+      "expect": {
+        "carrier": "nacex",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "2850/11247170",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/reclamaci-C3-B3n-por-da-C3-B1o-a-mercanc/7bf1f90f3a5fe7d8cb",
+        "date": "2025-07-25"
+      },
+      "expect": {
+        "carrier": "nacex",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    }
+  ]
+}

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

@@ -0,0 +1,4 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeNacexNumber(raw: string): string;
+export declare function validateNacexBootstrap(html: string): void;
+export declare function parseNacex(html: string, raw: string): CarrierResult;