universal-parcel-scraper 0.491.0-main.2362 → 0.495.1

package/README.md

@@ -13,7 +13,7 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
 [![License: Apache-2.0](https://img.shields.io/badge/core-Apache--2.0-blue.svg)](LICENSE)
 
 <!-- GENERATED:summary -->
-**3,500+ carriers** through **534 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **539 dedicated adapters** and **5 universal fallbacks**
 
 <sub>772 catalog entries · 134 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 15,397 such statuses, each filed under one stage.
+The carrier folders record 15,411 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/data/catalog.json

@@ -13516,7 +13516,8 @@
     "timezone": "America/Toronto",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "fastfrate",
+      "localClocks": true
     },
     "canaryUrl": "https://tracker.fastfrate.com/quick-track",
     "trackingUrlTemplate": "https://apps.fastfrate.com/fastnet/FastNet.aspx?ProbillNo={trackingNumber}",
@@ -16198,7 +16199,8 @@
     "timezone": "Asia/Shanghai",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "huahan",
+      "localClocks": true
     },
     "canaryUrl": "https://www.hh-exp.cn/WebTrack/CargoTrack.html",
     "trackingSearchUrl": "https://www.hh-exp.cn/WebTrack/CargoTrack.html",
@@ -20161,7 +20163,8 @@
     "timezone": "America/Moncton",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "midland-transport",
+      "localClocks": true
     },
     "canaryUrl": "https://ship.midlandtransport.com/Tracking/TrackClientTrackings",
     "trackingUrlTemplate": "https://ship.midlandtransport.com/Tracking/TrackClientTrackings?TrackingNumber={trackingNumber}&Lang=0",
@@ -22437,7 +22440,9 @@
     "timezone": "Pacific/Auckland",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "pbt",
+      "recognitionRank": 623,
+      "localClocks": true
     },
     "canaryUrl": "https://www.pbt.nz/",
     "trackingUrlTemplate": "https://www.pbt.nz/tracking-result/?consignmentNumber={trackingNumber}",
@@ -29088,7 +29093,8 @@
     "timezone": "America/Toronto",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "tst-cf-express",
+      "localClocks": true
     },
     "canaryUrl": "https://m.tst-cfexpress.com/tracing",
     "trackingUrlTemplate": "https://www.tst-cfexpress.com/tracing/by-url?lang=e&PRO={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 772,
-  "activeAdapters": 534,
+  "activeAdapters": 539,
   "countries": 134,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -50363,6 +50363,25 @@
       "dhl-ecommerce-pl"
     ]
   },
+  {
+    "input": "7011234567",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dhl",
+      "mondial-relay",
+      "relais-colis",
+      "tipsa",
+      "estafeta",
+      "packeta",
+      "dhl-ecommerce-es"
+    ],
+    "asked": [
+      "relais-colis",
+      "packeta",
+      "dhl-ecommerce-es"
+    ]
+  },
   {
     "input": "701327991",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -10452,7 +10452,8 @@ var Ue = {
 		timezone: "America/Toronto",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "fastfrate",
+			localClocks: !0
 		},
 		canaryUrl: "https://tracker.fastfrate.com/quick-track",
 		trackingUrlTemplate: "https://apps.fastfrate.com/fastnet/FastNet.aspx?ProbillNo={trackingNumber}",
@@ -12444,7 +12445,8 @@ var Ue = {
 		timezone: "Asia/Shanghai",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "huahan",
+			localClocks: !0
 		},
 		canaryUrl: "https://www.hh-exp.cn/WebTrack/CargoTrack.html",
 		trackingSearchUrl: "https://www.hh-exp.cn/WebTrack/CargoTrack.html",
@@ -15362,7 +15364,8 @@ var Ue = {
 		timezone: "America/Moncton",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "midland-transport",
+			localClocks: !0
 		},
 		canaryUrl: "https://ship.midlandtransport.com/Tracking/TrackClientTrackings",
 		trackingUrlTemplate: "https://ship.midlandtransport.com/Tracking/TrackClientTrackings?TrackingNumber={trackingNumber}&Lang=0",
@@ -17044,7 +17047,9 @@ var Ue = {
 		timezone: "Pacific/Auckland",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "pbt",
+			recognitionRank: 623,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.pbt.nz/",
 		trackingUrlTemplate: "https://www.pbt.nz/tracking-result/?consignmentNumber={trackingNumber}",
@@ -21908,7 +21913,8 @@ var Ue = {
 		timezone: "America/Toronto",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "tst-cf-express",
+			localClocks: !0
 		},
 		canaryUrl: "https://m.tst-cfexpress.com/tracing",
 		trackingUrlTemplate: "https://www.tst-cfexpress.com/tracing/by-url?lang=e&PRO={trackingNumber}",
@@ -29762,6 +29768,7 @@ var Tl = {
 	paquetexpress: 35,
 	passport: 55,
 	"pathao-courier": 945,
+	pbt: 623,
 	"pcp-express": 709,
 	"pdn-express": 838,
 	"pfc-express": 856,

package/dist/carriers/chunghwa-post/adapter.js

@@ -7,7 +7,7 @@ import { runSteps } from '../../core/runner/index.js';
 import { NOOP_RECORDER } from '../../core/telemetry/index.js';
 import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
 import { ChunghwaPostOcr } from './ocr.js';
-import { isChunghwaCaptchaFailure, normalizeChunghwaPostNumber, parseChunghwaPost, PROVIDER } from './parser.js';
+import { isChunghwaCaptchaFailure, isSupportedChunghwaPostNumber, normalizeChunghwaPostNumber, parseChunghwaPost, PROVIDER } from './parser.js';
 export { normalizeChunghwaPostNumber, parseChunghwaPost } from './parser.js';
 const BASE = 'https://postserv.post.gov.tw/pstmail/';
 export class ChunghwaPostTracker {
@@ -21,7 +21,7 @@ export class ChunghwaPostTracker {
         // Domestic, proprietary and other S10 services' references are refused before any request:
         // the international gateway cannot read them, and enabled universal providers follow them.
         if (/^(?:\d{14}|\d{20}|(?:PB|FT|FZ)[A-Z0-9]{11})$/.test(normalized)
-            || /^[A-Z]{2}\d{9}[A-Z]{2}$/.test(normalized) && !/^[CELR]/.test(normalized)) {
+            || /^[A-Z]{2}\d{9}[A-Z]{2}$/.test(normalized) && !isSupportedChunghwaPostNumber(normalized)) {
             throw new InvalidInputError(PROVIDER, 'This Chunghwa Post reference uses another tracking service');
         }
         const number = normalizeChunghwaPostNumber(raw);

package/dist/carriers/chunghwa-post/parser.d.ts

@@ -1,5 +1,6 @@
 import type { CarrierResult } from '../../core/result/index.js';
 export declare const PROVIDER = "Chunghwa Post";
+export declare const isSupportedChunghwaPostNumber: (number: string) => boolean;
 export declare function normalizeChunghwaPostNumber(raw: string): string;
 export declare function isChunghwaCaptchaFailure(payload: unknown): boolean;
 export declare function parseChunghwaPost(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/chunghwa-post/parser.js

@@ -6,9 +6,10 @@ import { clean } from '../../core/transport/text.js';
 import { isRecord } from '../../core/types.js';
 import { chunghwaPostStage } from './status.js';
 export const PROVIDER = 'Chunghwa Post';
+export const isSupportedChunghwaPostNumber = (number) => /^(?:[CELR][A-Z]\d{9}[A-Z]{2}|UH\d{9}TW)$/.test(number);
 export function normalizeChunghwaPostNumber(raw) {
     const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
-    if (!/^[CELR][A-Z]\d{9}[A-Z]{2}$/.test(number)) {
+    if (!isSupportedChunghwaPostNumber(number)) {
         throw new InvalidInputError(PROVIDER, 'Chunghwa Post requires an international postal S10 number');
     }
     return number;

package/dist/carriers/fastfrate/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';
+/** The lookup the tracker's quick track page makes for a probill, without an account. */
+export declare const FASTFRATE_API = "https://tracker.fastfrate.com/trackerapi/shipmentinformation/quicktrack";
+/** The lookup's address for one probill. */
+export declare function fastfrateLookupUrl(number: string): string;
+export declare class FastfrateTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/fastfrate/adapter.js

@@ -0,0 +1,61 @@
+import { ChallengeError, SchemaError, TransportError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { FASTFRATE_MAX_BYTES, normalizeFastfrateNumber, parseFastfrate, PROVIDER } from './parser.js';
+/** The lookup the tracker's quick track page makes for a probill, without an account. */
+export const FASTFRATE_API = 'https://tracker.fastfrate.com/trackerapi/shipmentinformation/quicktrack';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// A missing route is not a missing probill: the lookup answers an unknown one with an empty timeline.
+const GONE = [404, 410];
+// Bot checks a CDN or firewall could put in place of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>\s*(?:Just a moment|Attention Required|Access Denied|Request Rejected)|requested URL was rejected|AwsWafIntegration|awswaf\.com|captcha/i;
+/** The lookup's address for one probill. */
+export function fastfrateLookupUrl(number) {
+    return `${FASTFRATE_API}?probillnumber=${encodeURIComponent(normalizeFastfrateNumber(number))}`;
+}
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Fastfrate answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Fastfrate returned a reply that is not JSON', { cause });
+    }
+}
+export class FastfrateTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeFastfrateNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(fastfrateLookupUrl(number), { method: 'GET', signal, headers: {
+                    Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: FASTFRATE_MAX_BYTES, redirect: 'manual',
+                fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, ...GONE] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Fastfrate redirected its tracking lookup');
+            if (GONE.includes(response.status))
+                throw new TransportError(PROVIDER, 'Fastfrate tracking lookup is unavailable');
+            return parseFastfrate(json(decodeText(bytes)), number);
+        };
+        // A request that fails to reach the service, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'fastfrate', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => read(signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => read(signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new FastfrateTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'fastfrate', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+    };
+};

package/dist/carriers/fastfrate/carrier.json

@@ -17,18 +17,60 @@
   "timezone": "America/Toronto",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "fastfrate",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "eta"
+  ],
   "portal": {
     "url": "https://apps.fastfrate.com/fastnet/FastNet.aspx?ProbillNo={trackingNumber}",
     "searchUrl": "https://tracker.fastfrate.com/quick-track",
     "canaryUrl": "https://tracker.fastfrate.com/quick-track",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "customer_reference",
+      "origin",
+      "destination",
+      "weight",
+      "parcel_count",
+      "recipient_contact",
+      "remarks"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "eta"
+    ],
+    "discarded": [
+      "customer_reference",
+      "origin",
+      "destination",
+      "weight",
+      "parcel_count",
+      "recipient_contact",
+      "remarks"
+    ],
+    "unavailable": [
+      "offset_timestamps",
+      "delivered_at",
+      "service_name",
+      "provider_code",
+      "sender_name",
+      "recipient_name",
+      "delivery_partner",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

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

@@ -0,0 +1,13 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Fastfrate";
+export declare const FASTFRATE_MAX_BYTES: number;
+/** A Fastfrate probill: six to ten digits. Anything else is not one the tracker is asked for. */
+export declare function normalizeFastfrateNumber(raw: string): string;
+/**
+ * The reply of `trackerapi/shipmentinformation/quicktrack?probillnumber={number}`, the lookup
+ * the tracker's quick track page makes: `{"probillNumber":…,"timeline":[…],"references":[…],
+ * "serviceMsg":…}`, the timeline oldest first. The page reports an empty timeline as not
+ * found. The references are the shipper's own, and the service message stands in for a
+ * missing estimate; neither is read.
+ */
+export declare function parseFastfrate(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/fastfrate/parser.js

@@ -0,0 +1,150 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { fastfrateStage } from './status.js';
+export const PROVIDER = 'Fastfrate';
+// A long timeline is a few kilobytes.
+export const FASTFRATE_MAX_BYTES = 128 * 1024;
+// A probill as the trackers take it: more than five digits, as the tracker's page checks, and
+// at most ten, as the former page's field. The service reads it as a number, so one starting
+// with 0 would not be the same digits.
+const NUMBER = /^[1-9]\d{5,9}$/;
+// "2026-03-03T15:58:00", with milliseconds on some rows: a wall clock without an offset.
+const CLOCK = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d{1,7})?$/;
+// Two rows are not scans. The page shows the estimate's day over the list and leaves its row
+// out, and an appointment's row is dated with the appointment's own time.
+const ESTIMATE = 'estimated delivery date';
+const APPOINTMENT = 'scheduled appointment';
+// A canonical province or territory code.
+const PROVINCE = /^[A-Z]{2}$/;
+// Stages a delivery settles: the driver's device stamps its rows on its own clock, so its
+// arrival at the consignee can come after the delivery.
+const BEFORE_DELIVERY = new Set(['registered', 'accepted', 'in_transit', 'out_for_delivery']);
+const MAX_ROWS = 300;
+/** A Fastfrate probill: six to ten digits. Anything else is not one the tracker is asked for. */
+export function normalizeFastfrateNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Fastfrate probills are six to ten digits');
+    return number;
+}
+function invalid(message) {
+    throw new SchemaError(PROVIDER, `Fastfrate returned ${message}`);
+}
+/** An optional text field; anything but a string is a changed reply. */
+function text(row, key, maxLength = 200) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string')
+        invalid(`an invalid ${key}`);
+    return clean(value, maxLength);
+}
+/**
+ * A row's wall clock to the second, or its day when the clock is midnight, which the
+ * timeline gives a row dated without a time. No clock names its zone.
+ */
+function clockOf(value) {
+    const match = typeof value === 'string' ? CLOCK.exec(value.trim()) : null;
+    if (!match)
+        invalid('an invalid timeStamp');
+    const [, year, month, date, hour, minute, second] = match;
+    const day = calendarDay(Number(year), Number(month), Number(date));
+    // The clock's fields are checked here, since date libraries accept hour 24.
+    if (!day || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59)
+        invalid('an invalid timeStamp');
+    return `${hour}${minute}${second}` === '000000' ? day : `${day}T${hour}:${minute}:${second}`;
+}
+/** A terminal's town and province; a town holding a digit could be an address, so it is left out. */
+function placeOf(row) {
+    const city = text(row, 'city', 80);
+    const province = text(row, 'province', 8).toUpperCase();
+    if (!city || /\d/.test(city))
+        return '';
+    return PROVINCE.test(province) ? `${city}, ${province}` : city;
+}
+function rowOf(value) {
+    if (!isRecord(value))
+        invalid('an invalid timeline row');
+    const wording = text(value, 'description');
+    if (!wording)
+        invalid('a timeline row without its description');
+    return { wording, clock: clockOf(value.timeStamp), place: placeOf(value) };
+}
+/**
+ * The reply of `trackerapi/shipmentinformation/quicktrack?probillnumber={number}`, the lookup
+ * the tracker's quick track page makes: `{"probillNumber":…,"timeline":[…],"references":[…],
+ * "serviceMsg":…}`, the timeline oldest first. The page reports an empty timeline as not
+ * found. The references are the shipper's own, and the service message stands in for a
+ * missing estimate; neither is read.
+ */
+export function parseFastfrate(payload, raw) {
+    const number = normalizeFastfrateNumber(raw);
+    if (!isRecord(payload) || !Array.isArray(payload.timeline))
+        invalid('an invalid envelope');
+    const probill = payload.probillNumber;
+    if (typeof probill !== 'number' || !Number.isSafeInteger(probill) || probill < 0)
+        invalid('a reply without its probill');
+    // The service answers for the number it read: a missing one reads as 0, whose record holds stray rows.
+    if (String(probill) !== number)
+        throw new IndeterminateError(PROVIDER, 'Fastfrate answered for another probill');
+    const rows = payload.timeline;
+    if (rows.length > MAX_ROWS)
+        invalid('an oversized timeline');
+    if (!rows.length)
+        throw new NotFoundError(PROVIDER);
+    let estimate = null;
+    let appointment = null;
+    const seen = new Set();
+    const events = [];
+    for (const value of rows) {
+        const row = rowOf(value);
+        const wording = normalizeStatusWording(row.wording);
+        // The page shows the first estimate row's day.
+        if (wording === ESTIMATE) {
+            estimate ??= row.clock.slice(0, 10);
+            continue;
+        }
+        if (wording === APPOINTMENT) {
+            appointment = row.clock.slice(0, 10);
+            continue;
+        }
+        const key = JSON.stringify([row.clock, row.wording, row.place]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const staged = fastfrateStage(row.wording);
+        events.push({
+            local_time: row.clock,
+            ...(row.place ? { location: row.place } : {}),
+            description: row.wording,
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        });
+    }
+    if (!events.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first; rows on the same clock keep the reply's order, the later one first.
+    events.sort((a, b) => (a.local_time === b.local_time ? 0 : String(a.local_time) < String(b.local_time) ? -1 : 1)).reverse();
+    // The newest staged row decides, except that the driver's arrival at the shipper never steps
+    // a shipment back, and a delivery settles the rows its stages come before.
+    const staged = events.filter((event) => event.stage);
+    const newest = staged.find((event) => event.stage !== 'registered') ?? staged[0];
+    const delivered = staged.find((event) => event.stage === 'delivered');
+    const decided = delivered && newest && BEFORE_DELIVERY.has(newest.stage) ? delivered : newest;
+    const stage = decided?.stage;
+    const done = stage === 'delivered' || stage === 'returned';
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(decided ? { current_stage: stage, current_stage_source: decided.stage_source } : {}),
+        last_status_text: (decided ?? events[0]).description,
+        last_update: null,
+        last_update_local: events[0].local_time,
+        // The appointment's day, else the estimate's, until the delivery.
+        expected_delivery: done ? null : appointment ?? estimate,
+        events,
+    };
+}

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

@@ -0,0 +1,11 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives Fastfrate's wording, if it knows it. */
+export declare function fastfrateMappedStage(wording: string): Stage | undefined;
+/**
+ * A row's stage from the map, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export declare function fastfrateStage(wording: string): ClassifiedWording | null;
+/** The timeline carries wording only; the map leaves none of it out on purpose. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/fastfrate/status.js

@@ -0,0 +1,50 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The wording of Fastfrate's tracker timeline. Rows carry no code. The driver's
+ * device adds its arrival at and departure from the shipper and the consignee.
+ */
+const STAGES = new Map([
+    ['shipment created', 'registered'],
+    // The shipper's electronic order, before anyone collects the freight.
+    ['shipment accepted from edi', 'registered'],
+    ['driver assigned for pickup', 'registered'],
+    // The pickup driver at the shipper, before the freight is on board.
+    ['arrived at shipper', 'registered'],
+    ['picked up', 'accepted'],
+    // The pickup driver leaving the shipper with the freight.
+    ['departed shipper', 'accepted'],
+    ['on dock at origin terminal', 'in_transit'],
+    ['enroute to destination terminal', 'in_transit'],
+    ['on dock at destination terminal', 'in_transit'],
+    ['appointment requested', 'in_transit'],
+    // A delivery appointment, dated with the appointment's own time.
+    ['scheduled appointment', 'in_transit'],
+    ['loaded to delivery unit', 'out_for_delivery'],
+    // The delivery driver at the consignee and leaving it, around the delivery.
+    ['arrived at consignee', 'out_for_delivery'],
+    ['departed consignee', 'out_for_delivery'],
+    ['delivered', 'delivered'],
+    // The former FastNet page's delivery status.
+    ['delivered by appointment', 'delivered'],
+]);
+/** The stage the map gives Fastfrate's wording, if it knows it. */
+export function fastfrateMappedStage(wording) {
+    return STAGES.get(normalizeStatusWording(wording));
+}
+/**
+ * A row's stage from the map, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export function fastfrateStage(wording) {
+    const mapped = fastfrateMappedStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** The timeline carries wording only; the map leaves none of it out on purpose. */
+export const statusMap = {
+    stage: (code, wording) => (code ? undefined : fastfrateMappedStage(wording)),
+    gaps: [],
+};

package/dist/carriers/fastfrate/statuses.json

@@ -1,6 +1,21 @@
 {
   "carrier": "fastfrate",
   "entries": [
-    {"wording": "DELIVERED BY APPOINTMENT", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "Delivery status on the FastNet quick probill tracker, shown with the delivery and appointment dates."}
+    {"wording": "DELIVERED BY APPOINTMENT", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "Delivery status on the FastNet quick probill tracker, shown with the delivery and appointment dates."},
+    {"wording": "Shipment Created", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup."},
+    {"wording": "Shipment accepted from EDI", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup: the shipper's electronic order, before the pickup."},
+    {"wording": "Driver assigned for Pickup", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup."},
+    {"wording": "Arrived At Shipper", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, stamped by the pickup driver's device, sometimes after the pickup row."},
+    {"wording": "Picked Up", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, with the pickup town."},
+    {"wording": "Departed Shipper", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, stamped by the pickup driver's device."},
+    {"wording": "On Dock at Origin Terminal", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, with the terminal's town."},
+    {"wording": "Enroute to Destination Terminal", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, with the origin terminal's town."},
+    {"wording": "Appointment Requested", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, dated without a time."},
+    {"wording": "On Dock at Destination Terminal", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, with the terminal's town."},
+    {"wording": "Scheduled Appointment", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup dated with the delivery appointment's own time; the adapter reads it as the estimate, not as a scan."},
+    {"wording": "Loaded to Delivery Unit", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, with the delivering terminal's town."},
+    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup."},
+    {"wording": "Arrived at Consignee", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, stamped by the delivery driver's device, seen after the delivery row."},
+    {"wording": "Departed Consignee", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live", "note": "Timeline row of the quick track lookup, stamped by the delivery driver's device, seen after the delivery row."}
   ]
 }

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

@@ -0,0 +1,14 @@
+import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+/** Only the public widget's bounded, two-operand arithmetic grammar is accepted. */
+export declare function solveHuahanQuestion(question: unknown): string;
+export declare class HuahanTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<import("../../index.js").CarrierResult>;
+}
+export declare const adapter: AdapterFactory;