universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/usps/numbers.json

@@ -0,0 +1,286 @@
+{
+  "carrier": "usps",
+  "records": [
+    {
+      "number": "03071790000523483741",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "usps",
+          "nz-post",
+          "poczta-polska"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "70041160000026196575",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://docs.fcc.gov/public/attachments/FCC-26-44A1.pdf"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "usps",
+          "nz-post",
+          "poczta-polska"
+        ]
+      },
+      "note": "Certified-mail number printed in an FCC order. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "71123456789123456787",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "usps",
+          "nz-post",
+          "poczta-polska"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "71969010756003077385",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "usps",
+          "nz-post",
+          "poczta-polska"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9101123456789000000013",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9261290336128704042634",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9400111201080805483016",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9400111206206406260787",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9405803699300124287899",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9434611206206406227577",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Open-source project example, not a real shipment. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9500113562366007585132",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.govinfo.gov/content/pkg/USCOURTS-ilsd-3_25-cv-02196/pdf/USCOURTS-ilsd-3_25-cv-02196-0.pdf"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Tracking number quoted in a public court record. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "9589071052702449080343",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.govinfo.gov/content/pkg/USCOURTS-ilsd-3_25-cv-02196/pdf/USCOURTS-ilsd-3_25-cv-02196-0.pdf"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Tracking number quoted in a public court record. The source attributes it to USPS, which stays one candidate among several."
+    },
+    {
+      "number": "4201002334249200190132607600833457",
+      "role": "full_barcode",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Open-source project example, not a real shipment. Full label barcode rather than the number a user types. The source attributes it to USPS; no rule matches this shape."
+    },
+    {
+      "number": "4201028200009261290113185417468510",
+      "role": "full_barcode",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Open-source project example, not a real shipment. Full label barcode rather than the number a user types. The source attributes it to USPS; no rule matches this shape."
+    },
+    {
+      "number": "420221539101026837331000039521",
+      "role": "full_barcode",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Open-source project example, not a real shipment. Full label barcode rather than the number a user types. The source attributes it to USPS; no rule matches this shape."
+    },
+    {
+      "number": "420787459400111206206406260787",
+      "role": "full_barcode",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Open-source project example, not a real shipment. Full label barcode rather than the number a user types. The source attributes it to USPS; no rule matches this shape."
+    },
+    {
+      "number": "420902459261290336128704042634",
+      "role": "full_barcode",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/jkeen/tracking_number_data/blob/main/couriers/usps.json"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "none"
+      },
+      "note": "Open-source project example, not a real shipment. Full label barcode rather than the number a user types. The source attributes it to USPS; no rule matches this shape."
+    }
+  ]
+}

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

@@ -0,0 +1,25 @@
+/**
+ * USPS status vocabulary.
+ *
+ * The tracking page renders English prose (the status banner and the history
+ * rows) with no stable per-event code, so wording is matched on substrings.
+ * The map produces a result-level `CarrierStatus` and, when the wording is
+ * recognized, the event `Stage`.
+ *
+ * Wording provenance: the official Tracking API vocabulary and its published
+ * examples (DELIVERED, OUT FOR DELIVERY, IN TRANSIT, PRE-SHIPMENT, ALERT,
+ * NOTICE LEFT, ARRIVED, DEPARTED, ACCEPTED, PICKED UP — prior art).
+ * `statuses.json` holds the full list.
+ */
+import type { CarrierStatus } from '../../core/result/index.js';
+import type { Stage } from '../../core/status/index.js';
+/**
+ * Classify USPS status prose. Returns null when nothing matches, so callers
+ * leave an event unstaged rather than invent a stage. `hasEvents` reports an
+ * existing history, which makes unrecognized wording "moving" rather than
+ * "unknown" at the result level.
+ */
+export declare function uspsStage(text: string): Stage | null;
+export declare function statusForStage(stage: Stage): CarrierStatus;
+/** The result-level status for banner and history wording. */
+export declare function uspsStatus(text: string, hasEvents?: boolean): CarrierStatus;

package/dist/carriers/usps/status.js

@@ -0,0 +1,72 @@
+const RETURNED_TERMS = ['return to sender', 'returned to sender', 'returning to sender'];
+const FAILED_ATTEMPT_TERMS = [
+    'delivery attempted', 'delivery attempt', 'notice left', 'no access',
+    'receptacle blocked', 'business closed', 'no secure location', 'no authorized recipient',
+    'missed delivery', 'redelivery', 'unclaimed', 'vacant', 'no such number',
+];
+const EXCEPTION_TERMS = ['alert', 'exception', 'damaged', 'lost', 'seized', 'dispute', 'held at post office', 'held for pickup'];
+const DELIVERED_TERMS = ['delivered'];
+const OUT_FOR_DELIVERY_TERMS = ['out for delivery'];
+const READY_FOR_PICKUP_TERMS = ['available for pickup', 'available for pick-up', 'pickup', 'pick up', 'arrived at post office', 'arrived at unit', 'at post office'];
+const REGISTERED_TERMS = [
+    'pre-shipment', 'preshipment', 'shipping label created', 'label created',
+    'acceptance pending', 'usps awaiting item', 'awaiting item', 'order received',
+];
+const ACCEPTED_TERMS = ['accepted', 'picked up', 'picked-up', 'tendered', 'shipment received', 'arrival at unit', 'arrived at usps'];
+const CUSTOMS_TERMS = ['customs', 'clearance'];
+const IN_TRANSIT_TERMS = [
+    'in transit', 'on its way', 'in-transit', 'arrived', 'departed', 'departure',
+    'arrival', 'processed', 'processing', 'distribution center', 'sorting facility',
+    'en route', 'in route', 'forwarded', 'transferred', 'tendered to',
+];
+/**
+ * Classify USPS status prose. Returns null when nothing matches, so callers
+ * leave an event unstaged rather than invent a stage. `hasEvents` reports an
+ * existing history, which makes unrecognized wording "moving" rather than
+ * "unknown" at the result level.
+ */
+export function uspsStage(text) {
+    const value = text.toLocaleLowerCase('en-US');
+    if (!value)
+        return null;
+    if (RETURNED_TERMS.some((term) => value.includes(term)))
+        return 'returned';
+    if (FAILED_ATTEMPT_TERMS.some((term) => value.includes(term)))
+        return 'failed_attempt';
+    if (DELIVERED_TERMS.some((term) => value.includes(term)))
+        return 'delivered';
+    if (OUT_FOR_DELIVERY_TERMS.some((term) => value.includes(term)))
+        return 'out_for_delivery';
+    if (READY_FOR_PICKUP_TERMS.some((term) => value.includes(term)))
+        return 'ready_for_pickup';
+    if (CUSTOMS_TERMS.some((term) => value.includes(term)))
+        return 'customs';
+    if (EXCEPTION_TERMS.some((term) => value.includes(term)))
+        return 'exception';
+    if (REGISTERED_TERMS.some((term) => value.includes(term)))
+        return 'registered';
+    if (ACCEPTED_TERMS.some((term) => value.includes(term)))
+        return 'accepted';
+    if (IN_TRANSIT_TERMS.some((term) => value.includes(term)))
+        return 'in_transit';
+    return null;
+}
+export function statusForStage(stage) {
+    if (stage === 'delivered')
+        return 'delivered';
+    if (stage === 'out_for_delivery' || stage === 'ready_for_pickup')
+        return 'out_for_delivery';
+    if (stage === 'exception' || stage === 'failed_attempt' || stage === 'returned')
+        return 'exception';
+    if (stage === 'registered' || stage === 'pending')
+        return 'pending';
+    return 'in_transit';
+}
+/** The result-level status for banner and history wording. */
+export function uspsStatus(text, hasEvents = false) {
+    const stage = uspsStage(text);
+    if (stage)
+        return statusForStage(stage);
+    // Unrecognized wording only means "moving" once the shipment has scans.
+    return hasEvents ? 'in_transit' : 'unknown';
+}

package/dist/carriers/usps/statuses.json

@@ -0,0 +1,24 @@
+{
+  "carrier": "usps",
+  "entries": [
+    { "wording": "Delivered", "language": "en", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Official Tracking API vocabulary. A delivered line may name who signed; the adapter replaces the description with this word." },
+    { "wording": "Delivered, Front Door/Porch", "language": "en", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Sandbox example from the official API examples repository." },
+    { "wording": "Delivered, In/At Mailbox", "language": "en", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Sandbox example from the official API examples repository." },
+    { "wording": "Out for Delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Official Tracking API vocabulary." },
+    { "wording": "Available for Pickup", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: out_for_delivery." },
+    { "wording": "Arrived at Post Office", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Sandbox example; held for collection. Adapter result status: out_for_delivery." },
+    { "wording": "In Transit", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Official Tracking API vocabulary." },
+    { "wording": "Arrived at USPS Regional Facility", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "" },
+    { "wording": "Departed USPS Regional Facility", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "" },
+    { "wording": "Accepted at USPS Origin Facility", "language": "en", "stage": "accepted", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: in_transit." },
+    { "wording": "Picked Up by Shipping Partner", "language": "en", "stage": "accepted", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Sandbox example; the partner holds the item. Adapter result status: in_transit." },
+    { "wording": "Pre-Shipment", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Label created, item not yet with USPS. Adapter result status: pending." },
+    { "wording": "Shipping Label Created", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: pending." },
+    { "wording": "USPS Awaiting Item", "language": "en", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: pending." },
+    { "wording": "Notice Left", "language": "en", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Sandbox example. Adapter result status: exception." },
+    { "wording": "Delivery Attempted - No Access to Delivery Location", "language": "en", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Sandbox example. Adapter result status: exception." },
+    { "wording": "Alert", "language": "en", "stage": "exception", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Official Tracking API vocabulary." },
+    { "wording": "Return to Sender", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-09-20", "note": "Adapter result status: exception." },
+    { "wording": "Tracking Not Available", "language": "en", "stage": "pending", "confirmedBy": "live", "firstSeen": "2026-09-20", "note": "Rendered verdict banner for unknown or expired numbers; the adapter reports the unlocated unknown result, never a stage." }
+  ]
+}

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

@@ -0,0 +1,13 @@
+import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeYamatoNumber(raw: string): string;
+export declare function parse(html: string, trackingNumber: string): CarrierResult;
+export declare class YamatoTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        timeoutMs?: number;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/yamato/adapter.js

@@ -0,0 +1,130 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, InputRequiredError, NotFoundError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
+import { clean, decodeText, fetchBounded } from '../../core/transport/index.js';
+import { yamatoStatus } from './status.js';
+const PROVIDER = 'Yamato Transport';
+const ENDPOINT = 'https://toi.kuronekoyamato.co.jp/cgi-bin/tneko';
+const ZONE = 'Asia/Tokyo';
+export function normalizeYamatoNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!/^\d{12}$/.test(number)) {
+        throw new InputRequiredError(PROVIDER, 'number', 'Yamato requires a 12-digit tracking number');
+    }
+    return number;
+}
+function eventDate(raw) {
+    const match = /^(?:(\d{4})年)?(\d{1,2})月(\d{1,2})日 (\d{2}):(\d{2})$/.exec(raw);
+    if (!match)
+        throw new SchemaError(PROVIDER, 'Yamato returned an invalid event date');
+    const [, year, month, day, hour, minute] = match;
+    // A leap year validates month/day even when the carrier leaves the year out.
+    // It is never used as an event year or as a freshness watermark.
+    const date = DateTime.fromObject({ year: year ? Number(year) : 2000,
+        month: Number(month), day: Number(day), hour: Number(hour), minute: Number(minute) }, { zone: ZONE });
+    if (!date.isValid)
+        throw new SchemaError(PROVIDER, 'Yamato returned an invalid event date');
+    return { provider_time_text: raw, ...(year ? { time: date.toUTC().toISO({ suppressMilliseconds: true }) } : {}) };
+}
+export function parse(html, trackingNumber) {
+    const number = normalizeYamatoNumber(trackingNumber);
+    const $ = load(html);
+    if (/captcha|verify.*human|just a moment/i.test($('title').text())
+        || $('.g-recaptcha, .h-captcha, input[name="captcha"]').length)
+        throw new ChallengeError(PROVIDER);
+    $('script, style, noscript').remove();
+    const blocks = $('.parts-tracking-invoice-block');
+    if (blocks.length !== 1)
+        throw new SchemaError(PROVIDER, 'Yamato returned missing or ambiguous shipment details');
+    const block = blocks.first();
+    const headings = block.find('.tracking-invoice-block-title');
+    const heading = /^1件目：([\d-]+)$/.exec(clean(headings.text()));
+    if (headings.length !== 1 || !heading || normalizeTrackingNumber(heading[1]) !== number) {
+        throw new SchemaError(PROVIDER, 'Yamato returned a different shipment');
+    }
+    const summary = block.find('.tracking-invoice-block-state-title');
+    const wording = clean(summary.text());
+    if (summary.length !== 1 || !wording)
+        throw new SchemaError(PROVIDER, 'Yamato returned no current shipment state');
+    const history = block.find('.tracking-invoice-block-detail > ol');
+    const rows = history.children('li');
+    if (['伝票番号未登録', '伝票番号誤り'].includes(wording)) {
+        if (rows.length)
+            throw new SchemaError(PROVIDER, 'Yamato returned history alongside a missing-shipment state');
+        throw new NotFoundError(PROVIDER);
+    }
+    if (history.length !== 1 || !rows.length || rows.length > 1000) {
+        throw new SchemaError(PROVIDER, 'Yamato returned missing or excessive shipment history');
+    }
+    const events = [];
+    const seen = new Set();
+    let returning = false;
+    rows.each((_, row) => {
+        const item = $(row);
+        const labels = item.children('.item');
+        const dates = item.children('.date');
+        const places = item.children('.name');
+        const description = clean(labels.text());
+        if (labels.length !== 1 || dates.length !== 1 || places.length !== 1 || !description) {
+            throw new SchemaError(PROVIDER, 'Yamato returned an incomplete history row');
+        }
+        const location = clean(places.text());
+        const mapped = yamatoStatus(description);
+        if (mapped?.stage === 'returned')
+            returning = true;
+        const stage = returning && mapped && ['accepted', 'in_transit', 'out_for_delivery', 'ready_for_pickup', 'delivered'].includes(mapped.stage)
+            ? 'returned' : mapped?.stage;
+        const event = { description, ...eventDate(clean(dates.text())),
+            ...(location ? { location } : {}), ...(stage ? { stage } : {}), ...(returning ? { provider_leg: 'return' } : {}) };
+        const key = JSON.stringify(event);
+        if (!seen.has(key)) {
+            seen.add(key);
+            events.push(event);
+        }
+    });
+    // The official detail list is chronological, including request-only records.
+    // Sorting yearless dates could incorrectly reorder a New Year crossing.
+    events.reverse();
+    const mappedCurrent = yamatoStatus(wording);
+    const current = returning && mappedCurrent && ['accepted', 'in_transit', 'out_for_delivery', 'ready_for_pickup', 'delivered'].includes(mappedCurrent.stage)
+        ? { status: 'exception', stage: 'returned' } : mappedCurrent;
+    return { status: current?.status ?? 'unknown', ...(current ? { current_stage: current.stage } : {}),
+        last_status_text: wording, last_update: events[0]?.time ?? null,
+        ...(current?.stage === 'delivered' && events[0]?.stage === 'delivered' && events[0].time ? { delivered_at: events[0].time } : {}),
+        timezone: ZONE, events: events.slice(0, 100) };
+}
+export class YamatoTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeYamatoNumber(raw);
+        const budgetMs = context.budgetMs ?? this.options.timeoutMs ?? 15_000;
+        if (!Number.isFinite(budgetMs) || budgetMs <= 0)
+            throw new TypeError('Yamato timeout must be positive');
+        context.signal?.throwIfAborted();
+        try {
+            const { bytes } = await fetchBounded(ENDPOINT, { method: 'POST',
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                body: new URLSearchParams({ number00: '1', number01: number }) }, {
+                provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(budgetMs)), maxBytes: 1_000_000,
+                fetcher: (input, init) => (this.options.fetcher ?? fetch)(input, { ...init,
+                    signal: AbortSignal.any([...(context.signal ? [context.signal] : []), ...(init?.signal ? [init.signal] : [])]) }),
+            });
+            context.signal?.throwIfAborted();
+            return parse(decodeText(bytes), number);
+        }
+        catch (error) {
+            if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
+                throw new TransportError(PROVIDER, 'Yamato tracking endpoint is unavailable', { cause: error });
+            }
+            throw error;
+        }
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new YamatoTracker({ fetcher: environment.fetcher });
+    return { id: 'yamato', steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context) };
+};

package/dist/carriers/yamato/carrier.json

@@ -0,0 +1,72 @@
+{
+  "id": "yamato",
+  "displayName": "Yamato Transport",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "JP"
+    ]
+  },
+  "brand": {
+    "color": "#fccf00"
+  },
+  "selectable": true,
+  "timezone": "Asia/Tokyo",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "yamato",
+    "steps": [
+      "direct"
+    ],
+    "localClocks": true
+  },
+  "capabilities": [
+    "history",
+    "location"
+  ],
+  "portal": {
+    "url": "https://toi.kuronekoyamato.co.jp/cgi-bin/tneko",
+    "canaryUrl": "https://toi.kuronekoyamato.co.jp/cgi-bin/tneko",
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "eta"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "yearless_eta",
+      "requested_delivery_window",
+      "service_name",
+      "office_contact_details"
+    ],
+    "unavailable": [
+      "weight",
+      "sender_name",
+      "pickup_point"
+    ]
+  },
+  "links": [
+    {
+      "domains": [
+        "toi.kuronekoyamato.co.jp",
+        "track.kuronekoyamato.co.jp"
+      ],
+      "params": [
+        "number01",
+        "no01"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "yamato-1",
+      "pattern": "^\\d{12}$",
+      "confidence": "low"
+    }
+  ]
+}