universal-parcel-scraper 0.993.0-main.5345 → 0.993.1-main.5347

package/dist/carriers/dhlink/clock.d.ts

@@ -5,3 +5,5 @@ export declare const DHLINK_RECORD_ZONE = "Asia/Shanghai";
  * gives that instant.
  */
 export declare function usClockCopy(wall: string, timestamp: number): boolean;
+/** The US zone, the state's first, on whose clock `wall` strikes at `timestamp`; null when none does. */
+export declare function usClockZone(wall: string, timestamp: number, state?: string | null): string | null;

package/dist/carriers/dhlink/clock.js

@@ -10,5 +10,9 @@ const US_ZONES = ['America/New_York', 'America/Chicago', 'America/Denver', 'Amer
  * gives that instant.
  */
 export function usClockCopy(wall, timestamp) {
-    return US_ZONES.some((zone) => isoTime(wall, zone)?.timestamp === timestamp);
+    return usClockZone(wall, timestamp) !== null;
+}
+/** The US zone, the state's first, on whose clock `wall` strikes at `timestamp`; null when none does. */
+export function usClockZone(wall, timestamp, state) {
+    return [...(state ? [state] : []), ...US_ZONES].find((zone) => isoTime(wall, zone)?.timestamp === timestamp) ?? null;
 }

package/dist/carriers/dhlink/parser.js

@@ -7,7 +7,7 @@ import { countryCode, firstOccurrence, isoTime, usStateTimeZone } from '../../co
 import { cleanScalar } from '../../core/transport/text.js';
 import { isRecord } from '../../core/types.js';
 import { countryZones } from '../../places/zones.js';
-import { DHLINK_RECORD_ZONE as RECORD_ZONE, usClockCopy } from './clock.js';
+import { DHLINK_RECORD_ZONE as RECORD_ZONE, usClockCopy, usClockZone } from './clock.js';
 import { dhlinkEnglish, dhlinkStage, FLIGHT_BOOKED } from './status.js';
 export const PROVIDER = 'DHLink';
 // A long history is a few dozen kilobytes.
@@ -179,6 +179,10 @@ function projectRow(row, readAt) {
     return { stamp: local, event, rank, china, state, hub: usStateTimeZone(hub) !== null,
         recorded: Math.min(recordedAt(row) ?? readAt, readAt) };
 }
+/** A relayed wording without the town and state a US partner can write before it ("Sampletown IL, "). */
+function unplaced(description) {
+    return (description ?? '').replace(/^[A-Z][A-Za-z .'-]{0,40} [A-Z]{2}, /, '');
+}
 function outranks(left, right) {
     const index = left.findIndex((value, position) => value !== right[position]);
     return index >= 0 && left[index] > right[index];
@@ -259,6 +263,29 @@ export function parseDhlink(payload, raw, readAt = Date.now()) {
         const zone = scanZone(scan, destination, last?.leg.beijingClock === true && !(scan.hub && last.leg.hubClockPickup));
         return { scan, zone, time: zone ? isoTime(scan.stamp, zone) : null };
     });
+    // A US partner's scan can come twice, as UniUni's do: on its hub's wall clock, often after the
+    // hub's town, and on UTC. The UTC copy's clock is the other's on a US reading, to the second,
+    // before DHLink recorded either: one scan, on that US clock.
+    const utcCopies = new Set();
+    if (destination === 'US') {
+        for (const local of dated) {
+            if (utcCopies.has(local))
+                continue;
+            const wording = unplaced(local.scan.event.description);
+            const copy = dated.find((other) => {
+                if (other === local || utcCopies.has(other) || unplaced(other.scan.event.description) !== wording)
+                    return false;
+                const instant = isoTime(other.scan.stamp, 'UTC')?.timestamp;
+                return instant !== undefined && instant <= Math.min(local.scan.recorded, other.scan.recorded) + CLOCK_SKEW_MS
+                    && usClockZone(local.scan.stamp, instant, local.scan.state) !== null;
+            });
+            if (!copy)
+                continue;
+            const zone = usClockZone(local.scan.stamp, isoTime(copy.scan.stamp, 'UTC').timestamp, local.scan.state);
+            Object.assign(local, { zone, time: isoTime(local.scan.stamp, zone) });
+            utcCopies.add(copy);
+        }
+    }
     // Beside DHLink's own record of a partner's scan on Beijing time, the partner's copy can come
     // on its US wall clock: the same wording, at the instant of DHLink's row on a US reading.
     // Without a partner known to be relayed on Beijing time, DHLink's row must be read on it.
@@ -266,7 +293,7 @@ export function parseDhlink(payload, raw, readAt = Date.now()) {
         && other.scan.event.description === scan.event.description && usClockCopy(scan.stamp, other.time.timestamp))) : [];
     // A place naming only the destination country is the parcel's, not the scan's: a Canada line's
     // airline hand-over in China reads "Canada".
-    const kept = dated.filter((entry) => !copies.includes(entry));
+    const kept = dated.filter((entry) => !copies.includes(entry) && !utcCopies.has(entry));
     const events = kept
         .map(({ scan, time }) => {
         const { location, ...event } = scan.event;

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.993.0-main.5345"
+    "version": "0.993.1-main.5347"
   },
   "paths": {
     "/health": {

package/package.json

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