universal-parcel-scraper 0.556.0-main.2575 → 0.558.0-main.2587

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 **600 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **601 dedicated adapters** and **5 universal fallbacks**
 
 <sub>774 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 16,079 such statuses, each filed under one stage.
+The carrier folders record 16,089 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

@@ -17144,7 +17144,8 @@
     "timezone": "Australia/Sydney",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "j-and-t-au",
+      "recognitionRank": 698
     },
     "canaryUrl": "https://www.jtexpress.au/tracking",
     "trackingUrlTemplate": "https://www.jtexpress.au/tracking?q={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 774,
-  "activeAdapters": 600,
+  "activeAdapters": 601,
   "countries": 134,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -39780,6 +39780,31 @@
     "confidence": "none",
     "candidates": []
   },
+  {
+    "input": "48285234834793",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dpd",
+      "ciblex",
+      "hermes-de",
+      "seur",
+      "brt",
+      "delhivery",
+      "dhl-ecommerce-uk",
+      "dpd-be",
+      "dpd-de",
+      "dpd-nl",
+      "dpd-uk"
+    ],
+    "asked": [
+      "hermes-de",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
+    ]
+  },
   {
     "input": "483151203868516",
     "carrier": "unknown",
@@ -77396,6 +77421,14 @@
       "japan-post"
     ]
   },
+  {
+    "input": "LP107777790JP",
+    "carrier": "japan-post",
+    "confidence": "high",
+    "candidates": [
+      "japan-post"
+    ]
+  },
   {
     "input": "LP157079155HK",
     "carrier": "hongkong-post",

package/dist/browser/scraper.js

@@ -13165,7 +13165,8 @@ var Je = {
 		timezone: "Australia/Sydney",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "j-and-t-au",
+			recognitionRank: 698
 		},
 		canaryUrl: "https://www.jtexpress.au/tracking",
 		trackingUrlTemplate: "https://www.jtexpress.au/tracking?q={trackingNumber}",
@@ -25019,7 +25020,7 @@ function on(e) {
 //#endregion
 //#region core/detection/valid.ts
 function sn(e) {
-	return e.length >= 4 && e.length <= 40 && (/^[A-Z0-9]+$/.test(e) || /^\d{4}\/\d{8}$/.test(e));
+	return e.length >= 4 && e.length <= 40 && (/^[A-Z0-9]+(?:_[A-Z0-9]+)?$/.test(e) || /^\d{4}\/\d{8}$/.test(e));
 }
 function cn(e) {
 	let t = n(e);
@@ -29943,6 +29944,7 @@ var Al = {
 	interrapidisimo: 969,
 	"israel-post": 81,
 	"j-and-t": 530,
+	"j-and-t-au": 698,
 	"j-and-t-cargo": 910,
 	janio: 811,
 	jeebly: 805,

package/dist/carriers/j-and-t-au/adapter.d.ts

@@ -0,0 +1,30 @@
+import { type AdapterFactory, type 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 tracking page on www.jtexpress.au makes for the waybills typed in. */
+export declare const J_AND_T_AU_API = "https://official.jtaunz.com/official/logisticsTracking/getDetailByWaybillNo?countryCode=AU";
+/** The app id and signing key the site's script gives every visitor; the page sends the key along as a header too. */
+export declare const J_AND_T_AU_APP_ID = "2BZWAROTK578H7MG9YPWT057NN6IN8T1";
+export declare const J_AND_T_AU_SIGNING_KEY = "cteezp48358yyn6t6l9w8wfz2wctuqs7";
+/**
+ * The page's signature of a request: MD5, in capitals, of the app id, the
+ * timestamp, the nonce, the JSON body with its keys sorted and the key.
+ */
+export declare function jAndTAuSignature(timestamp: string, nonce: string, sortedBody: string): string;
+/** The zone the request names, which the reply writes every scan time in: UTC, so each is an instant. */
+export declare const J_AND_T_AU_ZONE = "GMT+0000";
+/** The page's request for one waybill: its body, and its headers signed over the same fields with their keys sorted. */
+export declare function jAndTAuRequest(number: string): {
+    body: string;
+    headers: Record<string, string>;
+};
+export declare class JAndTAuTracker {
+    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/j-and-t-au/adapter.js

@@ -0,0 +1,89 @@
+import { createHash } from 'node:crypto';
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+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 { J_AND_T_AU_MAX_BYTES, normalizeJAndTAuNumber, parseJAndTAu, PROVIDER } from './parser.js';
+/** The lookup the tracking page on www.jtexpress.au makes for the waybills typed in. */
+export const J_AND_T_AU_API = 'https://official.jtaunz.com/official/logisticsTracking/getDetailByWaybillNo?countryCode=AU';
+/** The app id and signing key the site's script gives every visitor; the page sends the key along as a header too. */
+export const J_AND_T_AU_APP_ID = '2BZWAROTK578H7MG9YPWT057NN6IN8T1'; // gitleaks:allow
+export const J_AND_T_AU_SIGNING_KEY = 'cteezp48358yyn6t6l9w8wfz2wctuqs7'; // gitleaks:allow
+const REDIRECTS = [301, 302, 303, 307, 308];
+// 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|acw_sc__v2|aliyun_waf|_____tmd_____|AwsWafIntegration|awswaf\.com/i;
+/**
+ * The page's signature of a request: MD5, in capitals, of the app id, the
+ * timestamp, the nonce, the JSON body with its keys sorted and the key.
+ */
+export function jAndTAuSignature(timestamp, nonce, sortedBody) {
+    return createHash('md5').update(`${J_AND_T_AU_APP_ID}${timestamp}${nonce}${sortedBody}${J_AND_T_AU_SIGNING_KEY}`).digest('hex').toUpperCase();
+}
+/** The zone the request names, which the reply writes every scan time in: UTC, so each is an instant. */
+export const J_AND_T_AU_ZONE = 'GMT+0000';
+/** The page's request for one waybill: its body, and its headers signed over the same fields with their keys sorted. */
+export function jAndTAuRequest(number) {
+    const timestamp = String(Date.now());
+    const nonce = String(Math.random());
+    return {
+        body: JSON.stringify({ waybillNos: [number], langType: 'EN' }),
+        headers: {
+            langType: 'EN', appId: J_AND_T_AU_APP_ID, timestamp, nonce, countryCode: 'AU', key: J_AND_T_AU_SIGNING_KEY,
+            sign: jAndTAuSignature(timestamp, nonce, JSON.stringify({ langType: 'EN', waybillNos: [number] })),
+            timezone: J_AND_T_AU_ZONE,
+        },
+    };
+}
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        // A JSON lookup answering with a page has been turned away.
+        if (CHALLENGE.test(body.slice(0, 64_000)) || /^\s*</.test(body)) {
+            throw new ChallengeError(PROVIDER, 'J&T Express Australia answered with a page instead of its lookup', { cause });
+        }
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned a reply that is not JSON', { cause });
+    }
+}
+export class JAndTAuTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeJAndTAuNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            // Signed afresh for each try, as the page signs each request.
+            const { body, headers } = jAndTAuRequest(number);
+            const { response, bytes } = await fetchBounded(J_AND_T_AU_API, { method: 'POST', signal, headers: {
+                    Accept: 'application/json, text/plain, */*', 'Content-Type': 'application/json', 'User-Agent': userAgentOf(this.options.userAgent),
+                    ...headers,
+                }, body }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: J_AND_T_AU_MAX_BYTES,
+                redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'J&T Express Australia redirected its tracking lookup');
+            // The lookup answers every waybill with HTTP 200; a 404 is a moved route, not an unknown parcel.
+            if (response.status === 404 || response.status === 410)
+                throw new TransportError(PROVIDER, 'J&T Express Australia tracking lookup is unavailable');
+            return parseJAndTAu(json(decodeText(bytes)), number);
+        };
+        // A request that fails to reach the site, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'j-and-t-au', 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 JAndTAuTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'j-and-t-au', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeJAndTAuNumber(number))),
+    };
+};

package/dist/carriers/j-and-t-au/carrier.json

@@ -19,18 +19,42 @@
   "timezone": "Australia/Sydney",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "j-and-t-au",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 698
+    }
   },
-  "capabilities": [],
+  "capabilities": [
+    "history"
+  ],
   "portal": {
     "url": "https://www.jtexpress.au/tracking?q={trackingNumber}",
     "searchUrl": "https://www.jtexpress.au/tracking",
     "canaryUrl": "https://www.jtexpress.au/tracking",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "office_contact_details"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "offset_timestamps",
+      "delivered_at"
+    ],
+    "discarded": [
+      "office_contact_details"
+    ],
+    "unavailable": [
+      "location",
+      "provider_code",
+      "eta",
+      "weight"
+    ]
   },
   "links": [
     {

package/dist/carriers/j-and-t-au/parser.d.ts

@@ -0,0 +1,18 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "J&T Express Australia";
+export declare const J_AND_T_AU_MAX_BYTES: number;
+/** A waybill for J&T Express Australia's tracker, in upper case as it prints them; anything else is not one it issues. */
+export declare function normalizeJAndTAuNumber(raw: string): string;
+/**
+ * A scan's sentence without the people and phones it can name: anything in
+ * brackets, the customer service line, who signed for the parcel, a person
+ * after their role, and phone numbers.
+ */
+export declare function jAndTAuWording(sentence: string): string;
+/**
+ * The reply of `getDetailByWaybillNo` for one waybill: code 1 with one answer
+ * in `data` per waybill it knows, which names the waybill in `keyword` and
+ * lists its scans in `details`. A waybill it does not know is left out, and
+ * the page then says it has no tracking records: not found.
+ */
+export declare function parseJAndTAu(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/j-and-t-au/parser.js

@@ -0,0 +1,169 @@
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, RateLimitedError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { jAndTAuStage } from './status.js';
+export const PROVIDER = 'J&T Express Australia';
+// A long history is a few kilobytes.
+export const J_AND_T_AU_MAX_BYTES = 512 * 1024;
+// The waybill J&T Express Australia prints: JTAU and twelve digits.
+const NUMBER = /^JTAU\d{12}$/;
+const WALL_CLOCK = /^(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})$/;
+// The page reads a reply as an answer only with this code.
+const ANSWERED = 1;
+// A signature that does not check out, and missing or invalid parameters: the lookup no longer takes the request as sent.
+const REFUSED_REQUEST = new Set([999001010, 999001030, 999001031]);
+const THROTTLED = /too many|too frequent|frequently|rate limit|请求(?:过于)?频繁|访问(?:过于)?频繁/i;
+// Fields that could name the waybill a scan belongs to.
+const IDENTITY = ['waybillNo', 'billCode', 'keyword'];
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+/** A waybill for J&T Express Australia's tracker, in upper case as it prints them; anything else is not one it issues. */
+export function normalizeJAndTAuNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw).toUpperCase() : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'J&T Express Australia waybills are JTAU and twelve digits');
+    return number;
+}
+// The page sets text in 【】 apart; like square brackets, it can hold a person, a phone or a branch.
+const BRACKETED = /【[^】]{0,200}】|\[[^\]]{0,200}\]/gu;
+// The customer service line some scans end with: "Customer service: 13 00 00", "客服热线：130000".
+const HOTLINE = /\s*(?:customer\s+service(?:\s+(?:hotline|number))?|(?:官网)?客服(?:热线|电话)?)\s*[:：]?\s*\+?\d[\d\s-]*\d/giu;
+// Who signed for, received or collected the parcel, to the end of the sentence: "signed for by Sample Person".
+const RECEIVER = /\b((?:signed(?:\s+for)?|received|collected)\s+)by\b[^.。;；]*/giu;
+const ROLES = 'courier|driver|rider|recipient|receiver|consignee|signer|signatory|sender|contact';
+// A role followed by its person, after a colon or in brackets: "Courier: Sample Person", "driver (Sample Person)".
+const PERSON = String.raw `(?:\s*[:：][^.。;；,，]*|(?:\s*(?:\([^)]{0,200}\)|（[^）]{0,200}）))+)`;
+const NAMED = new RegExp(String.raw `\b(${ROLES})${PERSON}`, 'giu');
+const NAMED_ZH = new RegExp(String.raw `(签收人|收件人|寄件人|派件员|快递员|业务员|派送员|收派员|司机|联系人)${PERSON}`, 'gu');
+// A role left alone as the last sentence once its person is gone.
+const BARE_ROLE = new RegExp(String.raw `(?<=[.。])\s*(?:${ROLES})\s*[.。]?$`, 'iu');
+// A run of eight or more digits, with spaces, brackets, dots or hyphens between them, as phone numbers are written; a date stays.
+const PHONE = /(?<![A-Z\d])(?!\d{4}-\d{2}-\d{2}(?!\d))\+?\d(?:[\s().-]{0,2}\d){7,}(?![A-Z\d])/giu;
+/**
+ * A scan's sentence without the people and phones it can name: anything in
+ * brackets, the customer service line, who signed for the parcel, a person
+ * after their role, and phone numbers.
+ */
+export function jAndTAuWording(sentence) {
+    return clean(sentence.replace(BRACKETED, ' ').replace(HOTLINE, '').replace(RECEIVER, '$1').replace(NAMED, '$1')
+        .replace(NAMED_ZH, '$1').replace(PHONE, '').replace(/\(\s*\)|（\s*）/gu, '').replace(/\s+([,.;:!?，。；：])/gu, '$1'))
+        .replace(/([,;:，；：])(?=[.。])/gu, '').replace(BARE_ROLE, '').replace(/^[\s,;:，；：\-–]+|[\s,;:，；：\-–]+$/gu, '');
+}
+/** Any waybill a record names must be the one asked. */
+function checkIdentity(record, number) {
+    for (const key of IDENTITY) {
+        const value = record[key];
+        if (value === null || value === undefined || value === '')
+            continue;
+        if (typeof value !== 'string')
+            throw new SchemaError(PROVIDER, `J&T Express Australia returned an invalid ${key}`);
+        // The whole value, normalized: a different waybill's suffix must not be cut off before comparing.
+        if (normalizeTrackingNumber(value).toUpperCase() !== number) {
+            throw new IndeterminateError(PROVIDER, 'J&T Express Australia answered for another waybill');
+        }
+    }
+}
+/** A scan's instant: `scanTime`, which the reply writes in the zone the request named, UTC. */
+function scanTime(row) {
+    const match = WALL_CLOCK.exec(typeof row.scanTime === 'string' ? row.scanTime.trim() : '');
+    const clock = match ? `${match[1]}T${match[2]}` : '';
+    const parsed = DateTime.fromISO(clock, { zone: 'UTC' });
+    // Luxon rolls 24:00 over to the next day; only a clock that reads back unchanged is kept.
+    if (!match || !parsed.isValid || parsed.toFormat("yyyy-MM-dd'T'HH:mm:ss") !== clock) {
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned an invalid scan time');
+    }
+    return parsed.toISO({ suppressMilliseconds: true });
+}
+/** One scan: its instant and its sentence. A sentence that named only people or phones is no scan. */
+function projectRow(row, number) {
+    checkIdentity(row, number);
+    if (typeof row.customerTracking !== 'string' || !clean(row.customerTracking)) {
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned a scan without wording');
+    }
+    const time = scanTime(row);
+    const description = jAndTAuWording(clean(row.customerTracking, 1000)).slice(0, 300);
+    if (!description)
+        return null;
+    const staged = jAndTAuStage(description);
+    const event = {
+        time,
+        description,
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+    return { key: JSON.stringify([time, description]), event };
+}
+/** The refusal or failure a reply that is not an answer stands for. */
+function failure(payload) {
+    const message = clean(payload.msg, 200);
+    if (THROTTLED.test(message))
+        return new RateLimitedError(PROVIDER, undefined, 'J&T Express Australia refused more lookups for now');
+    if (typeof payload.code === 'number' && REFUSED_REQUEST.has(payload.code)) {
+        return new SchemaError(PROVIDER, 'J&T Express Australia refused the lookup’s signature or parameters');
+    }
+    return new IndeterminateError(PROVIDER, 'J&T Express Australia did not complete the lookup');
+}
+/**
+ * The reply of `getDetailByWaybillNo` for one waybill: code 1 with one answer
+ * in `data` per waybill it knows, which names the waybill in `keyword` and
+ * lists its scans in `details`. A waybill it does not know is left out, and
+ * the page then says it has no tracking records: not found.
+ */
+export function parseJAndTAu(payload, raw) {
+    const number = normalizeJAndTAuNumber(raw);
+    if (!isRecord(payload) || typeof payload.code !== 'number')
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned an invalid envelope');
+    if (payload.code !== ANSWERED)
+        throw failure(payload);
+    const answers = payload.data;
+    if (!Array.isArray(answers))
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned invalid answers');
+    for (const answer of answers) {
+        if (!isRecord(answer) || typeof answer.keyword !== 'string' || !answer.keyword) {
+            throw new SchemaError(PROVIDER, 'J&T Express Australia did not name the waybill it answered for');
+        }
+        checkIdentity(answer, number);
+    }
+    if (answers.length > 1)
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned more than one answer for the waybill');
+    const answer = answers[0];
+    if (!answer)
+        throw new NotFoundError(PROVIDER);
+    const rows = answer.details ?? [];
+    if (!Array.isArray(rows))
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned invalid scans');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'J&T Express Australia returned an oversized history');
+    const seen = new Set();
+    const scans = [];
+    for (const row of rows) {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'J&T Express Australia returned an invalid scan');
+        const scan = projectRow(row, number);
+        if (!scan || seen.has(scan.key))
+            continue;
+        seen.add(scan.key);
+        scans.push({ index: scans.length, event: scan.event });
+    }
+    // A waybill the tracker knows without a scan has no history.
+    if (!scans.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first, as the page sorts them by time; scans at one time keep the reply's order.
+    const clock = (event) => event.time;
+    const newestFirst = scans.sort((a, b) => clock(b.event).localeCompare(clock(a.event)) || a.index - b.index).map(({ event }) => event);
+    const newest = newestFirst[0];
+    const staged = newestFirst.find((event) => event.stage);
+    const stage = staged?.stage;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: staged.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time,
+        expected_delivery: null,
+        ...(stage === 'delivered' ? { delivered_at: staged.time } : {}),
+        events: newestFirst.slice(0, MAX_EVENTS),
+        ...(newestFirst.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/j-and-t-au/status.d.ts

@@ -0,0 +1,7 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives a scan's wording. */
+export declare function jAndTAuMappedStage(wording: string): Stage | undefined;
+/** A scan's stage: its wording in the map, else the shared wording rules, else nothing. */
+export declare function jAndTAuStage(wording: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/j-and-t-au/status.js

@@ -0,0 +1,36 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/** A wording as the map keys it: normalized, without a closing full stop. */
+const key = (wording) => normalizeStatusWording(wording).replace(/[\s.。]+$/u, '');
+/**
+ * The tracker's scans carry no code, only a sentence. Those seen in replies are
+ * mapped, in English and in the Chinese the tracker answers other languages
+ * with; other wording falls to the shared rules.
+ */
+const WORDINGS = new Map([
+    // J&T collected an imported parcel from the customs broker; the shared rules would read it as held by customs.
+    ['The parcel has been picked up from customs clearance.', 'accepted'],
+    ['包裹已从清关行取件。', 'accepted'],
+    ['The parcel has been successfully picked up and is being prepared for transportation.', 'accepted'],
+    ['快件已揽收成功，运输准备中。', 'accepted'],
+    ['The parcel arrives at the distribution center and is prepared for transport to the next destination.', 'in_transit'],
+    ['快件到达转运中心，做发往下一站的运输准备', 'in_transit'],
+    ['The parcel is dispatched from the transit center to the next destination', 'in_transit'],
+    ['快件从转运中心发往下一站', 'in_transit'],
+].map(([wording, stage]) => [key(wording), stage]));
+/** The stage the map gives a scan's wording. */
+export function jAndTAuMappedStage(wording) {
+    return WORDINGS.get(key(wording));
+}
+/** A scan's stage: its wording in the map, else the shared wording rules, else nothing. */
+export function jAndTAuStage(wording) {
+    const mapped = jAndTAuMappedStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+export const statusMap = {
+    stage: (_code, wording) => jAndTAuMappedStage(wording),
+    gaps: [],
+};

package/dist/carriers/j-and-t-au/statuses.json

@@ -1,4 +1,13 @@
 {
   "carrier": "j-and-t-au",
-  "entries": []
+  "entries": [
+    {"wording": "The parcel has been picked up from customs clearance.", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "J&T's first scan of an imported parcel, collected from the customs broker after clearance. The tracker ends it with its customer service number, which the adapter drops."},
+    {"wording": "包裹已从清关行取件。", "stage": "accepted", "language": "zh", "confirmedBy": "live", "note": "The Chinese text of the same scan, which the tracker also gives when asked in German."},
+    {"wording": "The parcel has been successfully picked up and is being prepared for transportation.", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "The tracker ends it with its customer service number, which the adapter drops."},
+    {"wording": "快件已揽收成功，运输准备中。", "stage": "accepted", "language": "zh", "confirmedBy": "live"},
+    {"wording": "The parcel arrives at the distribution center and is prepared for transport to the next destination.", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "快件到达转运中心，做发往下一站的运输准备", "stage": "in_transit", "language": "zh", "confirmedBy": "live"},
+    {"wording": "The parcel is dispatched from the transit center to the next destination", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "快件从转运中心发往下一站", "stage": "in_transit", "language": "zh", "confirmedBy": "live"}
+  ]
 }

package/dist/carriers/japan-post/numbers.json

@@ -958,6 +958,25 @@
         "confidence": "high"
       },
       "note": "A Japan Post tracking link archived by the Wayback Machine. Japan Post's tracker returns its international history."
+    },
+    {
+      "number": "LP107777790JP",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20261005062200/https://trackings.post.japanpost.jp/services/srv/search/direct?locale=en&reqCodeNo1=LP107777790JP",
+        "date": "2026-10-05",
+        "dateKind": "capture",
+        "access": "full_page"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "japan-post",
+        "confidence": "high"
+      },
+      "note": "A Japan Post tracking link archived by the Wayback Machine. Japan Post's tracker returns its international history."
     }
   ]
 }

package/dist/carriers/mrw/parser.js

@@ -96,15 +96,15 @@ function officeLabel(value) {
  * Ceuta's and Melilla's offices among them, 052 for Gibraltar and 060 for
  * Andorra, all on Madrid's clock. The Canary Islands' 049 and 050 and
  * Portugal's 070 to 089 keep clocks of their own, and nothing shows whether
- * their rows are written on the office's clock or on Madrid's; MRW Points'
+ * their rows are written on the office's clock or on Madrid's; pickup points'
  * codes name no province. Those, and an office named for a town of the Canary
  * Islands, have none.
  */
-function officeZone(location) {
-    const office = /^(\d{3})\d{2}\s+(.+?)(?: \([\p{L} ]+\))?$/u.exec(location);
-    if (!office || regionHasTown('ES-CN', office[2]))
+function officeZone(location, points) {
+    const office = /^((\d{3})\d{2})\s+(.+?)(?: \([\p{L} ]+\))?$/u.exec(location);
+    if (!office || points.has(office[1]) || regionHasTown('ES-CN', office[3]))
         return null;
-    const province = Number(office[1]);
+    const province = Number(office[2]);
     if (province >= 1 && province <= 48)
         return 'Europe/Madrid';
     return province === 52 ? 'Europe/Gibraltar' : province === 60 ? 'Europe/Andorra' : null;
@@ -115,9 +115,9 @@ function instant(wall, zone) {
     return placed.isValid && placed.toFormat("yyyy-MM-dd'T'HH:mm:ss") === wall ? placed.toISO({ suppressMilliseconds: true }) : null;
 }
 /** A row's clock: an instant when its office settles the zone, else the wall clock or the text as shown. */
-function rowClock(rawDate, rawHour, location) {
+function rowClock(rawDate, rawHour, location, points) {
     const clock = buildLocalDate(rawDate, rawHour);
-    const zone = location ? officeZone(location) : null;
+    const zone = location ? officeZone(location, points) : null;
     const time = zone && clock.local_time ? instant(clock.local_time, zone) : null;
     return time ? { time } : clock;
 }
@@ -155,6 +155,13 @@ export function parseMrwHistory(html, raw, summary) {
         throw new IndeterminateError('MRW', 'Shipment history is empty');
     if (rows.length > 500)
         throw new SchemaError('MRW', 'Shipment history is unexpectedly large');
+    // A pickup point's place links to its map; a later row there, such as the
+    // collection, shows its code without the link.
+    const points = new Set(rows.toArray().flatMap((row) => {
+        const place = $(row).children('td').eq(3);
+        const code = /^\d{5}(?=\s)/.exec(officeLabel(place.text()))?.[0];
+        return code && place.find('a[onclick*="openMap"]').length ? [code] : [];
+    }));
     const events = [];
     const seen = new Set();
     // MRW renders the current row first. Do not promote an older dated row when
@@ -171,7 +178,7 @@ export function parseMrwHistory(html, raw, summary) {
         // Read visible text only. The PointCorner link embeds a full store address
         // and map arguments in onclick; they must never enter the result.
         const location = officeLabel(cells.eq(3).text());
-        const clock = rowClock(date, hour, location);
+        const clock = rowClock(date, hour, location, points);
         const key = JSON.stringify([date, hour, rawStatus, location]);
         if (seen.has(key))
             continue;

package/dist/carriers/seur/numbers.json

@@ -613,6 +613,40 @@
         ]
       },
       "note": "Made-up number in the layout of a sender's reference, dated day before month, that SEUR's lookup found for its shipments."
+    },
+    {
+      "number": "48285234834793",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/reclamaci-C3-B3n-formal-contra-seur/3d4034ae564773a03b",
+        "date": "2026-10-14",
+        "dateKind": "publication",
+        "access": "full_page"
+      },
+      "context": {
+        "assessment": "confirmed",
+        "reportedRole": "shipment_tracking",
+        "service": "SEUR"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dpd",
+          "ciblex",
+          "hermes-de",
+          "seur",
+          "brt",
+          "delhivery",
+          "dhl-ecommerce-uk",
+          "dpd-be",
+          "dpd-de",
+          "dpd-nl",
+          "dpd-uk"
+        ]
+      },
+      "note": "Tracking number in a complaint about a locker drop-off; SEUR's tracker returns its history."
     }
   ]
 }

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

@@ -0,0 +1,2 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/sf-express/identity.js

@@ -0,0 +1,6 @@
+// Universal providers copy SF's scans to the second, on the same UTC+08:00
+// clock, in their own wording. The scan SF itself returns at that instant
+// takes over the copy, and over its own row stored under older wording.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'sf-express', storedSources: ['sf-express', 'unknown'], requireProviderCode: false,
+};

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

@@ -83,7 +83,7 @@ export function parse(payload, trackingNumber) {
         const reason = clean(raw.stayWhyCode, 64);
         if (!/^[A-Z0-9_-]{1,64}$/.test(code))
             throw new SchemaError(PROVIDER, 'SF Express returned an invalid operation code');
-        const status = sfExpressEventStatus(code, reason);
+        const status = sfExpressEventStatus(code, reason, text);
         const event = { time, provider_code: code,
             description: status?.status === 'delivered' ? 'Delivered' : text,
             ...(status ? { stage: status.stage } : {}),

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

@@ -1,4 +1,4 @@
 import type { ClassifiedStatus } from '../../core/status/index.js';
-/** Codes 8000 and 70 are ambiguous without their reason; do not default them to signed. */
-export declare function sfExpressEventStatus(code: string, reason: string): ClassifiedStatus | undefined;
+/** Codes 8000 and 70 are ambiguous without their reason, and 99 without its remark; do not default them to signed. */
+export declare function sfExpressEventStatus(code: string, reason: string, remark?: string): ClassifiedStatus | undefined;
 export declare function sfExpressSummaryStatus(state: string, signed: boolean): ClassifiedStatus | undefined;

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

@@ -15,8 +15,7 @@ const UNDELIVERED = new Map([
 const SUMMARY = new Map([['2', EXCEPTION], ['3', TRANSIT], ['4', RETURNED], ['5', EXCEPTION], ['6', EXCEPTION], ['99', TRANSIT], ['100', DELIVERED]]);
 // The official Taiwan frontend's operation-code groups, plus codes observed in
 // its public route response whose remarks settle them. The warehouse
-// "delivered" group means dispatched. Code 99 reads both "being returned" and
-// "being forwarded", so it stays unclassified.
+// "delivered" group means dispatched. Code 99 is read by its remark.
 const CODES = new Map([
     ...['80', '980'].map((code) => [code, DELIVERED]),
     ...['50', '54', '950'].map((code) => [code, { stage: 'accepted', status: 'in_transit' }]),
@@ -28,13 +27,21 @@ const CODES = new Map([
     ...['98', '208', '649', '310', '115', '116', '302', '305'].map((code) => [code, TRANSIT]),
     ['605', { stage: 'customs', status: 'in_transit' }],
 ]);
-/** Codes 8000 and 70 are ambiguous without their reason; do not default them to signed. */
-export function sfExpressEventStatus(code, reason) {
+// Code 99 carries several notices: one on its way back to the sender, or one
+// sent on to another address. Other remarks stay unclassified.
+const NOTICES = [
+    [/^The shipment is being returned\.?$/i, RETURNED],
+    [/^The shipment is being forwarded\.?$/i, TRANSIT],
+];
+/** Codes 8000 and 70 are ambiguous without their reason, and 99 without its remark; do not default them to signed. */
+export function sfExpressEventStatus(code, reason, remark = '') {
     if (code === '8000') {
         return REASONS.get(reason);
     }
     if (code === '70')
         return UNDELIVERED.get(reason);
+    if (code === '99')
+        return NOTICES.find(([wording]) => wording.test(remark.trim()))?.[1];
     return CODES.get(code);
 }
 export function sfExpressSummaryStatus(state, signed) {

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

@@ -406,6 +406,24 @@
       "confirmedBy": "bundle",
       "firstSeen": "2026-09-26",
       "note": "Shipment summary vocabulary from official abroad/billDetailItem/mixins. State 99 yields to a more specific latest scan."
+    },
+    {
+      "code": "99",
+      "wording": "The shipment is being returned",
+      "stage": "returned",
+      "language": "en",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-20",
+      "note": "Official Taiwan routes opCode 99, which carries several notices; this remark says the parcel is on its way back to the sender."
+    },
+    {
+      "code": "99",
+      "wording": "The shipment is being forwarded",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-20",
+      "note": "Official Taiwan routes opCode 99 with this remark: the parcel is sent on to another address."
     }
   ]
 }

package/dist/core/catalog/eventIdentity.js

@@ -27,13 +27,14 @@ import { sameInstantIdentityPolicy as postaSlovenije } from '../../carriers/post
 import { sameInstantIdentityPolicy as posteItaliane } from '../../carriers/poste-italiane/identity.js';
 import { sameInstantIdentityPolicy as posti } from '../../carriers/posti/identity.js';
 import { sameInstantIdentityPolicy as royalMail } from '../../carriers/royal-mail/identity.js';
+import { sameInstantIdentityPolicy as sfExpress } from '../../carriers/sf-express/identity.js';
 import { sameInstantIdentityPolicy as speedpak } from '../../carriers/speedpak/identity.js';
 import { sameInstantIdentityPolicy as sunYou } from '../../carriers/sunyou/identity.js';
 import { sameInstantIdentityPolicy as ups } from '../../carriers/ups/app.js';
 import { sameInstantIdentityPolicy as swissPost } from '../../carriers/swiss-post/app.js';
 import { sameInstantIdentityPolicy as yanwen } from '../../carriers/yanwen/app.js';
 import { sameInstantIdentityPolicy as universal } from '../../providers/shared/app.js';
-const policies = new Map([aliexpress, amazonShipping, australiaPost, austrianPost, canadaPost, chronopost, ciblex, correosExpress, correosSpain, ctt, dhlEcommerce, dpd, dpdFrance, hermesGermany, indiaPost, inpost, jdLogistics, laPoste, lbcExpress, mondialRelay, mrw, nzPost, packeta, posMalaysia, postlogistics, postaSlovenije, posteItaliane, posti, royalMail, speedpak, sunYou, ups, swissPost, yanwen, universal].map((policy) => [policy.sourceCarrierId, policy]));
+const policies = new Map([aliexpress, amazonShipping, australiaPost, austrianPost, canadaPost, chronopost, ciblex, correosExpress, correosSpain, ctt, dhlEcommerce, dpd, dpdFrance, hermesGermany, indiaPost, inpost, jdLogistics, laPoste, lbcExpress, mondialRelay, mrw, nzPost, packeta, posMalaysia, postlogistics, postaSlovenije, posteItaliane, posti, royalMail, sfExpress, speedpak, sunYou, ups, swissPost, yanwen, universal].map((policy) => [policy.sourceCarrierId, policy]));
 /** Unlisted sources cannot identify a reworded scan by its instant alone. */
 export function sameInstantIdentityPolicy(sourceCarrierId, options = {}) {
     const policy = policies.get(sourceCarrierId);

package/dist/core/catalog/statusMaps.js

@@ -250,6 +250,7 @@ import { statusMap as interrapidisimo } from '../../carriers/interrapidisimo/sta
 import { statusMap as intexPaketdienst } from '../../carriers/intex-paketdienst/status.js';
 import { statusMap as israelPost } from '../../carriers/israel-post/status.js';
 import { statusMap as jAndT } from '../../carriers/j-and-t/status.js';
+import { statusMap as jAndTAu } from '../../carriers/j-and-t-au/status.js';
 import { statusMap as jntCargo } from '../../carriers/j-and-t-cargo/status.js';
 import { statusMap as jAndTMiddleEast } from '../../carriers/j-and-t-middle-east/status.js';
 import { statusMap as janio } from '../../carriers/janio/status.js';
@@ -563,7 +564,7 @@ export const STATUS_MAPS = {
     'houng-ah-loun': houngAhLoun, hovership, 'hr-parcel': hrParcel, 'hrvatska-posta': hrvatskaPosta, huahan, 'hunter-express': hunterExpress, hywl,
     'icc-worldwide': iccWorldwide, 'ics-courier': icsCourier, 'ids-logistik': idsLogistik, 'ilyang-logis': ilyangLogis, imile,
     'indah-logistik': indahLogistik, instabox, 'integral-pack': integralPack, 'internet-express': internetExpress, interrapidisimo,
-    'intex-paketdienst': intexPaketdienst, 'israel-post': israelPost, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo,
+    'intex-paketdienst': intexPaketdienst, 'israel-post': israelPost, 'j-and-t': jAndT, 'j-and-t-au': jAndTAu, 'j-and-t-cargo': jntCargo,
     'j-and-t-middle-east': jAndTMiddleEast, janio, jcex, jeebly, 'jersey-post': jerseyPost, 'jet-logistic': jetLogistic, 'jetline-couriers': jetlineCouriers,
     jhgj, jitsu, jne, 'jordan-post': jordanPost, jrt, 'js-express': jsExpress, jumppoint, kazpost, kex, 'kex-express-hk': kexExpressHk,
     'kit-tk': kitTk, 'kuehne-nagel': kuehneNagel, kunyoung, kyoungdong, 'kyrgyz-post': kyrgyzPost, 'l-post': lPost, 'la-poste': laPoste,

package/dist/core/detection/valid.js

@@ -11,9 +11,10 @@ import { normalizeTrackingNumber } from './normalize.js';
 function hasTrackingShape(normalized) {
     return normalized.length >= 4
         && normalized.length <= 40
-        // The NACEX agency/shipment composite is the only tracking shape allowed
-        // to keep punctuation; everything else stays strict alphanumeric.
-        && (/^[A-Z0-9]+$/.test(normalized) || /^\d{4}\/\d{8}$/.test(normalized));
+        // Letters and digits, with one underscore inside as Better Trucks writes
+        // its BTS_ numbers. The NACEX agency/shipment composite is the only other
+        // shape allowed to keep punctuation.
+        && (/^[A-Z0-9]+(?:_[A-Z0-9]+)?$/.test(normalized) || /^\d{4}\/\d{8}$/.test(normalized));
 }
 /**
  * Shape gate for a number entered whole or carried by a carrier's link. A number

package/dist/data/catalog.json

@@ -17144,7 +17144,8 @@
         "timezone": "Australia/Sydney",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "j-and-t-au",
+            "recognitionRank": 698
         },
         "canaryUrl": "https://www.jtexpress.au/tracking",
         "trackingUrlTemplate": "https://www.jtexpress.au/tracking?q={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -11082,7 +11082,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Australia/Sydney";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "j-and-t-au";
+            readonly recognitionRank: 698;
         };
         readonly canaryUrl: "https://www.jtexpress.au/tracking";
         readonly trackingUrlTemplate: "https://www.jtexpress.au/tracking?q={trackingNumber}";

package/dist/generated/catalog.js

@@ -17145,7 +17145,8 @@ export const CARRIER_CATALOG = {
         "timezone": "Australia/Sydney",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "j-and-t-au",
+            "recognitionRank": 698
         },
         "canaryUrl": "https://www.jtexpress.au/tracking",
         "trackingUrlTemplate": "https://www.jtexpress.au/tracking?q={trackingNumber}",

package/dist/generated/recognition.js

@@ -219,6 +219,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "interrapidisimo": 969,
     "israel-post": 81,
     "j-and-t": 530,
+    "j-and-t-au": 698,
     "j-and-t-cargo": 910,
     "janio": 811,
     "jeebly": 805,

package/dist/generated/registry.js

@@ -286,6 +286,7 @@ import { adapter as interrapidisimo } from '../carriers/interrapidisimo/adapter.
 import { adapter as intexPaketdienst } from '../carriers/intex-paketdienst/adapter.js';
 import { adapter as israelPost } from '../carriers/israel-post/adapter.js';
 import { adapter as jAndT } from '../carriers/j-and-t/adapter.js';
+import { adapter as jAndTAu } from '../carriers/j-and-t-au/adapter.js';
 import { adapter as jAndTCargo } from '../carriers/j-and-t-cargo/adapter.js';
 import { adapter as jAndTMiddleEast } from '../carriers/j-and-t-middle-east/adapter.js';
 import { adapter as janio } from '../carriers/janio/adapter.js';
@@ -888,6 +889,7 @@ export const REGISTRY = {
         "intex-paketdienst": intexPaketdienst,
         "israel-post": israelPost,
         "j-and-t": jAndT,
+        "j-and-t-au": jAndTAu,
         "j-and-t-cargo": jAndTCargo,
         "j-and-t-middle-east": jAndTMiddleEast,
         "janio": janio,
@@ -1563,7 +1565,7 @@ export const REGISTRY = {
         "iran-post": "universal",
         "israel-post": "israel-post",
         "j-and-t": "j-and-t",
-        "j-and-t-au": "universal",
+        "j-and-t-au": "j-and-t-au",
         "j-and-t-br": "universal",
         "j-and-t-cargo": "j-and-t-cargo",
         "j-and-t-cn": "universal",

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.556.0"
+    "version": "0.558.0"
   },
   "paths": {
     "/health": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-parcel-scraper",
-  "version": "0.556.0-main.2575",
+  "version": "0.558.0-main.2587",
   "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
   "type": "module",
   "license": "Apache-2.0",
@@ -62,6 +62,7 @@
     "test": "vitest run",
     "test:scripts": "node --test trawl/*.test.mjs scripts/*.test.mjs",
     "generate": "node scripts/generate-catalog.mjs && node scripts/generate-registry.mjs --strict && node scripts/generate-region-towns.mjs && node scripts/benchmark.mjs routing && node scripts/coverage-tables.mjs && node scripts/generate-readme.mjs",
+    "generate:golden": "node scripts/detection-golden.mjs",
     "test:generated": "node scripts/generate-catalog.mjs --check && node scripts/generate-registry.mjs --strict --check && node scripts/generate-region-towns.mjs --check && node scripts/benchmark.mjs routing --check && node scripts/coverage-tables.mjs --check && node scripts/generate-readme.mjs --check",
     "test:package": "node scripts/test-package.mjs",
     "test:carriers:live": "vitest run --config vitest.carriers-live.config.ts",