universal-parcel-scraper 0.95.0-main.992 → 0.97.0-main.997

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

@@ -4852,11 +4852,24 @@
     "timezone": "Europe/London",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "apc-overnight",
+      "recognitionRank": 870,
+      "localClocks": true
     },
     "canaryUrl": "https://apc.co.uk/",
+    "trackingUrlTemplate": "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
     "trackingSearchUrl": "https://apc.co.uk/",
-    "linkRules": [],
+    "linkRules": [
+      {
+        "domains": [
+          "apcchoice.apc-overnight.com"
+        ],
+        "pathPattern": "^/track-parcel/?$",
+        "params": [
+          "id"
+        ]
+      }
+    ],
     "detectionRules": [
       {
         "pattern": "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$",
@@ -7024,7 +7037,9 @@
     "timezone": "Europe/Vilnius",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "lietuvos-pastas",
+      "recognitionRank": 860,
+      "localClocks": true
     },
     "canaryUrl": "https://lpexpress.lt/track",
     "trackingUrlTemplate": "https://lpexpress.lt/track?parcel={trackingNumber}",
@@ -7059,6 +7074,12 @@
       {
         "pattern": "^(?:CC|CH|HC)\\d{9}LT$",
         "confidence": "low"
+      },
+      {
+        "pattern": "^[A-Z]{2}\\d{9}LT$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
       }
     ]
   },

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -9600,6 +9600,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -9663,6 +9664,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -9686,6 +9688,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -9703,6 +9706,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -24785,6 +24789,7 @@
       "intl-post"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -25654,6 +25659,7 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -25666,6 +25672,7 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -25677,6 +25684,19 @@
       "intl-post"
     ],
     "asked": [
+      "lietuvos-pastas",
+      "chronopost"
+    ]
+  },
+  {
+    "input": "CC929125681LT",
+    "carrier": "intl-post",
+    "confidence": "high",
+    "candidates": [
+      "intl-post"
+    ],
+    "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -26052,6 +26072,7 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -26064,6 +26085,7 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -26088,6 +26110,7 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -27580,6 +27603,7 @@
       "intl-post"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -29161,6 +29185,20 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
+      "chronopost"
+    ]
+  },
+  {
+    "input": "HC019942965LT",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "chronopost",
+      "lietuvos-pastas"
+    ],
+    "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -29173,6 +29211,7 @@
       "lietuvos-pastas"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -33473,6 +33512,7 @@
       "intl-post"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },
@@ -33930,6 +33970,7 @@
       "intl-post"
     ],
     "asked": [
+      "lietuvos-pastas",
       "chronopost"
     ]
   },

package/dist/browser/scraper.js

@@ -3976,11 +3976,18 @@ var be = {
 		timezone: "Europe/London",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "apc-overnight",
+			recognitionRank: 870,
+			localClocks: !0
 		},
 		canaryUrl: "https://apc.co.uk/",
+		trackingUrlTemplate: "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
 		trackingSearchUrl: "https://apc.co.uk/",
-		linkRules: [],
+		linkRules: [{
+			domains: ["apcchoice.apc-overnight.com"],
+			pathPattern: "^/track-parcel/?$",
+			params: ["id"]
+		}],
 		detectionRules: [{
 			pattern: "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$",
 			confidence: "low",
@@ -5589,7 +5596,9 @@ var be = {
 		timezone: "Europe/Vilnius",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "lietuvos-pastas",
+			recognitionRank: 860,
+			localClocks: !0
 		},
 		canaryUrl: "https://lpexpress.lt/track",
 		trackingUrlTemplate: "https://lpexpress.lt/track?parcel={trackingNumber}",
@@ -5613,6 +5622,11 @@ var be = {
 		detectionRules: [{
 			pattern: "^(?:CC|CH|HC)\\d{9}LT$",
 			confidence: "low"
+		}, {
+			pattern: "^[A-Z]{2}\\d{9}LT$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
 		}]
 	},
 	"loomis-express": {
@@ -7168,7 +7182,7 @@ var be = {
 	"kuehne-nagel": ["kuehne-nagel-1", "kuehne-nagel-2"],
 	"latvijas-pasts": ["latvijas-pasts-s10"],
 	"lbc-express": ["lbc-domestic"],
-	"lietuvos-pastas": ["lietuvos-pastas-1"],
+	"lietuvos-pastas": ["lietuvos-pastas-1", "lietuvos-pastas-s10"],
 	"loomis-express": ["loomis-express-1", "loomis-express-2"],
 	lso: ["lso-1"],
 	"magyar-posta": [],
@@ -11913,6 +11927,7 @@ var bc = {
 	"acs-courier": 570,
 	aliexpress: 140,
 	"allegro-one": 770,
+	"apc-overnight": 870,
 	"aras-kargo": 670,
 	"australia-post": 60,
 	"austrian-post": 390,
@@ -11962,6 +11977,7 @@ var bc = {
 	"j-and-t-cargo": 470,
 	"la-poste": 800,
 	"latvijas-pasts": 820,
+	"lietuvos-pastas": 860,
 	matkahuolto: 690,
 	"mng-kargo": 740,
 	nacex: 410,

package/dist/carriers/apc-overnight/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 APC_OVERNIGHT_ENDPOINT = "https://apcchoice.apc-overnight.com/track-parcel";
+export declare class ApcOvernightTracker {
+    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/apc-overnight/adapter.js

@@ -0,0 +1,53 @@
+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 { APC_OVERNIGHT_MAX_BYTES, normalizeApcOvernightNumber, parseApcOvernight, PROVIDER } from './parser.js';
+// APC Choice's public tracking page, which merchants link to with the waybill as `id`.
+export const APC_OVERNIGHT_ENDPOINT = 'https://apcchoice.apc-overnight.com/track-parcel';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// A missing route is not a missing consignment: the tracker answers unknown waybills with a notice.
+const GONE = [404, 410];
+export class ApcOvernightTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeApcOvernightNumber(raw);
+        const url = `${APC_OVERNIGHT_ENDPOINT}?${new URLSearchParams({ id: 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: APC_OVERNIGHT_MAX_BYTES,
+                redirect: 'manual', allowHttpStatuses: [...REDIRECTS, ...GONE], fetcher: this.options.fetcher });
+            // The site sends its errors to the search page with a message in the address.
+            if (REDIRECTS.includes(response.status))
+                throw new IndeterminateError(PROVIDER, 'APC Overnight sent the lookup to another page');
+            if (GONE.includes(response.status))
+                throw new TransportError(PROVIDER, 'APC Overnight tracking page is unavailable');
+            const html = decodeText(bytes);
+            if (!html.trim())
+                throw new IndeterminateError(PROVIDER, 'APC Overnight returned an empty page');
+            return parseApcOvernight(html, number);
+        };
+        // A request that fails to reach APC, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'apc-overnight', 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 ApcOvernightTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'apc-overnight', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeApcOvernightNumber(number))),
+    };
+};

package/dist/carriers/apc-overnight/carrier.json

@@ -17,19 +17,66 @@
   "timezone": "Europe/London",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "apc-overnight",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 870
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "weight",
+    "service_name"
+  ],
   "portal": {
+    "url": "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
     "searchUrl": "https://apc.co.uk/",
     "canaryUrl": "https://apc.co.uk/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "weight",
+      "service_name",
+      "parcel_count",
+      "customer_reference",
+      "office_contact_details",
+      "proof_of_delivery"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "weight",
+      "service_name"
+    ],
+    "discarded": [
+      "parcel_count",
+      "customer_reference",
+      "office_contact_details",
+      "proof_of_delivery"
+    ],
+    "unavailable": [
+      "location",
+      "eta",
+      "sender_name",
+      "recipient_name",
+      "offset_timestamps"
+    ]
   },
-  "links": [],
+  "links": [
+    {
+      "domains": [
+        "apcchoice.apc-overnight.com"
+      ],
+      "pathPattern": "^/track-parcel/?$",
+      "params": [
+        "id"
+      ]
+    }
+  ],
   "detection": [
     {
       "id": "apc-overnight-1",

package/dist/carriers/apc-overnight/numbers.json

@@ -10,7 +10,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -22,7 +22,7 @@
           "estafeta"
         ]
       },
-      "note": "A seller on Amazon's seller forum gives it as an APC Overnight consignment number."
+      "note": "A seller on Amazon's seller forum gives it as an APC Overnight consignment number. APC's tracker returns its history."
     },
     {
       "number": "2026100902014380018924",
@@ -35,7 +35,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -47,7 +47,7 @@
           "estafeta"
         ]
       },
-      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026. APC's tracker returns its history."
     },
     {
       "number": "2026090302014380017949",
@@ -60,7 +60,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -72,7 +72,7 @@
           "estafeta"
         ]
       },
-      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026. APC's tracker returns its history."
     },
     {
       "number": "2018041910099660000599",
@@ -95,7 +95,7 @@
           "estafeta"
         ]
       },
-      "note": "The Glama listing of an open-source MCP server for APC Overnight's booking API uses it as the waybill in an example prompt; it is not described as a live shipment."
+      "note": "The Glama listing of an open-source MCP server for APC Overnight's booking API uses it as the waybill in an example prompt; it is not described as a live shipment. APC's tracker no longer finds it."
     }
   ]
 }

package/dist/carriers/apc-overnight/parser.d.ts

@@ -0,0 +1,17 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "APC Overnight";
+export declare const APC_OVERNIGHT_MAX_BYTES: number;
+/**
+ * An APC waybill: twenty-two digits that start with the consignment's booking
+ * date, as 20YYMMDD, and end with its seven-digit consignment number. The
+ * tracker looks a consignment up only by the whole waybill.
+ */
+export declare function normalizeApcOvernightNumber(raw: string): string;
+/**
+ * The tracking page for one waybill: a consignment summary, then each item's
+ * journey through the network and its delivery summary, each row a wording
+ * with its day and minute. The page names the consignment by its seven-digit
+ * number, the end of the waybill it was asked for. A waybill the tracker does
+ * not have, or of another shape, comes back on the search page with a notice.
+ */
+export declare function parseApcOvernight(html: string, rawNumber: string): CarrierResult;