universal-parcel-scraper 0.121.0-main.1069 → 0.122.0-main.1072

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 **180 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **181 dedicated adapters** and **5 universal fallbacks**
 
 <sub>208 catalog entries · 66 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 5,319 such statuses, each filed under one stage.
+The carrier folders record 5,331 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

@@ -6141,15 +6141,33 @@
     "timezone": "America/Los_Angeles",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "epost-global",
+      "recognitionRank": 65,
+      "localClocks": true
     },
     "canaryUrl": "https://epgtrack.com/",
-    "trackingUrlTemplate": "https://epgtrack.com/",
+    "trackingUrlTemplate": "https://epgtrack.com/{trackingNumber}",
     "trackingSearchUrl": "https://epgtrack.com/",
-    "linkRules": [],
+    "linkRules": [
+      {
+        "domains": [
+          "epgtrack.com"
+        ],
+        "path": "^/(EPG\\d{10,15})/?$"
+      },
+      {
+        "domains": [
+          "epgtrack.com"
+        ],
+        "pathPattern": "^/$",
+        "params": [
+          "id"
+        ]
+      }
+    ],
     "detectionRules": [
       {
-        "pattern": "^EPG\\d{10,13}$",
+        "pattern": "^EPG\\d{10,15}$",
         "confidence": "high"
       }
     ]

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -28358,6 +28358,46 @@
       "epost-global"
     ]
   },
+  {
+    "input": "EPG011023513021511",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG011024032660913",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG011024033241487",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG011024034506837",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG011113700050012",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
   {
     "input": "EPG0112300001175",
     "carrier": "epost-global",
@@ -28374,6 +28414,38 @@
       "epost-global"
     ]
   },
+  {
+    "input": "EPG030878223676213",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG050927120007542",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG071024031554244",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG071101400605458",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
   {
     "input": "EPG10223001274",
     "carrier": "epost-global",
@@ -28382,6 +28454,30 @@
       "epost-global"
     ]
   },
+  {
+    "input": "EPG141034707026058",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG161034705036758",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
+  {
+    "input": "EPG250969101591620",
+    "carrier": "epost-global",
+    "confidence": "high",
+    "candidates": [
+      "epost-global"
+    ]
+  },
   {
     "input": "ERA907538712MY",
     "carrier": "pos-malaysia",

package/dist/browser/scraper.js

@@ -4942,14 +4942,23 @@ var De = {
 		timezone: "America/Los_Angeles",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "epost-global",
+			recognitionRank: 65,
+			localClocks: !0
 		},
 		canaryUrl: "https://epgtrack.com/",
-		trackingUrlTemplate: "https://epgtrack.com/",
+		trackingUrlTemplate: "https://epgtrack.com/{trackingNumber}",
 		trackingSearchUrl: "https://epgtrack.com/",
-		linkRules: [],
+		linkRules: [{
+			domains: ["epgtrack.com"],
+			path: "^/(EPG\\d{10,15})/?$"
+		}, {
+			domains: ["epgtrack.com"],
+			pathPattern: "^/$",
+			params: ["id"]
+		}],
 		detectionRules: [{
-			pattern: "^EPG\\d{10,13}$",
+			pattern: "^EPG\\d{10,15}$",
 			confidence: "high"
 		}]
 	},
@@ -12351,6 +12360,7 @@ var Qc = {
 	elta: 150,
 	emile: 480,
 	envialia: 260,
+	"epost-global": 65,
 	"express-one": 190,
 	"fan-courier": 330,
 	"four-px": 570,

package/dist/carriers/epost-global/adapter.d.ts

@@ -0,0 +1,15 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+/** The action the tracking page posts its numbers to. */
+export declare const EPOST_GLOBAL_ENDPOINT = "https://epgtrack.com/TrackingShipment/ShipmentData";
+export declare class EpostGlobalTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/epost-global/adapter.js

@@ -0,0 +1,38 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { EPOST_GLOBAL_MAX_BYTES, normalizeEpostGlobalNumber, parseEpostGlobal, PROVIDER } from './parser.js';
+/** The action the tracking page posts its numbers to. */
+export const EPOST_GLOBAL_ENDPOINT = 'https://epgtrack.com/TrackingShipment/ShipmentData';
+export class EpostGlobalTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeEpostGlobalNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { bytes } = await fetchBounded(EPOST_GLOBAL_ENDPOINT, { method: 'POST', signal, headers: {
+                    Accept: 'text/html, */*; q=0.01', 'User-Agent': userAgentOf(this.options.userAgent), 'X-Requested-With': 'XMLHttpRequest',
+                }, body: new URLSearchParams({ id: number }) }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: EPOST_GLOBAL_MAX_BYTES, fetcher: this.options.fetcher });
+            return parseEpostGlobal(decodeText(bytes), raw);
+        };
+        // A request that fails to reach the site, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'epost-global', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => read(signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => read(signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new EpostGlobalTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'epost-global', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeEpostGlobalNumber(number))),
+    };
+};

package/dist/carriers/epost-global/carrier.json

@@ -17,24 +17,85 @@
   "timezone": "America/Los_Angeles",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "epost-global",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 65
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "destination_country",
+    "delivery_partner",
+    "delivery_tracking_number"
+  ],
   "portal": {
-    "url": "https://epgtrack.com/",
+    "url": "https://epgtrack.com/{trackingNumber}",
     "searchUrl": "https://epgtrack.com/",
     "canaryUrl": "https://epgtrack.com/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "progress_rail",
+      "destination_country",
+      "postcodes",
+      "related_awb_numbers",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "offset_timestamps",
+      "destination_country",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "discarded": [
+      "progress_rail",
+      "postcodes",
+      "related_awb_numbers"
+    ],
+    "unavailable": [
+      "eta",
+      "delivered_at",
+      "weight",
+      "service_name",
+      "sender_name",
+      "recipient_name",
+      "proof_of_delivery"
+    ]
   },
-  "links": [],
+  "links": [
+    {
+      "domains": [
+        "epgtrack.com"
+      ],
+      "path": "^/(EPG\\d{10,15})/?$"
+    },
+    {
+      "domains": [
+        "epgtrack.com"
+      ],
+      "pathPattern": "^/$",
+      "params": [
+        "id"
+      ]
+    }
+  ],
   "detection": [
     {
       "id": "epost-global-1",
-      "pattern": "^EPG\\d{10,13}$",
+      "pattern": "^EPG\\d{10,15}$",
       "confidence": "high"
     }
   ]

package/dist/carriers/epost-global/numbers.json

@@ -289,6 +289,234 @@
         "confidence": "high"
       },
       "note": "An Amazon seller's forum post lists it among ePost Global numbers rejected by Amazon's carrier-code check."
+    },
+    {
+      "number": "EPG011113700050012",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260924140354/https://epgtrack.com/?id=EPG011113700050012",
+        "date": "2026-09-24",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG011024034506837",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260929124903/https://epgtrack.com/EPG011024034506837",
+        "date": "2026-09-29",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG071101400605458",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260901114745/https://epgtrack.com/?id=EPG071101400605458",
+        "date": "2026-09-01",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG011023513021511",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260813121523/https://epgtrack.com/?id=EPG011023513021511",
+        "date": "2026-08-13",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG071024031554244",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260801221733/https://epgtrack.com/EPG071024031554244",
+        "date": "2026-08-01",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG011024033241487",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260905144617/https://epgtrack.com/EPG011024033241487",
+        "date": "2026-09-05",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG011024032660913",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260825230629/https://epgtrack.com/EPG011024032660913",
+        "date": "2026-08-25",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened. ePost Global's tracker knows it."
+    },
+    {
+      "number": "EPG030878223676213",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20240713081303/https://epgtrack.com/EPG030878223676213",
+        "date": "2024-07-13",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened."
+    },
+    {
+      "number": "EPG050927120007542",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20230127065102/https://epgtrack.com/EPG050927120007542",
+        "date": "2023-01-27",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened."
+    },
+    {
+      "number": "EPG141034707026058",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20250126060413/https://epgtrack.com/EPG141034707026058",
+        "date": "2025-01-26",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened."
+    },
+    {
+      "number": "EPG161034705036758",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20240811023147/https://epgtrack.com/EPG161034705036758",
+        "date": "2024-08-11",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened."
+    },
+    {
+      "number": "EPG250969101591620",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20231206193211/https://epgtrack.com/?id=EPG250969101591620",
+        "date": "2023-12-06",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "epost-global",
+        "confidence": "high"
+      },
+      "note": "Looked up on ePost Global's own tracker, as an archived address shows; the capture was not opened."
     }
   ]
 }

package/dist/carriers/epost-global/parser.d.ts

@@ -0,0 +1,14 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "ePost Global";
+export declare const EPOST_GLOBAL_MAX_BYTES: number;
+/** An ePost Global number; anything else is a number the tracker is not asked for. */
+export declare function normalizeEpostGlobalNumber(raw: string): string;
+/**
+ * The HTML fragment `POST /TrackingShipment/ShipmentData` answers: one card
+ * per number asked, whose click handler carries the shipment's details as
+ * JSON. The tracker also finds a shipment by its partner's number, so the
+ * details count only when their own number is the one asked for. The
+ * recipient's postcode, the scans' ZIP codes, the master air waybill and the
+ * customer reference are never read.
+ */
+export declare function parseEpostGlobal(html: string, raw: string): CarrierResult;

package/dist/carriers/epost-global/parser.js

@@ -0,0 +1,212 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { carrierIdFromName, carrierIdFromPartner } from '../../core/catalog/hints.js';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { USPS_ROUTING_BARCODE, uspsPackageIdentifier } from '../../core/detection/usps.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { firstOccurrence, usStateTimeZone } from '../../core/time/index.js';
+import { cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { epostGlobalFacilityScan, epostGlobalStage } from './status.js';
+export const PROVIDER = 'ePost Global';
+// A delivered parcel's reply is up to a hundred kilobytes: its history twice,
+// as data and as rendered rows.
+export const EPOST_GLOBAL_MAX_BYTES = 1024 * 1024;
+// EPG and ten to fifteen digits; current labels print fifteen.
+const NUMBER = /^EPG\d{10,15}$/;
+// The page's call that shows a card's details: its scans, the card's index,
+// the number asked, the partner's number and the shipment's details.
+const CALL = /^transactionDetails\('(.*?)','(\d+)','([^']*)', '([^']*)', '(.*)'\)$/s;
+// The tracker's notice on the card of a number it has no shipment for.
+const NOT_TRACKED = /We haven.t received any tracking updates/;
+// A browser check, which the site has not been seen to send.
+const CHALLENGE = /captcha|cf-turnstile|_cf_chl_opt|<title>\s*(?:Just a moment|Attention Required)/i;
+const WALL_CLOCK = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})(?:\.\d{1,7})?$/;
+// A processing center's place: its town and state ("Itasca IL").
+const FACILITY = /^[A-Za-z][A-Za-z .'-]{0,60} ([A-Z]{2})$/;
+// States split between zones, where the state does not tell the clock.
+const SPLIT_STATES = new Set(['AK', 'FL', 'ID', 'IN', 'KS', 'KY', 'MI', 'ND', 'NE', 'NV', 'OR', 'SD', 'TN', 'TX']);
+// Partners whose names the catalog does not know. Spring's PostNL service is
+// tracked by spring-gds under the same number.
+const VENDORS = new Map([['SPRING POST NL', 'spring-gds']]);
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+/** An ePost Global number; anything else is a number the tracker is not asked for. */
+export function normalizeEpostGlobalNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'ePost Global numbers are EPG and ten to fifteen digits');
+    return number;
+}
+/** An optional text field; an object or array is a changed reply. */
+function text(row, key, maxLength = 500) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string' && typeof value !== 'number')
+        throw new SchemaError(PROVIDER, `ePost Global returned an invalid ${key}`);
+    return cleanScalar(value, maxLength);
+}
+/**
+ * A scan's place up to its first word holding a digit, where partners put a
+ * postcode, a depot number or a street address. A dash is no place, and a
+ * country named twice is named once.
+ */
+function placeOf(raw) {
+    const words = [];
+    for (const word of raw.split(' ')) {
+        if (/\d/.test(word))
+            break;
+        words.push(word);
+    }
+    const parts = words.join(' ').split(',').map((part) => part.trim()).filter(Boolean);
+    const place = parts.filter((part, index) => part !== parts[index - 1]).join(', ');
+    return /^[-.\s]*$/.test(place) ? '' : place;
+}
+/** The zone of a processing center's scan: the clock of the center's state. */
+function facilityZone(description, place) {
+    if (!epostGlobalFacilityScan(description))
+        return null;
+    const state = FACILITY.exec(place)?.[1];
+    return state && !SPLIT_STATES.has(state) ? usStateTimeZone(state) : null;
+}
+/** A scan's clock: an instant in the center's zone, else the wall clock as stamped. */
+function clockOf(stamp, zone) {
+    const wall = WALL_CLOCK.exec(stamp)?.[1];
+    if (!wall || !DateTime.fromISO(wall, { zone: 'utc' }).isValid) {
+        throw new SchemaError(PROVIDER, 'ePost Global returned an invalid scan time');
+    }
+    if (!zone)
+        return { local_time: wall };
+    const time = firstOccurrence(DateTime.fromISO(wall, { zone })).toISO({ suppressMilliseconds: true });
+    if (!time)
+        throw new SchemaError(PROVIDER, 'ePost Global returned an invalid scan time');
+    return { time };
+}
+function projectScan(row) {
+    if (!isRecord(row))
+        throw new SchemaError(PROVIDER, 'ePost Global returned an invalid scan');
+    const description = text(row, 'Event');
+    if (!description)
+        return null;
+    const stamp = text(row, 'EventDT', 64);
+    const place = placeOf(text(row, 'Loc', 200));
+    const code = text(row, 'ECode', 32);
+    const staged = epostGlobalStage(description);
+    const event = {
+        ...clockOf(stamp, facilityZone(description, place)),
+        description,
+        ...(place ? { location: place } : {}),
+        ...(code ? { provider_code: code } : {}),
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+    return { key: JSON.stringify([stamp, description, place, code]), event };
+}
+/** The delivering partner: one the catalog knows by name, whose link, if any, is its own. */
+function deliveryPartner(vendor, url) {
+    const mapped = VENDORS.get(vendor.toUpperCase());
+    if (mapped)
+        return mapped;
+    const named = vendor ? carrierIdFromName(vendor) : undefined;
+    return named && named !== 'epost-global' && carrierIdFromPartner(vendor, url) === named ? named : undefined;
+}
+/** The partner's number, without the recipient's ZIP code a USPS routing barcode opens with. */
+function partnerNumber(raw, number) {
+    const compact = normalizeTrackingNumber(raw);
+    const code = USPS_ROUTING_BARCODE.test(compact) ? uspsPackageIdentifier(compact) ?? '' : compact;
+    return /^[A-Z0-9]{4,40}$/.test(code) && code !== number ? code : undefined;
+}
+/**
+ * The HTML fragment `POST /TrackingShipment/ShipmentData` answers: one card
+ * per number asked, whose click handler carries the shipment's details as
+ * JSON. The tracker also finds a shipment by its partner's number, so the
+ * details count only when their own number is the one asked for. The
+ * recipient's postcode, the scans' ZIP codes, the master air waybill and the
+ * customer reference are never read.
+ */
+export function parseEpostGlobal(html, raw) {
+    const number = normalizeEpostGlobalNumber(raw);
+    const $ = load(html);
+    const cards = $('div[id^="tracking-card"]');
+    if (!cards.length) {
+        if (CHALLENGE.test(html))
+            throw new ChallengeError(PROVIDER, 'ePost Global answered with a browser check');
+        throw new SchemaError(PROVIDER, 'ePost Global returned a page without a shipment card');
+    }
+    if (cards.length > 1)
+        throw new SchemaError(PROVIDER, 'ePost Global returned several shipments');
+    const call = CALL.exec(cards.attr('onclick') ?? '');
+    if (!call)
+        throw new SchemaError(PROVIDER, 'ePost Global returned a card without its details');
+    if (normalizeTrackingNumber(call[3]) !== number)
+        throw new SchemaError(PROVIDER, 'ePost Global answered for another number');
+    if (!call[5]) {
+        if (NOT_TRACKED.test(cards.text()))
+            throw new NotFoundError(PROVIDER);
+        throw new IndeterminateError(PROVIDER, 'ePost Global returned a card without details');
+    }
+    let details;
+    try {
+        details = JSON.parse(call[5]);
+    }
+    catch (cause) {
+        throw new SchemaError(PROVIDER, 'ePost Global returned details that are not JSON', { cause });
+    }
+    if (!isRecord(details))
+        throw new SchemaError(PROVIDER, 'ePost Global returned invalid details');
+    const track = normalizeTrackingNumber(text(details, 'Track', 64));
+    if (normalizeTrackingNumber(text(details, 'Ref', 64)) !== number) {
+        // Found by another number of the shipment: its partner's, which is not ePost Global's own.
+        if (track === number)
+            throw new IndeterminateError(PROVIDER, 'ePost Global found another shipment by its partner number');
+        throw new SchemaError(PROVIDER, 'ePost Global returned another shipment');
+    }
+    const rows = details.Events;
+    if (!Array.isArray(rows))
+        throw new SchemaError(PROVIDER, 'ePost Global returned a shipment without scans');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'ePost Global returned an oversized history');
+    const seen = new Set();
+    const events = [];
+    for (const row of rows) {
+        const scan = projectScan(row);
+        if (!scan || seen.has(scan.key))
+            continue;
+        seen.add(scan.key);
+        events.push(scan.event);
+    }
+    if (!events.length)
+        throw new IndeterminateError(PROVIDER, 'ePost Global has no scans for the shipment yet');
+    // The reply lists scans newest first by their stamps. Partner clocks are not
+    // instants, so its order stands. A receipt after the parcel moved on is the
+    // partner's, not its acceptance.
+    let moved = false;
+    for (const event of [...events].reverse()) {
+        const stage = event.stage;
+        if (stage === 'accepted' && moved)
+            Object.assign(event, { stage: 'in_transit', stage_source: 'carrier_map' });
+        if (stage && !['registered', 'accepted', 'exception'].includes(stage))
+            moved = true;
+    }
+    const newest = events[0];
+    // A partner's announcement after ePost Global shipped the parcel is no step back.
+    const current = events.find((event) => event.stage && event.stage !== 'registered') ?? events.find((event) => event.stage);
+    const stage = current?.stage;
+    const partner = deliveryPartner(text(details, 'Vendor', 80), text(details, 'VendorTrackingUrl', 500) || text(details, 'VendorBaseUrl', 500));
+    const delivery = partnerNumber(track, number);
+    const country = text(details, 'DC', 8).toUpperCase();
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time ?? null,
+        ...(newest.local_time ? { last_update_local: newest.local_time } : {}),
+        expected_delivery: null,
+        ...(partner ? { delivery_carrier: partner } : {}),
+        ...(delivery ? { delivery_tracking_number: delivery } : {}),
+        ...(/^[A-Z]{2}$/.test(country) ? { destination_country: country } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/epost-global/status.d.ts

@@ -0,0 +1,13 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives the wording, if it knows it. */
+export declare function epostGlobalScanStage(wording: string): Stage | undefined;
+/** A scan at one of ePost Global's processing centers. */
+export declare function epostGlobalFacilityScan(wording: string): boolean;
+/**
+ * A scan's stage from the map, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export declare function epostGlobalStage(wording: string): ClassifiedWording | null;
+/** Codes are shared with the partners' own, so only the wording is read. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/epost-global/status.js

@@ -0,0 +1,55 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * ePost Global's English wording. Its rows carry a code, but rows it relays
+ * from the partner that delivers the parcel keep the partner's code, so a code
+ * alone names no scan: PostNL's 30 is ePost Global's 30. The map reads the
+ * wording: ePost Global's own, then the partners' that the shared wording
+ * rules leave without a stage. Other partner wording goes to those rules.
+ */
+const STAGES = new Map([
+    ['data received', 'registered'],
+    // Stamped a minute after the data, every time: the label, not a scan.
+    ['shipment in transit to the epost global processing center', 'registered'],
+    ['parcel received and processing', 'accepted'],
+    ['parcel shipped', 'in_transit'],
+    // DAI Post, for New Zealand: its manifest, then its origin hub and the airline.
+    ['customer information manifested', 'registered'],
+    ['checked in at origin hub', 'in_transit'],
+    ['airline delay', 'in_transit'],
+    ['collected from the airline for processing', 'in_transit'],
+    // PostNL, through Spring.
+    ['the item is tied to a mawb and ready for shipment', 'in_transit'],
+    // La Poste's wording for parcels PostNL brings to France, after they left the United States.
+    ['your item has been dropped off by the sender with our postal partner in the country of origin.', 'in_transit'],
+    ['your item is ready to be forwarded from its foreign territory. it will be given to the carrier for forwarding.', 'in_transit'],
+]);
+// The handover a minute after shipping: "In transit to {service} tracking #: {number}".
+const HANDED_OVER = /^in transit (?:to|via) \S.* tracking ?#:/;
+// The rows ePost Global's processing centers scan, stamped on the center's clock.
+const FACILITY_SCANS = new Set(['parcel received and processing', 'parcel shipped']);
+/** The stage the map gives the wording, if it knows it. */
+export function epostGlobalScanStage(wording) {
+    const normalized = normalizeStatusWording(wording);
+    return HANDED_OVER.test(normalized) ? 'in_transit' : STAGES.get(normalized);
+}
+/** A scan at one of ePost Global's processing centers. */
+export function epostGlobalFacilityScan(wording) {
+    return FACILITY_SCANS.has(normalizeStatusWording(wording));
+}
+/**
+ * A scan's stage from the map, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export function epostGlobalStage(wording) {
+    const mapped = epostGlobalScanStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** Codes are shared with the partners' own, so only the wording is read. */
+export const statusMap = {
+    stage: (_code, wording) => epostGlobalScanStage(wording),
+    gaps: [],
+};

package/dist/carriers/epost-global/statuses.json

@@ -1,4 +1,17 @@
 {
   "carrier": "epost-global",
-  "entries": []
+  "entries": [
+    {"code": "11", "wording": "Data Received", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "The shipper's data, without a place."},
+    {"code": "EPGS01", "wording": "Shipment in Transit to the ePost Global Processing Center", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Stamped a minute after the data on every parcel that has it: the label, not a scan."},
+    {"code": "30", "wording": "Parcel Received and Processing", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "A processing center's receipt, with its town and state; on the center's own clock."},
+    {"code": "32", "wording": "Parcel Shipped", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "The parcel left the processing center, on the center's clock."},
+    {"code": "41", "wording": "In transit to … tracking #: …", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "The handover a minute after shipping, naming the partner's service and number; also worded \"In transit via …\" and with \"tracking#:\"."},
+    {"code": "CI02", "wording": "Customer Information Manifested", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Relayed from DAI Post, which delivers in New Zealand."},
+    {"code": "OA01", "wording": "Checked in at origin hub", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Relayed from DAI Post, at its US hub after ePost Global shipped the parcel."},
+    {"code": "AD01", "wording": "Airline Delay", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Relayed from DAI Post; a delay, not a problem with the parcel."},
+    {"code": "DA05", "wording": "Collected from the airline for processing", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Relayed from DAI Post in the destination country."},
+    {"code": "1239", "wording": "The item is tied to a MAWB and ready for shipment", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Relayed from PostNL through Spring, after ePost Global shipped the parcel."},
+    {"code": "EPG-1272", "wording": "Your item has been dropped off by the sender with our postal partner in the country of origin.", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "La Poste's wording for a parcel PostNL brings to France, relayed after PostNL accepted it."},
+    {"code": "EPG-1270", "wording": "Your item is ready to be forwarded from its foreign territory. It will be given to the carrier for forwarding.", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "La Poste's wording, relayed for a parcel bound for France."}
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -41,6 +41,7 @@ import { statusMap as econt } from '../../carriers/econt/status.js';
 import { statusMap as elta } from '../../carriers/elta/status.js';
 import { statusMap as emile } from '../../carriers/emile/status.js';
 import { statusMap as envialia } from '../../carriers/envialia/status.js';
+import { statusMap as epostGlobal } from '../../carriers/epost-global/status.js';
 import { statusMap as expressOne } from '../../carriers/express-one/status.js';
 import { statusMap as fanCourier } from '../../carriers/fan-courier/status.js';
 import { statusMap as foxpost } from '../../carriers/foxpost/status.js';
@@ -105,7 +106,7 @@ export const STATUS_MAPS = {
     'acs-courier': acsCourier, aliexpress, 'allegro-one': allegroOne, 'an-post': anPost, 'apc-overnight': apcOvernight, 'aras-kargo': arasKargo,
     'box-now': boxNow, cacesa, cargus, cdek, cdl, 'ceska-posta': ceskaPosta, 'china-post': chinaPost, 'chit-chats': chitChats, chronopost, 'correos-spain': correosSpain,
     'cyprus-post': cyprusPost, dao, 'dhl-express': dhlExpress, dpd, 'dpd-de': dpdDe, 'dpd-fr': dpdFr, 'dpd-ie': dpdIe, 'dpd-pl': dpdPl, dsv,
-    dynalogic, 'early-bird': earlyBird, econt, elta, emile, envialia, 'express-one': expressOne, 'fan-courier': fanCourier, foxpost,
+    dynalogic, 'early-bird': earlyBird, econt, elta, emile, envialia, 'epost-global': epostGlobal, 'express-one': expressOne, 'fan-courier': fanCourier, foxpost,
     'gebrueder-weiss': gebruederWeiss, geis, 'geniki-taxydromiki': geniki, 'gls-es': glsEs, 'gls-it': glsIt, 'go-express': goExpress,
     'gofo-fr': gofoFr, 'gofo-it': gofoIt, helthjem, 'hrvatska-posta': hrvatskaPosta, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo, jitsu,
     'kuehne-nagel': kuehneNagel, 'la-poste': laPoste, 'latvijas-pasts': latvijasPasts, 'lietuvos-pastas': lietuvosPastas,

package/dist/data/catalog.json

@@ -6141,15 +6141,33 @@
         "timezone": "America/Los_Angeles",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "epost-global",
+            "recognitionRank": 65,
+            "localClocks": true
         },
         "canaryUrl": "https://epgtrack.com/",
-        "trackingUrlTemplate": "https://epgtrack.com/",
+        "trackingUrlTemplate": "https://epgtrack.com/{trackingNumber}",
         "trackingSearchUrl": "https://epgtrack.com/",
-        "linkRules": [],
+        "linkRules": [
+            {
+                "domains": [
+                    "epgtrack.com"
+                ],
+                "path": "^/(EPG\\d{10,15})/?$"
+            },
+            {
+                "domains": [
+                    "epgtrack.com"
+                ],
+                "pathPattern": "^/$",
+                "params": [
+                    "id"
+                ]
+            }
+        ],
         "detectionRules": [
             {
-                "pattern": "^EPG\\d{10,13}$",
+                "pattern": "^EPG\\d{10,15}$",
                 "confidence": "high"
             }
         ]

package/dist/generated/catalog.d.ts

@@ -4174,14 +4174,23 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "America/Los_Angeles";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "epost-global";
+            readonly recognitionRank: 65;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://epgtrack.com/";
-        readonly trackingUrlTemplate: "https://epgtrack.com/";
+        readonly trackingUrlTemplate: "https://epgtrack.com/{trackingNumber}";
         readonly trackingSearchUrl: "https://epgtrack.com/";
-        readonly linkRules: readonly [];
+        readonly linkRules: readonly [{
+            readonly domains: readonly ["epgtrack.com"];
+            readonly path: "^/(EPG\\d{10,15})/?$";
+        }, {
+            readonly domains: readonly ["epgtrack.com"];
+            readonly pathPattern: "^/$";
+            readonly params: readonly ["id"];
+        }];
         readonly detectionRules: readonly [{
-            readonly pattern: "^EPG\\d{10,13}$";
+            readonly pattern: "^EPG\\d{10,15}$";
             readonly confidence: "high";
         }];
     };

package/dist/generated/catalog.js

@@ -6142,15 +6142,33 @@ export const CARRIER_CATALOG = {
         "timezone": "America/Los_Angeles",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "epost-global",
+            "recognitionRank": 65,
+            "localClocks": true
         },
         "canaryUrl": "https://epgtrack.com/",
-        "trackingUrlTemplate": "https://epgtrack.com/",
+        "trackingUrlTemplate": "https://epgtrack.com/{trackingNumber}",
         "trackingSearchUrl": "https://epgtrack.com/",
-        "linkRules": [],
+        "linkRules": [
+            {
+                "domains": [
+                    "epgtrack.com"
+                ],
+                "path": "^/(EPG\\d{10,15})/?$"
+            },
+            {
+                "domains": [
+                    "epgtrack.com"
+                ],
+                "pathPattern": "^/$",
+                "params": [
+                    "id"
+                ]
+            }
+        ],
         "detectionRules": [
             {
-                "pattern": "^EPG\\d{10,13}$",
+                "pattern": "^EPG\\d{10,15}$",
                 "confidence": "high"
             }
         ]

package/dist/generated/recognition.js

@@ -42,6 +42,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "elta": 150,
     "emile": 480,
     "envialia": 260,
+    "epost-global": 65,
     "express-one": 190,
     "fan-courier": 330,
     "four-px": 570,

package/dist/generated/registry.js

@@ -64,6 +64,7 @@ import { adapter as elta } from '../carriers/elta/adapter.js';
 import { adapter as emile } from '../carriers/emile/adapter.js';
 import { adapter as ems } from '../carriers/ems/adapter.js';
 import { adapter as envialia } from '../carriers/envialia/adapter.js';
+import { adapter as epostGlobal } from '../carriers/epost-global/adapter.js';
 import { adapter as estafeta } from '../carriers/estafeta/adapter.js';
 import { adapter as evri } from '../carriers/evri/adapter.js';
 import { adapter as evriUk } from '../carriers/evri-uk/adapter.js';
@@ -246,6 +247,7 @@ export const REGISTRY = {
         "emile": emile,
         "ems": ems,
         "envialia": envialia,
+        "epost-global": epostGlobal,
         "estafeta": estafeta,
         "evri": evri,
         "evri-uk": evriUk,
@@ -435,7 +437,7 @@ export const REGISTRY = {
         "emile": "emile",
         "ems": "ems",
         "envialia": "envialia",
-        "epost-global": "universal",
+        "epost-global": "epost-global",
         "estafeta": "estafeta",
         "estes": "universal",
         "evri": "evri",

package/dist/server/openapi.json

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

package/package.json

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