universal-parcel-scraper 0.1003.1-main.5421 → 0.1003.3-main.5425

package/README.md

@@ -163,7 +163,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 19,226 such statuses, each filed under one stage.
+The carrier folders record 19,229 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/js-express/statuses.json

@@ -132,6 +132,9 @@
     {"code": "DDF", "wording": "DELIVERY ATTEMPTED: 1ST DELIVERY ATTEMPT", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-06", "note": "The delivering courier's missed delivery, at the second of the courier's own scan for it."},
     {"code": "DDF", "wording": "DELIVERY ATTEMPTED: 2ND DELIVERY ATTEMPT", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-06", "note": "The courier's second missed delivery."},
     {"code": "DDE", "wording": "DELIVERY ATTEMPTED: 3RD DELIVERY ATTEMPT", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-06", "note": "The courier's third missed delivery, under the code JS Express also gives forwards, at the second of the courier's own scan saying the recipient must book a delivery."},
-    {"code": "OIT", "wording": "RECEIVED AT LOCAL DEPOT", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-06", "note": "The depot that delivers, minutes before each delivery round and again on the evening after a missed one: the courier's delivery depot, not a collection point."}
+    {"code": "OIT", "wording": "RECEIVED AT LOCAL DEPOT", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-06", "note": "The depot that delivers, minutes before each delivery round and again on the evening after a missed one: the courier's delivery depot, not a collection point."},
+    {"code": "DDE", "wording": "DELIVERY EXCEPTION", "stage": "exception", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-07", "note": "The delivering courier's exception at its transit hub, before any delivery round: no attempt, so an exception."},
+    {"code": "DDE", "wording": "DELIVERY EXCEPTION, WAIT FOR INFORMATION CONFIRMATION", "stage": "exception", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-07", "note": "The courier holding the parcel until its information is confirmed, listed after its warehouse arrival of the same second."},
+    {"code": "OIT", "wording": "ARRIVE AT THE WAREHOUSE", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-11-07", "note": "The delivering courier's warehouse taking the parcel back, listed before its exception of the same second, which keeps the parcel's stage."}
   ]
 }

package/dist/carriers/xcargo/status.js

@@ -1,8 +1,10 @@
 const STATES = {
     '101': { description: 'Shipment registered', stage: 'registered', type: 'line_haul' },
-    '199': { description: 'Shipment accepted', stage: 'in_transit', type: 'line_haul' },
+    // The first scan after the order's creation: X-Cargo takes the shipment in, before it is put in a container.
+    '199': { description: 'Shipment accepted', stage: 'accepted', type: 'line_haul' },
     '130': { description: 'Container closed', stage: 'in_transit', type: 'line_haul' },
     '131': { description: 'Container opened', stage: 'in_transit', type: 'line_haul' },
+    // A station's receipt after the container leg, like Big Smart's own code 200, so the parcel is already in transit.
     '200': { description: 'Received at station', stage: 'in_transit', type: 'line_haul' },
     '201': { description: 'At station', stage: 'in_transit', type: 'line_haul' },
     '210': { description: 'At last-mile station', stage: 'in_transit', type: 'last_mile' },

package/dist/carriers/xcargo/statuses.json

@@ -11,9 +11,10 @@
     {
       "code": "199",
       "wording": "Aceptación de envío",
-      "stage": "in_transit",
+      "stage": "accepted",
       "language": "es",
-      "confirmedBy": "portal"
+      "confirmedBy": "portal",
+      "note": "The line-haul scan after the order's creation and before containerization: X-Cargo takes the shipment in."
     },
     {
       "code": "130",
@@ -27,7 +28,8 @@
       "wording": "Recibido",
       "stage": "in_transit",
       "language": "es",
-      "confirmedBy": "portal"
+      "confirmedBy": "portal",
+      "note": "A station's receipt after the container leg, as Big Smart's platform uses code 200; the parcel is already in X-Cargo's hands."
     },
     {
       "code": "201",

package/dist/providers/parcelsapp/adapter.js

@@ -160,9 +160,18 @@ function dayOnlyNetworks(entries, minutes = false) {
     const walls = new Map();
     for (const { name, date, offset } of entries)
         walls.set(nameKey(name), [...walls.get(nameKey(name)) ?? [], offset ? null : mislabeledWallTime(date)]);
-    return new Set([...walls].filter(([, list]) => list.length >= 3 && dayClock(list, minutes)
-        && new Set(list.map((wall) => wall.slice(0, 10))).size >= 2).map(([key]) => key));
+    return new Set([...walls].filter(([key, list]) => STEP_COUNTED_NETWORKS.has(key)
+        ? list.every((wall) => wall !== null && STEP_COUNT.test(wall))
+        : list.length >= 3 && dayClock(list, minutes) && new Set(list.map((wall) => wall.slice(0, 10))).size >= 2).map(([key]) => key));
 }
+/**
+ * Networks whose steps ParcelsApp always dates by their day alone, at the top of an hour with
+ * seconds that count the steps, however few the reply has: myBRT.it's progress bar ("Spedizione
+ * consegnata a BRT" at 01:00:01, "In viaggio" at 01:00:02 the next day), steps BRT's own
+ * tracker does not list. Read as instants, they came seconds after midnight.
+ */
+const STEP_COUNTED_NETWORKS = new Set(['mybrtit']);
+const STEP_COUNT = /T\d{2}:00(?::0\d(?:\.0+)?)?$/;
 /**
  * Whether a network's wall clocks, in the reply's order, stand for no time:
  * all at 00:00:00, or all on one minute with whole seconds that step by one

package/dist/providers/shared/result.js

@@ -200,6 +200,10 @@ function sourceEventStage(description, includeBroadMovement = true) {
     // A sender's parcel left at a pick-up point for a courier to collect: an acceptance, not a parcel awaiting its recipient.
     if (/^the (?:parcel|package) has been delivered to the pick-?up point\. a courier will pick it up\b/i.test(description))
         return 'accepted';
+    // myBRT's progress bar, as ParcelsApp relays it: the shipment handed to BRT, which BRT's own page calls its collection
+    // (RITIRATA). "Consegnata" names the hand-over to BRT, not the delivery.
+    if (/^spedizione consegnata a brt[.!]?$/i.test(description))
+        return 'accepted';
     // Posti's handling labels survive in aggregator histories. Registration is
     // a repeated physical scan here, and the reason can describe future customs
     // or delivery without making either the event's stage.

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.1003.1-main.5421"
+    "version": "0.1003.3-main.5425"
   },
   "paths": {
     "/health": {

package/package.json

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