universal-parcel-scraper 0.89.0-main.975 → 0.90.0-main.979

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 **148 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,072 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}",

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -26851,6 +26851,18 @@
       "intelcom"
     ]
   },
+  {
+    "input": "CS011354097CZ",
+    "carrier": "intl-post",
+    "confidence": "high",
+    "candidates": [
+      "intl-post"
+    ],
+    "asked": [
+      "ceska-posta",
+      "chronopost"
+    ]
+  },
   {
     "input": "CT001362607SK",
     "carrier": "intl-post",
@@ -34167,6 +34179,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}",
@@ -7039,7 +7059,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": [],
@@ -11856,6 +11876,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 +11886,7 @@ var bc = {
 	"canada-post": 150,
 	canpar: 340,
 	cargus: 730,
+	"ceska-posta": 760,
 	chronopost: 450,
 	ciblex: 200,
 	"colis-prive": 300,
@@ -11884,6 +11906,7 @@ var bc = {
 	econt: 560,
 	elta: 550,
 	emile: 40,
+	"express-one": 780,
 	"fan-courier": 510,
 	"four-px": 130,
 	foxpost: 520,

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 } : {}),
+    };
+}

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

@@ -0,0 +1,12 @@
+import type { Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/**
+ * The tracker's English status wordings. The service sends no status code, so
+ * each scan is staged by its wording. A parcel goes to a One Box locker, a One
+ * Punkt pickup point or the recipient's door; the history does not say which.
+ */
+export declare const ALLEGRO_ONE_SCANS: Readonly<Record<string, Stage>>;
+/** The stage a scan's wording gives it, if any. */
+export declare function allegroOneStage(wording: string): Stage | undefined;
+/** The tracker's scans carry a wording and no status code. */
+export declare const statusMap: CarrierStatusMap;

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

@@ -0,0 +1,49 @@
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The tracker's English status wordings. The service sends no status code, so
+ * each scan is staged by its wording. A parcel goes to a One Box locker, a One
+ * Punkt pickup point or the recipient's door; the history does not say which.
+ */
+export const ALLEGRO_ONE_SCANS = {
+    // The sender made the label; Allegro One has not handled the parcel yet.
+    'Parcel has been prepared by the sender': 'registered',
+    // The sender dropped the parcel in a locker or at a point.
+    'Parcel has been dispatched': 'accepted',
+    'Parcel has been dispatched at point': 'accepted',
+    'Parcel has been picked up by the courier': 'accepted',
+    // A courier collected the sender's drop-off from the locker or the point.
+    'Parcel has been picked up from parcel locker by courier': 'accepted',
+    'Parcel has been picked up from point by courier': 'accepted',
+    'Courier has transferred the parcel to the warehouse': 'in_transit',
+    'Parcel has been dispatched to its destination point': 'in_transit',
+    'Parcel has been accepted at the sorting center': 'in_transit',
+    'Parcel has been accepted at the branch': 'in_transit',
+    'Parcel has been redirected to a different point': 'in_transit',
+    // Notices while the parcel is on its way; neither stops it.
+    'Parcel may be delivered with delay': 'in_transit',
+    'Parcel delivery time has been arranged with the recipient': 'in_transit',
+    'Parcel has been released for delivery': 'out_for_delivery',
+    // The courier found the locker full and keeps the parcel.
+    'No space in the parcel locker': 'failed_attempt',
+    // The recipient is asked to choose another point.
+    'Parcel is waiting for an alternative point indication': 'exception',
+    'Parcel is awaiting pick-up': 'ready_for_pickup',
+    'Parcel is awaiting pick-up — pick-up deadline is about to expire': 'ready_for_pickup',
+    'Time for pick-up has been extended': 'ready_for_pickup',
+    'Time for parcel pick-up has expired': 'exception',
+    // The parcel was not where a scan expected it; a later scan can find it again.
+    'No parcel': 'exception',
+    'Parcel has been lost': 'exception',
+    'Parcel has been returned to the sender': 'returned',
+    'Parcel has been delivered': 'delivered',
+};
+const SCANS = new Map(Object.entries(ALLEGRO_ONE_SCANS).map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+/** The stage a scan's wording gives it, if any. */
+export function allegroOneStage(wording) {
+    return SCANS.get(normalizeStatusWording(wording));
+}
+/** The tracker's scans carry a wording and no status code. */
+export const statusMap = {
+    stage: (code, wording) => code ? undefined : SCANS.get(wording),
+    gaps: [],
+};

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

@@ -1,4 +1,29 @@
 {
   "carrier": "allegro-one",
-  "entries": []
+  "entries": [
+    {"wording": "Parcel has been prepared by the sender", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "The sender made the label; Allegro One has not handled the parcel yet."},
+    {"wording": "Parcel has been dispatched", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "The sender dropped the parcel off."},
+    {"wording": "Parcel has been dispatched at point", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "The sender dropped the parcel off at a pickup point."},
+    {"wording": "Parcel has been picked up by the courier", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "The courier collected the parcel from the sender."},
+    {"wording": "Parcel has been picked up from parcel locker by courier", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "A courier collected the sender's drop-off from a locker."},
+    {"wording": "Parcel has been picked up from point by courier", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "A courier collected the sender's drop-off from a pickup point."},
+    {"wording": "Courier has transferred the parcel to the warehouse", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
+    {"wording": "Parcel has been dispatched to its destination point", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The parcel left for the locker, point or branch serving the recipient."},
+    {"wording": "Parcel has been accepted at the sorting center", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
+    {"wording": "Parcel has been accepted at the branch", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
+    {"wording": "Parcel has been redirected to a different point", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Follows the recipient's choice of another point."},
+    {"wording": "Parcel may be delivered with delay", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "A notice; the parcel keeps moving."},
+    {"wording": "Parcel delivery time has been arranged with the recipient", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "A notice; the parcel keeps moving."},
+    {"wording": "Parcel has been released for delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "live", "note": "Also before a locker delivery."},
+    {"wording": "No space in the parcel locker", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "note": "The courier found the locker full and took the parcel back."},
+    {"wording": "Parcel is waiting for an alternative point indication", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "The recipient is asked to choose another point."},
+    {"wording": "Parcel is awaiting pick-up", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "live"},
+    {"wording": "Parcel is awaiting pick-up — pick-up deadline is about to expire", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "live"},
+    {"wording": "Time for pick-up has been extended", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "live"},
+    {"wording": "Time for parcel pick-up has expired", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "A return to the sender follows."},
+    {"wording": "No parcel", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "The parcel was not where a scan expected it; later scans can find it again."},
+    {"wording": "Parcel has been lost", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "Later scans can find the parcel again."},
+    {"wording": "Parcel has been returned to the sender", "language": "en", "stage": "returned", "confirmedBy": "live"},
+    {"wording": "Parcel has been delivered", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "Also when the recipient collects the parcel from a locker or point."}
+  ]
 }