universal-parcel-scraper 0.49.1-main.549 → 0.49.2-main.551

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,756 such statuses, each filed under one stage.
+The carrier folders record 2,758 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

@@ -4937,8 +4937,8 @@ function Yt(e) {
 	if (/will be transported|sera (?:transporte|achemine)|wird.*transportiert|sara trasportat/.test(t) || /will be available|sera disponible|(?:sera|va etre|doit etre) (?:distribue|remis|mis en (?:livraison|distribution))|wird.*verfugbar|sara disponibile|to be delivered|a livrer|noch zuzustellen|da consegnare|(?:once|when|as soon as) (?:the |your )?(?:shipment|parcel|package|item) is out for delivery/.test(t) || /\bestara disponi(?:ble|vel)\b|\bpor entregar\b|\bpendiente de (?:entrega|entregar|reparto)\b|\bpendente de entrega\b|\b(?:aguarda|aguardando|a aguardar) (?:a )?entrega\b|\bsera (?:enviad|transportad|expedid|encaminhad)[oa]s?\b/.test(t)) return "in_transit";
 	if (/ready for (?:pickup|collection)|ready to collect|available for (?:pickup|collection)|awaiting (?:customer |recipient |your )?(?:pickup|collection)|pret.*(?:retrait|retire)|disponible.*(?:retrait|collecte)|vous attend (?:au|en|dans|chez|a)\b|mise? a disposition (?:au|en|dans|a)\b.*(?:point (?:de )?retrait|relais|consigne|locker|bureau de poste|agence)|jours? restants? pour (?:le )?retirer|abholbereit|zur abholung bereit|pront[oa] per il ritiro|disponibile per il ritiro|(?:deposited|depose|hinterlegt|depositat[oa]).*mypost24/.test(t) || /(?<!\b(?:no|nao|ya no|ja nao) (?:(?:esta|estara|se encuentra|se encontra|e|era|foi) )?)\bdisponi(?:ble|vel) (?:para (?:su |ser )?(?:recoger|recogida|recogid[oa]|retirar|retiro|retirada|retirad[oa]|levantamento|levantar|levantad[oa]|recolha|recolher)|(?:en|no|na|num|numa|em) (?:el |la |un |una |su |tu |nuestr[oa] )?(?:punto|oficina|tienda|locker|taquilla|consigna|citypaq|parcel ?shop|buzon inteligente|agencia|delegacion|sucursal|ponto|loja|cacifo|estacao|balcao|payshop|posto|unidade))\b|\blist[oa] para (?:su |ser )?(?:recoger|recogida|recogid[oa]|retirar|retiro)\b|\bpront[oa] (?:para|a) (?:ser )?(?:levantamento|levantar|levantad[oa]|recolha|recolher|retirada|retirar)\b|\b(?:ya )?(?:puede|puedes|podra|podras) (?:pasar a )?recoger(?:lo|la)?\b|\b(?:aguarda|aguardando|a aguardar) (?:o |a )?(?:levantamento|retirada)\b|\besperando (?:su|tu) recogida\b|\b(?:pendiente de|esperando|a la espera de) (?:ser )?recogid[oa] por (?:el |la )?destinatari[oa]\b/.test(t)) return "ready_for_pickup";
 	if (/label (?:created|printed)|(?:created|generated) a (?:new )?(?:shipment |shipping )?label|etiquette.*(?:cree|imprime)|cree une etiquette|versandetikett.*(?:erstellt|gedruckt)|etikett erstellt|etichetta.*(?:creata|stampata)|creato un'etichetta|elektronisch|electroni(?:c|que|sch)|elettronic|pre.?advi[cs]|preannunciat|vorangemeldet|preannonce|data.*entered|donnees.*saisies|daten.*erfasst|dati.*inseriti/.test(t) || /shipment information (?:received|sent to)|\bdata received\b|(?:package|parcel|shipment) data (?:was |has been )?sent to|\bpre ?notification\b|informations d'expedition recues|sendungsinformationen erhalten|informazioni.*spedizione ricevute|(?:consignment|shipment|parcel|package) recorded by|envoi enregistre par|sendung.*absender.*erfasst|spedizione registrata dal/.test(t) || /preparation chez.*expediteur|preparation.*expediteur|preparazione.*mittente|being prepared.*sender|(?:shipper|sender)(?: that)? (?:they are|is|are) preparing|beim absender.*vorbereitet|warehouse of the sender|shippers warehouse|entrepot de l'expediteur|lager des absenders|magazzino del mittente|demande d'envoi.*prise en compte|collection request.*(?:received|recorded)|abholauftrag.*erfasst|richiesta.*ritiro.*registrata/.test(t) || /^(?:reported|recorded|announced|item created|enregistre|annonce|erfasst|angekundigt|registrato|annunciato)$/.test(t)) return "registered";
-	if (/attend d'etre libere|attente de liberation|wartet auf.*freigabe|attesa di svincolo|(?:customs|clearance).*\bnot\b.*(?:clear|complet|releas)|dedouanement.*pas termine|customs (?:not cleared|clearance not completed)|not.*released by customs|dedouanement.*(?:non termine|pas termine)|(?:\bnot|n't|\bnever)(?: yet)?(?: been)? cleared (?:through |by )?customs|\bbe(?:ing)? cleared (?:through |by )?customs|non dedouane|zollabfertigung.*nicht abgeschlossen|nicht.*zoll.*freigegeben|sdoganamento.*non completato|non sdoganat/.test(t)) return "customs";
-	if (/clearance.*(?:has been completed|completed)|clearance (?:complete|success)|(?:leaving|departed from|left) customs|completion of customs|formalites.*(?:terminee|achevee)|released by (?:customs|a government agency)|customs (?:cleared|(?:has |have )?released)|\bcleared (?:through |by )?customs|dedouanement.*(?:termine|acheve)|fin du dedouanement|libere.*(?:douane|autorite)|douane.*libere|zollabfertigung.*abgeschlossen|(?:zoll|behorde).*freigegeben|sdoganamento.*completato|completamento.*sdoganamento|svincolat.*(?:dogana|autorita)/.test(t)) return "in_transit";
+	if (/attend d'etre libere|attente de liberation|wartet auf.*freigabe|attesa di svincolo|(?:customs|clearance).*\bnot\b.*(?:clear|complet|releas)|dedouanement.*pas termine|customs (?:not cleared|clearance not completed)|not.*released by customs|(?:\bnot|n't|\bnever)(?: yet)?(?: been)? released (?:by |from )?(?:(?:import|export)(?:\/export)? )?customs|\b(?:be|being) released from (?:(?:import|export)(?:\/export)? )?customs|dedouanement.*(?:non termine|pas termine)|(?:\bnot|n't|\bnever)(?: yet)?(?: been)? cleared (?:through |by )?customs|\bbe(?:ing)? cleared (?:through |by )?customs|non dedouane|zollabfertigung.*nicht abgeschlossen|nicht.*zoll.*freigegeben|sdoganamento.*non completato|non sdoganat/.test(t)) return "customs";
+	if (/clearance.*(?:has been completed|completed)|clearance (?:complete|success)|(?:leaving|departed from|left) customs|completion of customs|formalites.*(?:terminee|achevee)|released from (?:(?:import|export)(?:\/export)? )?customs|released by (?:customs|a government agency)|customs (?:cleared|(?:has |have )?released)|\bcleared (?:through |by )?customs|dedouanement.*(?:termine|acheve)|fin du dedouanement|libere.*(?:douane|autorite)|douane.*libere|zollabfertigung.*abgeschlossen|(?:zoll|behorde).*freigegeben|sdoganamento.*completato|completamento.*sdoganamento|svincolat.*(?:dogana|autorita)/.test(t)) return "in_transit";
 	if (/customs|clearance|douan|formalites (?:d')?(?:import|export)|zoll|dogan|government agency|autorite gouvernementale|staatliche behorde|autorita governativa/.test(t)) return "customs";
 	if (/out for (?:physical )?delivery|being delivered|in delivery|(?:loading|loaded).*delivery vehicle|on (?:\w+ )?vehicle for delivery|(?:courier|driver|delivery champion) has (?:the|your) (?:shipment|parcel|package|item)|en cours de livraison|en livraison|de la livraison de (?:son|votre) colis ce jour|charg(?:e|ement).*vehicule de livraison|in zustellung|zustellfahrzeug.*(?:geladen|verladen)|(?:beladen|verladung).*zustellfahrzeug|in consegna|caric(?:at|amento).*veicolo.*consegna/.test(t) || /^(?:en )?reparto$|\ben reparto\b|\b(?:siendo|sendo|a ser) (?:entregad[oa]s?|entregues?|repartid[oa]s?|distribuid[oa]s?)\b|\b(?:salida|salio|sale|ha salido) (?:a|para) (?:el )?reparto\b|\bruta de (?:reparto|entrega)\b|\ben proceso de entrega\b|\bvehiculo de reparto\b|\b(?:repartidor|mensajero|cartero|conductor) (?:ya )?(?:tiene|lleva) (?:tu|su|el|la) (?:paquete|envio|pedido|encomienda)\b|\bem distribuicao\b|\bsaiu para (?:a )?(?:entrega|distribuicao)\b|\bem (?:rota|processo|curso) de entrega\b|\bem entrega\b|\bveiculo de (?:entrega|distribuicao)\b|\b(?:carteiro|estafeta|motorista|entregador) (?:ja )?(?:tem|leva) (?:a|o) (?:sua |tua )?(?:encomenda|envio|objeto|pacote|volume)\b/.test(t)) return "out_for_delivery";
 	if (/\bdelivered\b|^final delivery$|delivery complete(?:d)?\b|delivery (?:was )?successful|(?:a ete|est) distribue|^(?:livre|livree)(?:$|[ ,])|(?:colis|envoi|est|a ete) livre|zugestellt|\bconsegnat[oa]\b|livraison effectuee|consegna completata/.test(t) || !/\b(?:una vez|cuando|hasta que|antes de que|para que|en cuanto|tan pronto como|uma vez|quando|assim que|ate que|logo que)\b[^.;:]*\bentreg/.test(t) && /(?<!\b(?:sea|sean|fuera|fuese|ser|seja|sejam|fosse|for|forem|que|se) )\b(?:entregad[oa]s?|entregues?)\b|\bentrega (?:realizada|efectuada|efetuada|completada|concluida|finalizada)\b|\brecogid[oa] por (?:el |la )?destinatari[oa]\b|\b(?:levantad|retirad)[oa] pelo destinatario\b/.test(t)) return "delivered";

package/dist/carriers/aliexpress/adapter.js

@@ -19,7 +19,7 @@ import { NotFoundError, SchemaError } from '../../core/errors/index.js';
 import { explicitOffsetTime } from '../../core/time/index.js';
 import { fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
-import { CAINIAO_ACTION_STATUS, CAINIAO_STATUS, cainiaoActionCode, cainiaoStageByStatus, } from './status.js';
+import { CAINIAO_ACTION_STATUS, CAINIAO_STATUS, cainiaoActionCode, cainiaoActionStage, cainiaoStageByStatus, } from './status.js';
 const PROVIDER = 'Cainiao';
 const UPSTREAM = 'Cainiao tracking';
 const DETAIL_URL = 'https://global.cainiao.com/global/detail.json';
@@ -86,14 +86,17 @@ function carrierNames(trackingModule, scans) {
  * Cainiao has no place field: it writes a scan's town in front of its standard
  * wording, "[Bordeaux] Out for delivery", in every language. A bracket that
  * reads as a place name becomes the location and the wording keeps the rest.
- * Codes, capitals-only names and the module's own carrier names stay in the text.
+ * Codes, ambiguous capitals-only names and the module's carrier names stay in the text.
  */
 function placedWording(wording, carriers) {
     const match = /^\s*\[([^[\]]{1,80})\]\s*(\S[\s\S]*)$/.exec(wording);
     const place = match?.[1].trim() ?? '';
+    // An explicit numbered city district is a place even in uppercase. Keep
+    // arbitrary numbers and facility codes excluded from the general rule.
+    const arrondissement = /^(?:Paris (?:[1-9]|1\d|20)|Lyon [1-9]|Marseille (?:[1-9]|1[0-6]))(?:er|e|eme|ème) arrondissement$/i.test(place);
     const letters = place.match(/\p{L}/gu)?.length ?? 0;
-    if (!match || letters < 3 || !/^\p{L}[\p{L}\p{M} .'’-]*$/u.test(place)
-        || (/\p{Lu}/u.test(place) && !/\p{Ll}/u.test(place)) || carriers.has(place.toLocaleLowerCase('en-US'))) {
+    if (!match || letters < 3 || (!arrondissement && (!/^\p{L}[\p{L}\p{M} .'’-]*$/u.test(place)
+        || (/\p{Lu}/u.test(place) && !/\p{Ll}/u.test(place)))) || carriers.has(place.toLocaleLowerCase('en-US'))) {
         return { description: wording, location: '' };
     }
     return { description: match[2].trim(), location: place };
@@ -160,11 +163,11 @@ export function parseCainiaoTrackingResponse(value, trackingNumber) {
         : (CAINIAO_STATUS.get(rawStatus)
             ?? (rawStatus ? 'in_transit' : details.length === 0 ? 'pending' : 'unknown'));
     const latestAction = cainiaoActionCode(latest.actionCode);
-    const actionStage = cainiaoStageByStatus(latestAction);
+    const currentStage = cainiaoActionStage(latestAction) ?? cainiaoStageByStatus()[status];
     const carriers = carrierNames(trackingModule, details);
     const events = details.slice(0, MAX_EVENTS_TO_RETURN).map((event) => {
         const code = cainiaoActionCode(event.actionCode);
-        const mapped = code ? CAINIAO_ACTION_STATUS.get(code) : undefined;
+        const stage = cainiaoActionStage(code);
         const { description, location } = placedWording(text(event.standerdDesc) || text(event.desc), carriers);
         return {
             time: scanTime(event),
@@ -172,7 +175,7 @@ export function parseCainiaoTrackingResponse(value, trackingNumber) {
             description,
             // The code keys the app's review of a scan the map does not stage.
             ...(/^[A-Z0-9_]{1,64}$/.test(code) ? { provider_code: code } : {}),
-            ...(mapped ? { stage: actionStage[mapped] ?? 'in_transit' } : {}),
+            ...(stage ? { stage } : {}),
         };
     });
     const eta = record(trackingModule.globalEtaInfo);
@@ -187,7 +190,7 @@ export function parseCainiaoTrackingResponse(value, trackingNumber) {
     const deliveredAt = status === 'delivered' ? scanTime(latest) || null : null;
     return {
         status,
-        ...(actionStage[status] || status === 'in_transit' ? { current_stage: actionStage[status] ?? 'in_transit' } : {}),
+        ...(currentStage ? { current_stage: currentStage } : {}),
         last_status_text: placedWording(text(latest.standerdDesc) || text(latest.desc), carriers).description || rawStatus,
         last_update: scanTime(latest) || null,
         expected_delivery: status === 'delivered' ? null : expected,
@@ -195,7 +198,7 @@ export function parseCainiaoTrackingResponse(value, trackingNumber) {
             ? {}
             : { expected_delivery_from: expectedFrom }),
         ...(deliveredAt ? { delivered_at: deliveredAt } : {}),
-        ...(handoff ? { delivery_tracking_number: handoff } : {}),
+        ...(handoff && comparableIdentifier(handoff) !== requested ? { delivery_tracking_number: handoff } : {}),
         ...(destination ? { destination_country_name: destination } : {}),
         events,
     };

package/dist/carriers/aliexpress/app.js

@@ -1,3 +1,4 @@
+import { cainiaoActionCode, cainiaoActionStage } from './status.js';
 const normalized = (value) => value.replace(/\s+/g, ' ').trim().toLocaleLowerCase('en-US');
 // A scan stored while its town was still part of the wording, "[Bordeaux] Out for
 // delivery" without a location, is the same scan as "Out for delivery" in Bordeaux.
@@ -7,8 +8,22 @@ export const sameInstantIdentityPolicy = {
     matches(incoming, stored) {
         const wording = normalized(incoming.description);
         const location = normalized(incoming.location);
-        return Boolean(wording && location) && !['', 'unknown'].includes(incoming.stage)
-            && incoming.stage === stored.stage && !normalized(stored.location)
+        const movedLocation = Boolean(location) && !normalized(stored.location)
             && normalized(stored.description) === `[${location}] ${wording}`;
+        if (!wording || ['', 'unknown'].includes(incoming.stage))
+            return false;
+        if (incoming.stage === stored.stage)
+            return movedLocation;
+        // Correct only the old adapter's coarse stages, with the same action,
+        // wording and place. The consumer also requires a unique same-time match.
+        const code = cainiaoActionCode(incoming.providerCode);
+        if (!code || code !== cainiaoActionCode(stored.providerCode)
+            || incoming.stage !== cainiaoActionStage(code))
+            return false;
+        const correction = (['customs', 'accepted'].includes(incoming.stage) && stored.stage === 'in_transit')
+            || (incoming.stage === 'ready_for_pickup' && stored.stage === 'out_for_delivery')
+            || (incoming.stage === 'out_for_delivery' && stored.stage === 'ready_for_pickup');
+        return correction && (movedLocation || (wording === normalized(stored.description)
+            && location === normalized(stored.location)));
     },
 };

package/dist/carriers/aliexpress/status.d.ts

@@ -24,15 +24,9 @@ export declare const CAINIAO_ACTION_STATUS: Map<string, CarrierStatus>;
 export declare const CAINIAO_PICKUP_ACTIONS: Set<string>;
 /** Normalize an action code: Cainiao has been seen spelling them with spaces and in lower case. */
 export declare function cainiaoActionCode(value: unknown): string;
-/**
- * Status → stage for one lookup. The pickup distinction depends on the newest
- * action code, so the whole table is derived from it once and then applied to
- * the shipment and to every historical event, exactly as before the move.
- */
-export declare function cainiaoStageByStatus(latestActionCode: string): Partial<Record<CarrierStatus, Stage>>;
-/**
- * What the map says about one scan, by its action code. An out-for-delivery
- * code reads as the van or a pickup point by the newest code of the whole
- * reply, so the code alone does not answer it.
- */
+/** Coarse status fallback when Cainiao supplies no action code. */
+export declare function cainiaoStageByStatus(): Partial<Record<CarrierStatus, Stage>>;
+/** Each scan keeps its own milestone even after the parcel progresses. */
+export declare function cainiaoActionStage(code: string): Stage | undefined;
+/** The review queue uses the same per-scan mapping as the adapter. */
 export declare const statusMap: CarrierStatusMap;

package/dist/carriers/aliexpress/status.js

@@ -51,6 +51,8 @@ export const CAINIAO_ACTION_STATUS = new Map([
     ['CC_IM_FAILURE', 'exception'],
     ['CC_IM_EXCEPTION', 'exception'],
     ['GTMS_ACCEPT', 'in_transit'],
+    ['GTMS_DO_ARRIVE', 'in_transit'],
+    ['GTMS_STATION_OUT', 'in_transit'],
     ['GTMS_SC_DEPART', 'in_transit'],
     ['SC_ARRIVE', 'in_transit'],
     ['SC_DEPART', 'in_transit'],
@@ -71,19 +73,27 @@ export const CAINIAO_PICKUP_ACTIONS = new Set(['GSTA_INFORM_BUYER', 'GTMS_WAIT_S
 export function cainiaoActionCode(value) {
     return (typeof value === 'string' ? value : '').trim().toLocaleUpperCase('en-US').replace(/\s+/g, '_');
 }
-/**
- * Status → stage for one lookup. The pickup distinction depends on the newest
- * action code, so the whole table is derived from it once and then applied to
- * the shipment and to every historical event, exactly as before the move.
- */
-export function cainiaoStageByStatus(latestActionCode) {
+/** Coarse status fallback when Cainiao supplies no action code. */
+export function cainiaoStageByStatus() {
     return {
         pending: 'registered',
-        out_for_delivery: CAINIAO_PICKUP_ACTIONS.has(latestActionCode) ? 'ready_for_pickup' : 'out_for_delivery',
+        in_transit: 'in_transit',
+        out_for_delivery: 'out_for_delivery',
         delivered: 'delivered',
         exception: 'exception',
     };
 }
+/** Each scan keeps its own milestone even after the parcel progresses. */
+export function cainiaoActionStage(code) {
+    if (CAINIAO_PICKUP_ACTIONS.has(code))
+        return 'ready_for_pickup';
+    if (['CC_EX_START', 'CC_IM_START', 'CC_HO_IN_SUCCESS'].includes(code))
+        return 'customs';
+    if (code === 'PU_PICKUP_SUCCESS')
+        return 'accepted';
+    const status = CAINIAO_ACTION_STATUS.get(code);
+    return status ? cainiaoStageByStatus()[status] : undefined;
+}
 /**
  * The scans the review queue holds without their action code, from before
  * events kept it, by `normalizeStatusWording` wording without the town
@@ -95,18 +105,11 @@ const UNCODED_SCANS = new Map([
     ['awaiting for transit to final delivery office', 'TD_TRANS_ARRIVE_DCP'],
     ['departed from destination country/region sorting center', 'GTMS_SC_DEPART'],
 ]);
-/**
- * What the map says about one scan, by its action code. An out-for-delivery
- * code reads as the van or a pickup point by the newest code of the whole
- * reply, so the code alone does not answer it.
- */
+/** The review queue uses the same per-scan mapping as the adapter. */
 export const statusMap = {
     stage: (code, wording) => {
         const action = code ? cainiaoActionCode(code) : UNCODED_SCANS.get(wording.replace(/^\[[^\]]*\]\s*/, ''));
-        const status = action ? CAINIAO_ACTION_STATUS.get(action) : undefined;
-        if (!status || status === 'out_for_delivery')
-            return undefined;
-        return cainiaoStageByStatus('')[status] ?? 'in_transit';
+        return action ? cainiaoActionStage(action) : undefined;
     },
     gaps: [],
 };

package/dist/carriers/aliexpress/statuses.json

@@ -101,10 +101,12 @@
     },
     {
       "code": "PU_PICKUP_SUCCESS",
-      "stage": "in_transit",
-      "confirmedBy": "prior-art",
+      "stage": "accepted",
+      "confirmedBy": "live",
       "firstSeen": "2026-09-12",
-      "note": ""
+      "note": "",
+      "wording": "Received by logistics company",
+      "language": "en"
     },
     {
       "code": "GWMS_OUTBOUND",
@@ -143,10 +145,12 @@
     },
     {
       "code": "CC_EX_START",
-      "stage": "in_transit",
-      "confirmedBy": "prior-art",
+      "stage": "customs",
+      "confirmedBy": "live",
       "firstSeen": "2026-09-12",
-      "note": ""
+      "note": "",
+      "wording": "Export customs clearance started",
+      "language": "en"
     },
     {
       "code": "CC_EX_SUCCESS",
@@ -254,17 +258,21 @@
     },
     {
       "code": "CC_HO_IN_SUCCESS",
-      "stage": "in_transit",
-      "confirmedBy": "prior-art",
+      "stage": "customs",
+      "confirmedBy": "live",
       "firstSeen": "2026-09-12",
-      "note": ""
+      "note": "",
+      "wording": "Arrived at customs",
+      "language": "en"
     },
     {
       "code": "CC_IM_START",
-      "stage": "in_transit",
-      "confirmedBy": "prior-art",
+      "stage": "customs",
+      "confirmedBy": "live",
       "firstSeen": "2026-09-12",
-      "note": ""
+      "note": "",
+      "wording": "Import customs clearance started",
+      "language": "en"
     },
     {
       "code": "CC_IM_SUCCESS",
@@ -386,6 +394,24 @@
       "confirmedBy": "prior-art",
       "firstSeen": "2026-09-12",
       "note": "Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "GTMS_DO_ARRIVE",
+      "wording": "Arrived at local delivery center",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-08",
+      "note": ""
+    },
+    {
+      "code": "GTMS_STATION_OUT",
+      "wording": "Delivery in process. Now left facility.",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-08",
+      "note": ""
     }
   ]
 }

package/dist/carriers/paack/adapter.js

@@ -18,12 +18,14 @@
  * e-mail, phone and address, and per-event `variables` that repeat them.
  * `parse()` copies nothing from those objects: each event is rebuilt from its
  * timestamp, our own description and the mapped stage, and the only order-level
- * fields read are the delivery postcode, compared and never copied, and the
- * delivery window.
+ * fields read are the delivery postcode, compared and never copied, the
+ * delivery country, which picks the window's clock, and the delivery window.
  */
 import { load } from 'cheerio';
+import { DateTime } from 'luxon';
 import { lookupBudget } from '../../core/adapter/index.js';
 import { IndeterminateError, InputRequiredError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { countryCode, countryTimeZone, explicitOffsetTime } from '../../core/time/index.js';
 import { decodeText, fetchBounded, UpstreamHttpError, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { classifyPaackEvent } from './status.js';
@@ -32,6 +34,7 @@ const DEFAULT_TIMEOUT_MS = 15_000;
 const MAX_RESPONSE_BYTES = 2_000_000;
 const MAX_EVENTS = 100;
 const MAX_REDIRECTS = 1;
+const DEFAULT_ZONE = 'Europe/Paris';
 const PAACK_HOST = /(?:^|\.)paack\.(?:app|co)$/;
 const NOT_FOUND_PATTERN = /order not found|incorrect order number|commande introuvable|pedido no encontrado/i;
 const NOT_FOUND_PAGE_PATTERN = /order not found|incorrect order number or postal code|commande introuvable|pedido no encontrado/i;
@@ -68,6 +71,34 @@ function normalizedDate(value) {
     }
     return normalizedTimestamp(value)?.iso.slice(0, 10) ?? null;
 }
+/**
+ * The clock the page shows the delivery window on: the delivery country's, and
+ * the Canary Islands' for Spanish postcodes 35 and 38.
+ */
+function deliveryZone(country, postcode) {
+    return countryCode(country) === 'ES' && /^3[58]\d{3}$/.test(postcode)
+        ? 'Atlantic/Canary'
+        : countryTimeZone(country) ?? DEFAULT_ZONE;
+}
+/**
+ * `expected_delivery_ts` as the page shows it: `YYYY-MM-DD HH:MM–HH:MM` on the
+ * delivery clock when both ends are instants within one day, else the day
+ * alone. A window that ended before the newest scan is dropped.
+ */
+function expectedDelivery(window, zone, newest) {
+    const start = explicitOffsetTime(window.start);
+    const end = explicitOffsetTime(window.end) ?? start;
+    if (!end)
+        return normalizedDate(window.end ?? window.start);
+    if (end.timestamp < newest)
+        return null;
+    const clock = (time) => DateTime.fromMillis(time.timestamp, { zone }).toFormat('yyyy-MM-dd HH:mm');
+    const last = clock(end);
+    const first = start ? clock(start) : last;
+    return first.slice(0, 10) === last.slice(0, 10) && first < last
+        ? `${first}–${last.slice(11)}`
+        : last.slice(0, 10);
+}
 function routeData(payload) {
     if (!isRecord(payload))
         throw new SchemaError('Paack', 'Paack returned an invalid tracking response');
@@ -222,16 +253,18 @@ export function parsePaackTrackingResponse(payload, rawPostcode) {
     const activeTime = activeEvent
         ? normalizedTimestamp(activeEvent.timestamp ?? activeEvent.time)
         : null;
-    const expected = isRecord(order.expected_delivery_ts)
-        ? normalizedDate(order.expected_delivery_ts.end ?? order.expected_delivery_ts.start)
+    const zone = deliveryZone(address?.country, postcode);
+    const newest = Math.max(activeTime?.timestamp ?? -Infinity, parsedEvents[0]?.timestamp ?? -Infinity);
+    const expected = isRecord(order.expected_delivery_ts) && !['delivered', 'exception'].includes(current.status)
+        ? expectedDelivery(order.expected_delivery_ts, zone, newest)
         : null;
     return {
         status: current.status,
         current_stage: current.stage,
         last_status_text: current.description,
         last_update: activeTime?.iso ?? events[0]?.time ?? null,
-        expected_delivery: ['delivered', 'exception'].includes(current.status) ? null : expected,
-        timezone: 'Europe/Paris',
+        expected_delivery: expected,
+        timezone: zone,
         events,
     };
 }

package/dist/carriers/paack/carrier.json

@@ -49,6 +49,7 @@
       "status",
       "history",
       "eta",
+      "eta_window",
       "sender_name",
       "recipient_name",
       "recipient_address"
@@ -56,7 +57,8 @@
     "scraped": [
       "status",
       "history",
-      "eta"
+      "eta",
+      "eta_window"
     ],
     "discarded": [
       "sender_name",

package/dist/core/status/language.js

@@ -136,9 +136,9 @@ export function trackingLanguageStage(description) {
     if (/^(?:reported|recorded|announced|item created|enregistre|annonce|erfasst|angekundigt|registrato|annunciato)$/.test(text))
         return 'registered';
     // Completion/release is distinct from pending or explicitly negated clearance.
-    if (/attend d'etre libere|attente de liberation|wartet auf.*freigabe|attesa di svincolo|(?:customs|clearance).*\bnot\b.*(?:clear|complet|releas)|dedouanement.*pas termine|customs (?:not cleared|clearance not completed)|not.*released by customs|dedouanement.*(?:non termine|pas termine)|(?:\bnot|n't|\bnever)(?: yet)?(?: been)? cleared (?:through |by )?customs|\bbe(?:ing)? cleared (?:through |by )?customs|non dedouane|zollabfertigung.*nicht abgeschlossen|nicht.*zoll.*freigegeben|sdoganamento.*non completato|non sdoganat/.test(text))
+    if (/attend d'etre libere|attente de liberation|wartet auf.*freigabe|attesa di svincolo|(?:customs|clearance).*\bnot\b.*(?:clear|complet|releas)|dedouanement.*pas termine|customs (?:not cleared|clearance not completed)|not.*released by customs|(?:\bnot|n't|\bnever)(?: yet)?(?: been)? released (?:by |from )?(?:(?:import|export)(?:\/export)? )?customs|\b(?:be|being) released from (?:(?:import|export)(?:\/export)? )?customs|dedouanement.*(?:non termine|pas termine)|(?:\bnot|n't|\bnever)(?: yet)?(?: been)? cleared (?:through |by )?customs|\bbe(?:ing)? cleared (?:through |by )?customs|non dedouane|zollabfertigung.*nicht abgeschlossen|nicht.*zoll.*freigegeben|sdoganamento.*non completato|non sdoganat/.test(text))
         return 'customs';
-    if (/clearance.*(?:has been completed|completed)|clearance (?:complete|success)|(?:leaving|departed from|left) customs|completion of customs|formalites.*(?:terminee|achevee)|released by (?:customs|a government agency)|customs (?:cleared|(?:has |have )?released)|\bcleared (?:through |by )?customs|dedouanement.*(?:termine|acheve)|fin du dedouanement|libere.*(?:douane|autorite)|douane.*libere|zollabfertigung.*abgeschlossen|(?:zoll|behorde).*freigegeben|sdoganamento.*completato|completamento.*sdoganamento|svincolat.*(?:dogana|autorita)/.test(text))
+    if (/clearance.*(?:has been completed|completed)|clearance (?:complete|success)|(?:leaving|departed from|left) customs|completion of customs|formalites.*(?:terminee|achevee)|released from (?:(?:import|export)(?:\/export)? )?customs|released by (?:customs|a government agency)|customs (?:cleared|(?:has |have )?released)|\bcleared (?:through |by )?customs|dedouanement.*(?:termine|acheve)|fin du dedouanement|libere.*(?:douane|autorite)|douane.*libere|zollabfertigung.*abgeschlossen|(?:zoll|behorde).*freigegeben|sdoganamento.*completato|completamento.*sdoganamento|svincolat.*(?:dogana|autorita)/.test(text))
         return 'in_transit';
     if (/customs|clearance|douan|formalites (?:d')?(?:import|export)|zoll|dogan|government agency|autorite gouvernementale|staatliche behorde|autorita governativa/.test(text))
         return 'customs';

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.49.1"
+    "version": "0.49.2"
   },
   "paths": {
     "/health": {

package/package.json

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