universal-parcel-scraper 0.487.0-main.2349 → 0.488.0-main.2356

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 **530 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **531 dedicated adapters** and **5 universal fallbacks**
 
 <sub>772 catalog entries · 134 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 15,354 such statuses, each filed under one stage.
+The carrier folders record 15,361 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

@@ -8915,7 +8915,9 @@
     "timezone": "Asia/Seoul",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "chunil",
+      "recognitionRank": 621,
+      "localClocks": true
     },
     "canaryUrl": "https://www.chunil.co.kr/HTrace/HTrace.jsp",
     "trackingUrlTemplate": "https://www.chunil.co.kr/HTrace/HTrace.jsp?transNo={trackingNumber}",

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -9406,6 +9406,28 @@
       "j-and-t"
     ]
   },
+  {
+    "input": "10000000001",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "postlogistics",
+      "gls-ch",
+      "gls-fr",
+      "gls-de",
+      "dhl-ecommerce-pl",
+      "gls-at",
+      "gls-pl",
+      "ppl"
+    ],
+    "asked": [
+      "gls-fr",
+      "gls-de",
+      "gls-ch",
+      "postlogistics",
+      "dhl-ecommerce-pl"
+    ]
+  },
   {
     "input": "1000000157123",
     "carrier": "unknown",
@@ -13483,28 +13505,6 @@
       "zto"
     ]
   },
-  {
-    "input": "11633265509",
-    "carrier": "unknown",
-    "confidence": "low",
-    "candidates": [
-      "postlogistics",
-      "gls-ch",
-      "gls-fr",
-      "gls-de",
-      "dhl-ecommerce-pl",
-      "gls-at",
-      "gls-pl",
-      "ppl"
-    ],
-    "asked": [
-      "gls-fr",
-      "gls-de",
-      "gls-ch",
-      "postlogistics",
-      "dhl-ecommerce-pl"
-    ]
-  },
   {
     "input": "116439049496",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -7075,7 +7075,9 @@ var Ue = {
 		timezone: "Asia/Seoul",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "chunil",
+			recognitionRank: 621,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.chunil.co.kr/HTrace/HTrace.jsp",
 		trackingUrlTemplate: "https://www.chunil.co.kr/HTrace/HTrace.jsp?transNo={trackingNumber}",
@@ -29550,6 +29552,7 @@ var Tl = {
 	"chit-chats": 115,
 	chronodiali: 781,
 	chronopost: 890,
+	chunil: 621,
 	ciblex: 640,
 	"city-express-rs": 817,
 	citymail: 868,

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

@@ -1,5 +1,7 @@
 import { type ClassifiedWording } from '../../core/status/index.js';
 import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** Chronopost's notice to the recipient, which providers relay as it is. */
+export declare const CHRONOPOST_NOTIFICATION = "Destinataire inform\u00E9 par SMS ou mail";
 /** A notice to the recipient, or the recipient's own delivery instruction: neither is a scan. */
 export declare function isChronopostNotification(label: string): boolean;
 /** The scan that sends the parcel back to its sender. */

package/dist/carriers/chronopost/status.js

@@ -52,6 +52,8 @@ for (const [code, label, stage] of OBSERVED)
     observed.set(code, (observed.get(code) ?? new Map()).set(label, stage));
 const NOTIFICATION = 'Destinataire informé par SMS ou mail';
 const INSTRUCTION = 'Instruction de livraison reçue';
+/** Chronopost's notice to the recipient, which providers relay as it is. */
+export const CHRONOPOST_NOTIFICATION = NOTIFICATION;
 /** A notice to the recipient, or the recipient's own delivery instruction: neither is a scan. */
 export function isChronopostNotification(label) {
     return label === NOTIFICATION || label === INSTRUCTION;

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

@@ -0,0 +1,17 @@
+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 page the tracking fields on Chunil's sites open for a waybill. */
+export declare const CHUNIL_TRACE = "https://www.chunil.co.kr/HTrace/HTrace.jsp";
+/** The page's address for one whole waybill. */
+export declare function chunilTraceUrl(number: string): string;
+export declare class ChunilTracker {
+    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/chunil/adapter.js

@@ -0,0 +1,54 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+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 { CHUNIL_MAX_BYTES, normalizeChunilNumber, parseChunil, PROVIDER } from './parser.js';
+/** The page the tracking fields on Chunil's sites open for a waybill. */
+export const CHUNIL_TRACE = 'https://www.chunil.co.kr/HTrace/HTrace.jsp';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// The page answers an unknown number with HTTP 200; a missing route is not a missing parcel.
+const GONE = [404, 410];
+// The page is served as UTF-8; an older Korean page would name EUC-KR or its Windows superset.
+const KOREAN_CHARSET = /charset=["']?(?:euc-kr|ks_c_5601-1987|cp949|windows-949)\b/i;
+/** The page's address for one whole waybill. */
+export function chunilTraceUrl(number) {
+    return `${CHUNIL_TRACE}?${new URLSearchParams({ transNo: normalizeChunilNumber(number) })}`;
+}
+export class ChunilTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeChunilNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(chunilTraceUrl(number), { method: 'GET', signal, headers: {
+                    Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: CHUNIL_MAX_BYTES, redirect: 'manual',
+                fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, ...GONE] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Chunil Express redirected its tracking page');
+            if (GONE.includes(response.status))
+                throw new TransportError(PROVIDER, 'Chunil Express tracking page is unavailable');
+            const encoding = KOREAN_CHARSET.test(response.headers.get('content-type') ?? '') ? 'euc-kr' : 'utf-8';
+            return parseChunil(decodeText(bytes, encoding), 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: 'chunil', 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 ChunilTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'chunil', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeChunilNumber(number))),
+    };
+};

package/dist/carriers/chunil/carrier.json

@@ -18,18 +18,61 @@
   "timezone": "Asia/Seoul",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "chunil",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 621
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location"
+  ],
   "portal": {
     "url": "https://www.chunil.co.kr/HTrace/HTrace.jsp?transNo={trackingNumber}",
     "searchUrl": "https://www.chunil.co.kr/HTrace/HTrace.jsp",
     "canaryUrl": "https://www.chunil.co.kr/HTrace/HTrace.jsp",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "sender_name",
+      "recipient_name",
+      "signatory",
+      "origin",
+      "destination",
+      "office_contact_details",
+      "order_contents",
+      "parcel_count"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "signatory",
+      "origin",
+      "destination",
+      "office_contact_details",
+      "order_contents",
+      "parcel_count"
+    ],
+    "unavailable": [
+      "offset_timestamps",
+      "delivered_at",
+      "eta",
+      "weight",
+      "service_name",
+      "provider_code",
+      "pickup_point"
+    ]
   },
   "links": [
     {

package/dist/carriers/chunil/numbers.json

@@ -2,18 +2,11 @@
   "carrier": "chunil",
   "records": [
     {
-      "number": "11633265509",
+      "number": "10000000001",
       "role": "shipment",
-      "evidence": "public_shipment_report",
-      "source": {
-        "url": "https://web.archive.org/web/20240229082427/http://www.chunil.co.kr/HTrace/HTrace.jsp?transNo=11633265509",
-        "date": "2024-02-29",
-        "dateKind": "capture",
-        "access": "full_page"
-      },
-      "context": {
-        "assessment": "confirmed"
-      },
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-10-19",
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
@@ -28,7 +21,7 @@
           "ppl"
         ]
       },
-      "note": "The opened capture of Chunil Express's tracker shows the parcel with seven scans from acceptance in Daejeon to delivery."
+      "note": "Invented placeholder for an eleven-digit waybill; the public sample's tracker names its sender and recipient, masked."
     }
   ]
 }

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

@@ -0,0 +1,14 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Chunil Express";
+export declare const CHUNIL_MAX_BYTES: number;
+/** A Chunil Express waybill: eleven digits, as its tracking form asks for them. */
+export declare function normalizeChunilNumber(raw: string): string;
+/**
+ * The page `www.chunil.co.kr/HTrace/HTrace.jsp?transNo={number}` answers. The
+ * search field keeps the number asked; a parcel's details are headed by it,
+ * and its route table lists the scans oldest first, each with its day,
+ * branch, the branch's phone number and status. The sender, the recipient and
+ * the signer (masked names), the goods, the parcel count and the branches'
+ * phone numbers are not read.
+ */
+export declare function parseChunil(html: string, raw: string): CarrierResult;

package/dist/carriers/chunil/parser.js

@@ -0,0 +1,141 @@
+import { load } from 'cheerio';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { chunilStage } from './status.js';
+export const PROVIDER = 'Chunil Express';
+// A parcel's page is about 20 kilobytes.
+export const CHUNIL_MAX_BYTES = 512 * 1024;
+const NUMBER = /^\d{11}$/;
+// Date, branch, phone and status.
+const COLUMNS = '날짜|영업소|전화번호|상태';
+// The heading above a parcel: "below is the result of looking up waybill number {number}".
+const RESULT_FOR = '조회한 결과입니다';
+// The page's own answer for a number it has no parcel for: "there is no result".
+const MISSING = '결과가 없습니다.';
+// The delivery result's label in the parcel's details.
+const OUTCOME = '배송/출고결과:';
+const DAY = /^(\d{4})-(\d{2})-(\d{2})$/;
+// Bot checks a CDN or firewall could put in place of the page.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>\s*Just a moment|g-recaptcha|h-captcha|AwsWafIntegration|awswaf\.com/i;
+// A run of nine or more digits, with hyphens, dots, spaces or brackets between them, as phone numbers are written.
+const PHONE = /(?<!\d)\+?\d(?:[\s().-]{0,2}\d){8,}(?!\d)/g;
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+/** A Chunil Express waybill: eleven digits, as its tracking form asks for them. */
+export function normalizeChunilNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Chunil Express waybills are eleven digits');
+    return number;
+}
+function invalid(message) {
+    throw new SchemaError(PROVIDER, message);
+}
+/** A scan's day, as the page writes it; the history gives no time of day. */
+function scanDay(text) {
+    const match = DAY.exec(text);
+    const day = match ? calendarDay(Number(match[1]), Number(match[2]), Number(match[3])) : null;
+    return day ?? invalid('Chunil Express returned an invalid scan date');
+}
+/** The value beside a label in one of the parcel's detail tables, by the label without its spaces. */
+function detail($, label) {
+    const values = $('table.table02 tr').filter((_, row) => clean($(row).children('td').first().text()).replace(/\s/g, '') === label)
+        .map((_, row) => clean($(row).children('td').eq(1).text(), 80)).get();
+    if (values.length > 1)
+        invalid('Chunil Express returned repeated parcel details');
+    return values[0] ?? '';
+}
+/**
+ * The page `www.chunil.co.kr/HTrace/HTrace.jsp?transNo={number}` answers. The
+ * search field keeps the number asked; a parcel's details are headed by it,
+ * and its route table lists the scans oldest first, each with its day,
+ * branch, the branch's phone number and status. The sender, the recipient and
+ * the signer (masked names), the goods, the parcel count and the branches'
+ * phone numbers are not read.
+ */
+export function parseChunil(html, raw) {
+    const number = normalizeChunilNumber(raw);
+    const $ = load(html);
+    const field = $('input#transNo');
+    if (field.length !== 1) {
+        if (CHALLENGE.test(html.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Chunil Express answered with a browser check');
+        invalid('Chunil Express returned a page without its search field');
+    }
+    // The page trims the number it was sent and keeps it in its search field.
+    const asked = clean(field.attr('value'), 32);
+    const history = $('table#tracking');
+    const missing = $('td').filter((_, cell) => clean($(cell).text()) === MISSING);
+    if (missing.length) {
+        if (history.length || missing.length > 1)
+            invalid('Chunil Express returned an unexpected empty answer');
+        if (asked !== number)
+            throw new IndeterminateError(PROVIDER, 'Chunil Express answered for another number');
+        throw new NotFoundError(PROVIDER);
+    }
+    const heading = $('b').filter((_, bold) => clean($(bold).closest('td').text()).includes(RESULT_FOR))
+        .map((_, bold) => clean($(bold).text(), 32)).get();
+    if (heading.length !== 1 || history.length !== 1)
+        invalid('Chunil Express returned a page without a parcel');
+    if (heading[0] !== number || asked !== number)
+        throw new IndeterminateError(PROVIDER, 'Chunil Express answered for another parcel');
+    const rows = history.find('tr').toArray();
+    const columns = $(rows[0]).children('td').map((_, cell) => clean($(cell).text())).get().join('|');
+    if (columns !== COLUMNS)
+        invalid('Chunil Express returned an unexpected route table');
+    if (rows.length > MAX_ROWS)
+        invalid('Chunil Express returned an oversized history');
+    const seen = new Set();
+    const listed = [];
+    for (const row of rows.slice(1)) {
+        const cells = $(row).children('td');
+        if (cells.length !== 4)
+            invalid('Chunil Express returned an incomplete scan');
+        const local_time = scanDay(clean(cells.eq(0).text(), 16));
+        // The branch; its phone number, in the next column, is not read.
+        const location = clean(cells.eq(1).text().replace(PHONE, ' ').replace(/\(\s*\)/g, ' '), 80);
+        const description = clean(cells.eq(3).text(), 80);
+        if (!description)
+            invalid('Chunil Express returned a scan without its status');
+        const key = JSON.stringify([local_time, description, location]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const staged = chunilStage(description);
+        listed.push({
+            local_time,
+            ...(location ? { location } : {}),
+            description,
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        });
+    }
+    // Newest first, in the page's order: scans of one day cannot be told apart by their clocks.
+    const events = listed.reverse();
+    const outcome = detail($, OUTCOME);
+    if (!events.length && !outcome)
+        throw new NoHistoryError(PROVIDER);
+    // A delivery, in the route or as the delivery result, settles the parcel. Otherwise the newest
+    // staged scan says where it is, and the delivery result stands in for a route without one.
+    const result = outcome ? chunilStage(outcome) : null;
+    const delivery = events.find((event) => event.stage === 'delivered');
+    const staged = events.find((event) => event.stage);
+    const decided = delivery ? { stage: 'delivered', source: delivery.stage_source }
+        : result?.stage === 'delivered' ? result
+            : staged ? { stage: staged.stage, source: staged.stage_source } : result;
+    const newest = events[0];
+    const fromOutcome = decided === result && result !== null && !delivery;
+    return {
+        status: decided ? languageStageStatus(decided.stage) : 'unknown',
+        ...(decided ? { current_stage: decided.stage, current_stage_source: decided.source } : {}),
+        last_status_text: fromOutcome ? outcome : newest?.description ?? outcome,
+        last_update: null,
+        ...(newest && !fromOutcome ? { last_update_local: newest.local_time } : {}),
+        expected_delivery: null,
+        ...(events.length ? {} : { summary_only: true }),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

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

@@ -0,0 +1,8 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage Chunil's labels give a status, if the map knows it. */
+export declare function chunilMappedStage(label: string): Stage | undefined;
+/** A status's stage: the map, else the shared wording rules, else nothing. */
+export declare function chunilStage(label: string): ClassifiedWording | null;
+/** What the map says about one scan, by its label. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/chunil/status.js

@@ -0,0 +1,39 @@
+import { classifyWording } from '../../core/status/index.js';
+/**
+ * The labels of the route table's 상태 (status) column, which are also the
+ * values of the delivery result. Rows carry no code. The labels seen on the
+ * tracker are mapped, with those an open-source Korean tracker lists for this
+ * page; another label falls to the wording rules.
+ */
+const LABELS = new Map([
+    ['접수', 'accepted'], // The sending branch took the parcel in.
+    ['발송', 'in_transit'], // Sent on from the sending branch.
+    ['발송터미널하차', 'in_transit'], // Unloaded at the origin terminal.
+    ['발송터미널출발', 'in_transit'], // Left the origin terminal.
+    ['간선상차', 'in_transit'], // Loaded onto a trunk-line truck.
+    ['간선하차', 'in_transit'], // Unloaded from a trunk-line truck.
+    ['중계도착', 'in_transit'], // Arrived at a relay terminal.
+    ['중계발송', 'in_transit'], // Left a relay terminal.
+    ['도착터미널하차', 'in_transit'], // Unloaded at the destination terminal.
+    ['도착', 'in_transit'], // Arrived; the page's template places it before the terminal scans.
+    ['영업소도착', 'in_transit'], // Arrived at the delivering branch.
+    ['배송출발', 'out_for_delivery'], // Left the delivering branch for the recipient.
+    ['배송완료', 'delivered'],
+]);
+/** The stage Chunil's labels give a status, if the map knows it. */
+export function chunilMappedStage(label) {
+    return LABELS.get(label.replace(/\s/g, ''));
+}
+/** A status's stage: the map, else the shared wording rules, else nothing. */
+export function chunilStage(label) {
+    const mapped = chunilMappedStage(label);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(label, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** What the map says about one scan, by its label. */
+export const statusMap = {
+    stage: (code, wording) => (code ? undefined : chunilMappedStage(wording)),
+    gaps: [],
+};

package/dist/carriers/chunil/statuses.json

@@ -1,12 +1,18 @@
 {
   "carrier": "chunil",
   "entries": [
-    {"wording": "접수", "stage": "accepted", "language": "ko", "confirmedBy": "portal", "note": "The sending branch accepted the parcel. Seen in an archived reply of the tracker."},
-    {"wording": "발송", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "Dispatched from the sending branch. Seen in an archived reply of the tracker."},
-    {"wording": "발송터미널하차", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "Unloaded at the origin terminal. Seen in an archived reply of the tracker."},
-    {"wording": "발송터미널출발", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "Left the origin terminal. Seen in an archived reply of the tracker."},
-    {"wording": "도착터미널하차", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "Unloaded at the destination terminal. Seen in an archived reply of the tracker."},
-    {"wording": "영업소도착", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "Arrived at the delivering branch. Seen in an archived reply of the tracker."},
-    {"wording": "배송완료", "stage": "delivered", "language": "ko", "confirmedBy": "portal", "note": "Delivered; the reply repeats it as the delivery result. Seen in an archived reply of the tracker."}
+    {"wording": "접수", "language": "ko", "stage": "accepted", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "The sending branch took the parcel in."},
+    {"wording": "발송", "language": "ko", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Sent on from the sending branch."},
+    {"wording": "발송터미널하차", "language": "ko", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Unloaded at the origin terminal."},
+    {"wording": "발송터미널출발", "language": "ko", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Left the origin terminal."},
+    {"wording": "간선상차", "language": "ko", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-10-19", "note": "Loaded onto a trunk-line truck. Listed for this tracker by an open-source Korean parcel tracker."},
+    {"wording": "간선하차", "language": "ko", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-10-19", "note": "Unloaded from a trunk-line truck. Listed for this tracker by an open-source Korean parcel tracker."},
+    {"wording": "중계도착", "language": "ko", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-10-19", "note": "Arrived at a relay terminal. Listed for this tracker by an open-source Korean parcel tracker."},
+    {"wording": "중계발송", "language": "ko", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-10-19", "note": "Left a relay terminal. Listed for this tracker by an open-source Korean parcel tracker."},
+    {"wording": "도착터미널하차", "language": "ko", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Unloaded at the destination terminal."},
+    {"wording": "도착", "language": "ko", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-10-19", "note": "Arrived; the page's template has a block for it between the sending and terminal scans. Listed for this tracker by an open-source Korean parcel tracker."},
+    {"wording": "영업소도착", "language": "ko", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Arrived at the delivering branch."},
+    {"wording": "배송출발", "language": "ko", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-10-19", "note": "Left the delivering branch for the recipient. Listed for this tracker by an open-source Korean parcel tracker."},
+    {"wording": "배송완료", "language": "ko", "stage": "delivered", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Delivered; the page repeats it as the delivery result."}
   ]
 }

package/dist/carriers/geodis/adapter.js

@@ -268,6 +268,8 @@ export function parseGeodisTrackingResponse(payload, rawTrackingNumber) {
         ...(service ? { service_name: service } : {}),
         ...(weight !== null ? { weight_kg: weight } : {}),
         timezone: TIMEZONE,
+        // A delivered shipment's anonymous reply can carry the timeline step alone, without scans.
+        ...(events.length ? {} : { summary_only: true }),
         events,
     };
 }

package/dist/carriers/paack/adapter.js

@@ -39,6 +39,8 @@ const DEFAULT_TIMEOUT_MS = 15_000;
 const MAX_RESPONSE_BYTES = 2_000_000;
 const MAX_EVENTS = 100;
 const MAX_REDIRECTS = 1;
+/** Steps of a delivery run that a stale banner must not hide. */
+const ATTEMPT_STAGES = new Set(['failed_attempt', 'out_for_delivery', 'ready_for_pickup', 'delivered', 'returned']);
 const DEFAULT_ZONE = 'Europe/Paris';
 const PAACK_HOST = /(?:^|\.)paack\.(?:app|co)$/;
 const NOT_FOUND_PATTERN = /order not found|incorrect order number|commande introuvable|pedido no encontrado/i;
@@ -217,6 +219,32 @@ function pickupPoint(order) {
         : [];
     return [name, ...address].join('\n');
 }
+/**
+ * The steps that happened: the timeline's, then the history's. The history
+ * (`triggeredEventList`) repeats the timeline's steps under the same `uniq_id`
+ * and adds those the page keeps off the timeline (`timeline: false`), such as
+ * a failed attempt, the new attempt and the courier assigned to it.
+ */
+function happenedSteps(route) {
+    const steps = new Map();
+    for (const list of [route.eventList, route.triggeredEventList]) {
+        if (!Array.isArray(list))
+            continue;
+        for (const step of list.slice(0, 500)) {
+            if (!isRecord(step))
+                continue;
+            const time = normalizedTimestamp(step.timestamp ?? step.time);
+            if (!time)
+                continue;
+            const key = typeof step.uniq_id === 'string' && step.uniq_id
+                ? step.uniq_id
+                : `${String(step.id)}|${time.timestamp}`;
+            if (!steps.has(key) || (!steps.get(key).label && step.label))
+                steps.set(key, step);
+        }
+    }
+    return [...steps.values()];
+}
 /** Letters and digits only, so "SW1A 1AA" and "4445-027" compare by content. */
 function postcodeKey(value) {
     return value.toLocaleUpperCase('en-US').replace(/[^A-Z0-9]/g, '');
@@ -237,15 +265,10 @@ export function parsePaackTrackingResponse(payload, rawPostcode) {
     if (echoedPostcode && echoedPostcode !== postcodeKey(postcode)) {
         throw new SchemaError('Paack', 'Paack returned a different shipment');
     }
-    const rawEvents = Array.isArray(route.eventList) ? route.eventList : [];
     const parsedEvents = [];
-    rawEvents.slice(0, 500).forEach((rawEvent, sourceIndex) => {
-        if (!isRecord(rawEvent) || rawEvent.timeline === false)
-            return;
+    happenedSteps(route).forEach((rawEvent, sourceIndex) => {
         const classified = classifyPaackEvent(rawEvent);
         const time = normalizedTimestamp(rawEvent.timestamp ?? rawEvent.time);
-        if (!time)
-            return;
         parsedEvents.push({
             event: {
                 time: time.iso,
@@ -261,22 +284,30 @@ export function parsePaackTrackingResponse(payload, rawPostcode) {
     const events = parsedEvents.slice(0, MAX_EVENTS).map(({ event }) => event);
     const activeEvent = isRecord(route.activeEvent) ? route.activeEvent : null;
     const active = activeEvent ? classifyPaackEvent(activeEvent) : null;
-    const latest = parsedEvents.find((event) => event.status !== 'unknown');
-    const current = active && active.status !== 'unknown'
-        ? active
-        : latest && {
+    const activeTime = activeEvent
+        ? normalizedTimestamp(activeEvent.timestamp ?? activeEvent.time)
+        : null;
+    const banner = active && active.status !== 'unknown' ? active : null;
+    // The banner stays on "Out for delivery" after a failed attempt; a newer step
+    // of a delivery run replaces it. Scheduling notes and corrections do not.
+    const newer = banner && activeTime
+        ? parsedEvents.find((event) => event.status !== 'unknown' && event.timestamp > activeTime.timestamp
+            && ATTEMPT_STAGES.has(event.event.stage ?? ''))
+        : undefined;
+    const latest = newer ?? (banner ? undefined : parsedEvents.find((event) => event.status !== 'unknown'));
+    const current = latest
+        ? {
             status: latest.status,
             stage: latest.event.stage ?? 'in_transit',
             description: latest.event.description ?? 'Shipment update',
-        };
+        }
+        : banner;
     if (!current)
         throw new SchemaError('Paack', 'Paack returned incomplete tracking details');
-    const activeTime = activeEvent
-        ? normalizedTimestamp(activeEvent.timestamp ?? activeEvent.time)
-        : null;
     const zone = deliveryZone(address?.country, postcode);
     const newest = Math.max(activeTime?.timestamp ?? -Infinity, parsedEvents[0]?.timestamp ?? -Infinity);
-    const expected = isRecord(order.expected_delivery_ts) && !['delivered', 'exception'].includes(current.status)
+    // A failed attempt keeps the window: it is the new attempt's.
+    const expected = isRecord(order.expected_delivery_ts) && !['delivered', 'returned', 'exception'].includes(current.stage)
         ? expectedDelivery(order.expected_delivery_ts, zone, newest)
         : null;
     const pickup = current.stage === 'ready_for_pickup' ? pickupPoint(order) : '';
@@ -284,7 +315,7 @@ export function parsePaackTrackingResponse(payload, rawPostcode) {
         status: current.status,
         current_stage: current.stage,
         last_status_text: current.description,
-        last_update: activeTime?.iso ?? events[0]?.time ?? null,
+        last_update: newer?.event.time ?? activeTime?.iso ?? events[0]?.time ?? null,
         expected_delivery: expected,
         ...(pickup ? { pickup_point: pickup } : {}),
         timezone: zone,

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

@@ -14,6 +14,9 @@
  * before the generic words they contain: "rejectedByPudo" is a retried
  * delivery, not a rejection, and "collectedByCustomer" is the recipient
  * collecting the parcel, not a transit collection.
+ * The page's history also lists steps it keeps off the timeline. A failed
+ * delivery attempt can come there as `SA014` with no label, so that code is
+ * matched whole.
  * The provider's own wording is never returned; each mapped entry supplies the
  * English description we display.
  *

package/dist/carriers/paack/status.js

@@ -16,6 +16,10 @@ const OUT_FOR_DELIVERY = {
 };
 const DELIVERED = { status: 'delivered', stage: 'delivered', description: 'Delivered' };
 const DELIVERY_ISSUE = { status: 'exception', stage: 'failed_attempt', description: 'Delivery issue' };
+/** History codes that come without a label, matched whole. */
+const CODES = new Map([
+    ['sa014', { status: 'exception', stage: 'failed_attempt', description: 'Delivery attempt failed' }],
+]);
 /** Paack's English timeline labels, keyed like `statusKey`, with the identifier each one renders. */
 const RELAYED = new Map([
     ['orderdetailsreceived', REGISTERED], // manifested
@@ -30,6 +34,9 @@ export function paackScan(label) {
 }
 export function classifyPaackEvent(value) {
     const key = `${statusKey(value.label)} ${statusKey(value.id)}`;
+    const code = CODES.get(key.trim());
+    if (code)
+        return { ...code };
     if (includesAny(key, [
         'returnedsender',
         'returnedtosender',
@@ -78,13 +85,18 @@ export function classifyPaackEvent(value) {
     if (includesAny(key, ['droppedinpudo'])) {
         return { status: 'out_for_delivery', stage: 'ready_for_pickup', description: 'Ready for pickup' };
     }
-    if (includesAny(key, ['outfordelivery', 'indelivery', 'driverassigned', 'inprogress']))
+    // The new attempt after a failed one: the stage stays on the failure until the courier sets out again.
+    if (includesAny(key, ['additionaldeliveryattemptscheduled'])) {
+        return { status: 'exception', stage: 'failed_attempt', description: 'New delivery attempt scheduled' };
+    }
+    if (includesAny(key, ['driverassigned']))
+        return { ...OUT_FOR_DELIVERY, description: 'Courier assigned' };
+    if (includesAny(key, ['outfordelivery', 'indelivery']))
         return { ...OUT_FOR_DELIVERY };
     if (includesAny(key, [
         'manifested',
         'created',
         'notreceivedfromretailer',
-        'additionaldeliveryattemptscheduled',
         'orderreactivated',
         'appointmentbroughtforward',
         'appointmentrescheduled',
@@ -101,6 +113,7 @@ export function classifyPaackEvent(value) {
         'warehouse',
         'sorted',
         'pudoassigned',
+        'inprogress',
     ])) {
         return { status: 'in_transit', stage: 'in_transit', description: 'In transit' };
     }

package/dist/carriers/paack/statuses.json

@@ -105,6 +105,14 @@
       "firstSeen": "2026-09-12",
       "note": "Exercised by the delivered-order fixture's earlier attempt row. Reclassified to exception 2026-09-12."
     },
+    {
+      "code": "sa014",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-19",
+      "note": "History step (timeline: false) with no label, at a failed delivery attempt; the page has no text for it. Matched as the whole code."
+    },
     {
       "code": "absent",
       "language": "en",
@@ -285,17 +293,17 @@
       "code": "driverassigned",
       "language": "en",
       "stage": "out_for_delivery",
-      "confirmedBy": "fixture",
+      "confirmedBy": "live",
       "firstSeen": "2026-09-12",
-      "note": "Exercised by the delivered-order fixture's inProgress row."
+      "note": "History step (timeline: false), \"A courier was assigned to pick up your order\"; listed again for each new attempt. Read as \"Courier assigned\"."
     },
     {
       "code": "inprogress",
       "language": "en",
-      "stage": "out_for_delivery",
-      "confirmedBy": "fixture",
+      "stage": "in_transit",
+      "confirmedBy": "bundle",
       "firstSeen": "2026-09-12",
-      "note": "Exercised by the delivered-order fixture's inProgress row."
+      "note": "Page label inProgress, \"The order is being processed by Paack.\": not yet out for delivery."
     },
     {
       "code": "manifested",
@@ -324,10 +332,10 @@
     {
       "code": "additionaldeliveryattemptscheduled",
       "language": "en",
-      "stage": "registered",
-      "confirmedBy": "prior-art",
+      "stage": "failed_attempt",
+      "confirmedBy": "live",
       "firstSeen": "2026-09-12",
-      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+      "note": "History step (timeline: false) after a failed attempt, \"We scheduled a new delivery attempt.\" Kept on failed_attempt until the courier sets out again, so the stage does not fall back to registered."
     },
     {
       "code": "orderreactivated",

package/dist/core/catalog/statusMaps.js

@@ -79,6 +79,7 @@ import { statusMap as chitChats } from '../../carriers/chit-chats/status.js';
 import { statusMap as chronodiali } from '../../carriers/chronodiali/status.js';
 import { statusMap as chronopost } from '../../carriers/chronopost/status.js';
 import { statusMap as chunghwaPost } from '../../carriers/chunghwa-post/status.js';
+import { statusMap as chunil } from '../../carriers/chunil/status.js';
 import { statusMap as cityExpressRs } from '../../carriers/city-express-rs/status.js';
 import { statusMap as citymail } from '../../carriers/citymail/status.js';
 import { statusMap as cjLogistics } from '../../carriers/cj-logistics/status.js';
@@ -464,7 +465,7 @@ export const STATUS_MAPS = {
     bookurier, 'border-express': borderExpress, bosta, 'box-now': boxNow, 'bringer-parcel': bringerParcel, 'bulgarian-posts': bulgarianPosts, 'burd-delivery': burdDelivery, bussgods,
     byhd, c3x, cacesa, cargus, castores, 'cbl-logistica': cblLogistica, ccfs, cdek, cdl, celeritas,
     'central-transport': centralTransport, 'ceska-posta': ceskaPosta, 'ceva-logistics': cevaLogistics, chazki, chilexpress, 'china-post': chinaPost,
-    'chit-chats': chitChats, chronodiali, chronopost, 'chunghwa-post': chunghwaPost, 'city-express-rs': cityExpressRs, citymail,
+    'chit-chats': chitChats, chronodiali, chronopost, 'chunghwa-post': chunghwaPost, chunil, 'city-express-rs': cityExpressRs, citymail,
     'cj-logistics': cjLogistics, 'cj-packet': cjPacket, 'closer-logistics': closerLogistics, 'connect-couriers': connectCouriers, coordinadora,
     'copa-courier': copaCourier,
     'correo-argentino': correoArgentino, 'correo-uruguayo': correoUruguayo, 'correos-de-mexico': correosDeMexico, 'correos-express': correosExpress, 'correos-spain': correosSpain,

package/dist/data/catalog.json

@@ -8915,7 +8915,9 @@
         "timezone": "Asia/Seoul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "chunil",
+            "recognitionRank": 621,
+            "localClocks": true
         },
         "canaryUrl": "https://www.chunil.co.kr/HTrace/HTrace.jsp",
         "trackingUrlTemplate": "https://www.chunil.co.kr/HTrace/HTrace.jsp?transNo={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -5843,7 +5843,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Asia/Seoul";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "chunil";
+            readonly recognitionRank: 621;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.chunil.co.kr/HTrace/HTrace.jsp";
         readonly trackingUrlTemplate: "https://www.chunil.co.kr/HTrace/HTrace.jsp?transNo={trackingNumber}";

package/dist/generated/catalog.js

@@ -8916,7 +8916,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Asia/Seoul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "chunil",
+            "recognitionRank": 621,
+            "localClocks": true
         },
         "canaryUrl": "https://www.chunil.co.kr/HTrace/HTrace.jsp",
         "trackingUrlTemplate": "https://www.chunil.co.kr/HTrace/HTrace.jsp?transNo={trackingNumber}",

package/dist/generated/recognition.js

@@ -62,6 +62,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "chit-chats": 115,
     "chronodiali": 781,
     "chronopost": 890,
+    "chunil": 621,
     "ciblex": 640,
     "city-express-rs": 817,
     "citymail": 868,

package/dist/generated/registry.js

@@ -79,6 +79,7 @@ import { adapter as chitChats } from '../carriers/chit-chats/adapter.js';
 import { adapter as chronodiali } from '../carriers/chronodiali/adapter.js';
 import { adapter as chronopost } from '../carriers/chronopost/adapter.js';
 import { adapter as chunghwaPost } from '../carriers/chunghwa-post/adapter.js';
+import { adapter as chunil } from '../carriers/chunil/adapter.js';
 import { adapter as ciblex } from '../carriers/ciblex/adapter.js';
 import { adapter as cityExpressRs } from '../carriers/city-express-rs/adapter.js';
 import { adapter as citymail } from '../carriers/citymail/adapter.js';
@@ -611,6 +612,7 @@ export const REGISTRY = {
         "chronodiali": chronodiali,
         "chronopost": chronopost,
         "chunghwa-post": chunghwaPost,
+        "chunil": chunil,
         "ciblex": ciblex,
         "city-express-rs": cityExpressRs,
         "citymail": citymail,
@@ -1178,7 +1180,7 @@ export const REGISTRY = {
         "chronopost": "chronopost",
         "chukou1": "universal",
         "chunghwa-post": "chunghwa-post",
-        "chunil": "universal",
+        "chunil": "chunil",
         "ciblex": "ciblex",
         "city-express-rs": "city-express-rs",
         "citylink-express": "universal",

package/dist/providers/status.d.ts

@@ -1,13 +1,2 @@
-/**
- * The universal providers' status map. The parcel app files every scan a
- * universal provider relays under the carrier `unknown`, and no carrier map
- * stands behind those scans: the reading the providers give one is their map.
- * That is a 17TRACK sub-status where it outranks the wording
- * (`seventeentrack/status.ts`), else the wording rules every provider
- * applies (`classifyEvent`: their own vocabulary around the shared language
- * rules). A stage a provider declares and a UPU event code it maps are
- * `carrier_map`, so their scans never reach the app's review. Wording no rule
- * reads has no stage, and nothing is left out on purpose.
- */
-import type { CarrierStatusMap } from '../core/status/statusMap.js';
+import { type CarrierStatusMap } from '../core/status/statusMap.js';
 export declare const statusMap: CarrierStatusMap;

package/dist/providers/status.js

@@ -1,3 +1,17 @@
+/**
+ * The universal providers' status map. The parcel app files every scan a
+ * universal provider relays under the carrier `unknown`, and no carrier map
+ * stands behind those scans: the reading the providers give one is their map.
+ * That is a 17TRACK sub-status where it outranks the wording
+ * (`seventeentrack/status.ts`), else the wording rules every provider
+ * applies (`classifyEvent`: their own vocabulary around the shared language
+ * rules). A stage a provider declares and a UPU event code it maps are
+ * `carrier_map`, so their scans never reach the app's review. Wording no rule
+ * reads has no stage. Only Chronopost's notice to the recipient, which is no
+ * scan, is left out on purpose.
+ */
+import { CHRONOPOST_NOTIFICATION } from '../carriers/chronopost/status.js';
+import { normalizeStatusWording } from '../core/status/statusMap.js';
 import { subStatusStage } from './seventeentrack/status.js';
 import { classifyEvent } from './shared/result.js';
 export const statusMap = {
@@ -5,5 +19,8 @@ export const statusMap = {
         const read = classifyEvent(wording);
         return (code ? subStatusStage(code, read.stage) : undefined) ?? (read.stage_source === 'none' ? undefined : read.stage);
     },
-    gaps: [],
+    gaps: [{
+            wording: normalizeStatusWording(CHRONOPOST_NOTIFICATION),
+            note: "Chronopost's notice to the recipient, relayed as it is: not a scan, so it keeps the stage the parcel already had.",
+        }],
 };

package/dist/server/openapi.json

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

package/package.json

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