universal-parcel-scraper 0.121.0-main.1069 → 0.123.0-main.1075

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 **182 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,346 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"
       }
     ]
@@ -7724,7 +7742,8 @@
     "timezone": "America/New_York",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "passport",
+      "recognitionRank": 55
     },
     "canaryUrl": "https://passportglobal.com/track/",
     "trackingUrlTemplate": "https://track.passportglobal.com/{trackingNumber}",
@@ -7736,11 +7755,17 @@
           "track.passportshipping.com"
         ],
         "path": "^/([^/?#]+)/?$"
+      },
+      {
+        "domains": [
+          "passportglobal.com"
+        ],
+        "path": "^/([Pp][Gg]\\d{10,11}[A-Za-z]{2})/?$"
       }
     ],
     "detectionRules": [
       {
-        "pattern": "^PG\\d{10}[A-Z]{2}$",
+        "pattern": "^PG\\d{10,11}[A-Z]{2}$",
         "confidence": "high"
       }
     ]

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 208,
-  "activeAdapters": 180,
+  "activeAdapters": 182,
   "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",
@@ -33057,6 +33153,38 @@
       "passport"
     ]
   },
+  {
+    "input": "PG16107427306DE",
+    "carrier": "passport",
+    "confidence": "high",
+    "candidates": [
+      "passport"
+    ]
+  },
+  {
+    "input": "PG16153149815AT",
+    "carrier": "passport",
+    "confidence": "high",
+    "candidates": [
+      "passport"
+    ]
+  },
+  {
+    "input": "PG18272609183GB",
+    "carrier": "passport",
+    "confidence": "high",
+    "candidates": [
+      "passport"
+    ]
+  },
+  {
+    "input": "PG6255087480AU",
+    "carrier": "passport",
+    "confidence": "high",
+    "candidates": [
+      "passport"
+    ]
+  },
   {
     "input": "PG6519662122CA",
     "carrier": "passport",
@@ -33065,6 +33193,22 @@
       "passport"
     ]
   },
+  {
+    "input": "PG7230048929CA",
+    "carrier": "passport",
+    "confidence": "high",
+    "candidates": [
+      "passport"
+    ]
+  },
+  {
+    "input": "PG7237729986CA",
+    "carrier": "passport",
+    "confidence": "high",
+    "candidates": [
+      "passport"
+    ]
+  },
   {
     "input": "PG756920321CA",
     "carrier": "canada-post",

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"
 		}]
 	},
@@ -6124,7 +6133,8 @@ var De = {
 		timezone: "America/New_York",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "passport",
+			recognitionRank: 55
 		},
 		canaryUrl: "https://passportglobal.com/track/",
 		trackingUrlTemplate: "https://track.passportglobal.com/{trackingNumber}",
@@ -6132,9 +6142,12 @@ var De = {
 		linkRules: [{
 			domains: ["track.passportglobal.com", "track.passportshipping.com"],
 			path: "^/([^/?#]+)/?$"
+		}, {
+			domains: ["passportglobal.com"],
+			path: "^/([Pp][Gg]\\d{10,11}[A-Za-z]{2})/?$"
 		}],
 		detectionRules: [{
-			pattern: "^PG\\d{10}[A-Z]{2}$",
+			pattern: "^PG\\d{10,11}[A-Z]{2}$",
 			confidence: "high"
 		}]
 	},
@@ -12351,6 +12364,7 @@ var Qc = {
 	elta: 150,
 	emile: 480,
 	envialia: 260,
+	"epost-global": 65,
 	"express-one": 190,
 	"fan-courier": 330,
 	"four-px": 570,
@@ -12389,6 +12403,7 @@ var Qc = {
 	ontrac: 650,
 	"orlen-paczka": 495,
 	"osm-worldwide": 75,
+	passport: 55,
 	"poczta-polska": 750,
 	"post-luxembourg": 80,
 	"posta-slovenije": 130,

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"
     }
   ]