universal-parcel-scraper 0.75.0-main.929 → 0.76.0-main.932

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 **130 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **132 dedicated adapters** and **5 universal fallbacks**
 
 <sub>207 catalog entries · 66 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 3,675 such statuses, each filed under one stage.
+The carrier folders record 3,704 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

@@ -6249,7 +6249,9 @@
     "timezone": "Europe/Athens",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "geniki-taxydromiki",
+      "recognitionRank": 58,
+      "localClocks": true
     },
     "canaryUrl": "https://taxydromiki.com/track/",
     "trackingUrlTemplate": "https://taxydromiki.com/track/{trackingNumber}",
@@ -6325,10 +6327,12 @@
     "timezone": "Europe/Rome",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "gls-it",
+      "recognitionRank": 59,
+      "localClocks": true
     },
     "canaryUrl": "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/",
-    "trackingUrlTemplate": "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/?match={trackingNumber}",
+    "trackingUrlTemplate": "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/?match={trackingNumber}&type=NAT",
     "trackingSearchUrl": "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/",
     "linkRules": [
       {

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 207,
-  "activeAdapters": 130,
+  "activeAdapters": 132,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -24609,6 +24609,9 @@
     "confidence": "low",
     "candidates": [
       "gls-it"
+    ],
+    "asked": [
+      "gls-it"
     ]
   },
   {
@@ -24617,6 +24620,9 @@
     "confidence": "low",
     "candidates": [
       "gls-it"
+    ],
+    "asked": [
+      "gls-it"
     ]
   },
   {
@@ -25913,6 +25919,9 @@
     "confidence": "low",
     "candidates": [
       "gls-it"
+    ],
+    "asked": [
+      "gls-it"
     ]
   },
   {
@@ -31892,6 +31901,9 @@
     "confidence": "low",
     "candidates": [
       "gls-it"
+    ],
+    "asked": [
+      "gls-it"
     ]
   },
   {
@@ -35219,6 +35231,9 @@
     "confidence": "low",
     "candidates": [
       "gls-it"
+    ],
+    "asked": [
+      "gls-it"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -5014,7 +5014,9 @@ var ye = {
 		timezone: "Europe/Athens",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "geniki-taxydromiki",
+			recognitionRank: 58,
+			localClocks: !0
 		},
 		canaryUrl: "https://taxydromiki.com/track/",
 		trackingUrlTemplate: "https://taxydromiki.com/track/{trackingNumber}",
@@ -5067,10 +5069,12 @@ var ye = {
 		timezone: "Europe/Rome",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "gls-it",
+			recognitionRank: 59,
+			localClocks: !0
 		},
 		canaryUrl: "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/",
-		trackingUrlTemplate: "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/?match={trackingNumber}",
+		trackingUrlTemplate: "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/?match={trackingNumber}&type=NAT",
 		trackingSearchUrl: "https://gls-group.com/IT/it/servizi-online/ricerca-spedizioni/",
 		linkRules: [{
 			domains: ["gls-group.com", "gls-group.eu"],
@@ -11713,9 +11717,11 @@ var _c = {
 	"fan-courier": 51,
 	"four-px": 13,
 	foxpost: 52,
+	"geniki-taxydromiki": 58,
 	"gls-ch": 50,
 	"gls-de": 60,
 	"gls-fr": 61,
+	"gls-it": 59,
 	"gofo-fr": 3,
 	"gofo-it": 2,
 	"hermes-de": 40,

package/dist/carriers/geniki-taxydromiki/adapter.d.ts

@@ -0,0 +1,12 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+export declare class GenikiTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<import("../../index.js").CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/geniki-taxydromiki/adapter.js

@@ -0,0 +1,51 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
+import { normalizeGenikiNumber, parseGeniki, PROVIDER } from './parser.js';
+/** The tracking page's own lookup, which relays Geniki's voucher web service. */
+const ENDPOINT = 'https://taxydromiki.com/external_scripts/track-site.php';
+// Cloudflare's interstitial, served with a 200 or a 403.
+const CHALLENGE = /<title>\s*(?:Just a moment|Attention Required)|\bcf[-_]chl|challenge-platform/i;
+export class GenikiTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeGenikiNumber(raw);
+        return runSteps({ carrier: 'geniki-taxydromiki', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    signal.throwIfAborted();
+                    const { response, bytes } = await fetchBounded(ENDPOINT, { method: 'POST', signal,
+                        // The page sends a JSON body under a form content type; English words the checkpoints in English.
+                        headers: { Accept: 'application/json', 'Content-Type': 'application/x-www-form-urlencoded',
+                            'User-Agent': userAgentOf(this.options.userAgent) },
+                        body: JSON.stringify({ lang: 'en', voucherNo: number }),
+                    }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(remainingMs)), maxBytes: 1_000_000,
+                        allowHttpStatuses: [404, 410], fetcher: this.options.fetcher });
+                    // A missing lookup script says nothing about the parcel.
+                    if (response.status !== 200)
+                        throw new IndeterminateError(PROVIDER, 'Geniki Taxydromiki tracking is unavailable');
+                    const text = decodeText(bytes.subarray(0, 4_096));
+                    if (CHALLENGE.test(text))
+                        throw new ChallengeError(PROVIDER, 'Geniki Taxydromiki asked for a browser check');
+                    if (!text.trim())
+                        throw new IndeterminateError(PROVIDER, 'Geniki Taxydromiki returned an empty reply');
+                    let payload;
+                    try {
+                        payload = parseJsonBytes(bytes, PROVIDER);
+                    }
+                    catch (cause) {
+                        throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned invalid tracking JSON', { cause });
+                    }
+                    return parseGeniki(payload, number);
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new GenikiTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return { id: 'geniki-taxydromiki', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeGenikiNumber(number))) };
+};

package/dist/carriers/geniki-taxydromiki/carrier.json

@@ -18,18 +18,51 @@
   "timezone": "Europe/Athens",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "geniki-taxydromiki",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 58
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code"
+  ],
   "portal": {
     "url": "https://taxydromiki.com/track/{trackingNumber}",
     "searchUrl": "https://taxydromiki.com/track/",
     "canaryUrl": "https://taxydromiki.com/track/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "milestones",
+      "recipient_name"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code"
+    ],
+    "discarded": [
+      "milestones",
+      "recipient_name",
+      "coordinates",
+      "delivery_detail",
+      "return_number"
+    ],
+    "unavailable": [
+      "eta",
+      "pickup_point",
+      "sender_name",
+      "weight",
+      "offset_timestamps"
+    ]
   },
   "links": [
     {

package/dist/carriers/geniki-taxydromiki/numbers.json

@@ -40,7 +40,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -55,7 +55,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "5191585066",
@@ -68,7 +68,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -83,7 +83,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "5191263103",
@@ -96,7 +96,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -111,7 +111,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "5182618604",
@@ -124,7 +124,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -139,7 +139,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "5191585011",
@@ -152,7 +152,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -167,7 +167,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "5191590950",
@@ -180,7 +180,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -195,7 +195,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "5182251804",
@@ -208,7 +208,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -223,7 +223,7 @@
           "dhl-ecommerce-es"
         ]
       },
-      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's Geniki Taxydromiki page offered it as a sample to try on 11 Oct 2026; Geniki Taxydromiki's tracking returns its history."
     },
     {
       "number": "2974623013",

package/dist/carriers/geniki-taxydromiki/parser.d.ts

@@ -0,0 +1,11 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Geniki Taxydromiki";
+/** A ten-digit voucher, the only shape Geniki Taxydromiki's tracker, clients and shipments show. */
+export declare function normalizeGenikiNumber(raw: string): string;
+/**
+ * The tracker's reply for one voucher: its checkpoints, oldest first, each with
+ * its code, wording, service point and wall clock. The name of whoever received
+ * the parcel, the scanning device's coordinates, the return voucher and the
+ * delivery summary are never read.
+ */
+export declare function parseGeniki(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/geniki-taxydromiki/parser.js

@@ -0,0 +1,127 @@
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { genikiStage } from './status.js';
+export const PROVIDER = 'Geniki Taxydromiki';
+const MAX_EVENTS = 500;
+// The voucher web service's result codes, which the tracker passes on.
+const FOUND = 0;
+const ABSENT = 9;
+// Where a scan names the sender or the recipient instead of a service point.
+const ROLES = new Set(['SHIPPER', 'RECIPIENT', 'ΑΠΟΣΤΟΛΕΑΣ', 'ΠΑΡΑΛΗΠΤΗΣ']);
+// The tracking page hides a scan and the scan that cancels it, the last such pair of each kind.
+const CANCELLED = [['C_L1', 'C_L2'], ['C_E1', 'C_E2'], ['C_K8', 'C_K9']];
+/** A ten-digit voucher, the only shape Geniki Taxydromiki's tracker, clients and shipments show. */
+export function normalizeGenikiNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!/^\d{10}$/.test(number))
+        throw new InvalidInputError(PROVIDER, 'Geniki Taxydromiki requires a ten-digit voucher number');
+    return number;
+}
+/** A scan's wall clock. The reply gives no offset, so the clock stays local; fractions of a second are dropped. */
+function clock(raw) {
+    if (raw != null && typeof raw !== 'string')
+        throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned an invalid scan clock');
+    const text = clean(raw, 40);
+    const wall = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})(?:\.\d{1,7})?$/.exec(text)?.[1];
+    const parsed = wall ? DateTime.fromISO(wall, { zone: 'UTC' }) : null;
+    // The web service's empty date is a year-1 or 1900 placeholder.
+    if (parsed?.isValid && parsed.year < 2000)
+        return {};
+    return parsed?.isValid ? { local_time: wall } : text ? { provider_time_text: text } : {};
+}
+function cancelledRows(codes) {
+    const hidden = new Set();
+    for (const [scan, cancellation] of CANCELLED) {
+        let pair;
+        codes.forEach((code, index) => {
+            const later = code === scan ? codes.indexOf(cancellation, index + 1) : -1;
+            if (later !== -1)
+                pair = [index, later];
+        });
+        if (pair)
+            pair.forEach(index => hidden.add(index));
+    }
+    return hidden;
+}
+/**
+ * The tracker's reply for one voucher: its checkpoints, oldest first, each with
+ * its code, wording, service point and wall clock. The name of whoever received
+ * the parcel, the scanning device's coordinates, the return voucher and the
+ * delivery summary are never read.
+ */
+export function parseGeniki(payload, raw) {
+    const number = normalizeGenikiNumber(raw);
+    if (!isRecord(payload))
+        throw new SchemaError(PROVIDER);
+    // The tracker's own refusal, such as a missing number, or its expired service key.
+    if (payload.success === false || payload.invalid_token !== undefined) {
+        throw new IndeterminateError(PROVIDER, 'Geniki Taxydromiki tracking did not answer');
+    }
+    if (payload.success !== true)
+        throw new SchemaError(PROVIDER);
+    const keys = Object.keys(payload).filter(key => key !== 'success');
+    if (keys.length !== 1 || keys[0] !== number)
+        throw new SchemaError(PROVIDER, 'Geniki Taxydromiki answered for a different voucher');
+    const entry = payload[number];
+    const reply = isRecord(entry) ? entry.TrackAndTraceResult : undefined;
+    if (!isRecord(reply) || typeof reply.Result !== 'number' || !Number.isInteger(reply.Result)) {
+        throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned no tracking result');
+    }
+    if (reply.Result === ABSENT)
+        throw new NotFoundError(PROVIDER);
+    // 10 withholds a voucher from the tracker's account and 11 is its expired
+    // session: neither says anything about the parcel.
+    if (reply.Result !== FOUND)
+        throw new IndeterminateError(PROVIDER, `Geniki Taxydromiki answered with result ${reply.Result}`);
+    if (!isRecord(reply.Checkpoints))
+        throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned invalid checkpoints');
+    const listed = reply.Checkpoints.Checkpoint;
+    // The web service collapses a single checkpoint into an object.
+    const rows = listed === undefined ? [] : Array.isArray(listed) ? listed : [listed];
+    if (rows.length > MAX_EVENTS)
+        throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned invalid checkpoints');
+    // The page shows its not-found notice for a voucher without checkpoints, but the
+    // service found the voucher: that proves neither a parcel on its way nor absence.
+    if (!rows.length)
+        throw new IndeterminateError(PROVIDER, 'Geniki Taxydromiki returned no checkpoints for the voucher');
+    const scans = rows.map(row => {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned an invalid checkpoint');
+        const code = typeof row.StatusCode === 'string' ? row.StatusCode.trim() : '';
+        const description = clean(row.Status, 300);
+        if (!/^C_[A-Z0-9_]{1,16}$/.test(code) || !description) {
+            throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned a checkpoint without its code or wording');
+        }
+        if (row.Shop != null && typeof row.Shop !== 'string')
+            throw new SchemaError(PROVIDER, 'Geniki Taxydromiki returned an invalid service point');
+        const shop = clean(row.Shop, 100);
+        return { code, description, location: ROLES.has(shop.toUpperCase()) ? '' : shop, time: clock(row.StatusDate) };
+    });
+    const hidden = cancelledRows(scans.map(scan => scan.code));
+    const events = [];
+    const seen = new Set();
+    // Newest first; equal clocks keep the reply's order.
+    for (const [index, scan] of [...scans.entries()].reverse()) {
+        if (hidden.has(index))
+            continue;
+        const stage = genikiStage(scan.code);
+        const event = { description: scan.description, provider_code: scan.code, ...scan.time,
+            ...(scan.location ? { location: scan.location } : {}), ...(stage ? { stage } : {}) };
+        const key = JSON.stringify(event);
+        if (!seen.has(key)) {
+            seen.add(key);
+            events.push(event);
+        }
+    }
+    if (!events.length)
+        throw new IndeterminateError(PROVIDER, 'Geniki Taxydromiki returned only cancelled checkpoints');
+    const latest = events[0];
+    const stage = genikiStage(latest.provider_code);
+    return { status: stage ? languageStageStatus(stage) : 'unknown', ...(stage ? { current_stage: stage } : {}),
+        last_status_text: latest.description ?? null, last_update: null, last_update_local: latest.local_time ?? null,
+        expected_delivery: null, events };
+}

package/dist/carriers/geniki-taxydromiki/status.d.ts

@@ -0,0 +1,11 @@
+import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage of one checkpoint code, if the map gives it one. */
+export declare function genikiStage(code: string): Stage | undefined;
+/**
+ * What the map says about one scan. Every scan carries its code, so wording
+ * alone gets nothing. The page's error codes (C_EA_*), cancellations (C_E2,
+ * C_L2, C_K9, C_P4, C_S5, C_S8) and the other codes it counts as in progress
+ * have no wording any source settles, so they stay unknown, open for review.
+ */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/geniki-taxydromiki/status.js

@@ -0,0 +1,44 @@
+/**
+ * Geniki Taxydromiki's checkpoint codes, the same in Greek and English. The
+ * wordings come from the tracker's replies. C_SC and C_S2 come only from the
+ * tracking page's own code, which files C_SC with C_NW as a voucher the
+ * customer created and C_S2 with the deliveries. The shared wording rules
+ * leave several of them unstaged, such as a collected parcel.
+ */
+const CODES = new Map([
+    // The customer created the voucher and printed its label.
+    ['C_NW', 'registered'],
+    ['C_SC', 'registered'],
+    // A courier collected the parcel from its sender.
+    ['C_W3', 'accepted'],
+    // A service point registered the shipment it was handed: the page shows its
+    // date as the collection by Geniki and hides the customer's voucher step.
+    ['C_KK', 'accepted'],
+    // Departures from a service point, arrivals and departures at hubs, arrivals
+    // at a service point and a routing on to another one.
+    ['C_K8', 'in_transit'],
+    ['C_H1', 'in_transit'],
+    ['C_H2', 'in_transit'],
+    ['C_A1', 'in_transit'],
+    ['C_L1', 'in_transit'],
+    // Handed to a courier for delivery ("Χρέωση σε κούριερ").
+    ['C_A3', 'out_for_delivery'],
+    ['C_W2', 'delivered'],
+    // The delivery recorded at the service point, with the parcel marked delivered.
+    ['C_P1', 'delivered'],
+    ['C_S2', 'delivered'],
+]);
+/** The stage of one checkpoint code, if the map gives it one. */
+export function genikiStage(code) {
+    return CODES.get(code);
+}
+/**
+ * What the map says about one scan. Every scan carries its code, so wording
+ * alone gets nothing. The page's error codes (C_EA_*), cancellations (C_E2,
+ * C_L2, C_K9, C_P4, C_S5, C_S8) and the other codes it counts as in progress
+ * have no wording any source settles, so they stay unknown, open for review.
+ */
+export const statusMap = {
+    stage: code => (code ? genikiStage(code) : undefined),
+    gaps: [],
+};