universal-parcel-scraper 0.976.0-main.5284 → 0.976.2-main.5286

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,042 such statuses, each filed under one stage.
+The carrier folders record 19,046 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

@@ -45529,7 +45529,7 @@ function cu(e) {
 	if (/^your parcel is in the air and is heading your way$|^your parcel's left the transfer country and is back on the move$|^touchdown! your parcel has landed$|^collected from the airline for processing$|^your parcel's on an interstate journey\. we'll keep you updated as it travels$/.test(t)) return "in_transit";
 	if (/^it's happening, your parcel will be delivered today\. get ready$|^parcel out for final mile carrier delivery$/.test(t)) return "out_for_delivery";
 	if (/^parcel unsafe to leave at address$/.test(t)) return "failed_attempt";
-	if (/^due to be delivered today(?: by\b.*)?$/.test(t)) return "out_for_delivery";
+	if (/^due (?:to be delivered|for delivery) today(?: by\b.*)?$/.test(t)) return "out_for_delivery";
 	if (/^your shipment (?:\d{7,} )?is due to be delivered on (?:mon|tues|wednes|thurs|fri|satur|sun)day \d{2}(?:st|nd|rd|th) [a-z]+ \d{4}$/.test(t)) return "in_transit";
 	if (/^the item is expected to be delivered today\.?$|^(?:the )?parcel is expected to be delivered during the day\.?$/.test(t)) return "out_for_delivery";
 	let n = Sl(t);
@@ -45597,7 +45597,7 @@ function cu(e) {
 	if (/^acceptance of the (?:package|parcel) at the delivery branch abroad$/.test(t)) return "in_transit";
 	if (/^acceptance of the (?:package|parcel) at the pick ?up point$/.test(t)) return "ready_for_pickup";
 	if (/^(?:package|parcel) received (?:&|and) scanned at (?:the )?carrier's domestic warehouse$/.test(t) || /^(?:the )?goods (?:arrive|arrived|have arrived) at (?:the )?receiving point$/.test(t) || /(?<!\b(?:no|nao) )\badmitid[oa]s?\b|\badmision (?:en origen|pais de origen)\b/.test(t) || /^aceite(?:\.|$)|\b(?:envio|objeto|objecto|encomenda|remessa) foi aceite\b/.test(t)) return "accepted";
-	if (/\bcross ?dock(?:ed|ing)?\b|\bready for outbound\b|^(?:(?:item|parcel|package|shipment) )?inbound scan(?:ned|ning)?\b|\b(?:un)?bagg(?:ed|ing)\b|\bmaster (?:air ?way ?bill|awb)(?: (?:number|no))? (?:received|assigned|allocated)\b|\bhand ?over to (?:the |an )?(?:airline|air carrier)\b|^(?:(?:the |your )?(?:item|parcel|package|shipment) )?(?:has )?left (?:the|our) warehouse$|\b(?:flight|leg)\b[^.;]*\b(?:is taking off|took off|has taken off|landed)\b|\bflight (?:take ?off|landing)\b|^(?:initial|final) landing$|\bcargo tally in the supervised warehouse\b|\bprepared for (?:the )?last[- ]mile hand ?over\b/.test(t) || /^(?:the |your )?(?:parcel|package|shipment|item) is (?:now )?at (?:the |a )?distribution cent(?:er|re)$/.test(t) || /^l'envoi est dans le reseau de livraison local$/.test(t) || /^there (?:has|have) been (?:a |an )?(?:slight |short |small |unexpected )?delay (?:with|to|in) (?:your |the )?(?:delivery|parcel|package|shipment|order)\.?$/.test(t) || /transit|\bline ?haul\b|en route|on (?:its|the) way|\bfacility\b|airport|\bleaving\b|\bdispatched\b|^delay(?:ed)?$|received by (?:the )?(?:local )?(?:delivery|logistics) company|\btransfer to (?:the |a |an )?(?:local |destination )?(?:acting |delivery |logistics |courier )?(?:company|agent|carrier|partner)\b|received by (?:postnl|uniuni)\b|notification.*sent to the recipient|delivery option requested|instruction de livraison recue|cambio (?:delle )?disposizioni di consegna|expedie (?:depuis|du|de)\b|acheminement|unterwegs|\bin viaggio\b|\bw drodze\b|\bonderweg\b|transport|trasport|arriv|depart|processed|processing completed|processing at (?:the )?(?:origin |destination )?branch\b|\breceipt of (?:the )?(?:package|parcel|shipment) at (?:the )?dpd branch\b|sorted|sorting|\btri\b|\btriee?s?\b|traitement|traite|sortier|bearbeitet|bearbeitung|elaborat|elaborazion|smistat|parcel cent(?:er|re)|delivery cent(?:er|re)|centre.*(?:colis|distribution)|paketzentrum|verteilzentrum|centro.*(?:pacchi|distribuzione)|depot|import scan|scan.*import|importscan|scansione.*import|delivery.*delayed|livraison.*(?:retard|report)|zustellung.*verzogert|consegna.*ritard|transferred|transfere|weitergeleitet|inoltrato|left.*(?:point|center)|quitte|verlassen|raggiunto|close bag|fermeture du sac|sack.*geschlossen|chiusura.*sacco|scanned into|scanne dans|eingescannt|scansionat|\b(?:un)?loaded\b|^(?:item|parcel|shipment) distributed$|charg.*vehicule de transport|transportfahrzeug.*geladen|caric.*veicolo.*trasporto/.test(t) || /^enviad[oa]$|\bclasificad[oa]s?\b|\bclasificacion\b|\ben ruta\b|\ben camino\b|\bcargad[oa]s? en (?:el )?vehiculo\b|\bllegad[oa]s? (?:a|al|en)\b|\bllegada (?:a|al|en|de)\b|\bha llegado\b|\bllego (?:a|al)\b|\bsalida (?:de|del|desde)\b|\b(?:ha )?salido (?:de|del)\b|\bsalio (?:de|del)\b|\ben destino\b|\b(?:agencia|delegacion|plataforma|oficina|franquicia) (?:de )?destino\b|\b(?:unidad|centro|oficina|delegacion|base|agencia|plataforma) de reparto\b|\bcentro (?:de )?(?:clasificacion|distribucion|tratamiento|logistico|operaciones|operativo)\b|\blectura\b|\bleid[oa]s?\b|\brecepcionad[oa]s?\b|\bprocesad[oa]s?\b|\bexpedid[oa]s?\b|\btriagem\b|\btriad[oa]s?\b|\bem tratamento\b|\btratad[oa]s?\b|\bcentro (?:de )?(?:distribuicao|tratamento|triagem|operacional)\b|\bchegad[ao] (?:a|ao|no|na|em)\b|\bchegou (?:a|ao|no|na|em)\b|\bsaida (?:do|da|de|dos|das)\b|\bsaiu (?:do|da|de|dos|das)\b|\bem rota\b|\ba caminho\b|\bencaminhad[oa]s?\b|\b(?:em )?transferencia\b|\btransferid[oa]s?\b|\bprocessad[oa]s?\b|\brecebid[oa] (?:no|na|em) (?:centro|armazem|unidade|plataforma)\b|\brecibid[oa] en (?:el |la |nuestr[oa] )?(?:almacen|centro|delegacion|plataforma|hub|agencia)\b/.test(t)) return "in_transit";
+	if (/\bcross ?dock(?:ed|ing)?\b|\bready for outbound\b|^(?:(?:item|parcel|package|shipment) )?inbound scan(?:ned|ning)?\b|\b(?:un)?bagg(?:ed|ing)\b|\bmaster (?:air ?way ?bill|awb)(?: (?:number|no))? (?:received|assigned|allocated)\b|\bhand ?over to (?:the |an )?(?:airline|air carrier)\b|^(?:(?:the |your )?(?:item|parcel|package|shipment) )?(?:has )?left (?:the|our) warehouse$|\b(?:flight|leg)\b[^.;]*\b(?:is taking off|took off|has taken off|landed)\b|\bflight (?:take ?off|landing)\b|^(?:initial|final) landing$|\bcargo tally in the supervised warehouse\b|\bprepared for (?:the )?last[- ]mile hand ?over\b/.test(t) || /^(?:the )?noa (?:has been |was )?received$|^noa-notification of arrival\b/.test(t) || /^(?:the |your )?(?:parcel|package|shipment|item) is (?:now )?at (?:the |a )?distribution cent(?:er|re)$/.test(t) || /^l'envoi est dans le reseau de livraison local$/.test(t) || /^there (?:has|have) been (?:a |an )?(?:slight |short |small |unexpected )?delay (?:with|to|in) (?:your |the )?(?:delivery|parcel|package|shipment|order)\.?$/.test(t) || /transit|\bline ?haul\b|en route|on (?:its|the) way|\bfacility\b|airport|\bleaving\b|\bdispatched\b|^delay(?:ed)?$|received by (?:the )?(?:local )?(?:delivery|logistics) company|\btransfer to (?:the |a |an )?(?:local |destination )?(?:acting |delivery |logistics |courier )?(?:company|agent|carrier|partner)\b|received by (?:postnl|uniuni)\b|notification.*sent to the recipient|delivery option requested|instruction de livraison recue|cambio (?:delle )?disposizioni di consegna|expedie (?:depuis|du|de)\b|acheminement|unterwegs|\bin viaggio\b|\bw drodze\b|\bonderweg\b|transport|trasport|arriv|depart|processed|processing completed|processing at (?:the )?(?:origin |destination )?branch\b|\breceipt of (?:the )?(?:package|parcel|shipment) at (?:the )?dpd branch\b|sorted|sorting|\btri\b|\btriee?s?\b|traitement|traite|sortier|bearbeitet|bearbeitung|elaborat|elaborazion|smistat|parcel cent(?:er|re)|delivery cent(?:er|re)|centre.*(?:colis|distribution)|paketzentrum|verteilzentrum|centro.*(?:pacchi|distribuzione)|depot|import scan|scan.*import|importscan|scansione.*import|delivery.*delayed|livraison.*(?:retard|report)|zustellung.*verzogert|consegna.*ritard|transferred|transfere|weitergeleitet|inoltrato|left.*(?:point|center)|quitte|verlassen|raggiunto|close bag|fermeture du sac|sack.*geschlossen|chiusura.*sacco|scanned into|scanne dans|eingescannt|scansionat|\b(?:un)?loaded\b|^(?:item|parcel|shipment) distributed$|charg.*vehicule de transport|transportfahrzeug.*geladen|caric.*veicolo.*trasporto/.test(t) || /^enviad[oa]$|\bclasificad[oa]s?\b|\bclasificacion\b|\ben ruta\b|\ben camino\b|\bcargad[oa]s? en (?:el )?vehiculo\b|\bllegad[oa]s? (?:a|al|en)\b|\bllegada (?:a|al|en|de)\b|\bha llegado\b|\bllego (?:a|al)\b|\bsalida (?:de|del|desde)\b|\b(?:ha )?salido (?:de|del)\b|\bsalio (?:de|del)\b|\ben destino\b|\b(?:agencia|delegacion|plataforma|oficina|franquicia) (?:de )?destino\b|\b(?:unidad|centro|oficina|delegacion|base|agencia|plataforma) de reparto\b|\bcentro (?:de )?(?:clasificacion|distribucion|tratamiento|logistico|operaciones|operativo)\b|\blectura\b|\bleid[oa]s?\b|\brecepcionad[oa]s?\b|\bprocesad[oa]s?\b|\bexpedid[oa]s?\b|\btriagem\b|\btriad[oa]s?\b|\bem tratamento\b|\btratad[oa]s?\b|\bcentro (?:de )?(?:distribuicao|tratamento|triagem|operacional)\b|\bchegad[ao] (?:a|ao|no|na|em)\b|\bchegou (?:a|ao|no|na|em)\b|\bsaida (?:do|da|de|dos|das)\b|\bsaiu (?:do|da|de|dos|das)\b|\bem rota\b|\ba caminho\b|\bencaminhad[oa]s?\b|\b(?:em )?transferencia\b|\btransferid[oa]s?\b|\bprocessad[oa]s?\b|\brecebid[oa] (?:no|na|em) (?:centro|armazem|unidade|plataforma)\b|\brecibid[oa] en (?:el |la |nuestr[oa] )?(?:almacen|centro|delegacion|plataforma|hub|agencia)\b/.test(t)) return "in_transit";
 	if (/^(?:приинято|принято)$/.test(t)) return "accepted";
 	if (zl.test(t)) return "in_transit";
 }

package/dist/carriers/geodis-pl/status.js

@@ -33,6 +33,7 @@ const CODES = new Map([
     ['15', 'accepted'],
     // The driver could not collect the shipment from the sender.
     ['14', 'exception'],
+    // A terminal's receipt from a driver: after the collection, or after a round that brought it back undelivered.
     ['20', 'in_transit'],
     ['30', 'in_transit'],
     ['40', 'in_transit'],

package/dist/carriers/geodis-pl/statuses.json

@@ -4,7 +4,7 @@
     {"code": "10", "wording": "Received from the sender", "language": "en", "stage": "accepted", "confirmedBy": "live"},
     {"code": "15", "wording": "Collected (SMS)", "language": "en", "stage": "accepted", "confirmedBy": "portal", "note": "The collection from the sender, confirmed by text message."},
     {"code": "14", "wording": "Failed collection (SMS)", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "The driver could not collect the shipment from the sender."},
-    {"code": "20", "wording": "Inbound Scan From Driver to Terminal", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The collecting terminal received the shipment from the driver."},
+    {"code": "20", "wording": "Inbound Scan From Driver to Terminal", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "A terminal received the shipment from a driver: the collecting one after the collection, or the delivery terminal after a round that brought it back undelivered. Without an attempt code (65, 68) the round made no attempt: the shipment waits for another round."},
     {"code": "30", "wording": "Outbound Scan from (Collection) Terminal to Line-haul", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
     {"code": "40", "wording": "Inbound Scan from Line-haul to (Delivery) Terminal", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
     {"code": "50", "wording": "Outbound for Delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "portal"},

package/dist/carriers/hermes-de/status.js

@@ -50,6 +50,8 @@ export const STATUSES = {
     DELIVERY_FAILED_NOT_MET_1X: milestone('failed_attempt', 'exception', 'Recipient not met; another attempt follows'),
     DELIVERY_FAILED_NOT_MET_2X: milestone('failed_attempt', 'exception', 'Recipient not met a second time; another attempt follows'),
     DELIVERY_FAILED_NOT_MET_3X: milestone('failed_attempt', 'exception', 'Recipient not met three times; book a delivery within 10 days or the parcel goes back'),
+    // The last round: the parcel goes back to the sender, whose return scan follows.
+    DELIVERY_FAILED_NOT_MET_4X: milestone('failed_attempt', 'exception', 'Recipient not met; the parcel goes back to the sender'),
     INTERNATIONAL_DELIVERY_FAILED: milestone('failed_attempt', 'exception', 'Delivery attempt unsuccessful'),
     INTERNATIONAL_DELIVERY_FAILED_ADDRESS: milestone('failed_attempt', 'exception', 'Delivery address not found'),
     INTERNATIONAL_PUDO_READY_FOR_COLLECTION: milestone('ready_for_pickup', 'out_for_delivery', 'Ready for collection at a parcel shop'),

package/dist/carriers/hermes-de/statuses.json

@@ -252,6 +252,13 @@
       "firstSeen": "2026-11-05",
       "note": "The third attempt without meeting the recipient, who has 10 days to book a delivery before the parcel goes back to the sender"
     },
+    {
+      "code": "DELIVERY_FAILED_NOT_MET_4X",
+      "stage": "failed_attempt",
+      "confirmedBy": "live",
+      "firstSeen": "2026-11-05",
+      "note": "The fourth round without meeting the recipient, after which the parcel goes back to the sender"
+    },
     {
       "code": "NOT_DELIVERABLE",
       "stage": "exception",

package/dist/carriers/india-post/app.js

@@ -1,6 +1,11 @@
-// MySpeedPost changes a scan's wording while its instant and event_type stay the same.
+// MySpeedPost rewords a scan, and can restate it under another event_type, at the same
+// second and office: "Item bagged" (ItemBagged) as "Bag Closed" (BagOpened), "Item
+// Dispatched" as "Bag Dispatched". A reply never holds two scans at one second and office,
+// so the scan at that second and office, the only one both ways, is the stored one.
 // Scans abroad were read on India's clock until October 2026 and now show the
 // destination's offset, unless a reply lacks what places them abroad.
 export const sameInstantIdentityPolicy = {
-    sourceCarrierId: 'india-post', storedSources: ['india-post'], requireProviderCode: true, relabelledFrom: 'Asia/Kolkata',
+    sourceCarrierId: 'india-post', storedSources: ['india-post'], requireProviderCode: false, matchEachScan: true,
+    matches: (incoming, stored) => incoming.location.trim() === stored.location.trim(),
+    relabelledFrom: 'Asia/Kolkata',
 };

package/dist/carriers/jrt/statuses.json

@@ -807,6 +807,33 @@
       "firstSeen": "2026-11-04",
       "note": "On JRT's road line to Europe, the container leaving for Xinjiang, the way out of China, after the Shenzhen distribution center."
     },
+    {
+      "wording": "已抵达新疆，换装/报关，待出境",
+      "language": "zh",
+      "english": "Arrived in Xinjiang for transloading and export declaration, waiting to leave China",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-11-05",
+      "note": "On JRT's road line to Europe, after the container's departure for Xinjiang and before the border exit."
+    },
+    {
+      "wording": "因哈萨克斯坦拥堵，外车入境新疆拥堵缓慢，在等待外车倒装后报关出境。",
+      "language": "zh",
+      "english": "Congestion in Kazakhstan is slowing foreign trucks into Xinjiang; the parcel will be declared for export once it is reloaded onto one",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-11-05",
+      "note": "A delay at the Xinjiang border on JRT's road line to Europe; the exit from China follows."
+    },
+    {
+      "wording": "已出境，哈萨克斯坦阿拉木图",
+      "language": "zh",
+      "english": "Left China, Almaty, Kazakhstan",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-11-05",
+      "note": "The border exit on JRT's road line to Europe, naming the first town after it."
+    },
     {
       "wording": "Shipping Label Created",
       "language": "en",

package/dist/core/status/language.js

@@ -260,9 +260,9 @@ export function trackingLanguageStage(description) {
         return 'out_for_delivery';
     if (/^parcel unsafe to leave at address$/.test(text))
         return 'failed_attempt';
-    // Royal Mail's delivery-round scans (EVGPD, EVKPD), as universal providers relay them: the
-    // delivery today is its out-for-delivery scan, not a forecast.
-    if (/^due to be delivered today(?: by\b.*)?$/.test(text))
+    // Royal Mail's delivery-round scans (EVGPD, EVKPD), as universal providers relay them, Postal
+    // Ninja as "Due for delivery today": the delivery today is its out-for-delivery scan, not a forecast.
+    if (/^due (?:to be delivered|for delivery) today(?: by\b.*)?$/.test(text))
         return 'out_for_delivery';
     // DHL eCommerce UK's row for the day it plans to deliver on, which follows the collection, as
     // universal providers relay it with the shipment's number: the carrier's map reads it in transit.
@@ -716,6 +716,10 @@ export function trackingLanguageStage(description) {
     // the parcel on.
     if (/\bcross ?dock(?:ed|ing)?\b|\bready for outbound\b|^(?:(?:item|parcel|package|shipment) )?inbound scan(?:ned|ning)?\b|\b(?:un)?bagg(?:ed|ing)\b|\bmaster (?:air ?way ?bill|awb)(?: (?:number|no))? (?:received|assigned|allocated)\b|\bhand ?over to (?:the |an )?(?:airline|air carrier)\b|^(?:(?:the |your )?(?:item|parcel|package|shipment) )?(?:has )?left (?:the|our) warehouse$|\b(?:flight|leg)\b[^.;]*\b(?:is taking off|took off|has taken off|landed)\b|\bflight (?:take ?off|landing)\b|^(?:initial|final) landing$|\bcargo tally in the supervised warehouse\b|\bprepared for (?:the )?last[- ]mile hand ?over\b/.test(text))
         return 'in_transit';
+    // The airline's notice of arrival (NOA) reaching the destination agent, after the landing and
+    // before clearance, as Shouwu, JRT and the ground handlers word it.
+    if (/^(?:the )?noa (?:has been |was )?received$|^noa-notification of arrival\b/.test(text))
+        return 'in_transit';
     // A linehaul is the trunk haul between hubs, whatever was handed over.
     // A parcel at a distribution centre, the whole scan, as Lietuvos paštas words it. Other scans naming
     // such a centre, a courier's origin scan or a retailer's order sent to its store, say less.

package/dist/providers/parcelsapp/adapter.js

@@ -22,6 +22,7 @@ import { countryName, militaryPostOffice } from '../../places/trackingLocation.j
 import { hasSeveralClocks, keepsZone, mainZone } from '../../places/zones.js';
 import { captureFailure, capturedBodies, loadCapture } from '../shared/capture.js';
 import { CAINIAO_CHINA_LEG, CAINIAO_CHINA_ZONE } from '../../carriers/aliexpress/clock.js';
+import { chinaPostEnglish, chinaPostLabelPlace } from '../../carriers/china-post/status.js';
 import { correosOriginZone } from '../../carriers/correos-spain/clock.js';
 import { cttSiteZone, portugalZone } from '../../carriers/ctt/clock.js';
 import { DHLINK_RECORD_ZONE, usClockCopy } from '../../carriers/dhlink/clock.js';
@@ -1762,6 +1763,17 @@ function parseHistory(payload, trackingNumber, timezone = null, readAt = Date.no
             const location = scan?.location ?? reportedPlace(raw.location);
             if (location && !/^Type de livraison\s*:/i.test(location))
                 parsed.location = location;
+            // China Post words its labels in Chinese only, also those it gives the destination post's scans:
+            // they show in English where it is known, staged as the Chinese was, with the place left to the
+            // location, or taken from the label's 【】 where none is given, as 17TRACK's copies of them are.
+            const english = !scan && typeof name === 'string' && carrierIdFromName(name) === 'china-post'
+                && /\p{Script=Han}/u.test(parsed.description ?? '') ? chinaPostEnglish(parsed.description) : undefined;
+            if (english) {
+                const named = parsed.location ? '' : reportedPlace(chinaPostLabelPlace(parsed.description) ?? '');
+                parsed.description = english;
+                if (named)
+                    parsed.location = named;
+            }
             events.push(parsed);
             carried.push({ event: parsed, carrier: nameKey(name) });
             scanCarriers.add(name);

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.976.0-main.5284"
+    "version": "0.976.2-main.5286"
   },
   "paths": {
     "/health": {

package/package.json

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