universal-parcel-scraper 0.119.0-main.1065 → 0.121.0-main.1069

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 **178 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **180 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,275 such statuses, each filed under one stage.
+The carrier folders record 5,319 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

@@ -6954,10 +6954,11 @@
     "timezone": "America/Los_Angeles",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "jitsu",
+      "recognitionRank": 85
     },
     "canaryUrl": "https://recipient.gojitsu.com/",
-    "trackingUrlTemplate": "https://recipient.gojitsu.com/{trackingNumber}",
+    "trackingUrlTemplate": "https://recipient.gojitsu.com/noredirect/{trackingNumber}",
     "trackingSearchUrl": "https://recipient.gojitsu.com/",
     "linkRules": [
       {
@@ -6967,7 +6968,7 @@
           "tracking.gojitsu.com",
           "tracking.axlehire.com"
         ],
-        "path": "^/([^/?#]+)/?$"
+        "path": "^/(?:noredirect/)?([^/?#]+)/?$"
       }
     ],
     "detectionRules": []
@@ -7648,7 +7649,9 @@
     "timezone": "America/Chicago",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "osm-worldwide",
+      "recognitionRank": 75,
+      "localClocks": true
     },
     "canaryUrl": "https://www.osmworldwide.com/tracking/",
     "trackingUrlTemplate": "https://www.osmworldwide.com/tracking/?trackingIds={trackingNumber}",
@@ -7669,6 +7672,10 @@
       {
         "pattern": "^A\\d{10}[A-Z]{3}\\d{8}$",
         "confidence": "high"
+      },
+      {
+        "pattern": "^OSM[0-9A-Z]{14}$",
+        "confidence": "high"
       }
     ]
   },

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -16694,6 +16694,17 @@
     "confidence": "none",
     "candidates": []
   },
+  {
+    "input": "4AUMF4FWVRB5",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "colis-prive"
+    ],
+    "asked": [
+      "colis-prive"
+    ]
+  },
   {
     "input": "4C003925742US",
     "carrier": "uniuni",
@@ -32830,6 +32841,22 @@
     "confidence": "none",
     "candidates": []
   },
+  {
+    "input": "OSM000000LM0060VO",
+    "carrier": "osm-worldwide",
+    "confidence": "high",
+    "candidates": [
+      "osm-worldwide"
+    ]
+  },
+  {
+    "input": "OSM000000LM00B0LO",
+    "carrier": "osm-worldwide",
+    "confidence": "high",
+    "candidates": [
+      "osm-worldwide"
+    ]
+  },
   {
     "input": "P2Q5J87J96",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -5542,10 +5542,11 @@ var De = {
 		timezone: "America/Los_Angeles",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "jitsu",
+			recognitionRank: 85
 		},
 		canaryUrl: "https://recipient.gojitsu.com/",
-		trackingUrlTemplate: "https://recipient.gojitsu.com/{trackingNumber}",
+		trackingUrlTemplate: "https://recipient.gojitsu.com/noredirect/{trackingNumber}",
 		trackingSearchUrl: "https://recipient.gojitsu.com/",
 		linkRules: [{
 			domains: [
@@ -5554,7 +5555,7 @@ var De = {
 				"tracking.gojitsu.com",
 				"tracking.axlehire.com"
 			],
-			path: "^/([^/?#]+)/?$"
+			path: "^/(?:noredirect/)?([^/?#]+)/?$"
 		}],
 		detectionRules: []
 	},
@@ -6066,7 +6067,9 @@ var De = {
 		timezone: "America/Chicago",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "osm-worldwide",
+			recognitionRank: 75,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.osmworldwide.com/tracking/",
 		trackingUrlTemplate: "https://www.osmworldwide.com/tracking/?trackingIds={trackingNumber}",
@@ -6079,6 +6082,9 @@ var De = {
 		detectionRules: [{
 			pattern: "^A\\d{10}[A-Z]{3}\\d{8}$",
 			confidence: "high"
+		}, {
+			pattern: "^OSM[0-9A-Z]{14}$",
+			confidence: "high"
 		}]
 	},
 	paquetexpress: {
@@ -7362,7 +7368,7 @@ var De = {
 		"omniva-s10"
 	],
 	"orlen-paczka": ["orlen-paczka-1"],
-	"osm-worldwide": ["osm-worldwide-1"],
+	"osm-worldwide": ["osm-worldwide-1", "osm-worldwide-2"],
 	paquetexpress: [],
 	passport: ["passport-1"],
 	"post-luxembourg": ["post-luxembourg-s10"],
@@ -12364,6 +12370,7 @@ var Qc = {
 	inpost: 820,
 	"j-and-t": 530,
 	"j-and-t-cargo": 910,
+	jitsu: 85,
 	"kuehne-nagel": 435,
 	"la-poste": 1e3,
 	"latvijas-pasts": 100,
@@ -12381,6 +12388,7 @@ var Qc = {
 	omniva: 300,
 	ontrac: 650,
 	"orlen-paczka": 495,
+	"osm-worldwide": 75,
 	"poczta-polska": 750,
 	"post-luxembourg": 80,
 	"posta-slovenije": 130,

package/dist/carriers/jitsu/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';
+export declare const JITSU_ENDPOINT = "https://api.recipient.gojitsu.com/delivery/";
+export declare function jitsuTrackingUrl(raw: string): string;
+export declare class JitsuTracker {
+    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/jitsu/adapter.js

@@ -0,0 +1,75 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, NotFoundError, SchemaError, 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 { isJitsuNotFound, JITSU_MAX_BYTES, normalizeJitsuNumber, parseJitsu, PROVIDER } from './parser.js';
+// The service Jitsu's tracker and recipient app ask for a delivery by its code.
+export const JITSU_ENDPOINT = 'https://api.recipient.gojitsu.com/delivery/';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// Statuses that alone say nothing about the code: only the service's own 404 body does.
+const GONE = [404, 410];
+// A challenge page, which can come instead of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>\s*(?:Just a moment|Attention Required)/i;
+export function jitsuTrackingUrl(raw) {
+    return `${JITSU_ENDPOINT}${normalizeJitsuNumber(raw)}`;
+}
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (error) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Jitsu answered with a browser challenge', { cause: error });
+        throw new SchemaError(PROVIDER, 'Jitsu returned a reply that is not JSON', { cause: error });
+    }
+}
+export class JitsuTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeJitsuNumber(raw);
+        const url = `${JITSU_ENDPOINT}${number}`;
+        const read = async (signal, timeoutMs) => {
+            // The tracker sends no token for this read; a token only unlocks the
+            // recipient's own details and changes, which the adapter never asks for.
+            const { response, bytes } = await fetchBounded(url, { method: 'GET', signal, headers: {
+                    Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: JITSU_MAX_BYTES, redirect: 'manual',
+                allowHttpStatuses: [...REDIRECTS, ...GONE], fetcher: this.options.fetcher });
+            if (REDIRECTS.includes(response.status))
+                throw new IndeterminateError(PROVIDER, 'Jitsu moved its tracking service');
+            const body = decodeText(bytes);
+            if (GONE.includes(response.status)) {
+                let reply = null;
+                try {
+                    reply = JSON.parse(body);
+                }
+                catch { /* not the service's own answer */ }
+                if (response.status === 404 && isJitsuNotFound(reply, number))
+                    throw new NotFoundError(PROVIDER);
+                // A route the service does not serve, which says nothing about the code.
+                throw new TransportError(PROVIDER, 'Jitsu tracking service is unavailable');
+            }
+            return parseJitsu(json(body), number);
+        };
+        // A request that fails to reach Jitsu, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'jitsu', 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 JitsuTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'jitsu', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeJitsuNumber(number))),
+    };
+};

package/dist/carriers/jitsu/carrier.json

@@ -17,18 +17,70 @@
   "timezone": "America/Los_Angeles",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "jitsu",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 85
+    }
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "eta",
+    "delivered_at",
+    "provider_code"
+  ],
   "portal": {
-    "url": "https://recipient.gojitsu.com/{trackingNumber}",
+    "url": "https://recipient.gojitsu.com/noredirect/{trackingNumber}",
     "searchUrl": "https://recipient.gojitsu.com/",
     "canaryUrl": "https://recipient.gojitsu.com/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "progress_rail",
+      "history",
+      "location",
+      "eta",
+      "eta_window",
+      "delivered_at",
+      "sender_name",
+      "coordinates",
+      "proof_of_delivery",
+      "signature",
+      "driver_name",
+      "delivery_instructions"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "eta_window",
+      "delivered_at",
+      "provider_code",
+      "offset_timestamps"
+    ],
+    "discarded": [
+      "progress_rail",
+      "sender_name",
+      "coordinates",
+      "proof_of_delivery",
+      "signature",
+      "driver_name",
+      "delivery_instructions",
+      "recipient_address",
+      "postcodes",
+      "contact_details",
+      "remarks",
+      "customer_reference",
+      "service_name"
+    ],
+    "unavailable": [
+      "weight",
+      "dimensions"
+    ]
   },
   "links": [
     {
@@ -38,7 +90,7 @@
         "tracking.gojitsu.com",
         "tracking.axlehire.com"
       ],
-      "path": "^/([^/?#]+)/?$"
+      "path": "^/(?:noredirect/)?([^/?#]+)/?$"
     }
   ],
   "detection": []

package/dist/carriers/jitsu/numbers.json

@@ -12,13 +12,13 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "A review on AxleHire's Trustpilot page gives it as the tracking code."
+      "note": "A review on AxleHire's Trustpilot page gives it as the tracking code. Jitsu's tracking service knows it."
     },
     {
       "number": "SCD0970110404013031",
@@ -31,13 +31,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "SCD0000015902735263",
@@ -50,13 +50,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "SCD0000F00200029177",
@@ -69,13 +69,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "SCD0000H00500673206",
@@ -88,13 +88,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "lyqnxet59476nx3e",
@@ -107,13 +107,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on AxleHire's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "2f9es65v3g4gt72z",
@@ -126,13 +126,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on Jitsu's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Jitsu's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "SCD0000H00411947817",
@@ -145,13 +145,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on Jitsu's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Jitsu's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
     },
     {
       "number": "SCD0000F00410922107",
@@ -164,13 +164,35 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on Jitsu's own tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Jitsu's own tracker, as an archived address shows; the capture was not opened. Jitsu's tracking service knows it."
+    },
+    {
+      "number": "4AUMF4FWVRB5",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.parcelpanel.com/couriers/axlehire/",
+        "date": "2026-10-12",
+        "dateKind": "capture",
+        "access": "full_page"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "colis-prive"
+        ]
+      },
+      "note": "ParcelPanel's AxleHire page offered it as a sample to try. Jitsu's tracking service knows it."
     }
   ]
 }

package/dist/carriers/jitsu/parser.d.ts

@@ -0,0 +1,22 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Jitsu";
+export declare const JITSU_MAX_BYTES = 1000000;
+/** A tracking code the service can look up: letters and digits, upper-cased as the library stores them. */
+export declare function normalizeJitsuNumber(raw: string): string;
+/**
+ * The reply of `GET /delivery/{code}` on Jitsu's recipient service: the
+ * shipment, its events newest first, and the tracker's settings. The shipment's
+ * tracking code must be the one requested, in any case. Events are read as
+ * the tracker lists them: by clock, newest first, without the address updates
+ * the recipient made, and without a facility's first scan that repeats its
+ * receipt. The recipient's contact details, address, postcode and position,
+ * the driver, delivery remarks, photos, signatures and access codes are never
+ * read.
+ */
+export declare function parseJitsu(payload: unknown, raw: string): CarrierResult;
+/**
+ * Whether a 404 is the service's own answer that it has no delivery for the
+ * code: its servlet's not-found body naming the path asked. A route the service
+ * no longer serves answers another body.
+ */
+export declare function isJitsuNotFound(payload: unknown, number: string): boolean;