universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/correos-chile/parser.js

@@ -0,0 +1,120 @@
+import { isValidS10TrackingNumber } from '../../core/detection/s10.js';
+import { ChallengeError, IndeterminateError, RateLimitedError, SchemaError } from '../../core/errors/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { classifyCorreosChileScan } from './status.js';
+const ORIGIN = 'https://www.correos.cl';
+const PORTLET = /^cl_cch_seguimiento_portlet_seguimientoenlineaportlet_INSTANCE_[A-Za-z0-9]{8,24}$/;
+const RESOURCE = 'cl_cch_seguimiento_portlet_seguimientoresurcecommand';
+const ALLOWED_PARAMS = new Set(['p_p_id', 'p_p_lifecycle', 'p_p_state', 'p_p_mode', 'p_p_resource_id', 'p_p_cacheability']);
+export function normalizeCorreosChileNumber(raw) {
+    if (raw.length > 48)
+        throw new TypeError('Correos de Chile tracking number is too long');
+    const number = raw.toUpperCase().replace(/[\s.-]/g, '');
+    if (/^\d{13}$/.test(number) || (/^[A-Z]{2}\d{9}CL$/.test(number) && isValidS10TrackingNumber(number)))
+        return number;
+    throw new TypeError('Correos de Chile requires 13 digits or a valid Chilean postal number');
+}
+export function parseCorreosChileBootstrap(html) {
+    if (/Radware (?:Captcha )?Page|We apologize for the inconvenience|Please solve this CAPTCHA/i.test(html)) {
+        throw new ChallengeError('Correos de Chile', 'Correos de Chile returned a browser challenge');
+    }
+    const csrf = /Liferay\.authToken\s*=\s*'([A-Za-z0-9_-]{4,128})'/.exec(html)?.[1];
+    const rawUrl = /var\s+ajaxSeguimientosURL\s*=\s*"([^"\r\n]{1,2048})"/.exec(html)?.[1];
+    if (!csrf || !rawUrl)
+        throw new SchemaError('Correos de Chile', 'Tracking session fields are missing');
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new SchemaError('Correos de Chile', 'Tracking resource URL is invalid');
+    }
+    const id = url.searchParams.get('p_p_id') ?? '';
+    const namespace = `_${id}_`;
+    const cmd = `${namespace}cmd`;
+    if (url.origin !== ORIGIN || url.username || url.password || url.hash || url.pathname !== '/seguimiento-en-linea'
+        || !PORTLET.test(id) || url.searchParams.get('p_p_lifecycle') !== '2'
+        || url.searchParams.get('p_p_resource_id') !== RESOURCE
+        || url.searchParams.get(cmd) !== 'cmd_resource_get_seguimientos'
+        || [...url.searchParams.keys()].some(key => (!ALLOWED_PARAMS.has(key) && key !== cmd)
+            || url.searchParams.getAll(key).length !== 1)) {
+        throw new SchemaError('Correos de Chile', 'Tracking resource changed');
+    }
+    return { url: url.toString(), numberField: `${namespace}param_nro_seguimiento`, csrf };
+}
+function scanClock(raw, fallback) {
+    const value = clean(raw, 64);
+    const match = /^(\d{4})-(\d{2})-(\d{2})T((?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d)$/.exec(value);
+    if (match && calendarDay(Number(match[1]), Number(match[2]), Number(match[3])))
+        return { local_time: value };
+    const text = clean(value || fallback, 64);
+    return text ? { provider_time_text: text } : {};
+}
+function operationalOffice(value) {
+    const office = clean(value, 80);
+    return /^[A-ZÁÉÍÓÚÜÑ][A-ZÁÉÍÓÚÜÑ -]{2,79}$/.test(office) ? office : '';
+}
+function scanDescription(value, mapped) {
+    if (mapped)
+        return clean(value, 160);
+    // Estado is an untyped provider string. Avoid projecting free-form recipient
+    // or delivery details into a publicly visible history field.
+    return 'Actualización del envío';
+}
+export function parseCorreosChileTracking(payload, raw) {
+    const number = normalizeCorreosChileNumber(raw);
+    if (!isRecord(payload))
+        throw new SchemaError('Correos de Chile', 'Tracking response is not an object');
+    if (payload.error === true) {
+        if (payload.maxLimit === true)
+            throw new RateLimitedError('Correos de Chile');
+        // The same reply covers an unknown reference and a previously valid
+        // shipment whose history is no longer available.
+        throw new IndeterminateError('Correos de Chile', 'Tracking lookup returned no usable shipment history');
+    }
+    if (payload.error !== false || typeof payload.seguimiento !== 'string' || payload.seguimiento.length > 250_000) {
+        throw new SchemaError('Correos de Chile', 'Tracking response has no shipment detail');
+    }
+    let detail;
+    try {
+        detail = JSON.parse(payload.seguimiento);
+    }
+    catch {
+        throw new SchemaError('Correos de Chile', 'Shipment detail is not JSON');
+    }
+    if (!isRecord(detail) || detail.MainCodigo !== number || detail.Referencia !== number || !Array.isArray(detail.historial)
+        || detail.historial.length > 500 || !detail.historial.every(isRecord)) {
+        throw new SchemaError('Correos de Chile', 'Tracking response does not identify one requested shipment');
+    }
+    if (!detail.historial.length)
+        throw new IndeterminateError('Correos de Chile', 'Shipment history is empty');
+    const events = [];
+    const seen = new Set();
+    for (const row of detail.historial) {
+        const rawStatus = row.Estado;
+        if (typeof rawStatus !== 'string' || !rawStatus.trim() || rawStatus.length > 500) {
+            throw new SchemaError('Correos de Chile', 'Shipment scan lacks a status');
+        }
+        const code = /^\d{1,3}$/.test(clean(row.Icono, 32)) ? clean(row.Icono, 32) : '';
+        const mapped = classifyCorreosChileScan(code, rawStatus);
+        const description = scanDescription(rawStatus, mapped);
+        const time = scanClock(row.FechaDate, row.Fecha);
+        const location = operationalOffice(row.Oficina);
+        const key = JSON.stringify([row.FechaDate, row.Fecha, rawStatus, row.Icono, row.Oficina]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        events.push({ ...time, description, ...(code ? { provider_code: code } : {}),
+            ...(location ? { location } : {}), ...(mapped ? { stage: mapped.stage } : {}) });
+    }
+    // The portal renders the first history row as current and fades all later
+    // rows; retain that order even when the newest row has an unresolved clock.
+    const newest = events[0];
+    const mapped = classifyCorreosChileScan(String(newest.provider_code ?? ''), newest.description ?? '');
+    return { status: mapped?.status ?? 'unknown', ...(mapped ? { current_stage: mapped.stage } : {}),
+        last_status_text: newest.description, last_update: null,
+        ...(newest.local_time ? { last_update_local: newest.local_time } : {}),
+        expected_delivery: null, events: events.slice(0, 100) };
+}

package/dist/carriers/correos-chile/status.d.ts

@@ -0,0 +1,3 @@
+import type { ClassifiedStatus } from '../../core/status/index.js';
+/** Only actual scan wording establishes progress; the portal also sends future rail markers. */
+export declare function classifyCorreosChileScan(code: string, wording: string): ClassifiedStatus | null;

package/dist/carriers/correos-chile/status.js

@@ -0,0 +1,17 @@
+function comparable(value) {
+    return value.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toUpperCase().replace(/\s+/g, ' ').trim();
+}
+/** Only actual scan wording establishes progress; the portal also sends future rail markers. */
+export function classifyCorreosChileScan(code, wording) {
+    const label = comparable(wording);
+    if (code === '003' && label === 'ENVIO EN PROCESO DE INTERNACION AL PAIS') {
+        return { status: 'in_transit', stage: 'customs' };
+    }
+    if (code === '005' && label === 'ENVIO EN REPARTO') {
+        return { status: 'out_for_delivery', stage: 'out_for_delivery' };
+    }
+    if ((code === '006' || code === '010') && label === 'ENVIO ENTREGADO') {
+        return { status: 'delivered', stage: 'delivered' };
+    }
+    return null;
+}

package/dist/carriers/correos-chile/statuses.json

@@ -0,0 +1,12 @@
+{
+  "carrier": "correos-chile",
+  "entries": [
+    {
+      "code": "003",
+      "wording": "ENVÍO EN PROCESO DE INTERNACIÓN AL PAÍS",
+      "language": "es",
+      "stage": "customs",
+      "confirmedBy": "live"
+    }
+  ]
+}

package/dist/carriers/correos-express/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 CorreosExpressTracker {
+    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/correos-express/adapter.js

@@ -0,0 +1,32 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { IndeterminateError } 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 { normalizeCorreosExpressNumber, parseCorreosExpress } from './parser.js';
+const ENDPOINT = 'https://s.correosexpress.com/SeguimientoSinCP/search';
+export class CorreosExpressTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    fetch(raw, context = {}) {
+        const number = normalizeCorreosExpressNumber(raw);
+        return runSteps({ carrier: 'correos-express', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    signal.throwIfAborted();
+                    const { response, bytes } = await fetchBounded(ENDPOINT, { method: 'POST', signal,
+                        headers: { Accept: 'text/html' }, body: new URLSearchParams({ shippingNumber: number, errorCode: '' }),
+                    }, { provider: 'Correos Express', timeoutMs: Math.max(1, Math.floor(remainingMs)), maxBytes: 1_000_000,
+                        allowHttpStatuses: [404, 410], fetcher: this.options.fetcher });
+                    if (response.status !== 200)
+                        throw new IndeterminateError('Correos Express', 'Correos Express tracking endpoint is unavailable');
+                    return parseCorreosExpress(decodeText(bytes), number);
+                } }]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new CorreosExpressTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    return { id: 'correos-express', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeCorreosExpressNumber(number))) };
+};

package/dist/carriers/correos-express/carrier.json

@@ -0,0 +1,65 @@
+{
+  "id": "correos-express",
+  "displayName": "Correos Express",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "ES",
+      "PT"
+    ]
+  },
+  "brand": {
+    "color": "#ffcd00"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "correos-express",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 36
+    },
+    "localClocks": true
+  },
+  "capabilities": [
+    "history",
+    "location",
+    "eta"
+  ],
+  "portal": {
+    "url": "https://s.correosexpress.com/",
+    "canaryUrl": "https://s.correosexpress.com/",
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "estimated_delivery",
+      "proof_of_delivery"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "estimated_delivery"
+    ],
+    "discarded": [
+      "proof_of_delivery",
+      "contact_details",
+      "delivery_comments"
+    ],
+    "unavailable": [
+      "offset_timestamps"
+    ]
+  },
+  "links": [],
+  "detection": [
+    {
+      "id": "correos-express-1",
+      "pattern": "^\\d{16}$",
+      "confidence": "low"
+    }
+  ]
+}

package/dist/carriers/correos-express/numbers.json

@@ -0,0 +1,80 @@
+{
+  "carrier": "correos-express",
+  "records": [
+    {
+      "number": "3230002125829719",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/pedido-falsamente-entregado/09810690efcb4f7fde",
+        "date": "2025-08-14"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl-ecommerce",
+          "correos-express",
+          "canada-post",
+          "tnt"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Correos Express, which stays one candidate among several."
+    },
+    {
+      "number": "3230003401602989",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/error-al-visualizar-pin-probl/e22821af1ce1efd269",
+        "date": "2026-09-24"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl-ecommerce",
+          "correos-express",
+          "canada-post",
+          "tnt"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Correos Express, which stays one candidate among several."
+    },
+    {
+      "number": "7983000739053141",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/incidencia-env-C3-ADo-imposible-h/0052eb4a8375da7128",
+        "date": "2025-09-30"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl-ecommerce",
+          "correos-express",
+          "canada-post",
+          "tnt"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Correos Express, which stays one candidate among several."
+    },
+    {
+      "number": "93005001081690801339400",
+      "role": "quarantined",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/problema-con-el-repartidor/e30b27faaae7c53755",
+        "date": "2025-02-25"
+      },
+      "quarantine": true,
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Correos Express; no rule matches this shape."
+    }
+  ]
+}

package/dist/carriers/correos-express/parser.d.ts

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

package/dist/carriers/correos-express/parser.js

@@ -0,0 +1,97 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { IndeterminateError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { classifyCorreosExpressStatus } from './status.js';
+const MONTHS = { ene: 1, feb: 2, mar: 3, abr: 4, may: 5, jun: 6, jul: 7, ago: 8, sep: 9, oct: 10, nov: 11, dic: 12 };
+const NO_HISTORY = 'Lo sentimos, no se ha encontrado ningún envío con el número indicado.';
+const FAILED_ROUND = 'Su envío no ha podido ser entregado';
+export function normalizeCorreosExpressNumber(raw) {
+    const number = raw.replace(/[\s.-]/g, '');
+    if (!/^\d{16}$/.test(number))
+        throw new TypeError('Correos Express requires a 16-digit shipment number');
+    return number;
+}
+function scanClock(raw) {
+    const text = clean(raw, 64);
+    const digits = /^(?:[\p{L}]{3},?\s+)?(\d{2}\/\d{2}\/\d{4} \d{2}:\d{2}(?::\d{2})?)$/u.exec(text)?.[1];
+    if (digits) {
+        // UTC only validates the calendar digits; no instant or offset is emitted.
+        const date = DateTime.fromFormat(digits, digits.length === 19 ? 'dd/MM/yyyy HH:mm:ss' : 'dd/MM/yyyy HH:mm', { zone: 'UTC' });
+        if (date.isValid)
+            return { local_time: date.toISO({ includeOffset: false, suppressMilliseconds: true }) };
+    }
+    return text ? { provider_time_text: text } : {};
+}
+export function parseCorreosExpress(html, raw) {
+    const number = normalizeCorreosExpressNumber(raw);
+    const $ = load(html);
+    const tables = $('table.miyazaki');
+    if (!tables.length) {
+        const forms = $('#desktopHomeForm, #mobileHomeForm');
+        const inputs = forms.find('input[name="shippingNumber"]').map((_, node) => String($(node).val())).get();
+        const errors = forms.find('input[name="errorCode"]').map((_, node) => String($(node).val())).get();
+        // All error messages exist in the initial page. Only the selected server
+        // code and the matching request echo establish the observed negative.
+        if (inputs.length && inputs.some((value) => value !== number))
+            throw new SchemaError('Correos Express', 'Correos Express returned a different lookup');
+        if (inputs.length === forms.length && errors.length === forms.length && forms.length >= 1 && forms.length <= 2
+            && errors.every((code) => code === '2')
+            && $('.errorMessage2 .errorMessage').toArray().some((node) => clean($(node).text(), 300) === NO_HISTORY)) {
+            throw new NotFoundError('Correos Express');
+        }
+        throw new IndeterminateError('Correos Express', 'Correos Express did not return shipment history');
+    }
+    const heading = $('h3.status');
+    const identities = heading.find('.shipping > span').map((_, node) => clean($(node).text(), 40)).get();
+    if (tables.length !== 1 || heading.length !== 1 || heading.find('.shipping').length !== 1 || identities.length !== 1 || identities[0] !== number
+        || $('#shippingNumber').length !== 1 || $('#shippingNumber').val() !== number) {
+        throw new SchemaError('Correos Express', 'Correos Express returned a different or ambiguous shipment');
+    }
+    const headers = tables.find('thead th').map((_, node) => clean($(node).text(), 64)).get();
+    if (headers.join('|') !== 'Fechas/hora|Población|Estado')
+        throw new SchemaError('Correos Express', 'Correos Express history columns changed');
+    const rows = tables.find('tbody tr');
+    if (!rows.length)
+        throw new IndeterminateError('Correos Express', 'Correos Express returned an empty history');
+    if (rows.length > 500)
+        throw new SchemaError('Correos Express', 'Correos Express returned too many scans');
+    const events = [];
+    const seen = new Set();
+    // The carrier renders newest first. Preserve its order when a newest clock
+    // is unresolved; never promote an older dated delivery over that row.
+    for (const row of rows.toArray()) {
+        const cells = $(row).children('td');
+        if (cells.length !== 3)
+            throw new SchemaError('Correos Express', 'Correos Express returned an incomplete scan');
+        const rawStatus = clean(cells.eq(2).text(), 500);
+        if (!rawStatus)
+            throw new SchemaError('Correos Express', 'Correos Express returned an empty scan');
+        // The carrier sometimes leaves the label blank and puts a free-form
+        // incident note after the first period. Only known labels are retained.
+        // A failed round's note opens with a fixed phrase and then gives the
+        // reason, which can name the recipient; only the phrase is kept.
+        const label = /^\.?\s*Su env[ií]o no ha podido ser entregado\b/iu.test(rawStatus) ? FAILED_ROUND : rawStatus.split('.')[0].trim();
+        const clock = scanClock(cells.eq(0).text());
+        const location = clean(cells.eq(1).text(), 200);
+        const mapped = classifyCorreosExpressStatus(label);
+        const description = mapped ? (mapped.status === 'delivered' ? 'Delivered' : label) : 'Tracking update';
+        const key = `${clock.local_time ?? clock.provider_time_text ?? ''}\u0000${rawStatus}\u0000${location}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        events.push({ description, ...(mapped ? { provider_status: label, stage: mapped.stage } : {}),
+            ...clock, ...(location ? { location } : {}) });
+    }
+    const latest = events[0];
+    const mapped = classifyCorreosExpressStatus(String(latest.provider_status));
+    const estimate = /Entrega prevista:\s*[\p{L}]+,?\s+(\d{1,2})\s+([\p{L}]{3})\s+(\d{4})/iu.exec(heading.text());
+    const month = estimate && MONTHS[estimate[2].toLowerCase()];
+    const day = estimate && month ? calendarDay(Number(estimate[3]), month, Number(estimate[1])) : null;
+    const latestDay = typeof latest.local_time === 'string' ? latest.local_time.slice(0, 10) : null;
+    const active = mapped && ['pending', 'in_transit', 'out_for_delivery'].includes(mapped.status);
+    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: active && day && latestDay && day >= latestDay ? day : null, events: events.slice(0, 100) };
+}

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

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

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

@@ -0,0 +1,25 @@
+const labels = {
+    INFORMADO: { status: 'pending', stage: 'registered' },
+    ADMITIDO: { status: 'in_transit', stage: 'accepted' },
+    'ADMITIDO EN OFICINA DE CORREOS': { status: 'in_transit', stage: 'accepted' },
+    'EN RUTA A LOCALIDAD DE DESTINO': { status: 'in_transit', stage: 'in_transit' },
+    'EN DESTINO': { status: 'in_transit', stage: 'in_transit' },
+    'EN REPARTO': { status: 'out_for_delivery', stage: 'out_for_delivery' },
+    // The fixed opening the parser keeps from an unlabelled failed round.
+    'SU ENVIO NO HA PODIDO SER ENTREGADO': { status: 'exception', stage: 'failed_attempt' },
+    // At the chosen pickup point, but the carrier says the collection
+    // instructions are still to come; the next scan makes it available.
+    'ENTREGADO EN PUNTO DE CONVENIENCIA': { status: 'in_transit', stage: 'in_transit' },
+    'DISPONIBLE EN PUNTO DE CONVENIENCIA': { status: 'in_transit', stage: 'ready_for_pickup' },
+    ENTREGADO: { status: 'delivered', stage: 'delivered' },
+    DEVUELTO: { status: 'exception', stage: 'returned' },
+    'EN ALMACEN': { status: 'exception', stage: 'exception' },
+    ESTACIONADO: { status: 'exception', stage: 'exception' },
+    // The accompanying carrier wording describes a rescheduled delivery after
+    // an unsuccessful attempt, with the new delivery still in the future.
+    'NUEVO REPARTO': { status: 'in_transit', stage: 'in_transit' },
+};
+export function classifyCorreosExpressStatus(label) {
+    const key = label.normalize('NFD').replace(/\p{Diacritic}/gu, '').toUpperCase().trim();
+    return Object.hasOwn(labels, key) ? labels[key] : undefined;
+}

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

@@ -0,0 +1,19 @@
+{
+  "carrier": "correos-express",
+  "entries": [
+    { "wording": "INFORMADO", "language": "es", "stage": "registered", "confirmedBy": "live" },
+    { "wording": "ADMITIDO", "language": "es", "stage": "accepted", "confirmedBy": "live" },
+    { "wording": "ADMITIDO EN OFICINA DE CORREOS", "language": "es", "stage": "accepted", "confirmedBy": "live" },
+    { "wording": "EN RUTA A LOCALIDAD DE DESTINO", "language": "es", "stage": "in_transit", "confirmedBy": "live" },
+    { "wording": "EN DESTINO", "language": "es", "stage": "in_transit", "confirmedBy": "live" },
+    { "wording": "EN REPARTO", "language": "es", "stage": "out_for_delivery", "confirmedBy": "live" },
+    { "wording": "Su envío no ha podido ser entregado", "language": "es", "stage": "failed_attempt", "confirmedBy": "live" },
+    { "wording": "ENTREGADO EN PUNTO DE CONVENIENCIA", "language": "es", "stage": "in_transit", "confirmedBy": "live" },
+    { "wording": "DISPONIBLE EN PUNTO DE CONVENIENCIA", "language": "es", "stage": "ready_for_pickup", "confirmedBy": "live" },
+    { "wording": "ENTREGADO", "language": "es", "stage": "delivered", "confirmedBy": "live" },
+    { "wording": "DEVUELTO", "language": "es", "stage": "returned", "confirmedBy": "live" },
+    { "wording": "EN ALMACÉN", "language": "es", "stage": "exception", "confirmedBy": "live" },
+    { "wording": "ESTACIONADO", "language": "es", "stage": "exception", "confirmedBy": "live" },
+    { "wording": "NUEVO REPARTO", "language": "es", "stage": "in_transit", "confirmedBy": "live" }
+  ]
+}

package/dist/carriers/correos-spain/adapter.d.ts

@@ -0,0 +1,15 @@
+import type { AdapterFactory } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeCorreosSpainTrackingNumber(raw: string): string;
+export declare function correosSpainTrackingUrl(rawTrackingNumber: string): string;
+export declare function parseCorreosSpainTrackingResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare class CorreosSpainTracker {
+    readonly timeoutMs: number;
+    readonly fetcher: typeof fetch | undefined;
+    constructor(options?: {
+        timeoutMs?: number;
+        fetcher?: typeof fetch;
+    });
+    fetch(rawTrackingNumber: string): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;