universal-parcel-scraper 0.293.0-main.1746 → 0.294.0-main.1752

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 **334 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **336 dedicated adapters** and **5 universal fallbacks**
 
 <sub>635 catalog entries · 129 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 12,172 such statuses, each filed under one stage.
+The carrier folders record 12,191 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

@@ -10033,7 +10033,9 @@
     "timezone": "Europe/Vienna",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "dpd-at",
+      "recognitionRank": 878,
+      "localClocks": true
     },
     "canaryUrl": "https://www.mydpd.at/",
     "trackingUrlTemplate": "https://www.mydpd.at/?f=parcel.load&p={trackingNumber}",
@@ -15068,12 +15070,23 @@
     "timezone": "Asia/Amman",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "jordan-post",
+      "recognitionRank": 881,
+      "localClocks": true
     },
     "canaryUrl": "https://212.35.69.84/NewWebTrack/WebTrack_Submit.aspx",
-    "trackingUrlTemplate": "https://212.35.69.84/JordanWebTrack/Result.aspx?itemid={trackingNumber}",
+    "trackingUrlTemplate": "https://212.35.69.85/webtracking/IPSWeb_item_events.aspx?itemid={trackingNumber}&Submit=Submit",
     "trackingSearchUrl": "https://212.35.69.84/NewWebTrack/WebTrack_Submit.aspx",
     "linkRules": [
+      {
+        "domains": [
+          "212.35.69.85"
+        ],
+        "pathPattern": "^/webtracking/IPSWeb_item_events\\.aspx$",
+        "params": [
+          "itemid"
+        ]
+      },
       {
         "domains": [
           "212.35.69.84"
@@ -15084,7 +15097,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}JO$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "jrs-express": {
     "displayName": "JRS Express",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 635,
-  "activeAdapters": 334,
+  "activeAdapters": 336,
   "countries": 129,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -4327,6 +4327,32 @@
       "j-and-t"
     ]
   },
+  {
+    "input": "01955023696290",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dpd",
+      "dpd-fr",
+      "relais-colis",
+      "ciblex",
+      "seur",
+      "brt",
+      "delhivery",
+      "dhl-ecommerce-uk",
+      "dpd-be",
+      "dpd-de",
+      "dpd-nl",
+      "dpd-uk"
+    ],
+    "asked": [
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de",
+      "seur"
+    ]
+  },
   {
     "input": "01975035168241",
     "carrier": "unknown",
@@ -6982,11 +7008,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7012,11 +7038,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7042,11 +7068,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7072,11 +7098,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7102,11 +7128,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7188,11 +7214,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7218,11 +7244,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -7248,11 +7274,11 @@
       "dpd-at"
     ],
     "asked": [
-      "seur",
-      "brt",
-      "relais-colis",
-      "ciblex",
-      "dhl-ecommerce-uk"
+      "dpd-at",
+      "dpd-be",
+      "dpd",
+      "dpd-nl",
+      "dpd-de"
     ]
   },
   {
@@ -74295,6 +74321,14 @@
       "chronopost"
     ]
   },
+  {
+    "input": "RL851146956IE",
+    "carrier": "an-post",
+    "confidence": "high",
+    "candidates": [
+      "an-post"
+    ]
+  },
   {
     "input": "RL904818378CH",
     "carrier": "swiss-post",
@@ -75164,6 +75198,7 @@
       "intl-post"
     ],
     "asked": [
+      "jordan-post",
       "chronopost"
     ]
   },
@@ -75477,6 +75512,7 @@
       "intl-post"
     ],
     "asked": [
+      "jordan-post",
       "chronopost"
     ]
   },

package/dist/browser/scraper.js

@@ -7851,7 +7851,9 @@ var Me = {
 		timezone: "Europe/Vienna",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "dpd-at",
+			recognitionRank: 878,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.mydpd.at/",
 		trackingUrlTemplate: "https://www.mydpd.at/?f=parcel.load&p={trackingNumber}",
@@ -11543,17 +11545,28 @@ var Me = {
 		timezone: "Asia/Amman",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "jordan-post",
+			recognitionRank: 881,
+			localClocks: !0
 		},
 		canaryUrl: "https://212.35.69.84/NewWebTrack/WebTrack_Submit.aspx",
-		trackingUrlTemplate: "https://212.35.69.84/JordanWebTrack/Result.aspx?itemid={trackingNumber}",
+		trackingUrlTemplate: "https://212.35.69.85/webtracking/IPSWeb_item_events.aspx?itemid={trackingNumber}&Submit=Submit",
 		trackingSearchUrl: "https://212.35.69.84/NewWebTrack/WebTrack_Submit.aspx",
 		linkRules: [{
+			domains: ["212.35.69.85"],
+			pathPattern: "^/webtracking/IPSWeb_item_events\\.aspx$",
+			params: ["itemid"]
+		}, {
 			domains: ["212.35.69.84"],
 			pathPattern: "^/JordanWebTrack/Result\\.aspx$",
 			params: ["itemid"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}JO$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	"jrs-express": {
 		displayName: "JRS Express",
@@ -19854,7 +19867,7 @@ var Me = {
 	jhgj: ["jhgj-1"],
 	jitsu: [],
 	jne: ["jne-1"],
-	"jordan-post": [],
+	"jordan-post": ["jordan-post-s10"],
 	"jrs-express": [],
 	jrt: ["jrt-1"],
 	"js-express": ["js-express-1"],
@@ -25039,6 +25052,7 @@ var Mc = /* @__PURE__ */ new Map([
 	["FI", "posti"],
 	["FR", "la-poste"],
 	["GB", "royal-mail"],
+	["JO", "jordan-post"],
 	["JP", "japan-post"],
 	["MA", "barid-al-maghrib"],
 	["MK", "posta-north-macedonia"],
@@ -25324,6 +25338,7 @@ var ul = {
 	"dhl-freight": 437,
 	dhlink: 995,
 	dpd: 980,
+	"dpd-at": 878,
 	"dpd-be": 983,
 	"dpd-de": 970,
 	"dpd-ie": 960,
@@ -25387,6 +25402,7 @@ var ul = {
 	"j-and-t-cargo": 910,
 	jhgj: 907,
 	jitsu: 85,
+	"jordan-post": 881,
 	"js-express": 916,
 	kazpost: 931,
 	kex: 959,

package/dist/carriers/dpd-at/adapter.d.ts

@@ -0,0 +1,24 @@
+import { type AdapterFactory, type Recognition, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+import { type DpdAtReading } from './parser.js';
+/** The lookup myDPD's page makes for the number typed in. */
+export declare const DPD_AT_SEARCH = "https://www.mydpd.at/jws.php/parcel/search";
+export declare class DpdAtTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    read(raw: string, context?: TrackingContext): Promise<DpdAtReading>;
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+    /**
+     * Whether myDPD knows the parcel and its newest scan is in Austria. DPD
+     * Austria is the preferred carrier for its depots' numbers, so a parcel that
+     * has since moved to another country is left to that country's network,
+     * and a newest scan without a country is inconclusive.
+     */
+    recognize(raw: string, context?: TrackingContext): Promise<Recognition>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/dpd-at/adapter.js

@@ -0,0 +1,82 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, NotFoundError, SchemaError, TransportError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { DPD_AT_MAX_BYTES, dpdAtNumber, PROVIDER, readDpdAt } from './parser.js';
+/** The lookup myDPD's page makes for the number typed in. */
+export const DPD_AT_SEARCH = 'https://www.mydpd.at/jws.php/parcel/search';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// Radware's bot manager answers with its own page in place of the reply, or
+// sends the browser to its captcha on perfdrive.com.
+const CHALLENGE = /<title>\s*Radware (?:Captcha )?Page\s*<\/title>|Verifying your browser|perfdrive\.com|shieldsquare/i;
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'myDPD answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'myDPD returned a reply that is not JSON', { cause });
+    }
+}
+export class DpdAtTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async read(raw, context = {}) {
+        const number = dpdAtNumber(raw);
+        const search = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(DPD_AT_SEARCH, { method: 'POST', signal, headers: {
+                    Accept: 'application/json', 'Content-Type': 'application/json; charset=utf-8', 'User-Agent': userAgentOf(this.options.userAgent),
+                }, body: JSON.stringify(number) }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)),
+                maxBytes: DPD_AT_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: REDIRECTS });
+            if (REDIRECTS.includes(response.status)) {
+                if (CHALLENGE.test(response.headers.get('location') ?? ''))
+                    throw new ChallengeError(PROVIDER, 'myDPD sent the lookup to a captcha');
+                throw new TransportError(PROVIDER, 'myDPD redirected its tracking lookup');
+            }
+            return readDpdAt(json(decodeText(bytes)), number);
+        };
+        return runSteps({ carrier: 'dpd-at', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => search(signal, remainingMs) },
+        ]);
+    }
+    async fetch(raw, context = {}) {
+        return (await this.read(raw, context)).result;
+    }
+    /**
+     * Whether myDPD knows the parcel and its newest scan is in Austria. DPD
+     * Austria is the preferred carrier for its depots' numbers, so a parcel that
+     * has since moved to another country is left to that country's network,
+     * and a newest scan without a country is inconclusive.
+     */
+    async recognize(raw, context = {}) {
+        if (!accepted(() => dpdAtNumber(raw)))
+            return { known: false };
+        let reading;
+        try {
+            reading = await this.read(raw, context);
+        }
+        catch (error) {
+            if (error instanceof NotFoundError)
+                return { known: false };
+            throw error;
+        }
+        if (!reading.country)
+            throw new IndeterminateError(PROVIDER, 'myDPD named no country for the newest scan');
+        if (reading.country !== 'AT')
+            return { known: false };
+        return recognizeFromLookup(() => Promise.resolve(reading.result));
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new DpdAtTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'dpd-at', recordsSteps: true, steps: ['direct'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => tracker.recognize(number, context),
+    };
+};

package/dist/carriers/dpd-at/carrier.json

@@ -17,18 +17,60 @@
   "timezone": "Europe/Vienna",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "dpd-at",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 878
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "delivered_at"
+  ],
   "portal": {
     "url": "https://www.mydpd.at/?f=parcel.load&p={trackingNumber}",
     "searchUrl": "https://www.mydpd.at/",
     "canaryUrl": "https://www.mydpd.at/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "delivered_at",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "eta_window",
+      "pickup_point",
+      "signatory",
+      "delivery_instructions",
+      "delivery_options"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "delivered_at"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "eta_window",
+      "pickup_point",
+      "signatory",
+      "delivery_instructions",
+      "delivery_options"
+    ],
+    "unavailable": [
+      "weight",
+      "offset_timestamps"
+    ]
   },
   "links": [
     {

package/dist/carriers/dpd-at/numbers.json

@@ -182,7 +182,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -203,7 +203,7 @@
           "dpd-uk"
         ]
       },
-      "note": "Archived lookup on DPD Austria's myDPD tracker; the capture was not opened and the history was not visible."
+      "note": "Archived lookup on DPD Austria's myDPD tracker; myDPD's lookup knows it, from DPD Austria's Leopoldsdorf depot to a delivery from its Obertrum depot."
     },
     {
       "number": "06245146806199",
@@ -272,6 +272,39 @@
         ]
       },
       "note": "Archived lookup on DPD Austria's myDPD tracker, under the Sulz depot code; the capture was not opened and the history was not visible."
+    },
+    {
+      "number": "01955023696290",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260923101655/https://www.mydpd.at/meine-pakete?ipn=01955023696290",
+        "date": "2026-09-23",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dpd",
+          "dpd-fr",
+          "relais-colis",
+          "ciblex",
+          "seur",
+          "brt",
+          "delhivery",
+          "dhl-ecommerce-uk",
+          "dpd-be",
+          "dpd-de",
+          "dpd-nl",
+          "dpd-uk"
+        ]
+      },
+      "note": "Archived lookup on DPD Austria's myDPD tracker, under a German depot's code; myDPD's lookup knows it, from German depots to a Pickup station of DPD Austria's Leobendorf depot."
     }
   ]
 }

package/dist/carriers/dpd-at/parser.d.ts

@@ -0,0 +1,18 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "DPD Austria";
+export declare const DPD_AT_MAX_BYTES: number;
+/** The fourteen-digit parcel number myDPD takes, with or without DPD's check character; anything else is not one it issues. */
+export declare function dpdAtNumber(raw: string): string;
+/** What a myDPD reply says about the requested parcel, and the country of its newest scan when the reply shows it. */
+export interface DpdAtReading {
+    result: CarrierResult;
+    country: string | null;
+}
+/**
+ * The reply of myDPD's `parcel/search` for one number. It answers
+ * `{"state":"failure"}` for a number it does not know, which the page reports
+ * as not found, unless the reply carries a message for the page to show. A
+ * parcel must name the number asked.
+ */
+export declare function readDpdAt(payload: unknown, raw: string): DpdAtReading;
+export declare function parseDpdAt(payload: unknown, raw: string): CarrierResult;