universal-parcel-scraper 0.69.2-main.888 → 0.69.3-main.891

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/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/server/openapi.json

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

package/package.json

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