universal-parcel-scraper 0.764.1-main.4049 → 0.764.2-main.4053

package/README.md

@@ -161,7 +161,7 @@ the command line's `track --source ParcelsApp` does the same.
 <!-- 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 16,883 such statuses, each filed under one stage.
+The carrier folders record 16,891 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/dist/browser/scraper.js

@@ -31136,7 +31136,7 @@ function Ic(e) {
 			if (n != null && typeof n != "string") throw TypeError("The carrier adapter returned an invalid tracking event");
 		}
 		let t = { ...e };
-		if (t.point !== void 0) {
+		if (typeof t.location == "string" && !t.location.trim() && delete t.location, t.point !== void 0) {
 			let e = Xn(t.point) ? Nc(t.point.latitude, t.point.longitude) : null;
 			e ? t.point = e : delete t.point;
 		}

package/dist/carriers/chronopost/status.js

@@ -41,6 +41,8 @@ const OBSERVED = [
     ['TA', 'Colis en cours de livraison par le livreur', 'out_for_delivery'],
     ['RB', 'Colis en cours de livraison au point de retrait', 'in_transit'],
     ['AB', 'Colis mis à disposition au point de retrait', 'ready_for_pickup'],
+    // The courier left the parcel at another pickup point than the one planned, where it waits.
+    ['AB', 'Colis mis à disposition dans un point de retrait différent de celui prévu', 'ready_for_pickup'],
     // The same arrival at the pickup point, also written under SD and under MD.
     ['SD', 'Colis mis à disposition au point de retrait', 'ready_for_pickup'],
     ['MD', 'Colis mis à disposition au point de retrait', 'ready_for_pickup'],

package/dist/carriers/chronopost/statuses.json

@@ -312,6 +312,15 @@
       "wording": "Colis mis à disposition au point de retrait",
       "language": "fr"
     },
+    {
+      "code": "AB",
+      "stage": "ready_for_pickup",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-27",
+      "note": "Chronopost trackSkybillV2; code mapping requires matching wording. The parcel waits at another pickup point than the one planned.",
+      "wording": "Colis mis à disposition dans un point de retrait différent de celui prévu",
+      "language": "fr"
+    },
     {
       "code": "SD",
       "stage": "ready_for_pickup",

package/dist/carriers/correos-spain/adapter.js

@@ -6,7 +6,7 @@ import { zonedTime } from '../../core/time/index.js';
 import { clean, cleanScalar, fetchBounded, parseJsonBytes, UpstreamHttpError, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { isCorreosExpressCode } from '../correos-express/status.js';
-import { CORREOS_HOME_ZONE, correosOriginZone } from './clock.js';
+import { CORREOS_HOME_ZONE, correosOriginZone, correosUnitZone } from './clock.js';
 import { classifyCorreosSpainStatus, correosSpainEnglishSummary, NOTICE_CODES } from './status.js';
 // Protocol provenance:
 // - Prior art (structure + vocabulary, verified independently below, MIT):
@@ -41,12 +41,11 @@ const STAMP_FORMAT = 'dd/MM/yyyy HH:mm:ss';
 /**
  * When a scan happened. Correos splits it into fecEvento (DD/MM/YYYY) and
  * horEvento (HH:MM:SS, midnight when absent), a wall clock, read in Spanish
- * time: mainland Spain is Europe/Madrid, and Canary Islands scans stamped the
- * same way can be off by one hour, as events carry no locality. An origin
- * post's scan on an item from abroad has that post's wall clock (clock.ts):
- * it is read in `origin`, that post's zone, or kept as a wall clock when
- * `origin` is null, as the post's country keeps several. `timestamp` orders
- * the scans, on Madrid's reading for a wall clock.
+ * time: Europe/Madrid. A Canary Islands delivery unit's scans, and an origin
+ * post's scans on an item from abroad, have their own wall clock (clock.ts):
+ * they are read in `origin`, that zone, or kept as a wall clock when `origin`
+ * is null, as the post's country keeps several. `timestamp` orders the scans,
+ * on Madrid's reading for a wall clock.
  */
 function parsedTime(dateValue, timeValue, origin) {
     const date = clean(dateValue, 16);
@@ -154,14 +153,17 @@ function parseTracking(payload, trackingNumber, expeditionCode) {
     }
     const parsed = [];
     const seen = new Set();
-    const codes = [];
-    (Array.isArray(rawEvents) ? rawEvents : []).filter(isRecord).slice(0, 500).forEach((rawEvent, index) => {
+    const rows = (Array.isArray(rawEvents) ? rawEvents : []).filter(isRecord).slice(0, 500);
+    const codes = rows.map((rawEvent) => clean(rawEvent.codEvento, 32).toLocaleUpperCase('en-US')).filter(Boolean);
+    // codired is the unit holding the parcel, whose address the office locator gives.
+    const officeCode = cleanScalar(envelope.codired, 16);
+    const unitZone = correosUnitZone(officeCode, codes);
+    rows.forEach((rawEvent, index) => {
         const code = clean(rawEvent.codEvento, 32).toLocaleUpperCase('en-US');
-        if (code)
-            codes.push(code);
         // desTextoResumen is worded in the language codIdioma names.
         const description = clean(rawEvent.desTextoResumen, 500) || correosSpainEnglishSummary(code) || code;
-        const time = parsedTime(rawEvent.fecEvento, rawEvent.horEvento, correosOriginZone(requested, { code }));
+        const origin = correosOriginZone(requested, { code });
+        const time = parsedTime(rawEvent.fecEvento, rawEvent.horEvento, origin === undefined ? unitZone(code) : origin);
         if (!time || !description)
             return;
         const identity = `${time.time ?? time.local_time}\u0000${description}\u0000${code}`;
@@ -207,7 +209,6 @@ function parseTracking(payload, trackingNumber, expeditionCode) {
     // the envelope. The office is only a pickup signal when the parcel is
     // actually awaiting collection; weight/dims are operational parcel data.
     const office = clean(envelope.nom_codired, 300) || null;
-    const officeCode = cleanScalar(envelope.codired, 16);
     const grams = Number(envelope.peso);
     const weightKg = Number.isFinite(grams) && grams > 0 ? Math.round((grams / 1000) * 1000) / 1000 : null;
     const dims = [envelope.largo, envelope.ancho, envelope.alto].map((value) => Number(value));
@@ -222,7 +223,6 @@ function parseTracking(payload, trackingNumber, expeditionCode) {
         ...(weightKg != null ? { weight_kg: weightKg } : {}),
         ...(dimensionsText ? { dimensions_text: dimensionsText } : {}),
     };
-    // codired is the unit holding the parcel, whose address the office locator gives.
     const waiting = latest?.event.stage === 'ready_for_pickup' && office;
     const pickupExtras = waiting ? { pickup_point: office } : {};
     const pickupOffice = waiting && /^\d{1,16}$/.test(officeCode) ? officeCode : '';

package/dist/carriers/correos-spain/clock.d.ts

@@ -12,3 +12,9 @@ export declare function correosOriginZone(number: string, scan: {
 } | {
     wording: string;
 }): string | null | undefined;
+/**
+ * The clock of the delivery unit's scans when the unit holding the parcel is
+ * on the Canary Islands, which stamp their own wall clock; undefined for any
+ * other unit or scan, on Madrid's clock.
+ */
+export declare function correosUnitZone(unit: string, codes: readonly string[]): (code: string) => string | undefined;

package/dist/carriers/correos-spain/clock.js

@@ -35,3 +35,27 @@ export function correosOriginZone(number, scan) {
     const country = origin ? foreignOrigin(number) : null;
     return country ? countryTimeZone(country) : undefined;
 }
+/**
+ * A unit code (`codired`) opens with its province's two digits, as the office
+ * locator lists them: 35 (Las Palmas) and 38 (Santa Cruz de Tenerife) are the
+ * Canary Islands, an hour behind Madrid.
+ */
+const CANARY_UNIT = /^3[58]\d{5}$/;
+/**
+ * The delivery unit's scans: its registration of the parcel (G), the rounds,
+ * attempts and holds (H, not the collection from a sender's address,
+ * HI10002V), the end of a hold (L0), its hold for a return (O13) and the
+ * delivery.
+ */
+const DELIVERY_UNIT_CODE = /^(?:[GH]\d|L0|O13|I01H210V$|I010000V$)/;
+/** Handed back to the sender, whose unit the envelope may name from then on. */
+const BACK_TO_SENDER = new Set(['I020000V', 'I01H230V']);
+/**
+ * The clock of the delivery unit's scans when the unit holding the parcel is
+ * on the Canary Islands, which stamp their own wall clock; undefined for any
+ * other unit or scan, on Madrid's clock.
+ */
+export function correosUnitZone(unit, codes) {
+    const canary = CANARY_UNIT.test(unit) && !codes.some((code) => BACK_TO_SENDER.has(code));
+    return (code) => canary && DELIVERY_UNIT_CODE.test(code) ? 'Atlantic/Canary' : undefined;
+}

package/dist/carriers/correos-spain/identity.js

@@ -1,7 +1,8 @@
 // Scans stored while the localizador answered in Spanish take its English
 // wording in place: at one instant, the event code names the same scan. An
-// origin post's scans on an item from abroad kept the Madrid reading until
-// October 2026 and now show that post's clock, unless its country keeps several.
+// origin post's scans on an item from abroad, and a Canary Islands delivery
+// unit's, kept the Madrid reading until October 2026 and now show their own
+// clock, unless the origin's country keeps several.
 export const sameInstantIdentityPolicy = {
     sourceCarrierId: 'correos-spain', storedSources: ['correos-spain'], requireProviderCode: true, relabelledFrom: 'Europe/Madrid',
 };

package/dist/carriers/dhlink/status.js

@@ -48,6 +48,10 @@ const WORDINGS = new Map([
     ['package received & scanned at warehouse', 'accepted'],
     ['package received and scanned at warehouse', 'accepted'],
     ['parcel handed over to carrier,waiting for transportation', 'accepted'],
+    // A line's collection point and its domestic warehouse, before export.
+    ['the goods arrive at the receiving point', 'accepted'],
+    ["package received & scanned at carrier's domestic warehouse.", 'accepted'],
+    ["package depart carrier's domestic warehouse.", 'in_transit'],
     // China Post's receipt (中国邮政 已收取邮件).
     ['package received', 'accepted'],
     ['the package has sent from the warehouse', 'in_transit'],
@@ -115,12 +119,17 @@ const PATTERNS = [
     [/^离开【[^】]*】处理中心$/, 'in_transit'],
     [/^送交出口海关$/, 'customs'],
     // A line's own rows in Chinese, most with its English after them: the collection point and the
-    // operation centre, the warehouse's intake and customs' release before the flight, then the
-    // destination warehouse and the hand-over to the local carrier.
+    // operation centre, the warehouse's intake and customs' release before the flight, the flight,
+    // import clearance once the dispatch is unpacked, then the destination warehouse and the
+    // hand-over to the local carrier.
     [/^到达收货点$/, 'accepted'],
     [/^货物离开操作中心$/, 'in_transit'],
     [/^进仓时间[:：]/, 'in_transit'],
     [/^通关放行[;；]/, 'in_transit'],
+    [/^航班起飞[,，]/, 'in_transit'],
+    [/^航班已落地[;；]/, 'in_transit'],
+    [/^拆板清关中[;；]/, 'customs'],
+    [/^清关完成[,，]交仓中/, 'in_transit'],
     [/^货物已交仓[,，]/, 'in_transit'],
     [/^包裹交接给本地物流商处理/, 'in_transit'],
     [/安排投递$/, 'out_for_delivery'],

package/dist/carriers/dhlink/statuses.json

@@ -68,6 +68,13 @@
     {"wording": "货物已交仓，留意扫描； Pay attention to scanning", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "After import clearance, handed to the destination warehouse."},
     {"wording": "包裹交接给本地物流商处理，Received by local delivery company", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "Handed over to the local carrier."},
     {"wording": "预计配载航班时间：10-23；Estimated loading flight time:10-23", "unmapped": true, "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The flight the parcel is booked on, as another line words it, any date: no scan, so the adapter drops the row."},
+    {"wording": "THE GOODS ARRIVE AT THE RECEIVING POINT", "stage": "accepted", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The goods reached a line's collection point, beside 到达收货点."},
+    {"wording": "Package received & scanned at carrier's domestic warehouse.", "stage": "accepted", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The line's domestic warehouse took the parcel in."},
+    {"wording": "Package depart carrier's domestic warehouse.", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The parcel left the line's domestic warehouse."},
+    {"wording": "航班起飞，预计落地时间：10-25 Flight departure, estimated landing time:10-25", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The flight took off, with the day it lands; any day."},
+    {"wording": "航班已落地；The flight has Arrived", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The flight landed."},
+    {"wording": "拆板清关中；Dismantle the board and clear the gate", "stage": "customs", "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "Import clearance once the dispatch is unpacked from its pallet."},
+    {"wording": "清关完成，交仓中;Customs clearance completed,In transit", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "Import clearance done; on the way to the destination warehouse."},
     {"wording": "预计配载航班1月2日,Expected flight on January 2nd", "unmapped": true, "language": "zh", "confirmedBy": "live", "firstSeen": "2026-10-25", "note": "The flight the parcel is booked on, in Chinese and English, any date, written before the flight: no scan, so the adapter drops the row."},
     {"wording": "到达寄达地", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "note": "Arrived in the destination country."},
     {"wording": "目的港已提货 Delivery has been made at the destination port", "stage": "in_transit", "language": "zh", "confirmedBy": "live", "note": "Collected at the destination port after import clearance, before the destination's own scans; the English says a delivery, which it is not."},

package/dist/carriers/helthjem/parser.js

@@ -141,16 +141,17 @@ export function parseHelthjem(payload, rawNumber) {
     const events = scans.map(scan => scan.event);
     const newest = events[0];
     // The page headlines the parcel's state; the newest scan stands in without
-    // one, and for it when the scan's event code says more than their state.
-    const stateStage = !state ? undefined
-        : scans[0]?.state === state && newest?.stage ? newest.stage : helthjemStage(state);
+    // one, and the newest scan in that state for it, since its event code can
+    // say more than the state.
+    const own = state ? scans.find(scan => scan.state === state)?.event.stage : undefined;
+    const stateStage = !state ? undefined : own ?? helthjemStage(state);
     if (!newest && !state)
         throw new IndeterminateError(PROVIDER, 'Helthjem returned a parcel without a state or scans');
     const stage = stateStage ?? newest?.stage;
     const delivered = stage === 'delivered' ? deliveredAt(events) : undefined;
     // The night a booking names, while no scan but a terminal's has followed it.
     const booking = scans.find(scan => scan.state !== 'IN_TRANSIT')?.event;
-    const night = booking && stage === 'out_for_delivery' ? bookedNight(booking) : null;
+    const night = booking && stage === 'in_transit' ? bookedNight(booking) : null;
     // The point a parcel waits at, or was collected from, by its name alone.
     const point = state === 'READY_FOR_PICKUP' || state === 'PICKED_UP'
         ? (isRecord(parcel.servicePoint) ? clean(parcel.servicePoint.name, 160) : '') : '';

package/dist/carriers/helthjem/status.js

@@ -7,8 +7,8 @@ const STATES = new Map([
     // The shop announced the parcel; Helthjem does not have it yet.
     ['REGISTERED', { stage: 'registered', label: 'Pakken er registrert' }],
     ['IN_TRANSIT', { stage: 'in_transit', label: 'På vei til mottaker' }],
-    // Booked on the coming night's round, which the scan announces. A night
-    // missed is filed here too; its event code tells it apart.
+    // On the round. A booking on the coming night's round and a night missed
+    // are filed here too; their event codes tell them apart.
     ['DELIVERING', { stage: 'out_for_delivery', label: 'Leveres' }],
     ['DELIVERED', { stage: 'delivered', label: 'Levert' }],
     // A home delivery sent on to a pickup point instead.
@@ -26,8 +26,11 @@ const STATES = new Map([
 ]);
 /** Scans whose event code says more than their state. */
 const EVENTS = new Map([
+    // "Planlagt levering natt til 24. oktober!": the parcel is booked on the
+    // coming night's round, announced the day before. No courier has it yet.
+    ['DELIVERING/113', 'in_transit'],
     // "Budet fikk ikke med seg pakken din ut i natt": the night's courier did
-    // not take the parcel out, so it waits for a later round. Filed as delivering.
+    // not take the parcel out, so it waits for a later round.
     ['DELIVERING/057', 'in_transit'],
 ]);
 /** The state is a word of capitals and underscores. */

package/dist/carriers/helthjem/statuses.json

@@ -4,7 +4,7 @@
     { "code": "REGISTERED/001", "wording": "Nettbutikken har meldt at en pakke er på vei!", "language": "nb", "stage": "registered", "confirmedBy": "live", "note": "The shop announced the parcel; Helthjem does not have it yet." },
     { "code": "IN_TRANSIT/002", "wording": "Vi har mottatt pakken din, og gjør den klar for veien videre.", "language": "nb", "stage": "in_transit", "confirmedBy": "live", "note": "Received at a Helthjem terminal, which the scan names." },
     { "code": "IN_TRANSIT/003", "wording": "Pakken er under transport.", "language": "nb", "stage": "in_transit", "confirmedBy": "live", "note": "A terminal or sorter scan. The page hides the rows of its sorter, which it names VestbySorter; the adapter keeps them." },
-    { "code": "DELIVERING/113", "wording": "Planlagt levering natt til 8. oktober!", "language": "nb", "stage": "out_for_delivery", "confirmedBy": "live", "note": "Booked on the coming night's round; the wording names that night's date, which the adapter reads as the expected delivery day. Helthjem files the scan as delivering." },
+    { "code": "DELIVERING/113", "wording": "Planlagt levering natt til 8. oktober!", "language": "nb", "stage": "in_transit", "confirmedBy": "live", "note": "Booked on the coming night's round, the day before it: no courier has the parcel yet. The wording names that night's date, which the adapter reads as the expected delivery day. Helthjem files the scan as delivering; its code overrides that state, for the parcel too while it is the newest scan in that state." },
     { "code": "DELIVERING/057", "wording": "Budet fikk ikke med seg pakken din ut i natt.", "language": "nb", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-25", "note": "The night's courier did not take the parcel out, so it waits for a later round. Helthjem files the scan as delivering; its code overrides that state, for the parcel too while it is the newest scan." },
     { "code": "DELIVERED/013", "wording": "Pakken er levert på dørmatten din!", "language": "nb", "stage": "delivered", "confirmedBy": "live", "note": "Left at the door." },
     { "code": "DELIVERED/013", "wording": "Pakken er levert i postkassen din!", "language": "nb", "stage": "delivered", "confirmedBy": "live", "note": "Left in the letterbox." },

package/dist/core/result/index.js

@@ -150,6 +150,9 @@ export function normalizeCarrierResult(value) {
             }
         }
         const event = { ...rawEvent };
+        // A blank place is no place.
+        if (typeof event.location === 'string' && !event.location.trim())
+            delete event.location;
         if (event.point !== undefined) {
             const point = isRecord(event.point) ? eventPoint(event.point.latitude, event.point.longitude) : null;
             if (point)

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.764.1-main.4049"
+    "version": "0.764.2-main.4053"
   },
   "paths": {
     "/health": {

package/package.json

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