universal-parcel-scraper 0.69.2-main.888 → 0.69.4-main.892

package/data/catalog.json

@@ -2702,8 +2702,8 @@
       "browserRecognitionRank": 65
     },
     "canaryUrl": "https://www.usps.com/",
-    "trackingUrlTemplate": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-    "trackingSearchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+    "trackingUrlTemplate": "https://tools.usps.com/tracking/{trackingNumber}",
+    "trackingSearchUrl": "https://tools.usps.com/tracking/",
     "linkRules": [
       {
         "domains": [
@@ -2712,7 +2712,8 @@
         ],
         "params": [
           "tLabels"
-        ]
+        ],
+        "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
       }
     ],
     "detectionRules": [

package/dist/browser/scraper.js

@@ -2290,11 +2290,12 @@ var ye = {
 			browserRecognitionRank: 65
 		},
 		canaryUrl: "https://www.usps.com/",
-		trackingUrlTemplate: "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-		trackingSearchUrl: "https://tools.usps.com/go/TrackConfirmAction",
+		trackingUrlTemplate: "https://tools.usps.com/tracking/{trackingNumber}",
+		trackingSearchUrl: "https://tools.usps.com/tracking/",
 		linkRules: [{
 			domains: ["tools.usps.com", "usps.com"],
-			params: ["tLabels"]
+			params: ["tLabels"],
+			path: "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
 		}],
 		detectionRules: [
 			{

package/dist/carriers/canada-post/app.d.ts

@@ -0,0 +1,2 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/canada-post/app.js

@@ -0,0 +1,7 @@
+// Scans relayed from other posts kept Canada Post's -05:00 or -04:00 until
+// October 2026, and those in a country with one clock now show its offset.
+// The old label is read as -05:00, the one Canada Post gives them in winter and
+// often in summer; a row stored under -04:00 is not recognized.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'canada-post', storedSources: ['canada-post'], requireProviderCode: true, relabelledFrom: 'Etc/GMT+5',
+};

package/dist/carriers/canada-post/parser.js

@@ -81,8 +81,9 @@ const EXCHANGE_SCANS = new Set(['4000', '4100', '4202', '4310', '4311', '4330',
  * Post's own page, a Korean one is on Korea Post's clock, a Montana delivery
  * office's "05:05 -05:00" is 05:05 MDT on USPS's page, and the Toronto
  * exchange office's "01:11 -05:00" fell in summer time (checked 2026-10-10).
- * Such a scan is read on its country's single clock; elsewhere it stays a
- * wall clock. Null for a scan whose offset stands.
+ * Such a scan is read on its country's single clock; elsewhere it keeps
+ * Canada Post's offset, the last guess: hours off, but the reply keeps its
+ * instant. Null for a scan whose offset stands.
  */
 function relayedClock(code, country, region) {
     const abroad = country !== '' && country !== 'CA';
@@ -104,12 +105,12 @@ function eventClock(value, relayed = null) {
         const placed = relayed?.zone ? isoTime(local, relayed.zone) : null;
         if (placed)
             return { time: placed.iso };
-        if (!relayed && /^(?:Z|[+-](?:(?:0\d|1[0-3]):[0-5]\d|14:00))$/i.test(offset)) {
+        if (/^(?:Z|[+-](?:(?:0\d|1[0-3]):[0-5]\d|14:00))$/i.test(offset)) {
             const parsed = explicitOffsetTime(`${local}${offset}`);
             if (parsed)
                 return { time: parsed.iso };
         }
-        else if (relayed || !offset) {
+        else if (!offset) {
             // UTC validates the calendar only; no timezone is attached to local digits.
             const parsed = DateTime.fromISO(local, { zone: 'UTC' });
             const valid = parsed.isValid ? parsed.toISO({ includeOffset: false, suppressMilliseconds: true }) : null;
@@ -184,14 +185,17 @@ export function parseCanadaPostTrackingResponse(payload, trackingNumber) {
         const location = isRecord(raw.locationAddr)
             ? [textField(raw.locationAddr, 'city', 160), region].filter(Boolean).join(', ') : '';
         const stage = type === 'Signature' || code === '20' ? null : canadaPostScanStage(code, description) ?? canadaPostStage(description);
-        const event = { ...eventClock(raw.datetime, relayedClock(code, country, region)), description: stage === 'delivered' ? 'Delivered' : description,
+        const relayed = relayedClock(code, country, region);
+        const clock = eventClock(raw.datetime, relayed);
+        const event = { ...clock, description: stage === 'delivered' ? 'Delivered' : description,
             provider_code: code, ...(stage ? { stage } : {}), ...(location ? { location } : {}) };
         return { event, type, region, country, sourceDate: isRecord(raw.datetime) ? calendarDate(raw.datetime.date) : null,
-            returnCue: returnStarted(description) || type === 'RtsLabelProc' };
+            returnCue: returnStarted(description) || type === 'RtsLabelProc', guessed: relayed?.zone === null && 'time' in clock };
     });
     // Native detail history is newest first. Compare instants only when every
-    // row resolves; an unresolved latest row must not fall behind old scans.
-    if (rows.every(row => row.event.time))
+    // row resolves, and none only by a guess; an unresolved latest row must not
+    // fall behind old scans, nor a guessed one behind a scan placed abroad.
+    if (rows.every(row => row.event.time && !row.guessed))
         rows.sort((a, b) => Date.parse(b.event.time) - Date.parse(a.event.time));
     let returning = false;
     for (const row of [...rows].reverse()) {

package/dist/carriers/ctt/adapter.js

@@ -89,9 +89,10 @@ const WALL_CLOCK = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})(?:\.\d{1,3})?(?:Z|\+0
  * A scan's clock. CTT's Z is no offset: the digits are the wall clock where
  * the scan happened (see clock.ts). That is the destination's, for a
  * partner post's scan of a parcel bound abroad (`abroad`), unless the
- * location names an office or a site of CTT's; Portugal's otherwise. A
- * destination with several zones leaves the scan a wall time. Any other
- * offset is taken as sent.
+ * location names an office or a site of CTT's; Portugal's otherwise. In a
+ * destination with several zones the scan keeps CTT's Z, the last guess:
+ * hours off, but the reply keeps its instant. Only a wall clock sent with no
+ * Z stays a wall time there. Any other offset is taken as sent.
  */
 function scanClock(value, location, abroad) {
     const raw = typeof value === 'string' ? value.trim() : '';
@@ -104,6 +105,9 @@ function scanClock(value, location, abroad) {
     const placed = zone ? isoTime(wall, zone) : null;
     if (placed)
         return { time: placed.iso, timestamp: placed.timestamp };
+    const labelled = explicitOffsetTime(raw);
+    if (labelled)
+        return { time: labelled.iso, timestamp: labelled.timestamp };
     const read = Date.parse(`${wall}Z`);
     return Number.isFinite(read) ? { local_time: wall, timestamp: read } : null;
 }

package/dist/carriers/ctt/app.d.ts

@@ -0,0 +1,2 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/ctt/app.js

@@ -0,0 +1,6 @@
+// Scan times were read as the UTC their Z says until October 2026, and now show
+// the clock of the place the scan happened: Lisbon's, the Azores' or the
+// destination's. Lisbon's winter scans keep their instants under +00:00.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'ctt', storedSources: ['ctt'], requireProviderCode: true, relabelledFrom: 'UTC',
+};

package/dist/carriers/nz-post/identity.js

@@ -14,7 +14,9 @@ function matches(incoming, stored) {
         && wording === normalized(stored.description)
         && (location === savedLocation || (!location && isNzPostPlaceholderLocation(savedLocation)));
 }
+// Scans abroad were read on Auckland's clock until October 2026 and now show
+// the offset of the country they happened in, unless nothing places them.
 export const sameInstantIdentityPolicy = {
     sourceCarrierId: 'nz-post', storedSources: ['nz-post'], requireProviderCode: true,
-    matchEachScan: true, matches,
+    matchEachScan: true, matches, relabelledFrom: 'Pacific/Auckland',
 };

package/dist/carriers/nz-post/parser.js

@@ -53,7 +53,8 @@ function abroadWall(clocked) {
  * an airline's included ("China"), else the nearest later one's. All of them
  * are the destination post's or the flight's to it; a transit hub's country
  * can be wrong, but Hong Kong, Singapore and China keep one clock. Null when
- * that country has several clocks or none is named: the scan stays a wall time.
+ * that country has several clocks or none is named: the scan keeps NZ Post's
+ * Auckland reading, the last guess.
  */
 function abroadZone(scans, position) {
     const country = scans[position].country ?? scans.slice(0, position).reverse().find(other => other.country)?.country
@@ -119,23 +120,27 @@ export function parseNzPost(payload, number) {
         return { ...clocked, description, provider_code: code,
             ...(location ? { location } : {}), ...(mapped ? { stage: mapped.stage } : {}) };
     });
+    // A scan nothing places keeps NZ Post's Auckland reading, the last guess:
+    // hours off, but the reply keeps its instant.
+    let guessed = false;
     afterDeparture.forEach((scan, position) => {
         // An airline's scan only lends its country: its clock was not checked.
         if (!scan.wall)
             return;
         const zone = abroadZone(afterDeparture, position);
         const placed = zone ? isoTime(scan.wall, zone) : null;
-        const event = { ...projected[scan.index], ...placed ? { time: placed.iso } : { local_time: scan.wall } };
-        if (!placed)
-            delete event.time;
-        projected[scan.index] = event;
+        if (placed)
+            projected[scan.index] = { ...projected[scan.index], time: placed.iso };
+        else
+            guessed = true;
     });
     if (!projected.length)
         throw new IndeterminateError('nz-post', 'NZ Post returned no parcel history');
     // The consumer client treats the last source row as current. Preserve that
-    // order if any clock is unresolved instead of promoting an older dated row.
+    // order if any clock is unresolved, or only guessed, instead of promoting an
+    // older dated row: a guessed clock can fall hours behind one placed abroad.
     projected.reverse();
-    if (projected.every(event => event.time))
+    if (!guessed && projected.every(event => event.time))
         projected.sort((a, b) => Date.parse(b.time) - Date.parse(a.time));
     const seen = new Set();
     const events = projected.filter(event => {

package/dist/carriers/swiss-post/app.js

@@ -1,6 +1,10 @@
 import { matchesLocationEnrichment } from '../../core/catalog/locationIdentity.js';
+// The destination post's scans of a parcel sent abroad came with Swiss Post's
+// Zurich offset until October 2026, and now show the destination's when it
+// keeps one clock.
 export const sameInstantIdentityPolicy = {
     sourceCarrierId: 'swiss-post', storedSources: ['swiss-post'], requireProviderCode: true,
     matchEachScan: true,
     matches: matchesLocationEnrichment,
+    relabelledFrom: 'Europe/Zurich',
 };

package/dist/carriers/usps/adapter.js

@@ -12,21 +12,12 @@ import { uspsStage, uspsStatus } from './status.js';
 /**
  * USPS, through the server-rendered tracking page.
  *
- * The page at `go/TrackConfirmAction?tLabels=` carries the verdict, the
- * status and the history in its own HTML: no tracking XHR exists to capture.
- * Plain HTTP probes returned 403. Browser checks on 2026-09-22 first returned
- * a challenge shell, then succeeded with matching shipment timelines. Access
- * can vary by session. The lookup has a single
- * step: the private browser service loads the page, and the rendered DOM is
- * parsed. Nothing is ever replayed over plain HTTP.
- *
- * Markup provenance: the live page shell (`.track-bar-container`,
- * `#trackingNum`, `.latest-update-banner-wrapper .banner-header`,
- * `.current-tracking-status-wrapper`), inspected 2026-09-20. Positive lookups
- * on 2026-09-22 use `.tb-step` timeline cards, including collapsed history.
- * The older table-shaped fixture remains a parsing fallback.
+ * The `/tracking/{number}` page carries the verdict and collapsed history
+ * in its HTML. The legacy query route can return only the global header,
+ * so load the package path directly. The browser handles verification;
+ * nothing is replayed over plain HTTP.
  */
-const TRACKING_BASE = 'https://tools.usps.com/go/TrackConfirmAction';
+const TRACKING_BASE = 'https://tools.usps.com/tracking/';
 const MAX_BYTES = 10_000_000;
 const DEFAULT_TIMEOUT_MS = 90_000;
 const MAX_EVENTS_TO_RETURN = 100;
@@ -47,9 +38,7 @@ export function normalizeUSPSNumber(raw) {
     return value;
 }
 export function uspsTrackingUrl(trackingNumber) {
-    const url = new URL(TRACKING_BASE);
-    url.searchParams.set('tLabels', normalizeUSPSNumber(trackingNumber));
-    return url.toString();
+    return new URL(normalizeUSPSNumber(trackingNumber), TRACKING_BASE).toString();
 }
 const MONTHS = '(January|February|March|April|May|June|July|August|September|October|November|December)';
 const DATE_PATTERN = new RegExp(`${MONTHS}\\s+\\d{1,2},?\\s+\\d{4}`, 'i');

package/dist/carriers/usps/carrier.json

@@ -30,8 +30,8 @@
     "eta"
   ],
   "portal": {
-    "url": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-    "searchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+    "url": "https://tools.usps.com/tracking/{trackingNumber}",
+    "searchUrl": "https://tools.usps.com/tracking/",
     "canaryUrl": "https://www.usps.com/",
     "shows": [
       "status",
@@ -60,7 +60,8 @@
       ],
       "params": [
         "tLabels"
-      ]
+      ],
+      "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
     }
   ],
   "detection": [

package/dist/core/catalog/eventIdentity.js

@@ -2,9 +2,11 @@ import { sameInstantIdentityPolicy as aliexpress } from '../../carriers/aliexpre
 import { sameInstantIdentityPolicy as amazonShipping } from '../../carriers/amazon-shipping/app.js';
 import { sameInstantIdentityPolicy as australiaPost } from '../../carriers/australia-post/app.js';
 import { sameInstantIdentityPolicy as austrianPost } from '../../carriers/austrian-post/identity.js';
+import { sameInstantIdentityPolicy as canadaPost } from '../../carriers/canada-post/app.js';
 import { sameInstantIdentityPolicy as chronopost } from '../../carriers/chronopost/identity.js';
 import { sameInstantIdentityPolicy as ciblex } from '../../carriers/ciblex/identity.js';
 import { sameInstantIdentityPolicy as correosExpress } from '../../carriers/correos-express/identity.js';
+import { sameInstantIdentityPolicy as ctt } from '../../carriers/ctt/app.js';
 import { sameInstantIdentityPolicy as dpd } from '../../carriers/dpd/app.js';
 import { sameInstantIdentityPolicy as dpdFrance } from '../../carriers/dpd-fr/identity.js';
 import { sameInstantIdentityPolicy as hermesGermany } from '../../carriers/hermes-de/identity.js';
@@ -23,7 +25,7 @@ import { sameInstantIdentityPolicy as ups } from '../../carriers/ups/app.js';
 import { sameInstantIdentityPolicy as swissPost } from '../../carriers/swiss-post/app.js';
 import { sameInstantIdentityPolicy as yanwen } from '../../carriers/yanwen/app.js';
 import { sameInstantIdentityPolicy as universal } from '../../providers/shared/app.js';
-const policies = new Map([aliexpress, amazonShipping, australiaPost, austrianPost, chronopost, ciblex, correosExpress, dpd, dpdFrance, hermesGermany, indiaPost, jdLogistics, lbcExpress, mondialRelay, mrw, nzPost, posMalaysia, posteItaliane, posti, speedpak, sunYou, ups, swissPost, yanwen, universal].map((policy) => [policy.sourceCarrierId, policy]));
+const policies = new Map([aliexpress, amazonShipping, australiaPost, austrianPost, canadaPost, chronopost, ciblex, correosExpress, ctt, dpd, dpdFrance, hermesGermany, indiaPost, jdLogistics, lbcExpress, mondialRelay, mrw, nzPost, posMalaysia, posteItaliane, posti, speedpak, sunYou, ups, swissPost, yanwen, universal].map((policy) => [policy.sourceCarrierId, policy]));
 /** Unlisted sources cannot identify a reworded scan by its instant alone. */
 export function sameInstantIdentityPolicy(sourceCarrierId, options = {}) {
     const policy = policies.get(sourceCarrierId);

package/dist/data/catalog.json

@@ -2702,8 +2702,8 @@
             "browserRecognitionRank": 65
         },
         "canaryUrl": "https://www.usps.com/",
-        "trackingUrlTemplate": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-        "trackingSearchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+        "trackingUrlTemplate": "https://tools.usps.com/tracking/{trackingNumber}",
+        "trackingSearchUrl": "https://tools.usps.com/tracking/",
         "linkRules": [
             {
                 "domains": [
@@ -2712,7 +2712,8 @@
                 ],
                 "params": [
                     "tLabels"
-                ]
+                ],
+                "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
             }
         ],
         "detectionRules": [

package/dist/generated/catalog.d.ts

@@ -1830,11 +1830,12 @@ export declare const CARRIER_CATALOG: {
             readonly browserRecognitionRank: 65;
         };
         readonly canaryUrl: "https://www.usps.com/";
-        readonly trackingUrlTemplate: "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}";
-        readonly trackingSearchUrl: "https://tools.usps.com/go/TrackConfirmAction";
+        readonly trackingUrlTemplate: "https://tools.usps.com/tracking/{trackingNumber}";
+        readonly trackingSearchUrl: "https://tools.usps.com/tracking/";
         readonly linkRules: readonly [{
             readonly domains: readonly ["tools.usps.com", "usps.com"];
             readonly params: readonly ["tLabels"];
+            readonly path: "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$";
         }];
         readonly detectionRules: readonly [{
             readonly pattern: "^(?!9[23]61)(?:91\\d{2}9\\d{17}|92\\d{3}9\\d{16}|93\\d{3}[0-8]\\d{16}|9[45]\\d{20})$";

package/dist/generated/catalog.js

@@ -2703,8 +2703,8 @@ export const CARRIER_CATALOG = {
             "browserRecognitionRank": 65
         },
         "canaryUrl": "https://www.usps.com/",
-        "trackingUrlTemplate": "https://tools.usps.com/go/TrackConfirmAction?tLabels={trackingNumber}",
-        "trackingSearchUrl": "https://tools.usps.com/go/TrackConfirmAction",
+        "trackingUrlTemplate": "https://tools.usps.com/tracking/{trackingNumber}",
+        "trackingSearchUrl": "https://tools.usps.com/tracking/",
         "linkRules": [
             {
                 "domains": [
@@ -2713,7 +2713,8 @@ export const CARRIER_CATALOG = {
                 ],
                 "params": [
                     "tLabels"
-                ]
+                ],
+                "path": "^/tracking/(\\d{20}|\\d{22}|\\d{26}|[A-Z]{2}\\d{9}[A-Z]{2})/?$"
             }
         ],
         "detectionRules": [

package/dist/server/openapi.json

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

package/package.json

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