universal-parcel-scraper 0.49.2-main.556 → 0.49.2-main.558

package/README.md

@@ -149,7 +149,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 2,771 such statuses, each filed under one stage.
+The carrier folders record 2,772 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/dist/carriers/aliexpress/status.js

@@ -64,6 +64,8 @@ export const CAINIAO_ACTION_STATUS = new Map([
     // Station signed, not the recipient — must never read as delivered.
     ['GTMS_STA_SIGNED', 'out_for_delivery'],
     ['GTMS_SIGNED', 'delivered'],
+    // The courier could not deliver and tries again: a failed attempt, below.
+    ['GTMS_DEL_FAILURE', 'exception'],
     ['GTMS_STA_SIGN_FAILURE', 'exception'],
     ['EXCEPTION', 'exception'],
 ]);
@@ -91,6 +93,10 @@ export function cainiaoActionStage(code) {
         return 'customs';
     if (code === 'PU_PICKUP_SUCCESS')
         return 'accepted';
+    // Cainiao's last-mile gateway words it "Delivery Attempt Failure" in its
+    // `delivery_failed` group (seen live through Ecoscooting, another client).
+    if (code === 'GTMS_DEL_FAILURE')
+        return 'failed_attempt';
     const status = CAINIAO_ACTION_STATUS.get(code);
     return status ? cainiaoStageByStatus()[status] : undefined;
 }

package/dist/carriers/aliexpress/statuses.json

@@ -381,6 +381,13 @@
       "firstSeen": "2026-09-12",
       "note": "The only code that means the recipient has the parcel."
     },
+    {
+      "code": "GTMS_DEL_FAILURE",
+      "stage": "failed_attempt",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-08",
+      "note": "Seen live through Ecoscooting, a client of the same Cainiao last-mile gateway, as \"Delivery Attempt Failure\" with a reason such as the recipient not at home. No AliExpress reply has carried it yet."
+    },
     {
       "code": "GTMS_STA_SIGN_FAILURE",
       "stage": "exception",

package/dist/carriers/chronopost/identity.d.ts

@@ -0,0 +1,4 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+/** Whether an office label names one of Chronopost's services rather than a place. */
+export declare function isChronopostService(label: string): boolean;
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/chronopost/identity.js

@@ -0,0 +1,15 @@
+import { matchesDroppedLocation } from '../../core/catalog/locationIdentity.js';
+// Office labels that name a Chronopost service, not where the scan happened:
+// the shipper's labelling system on preparation scans, the notification
+// service on SMS and e-mail notices, and the partner network abroad.
+const SERVICES = new Set(['web services', "service d'avisage", 'chronopost networks']);
+/** Whether an office label names one of Chronopost's services rather than a place. */
+export function isChronopostService(label) {
+    return SERVICES.has(label.replace(/\s+/g, ' ').trim().replace(/’/g, "'").toLocaleLowerCase('fr-FR'));
+}
+// Scans stored with a service as their location lose it and keep their row.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'chronopost', storedSources: ['chronopost'], requireProviderCode: false,
+    matchEachScan: true,
+    matches: (incoming, stored) => matchesDroppedLocation(incoming, stored, isChronopostService),
+};

package/dist/carriers/chronopost/parser.js

@@ -5,6 +5,7 @@ import { languageStageStatus } from '../../core/status/index.js';
 import { calendarDay, countryCode, explicitOffsetTime } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { xmlDocument } from '../../core/transport/xml.js';
+import { isChronopostService } from './identity.js';
 import { chronopostStage, isChronopostNotification, isPickupDropOff } from './status.js';
 export const CHRONOPOST_MAX_BYTES = 2_000_000;
 const SOAP = 'http://schemas.xmlsoap.org/soap/envelope/';
@@ -78,14 +79,17 @@ const clockDay = (event) => {
 };
 /** Stages on the way to a planned delivery. */
 const ONGOING = new Set(['pending', 'registered', 'accepted', 'in_transit', 'customs', 'out_for_delivery']);
-/** Keep operational places, never the delivery-point address or shop contact block. */
+/**
+ * Keep operational places, never the delivery-point address or shop contact block,
+ * nor an office label that names a service ("Web Services", "Service d'avisage").
+ */
 function location(office, place) {
     if (/^[\p{L}\p{M} .,'’()-]{1,100} - [A-Z]{2}(?: \(depot \d{1,6}\))?$/u.test(place))
         return place;
     const shop = /^([\p{L}\p{M} .,'’-]{1,100}) - ([A-Z]{2}) - /u.exec(office);
     if (shop)
         return `${shop[1]}, ${shop[2]}`;
-    return /^[\p{L}\p{M} .,'’()/-]{1,160}$/u.test(office) ? office : '';
+    return /^[\p{L}\p{M} .,'’()/-]{1,160}$/u.test(office) && !isChronopostService(office) ? office : '';
 }
 export function parseChronopostTrackingXml(xml, rawNumber) {
     const requested = normalizeChronopostNumber(rawNumber);

package/dist/carriers/dpd-fr/adapter.js

@@ -5,6 +5,7 @@ import { eventPoint } from '../../core/result/index.js';
 import { runSteps } from '../../core/runner/index.js';
 import { zonedTime } from '../../core/time/index.js';
 import { TrawlClient, clean, decodeText, fetchBounded } from '../../core/transport/index.js';
+import { isDeliveryStatusCell } from './identity.js';
 import { classifyStatus, comparableText, includesAny } from './status.js';
 // Protocol provenance:
 // - DPD France publishes a server-rendered recipient page rather than a
@@ -146,7 +147,9 @@ export function parseDPDFranceTrackingHtml(html, rawTrackingNumber) {
         const date = clean(cells.eq(0).text(), 32);
         const clock = clean(cells.eq(1).text(), 32);
         const description = clean(cells.eq(2).text());
-        const location = clean(cells.eq(3).text());
+        const cell = clean(cells.eq(3).text());
+        // The delivered row's cell repeats the delivery, which is no place.
+        const location = isDeliveryStatusCell(cell) ? '' : cell;
         const time = parsedEventTime(date, clock);
         if (!time || !description)
             return;

package/dist/carriers/dpd-fr/identity.d.ts

@@ -0,0 +1,4 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+/** Whether a row's location cell states the delivery instead of a depot: "Livré au destinataire". */
+export declare function isDeliveryStatusCell(location: string): boolean;
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/dpd-fr/identity.js

@@ -0,0 +1,12 @@
+import { matchesDroppedLocation } from '../../core/catalog/locationIdentity.js';
+import { comparableText } from './status.js';
+/** Whether a row's location cell states the delivery instead of a depot: "Livré au destinataire". */
+export function isDeliveryStatusCell(location) {
+    return comparableText(location) === 'livre au destinataire';
+}
+// Scans stored with that status as their location lose it and keep their row.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'dpd-fr', storedSources: ['dpd-fr'], requireProviderCode: false,
+    matchEachScan: true,
+    matches: (incoming, stored) => matchesDroppedLocation(incoming, stored, isDeliveryStatusCell),
+};

package/dist/core/catalog/eventIdentity.js

@@ -1,12 +1,14 @@
 import { sameInstantIdentityPolicy as aliexpress } from '../../carriers/aliexpress/app.js';
 import { sameInstantIdentityPolicy as australiaPost } from '../../carriers/australia-post/app.js';
+import { sameInstantIdentityPolicy as chronopost } from '../../carriers/chronopost/identity.js';
 import { sameInstantIdentityPolicy as dpd } from '../../carriers/dpd/app.js';
+import { sameInstantIdentityPolicy as dpdFrance } from '../../carriers/dpd-fr/identity.js';
 import { sameInstantIdentityPolicy as indiaPost } from '../../carriers/india-post/app.js';
 import { sameInstantIdentityPolicy as mondialRelay } from '../../carriers/mondial-relay/identity.js';
 import { sameInstantIdentityPolicy as ups } from '../../carriers/ups/app.js';
 import { sameInstantIdentityPolicy as swissPost } from '../../carriers/swiss-post/app.js';
 import { sameInstantIdentityPolicy as universal } from '../../providers/shared/app.js';
-const policies = new Map([aliexpress, australiaPost, dpd, indiaPost, mondialRelay, ups, swissPost, universal].map((policy) => [policy.sourceCarrierId, policy]));
+const policies = new Map([aliexpress, australiaPost, chronopost, dpd, dpdFrance, indiaPost, mondialRelay, ups, swissPost, 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/core/catalog/locationIdentity.d.ts

@@ -1,3 +1,9 @@
 import type { SameInstantScan } from './eventIdentity.js';
 /** Adding a place must keep the scan's wording and known stage; conflicting places do not match. */
 export declare function matchesLocationEnrichment(incoming: SameInstantScan, stored: SameInstantScan): boolean;
+/**
+ * A scan whose adapter now drops the text it once gave as the location, a
+ * service's name or a status that is no place, must keep its wording and
+ * known stage. Only a stored location `dropped` names matches.
+ */
+export declare function matchesDroppedLocation(incoming: SameInstantScan, stored: SameInstantScan, dropped: (location: string) => boolean): boolean;

package/dist/core/catalog/locationIdentity.js

@@ -1,10 +1,22 @@
 const normalized = (value) => value.replace(/\s+/g, ' ').trim().toLocaleLowerCase('en-US');
+/** The same wording and the same known stage. */
+function sameScan(incoming, stored) {
+    const wording = normalized(incoming.description);
+    return Boolean(wording) && !['', 'unknown'].includes(incoming.stage)
+        && incoming.stage === stored.stage && wording === normalized(stored.description);
+}
 /** Adding a place must keep the scan's wording and known stage; conflicting places do not match. */
 export function matchesLocationEnrichment(incoming, stored) {
-    const wording = normalized(incoming.description);
     const location = normalized(incoming.location);
     const savedLocation = normalized(stored.location);
-    return Boolean(location && wording) && !['', 'unknown'].includes(incoming.stage)
-        && incoming.stage === stored.stage && wording === normalized(stored.description)
-        && (!savedLocation || location === savedLocation);
+    return Boolean(location) && sameScan(incoming, stored) && (!savedLocation || location === savedLocation);
+}
+/**
+ * A scan whose adapter now drops the text it once gave as the location, a
+ * service's name or a status that is no place, must keep its wording and
+ * known stage. Only a stored location `dropped` names matches.
+ */
+export function matchesDroppedLocation(incoming, stored, dropped) {
+    const savedLocation = stored.location.trim();
+    return !normalized(incoming.location) && Boolean(savedLocation) && dropped(savedLocation) && sameScan(incoming, stored);
 }

package/package.json

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