universal-parcel-scraper 0.49.2-main.550 → 0.49.2-main.552

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

@@ -15,16 +15,20 @@
  * does echo the delivery postcode, which must agree with the requested one.
  *
  * Privacy: the loader payload carries the retailer, the recipient's name,
- * 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.
+ * e-mail, phone and address, the PaackGo Point pickup code and QR link, and
+ * per-event `variables` that repeat them. `parse()` copies nothing from those:
+ * 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, the delivery country, which picks the window's
+ * clock, the delivery window, and the PaackGo Point's name and address while
+ * the parcel waits there.
  */
 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 { decodeText, fetchBounded, UpstreamHttpError, userAgentOf } from '../../core/transport/index.js';
+import { countryCode, countryTimeZone, explicitOffsetTime } from '../../core/time/index.js';
+import { clean, decodeText, fetchBounded, UpstreamHttpError, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { classifyPaackEvent } from './status.js';
 const TRACKING_ENDPOINT = 'https://mydeliveries.paack.app/tracking/order';
@@ -32,6 +36,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 +73,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');
@@ -165,6 +198,22 @@ function redirectTarget(location, from, trackingNumber, postcode) {
         return null;
     return { url: trackingOrderUrl(`${target.origin}${target.pathname}`, trackingNumber, postcode) };
 }
+/**
+ * The PaackGo Point the page names: `pudo_name`, then `pudo_address` on the
+ * following lines. The address is one string Paack formats itself; the page
+ * prints it as it comes and breaks it only where it holds a line break. The
+ * pickup code (`pudo_passcode`), QR link and collection deadline beside them
+ * are never read.
+ */
+function pickupPoint(order) {
+    const name = clean(order.pudo_name, 120);
+    if (!name)
+        return '';
+    const address = typeof order.pudo_address === 'string'
+        ? order.pudo_address.split('\n').map((line) => clean(line, 200)).filter(Boolean)
+        : [];
+    return [name, ...address].join('\n');
+}
 /** Letters and digits only, so "SW1A 1AA" and "4445-027" compare by content. */
 function postcodeKey(value) {
     return value.toLocaleUpperCase('en-US').replace(/[^A-Z0-9]/g, '');
@@ -222,16 +271,20 @@ 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;
+    const pickup = current.stage === 'ready_for_pickup' ? pickupPoint(order) : '';
     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,
+        ...(pickup ? { pickup_point: pickup } : {}),
+        timezone: zone,
         events,
     };
 }

package/dist/carriers/paack/carrier.json

@@ -40,7 +40,8 @@
   },
   "capabilities": [
     "history",
-    "eta"
+    "eta",
+    "pickup_point"
   ],
   "portal": {
     "url": "https://mydeliveries.paack.app/tracking?tracking_number={trackingNumber}",
@@ -49,6 +50,9 @@
       "status",
       "history",
       "eta",
+      "eta_window",
+      "pickup_point",
+      "pickup_code",
       "sender_name",
       "recipient_name",
       "recipient_address"
@@ -56,9 +60,12 @@
     "scraped": [
       "status",
       "history",
-      "eta"
+      "eta",
+      "eta_window",
+      "pickup_point"
     ],
     "discarded": [
+      "pickup_code",
       "sender_name",
       "recipient_name",
       "recipient_address"

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

@@ -10,6 +10,10 @@
  *
  * Order matters: return and failure identifiers are tested before the broader
  * delivery ones, so "notDelivered" can never match the "delivered" substring.
+ * PaackGo Point identifiers come from the page's own vocabulary and are tested
+ * before the generic words they contain: "rejectedByPudo" is a retried
+ * delivery, not a rejection, and "collectedByCustomer" is the recipient
+ * collecting the parcel, not a transit collection.
  * The provider's own wording is never returned; each mapped entry supplies the
  * English description we display.
  *

package/dist/carriers/paack/status.js

@@ -15,6 +15,7 @@ const OUT_FOR_DELIVERY = {
     description: 'Out for delivery',
 };
 const DELIVERED = { status: 'delivered', stage: 'delivered', description: 'Delivered' };
+const DELIVERY_ISSUE = { status: 'exception', stage: 'failed_attempt', description: 'Delivery issue' };
 /** Paack's English timeline labels, keyed like `statusKey`, with the identifier each one renders. */
 const RELAYED = new Map([
     ['orderdetailsreceived', REGISTERED], // manifested
@@ -36,6 +37,18 @@ export function classifyPaackEvent(value) {
     ])) {
         return { status: 'exception', stage: 'returned', description: 'Shipment returned' };
     }
+    // Expired, refused or unpaid at the PaackGo Point: on its way back to the retailer.
+    if (includesAny(key, [
+        'inpudotoreturnexpired',
+        'inpudotoreturnrejected',
+        'inpudotoreturncodnotaccepted',
+    ])) {
+        return { status: 'exception', stage: 'returned', description: 'Returning to sender' };
+    }
+    // The point was closed, full or refused the parcel; Paack tries again.
+    if (includesAny(key, ['pudoclosed', 'pudofull', 'rejectedbypudo'])) {
+        return { ...DELIVERY_ISSUE };
+    }
     if (includesAny(key, [
         'incorrectaddress',
         'notaccepted',
@@ -59,10 +72,10 @@ export function classifyPaackEvent(value) {
         'notdelivered',
         'undelivered',
     ]))
-        return { status: 'exception', stage: 'failed_attempt', description: 'Delivery issue' };
-    if (includesAny(key, ['delivered', 'deliverycompleted']))
+        return { ...DELIVERY_ISSUE };
+    if (includesAny(key, ['delivered', 'deliverycompleted', 'collectedbycustomer']))
         return { ...DELIVERED };
-    if (includesAny(key, ['readyforpickup', 'atpickuppoint'])) {
+    if (includesAny(key, ['droppedinpudo'])) {
         return { status: 'out_for_delivery', stage: 'ready_for_pickup', description: 'Ready for pickup' };
     }
     if (includesAny(key, ['outfordelivery', 'indelivery', 'driverassigned', 'inprogress']))

package/dist/carriers/paack/statuses.json

@@ -25,6 +25,54 @@
       "firstSeen": "2026-09-12",
       "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
     },
+    {
+      "code": "inpudotoreturnexpired",
+      "language": "en",
+      "stage": "returned",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label inPudoToReturnExpired, \"Expired at PaackGo Point\": not collected in time, returned to the retailer."
+    },
+    {
+      "code": "inpudotoreturnrejected",
+      "language": "en",
+      "stage": "returned",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label inPudoToReturnRejected: refused at the PaackGo Point, returned to the retailer. Tested before the rejected exception rule."
+    },
+    {
+      "code": "inpudotoreturncodnotaccepted",
+      "language": "en",
+      "stage": "returned",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label inPudoToReturnCODNotAccepted: cash on delivery not paid at the PaackGo Point, returned to the retailer."
+    },
+    {
+      "code": "pudoclosed",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label pudoClosed, \"Has been rescheduled\": the PaackGo Point was closed; Paack tries again."
+    },
+    {
+      "code": "pudofull",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label pudoFull, \"Has been rescheduled\": the PaackGo Point was full; Paack tries again."
+    },
+    {
+      "code": "rejectedbypudo",
+      "language": "en",
+      "stage": "failed_attempt",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label rejectedByPudo, \"Has been rescheduled\": the PaackGo Point refused the parcel; Paack tries again. Tested before the rejected exception rule."
+    },
     {
       "code": "returntosenderscheduled",
       "language": "en",
@@ -145,6 +193,22 @@
       "firstSeen": "2026-09-12",
       "note": "Identifier substring inherited from the pre-package adapter; source not recorded. Reclassified to exception 2026-09-12."
     },
+    {
+      "code": "inpudotoreturndamaged",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label inPudoToReturnDamaged, \"Logistic issue\": no longer available at the PaackGo Point. Reached through damaged."
+    },
+    {
+      "code": "lostbypudo",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label lostByPudo, \"Logistic issue\". Reached through lost."
+    },
     {
       "code": "integrationerror",
       "language": "en",
@@ -186,20 +250,20 @@
       "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
     },
     {
-      "code": "readyforpickup",
+      "code": "collectedbycustomer",
       "language": "en",
-      "stage": "ready_for_pickup",
-      "confirmedBy": "prior-art",
-      "firstSeen": "2026-09-12",
-      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+      "stage": "delivered",
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label collectedByCustomer, \"Collected from PaackGo Point\". Tested before the collected transit rule."
     },
     {
-      "code": "atpickuppoint",
+      "code": "droppedinpudo",
       "language": "en",
       "stage": "ready_for_pickup",
-      "confirmedBy": "prior-art",
-      "firstSeen": "2026-09-12",
-      "note": "Identifier substring inherited from the pre-package adapter; source not recorded."
+      "confirmedBy": "bundle",
+      "firstSeen": "2026-10-08",
+      "note": "Page label droppedInPudo, \"At PaackGo Point\": the parcel waits at the point named by pudo_name and pudo_address."
     },
     {
       "code": "outfordelivery",

package/package.json

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