universal-parcel-scraper 0.132.0-main.1109 → 0.133.1

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 **193 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **197 dedicated adapters** and **5 universal fallbacks**
 
 <sub>210 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 5,803 such statuses, each filed under one stage.
+The carrier folders record 5,854 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

@@ -2024,6 +2024,9 @@
   "parcelforce": {
     "displayName": "Parcelforce Worldwide",
     "color": "#9d0f11",
+    "aliases": [
+      "Parcelforce"
+    ],
     "countries": [
       "GB"
     ],
@@ -5465,9 +5468,12 @@
     "timezone": "America/Moncton",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "day-ross",
+      "recognitionRank": 38,
+      "localClocks": true
     },
-    "canaryUrl": "https://dayross.com/",
+    "canaryUrl": "https://dayross.com/track-shipments",
+    "trackingSearchUrl": "https://dayross.com/track-shipments",
     "linkRules": [],
     "detectionRules": [
       {
@@ -6988,11 +6994,31 @@
     "timezone": "Europe/Stockholm",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "instabox",
+      "requirements": [
+        {
+          "field": "trackingUrl",
+          "validator": "instaboxCapabilityUrl",
+          "optional": true,
+          "label": "Instabox notification URL",
+          "type": "url",
+          "placeholder": "https://track.instabox.com/…",
+          "help": "The complete notification link opens your parcel history. Without it, other sources are asked."
+        }
+      ]
     },
-    "canaryUrl": "https://track.instabox.com/en",
+    "canaryUrl": "https://track.instabox.com/",
     "trackingSearchUrl": "https://track.instabox.com/en",
-    "linkRules": [],
+    "linkRules": [
+      {
+        "domains": [
+          "track.instabox.com"
+        ],
+        "pathPattern": "^/[a-z]{2}(?:-[A-Z]{2})?/[A-Za-z0-9]{4,40}(?:/locker-to-locker-recipient)?/?$",
+        "path": "^/[a-z]{2}(?:-[A-Z]{2})?/([A-Za-z0-9]{4,40})(?:/locker-to-locker-recipient)?/?$",
+        "keepsCapabilityUrl": true
+      }
+    ],
     "detectionRules": []
   },
   "intelcom": {
@@ -8243,10 +8269,12 @@
     "timezone": "America/New_York",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "saia",
+      "recognitionRank": 12,
+      "localClocks": true
     },
     "canaryUrl": "https://www.saia.com/track",
-    "trackingUrlTemplate": "https://www.saia.com/track?pro={trackingNumber}",
+    "trackingUrlTemplate": "https://www.saia.com/track/details;pro={trackingNumber}",
     "trackingSearchUrl": "https://www.saia.com/track",
     "linkRules": [
       {
@@ -8257,6 +8285,16 @@
         "params": [
           "pro"
         ]
+      },
+      {
+        "domains": [
+          "saia.com"
+        ],
+        "pathPattern": "^/track/details(?:/|;|$)",
+        "path": "^/track/details;pro=(\\d+)",
+        "params": [
+          "pro"
+        ]
       }
     ],
     "detectionRules": []
@@ -8728,9 +8766,11 @@
     "timezone": "Asia/Shanghai",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "wanbexpress",
+      "recognitionRank": 33,
+      "browserRecognitionRank": 33
     },
-    "canaryUrl": "https://www.wanbexpress.com/",
+    "canaryUrl": "https://tracking.wanbexpress.com/",
     "linkRules": [],
     "detectionRules": [
       {
@@ -8856,6 +8896,7 @@
       "mode": "automatic",
       "adapter": "xpo-ltl",
       "recognitionRank": 25,
+      "browserRecognitionRank": 25,
       "localClocks": true
     },
     "canaryUrl": "https://www.xpo.com/",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 210,
-  "activeAdapters": 193,
+  "activeAdapters": 197,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -33006,7 +33006,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {
@@ -33037,7 +33038,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {
@@ -35872,7 +35874,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {
@@ -35884,7 +35887,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {
@@ -35896,7 +35900,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {
@@ -37615,7 +37620,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {
@@ -37627,7 +37633,8 @@
       "day-ross"
     ],
     "asked": [
-      "australia-post"
+      "australia-post",
+      "day-ross"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -1771,6 +1771,7 @@ var De = {
 	parcelforce: {
 		displayName: "Parcelforce Worldwide",
 		color: "#9d0f11",
+		aliases: ["Parcelforce"],
 		countries: ["GB"],
 		selectable: !0,
 		timezone: "UTC",
@@ -4437,9 +4438,12 @@ var De = {
 		timezone: "America/Moncton",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "day-ross",
+			recognitionRank: 38,
+			localClocks: !0
 		},
-		canaryUrl: "https://dayross.com/",
+		canaryUrl: "https://dayross.com/track-shipments",
+		trackingSearchUrl: "https://dayross.com/track-shipments",
 		linkRules: [],
 		detectionRules: [{
 			pattern: "^(?:MRO|MTN|SMI|SML|XTO)\\d{7}$",
@@ -5565,11 +5569,25 @@ var De = {
 		timezone: "Europe/Stockholm",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "instabox",
+			requirements: [{
+				field: "trackingUrl",
+				validator: "instaboxCapabilityUrl",
+				optional: !0,
+				label: "Instabox notification URL",
+				type: "url",
+				placeholder: "https://track.instabox.com/…",
+				help: "The complete notification link opens your parcel history. Without it, other sources are asked."
+			}]
 		},
-		canaryUrl: "https://track.instabox.com/en",
+		canaryUrl: "https://track.instabox.com/",
 		trackingSearchUrl: "https://track.instabox.com/en",
-		linkRules: [],
+		linkRules: [{
+			domains: ["track.instabox.com"],
+			pathPattern: "^/[a-z]{2}(?:-[A-Z]{2})?/[A-Za-z0-9]{4,40}(?:/locker-to-locker-recipient)?/?$",
+			path: "^/[a-z]{2}(?:-[A-Z]{2})?/([A-Za-z0-9]{4,40})(?:/locker-to-locker-recipient)?/?$",
+			keepsCapabilityUrl: !0
+		}],
 		detectionRules: []
 	},
 	intelcom: {
@@ -6508,15 +6526,22 @@ var De = {
 		timezone: "America/New_York",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "saia",
+			recognitionRank: 12,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.saia.com/track",
-		trackingUrlTemplate: "https://www.saia.com/track?pro={trackingNumber}",
+		trackingUrlTemplate: "https://www.saia.com/track/details;pro={trackingNumber}",
 		trackingSearchUrl: "https://www.saia.com/track",
 		linkRules: [{
 			domains: ["saia.com"],
 			pathPattern: "^/track/?$",
 			params: ["pro"]
+		}, {
+			domains: ["saia.com"],
+			pathPattern: "^/track/details(?:/|;|$)",
+			path: "^/track/details;pro=(\\d+)",
+			params: ["pro"]
 		}],
 		detectionRules: []
 	},
@@ -6859,9 +6884,11 @@ var De = {
 		timezone: "Asia/Shanghai",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "wanbexpress",
+			recognitionRank: 33,
+			browserRecognitionRank: 33
 		},
-		canaryUrl: "https://www.wanbexpress.com/",
+		canaryUrl: "https://tracking.wanbexpress.com/",
 		linkRules: [],
 		detectionRules: [{
 			pattern: "^WNB[A-Z]{2}\\d{10}YQ$",
@@ -6957,6 +6984,7 @@ var De = {
 			mode: "automatic",
 			adapter: "xpo-ltl",
 			recognitionRank: 25,
+			browserRecognitionRank: 25,
 			localClocks: !0
 		},
 		canaryUrl: "https://www.xpo.com/",
@@ -12475,6 +12503,7 @@ var Qc = {
 	"cyprus-post": 60,
 	"dai-post": 62,
 	dao: 515,
+	"day-ross": 38,
 	delhivery: 600,
 	"dhl-ecommerce": 670,
 	"dhl-ecommerce-es": 630,
@@ -12547,6 +12576,7 @@ var Qc = {
 	redpack: 15,
 	"relais-colis": 690,
 	"rl-carriers": 5,
+	saia: 12,
 	sameday: 370,
 	seur: 870,
 	"slovak-parcel-service": 180,
@@ -12563,6 +12593,7 @@ var Qc = {
 	uniuni: 770,
 	venipak: 240,
 	"vinted-go": 410,
+	wanbexpress: 33,
 	whistl: 320,
 	"xpo-ltl": 25,
 	"yurtici-kargo": 430,
@@ -12689,7 +12720,7 @@ function cl(e, t = /* @__PURE__ */ new Date()) {
 }
 //#endregion
 //#region core/catalog/urls.ts
-var ll = "trackandtrace.planzergroup.com", ul = /^\/shared\/sendungen\/([^/]+)\/?$/, dl = /^[A-Za-z0-9_-]{32,256}$/, fl = "customeriberia.dachser.com", pl = "/customerarea/utilidades/seguimiento-publico/detalle", ml = /^[A-Za-z0-9_-]{4,256}$/, hl = /[\x00-\x1f\x7f]/, gl = /* @__PURE__ */ new Set([
+var ll = "trackandtrace.planzergroup.com", ul = /^\/shared\/sendungen\/([^/]+)\/?$/, dl = /^[A-Za-z0-9_-]{32,256}$/, fl = "customeriberia.dachser.com", pl = "/customerarea/utilidades/seguimiento-publico/detalle", ml = /^\/[a-z]{2}(?:-[A-Z]{2})?\/([A-Z0-9]{4,40})(?:\/locker-to-locker-recipient)?\/?$/i, hl = /^[A-Za-z0-9_-]{4,256}$/, gl = /[\x00-\x1f\x7f]/, _l = /* @__PURE__ */ new Set([
 	"hash",
 	"cliente",
 	"numeroUnico",
@@ -12704,7 +12735,22 @@ var ll = "trackandtrace.planzergroup.com", ul = /^\/shared\/sendungen\/([^/]+)\/
 	"origen",
 	"usuario"
 ]);
-function _l(e, n) {
+function vl(e, n) {
+	let r;
+	try {
+		r = new URL(e.trim());
+	} catch {
+		throw TypeError("Paste the complete Instabox notification URL");
+	}
+	if (e.length > 4096 || r.protocol !== "https:" || r.hostname !== "track.instabox.com" || r.username || r.password || r.port && r.port !== "443" || r.hash) throw TypeError("Instabox notification links must use https://track.instabox.com");
+	let i = ml.exec(r.pathname);
+	if (!i || i[1].toUpperCase() !== t(n)) throw TypeError("The Instabox URL must name this complete parcel identifier");
+	let a = [...r.searchParams].filter(([e]) => e === "authCode" || e === "c");
+	if (a.length !== 1 || !/^[A-Za-z0-9_-]{16,160}$/.test(a[0][1])) throw TypeError("The Instabox notification URL must include its verification code");
+	for (let [e, t] of r.searchParams) if (!["authCode", "c"].includes(e) && (!/^utm_(?:source|medium|campaign|content|term)$/.test(e) || t.length > 256)) throw TypeError("The Instabox URL contains an unsupported parameter");
+	return r.pathname = r.pathname.replace(i[1], t(n)), r.search = new URLSearchParams([a[0]]).toString(), r.toString();
+}
+function yl(e, n) {
 	let r = e.trim();
 	if (r.length < 1 || r.length > 4096) throw TypeError("Paste the complete Planzer tracking URL");
 	let i;
@@ -12727,7 +12773,7 @@ function _l(e, n) {
 	if (s.length !== 1 || !dl.test(s[0])) throw TypeError("The Planzer URL must include its accessKey");
 	return i.toString();
 }
-function vl(e, n) {
+function bl(e, n) {
 	let r = e.trim();
 	if (r.length < 1 || r.length > 4096) throw TypeError("Paste the complete Dachser tracking URL");
 	let i;
@@ -12746,25 +12792,25 @@ function vl(e, n) {
 	if (a !== pl && a !== `${pl}/`) throw TypeError("Paste a Dachser public shipment detail URL");
 	let o = /* @__PURE__ */ new Map();
 	for (let [e, t] of i.searchParams) {
-		if (!gl.has(e)) throw TypeError("The Dachser URL contains an unsupported parameter");
+		if (!_l.has(e)) throw TypeError("The Dachser URL contains an unsupported parameter");
 		if (o.has(e)) throw TypeError("The Dachser URL contains a duplicate parameter");
-		if (!t || t.length > 256 || hl.test(t)) throw TypeError("The Dachser URL contains an invalid parameter");
+		if (!t || t.length > 256 || gl.test(t)) throw TypeError("The Dachser URL contains an invalid parameter");
 		o.set(e, t);
 	}
 	let s = o.get("numeroUnico");
 	if (!s) throw TypeError("The Dachser URL must include its shipment number");
 	if (t(s) !== t(n)) throw TypeError("The Dachser URL belongs to a different tracking number");
-	let c = o.get("hash"), l = o.get("clave"), u = o.get("fecha"), d = !!(c && ml.test(c)), f = !!(l && u && ml.test(l) && /^\d{8}$/.test(u));
+	let c = o.get("hash"), l = o.get("clave"), u = o.get("fecha"), d = !!(c && hl.test(c)), f = !!(l && u && hl.test(l) && /^\d{8}$/.test(u));
 	if (!d && !f) throw TypeError("The Dachser URL must include its access parameters");
 	return i.protocol = "https:", i.hostname = fl, i.port = "", i.toString();
 }
 //#endregion
 //#region core/catalog/postcode.ts
-var yl = /^(?=.{3,12}$)(?=.*\d)[A-Z0-9]+(?:[ -][A-Z0-9]+)*$/;
-function bl(e) {
+var xl = /^(?=.{3,12}$)(?=.*\d)[A-Z0-9]+(?:[ -][A-Z0-9]+)*$/;
+function Sl(e) {
 	return e.trim().toUpperCase().replace(/\s+/g, " ");
 }
-function xl(e) {
+function Cl(e) {
 	let t = e.toUpperCase().replace(/\s+/g, "");
 	if (/^(?:0[1-9]|[1-8]\d|9[0-5]|97|98)\d{3}$/.test(t)) return t;
 	let n = /^(?:(BE?|LU?)-?)?([1-9]\d{3})$/.exec(t);
@@ -12772,17 +12818,17 @@ function xl(e) {
 }
 //#endregion
 //#region core/catalog/inputs.ts
-function Sl(e, t) {
+function wl(e, t) {
 	return e === "mondial-relay" && /^(?:\d{10}|\d{12}|\d{26})$/.test(t);
 }
-function Cl(e, t, n, r) {
+function Tl(e, t, n, r) {
 	let i = {
 		trackingUrl: n.trim() || null,
 		postcode: r.trim() || null
 	};
 	if (e === "mondial-relay" && /^\d{26}$/.test(t) && !we(t)) throw TypeError("Invalid Mondial Relay barcode");
 	let a = new Map(Be(e, t).map((e) => [e.field, e]));
-	Sl(e, t) && i.postcode && a.set("postcode", {
+	wl(e, t) && i.postcode && a.set("postcode", {
 		field: "postcode",
 		validator: "internationalPostcode"
 	});
@@ -12795,9 +12841,12 @@ function Cl(e, t, n, r) {
 		}
 		switch (r.validator) {
 			case "planzerSharedUrl":
-				i[n] = _l(a, t);
+				i[n] = yl(a, t);
 				break;
 			case "dachserCapabilityUrl":
+				i[n] = bl(a, t);
+				break;
+			case "instaboxCapabilityUrl":
 				i[n] = vl(a, t);
 				break;
 			case "swissPostcode":
@@ -12811,8 +12860,8 @@ function Cl(e, t, n, r) {
 				if (!/^\d{4,5}$/.test(a)) throw TypeError(`${g(e).displayName} requires a four- or five-digit delivery postcode`);
 				break;
 			case "internationalPostcode":
-				if (!yl.test(bl(a))) throw TypeError(`${g(e).displayName} requires a valid delivery postcode`);
-				i[n] = bl(a);
+				if (!xl.test(Sl(a))) throw TypeError(`${g(e).displayName} requires a valid delivery postcode`);
+				i[n] = Sl(a);
 				break;
 			case "paackPostcode": {
 				let e = a.toLocaleUpperCase("en-US");
@@ -12821,7 +12870,7 @@ function Cl(e, t, n, r) {
 				break;
 			}
 			case "colisPrivePostcode": {
-				let t = xl(a);
+				let t = Cl(a);
 				if (!t) throw TypeError(`${g(e).displayName} requires a French, Belgian or Luxembourg delivery postcode`);
 				i[n] = t;
 				break;
@@ -12831,12 +12880,12 @@ function Cl(e, t, n, r) {
 	}
 	return i;
 }
-function wl(e) {
-	let t = bl(e);
-	if (!yl.test(t)) throw TypeError("A valid delivery postcode is required");
+function El(e) {
+	let t = Sl(e);
+	if (!xl.test(t)) throw TypeError("A valid delivery postcode is required");
 	return t;
 }
-var Tl = { carriers: [
+var Dl = { carriers: [
 	{
 		carrier: "dhl",
 		direct: "Yes",
@@ -16812,80 +16861,80 @@ var Tl = { carriers: [
 			}
 		}]
 	}
-] }, El = [
+] }, Ol = [
 	"Ship24",
 	"ParcelsApp",
 	"17TRACK",
 	"Postal Ninja",
 	"UPU"
-], Dl = /* @__PURE__ */ new Set([
+], kl = /* @__PURE__ */ new Set([
 	"no_history",
 	"summary_only",
 	"undated",
 	"sign_in",
 	"postcode_prompt"
-]), Ol = Tl.carriers, kl = new Map(Ol.map((e) => [e.carrier, e]));
-function Al(e) {
+]), Al = Dl.carriers, jl = new Map(Al.map((e) => [e.carrier, e]));
+function Ml(e) {
 	return typeof e == "number" || e === "history" || typeof e == "object" && !!e;
 }
-function jl(e, t) {
-	let n = t.filter((t) => t.results[e] !== void 0), r = n.some((t) => !t.stale && (Dl.has(t.results[e]) || t.results[e] === "wrong_carrier") && Object.entries(t.results).some(([t, n]) => t !== e && t !== "UPU" && Al(n)));
-	return n.some((t) => Al(t.results[e])) ? n.some((t) => typeof t.results[e] == "object") || r ? "partial" : "full" : n.some((t) => ["wrong_carrier", "refused"].includes(t.results[e])) ? "excluded" : n.some((t) => !t.stale && Dl.has(t.results[e])) ? "empty" : "unknown";
+function Nl(e, t) {
+	let n = t.filter((t) => t.results[e] !== void 0), r = n.some((t) => !t.stale && (kl.has(t.results[e]) || t.results[e] === "wrong_carrier") && Object.entries(t.results).some(([t, n]) => t !== e && t !== "UPU" && Ml(n)));
+	return n.some((t) => Ml(t.results[e])) ? n.some((t) => typeof t.results[e] == "object") || r ? "partial" : "full" : n.some((t) => ["wrong_carrier", "refused"].includes(t.results[e])) ? "excluded" : n.some((t) => !t.stale && kl.has(t.results[e])) ? "empty" : "unknown";
 }
-function Ml(e) {
-	let t = e ? kl.get(e) : void 0;
-	return t ? Object.fromEntries(El.map((e) => [e, jl(e, t.references)])) : null;
+function Pl(e) {
+	let t = e ? jl.get(e) : void 0;
+	return t ? Object.fromEntries(Ol.map((e) => [e, Nl(e, t.references)])) : null;
 }
 //#endregion
 //#region providers/plan.ts
-var Nl = [
+var Fl = [
 	"ParcelsApp",
 	"Ship24",
 	"17TRACK",
 	"UPU"
-], Pl = /* @__PURE__ */ new Set(["17TRACK", "Postal Ninja"]);
-function Fl(e) {
+], Il = /* @__PURE__ */ new Set(["17TRACK", "Postal Ninja"]);
+function Ll(e) {
 	return e === "ParcelsApp" ? 45e3 : e === "UPU" ? 8e3 : 3e4;
 }
-function Il(e) {
+function Rl(e) {
 	return e && /^\d{10}$/.test(t(e)) ? "Ship24" : e && /^[CL][A-Z]\d{9}CN$/.test(t(e)) && v(e) ? "17TRACK" : void 0;
 }
-var Ll = {
+var zl = {
 	full: 0,
 	partial: 1,
 	unknown: 2,
 	empty: 3,
 	excluded: 4
 };
-function Rl(e, t) {
-	let n = Ll[e?.[t] ?? "unknown"];
-	return t === "UPU" ? Ll.unknown : t === "Postal Ninja" ? Math.max(n, Ll.empty) : n;
-}
-var zl = (e) => e === "UPU" ? 2 : +(e === "Postal Ninja");
 function Bl(e, t) {
+	let n = zl[e?.[t] ?? "unknown"];
+	return t === "UPU" ? zl.unknown : t === "Postal Ninja" ? Math.max(n, zl.empty) : n;
+}
+var Vl = (e) => e === "UPU" ? 2 : +(e === "Postal Ninja");
+function Hl(e, t) {
 	let n = (e) => e !== "UPU" && t?.[e] === "excluded";
-	return (e.some((e) => e !== "UPU" && !n(e)) ? e.filter((e) => !n(e)) : [...e]).sort((n, r) => zl(n) - zl(r) || Rl(t, n) - Rl(t, r) || Number(Pl.has(n)) - Number(Pl.has(r)) || e.indexOf(n) - e.indexOf(r));
+	return (e.some((e) => e !== "UPU" && !n(e)) ? e.filter((e) => !n(e)) : [...e]).sort((n, r) => Vl(n) - Vl(r) || Bl(t, n) - Bl(t, r) || Number(Il.has(n)) - Number(Il.has(r)) || e.indexOf(n) - e.indexOf(r));
 }
-function Vl(e = {}) {
+function Ul(e = {}) {
 	let { trackingNumber: t, enablePostalNinja: n = !1 } = e, r = (n ? [
 		"ParcelsApp",
 		"Ship24",
 		"17TRACK",
 		"Postal Ninja",
 		"UPU"
-	] : [...Nl]).filter((e) => e !== "UPU" || t === void 0 || v(t)), i = (e.carriers ?? []).find((e) => Ml(e)) ?? null, a = Ml(i), o = Bl(r, a), s = Il(t);
+	] : [...Fl]).filter((e) => e !== "UPU" || t === void 0 || v(t)), i = (e.carriers ?? []).find((e) => Pl(e)) ?? null, a = Pl(i), o = Hl(r, a), s = Rl(t);
 	return {
 		sources: s ? [s, ...o.filter((e) => e !== s)] : o,
 		carrier: i,
 		tier: (e) => a?.[e] ?? "unknown",
-		rank: (e) => Rl(a, e)
+		rank: (e) => Bl(a, e)
 	};
 }
-function Hl(e = !1, t) {
-	return Vl({
+function Wl(e = !1, t) {
+	return Ul({
 		trackingNumber: t,
 		enablePostalNinja: e
 	}).sources;
 }
 //#endregion
-export { je as AMAZON_NUMBER_PATTERN, He as AUTOMATIC_CARRIER_IDS, Pl as BROWSER_SOURCES, te as BudgetExceededError, _ as CARRIERS, De as CARRIER_CATALOG, h as CARRIER_DEFINITIONS, Oe as CARRIER_IDS, Ue as CARRIER_NAMES, a as CarrierError, l as ChallengeError, Ho as EXPLICIT_OFFSET_PATTERN, s as IndeterminateError, p as InputRequiredError, m as InvalidInputError, $c as MAX_RECOGNITIONS, d as MaintenanceError, c as NoHistoryError, o as NotFoundError, u as RateLimitedError, Ze as SELECTABLE_CARRIERS, Ae as STAGES, f as SchemaError, zt as TRACKING_CANDIDATE_PATTERNS, We as TRACKING_LINK_RULES, ee as TransportError, Nl as UNIVERSAL_SOURCES, re as UpstreamHttpError, ie as UpstreamNetworkError, Be as activeRequirements, Pe as amazonMarketplace, Fe as amazonOrdersUrl, Ie as amazonShippingOrigin, Le as amazonShippingUrl, gs as calendarDay, us as canadaProvinceTimeZone, ze as carrierAdapter, g as carrierDefinition, oe as carrierErrorKind, Xe as carrierInfo, Ge as carrierLinkRules, Qe as carrierRequirements, Re as carrierTimezone, Pt as checksumRejections, mc as classifyStage, lc as classifyWording, is as countryCode, as as countryTimeZone, Mc as deliveryHandoff, Ft as detectCarrier, y as detectCarrierMatch, ms as epochMillisTime, hs as epochSecondsTime, ce as errorTypeOf, Es as eventPoint, Wo as explicitOffsetTime, Zc as failureHint, Xc as failureKind, Yc as fillPartialAnswer, Q as firstOccurrence, r as formatTrackingNumber, jc as hasDirectHandoffAdapter, hc as inferStage, Me as isAmazonTrackingNumber, Jc as isPartialAnswer, n as isPlanzerSharedTrackingNumber, it as isValidCorreosSpainCheckLetter, me as isValidDhlExpressWaybill, st as isValidDpdParcelNumber, gt as isValidGlsParcelNumber, _t as isValidHermesParcelNumber, we as isValidMondialRelayBarcode, Se as isValidPocztaPolskaBarcode, v as isValidS10TrackingNumber, Ce as isValidSscc, ge as isValidTntConsignmentNumber, Dt as isValidUspsPackageBarcode, Ko as isoTime, Ut as keywordNumberInText, cc as languageStageStatus, tt as localizedCarrierUrl, Ke as matchesDomain, Jo as mislabeledLocalTime, Yo as mislabeledWallTime, Cl as normalizeCarrierInputs, Ds as normalizeCarrierResult, wl as normalizeDeliveryPostcode, t as normalizeTrackingNumber, Bl as orderUniversalSources, Xt as parseTrackingInput, Il as priorityUniversalSource, nl as recognitionCandidates, el as recognitionNumberShape, il as recognizeAll, Bt as recognizedNumberInText, ps as regionHasTown, Ve as requiredRequirements, $e as requirementSatisfied, Ne as requiresAmazonAccount, _c as resolveResult, pc as resultHasUpdate, fc as resultStage, se as retryAfterMsOf, Qo as settleGuessedClocks, cl as settleRecognition, Xo as sharedClockZone, gc as stageSource, xt as supportsSwissPostHandoff, os as timeZoneCountry, ds as townKey, sc as trackingLanguageStage, Je as trackingLink, qe as trackingNumberForLink, et as tracksAutomatically, Vl as universalPlan, Fl as universalSourceBudget, Hl as universalSources, cs as usStateTimeZone, Et as uspsPackageIdentifier, Lt as validTrackingNumber, vl as validateDachserTrackingUrl, _l as validatePlanzerSharedUrl, uc as wordingStage, Go as zonedTime };
+export { je as AMAZON_NUMBER_PATTERN, He as AUTOMATIC_CARRIER_IDS, Il as BROWSER_SOURCES, te as BudgetExceededError, _ as CARRIERS, De as CARRIER_CATALOG, h as CARRIER_DEFINITIONS, Oe as CARRIER_IDS, Ue as CARRIER_NAMES, a as CarrierError, l as ChallengeError, Ho as EXPLICIT_OFFSET_PATTERN, s as IndeterminateError, p as InputRequiredError, m as InvalidInputError, $c as MAX_RECOGNITIONS, d as MaintenanceError, c as NoHistoryError, o as NotFoundError, u as RateLimitedError, Ze as SELECTABLE_CARRIERS, Ae as STAGES, f as SchemaError, zt as TRACKING_CANDIDATE_PATTERNS, We as TRACKING_LINK_RULES, ee as TransportError, Fl as UNIVERSAL_SOURCES, re as UpstreamHttpError, ie as UpstreamNetworkError, Be as activeRequirements, Pe as amazonMarketplace, Fe as amazonOrdersUrl, Ie as amazonShippingOrigin, Le as amazonShippingUrl, gs as calendarDay, us as canadaProvinceTimeZone, ze as carrierAdapter, g as carrierDefinition, oe as carrierErrorKind, Xe as carrierInfo, Ge as carrierLinkRules, Qe as carrierRequirements, Re as carrierTimezone, Pt as checksumRejections, mc as classifyStage, lc as classifyWording, is as countryCode, as as countryTimeZone, Mc as deliveryHandoff, Ft as detectCarrier, y as detectCarrierMatch, ms as epochMillisTime, hs as epochSecondsTime, ce as errorTypeOf, Es as eventPoint, Wo as explicitOffsetTime, Zc as failureHint, Xc as failureKind, Yc as fillPartialAnswer, Q as firstOccurrence, r as formatTrackingNumber, jc as hasDirectHandoffAdapter, hc as inferStage, Me as isAmazonTrackingNumber, Jc as isPartialAnswer, n as isPlanzerSharedTrackingNumber, it as isValidCorreosSpainCheckLetter, me as isValidDhlExpressWaybill, st as isValidDpdParcelNumber, gt as isValidGlsParcelNumber, _t as isValidHermesParcelNumber, we as isValidMondialRelayBarcode, Se as isValidPocztaPolskaBarcode, v as isValidS10TrackingNumber, Ce as isValidSscc, ge as isValidTntConsignmentNumber, Dt as isValidUspsPackageBarcode, Ko as isoTime, Ut as keywordNumberInText, cc as languageStageStatus, tt as localizedCarrierUrl, Ke as matchesDomain, Jo as mislabeledLocalTime, Yo as mislabeledWallTime, Tl as normalizeCarrierInputs, Ds as normalizeCarrierResult, El as normalizeDeliveryPostcode, t as normalizeTrackingNumber, Hl as orderUniversalSources, Xt as parseTrackingInput, Rl as priorityUniversalSource, nl as recognitionCandidates, el as recognitionNumberShape, il as recognizeAll, Bt as recognizedNumberInText, ps as regionHasTown, Ve as requiredRequirements, $e as requirementSatisfied, Ne as requiresAmazonAccount, _c as resolveResult, pc as resultHasUpdate, fc as resultStage, se as retryAfterMsOf, Qo as settleGuessedClocks, cl as settleRecognition, Xo as sharedClockZone, gc as stageSource, xt as supportsSwissPostHandoff, os as timeZoneCountry, ds as townKey, sc as trackingLanguageStage, Je as trackingLink, qe as trackingNumberForLink, et as tracksAutomatically, Ul as universalPlan, Ll as universalSourceBudget, Wl as universalSources, cs as usStateTimeZone, Et as uspsPackageIdentifier, Lt as validTrackingNumber, bl as validateDachserTrackingUrl, vl as validateInstaboxTrackingUrl, yl as validatePlanzerSharedUrl, uc as wordingStage, Go as zonedTime };

package/dist/carriers/apc-overnight/parser.js

@@ -1,3 +1,4 @@
+import { returnedTrackingNumber } from '../../core/detection/returned.js';
 import { load } from 'cheerio';
 import { DateTime } from 'luxon';
 import { normalizeTrackingNumber } from '../../core/detection/index.js';
@@ -54,7 +55,7 @@ function searchPage($, html, number) {
     const notice = notices.length === 1 ? clean(notices.text(), 200) : '';
     // The page puts the identifier it was asked for back into its search field.
     const fields = $('input#ConsignmentNumber');
-    const echoed = fields.length === 1 ? normalizeTrackingNumber(clean(fields.attr('value'), 80)) : '';
+    const echoed = fields.length === 1 ? returnedTrackingNumber(fields.attr('value')) : '';
     if (notice === NOT_FOUND || notice === INVALID) {
         if (echoed !== number)
             throw new SchemaError(PROVIDER, 'APC Overnight answered for a different number');

package/dist/carriers/asendia/probe.js

@@ -21,6 +21,7 @@
  * event from an explicit allowlist (time, harmonized wording, scanning
  * location, harmonized code) and copies nothing else.
  */
+import { returnedTrackingNumber } from '../../core/detection/returned.js';
 import { createHash } from 'node:crypto';
 import { load } from 'cheerio';
 import { DateTime } from 'luxon';
@@ -140,7 +141,7 @@ function parseTenantConfig(payload) {
 function responseIdentifier(parcel) {
     for (const value of [parcel.tracking_id, parcel.upper_tracking_id]) {
         try {
-            return normalizeAsendiaTrackingNumber(cleanScalar(value, 64));
+            return normalizeAsendiaTrackingNumber(returnedTrackingNumber(value, true));
         }
         catch {
             // Try the alternate provider field.

package/dist/carriers/cdek/parser.js

@@ -1,3 +1,4 @@
+import { returnedTrackingNumber } from '../../core/detection/returned.js';
 import { normalizeTrackingNumber } from '../../core/detection/index.js';
 import { IndeterminateError, InvalidInputError, NoHistoryError, SchemaError } from '../../core/errors/index.js';
 import { languageStageStatus } from '../../core/status/index.js';
@@ -71,8 +72,8 @@ export function parseCdek(payload, raw) {
     const data = payload.data;
     if (!isRecord(data))
         throw new SchemaError(PROVIDER, 'CDEK did not return an order');
-    const order = normalizeTrackingNumber(clean(data.orderNumber, 40));
-    const outer = payload.orderNumber === undefined ? order : normalizeTrackingNumber(clean(payload.orderNumber, 40));
+    const order = returnedTrackingNumber(data.orderNumber);
+    const outer = payload.orderNumber === undefined ? order : returnedTrackingNumber(payload.orderNumber);
     if (!ISSUED.test(order) || outer !== order)
         throw new SchemaError(PROVIDER, 'CDEK returned an order without its number');
     // CDEK finds an order by a number it links to it and answers with the order's own number.

package/dist/carriers/correos-de-mexico/parser.js

@@ -1,3 +1,4 @@
+import { returnedTrackingNumber } from '../../core/detection/returned.js';
 import { load } from 'cheerio';
 import { isValidS10TrackingNumber, normalizeTrackingNumber } from '../../core/detection/index.js';
 import { ChallengeError, IndeterminateError, InvalidInputError, SchemaError } from '../../core/errors/index.js';
@@ -125,7 +126,7 @@ export function readCorreosDeMexicoPage(html, rawNumber, askedYear) {
     const guia = form.find('input#Guia[name="Guia"]');
     if (guia.length !== 1)
         throw new SchemaError(PROVIDER, 'Correos de México tracking form changed');
-    if (normalizeTrackingNumber(clean(guia.attr('value'), 80)) !== number) {
+    if (returnedTrackingNumber(guia.attr('value')) !== number) {
         throw new SchemaError(PROVIDER, 'Correos de México answered for a different number');
     }
     const options = form.find('select#Periodo[name="Periodo"] > option');