universal-parcel-scraper 0.94.0-main.990 → 0.95.0-main.992

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 **153 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **154 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,279 such statuses, each filed under one stage.
+The carrier folders record 4,298 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

@@ -5249,7 +5249,9 @@
     "timezone": "Europe/Copenhagen",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "dao",
+      "recognitionRank": 850,
+      "localClocks": true
     },
     "canaryUrl": "https://dao.as/find-din-pakke/",
     "trackingUrlTemplate": "https://dao.as/find-din-pakke/#q={trackingNumber}",
@@ -5276,7 +5278,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^000(?:5712696|5715127)\\d{10}$",
+        "confidence": "low",
+        "checksum": "sscc",
+        "preferred": true
+      }
+    ]
   },
   "day-ross": {
     "displayName": "Day & Ross",

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -162,14 +162,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -181,14 +184,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -200,14 +206,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -219,14 +228,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -238,14 +250,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -257,14 +272,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -276,14 +294,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -295,14 +316,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -314,14 +338,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"
@@ -333,14 +360,17 @@
     "confidence": "low",
     "candidates": [
       "postnord",
+      "dao",
       "swiss-post-cargo",
       "usps",
       "nz-post"
     ],
     "preferred": [
-      "postnord"
+      "postnord",
+      "dao"
     ],
     "asked": [
+      "dao",
       "postnord",
       "swiss-post-cargo",
       "nz-post"

package/dist/browser/scraper.js

@@ -4274,7 +4274,9 @@ var be = {
 		timezone: "Europe/Copenhagen",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "dao",
+			recognitionRank: 850,
+			localClocks: !0
 		},
 		canaryUrl: "https://dao.as/find-din-pakke/",
 		trackingUrlTemplate: "https://dao.as/find-din-pakke/#q={trackingNumber}",
@@ -4289,7 +4291,12 @@ var be = {
 			pathPattern: "^/(?:en/private/track-your-parcel/?|dao-app/?)?$",
 			params: ["stregkode"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^000(?:5712696|5715127)\\d{10}$",
+			confidence: "low",
+			checksum: "sscc",
+			preferred: !0
+		}]
 	},
 	"day-ross": {
 		displayName: "Day & Ross",
@@ -7093,7 +7100,7 @@ var be = {
 	cne: ["cne-1"],
 	"correos-de-mexico": [],
 	"cyprus-post": [],
-	dao: [],
+	dao: ["dao-1"],
 	"day-ross": ["day-ross-1"],
 	"dhl-ecommerce-es": ["dhl-ecommerce-es-1", "dhl-ecommerce-es-2"],
 	"dhl-ecommerce-nl": [
@@ -11921,6 +11928,7 @@ var bc = {
 	"colis-prive": 300,
 	"correos-express": 360,
 	"ctt-express": 350,
+	dao: 850,
 	delhivery: 160,
 	"dhl-ecommerce": 230,
 	"dhl-ecommerce-es": 190,

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

@@ -0,0 +1,16 @@
+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 DAO_ENDPOINT = "https://dao.as/wp-json/dao-wp/v1/track-parcel";
+/** The service's address for one number, with English wording. */
+export declare function daoTrackingUrl(raw: string): string;
+export declare class DaoTracker {
+    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/dao/adapter.js

@@ -0,0 +1,70 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, SchemaError, TransportError, UpstreamHttpError } 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, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
+import { DAO_MAX_BYTES, normalizeDaoNumber, parseDao, PROVIDER } from './parser.js';
+// The service dao.as/find-din-pakke asks, without a key, nonce or cookie.
+export const DAO_ENDPOINT = 'https://dao.as/wp-json/dao-wp/v1/track-parcel';
+// A WordPress or edge block page instead of the service's JSON.
+const BLOCKED = /<title>\s*(?:Just a moment|Attention Required|Access denied|403 Forbidden)|cf-chl-|cf-turnstile|captcha/i;
+/** The service's address for one number, with English wording. */
+export function daoTrackingUrl(raw) {
+    return `${DAO_ENDPOINT}?${new URLSearchParams({ barcode: normalizeDaoNumber(raw).number, lang: 'EN' })}`;
+}
+export class DaoTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const url = daoTrackingUrl(raw);
+        const read = async (signal, timeoutMs) => {
+            let bytes;
+            let status;
+            try {
+                // The page sends its WordPress nonce, which the service does not need
+                // without a session cookie.
+                ({ bytes, response: { status } } = await fetchBounded(url, { signal,
+                    headers: { Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: DAO_MAX_BYTES, fetcher: this.options.fetcher,
+                    allowHttpStatuses: [400] }));
+            }
+            catch (error) {
+                // An unknown number is {"found":false}; a missing route is not a missing parcel.
+                if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
+                    throw new TransportError(PROVIDER, 'DAO tracking service is unavailable', { cause: error });
+                }
+                throw error;
+            }
+            let payload;
+            try {
+                payload = parseJsonBytes(bytes, PROVIDER);
+            }
+            catch (cause) {
+                if (BLOCKED.test(decodeText(bytes.subarray(0, 64_000))))
+                    throw new ChallengeError(PROVIDER, 'DAO answered with a block page', { cause });
+                throw new SchemaError(PROVIDER, 'DAO returned invalid tracking JSON', { cause });
+            }
+            // The service names a request it cannot read, such as one without a number.
+            if (status === 400)
+                throw new IndeterminateError(PROVIDER, 'DAO rejected the tracking request');
+            return parseDao(payload, raw);
+        };
+        // A request that fails to reach DAO, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'dao', 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 DaoTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'dao', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeDaoNumber(number))),
+    };
+};

package/dist/carriers/dao/carrier.json

@@ -18,18 +18,68 @@
   "timezone": "Europe/Copenhagen",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "dao",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 850
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "pickup_point",
+    "delivery_partner",
+    "delivery_tracking_number"
+  ],
   "portal": {
     "url": "https://dao.as/find-din-pakke/#q={trackingNumber}",
     "searchUrl": "https://dao.as/find-din-pakke/",
     "canaryUrl": "https://dao.as/find-din-pakke/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "postcodes",
+      "pickup_point",
+      "pickup_point_address",
+      "office_opening_hours",
+      "coordinates",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "pickup_point",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "postcodes",
+      "pickup_point_address",
+      "office_opening_hours",
+      "coordinates"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "dimensions",
+      "service_name",
+      "offset_timestamps"
+    ]
   },
   "links": [
     {
@@ -53,5 +103,13 @@
       ]
     }
   ],
-  "detection": []
+  "detection": [
+    {
+      "id": "dao-1",
+      "pattern": "^000(?:5712696|5715127)\\d{10}$",
+      "confidence": "low",
+      "preferred": true,
+      "checksum": "sscc"
+    }
+  ]
 }

package/dist/carriers/dao/numbers.json

@@ -19,6 +19,7 @@
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -44,6 +45,7 @@
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -62,13 +64,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -94,6 +97,7 @@
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -112,13 +116,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -137,13 +142,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -162,13 +168,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -187,13 +194,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -212,13 +220,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"
@@ -237,13 +246,14 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "low",
         "candidates": [
           "postnord",
+          "dao",
           "swiss-post-cargo",
           "usps",
           "nz-post"

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

@@ -0,0 +1,27 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "DAO";
+export declare const DAO_MAX_BYTES = 256000;
+/** A number as DAO's tracker takes it. */
+export interface DaoNumber {
+    readonly number: string;
+    /**
+     * A nine-digit e-label code or a thirteen-digit parcel number, which the
+     * tracker may answer with the parcel's SSCC.
+     */
+    readonly alias: boolean;
+}
+/**
+ * DAO's tracker takes its twenty-digit SSCCs, thirteen-digit parcel numbers
+ * starting with 7 and the nine-digit e-label code a sender writes on a parcel
+ * without a label. An SSCC must pass its check digit.
+ */
+export declare function normalizeDaoNumber(raw: string): DaoNumber;
+/**
+ * The reply of DAO's tracking page service for one number: `{"found":false}`
+ * for a number it does not know, else the parcel with its number, its scans
+ * newest first, the pickup point and, for a parcel sent abroad, the partner's
+ * number and tracking link. The masked sender and recipient, the recipient's
+ * postcode and the pickup point's address, opening hours and coordinates are
+ * never read.
+ */
+export declare function parseDao(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/dao/parser.js

@@ -0,0 +1,141 @@
+import { carrierIdFromPartner } from '../../core/catalog/hints.js';
+import { isValidSscc, normalizeTrackingNumber } from '../../core/detection/index.js';
+import { 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, cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { CODE, daoCode, daoStage } from './status.js';
+export const PROVIDER = 'DAO';
+// A parcel's reply is a few kilobytes.
+export const DAO_MAX_BYTES = 256_000;
+const MAX_ROWS = 300;
+const MAX_EVENTS = 200;
+// The backend's clock, a wall time without an offset: "2026-10-06 23:24:15".
+const CLOCK = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})$/;
+const LEG = /^[A-Za-z]{1,20}$/;
+const EVENT = /^\d{1,4}$/;
+/**
+ * DAO's tracker takes its twenty-digit SSCCs, thirteen-digit parcel numbers
+ * starting with 7 and the nine-digit e-label code a sender writes on a parcel
+ * without a label. An SSCC must pass its check digit.
+ */
+export function normalizeDaoNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (/^00\d{18}$/.test(number) && isValidSscc(number))
+        return { number, alias: false };
+    if (/^(?:7\d{12}|\d{9})$/.test(number))
+        return { number, alias: true };
+    throw new InvalidInputError(PROVIDER, 'DAO tracks twenty-digit SSCCs, thirteen-digit numbers starting with 7 and nine-digit e-label codes');
+}
+/** The parcel number the reply names, in the forms DAO issues. */
+function issued(value) {
+    const barcode = normalizeTrackingNumber(cleanScalar(value, 40));
+    return /^(?:00\d{18}|7\d{12}|\d{9})$/.test(barcode) ? barcode : '';
+}
+/** A clock as a wall time, validated. The reply gives no offset. */
+function wallClock(value) {
+    const match = CLOCK.exec(clean(value, 32));
+    if (!match)
+        return null;
+    const [, year, month, day, hour, minute, second] = match;
+    if (!calendarDay(Number(year), Number(month), Number(day)) || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59)
+        return null;
+    return `${year}-${month}-${day}T${hour}:${minute}:${second}`;
+}
+/**
+ * One row of the parcel's history, from the `raw` record the page's service
+ * passes through from DAO's backend: its clock, leg, event number, wording and
+ * place. A home delivery's scan has no wording of its own: the delivered text
+ * is in its place field.
+ */
+function scanOf(row, index) {
+    const raw = isRecord(row) ? row.raw : undefined;
+    if (!isRecord(raw))
+        throw new SchemaError(PROVIDER, 'DAO returned a scan without its record');
+    const local = wallClock(raw.tidspunkt);
+    const leg = clean(raw.pakketype, 24);
+    const event = cleanScalar(raw.haendelse, 8);
+    if (!local || !EVENT.test(event) || (leg && !LEG.test(leg)))
+        throw new SchemaError(PROVIDER, 'DAO returned a scan without its clock or event');
+    const wording = clean(raw.beskrivelse, 300);
+    const place = clean(raw.sted, 120);
+    const description = wording || place;
+    if (!description)
+        throw new SchemaError(PROVIDER, 'DAO returned a scan without wording');
+    const code = daoCode(leg, event);
+    if (!CODE.test(code))
+        throw new SchemaError(PROVIDER, 'DAO returned an invalid event code');
+    const stage = daoStage(code);
+    return {
+        local,
+        index,
+        event: { local_time: local, description, ...(wording && place ? { location: place } : {}), provider_code: code,
+            ...(stage ? { stage, stage_source: 'carrier_map' } : {}) },
+    };
+}
+/** The partner and number a parcel sent abroad is tracked under, as the page links them. */
+function abroad(parcel, number) {
+    const partnerNumber = normalizeTrackingNumber(clean(parcel.dist_barcode, 64));
+    if (!/^[A-Z0-9]{4,40}$/.test(partnerNumber) || partnerNumber === number)
+        return {};
+    const partner = carrierIdFromPartner('', clean(parcel.external_tracking, 500));
+    return { delivery_tracking_number: partnerNumber, ...(partner && partner !== 'dao' ? { delivery_carrier: partner } : {}) };
+}
+/**
+ * The reply of DAO's tracking page service for one number: `{"found":false}`
+ * for a number it does not know, else the parcel with its number, its scans
+ * newest first, the pickup point and, for a parcel sent abroad, the partner's
+ * number and tracking link. The masked sender and recipient, the recipient's
+ * postcode and the pickup point's address, opening hours and coordinates are
+ * never read.
+ */
+export function parseDao(payload, raw) {
+    const { number, alias } = normalizeDaoNumber(raw);
+    if (!isRecord(payload) || typeof payload.found !== 'boolean')
+        throw new SchemaError(PROVIDER, 'DAO returned an unexpected reply');
+    if (!payload.found)
+        throw new NotFoundError(PROVIDER);
+    // The page shows its not-found notice for this too, but no reply showed one.
+    if (!isRecord(payload.parcel))
+        throw new IndeterminateError(PROVIDER, 'DAO returned no parcel for a number it knows');
+    const parcel = payload.parcel;
+    const barcode = issued(parcel.barcode);
+    // An e-label code or a thirteen-digit number may be answered with the parcel's SSCC.
+    if (barcode !== number && !(alias && barcode))
+        throw new SchemaError(PROVIDER, 'DAO answered for a different parcel');
+    const rows = parcel.events ?? [];
+    if (!Array.isArray(rows) || rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'DAO returned an invalid parcel history');
+    const seen = new Set();
+    const scans = rows.map(scanOf).filter(({ event }) => {
+        // A consignment's parcels can repeat one scan.
+        const identity = JSON.stringify(event);
+        if (seen.has(identity))
+            return false;
+        seen.add(identity);
+        return true;
+    });
+    if (!scans.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first; equal clocks keep the reply's order, which is newest first too.
+    scans.sort((left, right) => (left.local < right.local ? 1 : left.local > right.local ? -1 : left.index - right.index));
+    const events = scans.map(({ event }) => event);
+    const newest = events[0];
+    const stage = newest.stage;
+    // The daoSHOP the parcel goes to or waits at, by its name alone.
+    const point = isRecord(parcel.pickup) ? clean(parcel.pickup.name, 160) : '';
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: 'carrier_map' } : {}),
+        last_status_text: newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: null,
+        ...(barcode !== number ? { canonical_tracking_number: barcode } : {}),
+        ...(point ? { pickup_point: point } : {}),
+        ...abroad(parcel, barcode),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

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

@@ -0,0 +1,10 @@
+import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** A leg and an event number: `Home/11`. */
+export declare const CODE: RegExp;
+/** The stage a scan's leg and event number give a parcel, if the map knows them. */
+export declare function daoStage(code: string): Stage | undefined;
+/** The scan's provider code: its leg and event number, or the number alone without a leg. */
+export declare function daoCode(leg: string, event: string): string;
+/** The map reads the whole code: the same event number means different things on each leg. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/dao/status.js

@@ -0,0 +1,46 @@
+/**
+ * DAO numbers its scan events separately for each leg, home delivery (`Home`)
+ * and daoSHOP (`Shop`), and the same number means different things on the
+ * two: Home 11 delivers a parcel to the door, Shop 11 brings it into a
+ * terminal. A scan's provider code is its leg, a slash and its event number,
+ * as `Shop/32`. A parcel whose home delivery fails is sent to a daoSHOP, and
+ * its later scans are on the Shop leg.
+ */
+const STAGES = new Map([
+    // The sender's data, before DAO has the parcel.
+    ['Home/1', 'registered'],
+    ['Shop/1', 'registered'],
+    // Handed in at a daoSHOP by the sender.
+    ['Shop/25', 'accepted'],
+    ['Home/10', 'in_transit'],
+    ['Home/35', 'in_transit'],
+    ['Shop/11', 'in_transit'],
+    ['Shop/12', 'in_transit'],
+    ['Shop/16', 'in_transit'],
+    ['Shop/23', 'in_transit'],
+    ['Shop/26', 'in_transit'],
+    // The parcel is on the day's delivery round.
+    ['Home/31', 'out_for_delivery'],
+    ['Home/61', 'failed_attempt'],
+    // A failed home delivery: the parcel goes on to a daoSHOP.
+    ['Home/64', 'failed_attempt'],
+    ['Shop/32', 'ready_for_pickup'],
+    ['Home/11', 'delivered'],
+    // Collected at the daoSHOP.
+    ['Shop/51', 'delivered'],
+]);
+/** A leg and an event number: `Home/11`. */
+export const CODE = /^(?:[A-Za-z]{1,20}\/)?\d{1,4}$/;
+/** The stage a scan's leg and event number give a parcel, if the map knows them. */
+export function daoStage(code) {
+    return STAGES.get(code);
+}
+/** The scan's provider code: its leg and event number, or the number alone without a leg. */
+export function daoCode(leg, event) {
+    return leg ? `${leg}/${event}` : event;
+}
+/** The map reads the whole code: the same event number means different things on each leg. */
+export const statusMap = {
+    stage: (code) => (code ? STAGES.get(code) : undefined),
+    gaps: [],
+};

package/dist/carriers/dao/statuses.json

@@ -1,4 +1,171 @@
 {
   "carrier": "dao",
-  "entries": []
+  "entries": [
+    {
+      "code": "Home/1",
+      "wording": "Shipment created, awaiting registration",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The sender's data, before DAO has the parcel."
+    },
+    {
+      "code": "Home/1",
+      "wording": "Forsendelse er oprettet, afventer registrering",
+      "language": "da",
+      "stage": "registered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12"
+    },
+    {
+      "code": "Shop/1",
+      "wording": "Shipment created, awaiting registration",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The same event on a parcel the sender hands in at a daoSHOP."
+    },
+    {
+      "code": "Shop/25",
+      "wording": "Handed in at daoSHOP",
+      "language": "en",
+      "stage": "accepted",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The sender handed the parcel in at a daoSHOP."
+    },
+    {
+      "code": "Shop/26",
+      "wording": "On the way to terminal",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12"
+    },
+    {
+      "code": "Shop/11",
+      "wording": "Parcel has arrived at terminal",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "On the home leg the same event number is the delivery."
+    },
+    {
+      "code": "Shop/12",
+      "wording": "Sorted at: Erritsø terminal",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The wording names the terminal."
+    },
+    {
+      "code": "Shop/16",
+      "wording": "Sorted at: Sjælland terminal",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The wording names the terminal."
+    },
+    {
+      "code": "Shop/23",
+      "wording": "On the way to daoSHOP",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12"
+    },
+    {
+      "code": "Shop/32",
+      "wording": "Ready for pickup",
+      "language": "en",
+      "stage": "ready_for_pickup",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12"
+    },
+    {
+      "code": "Shop/51",
+      "wording": "Parcel delivered",
+      "language": "en",
+      "stage": "delivered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "Collected at the daoSHOP."
+    },
+    {
+      "code": "Home/10",
+      "wording": "Parcel arrived at dao depot",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The depot comes in the place field."
+    },
+    {
+      "code": "Home/10",
+      "wording": "Pakke ankommet til dao depot",
+      "language": "da",
+      "stage": "in_transit",
+      "confirmedBy": "portal",
+      "firstSeen": "2026-10-12",
+      "note": "Seen in archived replies of the tracking service."
+    },
+    {
+      "code": "Home/35",
+      "wording": "Pakke på vej til leveringsterminalen",
+      "language": "da",
+      "stage": "in_transit",
+      "confirmedBy": "portal",
+      "firstSeen": "2026-10-12",
+      "note": "On the way to the delivery terminal. Seen in archived replies of the tracking service."
+    },
+    {
+      "code": "Home/31",
+      "wording": "To be delivered today",
+      "language": "en",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "The parcel is planned for the day's delivery round."
+    },
+    {
+      "code": "Home/61",
+      "wording": "Not delivered - other reason",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12"
+    },
+    {
+      "code": "Home/64",
+      "wording": "Delivery not possible. Redirected to daoSHOP",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "Follows a failed delivery at the same second; the parcel goes on to a daoSHOP, on the Shop leg."
+    },
+    {
+      "code": "Home/11",
+      "wording": "Parcel delivered",
+      "language": "en",
+      "stage": "delivered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-12",
+      "note": "A home delivery has no wording of its own: the delivered text comes in the place field."
+    },
+    {
+      "code": "Home/11",
+      "wording": "Pakke leveret",
+      "language": "da",
+      "stage": "delivered",
+      "confirmedBy": "portal",
+      "firstSeen": "2026-10-12",
+      "note": "Seen in archived replies of the tracking service."
+    }
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -22,6 +22,7 @@ import { statusMap as ceskaPosta } from '../../carriers/ceska-posta/status.js';
 import { statusMap as chinaPost } from '../../carriers/china-post/status.js';
 import { statusMap as chronopost } from '../../carriers/chronopost/status.js';
 import { statusMap as correosSpain } from '../../carriers/correos-spain/status.js';
+import { statusMap as dao } from '../../carriers/dao/status.js';
 import { statusMap as dhlExpress } from '../../carriers/dhl-express/status.js';
 import { statusMap as dpd } from '../../carriers/dpd/status.js';
 import { statusMap as dpdDe } from '../../carriers/dpd-de/status.js';
@@ -76,7 +77,7 @@ import { CARRIER_DEFINITIONS } from './definitions.js';
 /** By adapter: a carrier served by another's adapter, as Delivengo by La Poste's, reads that map. */
 export const STATUS_MAPS = {
     'acs-courier': acsCourier, aliexpress, 'allegro-one': allegroOne, 'an-post': anPost, 'aras-kargo': arasKargo, 'box-now': boxNow, cacesa, cargus,
-    'ceska-posta': ceskaPosta, 'china-post': chinaPost, chronopost, 'correos-spain': correosSpain, 'dhl-express': dhlExpress, dpd, 'dpd-de': dpdDe,
+    'ceska-posta': ceskaPosta, 'china-post': chinaPost, chronopost, 'correos-spain': correosSpain, dao, 'dhl-express': dhlExpress, dpd, 'dpd-de': dpdDe,
     'dpd-fr': dpdFr, 'dpd-ie': dpdIe, 'dpd-pl': dpdPl, econt, elta, emile, 'express-one': expressOne, 'fan-courier': fanCourier, foxpost,
     'geniki-taxydromiki': geniki, 'gls-es': glsEs, 'gls-it': glsIt, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, helthjem, 'hrvatska-posta': hrvatskaPosta,
     'j-and-t': jAndT, 'j-and-t-cargo': jntCargo, 'la-poste': laPoste, 'latvijas-pasts': latvijasPasts, matkahuolto, 'mng-kargo': mngKargo,

package/dist/data/catalog.json

@@ -5249,7 +5249,9 @@
         "timezone": "Europe/Copenhagen",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "dao",
+            "recognitionRank": 850,
+            "localClocks": true
         },
         "canaryUrl": "https://dao.as/find-din-pakke/",
         "trackingUrlTemplate": "https://dao.as/find-din-pakke/#q={trackingNumber}",
@@ -5276,7 +5278,14 @@
                 ]
             }
         ],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^000(?:5712696|5715127)\\d{10}$",
+                "confidence": "low",
+                "checksum": "sscc",
+                "preferred": true
+            }
+        ]
     },
     "day-ross": {
         "displayName": "Day & Ross",

package/dist/generated/catalog.d.ts

@@ -3588,7 +3588,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Copenhagen";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "dao";
+            readonly recognitionRank: 850;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://dao.as/find-din-pakke/";
         readonly trackingUrlTemplate: "https://dao.as/find-din-pakke/#q={trackingNumber}";
@@ -3603,7 +3605,12 @@ export declare const CARRIER_CATALOG: {
             readonly pathPattern: "^/(?:en/private/track-your-parcel/?|dao-app/?)?$";
             readonly params: readonly ["stregkode"];
         }];
-        readonly detectionRules: readonly [];
+        readonly detectionRules: readonly [{
+            readonly pattern: "^000(?:5712696|5715127)\\d{10}$";
+            readonly confidence: "low";
+            readonly checksum: "sscc";
+            readonly preferred: true;
+        }];
     };
     readonly "day-ross": {
         readonly displayName: "Day & Ross";

package/dist/generated/catalog.js

@@ -5250,7 +5250,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Copenhagen",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "dao",
+            "recognitionRank": 850,
+            "localClocks": true
         },
         "canaryUrl": "https://dao.as/find-din-pakke/",
         "trackingUrlTemplate": "https://dao.as/find-din-pakke/#q={trackingNumber}",
@@ -5277,7 +5279,14 @@ export const CARRIER_CATALOG = {
                 ]
             }
         ],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^000(?:5712696|5715127)\\d{10}$",
+                "confidence": "low",
+                "checksum": "sscc",
+                "preferred": true
+            }
+        ]
     },
     "day-ross": {
         "displayName": "Day & Ross",
@@ -8888,7 +8897,7 @@ export const DETECTION_RULE_IDS = {
     "cne": ["cne-1"],
     "correos-de-mexico": [],
     "cyprus-post": [],
-    "dao": [],
+    "dao": ["dao-1"],
     "day-ross": ["day-ross-1"],
     "dhl-ecommerce-es": ["dhl-ecommerce-es-1", "dhl-ecommerce-es-2"],
     "dhl-ecommerce-nl": ["dhl-ecommerce-nl-1", "dhl-ecommerce-nl-2", "dhl-ecommerce-nl-3"],

package/dist/generated/recognition.js

@@ -19,6 +19,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "colis-prive": 300,
     "correos-express": 360,
     "ctt-express": 350,
+    "dao": 850,
     "delhivery": 160,
     "dhl-ecommerce": 230,
     "dhl-ecommerce-es": 190,

package/dist/generated/registry.js

@@ -33,6 +33,7 @@ import { adapter as correosSpain } from '../carriers/correos-spain/adapter.js';
 import { adapter as ctt } from '../carriers/ctt/adapter.js';
 import { adapter as cttExpress } from '../carriers/ctt-express/adapter.js';
 import { adapter as dachser } from '../carriers/dachser/adapter.js';
+import { adapter as dao } from '../carriers/dao/adapter.js';
 import { adapter as delhivery } from '../carriers/delhivery/adapter.js';
 import { adapter as dhl } from '../carriers/dhl/adapter.js';
 import { adapter as dhlEcommerce } from '../carriers/dhl-ecommerce/adapter.js';
@@ -188,6 +189,7 @@ export const REGISTRY = {
         "ctt": ctt,
         "ctt-express": cttExpress,
         "dachser": dachser,
+        "dao": dao,
         "delhivery": delhivery,
         "dhl": dhl,
         "dhl-ecommerce": dhlEcommerce,
@@ -352,7 +354,7 @@ export const REGISTRY = {
         "ctt-express": "ctt-express",
         "cyprus-post": "universal",
         "dachser": "dachser",
-        "dao": "universal",
+        "dao": "dao",
         "day-ross": "universal",
         "delhivery": "delhivery",
         "delivengo": "la-poste",

package/dist/server/openapi.json

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

package/package.json

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