universal-parcel-scraper 0.91.1-main.983 → 0.93.0-main.987

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 **149 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **151 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 4,084 such statuses, each filed under one stage.
+The carrier folders record 4,117 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

@@ -6708,7 +6708,9 @@
     "timezone": "Europe/Zagreb",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "hrvatska-posta",
+      "recognitionRank": 810,
+      "localClocks": true
     },
     "canaryUrl": "https://posiljka.posta.hr/",
     "trackingUrlTemplate": "https://posiljka.posta.hr/hr/tracking/trackingdata?barcode={trackingNumber}",
@@ -6724,7 +6726,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}HR$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "instabox": {
     "displayName": "Instabox",
@@ -6929,7 +6938,9 @@
     "timezone": "Europe/Riga",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "latvijas-pasts",
+      "recognitionRank": 820,
+      "localClocks": true
     },
     "canaryUrl": "https://www.pasts.lv/izsekot-sutijumu",
     "trackingUrlTemplate": "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
@@ -6945,7 +6956,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}LV$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "lbc-express": {
     "displayName": "LBC Express",

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -25585,6 +25585,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -25596,6 +25597,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -25607,6 +25609,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -27047,6 +27050,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -27922,6 +27926,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -30430,6 +30435,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -30556,6 +30562,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -30575,6 +30582,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -30624,6 +30632,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -31481,6 +31490,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -31500,6 +31510,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -31648,6 +31659,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31659,6 +31671,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31670,6 +31683,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31681,6 +31695,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31692,6 +31707,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31703,6 +31719,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31714,6 +31731,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31725,6 +31743,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31736,6 +31755,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -33546,6 +33566,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -33557,6 +33578,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -33611,6 +33633,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -34240,6 +34263,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -35409,6 +35433,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -36111,6 +36136,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -36876,6 +36902,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -37150,6 +37177,7 @@
       "intl-post"
     ],
     "asked": [
+      "hrvatska-posta",
       "chronopost"
     ]
   },
@@ -37161,6 +37189,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },

package/dist/browser/scraper.js

@@ -5351,7 +5351,9 @@ var be = {
 		timezone: "Europe/Zagreb",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "hrvatska-posta",
+			recognitionRank: 810,
+			localClocks: !0
 		},
 		canaryUrl: "https://posiljka.posta.hr/",
 		trackingUrlTemplate: "https://posiljka.posta.hr/hr/tracking/trackingdata?barcode={trackingNumber}",
@@ -5361,7 +5363,12 @@ var be = {
 			pathPattern: "^/(?:hr/|en/)?tracking/trackingdata/?$",
 			params: ["barcode"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}HR$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	instabox: {
 		displayName: "Instabox",
@@ -5520,7 +5527,9 @@ var be = {
 		timezone: "Europe/Riga",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "latvijas-pasts",
+			recognitionRank: 820,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.pasts.lv/izsekot-sutijumu",
 		trackingUrlTemplate: "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
@@ -5530,7 +5539,12 @@ var be = {
 			pathPattern: "^/track/?$",
 			params: ["id"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}LV$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	"lbc-express": {
 		displayName: "LBC Express",
@@ -7126,7 +7140,7 @@ var be = {
 	"gofo-fr": ["gofo-fr-1", "gofo-fr-2"],
 	"gofo-it": ["gofo-it-1"],
 	helthjem: ["helthjem-1", "helthjem-2"],
-	"hrvatska-posta": [],
+	"hrvatska-posta": ["hrvatska-posta-s10"],
 	instabox: [],
 	intelcom: [
 		"intelcom-1",
@@ -7136,7 +7150,7 @@ var be = {
 	"j-and-t-cargo": ["j-and-t-cargo-1", "j-and-t-cargo-2"],
 	jitsu: [],
 	"kuehne-nagel": ["kuehne-nagel-1", "kuehne-nagel-2"],
-	"latvijas-pasts": [],
+	"latvijas-pasts": ["latvijas-pasts-s10"],
 	"lbc-express": ["lbc-domestic"],
 	"lietuvos-pastas": ["lietuvos-pastas-1"],
 	"loomis-express": ["loomis-express-1", "loomis-express-2"],
@@ -11925,10 +11939,12 @@ var bc = {
 	"gofo-it": 20,
 	helthjem: 710,
 	"hermes-de": 400,
+	"hrvatska-posta": 810,
 	inpost: 380,
 	"j-and-t": 90,
 	"j-and-t-cargo": 470,
 	"la-poste": 800,
+	"latvijas-pasts": 820,
 	matkahuolto: 690,
 	"mng-kargo": 740,
 	nacex: 410,

package/dist/carriers/hrvatska-posta/adapter.d.ts

@@ -0,0 +1,14 @@
+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';
+export declare const HRVATSKA_POSTA_ENDPOINT = "https://posiljka.posta.hr/en/tracking/trackingdata";
+export declare class HrvatskaPostaTracker {
+    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/hrvatska-posta/adapter.js

@@ -0,0 +1,52 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { IndeterminateError, TransportError } from '../../core/errors/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 { HRVATSKA_POSTA_MAX_BYTES, normalizeHrvatskaPostaNumber, parseHrvatskaPosta, PROVIDER } from './parser.js';
+// The English page of Hrvatska pošta's tracker, which its tracking forms open with the number as `barcode`.
+export const HRVATSKA_POSTA_ENDPOINT = 'https://posiljka.posta.hr/en/tracking/trackingdata';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// A missing route is not a missing item: the tracker answers unknown numbers with a notice.
+const GONE = [404, 410];
+export class HrvatskaPostaTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeHrvatskaPostaNumber(raw);
+        const url = `${HRVATSKA_POSTA_ENDPOINT}?${new URLSearchParams({ barcode: number })}`;
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(url, { method: 'GET', signal, headers: {
+                    Accept: 'text/html,application/xhtml+xml',
+                    'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: HRVATSKA_POSTA_MAX_BYTES,
+                redirect: 'manual', allowHttpStatuses: [...REDIRECTS, ...GONE], fetcher: this.options.fetcher });
+            if (REDIRECTS.includes(response.status))
+                throw new IndeterminateError(PROVIDER, 'Hrvatska pošta sent the lookup to another page');
+            if (GONE.includes(response.status))
+                throw new TransportError(PROVIDER, 'Hrvatska pošta tracking page is unavailable');
+            const html = decodeText(bytes);
+            if (!html.trim())
+                throw new IndeterminateError(PROVIDER, 'Hrvatska pošta returned an empty page');
+            return parseHrvatskaPosta(html, number);
+        };
+        // A request that fails to reach Hrvatska pošta, or hangs, gets one more
+        // try: the first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'hrvatska-posta', 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 HrvatskaPostaTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'hrvatska-posta', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeHrvatskaPostaNumber(number))),
+    };
+};

package/dist/carriers/hrvatska-posta/carrier.json

@@ -20,18 +20,52 @@
   "timezone": "Europe/Zagreb",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "hrvatska-posta",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 810
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "weight",
+    "pickup_point"
+  ],
   "portal": {
     "url": "https://posiljka.posta.hr/hr/tracking/trackingdata?barcode={trackingNumber}",
     "searchUrl": "https://posiljka.posta.hr/",
     "canaryUrl": "https://posiljka.posta.hr/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "weight",
+      "postcodes",
+      "delivery_unit_logo"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "weight",
+      "pickup_point"
+    ],
+    "discarded": [
+      "postcodes",
+      "delivery_unit_logo"
+    ],
+    "unavailable": [
+      "eta",
+      "service_name",
+      "sender_name",
+      "recipient_name",
+      "offset_timestamps"
+    ]
   },
   "links": [
     {
@@ -44,5 +78,13 @@
       ]
     }
   ],
-  "detection": []
+  "detection": [
+    {
+      "id": "hrvatska-posta-s10",
+      "pattern": "^[A-Z]{2}\\d{9}HR$",
+      "confidence": "low",
+      "preferred": true,
+      "checksum": "s10"
+    }
+  ]
 }