universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/royal-mail/carrier.json

@@ -0,0 +1,60 @@
+{
+  "id": "royal-mail",
+  "displayName": "Royal Mail",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "GB"
+    ]
+  },
+  "brand": {
+    "color": "#da202a"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "universal",
+    "steps": []
+  },
+  "capabilities": [
+    "history",
+    "location",
+    "eta"
+  ],
+  "portal": {
+    "url": "https://www.royalmail.com/portal/rm/track?trackNumber={trackingNumber}",
+    "canaryUrl": "https://www.royalmail.com/track-your-item",
+    "shows": [
+      "status",
+      "history",
+      "eta",
+      "location"
+    ],
+    "scraped": [],
+    "discarded": [
+      "signatory",
+      "proof of delivery extras",
+      "recipient details"
+    ],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "royalmail.com"
+      ],
+      "params": [
+        "trackNumber"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "royal-mail-1",
+      "pattern": "^(?!(?:EA|EB|EC|ED|EE|CP|GI))[A-Z]{2}\\d{9}GB$",
+      "confidence": "high",
+      "checksum": "s10"
+    }
+  ]
+}

package/dist/carriers/royal-mail/numbers.json

@@ -0,0 +1,57 @@
+{
+  "carrier": "royal-mail",
+  "records": [
+    {
+      "number": "SG577041359GB",
+      "role": "shipment",
+      "evidence": "official_documentation_example",
+      "source": {
+        "url": "https://www.royalmail.com/royal-mail-you/intellectual-property-rights/linking-our-website"
+      },
+      "expect": {
+        "carrier": "royal-mail",
+        "confidence": "high"
+      },
+      "note": "Official documentation example, not a real shipment."
+    },
+    {
+      "number": "ZW924750388GB",
+      "role": "shipment",
+      "evidence": "official_documentation_example",
+      "source": {
+        "url": "https://www.royalmail.com/royal-mail-you/intellectual-property-rights/linking-our-website"
+      },
+      "expect": {
+        "carrier": "royal-mail",
+        "confidence": "high"
+      },
+      "note": "Official documentation example, not a real shipment."
+    },
+    {
+      "number": "VU493136052GB",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.reddit.com/r/royalmail/comments/1w25nnx/if_you_experienced_this_please_reply/"
+      },
+      "expect": {
+        "carrier": "royal-mail",
+        "confidence": "high"
+      },
+      "note": "Public customer report with a later comment reporting delivery. An identity-matched direct summary was verified on 2026-09-21 after diagnosing a consent reload race. Status can change; not a permanent live-status oracle."
+    },
+    {
+      "number": "GV883319471GB",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.reddit.com/r/Sugargoo/comments/1we8q17/where_is_my_parcel/"
+      },
+      "expect": {
+        "carrier": "royal-mail",
+        "confidence": "high"
+      },
+      "note": "Public customer report of an inbound shipment intended for Royal Mail. An identity-matched direct summary was verified on 2026-09-21. Status can change; not a permanent live-status oracle."
+    }
+  ]
+}

package/dist/carriers/royal-mail/status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Royal Mail status vocabulary.
+ *
+ * Summary categories come from the public application's statusCategoryIcon
+ * vocabulary. Scan wording is matched separately: a collected scan may mean
+ * carrier acceptance, while the summary category Collected means delivery.
+ * `statuses.json` records the scan wording retained from prior art.
+ */
+import type { CarrierStatus } from '../../core/result/index.js';
+import type { Stage } from '../../core/status/index.js';
+export declare function royalMailSummaryStage(category: string, description: string): Stage | null;
+/**
+ * Classify Royal Mail status prose. Returns null when nothing matches, so
+ * callers leave an event unstaged rather than invent a stage.
+ */
+export declare function royalMailStage(text: string): Stage | null;
+export declare function statusForStage(stage: Stage): CarrierStatus;
+/** The result-level status for summary and scan wording. */
+export declare function royalMailStatus(text: string): CarrierStatus;

package/dist/carriers/royal-mail/status.js

@@ -0,0 +1,80 @@
+const RETURNED_TERMS = ['return to sender', 'returned to sender', 'returning to sender'];
+const FAILED_ATTEMPT_TERMS = [
+    'delivery attempted', 'delivery attempt', 'delivery was attempted', 'no answer',
+    'not delivered', 'unable to deliver', 'business closed', 'refused',
+];
+const EXCEPTION_TERMS = ['exception', 'delayed', 'delay', 'damaged', 'lost', 'customs charges', 'held'];
+const OUT_FOR_DELIVERY_TERMS = ['out for delivery', 'out-for-delivery', 'on delivery'];
+const READY_FOR_PICKUP_TERMS = ['ready for collection', 'ready to collect', 'available for collection'];
+const REGISTERED_TERMS = ['manifest', 'label created', 'information received', 'order received', 'sender preparing'];
+const ACCEPTED_TERMS = ['accepted', 'received', 'item received', 'collected', 'posted', 'handed over'];
+const CUSTOMS_TERMS = ['customs', 'clearance'];
+const IN_TRANSIT_TERMS = ['despatched', 'dispatched', 'redirected', 'in transit', 'on its way', 'in-transit', 'arrived', 'departed', 'processing', 'distribution centre', 'distribution center', 'mail centre', 'delivery office'];
+const SUMMARY_STAGES = new Map([
+    ["we're expecting it", 'registered'],
+    ["we've got it", 'accepted'],
+    ['left origin country', 'in_transit'],
+    ['in customs', 'customs'],
+    ['released from customs', 'in_transit'],
+    ['left the uk', 'in_transit'],
+    ['in transit', 'in_transit'],
+    ['ready for delivery', 'in_transit'],
+    ['delivery attempted', 'failed_attempt'],
+    ['pending', 'pending'],
+    ['returned to sender', 'returned'],
+    ['delivered', 'delivered'],
+    ['collected', 'delivered'],
+    ['duplicate identified', 'exception'],
+    ['restricted or prohibited contents', 'exception'],
+]);
+export function royalMailSummaryStage(category, description) {
+    return SUMMARY_STAGES.get(category.trim().toLocaleLowerCase('en-US')) ?? royalMailStage(description);
+}
+/**
+ * Classify Royal Mail status prose. Returns null when nothing matches, so
+ * callers leave an event unstaged rather than invent a stage.
+ */
+export function royalMailStage(text) {
+    const value = text.toLocaleLowerCase('en-US');
+    if (!value)
+        return null;
+    if (RETURNED_TERMS.some((term) => value.includes(term)))
+        return 'returned';
+    if (FAILED_ATTEMPT_TERMS.some((term) => value.includes(term)))
+        return 'failed_attempt';
+    if (/^(?:delivered\b|(?:your )?item (?:was |has been )?delivered\b)/.test(value))
+        return 'delivered';
+    if (OUT_FOR_DELIVERY_TERMS.some((term) => value.includes(term)))
+        return 'out_for_delivery';
+    if (READY_FOR_PICKUP_TERMS.some((term) => value.includes(term)))
+        return 'ready_for_pickup';
+    if (CUSTOMS_TERMS.some((term) => value.includes(term)))
+        return 'customs';
+    if (EXCEPTION_TERMS.some((term) => value.includes(term)))
+        return 'exception';
+    if (REGISTERED_TERMS.some((term) => value.includes(term)))
+        return 'registered';
+    if (ACCEPTED_TERMS.some((term) => value.includes(term)))
+        return 'accepted';
+    if (IN_TRANSIT_TERMS.some((term) => value.includes(term)))
+        return 'in_transit';
+    return null;
+}
+export function statusForStage(stage) {
+    if (stage === 'delivered')
+        return 'delivered';
+    if (stage === 'out_for_delivery' || stage === 'ready_for_pickup')
+        return 'out_for_delivery';
+    if (stage === 'exception' || stage === 'failed_attempt' || stage === 'returned')
+        return 'exception';
+    if (stage === 'registered' || stage === 'pending')
+        return 'pending';
+    return 'in_transit';
+}
+/** The result-level status for summary and scan wording. */
+export function royalMailStatus(text) {
+    const stage = royalMailStage(text);
+    if (stage)
+        return statusForStage(stage);
+    return 'unknown';
+}

package/dist/carriers/royal-mail/statuses.json

@@ -0,0 +1,16 @@
+{
+  "carrier": "royal-mail",
+  "entries": [
+    { "wording": "Delivered", "language": "en", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "A delivered line may name who signed; the adapter replaces the description with this word." },
+    { "wording": "Out for delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "" },
+    { "wording": "Arrived at delivery office", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Arrival at a delivery office does not establish collection availability." },
+    { "wording": "In transit", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "" },
+    { "wording": "Despatched to delivery office", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "" },
+    { "wording": "Item received", "language": "en", "stage": "accepted", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: in_transit." },
+    { "wording": "Sender preparing item", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: pending." },
+    { "wording": "Customs charges raised", "language": "en", "stage": "customs", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: in_transit." },
+    { "wording": "Delivery attempted", "language": "en", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: exception." },
+    { "wording": "Redirected", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Redirection alone does not establish an exception." },
+    { "wording": "Returned to sender", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: exception." }
+  ]
+}

package/dist/carriers/seur/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 SeurTracker {
+    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/seur/adapter.js

@@ -0,0 +1,35 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { BudgetExceededError, IndeterminateError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
+import { normalizeSeurNumber, parseSeur } from './parser.js';
+export class SeurTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    fetch(raw, context = {}) {
+        const number = normalizeSeurNumber(raw);
+        return runSteps({ carrier: 'seur', 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 body = { telefono: null, email: null, identificador_busqueda: number, idioma: 'es', cod_postal: '',
+                        tipo_actor: 'DST', cipher: false, origen_mkt: false };
+                    const { response, bytes } = await fetchBounded('https://www.seur.com/miseur/backend/consultarEnvioLTSimple', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body), signal }, { provider: 'SEUR', timeoutMs: Math.max(1, Math.floor(remainingMs)), maxBytes: 1_000_000,
+                        redirect: 'manual', allowHttpStatuses: [302, 404, 410], fetcher: this.options.fetcher });
+                    if (performance.now() >= deadline)
+                        throw new BudgetExceededError('SEUR', context.budgetMs ?? 15_000);
+                    signal.throwIfAborted();
+                    if (response.status !== 200)
+                        throw new IndeterminateError('SEUR', 'SEUR tracking endpoint is unavailable');
+                    return parseSeur(parseJsonBytes(bytes, 'SEUR'), number);
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new SeurTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    return { id: 'seur', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeSeurNumber(number))) };
+};

package/dist/carriers/seur/carrier.json

@@ -0,0 +1,89 @@
+{
+  "id": "seur",
+  "displayName": "SEUR",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "ES",
+      "PT"
+    ]
+  },
+  "brand": {
+    "color": "#0063b3"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "seur",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 43
+    },
+    "localClocks": true
+  },
+  "capabilities": [
+    "history",
+    "weight"
+  ],
+  "portal": {
+    "url": "https://www.seur.com/miseur/mis-envios?tracking={trackingNumber}",
+    "canaryUrl": "https://www.seur.com/miseur/mis-envios",
+    "shows": [
+      "status",
+      "history",
+      "weight",
+      "parcel_count",
+      "sender",
+      "recipient",
+      "delivery_pin",
+      "qr"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "weight"
+    ],
+    "discarded": [
+      "parcel_count",
+      "sender",
+      "recipient",
+      "delivery_pin",
+      "qr"
+    ],
+    "unavailable": [
+      "location"
+    ]
+  },
+  "links": [
+    {
+      "domains": [
+        "www.seur.com",
+        "seur.com"
+      ],
+      "path": "^/miseur/mis-envios(?:/.*)?$",
+      "params": [
+        "tracking"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "seur-1",
+      "pattern": "^\\d{14}$",
+      "confidence": "low"
+    },
+    {
+      "id": "seur-2",
+      "pattern": "^\\d{21}$",
+      "confidence": "low"
+    },
+    {
+      "id": "seur-3",
+      "pattern": "^\\d{7}$",
+      "confidence": "low"
+    }
+  ]
+}

package/dist/carriers/seur/numbers.json

@@ -0,0 +1,80 @@
+{
+  "carrier": "seur",
+  "records": [
+    {
+      "number": "01475194188635",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/empresas/seur/500000075"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dpd",
+          "dpd-fr",
+          "ciblex",
+          "seur",
+          "brt",
+          "delhivery"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to SEUR, which stays one candidate among several."
+    },
+    {
+      "number": "046999610972820260807",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/empresas/seur/500000075"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "seur"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to SEUR, which stays one candidate among several."
+    },
+    {
+      "number": "07474002501967",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/han-ignorado-el-punto-de-entre/1626552520d044c1b1",
+        "date": "2026-09-23"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dpd",
+          "dpd-fr",
+          "ciblex",
+          "seur",
+          "brt",
+          "delhivery"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to SEUR, which stays one candidate among several."
+    },
+    {
+      "number": "1796295",
+      "role": "order_reference",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/empresas/seur/500000075"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "seur"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Seven-digit references are ambiguous and require a matching native lookup."
+    }
+  ]
+}

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

@@ -0,0 +1,3 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeSeurNumber(raw: string): string;
+export declare function parseSeur(value: unknown, raw: string): CarrierResult;

package/dist/carriers/seur/parser.js

@@ -0,0 +1,78 @@
+import { IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { calendarDay, explicitOffsetTime } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { classifySeurStatus } from './status.js';
+export function normalizeSeurNumber(raw) {
+    const number = raw.replace(/\s/g, '');
+    if (!/^(?:\d{7}|\d{14}|\d{21})$/.test(number))
+        throw new TypeError('SEUR requires a seven, fourteen or twenty-one digit identifier');
+    return number;
+}
+function field(value, limit) {
+    if (typeof value !== 'string' || value.length > limit)
+        throw new SchemaError('SEUR', 'SEUR returned an invalid scan field');
+    return clean(value, limit);
+}
+function scanTime(value) {
+    if (value == null || value === '')
+        return {};
+    const raw = field(value, 64);
+    const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d{1,3})?(Z|[+-](\d{2}):?(\d{2}))?$/i.exec(raw);
+    if (match && calendarDay(Number(match[1]), Number(match[2]), Number(match[3]))
+        && Number(match[4]) < 24 && Number(match[5]) < 60 && Number(match[6]) < 60
+        && (!match[8] || (Number(match[8]) < 24 && Number(match[9]) < 60))) {
+        if (!match[7])
+            return { local_time: raw };
+        const parsed = explicitOffsetTime(raw);
+        if (parsed)
+            return { time: parsed.iso };
+    }
+    return raw ? { provider_time_text: raw } : {};
+}
+export function parseSeur(value, raw) {
+    const number = normalizeSeurNumber(raw);
+    if (!isRecord(value) || !Object.hasOwn(value, 'codigo_error'))
+        throw new SchemaError('SEUR', 'SEUR tracking response changed');
+    // The same lookup error covers absent, recent and out-of-range histories.
+    // It does not establish that the requested parcel never existed.
+    if (value.codigo_error != null)
+        throw new IndeterminateError('SEUR', 'SEUR did not locate usable shipment history');
+    if (value.identificador_busqueda !== number || typeof value.clave_envio !== 'string'
+        || !value.clave_envio || value.clave_envio.length > 80)
+        throw new SchemaError('SEUR', 'SEUR returned a different or incomplete shipment');
+    if (!Array.isArray(value.situaciones))
+        throw new SchemaError('SEUR', 'SEUR tracking scans changed');
+    if (!value.situaciones.length)
+        throw new IndeterminateError('SEUR', 'SEUR returned empty shipment history');
+    if (value.situaciones.length > 500)
+        throw new SchemaError('SEUR', 'SEUR returned too many tracking scans');
+    if (value.num_bultos !== 1)
+        throw new IndeterminateError('SEUR', 'SEUR single-piece shipment history is required');
+    if (value.bultos != null && (!Array.isArray(value.bultos) || value.bultos.length > 1
+        || value.bultos.some(piece => !isRecord(piece)))) {
+        throw new IndeterminateError('SEUR', 'SEUR returned ambiguous parcel details');
+    }
+    const events = value.situaciones.map(row => {
+        if (!isRecord(row))
+            throw new SchemaError('SEUR', 'SEUR returned an invalid scan');
+        const code = field(row.cod_situacion, 12);
+        const group = field(row.grupo_situacion, 80);
+        const label = field(row.descripcion_situacion, 500);
+        if (!/^[A-Z0-9]{2,12}$/.test(code) || !group || !label)
+            throw new SchemaError('SEUR', 'SEUR returned an incomplete scan');
+        const mapped = classifySeurStatus(code, group, label);
+        return { description: mapped?.status === 'delivered' ? 'Delivered' : label, provider_status: label,
+            provider_group: group, provider_code: code, ...(mapped ? { stage: mapped.stage } : {}), ...scanTime(row.fecha) };
+    });
+    // The official widget consumes situaciones[0]; unresolved clocks retain that position.
+    const latest = events[0];
+    const mapped = classifySeurStatus(latest.provider_code, String(latest.provider_group), String(latest.provider_status));
+    const weight = value.peso;
+    return { status: mapped?.status ?? 'unknown', ...(mapped ? { current_stage: mapped.stage } : {}),
+        last_status_text: latest.description, last_update: latest.time ?? null,
+        ...(latest.local_time ? { last_update_local: latest.local_time } : {}),
+        ...(mapped?.status === 'delivered' && latest.time ? { delivered_at: latest.time } : {}),
+        ...(typeof weight === 'number' && Number.isFinite(weight) && weight > 0 && weight <= 100_000 ? { weight_kg: weight } : {}),
+        events: events.slice(0, 100) };
+}

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

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

package/dist/carriers/seur/status.js

@@ -0,0 +1,14 @@
+const observed = {
+    LL020: { group: 'ENTREGADO', wording: 'EL ENVÍO HA SIDO ENTREGADO A UN VECINO.', mapped: { status: 'delivered', stage: 'delivered' } },
+    LC003: { group: 'EN REPARTO', wording: 'EL ENVÍO ESTÁ EN REPARTO.', mapped: { status: 'out_for_delivery', stage: 'out_for_delivery' } },
+    LI300: { group: 'EN DEMORA', wording: 'EL ENVÍO HA SUFRIDO UN RETRASO Y ES POSIBLE QUE SE DEMORE LA ENTREGA. DISCULPA LAS MOLESTIAS.', mapped: { status: 'exception', stage: 'exception' } },
+    LI567: { group: 'EN TRÁNSITO', wording: 'EL ENVÍO ESTÁ EN TRÁNSITO. PRÓXIMAMENTE LLEGARÁ A LAS INSTALACIONES DE DESTINO.', mapped: { status: 'in_transit', stage: 'in_transit' } },
+    SX001: { group: 'EN TRÁNSITO', wording: 'EL ENVÍO HA SIDO RECEPCIONADO EN LAS INSTALACIONES DE ORIGEN DE SEUR. COMIENZA EL TRÁNSITO A DESTINO', mapped: { status: 'in_transit', stage: 'accepted' } },
+    SX010: { group: 'NOTIFICADO', wording: 'EL ENVÍO HA SIDO REGISTRADO.', mapped: { status: 'pending', stage: 'registered' } },
+};
+export function classifySeurStatus(code, group, wording) {
+    if (!Object.hasOwn(observed, code))
+        return undefined;
+    const entry = observed[code];
+    return group.toUpperCase() === entry.group && wording.toUpperCase() === entry.wording ? entry.mapped : undefined;
+}

package/dist/carriers/seur/statuses.json

@@ -0,0 +1,47 @@
+{
+  "carrier": "seur",
+  "entries": [
+    {
+      "code": "LL020",
+      "wording": "EL ENVÍO HA SIDO ENTREGADO A UN VECINO.",
+      "language": "es",
+      "stage": "delivered",
+      "confirmedBy": "live"
+    },
+    {
+      "code": "LC003",
+      "wording": "EL ENVÍO ESTÁ EN REPARTO.",
+      "language": "es",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live"
+    },
+    {
+      "code": "LI300",
+      "wording": "EL ENVÍO HA SUFRIDO UN RETRASO Y ES POSIBLE QUE SE DEMORE LA ENTREGA. DISCULPA LAS MOLESTIAS.",
+      "language": "es",
+      "stage": "exception",
+      "confirmedBy": "live"
+    },
+    {
+      "code": "LI567",
+      "wording": "EL ENVÍO ESTÁ EN TRÁNSITO. PRÓXIMAMENTE LLEGARÁ A LAS INSTALACIONES DE DESTINO.",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live"
+    },
+    {
+      "code": "SX001",
+      "wording": "EL ENVÍO HA SIDO RECEPCIONADO EN LAS INSTALACIONES DE ORIGEN DE SEUR. COMIENZA EL TRÁNSITO A DESTINO",
+      "language": "es",
+      "stage": "accepted",
+      "confirmedBy": "live"
+    },
+    {
+      "code": "SX010",
+      "wording": "EL ENVÍO HA SIDO REGISTRADO.",
+      "language": "es",
+      "stage": "registered",
+      "confirmedBy": "live"
+    }
+  ]
+}

package/dist/carriers/sf-express/adapter.d.ts

@@ -0,0 +1,17 @@
+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';
+import { TrawlClient } from '../../core/transport/index.js';
+export { normalizeSfExpressNumber, parse } from './parser.js';
+export declare function sfExpressTrackingUrl(raw: string): string;
+export declare function sfExpressApiUrl(raw: string): string;
+export declare class SfExpressTracker {
+    private readonly options;
+    constructor(options: {
+        trawl: TrawlClient | null;
+        timeoutMs?: number;
+        recorder?: StepRecorder;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;