universal-parcel-scraper 0.366.0-main.1999 → 0.368.0-main.2003

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 **396 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **398 dedicated adapters** and **5 universal fallbacks**
 
 <sub>727 catalog entries · 133 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 13,496 such statuses, each filed under one stage.
+The carrier folders record 13,540 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

@@ -17174,7 +17174,7 @@
     "timezone": "Asia/Seoul",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "kyoungdong"
     },
     "canaryUrl": "https://kdexp.com/index.do",
     "trackingUrlTemplate": "https://kdexp.com/service/delivery/etc/delivery.do?barcode={trackingNumber}",
@@ -19610,7 +19610,9 @@
     "timezone": "Europe/Kyiv",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "nova-global",
+      "recognitionRank": 834,
+      "localClocks": true
     },
     "canaryUrl": "https://nova.global/track/",
     "trackingUrlTemplate": "https://nova.global/track/?Tracking_ID={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 727,
-  "activeAdapters": 396,
+  "activeAdapters": 398,
   "countries": 133,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -13154,7 +13154,7 @@ var Pe = {
 		timezone: "Asia/Seoul",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "kyoungdong"
 		},
 		canaryUrl: "https://kdexp.com/index.do",
 		trackingUrlTemplate: "https://kdexp.com/service/delivery/etc/delivery.do?barcode={trackingNumber}",
@@ -14957,7 +14957,9 @@ var Pe = {
 		timezone: "Europe/Kyiv",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "nova-global",
+			recognitionRank: 834,
+			localClocks: !0
 		},
 		canaryUrl: "https://nova.global/track/",
 		trackingUrlTemplate: "https://nova.global/track/?Tracking_ID={trackingNumber}",
@@ -28116,6 +28118,7 @@ var pl = {
 	nipost: 908,
 	"nippon-express": 941,
 	"norsk-global": 845,
+	"nova-global": 834,
 	"nova-poshta": 685,
 	nox: 874,
 	"nz-post": 760,

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

@@ -0,0 +1,15 @@
+import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+/** The lookup the tracking page on kdexp.com makes for a waybill, followed by the number. */
+export declare const KYOUNGDONG_API = "https://kdexp.com/service/delivery/new/ajax_basic.do?barcode=";
+export declare class KyoungdongTracker {
+    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/kyoungdong/adapter.js

@@ -0,0 +1,56 @@
+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 { CARRIER, KYOUNGDONG_MAX_BYTES, normalizeKyoungdongNumber, parseKyoungdong, PROVIDER } from './parser.js';
+/** The lookup the tracking page on kdexp.com makes for a waybill, followed by the number. */
+export const KYOUNGDONG_API = 'https://kdexp.com/service/delivery/new/ajax_basic.do?barcode=';
+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|challenge-platform|<title>\s*(?:Just a moment|Attention Required|Access Denied)|g-recaptcha|h-captcha|AwsWafIntegration|awswaf\.com/i;
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Kyungdong Express answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned a reply that is not JSON', { cause });
+    }
+}
+export class KyoungdongTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeKyoungdongNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(`${KYOUNGDONG_API}${number}`, { method: 'GET', signal, headers: {
+                    Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: KYOUNGDONG_MAX_BYTES, redirect: 'manual',
+                fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Kyungdong Express redirected its tracking lookup');
+            // The lookup answers an unknown number with HTTP 200; a 404 is a moved route.
+            if (response.status === 404 || response.status === 410)
+                throw new TransportError(PROVIDER, 'Kyungdong Express tracking lookup is unavailable');
+            return parseKyoungdong(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: CARRIER, 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 KyoungdongTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: CARRIER, recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+    };
+};

package/dist/carriers/kyoungdong/carrier.json

@@ -22,18 +22,68 @@
   "timezone": "Asia/Seoul",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "kyoungdong",
+    "steps": [
+      "direct",
+      "retry"
+    ]
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "delivered_at"
+  ],
   "portal": {
     "url": "https://kdexp.com/service/delivery/etc/delivery.do?barcode={trackingNumber}",
     "searchUrl": "https://kdexp.com/index.do",
     "canaryUrl": "https://kdexp.com/index.do",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "delivered_at",
+      "sender_name",
+      "sender_address",
+      "recipient_name",
+      "recipient_address",
+      "contact_details",
+      "order_contents",
+      "parcel_count",
+      "origin",
+      "destination",
+      "driver_name",
+      "office_contact_details",
+      "proof_of_delivery"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "delivered_at"
+    ],
+    "discarded": [
+      "sender_name",
+      "sender_address",
+      "recipient_name",
+      "recipient_address",
+      "contact_details",
+      "order_contents",
+      "parcel_count",
+      "origin",
+      "destination",
+      "driver_name",
+      "office_contact_details",
+      "proof_of_delivery"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "pickup_point"
+    ]
   },
   "links": [
     {

package/dist/carriers/kyoungdong/numbers.json

@@ -218,7 +218,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -230,7 +230,7 @@
           "yunda"
         ]
       },
-      "note": "A Naver KnowledgeiN question asks when this Kyungdong Express parcel will arrive."
+      "note": "A Naver KnowledgeiN question asks when this Kyungdong Express parcel will arrive. Kyungdong's tracker answers it with its scans."
     },
     {
       "number": "8026090773281",
@@ -243,7 +243,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -256,7 +256,7 @@
           "yunda"
         ]
       },
-      "note": "A Naver KnowledgeiN question about a Kyungdong Express lookup gives it."
+      "note": "A Naver KnowledgeiN question about a Kyungdong Express lookup gives it. Kyungdong's tracker answers it with its scans."
     },
     {
       "number": "8026091635480",
@@ -269,7 +269,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -281,7 +281,7 @@
           "yunda"
         ]
       },
-      "note": "A Naver KnowledgeiN question about a stalled Kyungdong Express parcel gives it as the waybill number."
+      "note": "A Naver KnowledgeiN question about a stalled Kyungdong Express parcel gives it as the waybill number. Kyungdong's tracker answers it with its scans."
     },
     {
       "number": "8026100380015",
@@ -294,7 +294,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -306,7 +306,7 @@
           "yunda"
         ]
       },
-      "note": "A Naver KnowledgeiN question tagged Kyungdong Express gives it as the waybill being tracked."
+      "note": "A Naver KnowledgeiN question tagged Kyungdong Express gives it as the waybill being tracked. Kyungdong's tracker answers it with its scans."
     }
   ]
 }

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

@@ -0,0 +1,23 @@
+import type { CarrierResult } from '../../core/result/index.js';
+import { type Stage } from '../../core/status/index.js';
+export declare const PROVIDER = "Kyungdong Express";
+export declare const CARRIER = "kyoungdong";
+export declare const KYOUNGDONG_MAX_BYTES: number;
+/** A Kyungdong Express waybill as its tracker looks it up: thirteen digits, without the hyphens a label prints. */
+export declare function normalizeKyoungdongNumber(raw: string): string;
+/**
+ * A scan's site, when it is a branch, terminal or hub. A delivery-leg scan
+ * keeps only a branch the summary names, since it can name the driver, and a
+ * line-haul load can name its driver too.
+ */
+export declare function kyoungdongSite(value: string, branches: ReadonlySet<string>, stage?: Stage): string;
+/**
+ * The reply of `/service/delivery/new/ajax_basic.do?barcode=`, the lookup
+ * Kyungdong's tracking page makes. `result` is `suc` with the parcel in `data`
+ * and its scans oldest first, or `fail` without data, which the page words as a
+ * wrong waybill or a failed lookup: an unknown number, a parcel older than four
+ * months or a lookup that failed, so it proves no absence. The parcel must name
+ * the number asked. Senders, recipients, addresses, phone numbers, goods and
+ * the delivery's signature files are never read.
+ */
+export declare function parseKyoungdong(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/kyoungdong/parser.js

@@ -0,0 +1,139 @@
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { firstOccurrence } from '../../core/time/index.js';
+import { clean, cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { kyoungdongStage } from './status.js';
+export const PROVIDER = 'Kyungdong Express';
+export const CARRIER = 'kyoungdong';
+// A reply is a few kilobytes.
+export const KYOUNGDONG_MAX_BYTES = 256 * 1024;
+const ZONE = 'Asia/Seoul';
+const NUMBER = /^\d{13}$/;
+// A scan's wall clock to the second, some with a fraction of a second after it.
+const CLOCK = /^(\d{4}-\d{2}-\d{2} (?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d)(?:\.\d{1,9})?$/;
+const CODE = /^\d{1,6}$/;
+// A site that names a person: a masked name (최**) or a role such as (배송기사), the driver.
+const PERSON = /[*＊(（]|기사/;
+// A branch carries its number after its area's name; terminals and hubs say what they are.
+const BRANCH = /\d|(?:터미널|허브|센터)$/;
+// Scans whose site can be the driver who delivers.
+const DELIVERY_LEG = ['out_for_delivery', 'failed_attempt', 'delivered'];
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+/** A Kyungdong Express waybill as its tracker looks it up: thirteen digits, without the hyphens a label prints. */
+export function normalizeKyoungdongNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Kyungdong Express waybills are thirteen digits');
+    return number;
+}
+/** An optional text field; anything but a string is a changed reply. */
+function text(row, key, maxLength = 120) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string')
+        throw new SchemaError(PROVIDER, `Kyungdong Express returned an invalid ${key}`);
+    return clean(value, maxLength);
+}
+/** A scan's clock: every scan is at a branch or terminal in Korea, which keeps UTC+9 all year. */
+function scanClock(row) {
+    const clock = CLOCK.exec(text(row, 'scanDt', 40))?.[1] ?? '';
+    const wall = firstOccurrence(DateTime.fromFormat(clock, 'yyyy-MM-dd HH:mm:ss', { zone: ZONE }));
+    // Luxon rolls 24:00 over to the next day; only a clock that reads back unchanged is kept.
+    if (!clock || !wall.isValid || wall.toFormat('yyyy-MM-dd HH:mm:ss') !== clock)
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned an invalid scan time');
+    return wall.toUTC().toISO({ suppressMilliseconds: true });
+}
+/**
+ * A scan's site, when it is a branch, terminal or hub. A delivery-leg scan
+ * keeps only a branch the summary names, since it can name the driver, and a
+ * line-haul load can name its driver too.
+ */
+export function kyoungdongSite(value, branches, stage) {
+    const name = clean(value, 120);
+    if (!name || PERSON.test(name))
+        return '';
+    if (branches.has(name))
+        return name;
+    return stage && DELIVERY_LEG.includes(stage) ? '' : BRANCH.test(name) ? name : '';
+}
+/**
+ * The reply of `/service/delivery/new/ajax_basic.do?barcode=`, the lookup
+ * Kyungdong's tracking page makes. `result` is `suc` with the parcel in `data`
+ * and its scans oldest first, or `fail` without data, which the page words as a
+ * wrong waybill or a failed lookup: an unknown number, a parcel older than four
+ * months or a lookup that failed, so it proves no absence. The parcel must name
+ * the number asked. Senders, recipients, addresses, phone numbers, goods and
+ * the delivery's signature files are never read.
+ */
+export function parseKyoungdong(payload, raw) {
+    const number = normalizeKyoungdongNumber(raw);
+    if (!isRecord(payload) || typeof payload.result !== 'string')
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned an invalid envelope');
+    if (payload.result === 'fail') {
+        if (payload.data !== undefined && payload.data !== null)
+            throw new SchemaError(PROVIDER, 'Kyungdong Express returned an unexpected failure');
+        throw new IndeterminateError(PROVIDER, 'Kyungdong Express has no parcel for this number or failed to look it up', { reason: 'portal_not_found' });
+    }
+    const data = payload.data;
+    if (payload.result !== 'suc' || !isRecord(data))
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned an unexpected answer');
+    const echoed = cleanScalar(data.prodCode, 64);
+    if (!echoed)
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned a parcel without its waybill');
+    if (normalizeTrackingNumber(echoed) !== number)
+        throw new IndeterminateError(PROVIDER, 'Kyungdong Express answered for another parcel');
+    const rows = data.scanList ?? [];
+    if (!Array.isArray(rows))
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned a parcel with invalid scans');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Kyungdong Express returned an oversized history');
+    const branches = new Set([text(data, 'branSndnNm'), text(data, 'branArvlNm')].filter((name) => name && !PERSON.test(name)));
+    const seen = new Set();
+    const events = [];
+    for (const row of rows) {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'Kyungdong Express returned an invalid scan');
+        const label = text(row, 'scanTypeNm', 40);
+        if (!label)
+            throw new SchemaError(PROVIDER, 'Kyungdong Express returned a scan without its type');
+        const code = cleanScalar(row.scanType, 16);
+        if (code && !CODE.test(code))
+            throw new SchemaError(PROVIDER, 'Kyungdong Express returned an invalid scan type code');
+        const time = scanClock(row);
+        const staged = kyoungdongStage(code || null, label);
+        const location = kyoungdongSite(text(row, 'strtPointNm'), branches, staged?.stage);
+        const key = JSON.stringify([time, code, label, location]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        events.push({
+            time,
+            ...(location ? { location } : {}),
+            description: label,
+            ...(code ? { provider_code: code } : {}),
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        });
+    }
+    if (!events.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first; the reply lists the scans oldest first.
+    const newestFirst = events[0].time <= events.at(-1).time ? events.reverse() : events;
+    const newest = newestFirst[0];
+    const scanned = newestFirst.find((event) => event.stage);
+    const stage = scanned?.stage;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: scanned.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time,
+        expected_delivery: null,
+        ...(stage === 'delivered' ? { delivered_at: scanned.time } : {}),
+        events: newestFirst.slice(0, MAX_EVENTS),
+        ...(newestFirst.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/kyoungdong/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 Kyungdong's scan types give a label, else a code. */
+export declare function kyoungdongMappedStage(code: string | null, label: string): Stage | undefined;
+/** A scan's stage: its label or code, else the shared wording rules, else nothing. */
+export declare function kyoungdongStage(code: string | null, label: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/kyoungdong/status.js

@@ -0,0 +1,42 @@
+import { classifyWording } from '../../core/status/index.js';
+/**
+ * The scan types the tracker page's script draws, by their Korean label. The
+ * page gives `도착` the icon of a finished parcel, but a delivery scan follows
+ * it, so it is the delivering branch's arrival.
+ */
+const LABELS = new Map([
+    ['예약접수', 'registered'], // Booked, not handed over yet.
+    ['접수', 'accepted'], // Accepted by the sending branch.
+    ['발송', 'in_transit'], // Sent off by the sending branch; recent histories start with it.
+    ['노선상차', 'in_transit'], // Loaded on a line-haul truck.
+    ['터미널', 'in_transit'], // Scanned at a hub terminal.
+    ['지연도착', 'in_transit'], // A late arrival.
+    ['도착', 'in_transit'], // Arrived at the delivering branch.
+    ['배송중', 'out_for_delivery'],
+    ['인수확인', 'delivered'], // Receipt confirmed.
+    ['배송완료', 'delivered'], // Recorded by the delivering branch.
+]);
+/** The scan type codes seen with their labels. */
+const CODES = new Map([
+    ['0002', 'in_transit'], // 발송
+    ['0004', 'in_transit'], // 노선상차
+    ['0006', 'in_transit'], // 도착
+    ['0007', 'delivered'], // 배송완료
+    ['0008', 'out_for_delivery'], // 배송중
+]);
+/** The stage Kyungdong's scan types give a label, else a code. */
+export function kyoungdongMappedStage(code, label) {
+    return LABELS.get(label.trim()) ?? (code ? CODES.get(code) : undefined);
+}
+/** A scan's stage: its label or code, else the shared wording rules, else nothing. */
+export function kyoungdongStage(code, label) {
+    const mapped = kyoungdongMappedStage(code, label);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(label, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+export const statusMap = {
+    stage: (code, wording) => kyoungdongMappedStage(code, wording),
+    gaps: [],
+};

package/dist/carriers/kyoungdong/statuses.json

@@ -3,13 +3,13 @@
   "entries": [
     {"wording": "예약접수", "stage": "registered", "language": "ko", "confirmedBy": "official-doc", "note": "A booked shipment not yet handed over. Named among the scan types the tracker page's script draws."},
     {"wording": "접수", "stage": "accepted", "language": "ko", "confirmedBy": "official-doc", "note": "The sending branch accepted the shipment. Named among the scan types the tracker page's script draws."},
-    {"wording": "발송", "stage": "in_transit", "language": "ko", "confirmedBy": "official-doc", "note": "Dispatched from the sending branch. Named among the scan types the tracker page's script draws. A Naver KnowledgeiN answer quotes it from a lookup too."},
-    {"wording": "노선상차", "stage": "in_transit", "language": "ko", "confirmedBy": "official-doc", "note": "Loaded on a line-haul truck. Named among the scan types the tracker page's script draws."},
+    {"code": "0002", "wording": "발송", "stage": "in_transit", "language": "ko", "confirmedBy": "live", "note": "Sent off by the sending branch, at the moment the waybill is registered; recent histories start with it."},
+    {"code": "0004", "wording": "노선상차", "stage": "in_transit", "language": "ko", "confirmedBy": "live", "note": "Loaded on a line-haul truck. Its site can be the driver instead of a branch."},
     {"wording": "터미널", "stage": "in_transit", "language": "ko", "confirmedBy": "official-doc", "note": "Scanned at a hub terminal. Named among the scan types the tracker page's script draws."},
     {"wording": "지연도착", "stage": "in_transit", "language": "ko", "confirmedBy": "official-doc", "note": "A late arrival scan. Named among the scan types the tracker page's script draws."},
-    {"wording": "도착", "stage": "in_transit", "language": "ko", "confirmedBy": "official-doc", "note": "Arrived at the delivering branch; the tracker draws it with the completed icon, but a Naver KnowledgeiN answer shows it before delivery. Named among the scan types the tracker page's script draws."},
-    {"wording": "배송중", "stage": "out_for_delivery", "language": "ko", "confirmedBy": "official-doc", "note": "Named among the scan types the tracker page's script draws."},
+    {"code": "0006", "wording": "도착", "stage": "in_transit", "language": "ko", "confirmedBy": "live", "note": "Arrived at the delivering branch; the tracker draws it with the completed icon, but delivery scans follow it."},
+    {"code": "0008", "wording": "배송중", "stage": "out_for_delivery", "language": "ko", "confirmedBy": "live", "note": "Out for delivery from the delivering branch."},
     {"wording": "인수확인", "stage": "delivered", "language": "ko", "confirmedBy": "official-doc", "note": "Receipt confirmed. Named among the scan types the tracker page's script draws."},
-    {"wording": "배송완료", "stage": "delivered", "language": "ko", "confirmedBy": "official-doc", "note": "Kyungdong's FAQ says the destination branch records it, so a parcel can show it before the recipient has it."}
+    {"code": "0007", "wording": "배송완료", "stage": "delivered", "language": "ko", "confirmedBy": "live", "note": "Kyungdong's FAQ says the destination branch records it, so a parcel can show it before the recipient has it. Its site names the driver."}
   ]
 }

package/dist/carriers/nova-global/adapter.d.ts

@@ -0,0 +1,15 @@
+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 nova.global makes for the number typed in. */
+export declare const NOVA_GLOBAL_API = "https://personal.nova.global/tracking.php";
+export declare class NovaGlobalTracker {
+    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/nova-global/adapter.js

@@ -0,0 +1,62 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, NotFoundError, 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 { NOVA_GLOBAL_MAX_BYTES, normalizeNovaGlobalNumber, parseNovaGlobal, PROVIDER } from './parser.js';
+/** The lookup the tracking page on nova.global makes for the number typed in. */
+export const NOVA_GLOBAL_API = 'https://personal.nova.global/tracking.php';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// Bot checks Cloudflare, in front of the tracker, could put in place of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|challenge-platform|<title>\s*Just a moment|<title>\s*Attention Required/i;
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Nova Global answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Nova Global returned a reply that is not JSON', { cause });
+    }
+}
+export class NovaGlobalTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeNovaGlobalNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(NOVA_GLOBAL_API, { method: 'POST', signal, headers: {
+                    Accept: 'application/json', 'Content-Type': 'application/x-www-form-urlencoded', 'User-Agent': userAgentOf(this.options.userAgent),
+                }, body: new URLSearchParams({ num: number, lang: 'en' }).toString() }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)),
+                maxBytes: NOVA_GLOBAL_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Nova Global redirected its tracking lookup');
+            // The tracker answers every number with HTTP 200; a 404 is a moved route, not an unknown parcel.
+            if (response.status === 404 || response.status === 410)
+                throw new TransportError(PROVIDER, 'Nova Global tracking lookup is unavailable');
+            const body = decodeText(bytes);
+            // A number the tracker does not know, or no longer keeps, gets an empty body.
+            if (!body.trim())
+                throw new NotFoundError(PROVIDER);
+            return parseNovaGlobal(json(body), number);
+        };
+        // A request that fails to reach the tracker, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'nova-global', 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 NovaGlobalTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'nova-global', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeNovaGlobalNumber(number))),
+    };
+};

package/dist/carriers/nova-global/carrier.json

@@ -21,18 +21,65 @@
   "timezone": "Europe/Kyiv",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "nova-global",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 834
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "provider_code",
+    "location",
+    "offset_timestamps",
+    "delivered_at",
+    "destination_country",
+    "delivery_partner",
+    "delivery_tracking_number"
+  ],
   "portal": {
     "url": "https://nova.global/track/?Tracking_ID={trackingNumber}",
     "searchUrl": "https://nova.global/track/",
     "canaryUrl": "https://nova.global/track/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "offset_timestamps",
+      "origin_country",
+      "destination_country",
+      "delivery_tracking_number",
+      "tracking_alias"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "provider_code",
+      "location",
+      "offset_timestamps",
+      "delivered_at",
+      "destination_country",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "discarded": [
+      "origin_country",
+      "tracking_alias"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "pickup_point",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

package/dist/carriers/nova-global/parser.d.ts

@@ -0,0 +1,14 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Nova Global";
+export declare const NOVA_GLOBAL_MAX_BYTES: number;
+/** A Nova Global waybill, in capitals; anything else is not a number it issues. */
+export declare function normalizeNovaGlobalNumber(raw: string): string;
+/**
+ * The reply of `tracking.php` for one waybill: the summary of its newest scan,
+ * the route's two country codes, the parcel's other numbers, its delivery
+ * partner and `historyStatus`, its scans newest first. They keep that order:
+ * their clocks are not all instants. The tracker echoes the number asked as
+ * `billNumber`. An empty body, the reply to a number it does not know, is
+ * read before this.
+ */
+export declare function parseNovaGlobal(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/nova-global/parser.js

@@ -0,0 +1,166 @@
+import { DateTime } from 'luxon';
+import { carrierIdFromPartner } from '../../core/catalog/hints.js';
+import { detectCarrierMatch, normalizeTrackingNumber } from '../../core/detection/index.js';
+import { returnedTrackingNumber } from '../../core/detection/returned.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { countryCode, countryTimeZone } from '../../core/time/index.js';
+import { clean, cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { novaGlobalStage } from './status.js';
+export const PROVIDER = 'Nova Global';
+// A long history is a few kilobytes.
+export const NOVA_GLOBAL_MAX_BYTES = 512 * 1024;
+// Two letters, nine to sixteen digits and NPG, as rule nova-global-1 claims.
+const NUMBER = /^[A-Z]{2}\d{9,16}NPG$/;
+const WALL_CLOCK = /^(\d{4})\/(\d{2})\/(\d{2}) (\d{2}):(\d{2}):(\d{2})$/;
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+// The page's script reads this reply as a number the tracker does not know.
+const NOT_FOUND = 203;
+/** A Nova Global waybill, in capitals; anything else is not a number it issues. */
+export function normalizeNovaGlobalNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Nova Global waybills are two letters, nine to sixteen digits and NPG');
+    return number;
+}
+/** An optional text field; an object or array is a changed reply. */
+function text(row, key, maxLength = 300) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string' && typeof value !== 'number')
+        throw new SchemaError(PROVIDER, `Nova Global returned an invalid ${key}`);
+    return cleanScalar(value, maxLength);
+}
+/** A two-letter country code the reply gives, or nothing. */
+function country(row, key) {
+    const code = text(row, key, 8).toUpperCase();
+    return /^[A-Z]{2}$/.test(code) && countryCode(code) === code ? code : '';
+}
+/**
+ * A scan's clock. `date` is a wall clock with no zone, and `timestamp` the
+ * instant the tracker makes of it by reading every wall clock on Kyiv time.
+ * Scans abroad keep the scanning site's own clock, which that reading
+ * misplaces, so the instant counts only where it reads back to the wall
+ * clock in the zone of the country the scan names: in practice Ukraine.
+ * Every other scan keeps its wall clock.
+ */
+function clockOf(row, place) {
+    const wall = WALL_CLOCK.exec(text(row, 'date', 32));
+    const local = wall ? `${wall[1]}-${wall[2]}-${wall[3]}T${wall[4]}:${wall[5]}:${wall[6]}` : '';
+    // Parsing in UTC checks the calendar digits only; Luxon rolls 24:00 over, so the clock must read back unchanged.
+    const parsed = DateTime.fromISO(local, { zone: 'UTC' });
+    if (!wall || !parsed.isValid || parsed.toFormat("yyyy-MM-dd'T'HH:mm:ss") !== local) {
+        throw new SchemaError(PROVIDER, 'Nova Global returned an invalid scan time');
+    }
+    const zone = place ? countryTimeZone(place) : null;
+    const stamp = row.timestamp;
+    if (zone && typeof stamp === 'number' && Number.isSafeInteger(stamp) && stamp > 0) {
+        const instant = DateTime.fromSeconds(stamp, { zone });
+        const time = instant.isValid && instant.toFormat("yyyy-MM-dd'T'HH:mm:ss") === local ? instant.toISO({ suppressMilliseconds: true }) : null;
+        if (time)
+            return { time };
+    }
+    return { local_time: local };
+}
+/**
+ * The scan's line, which starts with the name of the country the scan names
+ * and a full stop ("Ukraine.Delivered"); the name becomes its location.
+ */
+function wordingOf(status, place) {
+    const stop = status.indexOf('.');
+    const name = stop > 0 ? status.slice(0, stop).trim() : '';
+    const rest = stop > 0 ? clean(status.slice(stop + 1)) : '';
+    if (place && name && rest && countryCode(name) === place)
+        return { description: rest, location: name };
+    return { description: status, location: place };
+}
+function projectRow(row) {
+    if (!isRecord(row))
+        throw new SchemaError(PROVIDER, 'Nova Global returned an invalid scan');
+    const status = text(row, 'status');
+    if (!status)
+        throw new SchemaError(PROVIDER, 'Nova Global returned a scan without wording');
+    const place = country(row, 'location');
+    const { description, location } = wordingOf(status, place);
+    const code = text(row, 'code', 16);
+    const staged = novaGlobalStage(code, description);
+    const event = {
+        ...clockOf(row, place),
+        ...(location ? { location } : {}),
+        description,
+        ...(code ? { provider_code: code } : {}),
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+    return { key: JSON.stringify([text(row, 'date', 32), code, status]), event };
+}
+/**
+ * The partner the reply says delivers the parcel, with its number. `bills`
+ * lists the parcel's other numbers without saying whose each is: the sending
+ * carrier's, Nova Poshta's waybill and the partner's. The partner's number is
+ * the only one of the partner's own shape; with none or several, there is no
+ * hand-off.
+ */
+function handoff(payload, number) {
+    const name = text(payload, 'partner', 80);
+    const partner = name ? carrierIdFromPartner(name) : undefined;
+    const bills = payload.bills;
+    if (!partner || partner === 'nova-global' || typeof bills !== 'string' || bills.length > 4096)
+        return {};
+    const references = new Set(bills.split(',').map((bill) => returnedTrackingNumber(bill))
+        .filter((bill) => /^[A-Z0-9]{4,40}$/.test(bill) && bill !== number));
+    const theirs = [...references].filter((bill) => detectCarrierMatch(bill).candidates.includes(partner));
+    return theirs.length === 1 ? { delivery_carrier: partner, delivery_tracking_number: theirs[0] } : {};
+}
+/**
+ * The reply of `tracking.php` for one waybill: the summary of its newest scan,
+ * the route's two country codes, the parcel's other numbers, its delivery
+ * partner and `historyStatus`, its scans newest first. They keep that order:
+ * their clocks are not all instants. The tracker echoes the number asked as
+ * `billNumber`. An empty body, the reply to a number it does not know, is
+ * read before this.
+ */
+export function parseNovaGlobal(payload, raw) {
+    const number = normalizeNovaGlobalNumber(raw);
+    if (payload === NOT_FOUND)
+        throw new NotFoundError(PROVIDER);
+    if (!isRecord(payload) || typeof payload.billNumber !== 'string')
+        throw new SchemaError(PROVIDER, 'Nova Global returned a reply without its waybill');
+    if (returnedTrackingNumber(payload.billNumber) !== number)
+        throw new IndeterminateError(PROVIDER, 'Nova Global answered for another waybill');
+    const rows = payload.historyStatus ?? [];
+    if (!Array.isArray(rows))
+        throw new SchemaError(PROVIDER, 'Nova Global returned a waybill with invalid scans');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Nova Global returned an oversized history');
+    const seen = new Set();
+    const events = [];
+    for (const row of rows) {
+        const scan = projectRow(row);
+        if (seen.has(scan.key))
+            continue;
+        seen.add(scan.key);
+        events.push(scan.event);
+    }
+    if (!events.length)
+        throw new NoHistoryError(PROVIDER);
+    const newest = events[0];
+    const current = events.find((event) => event.stage);
+    const stage = current?.stage;
+    const destination = country(payload, 'to');
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time ?? null,
+        ...(newest.local_time ? { last_update_local: newest.local_time } : {}),
+        expected_delivery: null,
+        ...(stage === 'delivered' && current.time ? { delivered_at: current.time } : {}),
+        ...handoff(payload, number),
+        ...(destination ? { destination_country: destination } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/nova-global/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 Nova Global's codes give a scan code. */
+export declare function novaGlobalMappedStage(code: string): Stage | undefined;
+/** A scan's stage: its code, else the shared wording rules, else nothing. */
+export declare function novaGlobalStage(code: string, wording: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/nova-global/status.js

@@ -0,0 +1,51 @@
+import { classifyWording } from '../../core/status/index.js';
+/**
+ * Nova Global's scan codes, the same whatever the reply's language. Only codes
+ * seen in replies are mapped; another code falls to the wording rules.
+ */
+const CODES = new Map([
+    ['1-0', 'registered'], // The order for delivery to the destination country.
+    ['1-2', 'accepted'], // A parcel that reached the hub without an order is processed there.
+    ['14', 'accepted'],
+    ['20', 'customs'], // Delivered to the customs terminal.
+    ['22', 'in_transit'], // Left the customs terminal.
+    ['23', 'in_transit'], // Arrived at a transit sorting centre.
+    ['24', 'in_transit'], // Arrived in a country under customs control, on its way through.
+    ['24-1', 'in_transit'], // In transit through Ukraine.
+    ['25', 'in_transit'], // Left a country under customs control.
+    ['26', 'in_transit'], // Left a transit sorting centre.
+    ['30', 'in_transit'], // Sent to the destination city.
+    ['301', 'in_transit'], // At the terminal of the destination city.
+    ['303', 'ready_for_pickup'], // In a parcel locker, for the recipient to collect.
+    ['37', 'out_for_delivery'],
+    ['38', 'ready_for_pickup'], // At the branch, for the recipient to collect.
+    ['3-1', 'delivered'],
+    ['400', 'customs'], // Customs declaration under way.
+    ['401', 'in_transit'], // Customs declaration finished: the parcel is cleared.
+    ['402', 'customs'], // The parcel needs customs clearance.
+    ['407', 'customs'], // Documents submitted for customs clearance.
+    ['407-1', 'customs'],
+    ['410', 'customs'], // The documents customs asked for arrived.
+    ['54', 'in_transit'], // A truck left for its destination.
+    ['55', 'in_transit'], // A truck reached its destination.
+    ['553', 'exception'], // Lost.
+    ['63-4', 'in_transit'], // Released from the hub's area for parcels without an order.
+    ['76', 'in_transit'], // The consignment reached the airport.
+    ['247', 'in_transit'], // Processed and ready for the flight.
+]);
+/** The stage Nova Global's codes give a scan code. */
+export function novaGlobalMappedStage(code) {
+    return CODES.get(code.trim());
+}
+/** A scan's stage: its code, else the shared wording rules, else nothing. */
+export function novaGlobalStage(code, wording) {
+    const mapped = novaGlobalMappedStage(code);
+    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) => (code ? novaGlobalMappedStage(code) : undefined),
+    gaps: [],
+};

package/dist/carriers/nova-global/statuses.json

@@ -12,7 +12,7 @@
     {"wording": "Відправлення потребує митного оформлення", "stage": "customs", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; the parcel needs customs clearance."},
     {"wording": "Нестача /невідповідність супровідних документів", "stage": "customs", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; documents are missing or do not match, which holds the parcel in customs. Spacing as the tracker prints it."},
     {"wording": "Супровідні документи отримані", "stage": "customs", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; the missing documents arrived."},
-    {"wording": "Митне декларування завершене", "stage": "customs", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; customs clearance finished."},
+    {"wording": "Митне декларування завершене", "stage": "in_transit", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; customs clearance finished, which puts the parcel back in transit."},
     {"wording": "Відправлено в місто призначення", "stage": "in_transit", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; the parcel was sent on to the destination city."},
     {"wording": "Доставлено в транзитний сортувальний центр", "stage": "in_transit", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker."},
     {"wording": "Відправлення одержано", "stage": "delivered", "language": "uk", "confirmedBy": "portal", "note": "An event in an archived capture of Nova Poshta Global's tracker; the recipient collected the parcel."},
@@ -23,7 +23,51 @@
     {"wording": "Shipment is in transit", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker, seen at the arrival airport in Ukraine."},
     {"wording": "Delivered to the customs terminalr", "stage": "customs", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker, misspelt as the tracker prints it."},
     {"wording": "In the process of customs declaration", "stage": "customs", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker."},
-    {"wording": "Customs declaration finished", "stage": "customs", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker."},
-    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker."}
+    {"wording": "Customs declaration finished", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker; customs clearance finished, which puts the parcel back in transit."},
+    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "An event in an archived capture of the English tracker."},
+    {"code": "1-0", "wording": "Order is processed for delivery to the country of destination", "stage": "registered", "language": "en", "confirmedBy": "live"},
+    {"code": "1-0", "wording": "Оформлено замовлення на доставку в країну призначення", "stage": "registered", "language": "uk", "confirmedBy": "live"},
+    {"code": "1-2", "wording": "Processing an unregistered shipment", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "At the hub, for a parcel that arrived without an order; written beside the order itself."},
+    {"code": "14", "wording": "Accepted for delivery", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "The first scan at the sending site, in the United States or Ukraine."},
+    {"code": "14", "wording": "Прийнято до перевезення", "stage": "accepted", "language": "uk", "confirmedBy": "live"},
+    {"code": "20", "wording": "Delivered to the customs terminal", "stage": "customs", "language": "en", "confirmedBy": "live"},
+    {"code": "20", "wording": "Доставлено до митного терміналу", "stage": "customs", "language": "uk", "confirmedBy": "live"},
+    {"code": "22", "wording": "Left the customs terminal", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "22", "wording": "Вибуло із митного терміналу", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "23", "wording": "Shipment arrived at the transit sorting center", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "23", "wording": "Вантаж прибув у транзитний сортувальний центр", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "24", "wording": "Shipment arrived in the transit country under customs control", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Also written on arrival in the destination country before the partner delivers."},
+    {"code": "24-1", "wording": "The shipment is in transit through Ukraine", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "25", "wording": "Shipment left the transit country under customs control", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "25", "wording": "Вантаж вибув з транзитної країни під митним контролем", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "26", "wording": "Shipment left the transit sorting center", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "30", "wording": "Sent to the destination city", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "30", "wording": "Відправлено в місто призначення", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "301", "wording": "At the terminal of the destination city", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "301", "wording": "На терміналі міста призначення", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "303", "wording": "Delivered to the locker", "stage": "ready_for_pickup", "language": "en", "confirmedBy": "live", "note": "In a Nova Poshta parcel locker, waiting for the recipient."},
+    {"code": "303", "wording": "Доставлено в поштомат", "stage": "ready_for_pickup", "language": "uk", "confirmedBy": "live"},
+    {"code": "37", "wording": "On courier delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live", "note": "With the partner's courier in the destination country."},
+    {"code": "38", "wording": "At the post office", "stage": "ready_for_pickup", "language": "en", "confirmedBy": "live", "note": "At the Nova Poshta branch, waiting for the recipient."},
+    {"code": "3-1", "wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "The page marks this code as the delivery."},
+    {"code": "3-1", "wording": "Відправлення одержано", "stage": "delivered", "language": "uk", "confirmedBy": "live"},
+    {"code": "400", "wording": "In the process of customs declaration", "stage": "customs", "language": "en", "confirmedBy": "live"},
+    {"code": "400", "wording": "В процесі митного декларування", "stage": "customs", "language": "uk", "confirmedBy": "live"},
+    {"code": "401", "wording": "Customs declaration finished", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Customs clearance finished, which puts the parcel back in transit."},
+    {"code": "401", "wording": "Митне декларування завершене", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "402", "wording": "Parcel require customs clearance", "stage": "customs", "language": "en", "confirmedBy": "live", "note": "Spelt as the tracker prints it."},
+    {"code": "407", "wording": "The documents were submitted for customs clearance", "stage": "customs", "language": "en", "confirmedBy": "live"},
+    {"code": "407-1", "wording": "The documents were submitted for customs clearance", "stage": "customs", "language": "en", "confirmedBy": "live"},
+    {"code": "410", "wording": "Accompanying documents received", "stage": "customs", "language": "en", "confirmedBy": "live"},
+    {"code": "54", "wording": "The truck departed for its destination", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "54", "wording": "Рейс вибув до пункту призначення", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "55", "wording": "The truck arrived at the destination point", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "55", "wording": "Рейс прибув в пункт призначення", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "553", "wording": "Shipment lost", "stage": "exception", "language": "en", "confirmedBy": "live"},
+    {"code": "63-4", "wording": "IEW released from the \"Unregistered\" area", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Released from the hub's area for parcels that arrived without an order."},
+    {"code": "76", "wording": "The batch of cargo arrived at the airport", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "76", "wording": "Партія вантажу прибула в аеропорт", "stage": "in_transit", "language": "uk", "confirmedBy": "live"},
+    {"code": "247", "wording": "Shipment processed - ready for further shipment on the flight", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"code": "247", "wording": "Відправлення оброблено - готово до подальшого відвантаження на рейс", "stage": "in_transit", "language": "uk", "confirmedBy": "live"}
   ]
 }

package/dist/core/catalog/statusMaps.js

@@ -170,6 +170,7 @@ import { statusMap as jsExpress } from '../../carriers/js-express/status.js';
 import { statusMap as kazpost } from '../../carriers/kazpost/status.js';
 import { statusMap as kex } from '../../carriers/kex/status.js';
 import { statusMap as kuehneNagel } from '../../carriers/kuehne-nagel/status.js';
+import { statusMap as kyoungdong } from '../../carriers/kyoungdong/status.js';
 import { statusMap as laPoste } from '../../carriers/la-poste/status.js';
 import { statusMap as latvijasPasts } from '../../carriers/latvijas-pasts/status.js';
 import { statusMap as leopardsCourier } from '../../carriers/leopards-courier/status.js';
@@ -200,6 +201,7 @@ import { statusMap as nextLevelDelivery } from '../../carriers/next-level-delive
 import { statusMap as nipost } from '../../carriers/nipost/status.js';
 import { statusMap as nipponExpress } from '../../carriers/nippon-express/status.js';
 import { statusMap as norskGlobal } from '../../carriers/norsk-global/status.js';
+import { statusMap as novaGlobal } from '../../carriers/nova-global/status.js';
 import { statusMap as nox } from '../../carriers/nox/status.js';
 import { statusMap as oca } from '../../carriers/oca/status.js';
 import { statusMap as oldDominion } from '../../carriers/old-dominion/status.js';
@@ -343,11 +345,11 @@ export const STATUS_MAPS = {
     'go-express': goExpress, globalpost, go4, gofo, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'gofo-nl': gofoNl, gzyl, hanjin, 'happy-post': happyPost, haypost, 'hct-logistics': hctLogistics,
     helthjem, hepsijet, 'hermes-at': hermesAt, hispapost, 'hr-parcel': hrParcel,
     'hrvatska-posta': hrvatskaPosta, hywl, 'ids-logistik': idsLogistik, imile, instabox, interrapidisimo, 'intex-paketdienst': intexPaketdienst, 'israel-post': israelPost, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo,
-    'j-and-t-middle-east': jAndTMiddleEast, jhgj, jitsu, jne, 'jordan-post': jordanPost, jrt, 'js-express': jsExpress, kazpost, kex, 'kuehne-nagel': kuehneNagel, 'la-poste': laPoste, 'latvijas-pasts': latvijasPasts,
+    'j-and-t-middle-east': jAndTMiddleEast, jhgj, jitsu, jne, 'jordan-post': jordanPost, jrt, 'js-express': jsExpress, kazpost, kex, 'kuehne-nagel': kuehneNagel, kyoungdong, 'la-poste': laPoste, 'latvijas-pasts': latvijasPasts,
     'leopards-courier': leopardsCourier, liccardi, 'lietuvos-pastas': lietuvosPastas, linhan, 'lion-parcel': lionParcel, logen, loggi, logoix, 'loomis-express': loomisExpress,
     'lotte-global': lotteGlobal, 'magyar-posta': magyarPosta, mailamericas, mainfreight, maltapost, matkahuolto, mayiyinfu, meest, 'messenger-cz': messengerCz,
     'metropolitan-warehouse': metropolitanWarehouse, 'mng-kargo': mngKargo, mtscn, mylerz, naqel, nationex, 'next-level-delivery': nextLevelDelivery, nipost, 'nippon-express': nipponExpress,
-    'norsk-global': norskGlobal, nox, oca, 'old-dominion': oldDominion, 'olva-courier': olvaCourier, omgo, omniva,
+    'norsk-global': norskGlobal, 'nova-global': novaGlobal, nox, oca, 'old-dominion': oldDominion, 'olva-courier': olvaCourier, omgo, omniva,
     'one-world-express': oneWorldExpress, 'orlen-paczka': orlenPaczka, 'osm-worldwide': osmWorldwide, 'pack-man': packMan, packlink, packs,
     'pakistan-post': pakistanPost, palletways, paquetexpress, passport, 'pathao-courier': pathaoCourier, 'pdn-express': pdnExpress, pecom,
     'pfc-express': pfcExpress, phlpost,

package/dist/data/catalog.json

@@ -17174,7 +17174,7 @@
         "timezone": "Asia/Seoul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "kyoungdong"
         },
         "canaryUrl": "https://kdexp.com/index.do",
         "trackingUrlTemplate": "https://kdexp.com/service/delivery/etc/delivery.do?barcode={trackingNumber}",
@@ -19610,7 +19610,9 @@
         "timezone": "Europe/Kyiv",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "nova-global",
+            "recognitionRank": 834,
+            "localClocks": true
         },
         "canaryUrl": "https://nova.global/track/",
         "trackingUrlTemplate": "https://nova.global/track/?Tracking_ID={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -11076,7 +11076,7 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Asia/Seoul";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "kyoungdong";
         };
         readonly canaryUrl: "https://kdexp.com/index.do";
         readonly trackingUrlTemplate: "https://kdexp.com/service/delivery/etc/delivery.do?barcode={trackingNumber}";
@@ -12611,7 +12611,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Kyiv";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "nova-global";
+            readonly recognitionRank: 834;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://nova.global/track/";
         readonly trackingUrlTemplate: "https://nova.global/track/?Tracking_ID={trackingNumber}";

package/dist/generated/catalog.js

@@ -17175,7 +17175,7 @@ export const CARRIER_CATALOG = {
         "timezone": "Asia/Seoul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "kyoungdong"
         },
         "canaryUrl": "https://kdexp.com/index.do",
         "trackingUrlTemplate": "https://kdexp.com/service/delivery/etc/delivery.do?barcode={trackingNumber}",
@@ -19611,7 +19611,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Kyiv",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "nova-global",
+            "recognitionRank": 834,
+            "localClocks": true
         },
         "canaryUrl": "https://nova.global/track/",
         "trackingUrlTemplate": "https://nova.global/track/?Tracking_ID={trackingNumber}",

package/dist/generated/recognition.js

@@ -182,6 +182,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "nipost": 908,
     "nippon-express": 941,
     "norsk-global": 845,
+    "nova-global": 834,
     "nova-poshta": 685,
     "nox": 874,
     "nz-post": 760,

package/dist/generated/registry.js

@@ -209,6 +209,7 @@ import { adapter as kazpost } from '../carriers/kazpost/adapter.js';
 import { adapter as kex } from '../carriers/kex/adapter.js';
 import { adapter as koreaPost } from '../carriers/korea-post/adapter.js';
 import { adapter as kuehneNagel } from '../carriers/kuehne-nagel/adapter.js';
+import { adapter as kyoungdong } from '../carriers/kyoungdong/adapter.js';
 import { adapter as laPoste } from '../carriers/la-poste/adapter.js';
 import { adapter as landmarkGlobal } from '../carriers/landmark-global/adapter.js';
 import { adapter as latvijasPasts } from '../carriers/latvijas-pasts/adapter.js';
@@ -245,6 +246,7 @@ import { adapter as ninjaVan } from '../carriers/ninja-van/adapter.js';
 import { adapter as nipost } from '../carriers/nipost/adapter.js';
 import { adapter as nipponExpress } from '../carriers/nippon-express/adapter.js';
 import { adapter as norskGlobal } from '../carriers/norsk-global/adapter.js';
+import { adapter as novaGlobal } from '../carriers/nova-global/adapter.js';
 import { adapter as novaPoshta } from '../carriers/nova-poshta/adapter.js';
 import { adapter as nox } from '../carriers/nox/adapter.js';
 import { adapter as nzPost } from '../carriers/nz-post/adapter.js';
@@ -607,6 +609,7 @@ export const REGISTRY = {
         "kex": kex,
         "korea-post": koreaPost,
         "kuehne-nagel": kuehneNagel,
+        "kyoungdong": kyoungdong,
         "la-poste": laPoste,
         "landmark-global": landmarkGlobal,
         "latvijas-pasts": latvijasPasts,
@@ -643,6 +646,7 @@ export const REGISTRY = {
         "nipost": nipost,
         "nippon-express": nipponExpress,
         "norsk-global": norskGlobal,
+        "nova-global": novaGlobal,
         "nova-poshta": novaPoshta,
         "nox": nox,
         "nz-post": nzPost,
@@ -1167,7 +1171,7 @@ export const REGISTRY = {
         "kuehne-nagel": "kuehne-nagel",
         "kunyoung": "universal",
         "kwick-box": "universal",
-        "kyoungdong": "universal",
+        "kyoungdong": "kyoungdong",
         "kyrgyz-post": "universal",
         "l-post": "universal",
         "la-poste": "la-poste",
@@ -1240,7 +1244,7 @@ export const REGISTRY = {
         "nord-wheel": "universal",
         "norsk-global": "norsk-global",
         "northline": "universal",
-        "nova-global": "universal",
+        "nova-global": "nova-global",
         "nova-poshta": "nova-poshta",
         "nox": "nox",
         "nz-couriers": "universal",

package/dist/server/openapi.json

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

package/package.json

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