universal-parcel-scraper 0.652.1-main.3103 → 0.652.3-main.3107

package/README.md

@@ -155,7 +155,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 16,472 such statuses, each filed under one stage.
+The carrier folders record 16,475 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/dayone/statuses.json

@@ -1,6 +1,7 @@
 {
   "carrier": "dayone",
   "entries": [
+    {"wording": "Shipment has begun. In transit to destination city", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "The single scan of a parcel the tracker lists with a YunExpress number, whose tracker carries the rest of its history."},
     {"wording": "Order processed by shipper", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Yanwen's record of the merchant's order data, the first scan."},
     {"wording": "SHIPPING INFORMATION RECEIVED", "stage": "registered", "language": "en", "confirmedBy": "live"},
     {"wording": "SHIPPING INFORMATION RECEIVED BY AUSTRALIA POST", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "Australia Post's manifest, relayed: it comes after the parcel has moved and is no step back."},

package/dist/carriers/four-px/status.js

@@ -14,6 +14,7 @@ const CODES = new Map([
     ['FPX_C_AAF', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_C_ADFF', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_F_ST', { status: 'in_transit', stage: 'in_transit' }],
+    ['FPX_M_PT', { status: 'in_transit', stage: 'in_transit' }], // Left the origin facility, awaiting the line haul.
     ['FPX_M_HA', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_M_DFOA', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_M_ATA', { status: 'in_transit', stage: 'in_transit' }],
@@ -23,6 +24,7 @@ const CODES = new Map([
     ['FPX_D_AOPC', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_D_STPP', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_D_HQ', { status: 'in_transit', stage: 'in_transit' }],
+    ['FPX_D_DFD', { status: 'in_transit', stage: 'in_transit' }], // Left the destination's national sorting centre.
     ['FPX_O_RR', { status: 'in_transit', stage: 'in_transit' }],
     ['FPX_M_IT', { status: 'in_transit', stage: 'in_transit' }],
 ]);

package/dist/carriers/four-px/statuses.json

@@ -302,6 +302,24 @@
       "confirmedBy": "live",
       "firstSeen": "2026-10-19",
       "note": "The pickup shop took the parcel over; relayed from DPD."
+    },
+    {
+      "code": "FPX_M_PT",
+      "wording": "Pending transportation",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-22",
+      "note": "After the departure from the origin facility, before the hand-over to the airline."
+    },
+    {
+      "code": "FPX_D_DFD",
+      "wording": "Out from national sorting center",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-22",
+      "note": "After import clearance, the day before the last mile's out-for-delivery scan."
     }
   ]
 }

package/dist/carriers/ups/adapter.js

@@ -1,4 +1,5 @@
 import { load } from 'cheerio';
+import { DateTime, FixedOffsetZone } from 'luxon';
 import makeFetchCookie from 'fetch-cookie';
 import { CookieJar } from 'tough-cookie';
 import { carrierErrorKind, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
@@ -295,30 +296,44 @@ export function parseUPSTrackingHtml(page, trackingNumber) {
 function text(value, maxLength) {
     return clean(typeof value === 'string' ? decodeEntities(value) : value, maxLength);
 }
+/** UPS's offset of a scan's place, in minutes. */
+function statedOffset(activity) {
+    const offset = /^([+-])(0\d|1[0-4]):([0-5]\d)$/.exec(cleanScalar(activity.gmtOffset));
+    return offset ? (offset[1] === '-' ? -1 : 1) * (Number(offset[2]) * 60 + Number(offset[3])) : null;
+}
 /**
  * A scan's clock. UPS sends the same scan twice: a UTC pair (`gmtDate` /
- * `gmtTime`) and a local pair with a `gmtOffset`. Either becomes an
- * offset-carrying ISO string, so no zone is ever guessed. A local pair without
- * an offset stays a `local_time`, a scan UPS dates by its day alone, as it does
- * some drop-offs, keeps that day, other text stays as UPS wrote it, and a scan
- * with no clock at all, like some label scans, gets none.
+ * `gmtTime`) and a local pair with a `gmtOffset`. The UTC pair's instant, to
+ * the second, is written on that offset when the local pair reads the same
+ * minute on it, so the scan keeps its place's clock; otherwise it stays in
+ * UTC. A zero offset is written as UTC was, `+00:00`. Without the UTC pair,
+ * the local pair and its offset become the time, and no zone is ever guessed.
+ * A local pair without an offset stays a `local_time`, a scan UPS dates by
+ * its day alone, as it does some drop-offs, keeps that day, other text stays
+ * as UPS wrote it, and a scan with no clock at all, like some label scans,
+ * gets none.
  */
 function activityClock(activity) {
-    const gmtDate = cleanScalar(activity.gmtDate);
-    const gmtTime = cleanScalar(activity.gmtTime);
-    if (/^\d{8}$/.test(gmtDate) && /^\d{2}:\d{2}:\d{2}$/.test(gmtTime)) {
-        return { time: `${gmtDate.slice(0, 4)}-${gmtDate.slice(4, 6)}-${gmtDate.slice(6, 8)}T${gmtTime}+00:00` };
-    }
     const localDate = cleanScalar(activity.date);
     const localTime = cleanScalar(activity.time);
     const dateMatch = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(localDate);
     const timeMatch = /^(\d{1,2}):([0-5]\d)\s*([AP])\.?M\.?$/i.exec(localTime);
     const hour = Number(timeMatch?.[1]);
-    if (dateMatch && timeMatch && hour >= 1 && hour <= 12) {
-        const hours = String(hour % 12 + (timeMatch[3].toUpperCase() === 'P' ? 12 : 0)).padStart(2, '0');
-        const local = `${dateMatch[3]}-${dateMatch[1]}-${dateMatch[2]}T${hours}:${timeMatch[2]}:00`;
-        const offset = cleanScalar(activity.gmtOffset);
-        return /^[+-]\d{2}:\d{2}$/.test(offset) ? { time: `${local}${offset}` } : { local_time: local };
+    const local = dateMatch && timeMatch && hour >= 1 && hour <= 12
+        ? `${dateMatch[3]}-${dateMatch[1]}-${dateMatch[2]}T${String(hour % 12 + (timeMatch[3].toUpperCase() === 'P' ? 12 : 0)).padStart(2, '0')}:${timeMatch[2]}:00`
+        : null;
+    const offset = statedOffset(activity);
+    const gmtDate = cleanScalar(activity.gmtDate);
+    const gmtTime = cleanScalar(activity.gmtTime);
+    if (/^\d{8}$/.test(gmtDate) && /^\d{2}:\d{2}:\d{2}$/.test(gmtTime)) {
+        const utc = `${gmtDate.slice(0, 4)}-${gmtDate.slice(4, 6)}-${gmtDate.slice(6, 8)}T${gmtTime}`;
+        const shown = offset ? DateTime.fromISO(utc, { zone: 'utc' }).setZone(FixedOffsetZone.instance(offset)) : null;
+        return { time: shown?.isValid && shown.toFormat("yyyy-MM-dd'T'HH:mm':00'") === local
+                ? shown.toISO({ suppressMilliseconds: true }) : `${utc}+00:00` };
+    }
+    if (local) {
+        const stated = cleanScalar(activity.gmtOffset);
+        return /^[+-]\d{2}:\d{2}$/.test(stated) ? { time: `${local}${stated}` } : { local_time: local };
     }
     const day = dateMatch && !localTime ? calendarDay(Number(dateMatch[3]), Number(dateMatch[1]), Number(dateMatch[2])) : null;
     if (day)

package/dist/server/openapi.json

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

package/package.json

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