universal-parcel-scraper 0.856.1-main.4572 → 0.856.2-main.4574

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 17,848 such statuses, each filed under one stage.
+The carrier folders record 17,863 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/china-post/status.js

@@ -182,15 +182,15 @@ export function chinaPostEnglish(wording) {
 }
 // China Post's domestic scans as a forwarder or a provider relays them in Chinese: an arrival at an
 // office or a departure from one, whether its office is still in the wording or has become the scan's
-// place, a sorting, a flight between two cities, the closing of an export dispatch, its hand-over
-// to the carrier that flies it and the airline's receipt and departure, and export customs'
-// presentation and release.
+// place, a sorting or a dispatch to the delivering office, a flight between two cities, the closing of
+// an export dispatch, its hand-over to the carrier that flies it and the airline's receipt and
+// departure, and export customs' presentation and release.
 const RELAYED_STAGES = [
     [/^邮件(?:到达|离开)(?:$|[【，])/u, 'in_transit'],
     [/^邮件已在【[^【】]+】完成分拣，准备发出$/u, 'in_transit'],
     [/^邮件已乘机由【[^【】]+】飞往【[^【】]+】$/u, 'in_transit'],
     [/^【[^【】]+】已出口直封$/u, 'in_transit'],
-    [/^已交承运商运输$/u, 'in_transit'],
+    [/^(?:已交承运商运输|揽投配发)$/u, 'in_transit'],
     [/^航空公司(?:接收|启运)$/u, 'in_transit'],
     [/^送交出口海关$/u, 'customs'],
     [/^出口海关\/放行$/u, 'in_transit'],

package/dist/carriers/jrt/parser.js

@@ -1,8 +1,11 @@
 import { normalizeHualeiNumber, parseHualeiPage, parseHualeiTrack } from '../gzyl/hualei.js';
-import { jrtEnglish, jrtStage } from './status.js';
+import { isJrtUpsRow, jrtEnglish, jrtStage } from './status.js';
 export const PROVIDER = 'JRT';
 export const JRT_ORIGIN = 'http://106.53.64.22:8082';
-export const JRT = { carrier: 'jrt', provider: PROVIDER, origin: JRT_ORIGIN, stage: jrtStage, english: jrtEnglish };
+export const JRT = {
+    carrier: 'jrt', provider: PROVIDER, origin: JRT_ORIGIN, stage: jrtStage, english: jrtEnglish,
+    clock: ({ content, location }) => (isJrtUpsRow(content, location) ? 'wall' : 'platform'),
+};
 export const normalizeJrtNumber = (raw) => normalizeHualeiNumber(raw, PROVIDER);
 /** The track interface's reply, or null when it holds no row for the number. */
 export const parseJrtTrack = (payload, number, readAt) => parseHualeiTrack(payload, number, JRT, readAt);

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

@@ -1,5 +1,5 @@
 import type { Stage } from '../../core/status/index.js';
-import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
 /** The key a row's `normalizeStatusWording` wording is mapped under: a booked flight's day becomes an ellipsis. */
 export declare const jrtScanKey: (wording: string) => string;
 /**
@@ -14,4 +14,6 @@ export declare function jrtStage(_code: string | null, wording: string): Stage |
  * flight it books, which is still to come.
  */
 export declare const jrtEnglish: (_code: string | null, wording: string) => string | undefined;
+/** Whether a row is one UPS wrote, by its wording or its place in the United States: it is on UPS's wall clock. */
+export declare const isJrtUpsRow: (wording: string, place: string) => boolean;
 export declare const statusMap: CarrierStatusMap;

package/dist/carriers/jrt/status.js

@@ -1,4 +1,5 @@
 import { statusWordings } from '../../core/status/english.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
 import statuses from './statuses.json' with { type: 'json' };
 const WORDINGS = statusWordings(statuses.entries);
 // The airport row names the day of the booked flight in both halves.
@@ -10,10 +11,12 @@ const TAKE_OFF_DAY = /^(flight is expected to take off on )[a-z]+ \d{1,2}$/;
 // The newer English rows name the flight's days as month.day: "expected to depart on 10.27 and land on 10.27".
 const FLIGHT_DATES = /^(the flight is expected to depart on )\d{1,2}\.\d{1,2}( and land on )\d{1,2}\.\d{1,2}$/;
 const LANDING_DATE = /^(the flight has departed and is expected to )\d{1,2}\.\d{1,2}( land)$/;
+// On the line into the United States JRT books the flight by its month and day alone: "10/22号航班".
+const BOOKED_FLIGHT = /^\d{1,2}\/\d{1,2}(号航班)$/;
 /** The key a row's `normalizeStatusWording` wording is mapped under: a booked flight's day becomes an ellipsis. */
 export const jrtScanKey = (wording) => wording.replace(FLIGHT_DAY, '$1…$2…')
     .replace(CLEARED_FLIGHT_DAY, '$1…$2…').replace(TAKE_OFF_DAY, '$1…')
-    .replace(FLIGHT_DATES, '$1…$2…').replace(LANDING_DATE, '$1…$2');
+    .replace(FLIGHT_DATES, '$1…$2…').replace(LANDING_DATE, '$1…$2').replace(BOOKED_FLIGHT, '…$1');
 /**
  * The stage JRT's map gives a row, by its whole `normalizeStatusWording` wording:
  * JRT's own, or the English the adapter shows for it.
@@ -28,4 +31,9 @@ export function jrtStage(_code, wording) {
  * flight it books, which is still to come.
  */
 export const jrtEnglish = (_code, wording) => WORDINGS.english(jrtScanKey(wording));
+// UPS's rows, which the tracker copies in Chinese on UPS's wall clock on the line into the United States.
+const UPS_ROWS = new Set(['发件人已创建标签，但是 UPS 尚未收到包裹。', '抵达设施', '离开设施', '已提取', 'UPS 设施处理', '已装上递送车辆',
+    '准备今天递送', '已递送'].map(normalizeStatusWording));
+/** Whether a row is one UPS wrote, by its wording or its place in the United States: it is on UPS's wall clock. */
+export const isJrtUpsRow = (wording, place) => UPS_ROWS.has(normalizeStatusWording(wording)) || /(?:^|,)\s*US$/.test(place.trim());
 export const statusMap = { stage: jrtStage, gaps: [] };

package/dist/carriers/jrt/statuses.json

@@ -360,6 +360,129 @@
       "stage": "in_transit",
       "confirmedBy": "live",
       "note": "The airline's notice of arrival, after the landing and before the pickup and customs clearance."
+    },
+    {
+      "wording": "…号航班",
+      "language": "zh",
+      "english": "Booked on a flight",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "JRT's own row on its line into the United States, naming the flight's month and day, read as an ellipsis."
+    },
+    {
+      "wording": "航班已飞",
+      "language": "zh",
+      "english": "Flight has flown",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30"
+    },
+    {
+      "wording": "航班抵达",
+      "language": "zh",
+      "english": "Flight has arrived",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30"
+    },
+    {
+      "wording": "提货中",
+      "language": "zh",
+      "english": "Picking up the goods",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "At the destination airport after the landing, before the clearance."
+    },
+    {
+      "wording": "清关完成，已提货，待交仓",
+      "language": "zh",
+      "english": "Customs clearance completed, goods picked up, awaiting hand-over to the warehouse",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30"
+    },
+    {
+      "wording": "已交仓",
+      "language": "zh",
+      "english": "Handed over to the warehouse",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "The hand-over to the delivering carrier's warehouse, before UPS's first facility scan."
+    },
+    {
+      "wording": "发件人已创建标签，但是 UPS 尚未收到包裹。",
+      "language": "zh",
+      "english": "Shipper created a label, UPS has not received the package yet.",
+      "stage": "registered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "UPS's label row. On the line into the United States the tracker copies UPS's rows in Chinese, on UPS's wall clock at the scan's place; the English is UPS's."
+    },
+    {
+      "wording": "抵达设施",
+      "language": "zh",
+      "english": "Arrived at Facility",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS."
+    },
+    {
+      "wording": "离开设施",
+      "language": "zh",
+      "english": "Departed from Facility",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS."
+    },
+    {
+      "wording": "已提取",
+      "language": "zh",
+      "english": "Picked Up",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS without a place, between its facility scans; the parcel is already on its way."
+    },
+    {
+      "wording": "UPS 设施处理",
+      "language": "zh",
+      "english": "Processing at UPS Facility",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS."
+    },
+    {
+      "wording": "已装上递送车辆",
+      "language": "zh",
+      "english": "Loaded on Delivery Vehicle",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS, whose own map gives its code OF out for delivery."
+    },
+    {
+      "wording": "准备今天递送",
+      "language": "zh",
+      "english": "Out For Delivery Today",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS, whose own map gives its code OT out for delivery."
+    },
+    {
+      "wording": "已递送",
+      "language": "zh",
+      "english": "Delivered",
+      "stage": "delivered",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-30",
+      "note": "Copied from UPS."
     }
   ]
 }

package/dist/carriers/lingdong/statuses.json

@@ -10,6 +10,7 @@
     {"wording": "航班抵达【Flight arrival】", "language": "zh", "stage": "in_transit", "confirmedBy": "live", "note": "The flight has landed."},
     {"wording": "航班已启运/Package in transit to destination country", "language": "zh", "stage": "in_transit", "confirmedBy": "live", "note": "The booked flight has left."},
     {"wording": "航班已落地，拆板中/Package arrived at destination country", "language": "zh", "stage": "in_transit", "confirmedBy": "live", "note": "The flight has landed and its pallets are being broken down."},
+    {"wording": "已完成国内报关手续【Domestic customs clearance procedures have been completed.】", "language": "zh", "stage": "in_transit", "confirmedBy": "live", "note": "Cleared after the landing, before the delivery."},
     {"wording": "货物已清关完成/Import customs clearance complete", "language": "zh", "stage": "in_transit", "confirmedBy": "live", "note": "Released by the destination's customs, the day after the landing."},
     {"wording": "货物电子信息已经收到", "language": "zh", "stage": "registered", "confirmedBy": "prior-art", "note": "The platform writes this row itself for an order without scans, on its creation time."}
   ]

package/dist/providers/shared/result.js

@@ -562,6 +562,12 @@ function providerWordingStage(description) {
     // hub taking the parcel in, the parcel sent on, and a flight held up, for which results carry no delay flag.
     if (/^customer information manifested[.!]?$/i.test(value))
         return 'registered';
+    // A booking before any carrier has the parcel: a collection requested or booked, or a carrier still waiting for it.
+    if (/^(?:pickup requested|booked|waiting for (?:the )?parcel)[.!]?$/i.test(value))
+        return 'registered';
+    // A forwarder's warehouse scanning the parcel in or out, as aggregators relay SPT Express's rows.
+    if (/^item (?:in|out)bound scanning[.!]?$/i.test(value))
+        return 'in_transit';
     if (/^checked in at origin hub[.!]?$|^parcel received and processing[.!]?$/i.test(value))
         return 'accepted';
     if (/^parcel shipped[.!]?$|^(?:airline|flight) delay(?:ed)?[.!]?$/i.test(value))

package/dist/providers/status.js

@@ -44,6 +44,7 @@ const NO_STEP = [
     // released it, whether a driver collects or delivers, or which forwarder's warehouse scanned it.
     ['item received', 'A bare receipt that names no receiver: ParcelsApp reads it by its place, the wording alone cannot.'],
     ['received.', 'A bare receipt that names no receiver: a store, a centre or a carrier.'],
+    ['package received', 'A bare receipt that names no receiver: a store, a centre or a carrier.'],
     ['shipped', "A dispatch that does not say whether the seller or a carrier sent the parcel on."],
     ['released', 'A release that does not say from customs or from a hold.'],
     ['driver assigned', 'A driver assigned, to a collection or to a delivery round: the wording does not say which.'],

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.856.1-main.4572"
+    "version": "0.856.2-main.4574"
   },
   "paths": {
     "/health": {

package/package.json

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