universal-parcel-scraper 0.4.0-main.319 → 0.5.0-main.321

package/README.md

@@ -15,7 +15,7 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
 <!-- GENERATED:summary -->
 **3,500+ carriers** through **85 dedicated adapters** and **5 universal fallbacks**
 
-<sub>105 catalog entries · 58 countries represented</sub>
+<sub>106 catalog entries · 58 countries represented</sub>
 <!-- /GENERATED:summary -->
 
 [Try it](#try-it) · [Ways to run it](#ways-to-run-it) · [Benchmark](#benchmark) · [Carriers](carriers/) · [Add a carrier](CONTRIBUTING.md)

package/data/catalog.json

@@ -193,7 +193,12 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^DOFR\\d{13}HD$",
+        "confidence": "high"
+      }
+    ]
   },
   "sunyou": {
     "displayName": "SunYou",
@@ -463,7 +468,8 @@
     "timezone": "UTC",
     "tracking": {
       "mode": "automatic",
-      "adapter": "dhl-ecommerce"
+      "adapter": "dhl-ecommerce",
+      "recognitionRank": 23
     },
     "canaryUrl": "https://www.dhl.com/ch-en/home/tracking.html",
     "trackingUrlTemplate": "https://www.dhl.com/ch-en/home/tracking.html?tracking-id={trackingNumber}&submit=1",
@@ -1968,7 +1974,8 @@
     "timezone": "Europe/Helsinki",
     "tracking": {
       "mode": "automatic",
-      "adapter": "posti"
+      "adapter": "posti",
+      "recognitionRank": 27
     },
     "canaryUrl": "https://www.posti.fi/en/tracking",
     "trackingUrlTemplate": "https://www.posti.fi/en/tracking/{trackingNumber}",
@@ -1980,7 +1987,14 @@
         "path": "^/(?:[a-z]{2}/)?tracking/([^/?#]+)(?:/[0-9]+)?/?$"
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}FI$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "correos-express": {
     "displayName": "Correos Express",
@@ -3969,5 +3983,30 @@
       }
     ],
     "detectionRules": []
+  },
+  "omgo": {
+    "displayName": "OMGO",
+    "color": "#8e8e93",
+    "aliases": [
+      "OMGO Express"
+    ],
+    "countries": [
+      "CN"
+    ],
+    "selectable": true,
+    "timezone": "UTC",
+    "tracking": {
+      "mode": "automatic",
+      "adapter": "universal"
+    },
+    "canaryUrl": "https://omgoexpress.cn/",
+    "trackingUrlTemplate": "https://omgoexpress.cn/",
+    "linkRules": [],
+    "detectionRules": [
+      {
+        "pattern": "^OMGO\\d{13}$",
+        "confidence": "high"
+      }
+    ]
   }
 }

package/data/coverage-summary.json

@@ -1,5 +1,5 @@
 {
-  "catalog": 105,
+  "catalog": 106,
   "activeAdapters": 85,
   "countries": 58,
   "referenceCarriers": 100,

package/data/detection-golden.json

@@ -142,6 +142,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -1124,6 +1125,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -1140,6 +1142,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -1622,6 +1625,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -1638,6 +1642,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -1731,6 +1736,9 @@
     "confidence": "low",
     "candidates": [
       "dhl-ecommerce"
+    ],
+    "asked": [
+      "dhl-ecommerce"
     ]
   },
   {
@@ -1746,6 +1754,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -1922,6 +1931,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -2345,6 +2355,9 @@
     "confidence": "low",
     "candidates": [
       "dhl-ecommerce"
+    ],
+    "asked": [
+      "dhl-ecommerce"
     ]
   },
   {
@@ -2438,6 +2451,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -2454,6 +2468,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -2594,6 +2609,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -2970,6 +2986,7 @@
     "asked": [
       "tnt",
       "correos-express",
+      "dhl-ecommerce",
       "canada-post"
     ]
   },
@@ -3101,6 +3118,9 @@
     "confidence": "low",
     "candidates": [
       "dhl-ecommerce"
+    ],
+    "asked": [
+      "dhl-ecommerce"
     ]
   },
   {
@@ -3112,7 +3132,8 @@
       "colis-prive"
     ],
     "asked": [
-      "colis-prive"
+      "colis-prive",
+      "dhl-ecommerce"
     ]
   },
   {
@@ -3281,6 +3302,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -3428,6 +3452,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -3473,6 +3500,29 @@
       "spring-gds"
     ]
   },
+  {
+    "input": "CP123456785FI",
+    "carrier": "intl-post",
+    "confidence": "high",
+    "candidates": [
+      "intl-post"
+    ],
+    "asked": [
+      "posti",
+      "chronopost"
+    ]
+  },
+  {
+    "input": "CP123456789FI",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "chronopost"
+    ],
+    "asked": [
+      "chronopost"
+    ]
+  },
   {
     "input": "CP123456789PL",
     "carrier": "unknown",
@@ -3490,6 +3540,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -3613,6 +3666,26 @@
     "confidence": "none",
     "candidates": []
   },
+  {
+    "input": "DOFR0000000000001HD",
+    "carrier": "aliexpress",
+    "confidence": "high",
+    "candidates": [
+      "aliexpress"
+    ]
+  },
+  {
+    "input": "DOFR0000000000001HU",
+    "carrier": "unknown",
+    "confidence": "none",
+    "candidates": []
+  },
+  {
+    "input": "DOFR000000000001HD",
+    "carrier": "unknown",
+    "confidence": "none",
+    "candidates": []
+  },
   {
     "input": "DQ0DK20000034530118220Z",
     "carrier": "correos-spain",
@@ -4157,6 +4230,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -4184,6 +4260,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -4200,6 +4279,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -4216,6 +4298,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -4312,6 +4397,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -4462,6 +4550,28 @@
       "ninja-van"
     ]
   },
+  {
+    "input": "OMGO0000000000001",
+    "carrier": "omgo",
+    "confidence": "high",
+    "candidates": [
+      "omgo"
+    ]
+  },
+  {
+    "input": "OMGO000000000001",
+    "carrier": "unknown",
+    "confidence": "none",
+    "candidates": []
+  },
+  {
+    "input": "OMGO0000000050001",
+    "carrier": "omgo",
+    "confidence": "high",
+    "candidates": [
+      "omgo"
+    ]
+  },
   {
     "input": "PHAS9C0419962810128017D",
     "carrier": "correos-spain",
@@ -4597,6 +4707,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {
@@ -4998,6 +5111,9 @@
     "confidence": "high",
     "candidates": [
       "intl-post"
+    ],
+    "asked": [
+      "chronopost"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -278,7 +278,10 @@ var ue = {
 			domains: ["global.cainiao.com"],
 			params: ["mailNoList"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^DOFR\\d{13}HD$",
+			confidence: "high"
+		}]
 	},
 	sunyou: {
 		displayName: "SunYou",
@@ -476,7 +479,8 @@ var ue = {
 		timezone: "UTC",
 		tracking: {
 			mode: "automatic",
-			adapter: "dhl-ecommerce"
+			adapter: "dhl-ecommerce",
+			recognitionRank: 23
 		},
 		canaryUrl: "https://www.dhl.com/ch-en/home/tracking.html",
 		trackingUrlTemplate: "https://www.dhl.com/ch-en/home/tracking.html?tracking-id={trackingNumber}&submit=1",
@@ -1592,7 +1596,8 @@ var ue = {
 		timezone: "Europe/Helsinki",
 		tracking: {
 			mode: "automatic",
-			adapter: "posti"
+			adapter: "posti",
+			recognitionRank: 27
 		},
 		canaryUrl: "https://www.posti.fi/en/tracking",
 		trackingUrlTemplate: "https://www.posti.fi/en/tracking/{trackingNumber}",
@@ -1600,7 +1605,12 @@ var ue = {
 			domains: ["posti.fi"],
 			path: "^/(?:[a-z]{2}/)?tracking/([^/?#]+)(?:/[0-9]+)?/?$"
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}FI$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	"correos-express": {
 		displayName: "Correos Express",
@@ -3059,8 +3069,27 @@ var ue = {
 			params: ["itemId"]
 		}],
 		detectionRules: []
+	},
+	omgo: {
+		displayName: "OMGO",
+		color: "#8e8e93",
+		aliases: ["OMGO Express"],
+		countries: ["CN"],
+		selectable: !0,
+		timezone: "UTC",
+		tracking: {
+			mode: "automatic",
+			adapter: "universal"
+		},
+		canaryUrl: "https://omgoexpress.cn/",
+		trackingUrlTemplate: "https://omgoexpress.cn/",
+		linkRules: [],
+		detectionRules: [{
+			pattern: "^OMGO\\d{13}$",
+			confidence: "high"
+		}]
 	}
-}, de = /* @__PURE__ */ "swiss-post.swiss-post-cargo.quickpac.planzer.aliexpress.sunyou.hermes.spring-gds.postlogistics.dachser.dhl.dhl-ecommerce.ups.amazon-logistics.amazon-shipping.fedex.gls-ch.dpd.dpd-fr.mondial-relay.relais-colis.la-poste.chronopost.gls-fr.colis-prive.geodis.colisweb.c-chez-vous.heppner.ciblex.paack.asendia.shipup.india-post.hermes-de.gls-de.delivengo.intl-post.unknown.royal-mail.parcelforce.evri.inpost.an-post.bpost.austrian-post.postnord.posti.correos-express.seur.mrw.nacex.ctt.ctt-express.poste-italiane.brt.ecoscooting.tipsa.ukrposhta.usps.canada-post.purolator.canpar.ontrac.speedx.uniuni.landmark-global.old-dominion.spee-dee.gofo.estafeta.correios-br.correos-chile.yunexpress.four-px.blue-dart.delhivery.nz-post.singapore-post.japan-post.sf-express.sto.yunda.yto.zto.jd-logistics.yamato.korea-post.thailand-post.dtdc.australia-post.hongkong-post.pos-malaysia.ninja-van.china-post.packeta.poczta-polska.bring-posten.aramex.tnt.correos-spain.yanwen.the-courier-guy.j-and-t.ems".split("."), fe = [
+}, de = /* @__PURE__ */ "swiss-post.swiss-post-cargo.quickpac.planzer.aliexpress.sunyou.hermes.spring-gds.postlogistics.dachser.dhl.dhl-ecommerce.ups.amazon-logistics.amazon-shipping.fedex.gls-ch.dpd.dpd-fr.mondial-relay.relais-colis.la-poste.chronopost.gls-fr.colis-prive.geodis.colisweb.c-chez-vous.heppner.ciblex.paack.asendia.shipup.india-post.hermes-de.gls-de.delivengo.intl-post.unknown.royal-mail.parcelforce.evri.inpost.an-post.bpost.austrian-post.postnord.posti.correos-express.seur.mrw.nacex.ctt.ctt-express.poste-italiane.brt.ecoscooting.tipsa.ukrposhta.usps.canada-post.purolator.canpar.ontrac.speedx.uniuni.landmark-global.old-dominion.spee-dee.gofo.estafeta.correios-br.correos-chile.yunexpress.four-px.blue-dart.delhivery.nz-post.singapore-post.japan-post.sf-express.sto.yunda.yto.zto.jd-logistics.yamato.korea-post.thailand-post.dtdc.australia-post.hongkong-post.pos-malaysia.ninja-van.china-post.packeta.poczta-polska.bring-posten.aramex.tnt.correos-spain.yanwen.the-courier-guy.j-and-t.ems.omgo".split("."), fe = [
 	"pending",
 	"registered",
 	"accepted",
@@ -3313,7 +3342,8 @@ var We = [
 	/\b1G[A-Z0-9]{10}\b/gi,
 	/\b[A-Z]{2}\s*\d(?:[\s.-]?\d){8}\s*[A-Z]{2}\b/gi,
 	/\b(?:JJD|JVGL)[A-Z0-9]{8,}\b/gi,
-	/\b\d(?:[\s.-]?\d){9,19}\b/g
+	/\b\d(?:[\s.-]?\d){9,19}\b/g,
+	/\b[A-Z0-9]{4,40}\b/gi
 ];
 function Ge(e) {
 	for (let t of We) {
@@ -7404,6 +7434,7 @@ var Lo = {
 	"colis-prive": 30,
 	"correos-express": 36,
 	"ctt-express": 35,
+	"dhl-ecommerce": 23,
 	dpd: 70,
 	"gls-ch": 60,
 	"gls-de": 50,
@@ -7414,6 +7445,7 @@ var Lo = {
 	"ninja-van": 28,
 	"nz-post": 32,
 	"poczta-polska": 31,
+	posti: 27,
 	postlogistics: 26,
 	"relais-colis": 25,
 	seur: 43,
@@ -7423,20 +7455,26 @@ var Lo = {
 	uniuni: 33
 }, Ro = 5;
 function zo(e, t = {}) {
-	let n = b(e);
-	if (n.confidence !== "low") return [];
-	let r = new Set(n.preferred.filter((e) => Lo[e] === void 0).map((e) => Io(e)).filter(Boolean)), i = (e) => [
+	let n = b(e), r = n.carrier === "intl-post";
+	if (n.confidence !== "low" && !r) return [];
+	let i = g(e), a = r ? Object.entries(_).flatMap(([t, n]) => {
+		let r = n.detectionRules.find((t) => t.confidence === "low" && (!t.checksum || t.checksum === "s10") && new RegExp(t.pattern).test(i) && (!t.rawPattern || new RegExp(t.rawPattern).test(e.trim().toUpperCase())));
+		return r ? [{
+			carrier: t,
+			preferred: r.preferred === !0
+		}] : [];
+	}) : [], o = r ? a.map(({ carrier: e }) => e) : n.candidates, s = r ? a.filter((e) => e.preferred).map(({ carrier: e }) => e) : n.preferred, c = new Set(s.filter((e) => Lo[e] === void 0).map((e) => Io(e)).filter(Boolean)), l = (e) => [
 		+(e === t.hint),
-		+!!n.preferred.includes(e),
+		+!!s.includes(e),
 		Lo[e] ?? 0
 	];
-	return n.candidates.filter((e) => Lo[e] !== void 0 && we.has(e) && xe(e) !== "universal" && !r.has(Io(e)) && !t.skip?.(e)).map((e) => ({
+	return o.filter((e) => Lo[e] !== void 0 && we.has(e) && xe(e) !== "universal" && !c.has(Io(e)) && !t.skip?.(e)).map((e) => ({
 		carrier: e,
-		score: i(e)
+		score: l(e)
 	})).sort((e, t) => t.score[0] - e.score[0] || t.score[1] - e.score[1] || t.score[2] - e.score[2]).map(({ carrier: t }) => ({
 		carrier: t,
 		needsInput: Ce(t, e)[0]?.field ?? null,
-		preferred: n.preferred.includes(t)
+		preferred: s.includes(t)
 	}));
 }
 //#endregion

package/dist/carriers/aliexpress/carrier.json

@@ -55,5 +55,11 @@
       ]
     }
   ],
-  "detection": []
+  "detection": [
+    {
+      "id": "aliexpress-1",
+      "pattern": "^DOFR\\d{13}HD$",
+      "confidence": "high"
+    }
+  ]
 }

package/dist/carriers/aliexpress/numbers.json

@@ -1,6 +1,28 @@
 {
   "carrier": "aliexpress",
   "records": [
+    {
+      "number": "DOFR0000000000001HD",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "observed_request",
+      "expect": { "carrier": "aliexpress", "confidence": "high" },
+      "note": "Synthetic Cainiao shipment-number shape."
+    },
+    {
+      "number": "DOFR000000000001HD",
+      "role": "negative",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "expect": { "carrier": "unknown", "confidence": "none", "not": ["aliexpress"] }
+    },
+    {
+      "number": "DOFR0000000000001HU",
+      "role": "negative",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "expect": { "carrier": "unknown", "confidence": "none", "not": ["aliexpress"] }
+    },
     {
       "number": "CNG00798678939847",
       "role": "shipment",

package/dist/carriers/dhl-ecommerce/adapter.d.ts

@@ -1,20 +1,12 @@
 /**
- * DHL eCommerce, through the public recipient endpoint the global tracking
- * page calls (`www.dhl.com/utapi`).
- *
- * The endpoint answers every direct server request with an Akamai crypto
- * proof-of-work challenge (HTTP 428) that plain HTTP cannot solve (verified
- * 2026-09-10: cookie replay and visiting the page first both still return
- * 428), and browser clearance is not transferable back to Node. The lookup
- * therefore has a single step: a local Chromium session loads the tracking
- * page, the site solves its own challenge and calls the API in that session,
- * and the response to the exact requested URL is parsed.
+ * DHL eCommerce, through its anonymous Americas Webtrack API first, then
+ * the global tracking page's UTAPI for shipments outside Webtrack's scope.
  *
  * DHL may answer with a customer-confirmation id instead of the queried
  * alias, so only one eCommerce shipment from that exact request URL is
  * accepted, and the id itself is never retained.
  */
-import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type AdapterFactory, type Recognition, type TrackingContext } from '../../core/adapter/index.js';
 import { ChallengeError, type CarrierErrorOptions } from '../../core/errors/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 import { type StepRecorder } from '../../core/telemetry/index.js';
@@ -24,6 +16,11 @@ export declare function dhlEcommerceTrackingUrl(number: string): string;
 /** Only call for the response to the exact requested UTAPI URL. DHL can return
  * a customer-confirmation id which differs from every queried parcel alias. */
 export declare function parseDHLEcommerceResponse(payload: unknown): CarrierResult;
+/** Webtrack scopes the read to the requested alias and returns that alias on
+ * each package, as its own client requires. An alias can differ from all of
+ * the package's carrier identifiers, so accept it only on one identified,
+ * unambiguous package. Never accept a bare query echo or a fabricated shell. */
+export declare function parseDHLEcommerceWebtrackResponse(payload: unknown, trackingNumber: string): CarrierResult;
 /**
  * The tracking page answered with a challenge status instead of the tracking
  * application. The name is part of the host's error metadata contract: it
@@ -37,6 +34,8 @@ export declare class DHLEcommerceSessionError extends ChallengeError {
 export interface DHLEcommerceTrackerOptions extends Omit<UniversalBrowserOptions, 'signal'> {
     budgetMs?: number;
     recorder?: StepRecorder;
+    fetcher?: typeof fetch;
+    userAgent?: string;
 }
 export declare class DHLEcommerceTracker {
     readonly options: DHLEcommerceTrackerOptions;
@@ -45,6 +44,9 @@ export declare class DHLEcommerceTracker {
     constructor(options?: DHLEcommerceTrackerOptions);
     /** One browser at a time per instance: a batch must not spawn a Chromium per parcel. */
     fetch(trackingNumber: string, context?: TrackingContext): Promise<CarrierResult>;
+    /** Recognition never starts the global page or spends a browser budget. */
+    recognize(trackingNumber: string, context?: TrackingContext): Promise<Recognition>;
+    private direct;
     private browser;
 }
 export declare const adapter: AdapterFactory;