universal-parcel-scraper 0.802.4-main.4321 → 0.803.0-main.4323

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 **651 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **652 dedicated adapters** and **5 universal fallbacks**
 
 <sub>835 catalog entries · 135 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -161,7 +161,7 @@ the command line's `track --source ParcelsApp` does the same.
 <!-- 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 17,602 such statuses, each filed under one stage.
+The carrier folders record 17,632 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

@@ -33948,7 +33948,8 @@
     "timezone": "Asia/Shanghai",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "ydh",
+      "localClocks": true
     },
     "canaryUrl": "https://track.ydhex.com/track_query.aspx",
     "trackingUrlTemplate": "https://track.ydhex.com/track_query.aspx?track_number={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 835,
-  "activeAdapters": 651,
+  "activeAdapters": 652,
   "countries": 135,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -25644,7 +25644,8 @@ var tt = {
 		timezone: "Asia/Shanghai",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "ydh",
+			localClocks: !0
 		},
 		canaryUrl: "https://track.ydhex.com/track_query.aspx",
 		trackingUrlTemplate: "https://track.ydhex.com/track_query.aspx?track_number={trackingNumber}",

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

@@ -0,0 +1,21 @@
+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 tracker's page for one parcel. */
+export declare const YDH_PAGE = "https://track.ydhex.com/track_query.aspx";
+/** The tracking platform's lookup on YDH's tenant. */
+export declare const YDH_API = "https://track.ydhex.com/webservice/Service.ashx";
+/** The JSONP callback the adapter names. */
+export declare const YDH_CALLBACK = "ydhTrack";
+/** The platform's request for one number. */
+export declare function ydhLookupUrl(number: string): string;
+export declare class YdhTracker {
+    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/ydh/adapter.js

@@ -0,0 +1,47 @@
+import { 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 { RTB56_REDIRECTS, rtb56Json, rtb56LookupUrl } from '../yypost/rtb56.js';
+import { normalizeYdhNumber, parseYdh, PROVIDER, YDH_MAX_BYTES } from './parser.js';
+/** The tracker's page for one parcel. */
+export const YDH_PAGE = 'https://track.ydhex.com/track_query.aspx';
+/** The tracking platform's lookup on YDH's tenant. */
+export const YDH_API = 'https://track.ydhex.com/webservice/Service.ashx';
+/** The JSONP callback the adapter names. */
+export const YDH_CALLBACK = 'ydhTrack';
+/** The platform's request for one number. */
+export function ydhLookupUrl(number) {
+    return rtb56LookupUrl(YDH_API, YDH_CALLBACK, number);
+}
+export class YdhTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeYdhNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(ydhLookupUrl(number), { method: 'GET', signal, headers: {
+                    Accept: 'text/javascript, application/javascript, */*; q=0.01', Referer: `${YDH_PAGE}?track_number=${number}`,
+                    'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: YDH_MAX_BYTES,
+                redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: [...RTB56_REDIRECTS, 404, 410] });
+            // The lookup answers every number with HTTP 200; a redirect or a 404 is a moved route.
+            if (response.status !== 200)
+                throw new TransportError(PROVIDER, 'YDH tracking lookup moved', { status: response.status });
+            return parseYdh(rtb56Json(decodeText(bytes), YDH_CALLBACK, PROVIDER), number);
+        };
+        // A read that fails to reach the site, or hangs, gets one more: the first gets half of the budget.
+        return runSteps({ carrier: 'ydh', 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 YdhTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return { id: 'ydh', recordsSteps: true, steps: ['direct', 'retry'], track: (input, context) => tracker.fetch(input.number, context) };
+};

package/dist/carriers/ydh/carrier.json

@@ -19,18 +19,53 @@
   "timezone": "Asia/Shanghai",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "ydh",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "delivery_tracking_number",
+    "destination_country"
+  ],
   "portal": {
     "url": "https://track.ydhex.com/track_query.aspx?track_number={trackingNumber}",
     "searchUrl": "https://track.ydhex.com/track_query.aspx",
     "canaryUrl": "https://track.ydhex.com/track_query.aspx",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "destination_country"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "destination_country",
+      "delivery_tracking_number"
+    ],
+    "discarded": [
+      "customer_reference",
+      "signatory",
+      "delivery_partner"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "offset_timestamps",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "pickup_point",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

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

@@ -0,0 +1,14 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "YDH";
+export declare const YDH_MAX_BYTES: number;
+/** A YDH parcel number; anything else is not one it issues. */
+export declare function normalizeYdhNumber(raw: string): string;
+/**
+ * The reply of the tracker's `Service.ashx` lookup for one number: `data`
+ * holds an entry per number, with the scans newest first, each a wall clock,
+ * a place, a code and wording: YDH's own in Chinese or English, then those
+ * of the partner that delivers abroad, relayed in its language. Only the
+ * entry whose `server_hawbcode` is the whole number asked is read; the
+ * merchant's order reference and the signatory are never read.
+ */
+export declare function parseYdh(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/ydh/parser.js

@@ -0,0 +1,51 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { InvalidInputError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { countryCode } from '../../core/time/index.js';
+import { RTB56_MAX_BYTES, rtb56Entry, rtb56Scans, rtb56Text } from '../yypost/rtb56.js';
+import { ydhStage } from './status.js';
+export const PROVIDER = 'YDH';
+export const YDH_MAX_BYTES = RTB56_MAX_BYTES;
+// YDH, ten digits and two letters.
+const NUMBER = /^YDH\d{10}[A-Z]{2}$/;
+const REFERENCE = /^[A-Z0-9]{4,40}$/;
+const MAX_EVENTS = 100;
+/** A YDH parcel number; anything else is not one it issues. */
+export function normalizeYdhNumber(raw) {
+    const number = typeof raw === 'string' && raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'YDH parcel numbers are YDH, ten digits and two letters');
+    return number;
+}
+/**
+ * The reply of the tracker's `Service.ashx` lookup for one number: `data`
+ * holds an entry per number, with the scans newest first, each a wall clock,
+ * a place, a code and wording: YDH's own in Chinese or English, then those
+ * of the partner that delivers abroad, relayed in its language. Only the
+ * entry whose `server_hawbcode` is the whole number asked is read; the
+ * merchant's order reference and the signatory are never read.
+ */
+export function parseYdh(payload, raw) {
+    const number = normalizeYdhNumber(raw);
+    const { item, rows } = rtb56Entry(payload, number, PROVIDER);
+    const events = rtb56Scans(rows, PROVIDER, ydhStage, { offsets: false, codes: true });
+    const newest = events[0];
+    // A label or electronic information recorded after the parcel moved is no step back.
+    const staged = events.find((event) => event.stage && event.stage !== 'registered') ?? events.find((event) => event.stage);
+    const stage = staged?.stage;
+    const country = countryCode(rtb56Text(item, 'destination_country', PROVIDER, 8));
+    const channel = normalizeTrackingNumber(rtb56Text(item, 'channel_hawbcode', PROVIDER, 64));
+    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 ?? null,
+        ...(newest.local_time ? { last_update_local: newest.local_time } : {}),
+        expected_delivery: null,
+        ...(country ? { destination_country: country } : {}),
+        // The partner's own number for the parcel; the hand-off decides who that is.
+        ...(REFERENCE.test(channel) && channel !== number ? { delivery_tracking_number: channel } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

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

@@ -0,0 +1,6 @@
+import { type ClassifiedWording } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** A scan's stage: its code, else its wording in the map, else the shared wording rules, else nothing. */
+export declare function ydhStage(wording: string, code?: string): ClassifiedWording | null;
+/** What the map says about a scan, by its code, or by its wording when it has none. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/ydh/status.js

@@ -0,0 +1,30 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+import statuses from './statuses.json' with { type: 'json' };
+const ENTRIES = statuses.entries;
+/**
+ * YDH's scans carry a code when YDH or its partner abroad files a milestone,
+ * whatever the wording: YDH's own in Chinese or English, or the partner's
+ * relayed in its language. Scans without a code are YDH's warehouse and
+ * export steps, or the partner's, in their wording. The map is the codes and
+ * wording recorded in `statuses.json`.
+ */
+const CODES = new Map(ENTRIES.filter((entry) => entry.code && entry.stage)
+    .map((entry) => [entry.code, entry.stage]));
+const WORDINGS = new Map(ENTRIES.filter((entry) => !entry.code && entry.wording && entry.stage)
+    .map((entry) => [normalizeStatusWording(entry.wording), entry.stage]));
+/** The codes that name no one milestone: the partner's wording does. */
+const GAPS = ENTRIES.filter((entry) => entry.unmapped && entry.code).map((entry) => ({ code: entry.code, note: entry.note ?? '' }));
+/** A scan's stage: its code, else its wording in the map, else the shared wording rules, else nothing. */
+export function ydhStage(wording, code = '') {
+    const mapped = code ? CODES.get(code) : WORDINGS.get(normalizeStatusWording(wording));
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** What the map says about a scan, by its code, or by its wording when it has none. */
+export const statusMap = {
+    stage: (code, wording) => (code ? CODES.get(code) : WORDINGS.get(wording)),
+    gaps: GAPS,
+};

package/dist/carriers/ydh/statuses.json

@@ -1,4 +1,201 @@
 {
   "carrier": "ydh",
-  "entries": []
+  "entries": [
+    {
+      "code": "IR",
+      "stage": "registered",
+      "confirmedBy": "live",
+      "note": "Electronic information received (\"Shipment information received\", \"Label Created\"), or the partner's own notice of it."
+    },
+    {
+      "code": "AF",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"Shipment arrived at facility\": YDH's warehouse in China."
+    },
+    {
+      "code": "GNZY",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"快件到达作业中心\", carried on within China."
+    },
+    {
+      "code": "HBYP",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "Waiting for a flight."
+    },
+    {
+      "code": "DF",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"Shipment departed from facility\"."
+    },
+    {
+      "code": "DA",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"Shipment departed from airport\" or \"航班起飞\"."
+    },
+    {
+      "code": "TDDY",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"Flight delay\"."
+    },
+    {
+      "code": "AA",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"Shipment arrived at airport\" or \"航班到达\"."
+    },
+    {
+      "code": "RC",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"Released from customs\" at the destination."
+    },
+    {
+      "code": "CARR",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "\"The goods have been handed over to the final carrier\"."
+    },
+    {
+      "code": "PU",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "The partner's first scans once it has the parcel, in its wording: its pickup from YDH, its manifest, its transit."
+    },
+    {
+      "code": "OD",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live",
+      "note": "\"Out for Delivery\", or the partner's wording for a parcel at its delivery office being prepared for the round."
+    },
+    {
+      "code": "CC",
+      "stage": "delivered",
+      "confirmedBy": "live",
+      "note": "\"Delivered\", in YDH's or the partner's wording."
+    },
+    {
+      "code": "DD",
+      "unmapped": true,
+      "confirmedBy": "live",
+      "note": "A delivery the partner could not make or put off, filed as a delivery exception; the partner's wording tells which."
+    },
+    {
+      "wording": "快件电子信息已经收到",
+      "stage": "registered",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Electronic information received, without a code beside the coded scan."
+    },
+    {
+      "wording": "Shipping Label Created",
+      "stage": "registered",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "A partner's label, relayed without a code."
+    },
+    {
+      "wording": "快件已操作完成",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Processing at YDH's warehouse done."
+    },
+    {
+      "wording": "扫描装箱",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Scanned into a box."
+    },
+    {
+      "wording": "装箱完成",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Boxing done."
+    },
+    {
+      "wording": "货物出库",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Out of the warehouse."
+    },
+    {
+      "wording": "出口报关",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Export declaration."
+    },
+    {
+      "wording": "出口放行并安排航班",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Released for export, flight arranged."
+    },
+    {
+      "wording": "货交物流供应商",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Handed to the logistics provider at the destination."
+    },
+    {
+      "wording": "快件到达目的地作业中心",
+      "stage": "in_transit",
+      "language": "zh",
+      "confirmedBy": "live",
+      "note": "Arrived at the destination's processing centre."
+    },
+    {
+      "wording": "Loaded on Vehicle",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "The partner's scan in the United States, relayed without a code."
+    },
+    {
+      "wording": "Arrived at GOFO Delivery Station",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "GOFO's scan in the United States, relayed without a code."
+    },
+    {
+      "wording": "Departed GOFO Delivery Station",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "GOFO's scan in the United States, relayed without a code."
+    },
+    {
+      "wording": "Package Scan",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "USPS's scan, relayed without a code."
+    },
+    {
+      "wording": "Shipment Shipped",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "USPS's scan, relayed without a code."
+    },
+    {
+      "wording": "Arrival at Unit",
+      "stage": "in_transit",
+      "language": "en",
+      "confirmedBy": "live",
+      "note": "USPS's scan at the delivery office, relayed without a code."
+    }
+  ]
 }

package/dist/carriers/yypost/rtb56.d.ts

@@ -35,11 +35,13 @@ export declare function rtb56Wording(row: Record<string, unknown>, provider: str
  * its offset gets its instant; any other scan keeps its wall clock. Some
  * tenants state China's offset for scans at the destination too, so a tenant
  * whose offsets were not seen to follow the scan's place keeps wall clocks.
+ * With `codes`, a scan keeps its `track_code`, which the stage is asked with.
  * The tracker orders the scans by their wall clocks, whatever their offsets;
  * when every scan has an instant they are ordered by it, equal ones in the
  * tracker's order. A row without wording says nothing, and a repeated one is
  * read once.
  */
-export declare function rtb56Scans(rows: unknown[], provider: string, stage: (wording: string) => ClassifiedWording | null, { offsets }: {
+export declare function rtb56Scans(rows: unknown[], provider: string, stage: (wording: string, code: string) => ClassifiedWording | null, { offsets, codes }: {
     offsets: boolean;
+    codes?: boolean;
 }): CarrierEvent[];

package/dist/carriers/yypost/rtb56.js

@@ -14,6 +14,7 @@ export const RTB56_REDIRECTS = [301, 302, 303, 307, 308];
 const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>\s*Just a moment|acw_sc__v2|aliyun_waf|_____tmd_____|waf\.tencent|<title>\s*(?:滑动验证|验证码|安全验证|访问受限|访问被拒绝)/i;
 const CLOCK = /^(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})$/;
 const OFFSET = /^[+-](?:0\d|1[0-4]):[0-5]\d$/;
+const CODE = /^[A-Z]{1,8}$/;
 const MAX_ROWS = 500;
 // Four to six digits standing alone in a place are a postcode.
 const POSTCODE_RUN = /(^|[^\p{L}\p{N}])\d{4,6}(?![\p{L}\p{N}])/gu;
@@ -104,12 +105,13 @@ export function rtb56Wording(row, provider) {
  * its offset gets its instant; any other scan keeps its wall clock. Some
  * tenants state China's offset for scans at the destination too, so a tenant
  * whose offsets were not seen to follow the scan's place keeps wall clocks.
+ * With `codes`, a scan keeps its `track_code`, which the stage is asked with.
  * The tracker orders the scans by their wall clocks, whatever their offsets;
  * when every scan has an instant they are ordered by it, equal ones in the
  * tracker's order. A row without wording says nothing, and a repeated one is
  * read once.
  */
-export function rtb56Scans(rows, provider, stage, { offsets }) {
+export function rtb56Scans(rows, provider, stage, { offsets, codes = false }) {
     const seen = new Set();
     const scans = [];
     for (const row of rows) {
@@ -121,16 +123,20 @@ export function rtb56Scans(rows, provider, stage, { offsets }) {
         const { description, location } = rtb56Wording(row, provider);
         if (!description)
             continue;
-        const key = JSON.stringify([instant?.iso ?? local, location, description]);
+        const code = codes ? rtb56Text(row, 'track_code', provider, 16).toUpperCase() : '';
+        if (code && !CODE.test(code))
+            throw new SchemaError(provider, `${provider} returned an invalid scan code`);
+        const key = JSON.stringify([instant?.iso ?? local, location, description, code]);
         if (seen.has(key))
             continue;
         seen.add(key);
-        const staged = stage(description);
+        const staged = stage(description, code);
         scans.push({ at: instant?.timestamp ?? null, index: scans.length, event: {
                 // A scan without its place's offset keeps its wall clock.
                 ...(instant ? { time: instant.iso } : { local_time: local }),
                 ...(location ? { location } : {}),
                 description,
+                ...(code ? { provider_code: code } : {}),
                 ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
             } });
     }

package/dist/core/catalog/statusMaps.js

@@ -651,6 +651,7 @@ import { statusMap as yanwen } from '../../carriers/yanwen/status.js';
 import { statusMap as yunda } from '../../carriers/yunda/status.js';
 import { statusMap as ywe } from '../../carriers/ywe/status.js';
 import { statusMap as ycsLogistics } from '../../carriers/ycs-logistics/status.js';
+import { statusMap as ydh } from '../../carriers/ydh/status.js';
 import { statusMap as zto } from '../../carriers/zto/status.js';
 import { statusMap as ztoInternational } from '../../carriers/zto-international/status.js';
 import { statusMap as yto } from '../../carriers/yto/status.js';
@@ -746,7 +747,7 @@ export const STATUS_MAPS = {
     'united-delivery-service': unitedDeliveryService, uniuni, upaya, ups, urbano, urvaam, usps,
     'uzbekistan-post': uzbekistanPost, valmo, 'vasp-expresso': vaspExpresso, veloces, venipak, 'via-cargo': viaCargo, viadireta, 'viettel-post': viettelPost,
     vimenpaq, 'vinted-go': vintedGo, vozovoz, 'vrl-logistics': vrlLogistics, wanbexpress, whistl, winit, 'xde-logistics': xdeLogistics, xdp, xlcourier, 'xpo-ltl': xpoLtl, xpressbees,
-    yamato, yanwen, 'ycs-logistics': ycsLogistics, 'yilong-logistics': yilongLogistics, yto, yunexpress, yunda, ywe, yypost, zto, 'zto-international': ztoInternational,
+    yamato, yanwen, 'ycs-logistics': ycsLogistics, ydh, 'yilong-logistics': yilongLogistics, yto, yunexpress, yunda, ywe, yypost, zto, 'zto-international': ztoInternational,
     'yurtici-kargo': yurticiKargo, zajil, zeleris, 'zr-express': zrExpress,
 };
 /** The carrier the app files the universal providers' scans under. */

package/dist/data/catalog.json

@@ -33948,7 +33948,8 @@
         "timezone": "Asia/Shanghai",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "ydh",
+            "localClocks": true
         },
         "canaryUrl": "https://track.ydhex.com/track_query.aspx",
         "trackingUrlTemplate": "https://track.ydhex.com/track_query.aspx?track_number={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -21717,7 +21717,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Asia/Shanghai";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "ydh";
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://track.ydhex.com/track_query.aspx";
         readonly trackingUrlTemplate: "https://track.ydhex.com/track_query.aspx?track_number={trackingNumber}";

package/dist/generated/catalog.js

@@ -33949,7 +33949,8 @@ export const CARRIER_CATALOG = {
         "timezone": "Asia/Shanghai",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "ydh",
+            "localClocks": true
         },
         "canaryUrl": "https://track.ydhex.com/track_query.aspx",
         "trackingUrlTemplate": "https://track.ydhex.com/track_query.aspx?track_number={trackingNumber}",

package/dist/generated/registry.js

@@ -638,6 +638,7 @@ import { adapter as xpressbees } from '../carriers/xpressbees/adapter.js';
 import { adapter as yamato } from '../carriers/yamato/adapter.js';
 import { adapter as yanwen } from '../carriers/yanwen/adapter.js';
 import { adapter as ycsLogistics } from '../carriers/ycs-logistics/adapter.js';
+import { adapter as ydh } from '../carriers/ydh/adapter.js';
 import { adapter as yilongLogistics } from '../carriers/yilong-logistics/adapter.js';
 import { adapter as yto } from '../carriers/yto/adapter.js';
 import { adapter as yunda } from '../carriers/yunda/adapter.js';
@@ -1291,6 +1292,7 @@ export const REGISTRY = {
         "yamato": yamato,
         "yanwen": yanwen,
         "ycs-logistics": ycsLogistics,
+        "ydh": ydh,
         "yilong-logistics": yilongLogistics,
         "yto": yto,
         "yunda": yunda,
@@ -2121,7 +2123,7 @@ export const REGISTRY = {
         "yanwen": "yanwen",
         "yc-delivery": "universal",
         "ycs-logistics": "ycs-logistics",
-        "ydh": "universal",
+        "ydh": "ydh",
         "yfhex": "universal",
         "yilong-logistics": "yilong-logistics",
         "yimidida": "universal",

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.802.4-main.4321"
+    "version": "0.803.0-main.4323"
   },
   "paths": {
     "/health": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-parcel-scraper",
-  "version": "0.802.4-main.4321",
+  "version": "0.803.0-main.4323",
   "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
   "type": "module",
   "license": "Apache-2.0",