universal-parcel-scraper 0.237.0-main.1502 → 0.239.0-main.1504

package/data/catalog.json

@@ -126,7 +126,8 @@
     "displayName": "Planzer",
     "color": "#e30613",
     "aliases": [
-      "Planzer Group"
+      "Planzer Group",
+      "Planzer Parcel"
     ],
     "countries": [
       "CH"
@@ -774,7 +775,9 @@
     "color": "#ff9900",
     "aliases": [
       "Shipping with Amazon",
-      "SWA"
+      "SWA",
+      "Amazon Swiship",
+      "Swiship"
     ],
     "countries": [
       "FR",
@@ -2121,6 +2124,7 @@
       "mode": "automatic",
       "adapter": "evri",
       "upstreamName": "Evri International",
+      "recognitionRank": 605,
       "localClocks": true
     },
     "canaryUrl": "https://globaleco.app/track/",
@@ -2300,6 +2304,10 @@
   "postnord": {
     "displayName": "PostNord",
     "color": "#00a0d6",
+    "aliases": [
+      "PostNord Danmark",
+      "PostNord Denmark"
+    ],
     "countries": [
       "SE",
       "DK",
@@ -3617,6 +3625,9 @@
   "nz-post": {
     "displayName": "NZ Post",
     "color": "#d8291c",
+    "aliases": [
+      "New Zealand Post"
+    ],
     "countries": [
       "NZ"
     ],
@@ -3997,6 +4008,9 @@
   "korea-post": {
     "displayName": "Korea Post",
     "color": "#da291c",
+    "aliases": [
+      "South Korea Post"
+    ],
     "countries": [
       "KR"
     ],
@@ -4390,6 +4404,11 @@
   "poczta-polska": {
     "displayName": "Poczta Polska",
     "color": "#c43c2b",
+    "aliases": [
+      "Polish Post",
+      "Poland Post",
+      "Pocztex"
+    ],
     "countries": [
       "PL"
     ],
@@ -4442,7 +4461,8 @@
     "color": "#56b529",
     "aliases": [
       "Posten Norge",
-      "Posten Bring"
+      "Posten Bring",
+      "Norway Post"
     ],
     "countries": [
       "NO",
@@ -4636,6 +4656,9 @@
   "yanwen": {
     "displayName": "Yanwen",
     "color": "#8cbe1e",
+    "aliases": [
+      "Yanwen Logistics"
+    ],
     "countries": [
       "CN"
     ],
@@ -10527,7 +10550,9 @@
     "timezone": "Europe/London",
     "tracking": {
       "mode": "automatic",
-      "adapter": "evri-uk"
+      "adapter": "evri-uk",
+      "recognitionRank": 615,
+      "recognitionPattern": "^(?:[HT][0-9A-Z]{5}|C00HHA)\\d{10}$"
     },
     "canaryUrl": "https://www.evri.com/track-a-parcel",
     "trackingUrlTemplate": "https://www.evri.com/track/parcel/{trackingNumber}/details",
@@ -12651,7 +12676,8 @@
     "aliases": [
       "Intelcom",
       "Dragonfly",
-      "Dragonfly Shipping"
+      "Dragonfly Shipping",
+      "Intelcom Express"
     ],
     "countries": [
       "CA"

package/data/detection-golden.json

@@ -50562,6 +50562,9 @@
     "confidence": "low",
     "candidates": [
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk"
     ]
   },
   {
@@ -50570,6 +50573,9 @@
     "confidence": "low",
     "candidates": [
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk"
     ]
   },
   {
@@ -50578,6 +50584,9 @@
     "confidence": "low",
     "candidates": [
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk"
     ]
   },
   {
@@ -50586,6 +50595,9 @@
     "confidence": "low",
     "candidates": [
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk"
     ]
   },
   {
@@ -57308,6 +57320,8 @@
       "evri-uk"
     ],
     "asked": [
+      "evri-uk",
+      "evri",
       "hermes-de"
     ]
   },
@@ -57318,6 +57332,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57327,6 +57345,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57336,6 +57358,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57345,6 +57371,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57354,6 +57384,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57363,6 +57397,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57372,6 +57410,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57381,6 +57423,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57390,6 +57436,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57399,6 +57449,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57408,6 +57462,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57417,6 +57475,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57426,6 +57488,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57435,6 +57501,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57444,6 +57514,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57453,6 +57527,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57462,6 +57540,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57471,6 +57553,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57480,6 +57566,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57489,6 +57579,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57498,6 +57592,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57507,6 +57605,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57516,6 +57618,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57525,6 +57631,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57540,6 +57650,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57549,6 +57663,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57558,6 +57676,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57567,6 +57689,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57576,6 +57702,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -57585,6 +57715,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {
@@ -68927,6 +69061,10 @@
     "candidates": [
       "evri",
       "evri-uk"
+    ],
+    "asked": [
+      "evri-uk",
+      "evri"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -348,7 +348,7 @@ var Ae = {
 	planzer: {
 		displayName: "Planzer",
 		color: "#e30613",
-		aliases: ["Planzer Group"],
+		aliases: ["Planzer Group", "Planzer Parcel"],
 		countries: ["CH"],
 		selectable: !0,
 		timezone: "Europe/Zurich",
@@ -832,7 +832,12 @@ var Ae = {
 	"amazon-shipping": {
 		displayName: "Amazon Shipping",
 		color: "#ff9900",
-		aliases: ["Shipping with Amazon", "SWA"],
+		aliases: [
+			"Shipping with Amazon",
+			"SWA",
+			"Amazon Swiship",
+			"Swiship"
+		],
 		countries: /* @__PURE__ */ "FR.DE.BE.GB.IT.ES.NL.AT.IE.PL.SE.PT.LU.DK.FI.CZ.SK.HU.RO.BG.HR.SI.EE.LV.LT.GR.CY.MT.CH.NO.IS.LI.TR.US".split("."),
 		selectable: !1,
 		timezone: "UTC",
@@ -1885,6 +1890,7 @@ var Ae = {
 			mode: "automatic",
 			adapter: "evri",
 			upstreamName: "Evri International",
+			recognitionRank: 605,
 			localClocks: !0
 		},
 		canaryUrl: "https://globaleco.app/track/",
@@ -2047,6 +2053,7 @@ var Ae = {
 	postnord: {
 		displayName: "PostNord",
 		color: "#00a0d6",
+		aliases: ["PostNord Danmark", "PostNord Denmark"],
 		countries: [
 			"SE",
 			"DK",
@@ -3084,6 +3091,7 @@ var Ae = {
 	"nz-post": {
 		displayName: "NZ Post",
 		color: "#d8291c",
+		aliases: ["New Zealand Post"],
 		countries: ["NZ"],
 		selectable: !0,
 		timezone: "UTC",
@@ -3371,6 +3379,7 @@ var Ae = {
 	"korea-post": {
 		displayName: "Korea Post",
 		color: "#da291c",
+		aliases: ["South Korea Post"],
 		countries: ["KR"],
 		selectable: !0,
 		timezone: "UTC",
@@ -3682,6 +3691,11 @@ var Ae = {
 	"poczta-polska": {
 		displayName: "Poczta Polska",
 		color: "#c43c2b",
+		aliases: [
+			"Polish Post",
+			"Poland Post",
+			"Pocztex"
+		],
 		countries: ["PL"],
 		selectable: !0,
 		timezone: "UTC",
@@ -3724,7 +3738,11 @@ var Ae = {
 	"bring-posten": {
 		displayName: "Bring",
 		color: "#56b529",
-		aliases: ["Posten Norge", "Posten Bring"],
+		aliases: [
+			"Posten Norge",
+			"Posten Bring",
+			"Norway Post"
+		],
 		countries: [
 			"NO",
 			"SE",
@@ -3887,6 +3905,7 @@ var Ae = {
 	yanwen: {
 		displayName: "Yanwen",
 		color: "#8cbe1e",
+		aliases: ["Yanwen Logistics"],
 		countries: ["CN"],
 		selectable: !0,
 		timezone: "UTC",
@@ -8204,7 +8223,9 @@ var Ae = {
 		timezone: "Europe/London",
 		tracking: {
 			mode: "automatic",
-			adapter: "evri-uk"
+			adapter: "evri-uk",
+			recognitionRank: 615,
+			recognitionPattern: "^(?:[HT][0-9A-Z]{5}|C00HHA)\\d{10}$"
 		},
 		canaryUrl: "https://www.evri.com/track-a-parcel",
 		trackingUrlTemplate: "https://www.evri.com/track/parcel/{trackingNumber}/details",
@@ -9768,7 +9789,8 @@ var Ae = {
 		aliases: [
 			"Intelcom",
 			"Dragonfly",
-			"Dragonfly Shipping"
+			"Dragonfly Shipping",
+			"Intelcom Express"
 		],
 		countries: ["CA"],
 		selectable: !0,
@@ -22648,6 +22670,8 @@ var il = {
 	envialia: 260,
 	"epost-global": 65,
 	estes: 20,
+	evri: 605,
+	"evri-uk": 615,
 	"express-one": 190,
 	"fan-courier": 330,
 	"four-px": 570,

package/dist/carriers/amazon-shipping/carrier.json

@@ -3,7 +3,9 @@
   "displayName": "Amazon Shipping",
   "aliases": [
     "Shipping with Amazon",
-    "SWA"
+    "SWA",
+    "Amazon Swiship",
+    "Swiship"
   ],
   "region": {
     "countries": [

package/dist/carriers/bring-posten/carrier.json

@@ -3,7 +3,8 @@
   "displayName": "Bring",
   "aliases": [
     "Posten Norge",
-    "Posten Bring"
+    "Posten Bring",
+    "Norway Post"
   ],
   "region": {
     "countries": [

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

@@ -1,4 +1,4 @@
-import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 export { normalizeEvriNumber, parse } from './parser.js';
 /**

package/dist/carriers/evri/adapter.js

@@ -1,3 +1,4 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
 import { TransportError, UpstreamHttpError } from '../../core/errors/index.js';
 import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
 import { normalizeEvriNumber, parse, PROVIDER } from './parser.js';
@@ -51,5 +52,8 @@ export class EvriTracker {
 }
 export const adapter = (environment) => {
     const tracker = new EvriTracker({ fetcher: environment.fetcher, userAgent: environment.userAgent });
-    return { id: 'evri', steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context) };
+    return {
+        id: 'evri', steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeEvriNumber(number))),
+    };
 };

package/dist/carriers/evri/carrier.json

@@ -23,6 +23,9 @@
     "steps": [
       "direct"
     ],
+    "recognition": {
+      "rank": 605
+    },
     "localClocks": true
   },
   "capabilities": [

package/dist/carriers/evri-uk/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import { type StepRecorder } from '../../core/telemetry/index.js';
 export declare class EvriUkTracker {
     private readonly options;

package/dist/carriers/evri-uk/adapter.js

@@ -1,9 +1,10 @@
+import { accepted } from '../../core/adapter/index.js';
 import { CarrierError, carrierErrorKind, ChallengeError, IndeterminateError, RateLimitedError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
 import { recoverableByDefault, runSteps } from '../../core/runner/index.js';
 import { NOOP_RECORDER } from '../../core/telemetry/index.js';
 import { withLocalBrowser } from '../../core/transport/localBrowser.js';
 import { requestEvriUkInPage } from './browser.js';
-import { EVRI_UK_UNCONFIRMED, readEvriUkMobile } from './mobile.js';
+import { EVRI_UK_UNCONFIRMED, readEvriUkMobile, recognizeEvriUkMobile } from './mobile.js';
 import { normalizeEvriUkNumber, parseEvriUk } from './parser.js';
 /** How long the guest API may take while the page can still answer. */
 const DIRECT_TIMEOUT_MS = 10_000;
@@ -89,5 +90,17 @@ export const adapter = environment => {
         executablePath: environment.browserExecutablePath, recorder: environment.recorder, fetcher: environment.fetcher,
         userAgent: environment.userAgent,
     });
-    return { id: 'evri-uk', recordsSteps: true, steps: ['direct', 'browser'], track: (input, context) => tracker.fetch(input.number, context) };
+    return {
+        id: 'evri-uk', recordsSteps: true, steps: ['direct', 'browser'], track: (input, context) => tracker.fetch(input.number, context),
+        // The guest API's reference lookup alone; the page is never opened to recognize a number.
+        recognize: async (number, context = {}) => {
+            if (!accepted(() => normalizeEvriUkNumber(number)))
+                return { known: false };
+            const budgetMs = context.budgetMs ?? DIRECT_TIMEOUT_MS;
+            if (!Number.isFinite(budgetMs) || budgetMs <= 0)
+                throw new TypeError('Evri UK budget must be positive');
+            return recognizeEvriUkMobile(number, { fetcher: environment.fetcher, userAgent: environment.userAgent,
+                signal: context.signal ?? new AbortController().signal, timeoutMs: budgetMs });
+        },
+    };
 };

package/dist/carriers/evri-uk/carrier.json

@@ -22,7 +22,11 @@
     "steps": [
       "direct",
       "browser"
-    ]
+    ],
+    "recognition": {
+      "rank": 615,
+      "pattern": "^(?:[HT][0-9A-Z]{5}|C00HHA)\\d{10}$"
+    }
   },
   "capabilities": [
     "history",

package/dist/carriers/evri-uk/mobile.d.ts

@@ -1,10 +1,19 @@
+import type { Recognition } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 export declare const EVRI_UK_MOBILE_API = "https://tracking.platform-apis.evri.com/v1";
 /** The history service answered and confirmed no domestic parcel activity; the page asks the same service. */
 export declare const EVRI_UK_UNCONFIRMED = "parcel_unconfirmed";
-export declare function readEvriUkMobile(raw: string, options: {
+type MobileOptions = {
     fetcher?: typeof fetch;
     userAgent?: string;
     signal: AbortSignal;
     timeoutMs: number;
-}): Promise<CarrierResult>;
+};
+export declare function readEvriUkMobile(raw: string, options: MobileOptions): Promise<CarrierResult>;
+/**
+ * Whether Evri UK holds the barcode, from the reference lookup tracking starts
+ * with. No parcel and a barcode the service rejects for its check digit are
+ * unknown, and so is a parcel it redirects to Evri International's tracker.
+ */
+export declare function recognizeEvriUkMobile(raw: string, options: MobileOptions): Promise<Recognition>;
+export {};

package/dist/carriers/evri-uk/mobile.js

@@ -11,52 +11,75 @@ const APPLICATION_KEY = 'NpxtibhIgliySB4JRfjAQq2vytmiWGUQ';
 function unconfirmed() {
     throw new IndeterminateError('Evri UK', 'Evri UK could not confirm a domestic parcel', { reason: EVRI_UK_UNCONFIRMED });
 }
-export async function readEvriUkMobile(raw, options) {
+async function request(url, options, deadline) {
+    const { response, bytes } = await fetchBounded(url, { signal: options.signal,
+        headers: { Accept: 'application/json', apiKey: APPLICATION_KEY, 'User-Agent': userAgentOf(options.userAgent) } }, {
+        provider: 'Evri UK', maxBytes: MAX_BYTES, timeoutMs: Math.max(1, Math.floor(deadline - performance.now())),
+        fetcher: options.fetcher, allowHttpStatuses: [400, 401, 403, 404, 410],
+    });
+    if ([401, 403].includes(response.status))
+        throw new ChallengeError('Evri UK', 'Evri UK refused the tracking API key');
+    let payload;
+    try {
+        payload = JSON.parse(decodeText(bytes));
+    }
+    catch {
+        payload = undefined;
+    }
+    // The service reports a reference it rejects as JSON; a bare status is the endpoint's.
+    if (response.status !== 200 && !(isRecord(payload) && Array.isArray(payload.errors) && payload.errors.length)) {
+        if ([404, 410].includes(response.status))
+            throw new TransportError('Evri UK', 'Evri UK tracking API is unavailable', { status: response.status });
+        throw new UpstreamHttpError('Evri UK', response.status);
+    }
+    if (response.status === 200 && payload === undefined)
+        throw new SchemaError('Evri UK', 'Evri UK returned invalid tracking data');
+    return { status: response.status, payload };
+}
+async function guarded(options, run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        options.signal.throwIfAborted();
+        // Transport diagnostics include the key, the barcode and recipient fields.
+        // Preserve the failure contract without forwarding request or body data.
+        if (error instanceof CarrierError)
+            throw new CarrierError(error.kind, 'Evri UK', `Evri UK tracking failed (${error.kind})`, {
+                status: error.status, retryAfterMs: error.retryAfterMs, reason: error.reason,
+            });
+        throw new TransportError('Evri UK', 'Evri UK tracking API request failed');
+    }
+}
+function boundUrn(identifier, number) {
+    const urn = isRecord(identifier) ? identifier.urn : undefined;
+    if (typeof urn !== 'string' || !new RegExp(`^urn:parcel_id:barcode:date:\\d{1,30}:${number}:\\d{4}-\\d{2}-\\d{2}$`).test(urn)) {
+        throw new SchemaError('Evri UK', 'Evri UK did not return the requested parcel');
+    }
+    return urn;
+}
+function identifiersOf(payload) {
+    const identifiers = isRecord(payload) ? payload.parcelIdentifiers : undefined;
+    if (!Array.isArray(identifiers) || identifiers.length > 50)
+        throw new SchemaError('Evri UK', 'Evri UK returned invalid parcel identifiers');
+    return identifiers;
+}
+export function readEvriUkMobile(raw, options) {
     const number = normalizeEvriUkNumber(raw);
     const deadline = performance.now() + options.timeoutMs;
-    const read = async (url) => {
-        const { response, bytes } = await fetchBounded(url, { signal: options.signal,
-            headers: { Accept: 'application/json', apiKey: APPLICATION_KEY, 'User-Agent': userAgentOf(options.userAgent) } }, {
-            provider: 'Evri UK', maxBytes: MAX_BYTES, timeoutMs: Math.max(1, Math.floor(deadline - performance.now())),
-            fetcher: options.fetcher, allowHttpStatuses: [400, 401, 403, 404, 410],
-        });
-        if ([401, 403].includes(response.status))
-            throw new ChallengeError('Evri UK', 'Evri UK refused the tracking API key');
-        let payload;
-        try {
-            payload = JSON.parse(decodeText(bytes));
-        }
-        catch {
-            payload = undefined;
-        }
-        // The service reports a reference it rejects as JSON; a bare status is the endpoint's.
-        if (response.status !== 200 && !(isRecord(payload) && Array.isArray(payload.errors) && payload.errors.length)) {
-            if ([404, 410].includes(response.status))
-                throw new TransportError('Evri UK', 'Evri UK tracking API is unavailable', { status: response.status });
-            throw new UpstreamHttpError('Evri UK', response.status);
-        }
-        if (response.status === 200 && payload === undefined)
-            throw new SchemaError('Evri UK', 'Evri UK returned invalid tracking data');
-        return { status: response.status, payload };
-    };
-    try {
-        const reference = await read(new URL(`${EVRI_UK_MOBILE_API}/parcels/reference/${number}`));
+    return guarded(options, async () => {
+        const reference = await request(new URL(`${EVRI_UK_MOBILE_API}/parcels/reference/${number}`), options, deadline);
         if (reference.status !== 200)
             unconfirmed();
-        const identifiers = isRecord(reference.payload) ? reference.payload.parcelIdentifiers : undefined;
-        if (!Array.isArray(identifiers) || identifiers.length > 50)
-            throw new SchemaError('Evri UK', 'Evri UK returned invalid parcel identifiers');
+        const identifiers = identifiersOf(reference.payload);
         // Several parcels or an international redirect do not settle one domestic parcel.
         const identifier = identifiers.length === 1 ? identifiers[0] : undefined;
         if (identifiers.length !== 1 || (isRecord(identifier) && identifier.redirectUrl))
             unconfirmed();
-        const urn = isRecord(identifier) ? identifier.urn : undefined;
-        if (typeof urn !== 'string' || !new RegExp(`^urn:parcel_id:barcode:date:\\d{1,30}:${number}:\\d{4}-\\d{2}-\\d{2}$`).test(urn)) {
-            throw new SchemaError('Evri UK', 'Evri UK did not return the requested parcel');
-        }
+        const urn = boundUrn(identifier, number);
         const endpoint = new URL(`${EVRI_UK_MOBILE_API}/parcels/`);
         endpoint.searchParams.set('uniqueIds', urn);
-        const history = await read(endpoint);
+        const history = await request(endpoint, options, deadline);
         if (history.status !== 200)
             unconfirmed();
         try {
@@ -67,15 +90,32 @@ export async function readEvriUkMobile(raw, options) {
                 unconfirmed();
             throw error;
         }
-    }
-    catch (error) {
-        options.signal.throwIfAborted();
-        // Transport diagnostics include the key, the barcode and recipient fields.
-        // Preserve the failure contract without forwarding request or body data.
-        if (error instanceof CarrierError)
-            throw new CarrierError(error.kind, 'Evri UK', `Evri UK tracking failed (${error.kind})`, {
-                status: error.status, retryAfterMs: error.retryAfterMs, reason: error.reason,
-            });
-        throw new TransportError('Evri UK', 'Evri UK tracking API request failed');
-    }
+    });
+}
+/**
+ * Whether Evri UK holds the barcode, from the reference lookup tracking starts
+ * with. No parcel and a barcode the service rejects for its check digit are
+ * unknown, and so is a parcel it redirects to Evri International's tracker.
+ */
+export function recognizeEvriUkMobile(raw, options) {
+    const number = normalizeEvriUkNumber(raw);
+    const deadline = performance.now() + options.timeoutMs;
+    return guarded(options, async () => {
+        const reference = await request(new URL(`${EVRI_UK_MOBILE_API}/parcels/reference/${number}`), options, deadline);
+        if (reference.status !== 200) {
+            const errors = isRecord(reference.payload) && Array.isArray(reference.payload.errors) ? reference.payload.errors : [];
+            if (reference.status === 400 && errors.length === 1 && isRecord(errors[0]) && errors[0].errorType === 'InvalidReferenceException')
+                return { known: false };
+            throw new IndeterminateError('Evri UK', 'Evri UK could not say whether it holds the parcel');
+        }
+        const identifiers = identifiersOf(reference.payload);
+        if (!identifiers.length)
+            return { known: false };
+        if (identifiers.length > 1)
+            throw new IndeterminateError('Evri UK', 'Evri UK holds several parcels under the barcode');
+        if (isRecord(identifiers[0]) && identifiers[0].redirectUrl)
+            return { known: false };
+        boundUrn(identifiers[0], number);
+        return { known: true, lastActivityAt: null };
+    });
 }

package/dist/carriers/intelcom/carrier.json

@@ -4,7 +4,8 @@
   "aliases": [
     "Intelcom",
     "Dragonfly",
-    "Dragonfly Shipping"
+    "Dragonfly Shipping",
+    "Intelcom Express"
   ],
   "region": {
     "countries": [

package/dist/carriers/korea-post/carrier.json

@@ -1,7 +1,9 @@
 {
   "id": "korea-post",
   "displayName": "Korea Post",
-  "aliases": [],
+  "aliases": [
+    "South Korea Post"
+  ],
   "region": {
     "countries": [
       "KR"

package/dist/carriers/nz-post/carrier.json

@@ -1,7 +1,9 @@
 {
   "id": "nz-post",
   "displayName": "NZ Post",
-  "aliases": [],
+  "aliases": [
+    "New Zealand Post"
+  ],
   "region": {
     "countries": [
       "NZ"

package/dist/carriers/planzer/carrier.json

@@ -2,7 +2,8 @@
   "id": "planzer",
   "displayName": "Planzer",
   "aliases": [
-    "Planzer Group"
+    "Planzer Group",
+    "Planzer Parcel"
   ],
   "region": {
     "countries": [

package/dist/carriers/poczta-polska/carrier.json

@@ -1,7 +1,11 @@
 {
   "id": "poczta-polska",
   "displayName": "Poczta Polska",
-  "aliases": [],
+  "aliases": [
+    "Polish Post",
+    "Poland Post",
+    "Pocztex"
+  ],
   "region": {
     "countries": [
       "PL"

package/dist/carriers/postnord/carrier.json

@@ -1,7 +1,10 @@
 {
   "id": "postnord",
   "displayName": "PostNord",
-  "aliases": [],
+  "aliases": [
+    "PostNord Danmark",
+    "PostNord Denmark"
+  ],
   "region": {
     "countries": [
       "SE",

package/dist/carriers/yanwen/carrier.json

@@ -1,7 +1,9 @@
 {
   "id": "yanwen",
   "displayName": "Yanwen",
-  "aliases": [],
+  "aliases": [
+    "Yanwen Logistics"
+  ],
   "region": {
     "countries": [
       "CN"

package/dist/data/catalog.json

@@ -126,7 +126,8 @@
         "displayName": "Planzer",
         "color": "#e30613",
         "aliases": [
-            "Planzer Group"
+            "Planzer Group",
+            "Planzer Parcel"
         ],
         "countries": [
             "CH"
@@ -774,7 +775,9 @@
         "color": "#ff9900",
         "aliases": [
             "Shipping with Amazon",
-            "SWA"
+            "SWA",
+            "Amazon Swiship",
+            "Swiship"
         ],
         "countries": [
             "FR",
@@ -2121,6 +2124,7 @@
             "mode": "automatic",
             "adapter": "evri",
             "upstreamName": "Evri International",
+            "recognitionRank": 605,
             "localClocks": true
         },
         "canaryUrl": "https://globaleco.app/track/",
@@ -2300,6 +2304,10 @@
     "postnord": {
         "displayName": "PostNord",
         "color": "#00a0d6",
+        "aliases": [
+            "PostNord Danmark",
+            "PostNord Denmark"
+        ],
         "countries": [
             "SE",
             "DK",
@@ -3617,6 +3625,9 @@
     "nz-post": {
         "displayName": "NZ Post",
         "color": "#d8291c",
+        "aliases": [
+            "New Zealand Post"
+        ],
         "countries": [
             "NZ"
         ],
@@ -3997,6 +4008,9 @@
     "korea-post": {
         "displayName": "Korea Post",
         "color": "#da291c",
+        "aliases": [
+            "South Korea Post"
+        ],
         "countries": [
             "KR"
         ],
@@ -4390,6 +4404,11 @@
     "poczta-polska": {
         "displayName": "Poczta Polska",
         "color": "#c43c2b",
+        "aliases": [
+            "Polish Post",
+            "Poland Post",
+            "Pocztex"
+        ],
         "countries": [
             "PL"
         ],
@@ -4442,7 +4461,8 @@
         "color": "#56b529",
         "aliases": [
             "Posten Norge",
-            "Posten Bring"
+            "Posten Bring",
+            "Norway Post"
         ],
         "countries": [
             "NO",
@@ -4636,6 +4656,9 @@
     "yanwen": {
         "displayName": "Yanwen",
         "color": "#8cbe1e",
+        "aliases": [
+            "Yanwen Logistics"
+        ],
         "countries": [
             "CN"
         ],
@@ -10527,7 +10550,9 @@
         "timezone": "Europe/London",
         "tracking": {
             "mode": "automatic",
-            "adapter": "evri-uk"
+            "adapter": "evri-uk",
+            "recognitionRank": 615,
+            "recognitionPattern": "^(?:[HT][0-9A-Z]{5}|C00HHA)\\d{10}$"
         },
         "canaryUrl": "https://www.evri.com/track-a-parcel",
         "trackingUrlTemplate": "https://www.evri.com/track/parcel/{trackingNumber}/details",
@@ -12651,7 +12676,8 @@
         "aliases": [
             "Intelcom",
             "Dragonfly",
-            "Dragonfly Shipping"
+            "Dragonfly Shipping",
+            "Intelcom Express"
         ],
         "countries": [
             "CA"

package/dist/generated/catalog.d.ts

@@ -83,7 +83,7 @@ export declare const CARRIER_CATALOG: {
     readonly planzer: {
         readonly displayName: "Planzer";
         readonly color: "#e30613";
-        readonly aliases: readonly ["Planzer Group"];
+        readonly aliases: readonly ["Planzer Group", "Planzer Parcel"];
         readonly countries: readonly ["CH"];
         readonly selectable: true;
         readonly timezone: "Europe/Zurich";
@@ -492,7 +492,7 @@ export declare const CARRIER_CATALOG: {
     readonly "amazon-shipping": {
         readonly displayName: "Amazon Shipping";
         readonly color: "#ff9900";
-        readonly aliases: readonly ["Shipping with Amazon", "SWA"];
+        readonly aliases: readonly ["Shipping with Amazon", "SWA", "Amazon Swiship", "Swiship"];
         readonly countries: readonly ["FR", "DE", "BE", "GB", "IT", "ES", "NL", "AT", "IE", "PL", "SE", "PT", "LU", "DK", "FI", "CZ", "SK", "HU", "RO", "BG", "HR", "SI", "EE", "LV", "LT", "GR", "CY", "MT", "CH", "NO", "IS", "LI", "TR", "US"];
         readonly selectable: false;
         readonly timezone: "UTC";
@@ -1404,6 +1404,7 @@ export declare const CARRIER_CATALOG: {
             readonly mode: "automatic";
             readonly adapter: "evri";
             readonly upstreamName: "Evri International";
+            readonly recognitionRank: 605;
             readonly localClocks: true;
         };
         readonly canaryUrl: "https://globaleco.app/track/";
@@ -1539,6 +1540,7 @@ export declare const CARRIER_CATALOG: {
     readonly postnord: {
         readonly displayName: "PostNord";
         readonly color: "#00a0d6";
+        readonly aliases: readonly ["PostNord Danmark", "PostNord Denmark"];
         readonly countries: readonly ["SE", "DK", "NO", "FI"];
         readonly selectable: true;
         readonly timezone: "UTC";
@@ -2474,6 +2476,7 @@ export declare const CARRIER_CATALOG: {
     readonly "nz-post": {
         readonly displayName: "NZ Post";
         readonly color: "#d8291c";
+        readonly aliases: readonly ["New Zealand Post"];
         readonly countries: readonly ["NZ"];
         readonly selectable: true;
         readonly timezone: "UTC";
@@ -2748,6 +2751,7 @@ export declare const CARRIER_CATALOG: {
     readonly "korea-post": {
         readonly displayName: "Korea Post";
         readonly color: "#da291c";
+        readonly aliases: readonly ["South Korea Post"];
         readonly countries: readonly ["KR"];
         readonly selectable: true;
         readonly timezone: "UTC";
@@ -3017,6 +3021,7 @@ export declare const CARRIER_CATALOG: {
     readonly "poczta-polska": {
         readonly displayName: "Poczta Polska";
         readonly color: "#c43c2b";
+        readonly aliases: readonly ["Polish Post", "Poland Post", "Pocztex"];
         readonly countries: readonly ["PL"];
         readonly selectable: true;
         readonly timezone: "UTC";
@@ -3054,7 +3059,7 @@ export declare const CARRIER_CATALOG: {
     readonly "bring-posten": {
         readonly displayName: "Bring";
         readonly color: "#56b529";
-        readonly aliases: readonly ["Posten Norge", "Posten Bring"];
+        readonly aliases: readonly ["Posten Norge", "Posten Bring", "Norway Post"];
         readonly countries: readonly ["NO", "SE", "DK", "FI"];
         readonly selectable: true;
         readonly timezone: "UTC";
@@ -3184,6 +3189,7 @@ export declare const CARRIER_CATALOG: {
     readonly yanwen: {
         readonly displayName: "Yanwen";
         readonly color: "#8cbe1e";
+        readonly aliases: readonly ["Yanwen Logistics"];
         readonly countries: readonly ["CN"];
         readonly selectable: true;
         readonly timezone: "UTC";
@@ -6856,6 +6862,8 @@ export declare const CARRIER_CATALOG: {
         readonly tracking: {
             readonly mode: "automatic";
             readonly adapter: "evri-uk";
+            readonly recognitionRank: 615;
+            readonly recognitionPattern: "^(?:[HT][0-9A-Z]{5}|C00HHA)\\d{10}$";
         };
         readonly canaryUrl: "https://www.evri.com/track-a-parcel";
         readonly trackingUrlTemplate: "https://www.evri.com/track/parcel/{trackingNumber}/details";
@@ -8196,7 +8204,7 @@ export declare const CARRIER_CATALOG: {
     readonly intelcom: {
         readonly displayName: "Intelcom / Dragonfly";
         readonly color: "#13a58f";
-        readonly aliases: readonly ["Intelcom", "Dragonfly", "Dragonfly Shipping"];
+        readonly aliases: readonly ["Intelcom", "Dragonfly", "Dragonfly Shipping", "Intelcom Express"];
         readonly countries: readonly ["CA"];
         readonly selectable: true;
         readonly timezone: "UTC";

package/dist/generated/catalog.js

@@ -127,7 +127,8 @@ export const CARRIER_CATALOG = {
         "displayName": "Planzer",
         "color": "#e30613",
         "aliases": [
-            "Planzer Group"
+            "Planzer Group",
+            "Planzer Parcel"
         ],
         "countries": [
             "CH"
@@ -775,7 +776,9 @@ export const CARRIER_CATALOG = {
         "color": "#ff9900",
         "aliases": [
             "Shipping with Amazon",
-            "SWA"
+            "SWA",
+            "Amazon Swiship",
+            "Swiship"
         ],
         "countries": [
             "FR",
@@ -2122,6 +2125,7 @@ export const CARRIER_CATALOG = {
             "mode": "automatic",
             "adapter": "evri",
             "upstreamName": "Evri International",
+            "recognitionRank": 605,
             "localClocks": true
         },
         "canaryUrl": "https://globaleco.app/track/",
@@ -2301,6 +2305,10 @@ export const CARRIER_CATALOG = {
     "postnord": {
         "displayName": "PostNord",
         "color": "#00a0d6",
+        "aliases": [
+            "PostNord Danmark",
+            "PostNord Denmark"
+        ],
         "countries": [
             "SE",
             "DK",
@@ -3618,6 +3626,9 @@ export const CARRIER_CATALOG = {
     "nz-post": {
         "displayName": "NZ Post",
         "color": "#d8291c",
+        "aliases": [
+            "New Zealand Post"
+        ],
         "countries": [
             "NZ"
         ],
@@ -3998,6 +4009,9 @@ export const CARRIER_CATALOG = {
     "korea-post": {
         "displayName": "Korea Post",
         "color": "#da291c",
+        "aliases": [
+            "South Korea Post"
+        ],
         "countries": [
             "KR"
         ],
@@ -4391,6 +4405,11 @@ export const CARRIER_CATALOG = {
     "poczta-polska": {
         "displayName": "Poczta Polska",
         "color": "#c43c2b",
+        "aliases": [
+            "Polish Post",
+            "Poland Post",
+            "Pocztex"
+        ],
         "countries": [
             "PL"
         ],
@@ -4443,7 +4462,8 @@ export const CARRIER_CATALOG = {
         "color": "#56b529",
         "aliases": [
             "Posten Norge",
-            "Posten Bring"
+            "Posten Bring",
+            "Norway Post"
         ],
         "countries": [
             "NO",
@@ -4637,6 +4657,9 @@ export const CARRIER_CATALOG = {
     "yanwen": {
         "displayName": "Yanwen",
         "color": "#8cbe1e",
+        "aliases": [
+            "Yanwen Logistics"
+        ],
         "countries": [
             "CN"
         ],
@@ -10528,7 +10551,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/London",
         "tracking": {
             "mode": "automatic",
-            "adapter": "evri-uk"
+            "adapter": "evri-uk",
+            "recognitionRank": 615,
+            "recognitionPattern": "^(?:[HT][0-9A-Z]{5}|C00HHA)\\d{10}$"
         },
         "canaryUrl": "https://www.evri.com/track-a-parcel",
         "trackingUrlTemplate": "https://www.evri.com/track/parcel/{trackingNumber}/details",
@@ -12652,7 +12677,8 @@ export const CARRIER_CATALOG = {
         "aliases": [
             "Intelcom",
             "Dragonfly",
-            "Dragonfly Shipping"
+            "Dragonfly Shipping",
+            "Intelcom Express"
         ],
         "countries": [
             "CA"

package/dist/generated/recognition.js

@@ -80,6 +80,8 @@ export const CARRIER_RECOGNITION_RANKS = {
     "envialia": 260,
     "epost-global": 65,
     "estes": 20,
+    "evri": 605,
+    "evri-uk": 615,
     "express-one": 190,
     "fan-courier": 330,
     "four-px": 570,

package/dist/server/openapi.json

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

package/package.json

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