universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/poste-italiane/adapter.js

@@ -0,0 +1,211 @@
+import { NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { clean, fetchBounded, parseJsonBytes, UpstreamHttpError } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { classifyPosteItalianeStatus } from './status.js';
+// Protocol provenance:
+// - Prior art (structure + vocabulary, verified independently below, MIT):
+//   https://github.com/ha-parcel-integrations/ha-poste-italiane (api.py,
+//   parcels.py status map, tests/payloads.py — keyless DoveQuando endpoint,
+//   esitoRicerca envelope, epoch-millis dataOra, Europe/Rome ETA text).
+// - Live verification 2026-09-10: unknown codes answer HTTP 200 with
+//   esitoRicerca "1"; old expired parcels answer without esitoRicerca and
+//   with empty listaMovimenti. The success vocabulary in status.ts was
+//   confirmed against a real parcel 2026-08-24 by the prior-art client.
+// - Deep link verified live in a real browser session: .../cerca/index.html
+//   #/risultati-spedizioni/{code} resolves the code and renders the tracker
+//   (expired parcels show the documented "Tracciatura non disponibile").
+const TRACKING_ENDPOINT = 'https://www.poste.it/online/dovequando/DQ-REST/ricercasemplice';
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_RESPONSE_BYTES = 1_000_000;
+const MAX_EVENTS_TO_RETURN = 20;
+const ITALIAN_MONTHS = {
+    gennaio: 1, febbraio: 2, marzo: 3, aprile: 4, maggio: 5, giugno: 6,
+    luglio: 7, agosto: 8, settembre: 9, ottobre: 10, novembre: 11, dicembre: 12,
+};
+function expectedDeliveryDay(value) {
+    // dataPrevistaConsegna reads like "Consegna prevista entro Giovedì 1 Gennaio
+    // 2026": reduce it to the local calendar day, never a timestamp.
+    if (typeof value !== 'string')
+        return null;
+    // Note: \w is ASCII-only in JS without the u flag and would choke on accented
+    // weekday names like "Venerdì", so the weekday group excludes spaces/digits
+    // instead (Python's \w would have matched; kept equivalent here).
+    const match = /(?:consegna prevista(?: entro)?\s+)(?:[^\s\d]+\s+)?(\d{1,2})\s+([a-zà]+)\s+(\d{4})/i.exec(value);
+    if (!match)
+        return null;
+    const month = ITALIAN_MONTHS[match[2].toLocaleLowerCase('it-IT')];
+    if (!month)
+        return null;
+    const day = Number(match[1]);
+    const year = Number(match[3]);
+    if (!Number.isInteger(day) || day < 1 || day > 31 || !Number.isInteger(year))
+        return null;
+    const iso = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`;
+    return /^\d{4}-\d{2}-\d{2}$/.test(iso) ? iso : null;
+}
+/**
+ * dataOra is epoch milliseconds (numbers, occasionally numeric strings).
+ * `core/time`'s epochMillisTime suppresses milliseconds in its ISO output;
+ * this adapter has always emitted them, and the value is persisted, so the
+ * local helper stays rather than silently rewriting stored timestamps.
+ */
+function parsedTime(value) {
+    const millis = typeof value === 'number' ? value
+        : typeof value === 'string' && value.trim() !== '' ? Number(value) : NaN;
+    if (!Number.isFinite(millis) || millis <= 0)
+        return null;
+    const iso = new Date(millis).toISOString();
+    return { iso, timestamp: millis };
+}
+export function normalizePosteItalianeTrackingNumber(raw) {
+    // Mirrors number detection: RA/1UW/3UW/5P/2IMA families. Anything else stays
+    // with the generic postal fallback — those routes were never sampled here.
+    const value = raw.toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
+    if (!/^(?:RA\d{11}|[13]UW[A-Z0-9]{10}|5P[A-Z0-9]{11}|2IMA\d{10})$/.test(value)) {
+        throw new TypeError('Poste Italiane tracking requires a Poste Italiane parcel identifier');
+    }
+    return value;
+}
+export function posteItalianeTrackingUrl(rawTrackingNumber) {
+    return `https://www.poste.it/cerca/index.html#/risultati-spedizioni/${encodeURIComponent(normalizePosteItalianeTrackingNumber(rawTrackingNumber))}`;
+}
+export function parsePosteItalianeTrackingResponse(payload, trackingNumber) {
+    const requested = normalizePosteItalianeTrackingNumber(trackingNumber);
+    if (!isRecord(payload))
+        throw new SchemaError('Poste Italiane', 'Poste Italiane returned an invalid tracking response');
+    const returned = clean(payload.idTracciatura, 64).toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
+    if (!returned)
+        throw new SchemaError('Poste Italiane', 'Poste Italiane did not return a shipment identifier');
+    if (returned !== requested)
+        throw new SchemaError('Poste Italiane', 'Poste Italiane returned a different shipment');
+    const esito = clean(payload.esitoRicerca, 8);
+    // Documented unknown outcomes: esito "1"/"2". Old expired parcels omit
+    // esitoRicerca and carry empty movements — unknown-or-expired are
+    // indistinguishable by design, and both are clean 404s, never failures.
+    if (esito === '1' || esito === '2')
+        throw new NotFoundError('Poste Italiane');
+    const rawMovements = payload.listaMovimenti;
+    if (rawMovements !== undefined && !Array.isArray(rawMovements)) {
+        throw new SchemaError('Poste Italiane', 'Poste Italiane returned invalid tracking history');
+    }
+    const parsed = [];
+    const seen = new Set();
+    (Array.isArray(rawMovements) ? rawMovements : []).filter(isRecord).slice(0, 500).forEach((rawEvent, index) => {
+        const wording = clean(rawEvent.statoLavorazione, 500);
+        const time = parsedTime(rawEvent.dataOra);
+        if (!time || !wording)
+            return;
+        const identity = `${time.iso}\u0000${wording}`;
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        const classified = classifyPosteItalianeStatus(rawEvent.statoLavorazione);
+        parsed.push({
+            // luogo fields are dropped: nothing distinguishes a depot from a
+            // recipient address without evidence. Sender, dimensions, flags and
+            // pickup-office blocks on the envelope are never retained either.
+            // Unmapped wording keeps no stage: the sync classifies it and records
+            // where the stage came from instead of assuming movement here.
+            event: {
+                time: time.iso,
+                location: '',
+                description: wording,
+                ...(classified ? { stage: classified.stage } : {}),
+            },
+            classified: classified ?? undefined,
+            timestamp: time.timestamp,
+            index,
+        });
+    });
+    parsed.sort((left, right) => right.timestamp - left.timestamp || left.index - right.index);
+    const events = parsed.slice(0, MAX_EVENTS_TO_RETURN).map(({ event }) => event);
+    // Envelope stato "5" forces delivered; otherwise the newest mapped event wins
+    // and unmapped wording stays unknown with its raw text preserved.
+    if (String(payload.stato ?? '') === '5') {
+        return {
+            status: 'delivered',
+            current_stage: 'delivered',
+            last_status_text: events[0]?.description ?? 'Delivered',
+            last_update: events[0]?.time ?? null,
+            expected_delivery: null,
+            events,
+        };
+    }
+    const latest = parsed.find((item) => item.classified);
+    if (!latest) {
+        if (events.length > 0) {
+            // Movements exist but none map: report unknown with the newest raw
+            // wording preserved rather than a wrong status or a false pending.
+            return {
+                status: 'unknown',
+                last_status_text: events[0].description,
+                last_update: events[0]?.time ?? null,
+                expected_delivery: expectedDeliveryDay(payload.dataPrevistaConsegna),
+                events,
+            };
+        }
+        if (esito === '3') {
+            return {
+                status: 'pending',
+                current_stage: 'registered',
+                last_status_text: 'Tracking information received',
+                last_update: null,
+                expected_delivery: expectedDeliveryDay(payload.dataPrevistaConsegna),
+                events,
+            };
+        }
+        throw new NotFoundError('Poste Italiane');
+    }
+    return {
+        status: latest.classified.status,
+        current_stage: latest.classified.stage,
+        last_status_text: latest.event.description,
+        last_update: latest.event.time ?? null,
+        expected_delivery: expectedDeliveryDay(payload.dataPrevistaConsegna),
+        events,
+    };
+}
+export class PosteItalianeTracker {
+    timeoutMs;
+    fetcher;
+    constructor(options = {}) {
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetcher = options.fetcher;
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
+            throw new TypeError('Poste Italiane tracking timeout must be positive');
+        }
+    }
+    async fetch(rawTrackingNumber) {
+        const trackingNumber = normalizePosteItalianeTrackingNumber(rawTrackingNumber);
+        const { response, bytes } = await fetchBounded(TRACKING_ENDPOINT, {
+            method: 'POST',
+            headers: {
+                Accept: 'application/json, text/plain, */*',
+                'Accept-Language': 'en-US,en;q=0.9',
+                'Content-Type': 'application/json',
+                Origin: 'https://www.poste.it',
+                Referer: 'https://www.poste.it/',
+                'User-Agent': 'Mozilla/5.0 (compatible; DeliveryTracker/1.0)',
+            },
+            body: JSON.stringify({ codiceSpedizione: trackingNumber, tipoRichiedente: 'WEB', periodoRicerca: 1 }),
+        }, {
+            provider: 'Poste Italiane tracking',
+            timeoutMs: this.timeoutMs,
+            maxBytes: MAX_RESPONSE_BYTES,
+            retryTransient: true,
+            allowHttpError: true,
+            fetcher: this.fetcher,
+        });
+        if (!response.ok)
+            throw new UpstreamHttpError('Poste Italiane tracking', response.status);
+        return parsePosteItalianeTrackingResponse(parseJsonBytes(bytes, 'Poste Italiane tracking'), trackingNumber);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new PosteItalianeTracker({ fetcher: environment.fetcher });
+    return {
+        id: 'poste-italiane',
+        steps: ['direct'],
+        track: (input) => tracker.fetch(input.number),
+    };
+};

package/dist/carriers/poste-italiane/carrier.json

@@ -0,0 +1,86 @@
+{
+  "id": "poste-italiane",
+  "displayName": "Poste Italiane",
+  "aliases": [
+    "Poste",
+    "PosteDelivery",
+    "Crono"
+  ],
+  "region": {
+    "countries": [
+      "IT"
+    ]
+  },
+  "brand": {
+    "color": "#eedc00"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "poste-italiane",
+    "steps": [
+      "direct"
+    ]
+  },
+  "capabilities": [
+    "history",
+    "eta"
+  ],
+  "portal": {
+    "url": "https://www.poste.it/cerca/index.html#/risultati-spedizioni/{trackingNumber}",
+    "canaryUrl": "https://www.poste.it/",
+    "shows": [
+      "status",
+      "history",
+      "eta",
+      "location",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "signature",
+      "weight",
+      "pickup_point"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "eta"
+    ],
+    "discarded": [
+      "location",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "signature",
+      "weight",
+      "pickup_point"
+    ],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "poste.it"
+      ],
+      "fragment": "risultati-spedizioni/([^/?#]+)"
+    }
+  ],
+  "detection": [
+    {
+      "id": "poste-italiane-1",
+      "pattern": "^RA\\d{11}$",
+      "confidence": "high"
+    },
+    {
+      "id": "poste-italiane-2",
+      "pattern": "^(?:[13]UW[A-Z0-9]{10}|5P[A-Z0-9]{11})$",
+      "confidence": "high"
+    },
+    {
+      "id": "poste-italiane-3",
+      "pattern": "^2IMA\\d{10}$",
+      "confidence": "high"
+    }
+  ]
+}

package/dist/carriers/poste-italiane/numbers.json

@@ -0,0 +1,117 @@
+{
+  "carrier": "poste-italiane",
+  "records": [
+    {
+      "number": "1UW1G2J193065",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/nessuno-sa-dove-si-trova-il-mi/d6bbf9fcb0dad025b2",
+        "date": "2025-01-03"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "1UW1GF0355933",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/posta-delivery-attesa-pi-C3-B9-di-2/862635c7ab6f209ad0",
+        "date": "2025-01-04"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "1UW1GF0359668",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/posta-delivery-attesa-pi-C3-B9-di-2/862635c7ab6f209ad0",
+        "date": "2025-01-04"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "2IMA0051035900",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/consegna-mai-ricevuta/97b85e8cbc17700047",
+        "date": "2025-03-03"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "3UW1GY0000066",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/rimborso-merce-spedizione-smar/6a89612b76f513e66c",
+        "date": "2025-06-16"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "5P38C32989681",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/poste-non-consegna-resa-al-mi/8b8789c70e8c99692a",
+        "date": "2025-01-31"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    },
+    {
+      "number": "CH166307960NL",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/reso-ritornato-al-mittente-e-p/5341225f84324f54e4",
+        "date": "2025-07-07"
+      },
+      "expect": {
+        "carrier": "spring-gds",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Poste Italiane; detection selects PostNL."
+    },
+    {
+      "number": "RA00020974503",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.altroconsumo.it/reclamare/bacheca-dei-reclami/spedizione-persa/f51f02b1ee980bd0bd",
+        "date": "2025-04-15"
+      },
+      "expect": {
+        "carrier": "poste-italiane",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified."
+    }
+  ]
+}

package/dist/carriers/poste-italiane/status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Poste Italiane status vocabulary.
+ *
+ * DoveQuando has no per-event status code: `statoLavorazione` is Italian prose,
+ * so the map matches on normalized wording (whitespace collapsed, lower-cased
+ * with the `it-IT` locale). The vocabulary is explicitly still being observed,
+ * so unmapped wording yields no stage at all: the sync classifies it and
+ * records where the final stage came from, rather than this map guessing.
+ *
+ * Provenance: derived from the prior-art client
+ * https://github.com/ha-parcel-integrations/ha-poste-italiane (MIT), whose
+ * success vocabulary was confirmed against a real parcel on 2026-08-24; the
+ * ASCII-apostrophe delivered variant was observed live on 2026-09-11.
+ */
+import type { ClassifiedStatus } from '../../core/status/index.js';
+/** Collapse whitespace and lower-case with the Italian locale, as the map expects. */
+export declare function normalizePosteItalianeWording(value: unknown): string;
+/** The stage and status for one `statoLavorazione`, or undefined when unmapped. */
+export declare function classifyPosteItalianeStatus(rawWording: unknown): ClassifiedStatus | undefined;

package/dist/carriers/poste-italiane/status.js

@@ -0,0 +1,44 @@
+/** Collapse whitespace and lower-case with the Italian locale, as the map expects. */
+export function normalizePosteItalianeWording(value) {
+    return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim().toLocaleLowerCase('it-IT') : '';
+}
+/** The stage and status for one `statoLavorazione`, or undefined when unmapped. */
+export function classifyPosteItalianeStatus(rawWording) {
+    const value = normalizePosteItalianeWording(rawWording);
+    if (!value)
+        return undefined;
+    if (value.startsWith('la spedizione è stata presa in carico')
+        || value.startsWith('da un nostro operatore presso l’ufficio postale')
+        || value.startsWith('da un nostro operatore presso l\'ufficio postale')
+        || value === 'a seguito di acquisto da poste.it')
+        return { status: 'pending', stage: 'registered' };
+    if (value.startsWith('la spedizione è in transito')
+        || value.startsWith('completata la fase di verifica per lo svincolo')
+        || value.startsWith('consegna non andata a buon fine')) {
+        return value.startsWith('consegna non andata a buon fine')
+            ? { status: 'exception', stage: 'failed_attempt' }
+            : { status: 'in_transit', stage: 'in_transit' };
+    }
+    if (value.startsWith('in restituzione al mittente'))
+        return { status: 'exception', stage: 'returned' };
+    switch (value) {
+        case 'la spedizione è in consegna':
+            return { status: 'out_for_delivery', stage: 'out_for_delivery' };
+        case 'la spedizione è stata consegnata':
+        // ASCII-apostrophe variant observed live on a delivered parcel.
+        case "la spedizione e' stata consegnata":
+        case 'con successo in data':
+            return { status: 'delivered', stage: 'delivered' };
+        case 'all’estero':
+        case 'all\'estero':
+        case 'presso il paese estero in data':
+        case 'in data':
+            return { status: 'in_transit', stage: 'in_transit' };
+        case 'sono in corso delle verifiche sulla spedizione. contatta assistenza':
+            return { status: 'exception', stage: 'failed_attempt' };
+        case 'disponibile per il ritiro dal giorno lavorativo successivo alla data indicata':
+            return { status: 'out_for_delivery', stage: 'ready_for_pickup' };
+        default:
+            return undefined;
+    }
+}

package/dist/carriers/poste-italiane/statuses.json

@@ -0,0 +1,22 @@
+{
+  "carrier": "poste-italiane",
+  "entries": [
+    { "wording": "la spedizione è stata presa in carico…", "language": "it", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Prefix match." },
+    { "wording": "da un nostro operatore presso l’ufficio postale…", "language": "it", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Prefix match; both the typographic and the ASCII apostrophe are accepted." },
+    { "wording": "a seguito di acquisto da poste.it", "language": "it", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match." },
+    { "wording": "la spedizione è in transito…", "language": "it", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Prefix match." },
+    { "wording": "completata la fase di verifica per lo svincolo…", "language": "it", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Customs release; prefix match." },
+    { "wording": "all’estero", "language": "it", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match; the ASCII apostrophe variant is accepted too." },
+    { "wording": "presso il paese estero in data", "language": "it", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match." },
+    { "wording": "in data", "language": "it", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match on a truncated movement line." },
+    { "wording": "la spedizione è in consegna", "language": "it", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match." },
+    { "wording": "disponibile per il ritiro dal giorno lavorativo successivo alla data indicata", "language": "it", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match." },
+    { "wording": "la spedizione è stata consegnata", "language": "it", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match." },
+    { "wording": "la spedizione e' stata consegnata", "language": "it", "stage": "delivered", "confirmedBy": "live", "firstSeen": "2026-09-11", "note": "ASCII-apostrophe variant observed live on a delivered parcel." },
+    { "wording": "con successo in data", "language": "it", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match on a truncated delivery line." },
+    { "wording": "consegna non andata a buon fine…", "language": "it", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Prefix match." },
+    { "wording": "sono in corso delle verifiche sulla spedizione. contatta assistenza", "language": "it", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Exact match." },
+    { "wording": "in restituzione al mittente…", "language": "it", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-09-10", "note": "Prefix match." },
+    { "code": "5", "language": "it", "stage": "delivered", "confirmedBy": "live", "firstSeen": "2026-09-10", "note": "Envelope-level `stato`, not an event code: it forces delivered regardless of the movement wording." }
+  ]
+}

package/dist/carriers/posti/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';
+export declare function normalizePostiTrackingNumber(raw: string): string;
+/** Identity-bound projection; empty search, malformed replies and wrong identities remain distinct. */
+export declare function parse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare class PostiTracker {
+    private readonly options;
+    private session?;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        timeoutMs?: number;
+        recorder?: StepRecorder;
+    });
+    fetch(trackingNumber: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;