universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/tipsa/adapter.js

@@ -0,0 +1,52 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { BudgetExceededError, NotFoundError, 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 { normalizeTipsaNumber, parseTipsaDetail, tipsaDetailUrl } from './parser.js';
+// The shop link (www.tip-sa.com/cliente/datos_prestashop.php) redirects here.
+const LOOKUP = 'https://aplicaciones.tip-sa.com/cliente/datos_prestashop.php';
+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 LOOKUP_MAX_BYTES = 20_000;
+const DETAIL_MAX_BYTES = 1_000_000;
+const REDIRECTS = [301, 302, 303, 307, 308];
+export class TipsaTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    fetch(raw, context = {}) {
+        const number = normalizeTipsaNumber(raw);
+        const budgetMs = context.budgetMs ?? 15_000;
+        return runSteps({ carrier: 'tipsa', budgetMs, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    const deadline = performance.now() + remainingMs;
+                    const read = async (url, maxBytes, encoding) => {
+                        signal.throwIfAborted();
+                        const left = deadline - performance.now();
+                        if (left <= 0)
+                            throw new BudgetExceededError('TIPSA', budgetMs);
+                        const { response, bytes } = await fetchBounded(url, { signal, headers: {
+                                'User-Agent': USER_AGENT,
+                                Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                                'Accept-Language': 'es-ES,es;q=0.9,en;q=0.8',
+                            } }, { provider: 'TIPSA', timeoutMs: Math.max(1, Math.floor(left)), maxBytes, redirect: 'manual',
+                            allowHttpStatuses: REDIRECTS, fetcher: this.options.fetcher });
+                        if (performance.now() >= deadline)
+                            throw new BudgetExceededError('TIPSA', budgetMs);
+                        if (REDIRECTS.includes(response.status))
+                            throw new SchemaError('TIPSA', 'TIPSA tracking page moved');
+                        return decodeText(bytes, encoding);
+                    };
+                    const detail = tipsaDetailUrl(await read(`${LOOKUP}?id=${number}`, LOOKUP_MAX_BYTES, 'utf-8'));
+                    if (!detail)
+                        throw new NotFoundError('TIPSA');
+                    return parseTipsaDetail(await read(detail, DETAIL_MAX_BYTES, 'iso-8859-1'), number);
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new TipsaTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    return { id: 'tipsa', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeTipsaNumber(number))) };
+};

package/dist/carriers/tipsa/carrier.json

@@ -0,0 +1,92 @@
+{
+  "id": "tipsa",
+  "displayName": "TIPSA",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "ES",
+      "PT",
+      "AD"
+    ]
+  },
+  "brand": {
+    "color": "#001e62"
+  },
+  "selectable": true,
+  "timezone": "Europe/Madrid",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "tipsa",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 24
+    }
+  },
+  "capabilities": [
+    "history",
+    "location"
+  ],
+  "portal": {
+    "url": "https://www.tip-sa.com/cliente/datos_prestashop.php?id={trackingNumber}",
+    "canaryUrl": "https://dinapaqweb.tipsa-dinapaq.com/dinapaqweb/detalle_envio.php",
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "postcodes",
+      "customer_reference",
+      "parcel_count",
+      "weight",
+      "volume",
+      "proof_of_delivery"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "postcodes",
+      "customer_reference",
+      "parcel_count",
+      "weight",
+      "volume",
+      "proof_of_delivery"
+    ],
+    "unavailable": [
+      "eta"
+    ]
+  },
+  "links": [
+    {
+      "domains": [
+        "tip-sa.com"
+      ],
+      "path": "^/cliente/datos(?:_prestashop)?\\.php$",
+      "params": [
+        "id"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "tipsa-1",
+      "pattern": "^\\d{10}$",
+      "confidence": "low"
+    },
+    {
+      "id": "tipsa-2",
+      "pattern": "^0\\d{5}0\\d{5}\\d{10}$",
+      "confidence": "low",
+      "preferred": true
+    }
+  ]
+}

package/dist/carriers/tipsa/numbers.json

@@ -0,0 +1,100 @@
+{
+  "carrier": "tipsa",
+  "records": [
+    {
+      "number": "0000100000104000903494",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/paquete-entregado-a-otra-perso/CPTES01915119-48",
+        "date": "2023-11-11"
+      },
+      "expect": {
+        "carrier": "ctt-express",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to TIPSA; CTT Express's rule for numbers starting 00 claims it."
+    },
+    {
+      "number": "0280010280017024953690",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.deco.proteste.pt/reclamar/todas-as-reclamacoes/encomenda-n-C3-A3o-recebida/0e56c354319eb7d720",
+        "date": "2026-08-25"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment."
+    },
+    {
+      "number": "0460040240008103140542",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/incumplimiento-en-la-entrega-d/fac22bd26674a21683",
+        "date": "2024-12-13"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Its two agency codes differ."
+    },
+    {
+      "number": "0460040460048105123537",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://portaldaqueixa.com/brands/tipsa/complaints/tipsa-nao-entrega-de-encomenda-2-146876825",
+        "date": "2025-12-24"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment."
+    },
+    {
+      "number": "8104405448",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/no-recibido-pedido/ca39ecd30bb517b380",
+        "date": "2025-08-07"
+      },
+      "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 TIPSA, which stays one candidate among several."
+    }
+  ]
+}

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

@@ -0,0 +1,17 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const TIPSA_ZONE = "Europe/Madrid";
+/** The 22-digit reference: charge agency, origin agency and waybill, six, six and ten digits. */
+export declare function normalizeTipsaNumber(raw: string): string;
+/**
+ * The shipment page the lookup's meta refresh names, or null when TIPSA knows
+ * no shipment by that reference (it then names the page with empty
+ * parameters). Only TIPSA's own detail page with a service id and a
+ * `dd/MM/yy` date is followed.
+ */
+export declare function tipsaDetailUrl(html: string): string | null;
+/**
+ * The history table of TIPSA's shipment page. Its clock is Madrid's for every
+ * agency, Portuguese ones included. Recipient, sender, reference and proof of
+ * delivery blocks are never read.
+ */
+export declare function parseTipsaDetail(html: string, raw: string): CarrierResult;

package/dist/carriers/tipsa/parser.js

@@ -0,0 +1,114 @@
+import { load } from 'cheerio';
+import { ChallengeError, IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { zonedTime } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { tipsaStatus } from './status.js';
+const PROVIDER = 'TIPSA';
+const DETAIL_ORIGIN = 'https://dinapaqweb.tipsa-dinapaq.com';
+const DETAIL_PATH = '/dinapaqweb/detalle_envio.php';
+const SERVICE = /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;
+const MAX_ROWS = 500;
+export const TIPSA_ZONE = 'Europe/Madrid';
+/** The 22-digit reference: charge agency, origin agency and waybill, six, six and ten digits. */
+export function normalizeTipsaNumber(raw) {
+    if (raw.length > 64)
+        throw new TypeError('TIPSA tracking number is too long');
+    const number = raw.replace(/[\s.-]/g, '');
+    if (/^\d{22}$/.test(number))
+        return number;
+    throw new TypeError('TIPSA requires the full 22-digit reference');
+}
+/**
+ * The shipment page the lookup's meta refresh names, or null when TIPSA knows
+ * no shipment by that reference (it then names the page with empty
+ * parameters). Only TIPSA's own detail page with a service id and a
+ * `dd/MM/yy` date is followed.
+ */
+export function tipsaDetailUrl(html) {
+    const target = /<meta\s+http-equiv=["']refresh["']\s+content=["']\s*0\s*;\s*URL=([^"'\s]{1,512})["']/i.exec(html)?.[1];
+    if (!target)
+        throw new SchemaError(PROVIDER, 'TIPSA lookup did not name a shipment page');
+    let url;
+    try {
+        url = new URL(target.replaceAll('&amp;', '&'));
+    }
+    catch {
+        throw new SchemaError(PROVIDER, 'TIPSA shipment page address is invalid');
+    }
+    const keys = [...url.searchParams.keys()];
+    if (url.origin !== DETAIL_ORIGIN || url.pathname.toLowerCase() !== DETAIL_PATH || url.username || url.password || url.hash
+        || keys.length !== 2 || !keys.includes('servicio') || !keys.includes('fecha')) {
+        throw new SchemaError(PROVIDER, 'TIPSA shipment page address changed');
+    }
+    const service = url.searchParams.get('servicio');
+    const date = url.searchParams.get('fecha');
+    if (!service && !date)
+        return null;
+    if (!SERVICE.test(service) || !/^\d{2}\/\d{2}\/\d{2}$/.test(date)) {
+        throw new SchemaError(PROVIDER, 'TIPSA shipment page address changed');
+    }
+    return url.toString();
+}
+/**
+ * The history table of TIPSA's shipment page. Its clock is Madrid's for every
+ * agency, Portuguese ones included. Recipient, sender, reference and proof of
+ * delivery blocks are never read.
+ */
+export function parseTipsaDetail(html, raw) {
+    const number = normalizeTipsaNumber(raw);
+    if (/<title>\s*Just a moment|cf-chl-|challenge-platform|Attention Required! \| Cloudflare/i.test(html)) {
+        throw new ChallengeError(PROVIDER, 'TIPSA returned a browser challenge');
+    }
+    const $ = load(html);
+    const value = (selector) => clean($(selector).attr('value'), 32);
+    const parts = value('#CodAgeCargo') + value('#CodAgeOri') + value('#Albaran');
+    if (value('#envio-localizado') !== number || parts !== number) {
+        throw new SchemaError(PROVIDER, 'TIPSA page does not identify the requested shipment');
+    }
+    const tables = $('table').filter((_, table) => $(table).find('thead th').map((__, th) => clean($(th).text(), 32)).get()
+        .join('|') === 'FECHA/HORA|ESTADO|POBLACIÓN');
+    if (tables.length !== 1)
+        throw new SchemaError(PROVIDER, 'TIPSA shipment history is missing');
+    const rows = tables.find('tbody > tr');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'TIPSA returned too many history rows');
+    const events = [];
+    const seen = new Set();
+    rows.each((_, row) => {
+        const cells = $(row).children('td');
+        if (cells.length !== 3)
+            throw new SchemaError(PROVIDER, 'TIPSA history row changed');
+        // Each cell repeats its text in a tooltip span, which is skipped.
+        const cellText = (index) => {
+            const cell = cells.eq(index);
+            const spans = cell.children('span').not('.mdl-tooltip');
+            return clean((spans.length ? spans : cell).first().text(), 160);
+        };
+        const time = zonedTime(cellText(0), 'dd/MM/yy HH:mm', TIPSA_ZONE);
+        const description = cellText(1);
+        if (!time || !description)
+            throw new SchemaError(PROVIDER, 'TIPSA history row has no time or status');
+        const location = cellText(2);
+        const key = JSON.stringify([time.iso, description, location]);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        const stage = tipsaStatus(description)?.stage;
+        events.push({ time: time.iso, description, ...(location ? { location } : {}), ...(stage ? { stage } : {}) });
+    });
+    if (!events.length)
+        throw new IndeterminateError(PROVIDER, 'TIPSA shipment history is empty');
+    // Newest first, as the page lists them; rows of one minute keep the page's order.
+    events.sort((left, right) => Date.parse(right.time) - Date.parse(left.time));
+    const newest = events[0];
+    const current = tipsaStatus(newest.description);
+    return {
+        status: current?.status ?? 'unknown',
+        ...(current ? { current_stage: current.stage } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time,
+        expected_delivery: null,
+        timezone: TIPSA_ZONE,
+        events,
+    };
+}

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

@@ -0,0 +1,3 @@
+import { type ClassifiedStatus } from '../../core/status/index.js';
+/** A label's stage: TIPSA's own vocabulary first, then the shared Spanish and Portuguese wording rules. */
+export declare function tipsaStatus(label: string): ClassifiedStatus | undefined;

package/dist/carriers/tipsa/status.js

@@ -0,0 +1,25 @@
+import { languageStageStatus, trackingLanguageStage } from '../../core/status/index.js';
+function comparable(value) {
+    return value.normalize('NFD').replace(/[̀-ͯ]/g, '').toUpperCase().replace(/\s+/g, ' ').trim();
+}
+// TIPSA's history labels, as the shipment page lists them.
+const LABELS = new Map([
+    ['PENDIENTE DE ENTREGAR A TIPSA', { status: 'pending', stage: 'registered' }],
+    ['TRANSITO', { status: 'in_transit', stage: 'in_transit' }],
+    ['LEIDO EN DESTINO', { status: 'in_transit', stage: 'in_transit' }],
+    ['REPARTO', { status: 'out_for_delivery', stage: 'out_for_delivery' }],
+    ['AUSENTE', { status: 'exception', stage: 'failed_attempt' }],
+    ['ENTREGADO', { status: 'delivered', stage: 'delivered' }],
+]);
+/** A label's stage: TIPSA's own vocabulary first, then the shared Spanish and Portuguese wording rules. */
+export function tipsaStatus(label) {
+    const key = comparable(label);
+    // The destination agency's name follows ("LECTURA EN AGENCIA DESTINO EJEMPLO 01").
+    if (/^LECTURA EN AGENCIA DESTINO\b/.test(key))
+        return { status: 'in_transit', stage: 'in_transit' };
+    const known = LABELS.get(key);
+    if (known)
+        return known;
+    const worded = trackingLanguageStage(label);
+    return worded ? { status: languageStageStatus(worded), stage: worded } : undefined;
+}

package/dist/carriers/tipsa/statuses.json

@@ -0,0 +1,12 @@
+{
+  "carrier": "tipsa",
+  "entries": [
+    { "wording": "PENDIENTE DE ENTREGAR A TIPSA", "language": "es", "stage": "registered", "confirmedBy": "live" },
+    { "wording": "TRANSITO", "language": "es", "stage": "in_transit", "confirmedBy": "live" },
+    { "wording": "LEIDO EN DESTINO", "language": "es", "stage": "in_transit", "confirmedBy": "live" },
+    { "wording": "LECTURA EN AGENCIA DESTINO", "language": "es", "stage": "in_transit", "confirmedBy": "live", "note": "Followed by the destination agency's name." },
+    { "wording": "REPARTO", "language": "es", "stage": "out_for_delivery", "confirmedBy": "live" },
+    { "wording": "Ausente", "language": "es", "stage": "failed_attempt", "confirmedBy": "live" },
+    { "wording": "ENTREGADO", "language": "es", "stage": "delivered", "confirmedBy": "live" }
+  ]
+}

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

@@ -0,0 +1,23 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeTntFranceNumber(raw: string): string;
+export declare function normalizeTntExpressNumber(raw: string): string;
+export declare function parseTntFranceResponse(html: string, rawNumber: string): CarrierResult;
+export declare function parseTntExpressResponse(payload: unknown, rawNumber: string): CarrierResult;
+export declare class TntFranceTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        timeoutMs?: number;
+    });
+    fetch(rawNumber: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare class TntExpressTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        timeoutMs?: number;
+    });
+    fetch(rawNumber: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/tnt/adapter.js

@@ -0,0 +1,210 @@
+import { load } from 'cheerio';
+import { recognizeFromLookup } from '../../core/adapter/index.js';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, IndeterminateError, InputRequiredError, NotFoundError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
+import { explicitOffsetTime, zonedTime } from '../../core/time/index.js';
+import { clean, decodeText, fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { tntExpressStatus, tntFranceStatus } from './status.js';
+const PROVIDER = 'TNT France';
+const ENDPOINT = 'https://www.tnt.fr/public/suivi_colis/recherche/visubontransport.do';
+const EXPRESS_PROVIDER = 'TNT';
+// The JSON read behind tnt.com's public tracking page.
+const EXPRESS_ENDPOINT = 'https://www.tnt.com/api/v3/shipment';
+export function normalizeTntFranceNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!/^\d{16}$/.test(number))
+        throw new InputRequiredError(PROVIDER, 'number', 'TNT France direct tracking requires a 16-digit national consignment');
+    return number;
+}
+export function normalizeTntExpressNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!/^\d{9}$/.test(number))
+        throw new InputRequiredError(EXPRESS_PROVIDER, 'number', 'TNT direct tracking requires a 9-digit consignment or a 16-digit TNT France consignment');
+    return number;
+}
+async function fetchTnt(url, accept, provider, context, options) {
+    const budgetMs = context.budgetMs ?? options.timeoutMs ?? 15_000;
+    if (!Number.isFinite(budgetMs) || budgetMs <= 0)
+        throw new TypeError(`${provider} timeout must be positive`);
+    context.signal?.throwIfAborted();
+    try {
+        const fetched = await fetchBounded(url, { headers: { Accept: accept } }, {
+            provider, maxBytes: 1_000_000, timeoutMs: Math.max(1, Math.floor(budgetMs)),
+            fetcher: (input, init) => (options.fetcher ?? fetch)(input, {
+                ...init, signal: AbortSignal.any([...(context.signal ? [context.signal] : []), ...(init?.signal ? [init.signal] : [])]),
+            }),
+        });
+        context.signal?.throwIfAborted();
+        return fetched;
+    }
+    catch (error) {
+        if (error instanceof UpstreamHttpError && [404, 410].includes(error.status))
+            throw new TransportError(provider, `${provider} tracking endpoint is unavailable`, { cause: error });
+        throw error;
+    }
+}
+export function parseTntFranceResponse(html, rawNumber) {
+    const number = normalizeTntFranceNumber(rawNumber);
+    const $ = load(html);
+    $('script, style, noscript').remove();
+    if (/captcha|access denied|verify you are human/i.test(clean($('title').text(), 200)))
+        throw new ChallengeError(PROVIDER);
+    const negative = $('#saisieBTMsg');
+    if (negative.length === 1 && !/display\s*:\s*none/i.test(negative.attr('style') ?? '')
+        && /Nous n'avons pas trouvé de colis associé à votre recherche|Les données suivantes ne correspondent pas à des bons de transport/i.test(clean(negative.text(), 500))) {
+        throw new NotFoundError(PROVIDER);
+    }
+    // The returned details identity is separate from the search form's echo.
+    const identity = $('#ancestor');
+    const titles = $('.layout__item').filter((_, element) => /^Bon de transport n[º°]\s*\d{16}$/.test(clean($(element).text(), 100)));
+    if (identity.length !== 1 || clean(identity.text(), 32) !== number || titles.length !== 1
+        || !clean(titles.text(), 100).endsWith(number))
+        throw new SchemaError(PROVIDER, 'TNT France returned no matching shipment details');
+    const sections = $('.result__item').filter((_, element) => clean($(element).children('.result__row').text(), 100) === 'Etapes de votre expédition');
+    if (sections.length !== 1)
+        throw new SchemaError(PROVIDER, 'TNT France returned no unique tracking history');
+    const rows = sections.children('.result__content').children('.roster');
+    if (!rows.length)
+        throw new IndeterminateError(PROVIDER, 'TNT France returned empty tracking history');
+    if (rows.length > 500)
+        throw new SchemaError(PROVIDER, 'TNT France returned excessive tracking history');
+    const parsed = [];
+    const seen = new Set();
+    rows.toArray().forEach((row, index) => {
+        const cells = $(row).children('.roster__item');
+        if (cells.length !== 3)
+            throw new SchemaError(PROVIDER, 'TNT France changed its tracking row');
+        const description = clean(cells.eq(0).text(), 500);
+        const date = clean(cells.eq(1).text(), 64);
+        const time = zonedTime(date, 'dd/MM/yyyy HH:mm', 'Europe/Paris');
+        const location = clean(cells.eq(2).text(), 200);
+        if (!description || !time)
+            throw new SchemaError(PROVIDER, 'TNT France returned an incomplete tracking row');
+        const mapped = tntFranceStatus(description);
+        const key = JSON.stringify([time.iso, description, location]);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        parsed.push({ event: { time: time.iso, description, ...(location ? { location } : {}), ...(mapped ? { stage: mapped.stage } : {}) }, timestamp: time.timestamp, index });
+    });
+    parsed.sort((a, b) => b.timestamp - a.timestamp || a.index - b.index);
+    const events = parsed.slice(0, 100).map(({ event }) => event);
+    // Desktop and mobile repeat the selected milestone. Future rail labels are
+    // not events, and an unselected "Livré" never proves delivery.
+    const selected = [...new Set($('.suivi-title-selected').toArray().map((element) => clean($(element).text(), 200)).filter(Boolean))];
+    if (selected.length !== 1)
+        throw new SchemaError(PROVIDER, 'TNT France returned an ambiguous current milestone');
+    const mapped = tntFranceStatus(selected[0]);
+    return {
+        status: mapped?.status ?? 'unknown', ...(mapped ? { current_stage: mapped.stage } : {}),
+        last_status_text: selected[0], last_update: events[0].time, expected_delivery: null, events,
+    };
+}
+function tntExpressHistory(consignment) {
+    if (!Array.isArray(consignment.events) || consignment.events.length > 500)
+        throw new SchemaError(EXPRESS_PROVIDER, 'TNT returned invalid tracking history');
+    const parsed = [];
+    const seen = new Set();
+    consignment.events.forEach((raw, index) => {
+        if (!isRecord(raw))
+            throw new SchemaError(EXPRESS_PROVIDER, 'TNT returned an invalid scan');
+        const time = explicitOffsetTime(raw.date);
+        const description = clean(raw.statusDescription, 500);
+        if (!time || !description)
+            throw new SchemaError(EXPRESS_PROVIDER, 'TNT returned an incomplete scan');
+        const place = isRecord(raw.location) ? raw.location : {};
+        const location = [clean(place.city, 100), clean(place.country, 100)].filter(Boolean).join(', ');
+        const code = clean(raw.legacyCode, 16);
+        const mapped = tntExpressStatus(code);
+        const key = JSON.stringify([time.iso, code, description, location]);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        parsed.push({ event: {
+                time: time.iso, description, ...(location ? { location } : {}), ...(code ? { provider_code: code } : {}),
+                ...(mapped ? { stage: mapped.stage } : {}),
+            }, timestamp: time.timestamp, index });
+    });
+    // Newest first, as the page lists them.
+    return parsed.sort((a, b) => b.timestamp - a.timestamp || a.index - b.index);
+}
+export function parseTntExpressResponse(payload, rawNumber) {
+    const number = normalizeTntExpressNumber(rawNumber);
+    const output = isRecord(payload) ? payload['tracker.output'] : undefined;
+    if (!isRecord(output))
+        throw new SchemaError(EXPRESS_PROVIDER);
+    const consignments = Array.isArray(output.consignment) ? output.consignment : [];
+    if (!consignments.length) {
+        if (Array.isArray(output.notFound) && output.notFound.some((entry) => isRecord(entry) && clean(entry.input, 32) === number)) {
+            throw new NotFoundError(EXPRESS_PROVIDER);
+        }
+        throw new SchemaError(EXPRESS_PROVIDER);
+    }
+    if (consignments.length > 50)
+        throw new SchemaError(EXPRESS_PROVIDER, 'TNT returned excessive shipments');
+    // Numbers are reused: every consignment that carried this one is listed.
+    // Its most recent scan picks the parcel; another number is never read.
+    const shipments = consignments.map((consignment) => {
+        if (!isRecord(consignment))
+            throw new SchemaError(EXPRESS_PROVIDER, 'TNT returned an invalid shipment');
+        return consignment;
+    }).filter((consignment) => clean(consignment.consignmentNumber, 32) === number)
+        .map((consignment) => ({ consignment, history: tntExpressHistory(consignment) }));
+    if (!shipments.length)
+        throw new SchemaError(EXPRESS_PROVIDER, 'TNT returned a different shipment');
+    const newest = ({ history }) => history[0]?.timestamp ?? -Infinity;
+    const { consignment, history } = shipments.reduce((best, shipment) => newest(shipment) > newest(best) ? shipment : best);
+    if (!history.length)
+        throw new IndeterminateError(EXPRESS_PROVIDER, 'TNT returned a shipment without tracking history');
+    const events = history.slice(0, 100).map(({ event }) => event);
+    const mapped = tntExpressStatus(String(events[0].provider_code ?? ''));
+    // `destinationDate` is the estimate until delivery; its day matches the page.
+    const sources = isRecord(consignment.analytics) && isRecord(consignment.analytics.destinationDateSources)
+        ? consignment.analytics.destinationDateSources : {};
+    const estimate = clean(consignment.destinationDate, 64);
+    const expected = ['originalEta', 'revisedEta', 'outForDeliveryEta'].includes(clean(sources.usedDate, 32))
+        && !['delivered', 'returned'].includes(mapped?.stage ?? '') && /^\d{4}-\d{2}-\d{2}T/.test(estimate) ? estimate.slice(0, 10) : null;
+    return {
+        status: mapped?.status ?? 'unknown', ...(mapped ? { current_stage: mapped.stage } : {}),
+        last_status_text: events[0].description, last_update: events[0].time, expected_delivery: expected, events,
+    };
+}
+export class TntFranceTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(rawNumber, context = {}) {
+        const number = normalizeTntFranceNumber(rawNumber);
+        const url = new URL(ENDPOINT);
+        url.search = new URLSearchParams({ bonTransport: number, radiochoixrecherche: 'BT' }).toString();
+        const { response, bytes } = await fetchTnt(url, 'text/html', PROVIDER, context, this.options);
+        const encoding = /charset\s*=\s*ISO-8859-1/i.test(response.headers.get('content-type') ?? '') ? 'iso-8859-1' : 'utf-8';
+        return parseTntFranceResponse(decodeText(bytes, encoding), number);
+    }
+}
+export class TntExpressTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(rawNumber, context = {}) {
+        const number = normalizeTntExpressNumber(rawNumber);
+        const url = new URL(EXPRESS_ENDPOINT);
+        url.search = new URLSearchParams({ con: number, searchType: 'CON', locale: 'en_GB', channel: 'OPENTRACK' }).toString();
+        const { bytes } = await fetchTnt(url, 'application/json', EXPRESS_PROVIDER, context, this.options);
+        return parseTntExpressResponse(parseJsonBytes(bytes, EXPRESS_PROVIDER), number);
+    }
+}
+export const adapter = (environment) => {
+    const france = new TntFranceTracker({ fetcher: environment.fetcher });
+    const express = new TntExpressTracker({ fetcher: environment.fetcher });
+    // TNT France consignments have 16 digits; tnt.com rejects them.
+    const lookup = (number, context) => /^\d{16}$/.test(normalizeTrackingNumber(number))
+        ? france.fetch(number, context) : express.fetch(number, context);
+    return {
+        id: 'tnt', steps: ['direct'], track: (input, context) => lookup(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => lookup(number, context), () => /^(?:\d{9}|\d{16})$/.test(normalizeTrackingNumber(number))),
+    };
+};