universal-parcel-scraper 0.89.0-main.975 → 0.91.0-main.981

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 **145 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **149 dedicated adapters** and **5 universal fallbacks**
 
 <sub>208 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 4,002 such statuses, each filed under one stage.
+The carrier folders record 4,083 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

@@ -4805,10 +4805,32 @@
     "timezone": "Europe/Warsaw",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "allegro-one",
+      "recognitionRank": 770
     },
-    "canaryUrl": "https://allegro.pl/",
-    "linkRules": [],
+    "canaryUrl": "https://allegro.pl/allegrodelivery/sledzenie-paczki",
+    "trackingUrlTemplate": "https://allegro.pl/allegrodelivery/sledzenie-paczki?numer={trackingNumber}",
+    "trackingSearchUrl": "https://allegro.pl/allegrodelivery/sledzenie-paczki",
+    "linkRules": [
+      {
+        "domains": [
+          "allegro.pl"
+        ],
+        "pathPattern": "^/allegrodelivery/sledzenie-paczki/?$",
+        "params": [
+          "numer"
+        ]
+      },
+      {
+        "domains": [
+          "allegro.pl"
+        ],
+        "pathPattern": "^/kampania/one/kurier/sledzenie-paczki/?$",
+        "params": [
+          "numer"
+        ]
+      }
+    ],
     "detectionRules": [
       {
         "pattern": "^A[0D][0-9A-Z]{8}$",
@@ -5069,7 +5091,9 @@
     "timezone": "Europe/Prague",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "ceska-posta",
+      "recognitionRank": 760,
+      "localClocks": true
     },
     "canaryUrl": "https://www.postaonline.cz/trackandtrace",
     "trackingUrlTemplate": "https://www.postaonline.cz/trackandtrace/-/zasilka/{trackingNumber}",
@@ -5086,6 +5110,12 @@
       {
         "pattern": "^[BD][A-Z]\\d{10}[A-Z]$",
         "confidence": "high"
+      },
+      {
+        "pattern": "^[A-Z]{2}\\d{9}CZ$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
       }
     ]
   },
@@ -6155,7 +6185,9 @@
     "timezone": "Europe/Budapest",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "express-one",
+      "recognitionRank": 780,
+      "localClocks": true
     },
     "canaryUrl": "https://tracking.expressone.hu/",
     "trackingUrlTemplate": "https://tracking.expressone.hu/?plc_number={trackingNumber}",
@@ -7558,7 +7590,8 @@
     "timezone": "Europe/Ljubljana",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "posta-slovenije",
+      "recognitionRank": 790
     },
     "canaryUrl": "https://moja.posta.si/tracking",
     "trackingUrlTemplate": "https://moja.posta.si/tracking?trackingNumber={trackingNumber}",
@@ -7574,7 +7607,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}SI$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "posta-srbije": {
     "displayName": "Pošta Srbije",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 208,
-  "activeAdapters": 145,
+  "activeAdapters": 149,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -25888,6 +25888,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -25899,6 +25900,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -25910,6 +25912,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -26031,6 +26034,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -26851,6 +26855,18 @@
       "intelcom"
     ]
   },
+  {
+    "input": "CS011354097CZ",
+    "carrier": "intl-post",
+    "confidence": "high",
+    "candidates": [
+      "intl-post"
+    ],
+    "asked": [
+      "ceska-posta",
+      "chronopost"
+    ]
+  },
   {
     "input": "CT001362607SK",
     "carrier": "intl-post",
@@ -27068,6 +27084,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -30477,6 +30494,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -30668,6 +30686,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -34133,6 +34152,7 @@
       "intl-post"
     ],
     "asked": [
+      "posta-slovenije",
       "chronopost"
     ]
   },
@@ -34167,6 +34187,18 @@
       "correos-chile"
     ]
   },
+  {
+    "input": "RR562174447CZ",
+    "carrier": "intl-post",
+    "confidence": "high",
+    "candidates": [
+      "intl-post"
+    ],
+    "asked": [
+      "ceska-posta",
+      "chronopost"
+    ]
+  },
   {
     "input": "RR568370453CL",
     "carrier": "correos-chile",

package/dist/browser/scraper.js

@@ -3947,10 +3947,21 @@ var be = {
 		timezone: "Europe/Warsaw",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "allegro-one",
+			recognitionRank: 770
 		},
-		canaryUrl: "https://allegro.pl/",
-		linkRules: [],
+		canaryUrl: "https://allegro.pl/allegrodelivery/sledzenie-paczki",
+		trackingUrlTemplate: "https://allegro.pl/allegrodelivery/sledzenie-paczki?numer={trackingNumber}",
+		trackingSearchUrl: "https://allegro.pl/allegrodelivery/sledzenie-paczki",
+		linkRules: [{
+			domains: ["allegro.pl"],
+			pathPattern: "^/allegrodelivery/sledzenie-paczki/?$",
+			params: ["numer"]
+		}, {
+			domains: ["allegro.pl"],
+			pathPattern: "^/kampania/one/kurier/sledzenie-paczki/?$",
+			params: ["numer"]
+		}],
 		detectionRules: [{
 			pattern: "^A[0D][0-9A-Z]{8}$",
 			confidence: "high"
@@ -4145,7 +4156,9 @@ var be = {
 		timezone: "Europe/Prague",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "ceska-posta",
+			recognitionRank: 760,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.postaonline.cz/trackandtrace",
 		trackingUrlTemplate: "https://www.postaonline.cz/trackandtrace/-/zasilka/{trackingNumber}",
@@ -4157,6 +4170,11 @@ var be = {
 		detectionRules: [{
 			pattern: "^[BD][A-Z]\\d{10}[A-Z]$",
 			confidence: "high"
+		}, {
+			pattern: "^[A-Z]{2}\\d{9}CZ$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
 		}]
 	},
 	"chit-chats": {
@@ -4950,7 +4968,9 @@ var be = {
 		timezone: "Europe/Budapest",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "express-one",
+			recognitionRank: 780,
+			localClocks: !0
 		},
 		canaryUrl: "https://tracking.expressone.hu/",
 		trackingUrlTemplate: "https://tracking.expressone.hu/?plc_number={trackingNumber}",
@@ -6005,7 +6025,8 @@ var be = {
 		timezone: "Europe/Ljubljana",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "posta-slovenije",
+			recognitionRank: 790
 		},
 		canaryUrl: "https://moja.posta.si/tracking",
 		trackingUrlTemplate: "https://moja.posta.si/tracking?trackingNumber={trackingNumber}",
@@ -6015,7 +6036,12 @@ var be = {
 			pathPattern: "^/tracking/?$",
 			params: ["trackingNumber"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}SI$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	"posta-srbije": {
 		displayName: "Pošta Srbije",
@@ -7039,7 +7065,7 @@ var be = {
 	cargus: [],
 	cdek: [],
 	cdl: ["cdl-1", "cdl-2"],
-	"ceska-posta": ["ceska-posta-1"],
+	"ceska-posta": ["ceska-posta-1", "ceska-posta-s10"],
 	"chit-chats": ["chit-chats-1"],
 	cne: ["cne-1"],
 	"correos-de-mexico": [],
@@ -7133,7 +7159,7 @@ var be = {
 	paquetexpress: [],
 	passport: ["passport-1"],
 	"post-luxembourg": [],
-	"posta-slovenije": [],
+	"posta-slovenije": ["posta-slovenije-s10"],
 	"posta-srbije": [],
 	ppl: [],
 	ptt: ["ptt-1", "ptt-s10"],
@@ -11856,6 +11882,7 @@ function yc(e) {
 var bc = {
 	"acs-courier": 570,
 	aliexpress: 140,
+	"allegro-one": 770,
 	"aras-kargo": 670,
 	"australia-post": 60,
 	"austrian-post": 390,
@@ -11865,6 +11892,7 @@ var bc = {
 	"canada-post": 150,
 	canpar: 340,
 	cargus: 730,
+	"ceska-posta": 760,
 	chronopost: 450,
 	ciblex: 200,
 	"colis-prive": 300,
@@ -11884,6 +11912,7 @@ var bc = {
 	econt: 560,
 	elta: 550,
 	emile: 40,
+	"express-one": 780,
 	"fan-courier": 510,
 	"four-px": 130,
 	foxpost: 520,
@@ -11910,6 +11939,7 @@ var bc = {
 	ontrac: 210,
 	"orlen-paczka": 490,
 	"poczta-polska": 310,
+	"posta-slovenije": 790,
 	"poste-italiane": 460,
 	posti: 270,
 	postlogistics: 260,

package/dist/carriers/allegro-one/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';
+export declare const ALLEGRO_ONE_ENDPOINT = "https://edge.allegro.pl/one/tracking";
+export declare function allegroOneTrackingUrl(raw: string): string;
+export declare class AllegroOneTracker {
+    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/allegro-one/adapter.js

@@ -0,0 +1,63 @@
+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 { 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 { ALLEGRO_ONE_MAX_BYTES, normalizeAllegroOneNumber, parseAllegroOne, PROVIDER } from './parser.js';
+// The service Allegro's tracking page asks through its edge gateway.
+export const ALLEGRO_ONE_ENDPOINT = 'https://edge.allegro.pl/one/tracking';
+// The gateway answers only the media type Allegro's own pages ask for.
+const MEDIA_TYPE = 'application/vnd.allegro.internal.v1+json';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// DataDome's interstitial, which guards Allegro's pages and could come instead of the reply.
+const CHALLENGE = /captcha-delivery\.com|datadome/i;
+export function allegroOneTrackingUrl(raw) {
+    return `${ALLEGRO_ONE_ENDPOINT}?packageNo=${encodeURIComponent(normalizeAllegroOneNumber(raw))}`;
+}
+export class AllegroOneTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const url = allegroOneTrackingUrl(raw);
+        const read = async (signal, timeoutMs) => {
+            // The scans are worded in the language asked for: Polish for `pl-PL` or
+            // `*`, English for `en-US`. The status map reads English.
+            const { response, bytes } = await fetchBounded(url, { signal, headers: {
+                    Accept: MEDIA_TYPE, 'Accept-Language': 'en-US', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: ALLEGRO_ONE_MAX_BYTES, redirect: 'manual',
+                allowHttpStatuses: [...REDIRECTS, 400, 404, 406, 410], fetcher: this.options.fetcher });
+            // A refused request, a retired route ("Feature unavailable") or a move says nothing about the parcel.
+            if (response.status !== 200)
+                throw new IndeterminateError(PROVIDER, 'Allegro One tracking service is unavailable');
+            const text = decodeText(bytes);
+            let reply;
+            try {
+                reply = JSON.parse(text);
+            }
+            catch (error) {
+                if (CHALLENGE.test(text))
+                    throw new ChallengeError(PROVIDER, 'Allegro One answered with a bot check', { cause: error });
+                throw new SchemaError(PROVIDER, 'Allegro One returned a reply that is not JSON', { cause: error });
+            }
+            return parseAllegroOne(reply, raw);
+        };
+        // A request that fails to reach Allegro, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'allegro-one', 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 AllegroOneTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'allegro-one', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeAllegroOneNumber(number))),
+    };
+};

package/dist/carriers/allegro-one/carrier.json

@@ -19,18 +19,66 @@
   "timezone": "Europe/Warsaw",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "allegro-one",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 770
+    }
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "delivered_at"
+  ],
   "portal": {
-    "canaryUrl": "https://allegro.pl/",
-    "shows": [],
-    "scraped": [],
+    "url": "https://allegro.pl/allegrodelivery/sledzenie-paczki?numer={trackingNumber}",
+    "searchUrl": "https://allegro.pl/allegrodelivery/sledzenie-paczki",
+    "canaryUrl": "https://allegro.pl/allegrodelivery/sledzenie-paczki",
+    "shows": [
+      "status",
+      "history",
+      "delivered_at"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "delivered_at",
+      "offset_timestamps"
+    ],
     "discarded": [],
-    "unavailable": []
+    "unavailable": [
+      "location",
+      "eta",
+      "pickup_point",
+      "weight",
+      "service_name",
+      "sender_name",
+      "recipient_name",
+      "delivery_partner"
+    ]
   },
-  "links": [],
+  "links": [
+    {
+      "domains": [
+        "allegro.pl"
+      ],
+      "pathPattern": "^/allegrodelivery/sledzenie-paczki/?$",
+      "params": [
+        "numer"
+      ]
+    },
+    {
+      "domains": [
+        "allegro.pl"
+      ],
+      "pathPattern": "^/kampania/one/kurier/sledzenie-paczki/?$",
+      "params": [
+        "numer"
+      ]
+    }
+  ],
   "detection": [
     {
       "id": "allegro-one-1",

package/dist/carriers/allegro-one/numbers.json

@@ -12,7 +12,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",
@@ -31,7 +31,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",
@@ -50,7 +50,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",
@@ -69,7 +69,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",
@@ -88,7 +88,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",
@@ -107,7 +107,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",
@@ -126,7 +126,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "allegro-one",

package/dist/carriers/allegro-one/parser.d.ts

@@ -0,0 +1,15 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Allegro One";
+export declare const ALLEGRO_ONE_MAX_BYTES: number;
+/** An Allegro One number; anything else is a number Allegro One does not issue. */
+export declare function normalizeAllegroOneNumber(raw: string): string;
+/**
+ * The reply of `GET /one/tracking?packageNo={number}` on Allegro's edge
+ * gateway: `{ "status": [...] }`, each scan a UTC instant and a wording. It
+ * does not echo the number: the scans are those of the number in the request.
+ * An empty or null list is what the tracker shows as "not found". Every A0
+ * number seen has scans from its label on, so an empty list is not found for
+ * them; every real AD number seen had an empty list, so for AD and the older
+ * ALE form it stays inconclusive.
+ */
+export declare function parseAllegroOne(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/allegro-one/parser.js

@@ -0,0 +1,91 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { classifyWording, languageStageStatus } from '../../core/status/index.js';
+import { explicitOffsetTime } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { allegroOneStage } from './status.js';
+export const PROVIDER = 'Allegro One';
+// A parcel's reply is a list of short scans; a few kilobytes.
+export const ALLEGRO_ONE_MAX_BYTES = 256 * 1024;
+// Allegro One's ten-character numbers start A0, Allegro Delivery's start AD,
+// and the older form the tracker still answers is ALE and twelve digits.
+const NUMBER = /^(?:A[0D][0-9A-Z]{8}|ALE\d{12})$/;
+const MAX_ROWS = 300;
+const MAX_EVENTS = 100;
+/** An Allegro One number; anything else is a number Allegro One does not issue. */
+export function normalizeAllegroOneNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number)) {
+        throw new InvalidInputError(PROVIDER, 'Allegro One numbers are A0 or AD and eight letters and digits, or ALE and twelve digits');
+    }
+    return number;
+}
+function projectScan(row, index) {
+    if (!isRecord(row) || typeof row.eventTimestamp !== 'string' || typeof row.description !== 'string') {
+        throw new SchemaError(PROVIDER, 'Allegro One returned an invalid scan');
+    }
+    const time = explicitOffsetTime(row.eventTimestamp);
+    if (!time)
+        throw new SchemaError(PROVIDER, 'Allegro One returned a scan without an offset time');
+    const description = clean(row.description, 300);
+    if (!description)
+        throw new SchemaError(PROVIDER, 'Allegro One returned a scan without wording');
+    const stage = allegroOneStage(description);
+    return {
+        event: { time: time.iso, description, ...(stage ? { stage, stage_source: 'carrier_map' } : {}) },
+        at: time.timestamp,
+        index,
+    };
+}
+/**
+ * The reply of `GET /one/tracking?packageNo={number}` on Allegro's edge
+ * gateway: `{ "status": [...] }`, each scan a UTC instant and a wording. It
+ * does not echo the number: the scans are those of the number in the request.
+ * An empty or null list is what the tracker shows as "not found". Every A0
+ * number seen has scans from its label on, so an empty list is not found for
+ * them; every real AD number seen had an empty list, so for AD and the older
+ * ALE form it stays inconclusive.
+ */
+export function parseAllegroOne(payload, raw) {
+    const number = normalizeAllegroOneNumber(raw);
+    if (!isRecord(payload) || !('status' in payload) || (payload.status !== null && !Array.isArray(payload.status))) {
+        throw new SchemaError(PROVIDER, 'Allegro One returned an unexpected reply');
+    }
+    const rows = (payload.status ?? []);
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Allegro One returned an oversized history');
+    if (!rows.length) {
+        if (number.startsWith('A0'))
+            throw new NotFoundError(PROVIDER);
+        throw new NoHistoryError(PROVIDER, 'Allegro One has no scans for this number');
+    }
+    const seen = new Set();
+    const scans = [];
+    rows.forEach((row, index) => {
+        const scan = projectScan(row, index);
+        const key = `${scan.event.time}\n${scan.event.description}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        scans.push(scan);
+    });
+    // The reply lists scans newest first and the tracker sorts them so too.
+    // Instants order them; equal ones keep the reply's order.
+    scans.sort((left, right) => right.at - left.at || left.index - right.index);
+    const newest = scans[0].event;
+    const current = newest.stage
+        ? { stage: newest.stage, source: 'carrier_map' }
+        : classifyWording(newest.description, 'in_transit');
+    const stage = current.source !== 'none' ? current.stage : undefined;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time,
+        expected_delivery: null,
+        ...(stage === 'delivered' ? { delivered_at: newest.time } : {}),
+        events: scans.slice(0, MAX_EVENTS).map((scan) => scan.event),
+        ...(scans.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}