universal-parcel-scraper 0.809.2-main.4367 → 0.810.1-main.4374

package/README.md

@@ -161,7 +161,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,645 such statuses, each filed under one stage.
+The carrier folders record 17,648 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/data/catalog.json

@@ -427,6 +427,8 @@
           "autoComplete": "postal-code"
         }
       ],
+      "recognitionRank": 524,
+      "recognitionPattern": "^1810\\d{14}$",
       "refresh": {
         "minMinutes": 30
       },
@@ -476,6 +478,10 @@
       {
         "pattern": "^(?=.{13}$|.{15}$)3S[A-Z]{1,3}\\d+$",
         "confidence": "low"
+      },
+      {
+        "pattern": "^1810\\d{14}$",
+        "confidence": "low"
       }
     ]
   },

package/data/detection-golden.json

@@ -20397,6 +20397,19 @@
       "heppner"
     ]
   },
+  {
+    "input": "181011000000000017",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "spring-gds",
+      "bpost",
+      "ecoscooting"
+    ],
+    "asked": [
+      "spring-gds"
+    ]
+  },
   {
     "input": "18113149",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -685,6 +685,8 @@ var tt = {
 				inputMode: "text",
 				autoComplete: "postal-code"
 			}],
+			recognitionRank: 524,
+			recognitionPattern: "^1810\\d{14}$",
 			refresh: { minMinutes: 30 },
 			localClocks: !0
 		},
@@ -722,6 +724,10 @@ var tt = {
 			{
 				pattern: "^(?=.{13}$|.{15}$)3S[A-Z]{1,3}\\d+$",
 				confidence: "low"
+			},
+			{
+				pattern: "^1810\\d{14}$",
+				confidence: "low"
 			}
 		]
 	},
@@ -26880,7 +26886,8 @@ var tt = {
 	"spring-gds": [
 		"spring-gds-1",
 		"spring-gds-2",
-		"spring-gds-3"
+		"spring-gds-3",
+		"spring-gds-1810"
 	],
 	postlogistics: ["postlogistics-dashed-reference", "postlogistics-compact-reference"],
 	dachser: [],
@@ -34304,6 +34311,7 @@ var Uu = {
 	speedaf: 989,
 	speedex: 938,
 	speedy: 280,
+	"spring-gds": 524,
 	"spx-br": 982,
 	"st-courier": 753,
 	"stallion-express": 105,

package/dist/carriers/meso-global/statuses.json

@@ -7,6 +7,8 @@
     {"wording": "预计…飞", "language": "zh", "english": "Flight booked", "stage": "in_transit", "confirmedBy": "source", "note": "The row names the day the flight is expected to leave, as month-day; the key replaces it with an ellipsis and the English leaves it out, since it is still to come. As a universal provider relays it."},
     {"wording": "已飞未落地", "language": "zh", "english": "Flight departed, not yet landed", "stage": "in_transit", "confirmedBy": "source", "note": "As a universal provider relays it."},
     {"wording": "一程已落地 二程预计…飞", "language": "zh", "english": "First flight landed, connecting flight booked", "stage": "in_transit", "confirmedBy": "source", "note": "The first leg has landed; the row names the day the second is expected to leave, which the key replaces with an ellipsis. As a universal provider relays it."},
-    {"wording": "二程已飞未落地", "language": "zh", "english": "Connecting flight departed, not yet landed", "stage": "in_transit", "confirmedBy": "source", "note": "As a universal provider relays it."}
+    {"wording": "二程已飞未落地", "language": "zh", "english": "Connecting flight departed, not yet landed", "stage": "in_transit", "confirmedBy": "source", "note": "As a universal provider relays it."},
+    {"wording": "已落地 等待拆板提货", "language": "zh", "english": "Landed, awaiting unloading for collection", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-29", "note": "The last flight has landed; its pallets are still to be broken down and the shipment collected from the airport."},
+    {"wording": "已提回 等待清关", "language": "zh", "english": "Collected from the airport, awaiting customs clearance", "stage": "customs", "confirmedBy": "live", "firstSeen": "2026-10-29", "note": "Collected from the airport and held for import clearance, as other forwarders' rows of the same step read."}
   ]
 }

package/dist/carriers/spring-gds/adapter.d.ts

@@ -22,7 +22,7 @@
  * delivery postcode. With a Dutch postcode, or another country's postcode
  * given with that country, that tracker is asked first.
  */
-import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 import { type StepRecorder } from '../../core/telemetry/index.js';
 /** Projects one `tracking-items` payload. Pure: the offline tests target this. */

package/dist/carriers/spring-gds/adapter.js

@@ -1,3 +1,29 @@
+/**
+ * PostNL international tracking (carrier id `spring-gds`).
+ *
+ * The folder keeps the historical `spring-gds` id for parcels and clients that
+ * already store it; the carrier is presented as PostNL everywhere else. Spring
+ * GDS is PostNL's international subsidiary and its mailingtechnology.com
+ * portal shows the same barcode (see this folder's README).
+ *
+ * `postnl.post` hands out a visitor token that lasts a day to anyone who asks,
+ * then accepts a batch tracking request with it. The tracker keeps the token
+ * for its later lookups. Both calls replay once after a transport failure or an
+ * HTTP 502/503/504, and an HTTP 429 only when it supplies a short, valid
+ * `Retry-After` that ends before the lookup does. A 429 left standing names the
+ * wait PostNL asked for.
+ *
+ * The response echoes the requested barcodes, so the item whose `item` equals
+ * the requested number is the only one read. PostNL answers an unknown barcode
+ * with an ordinary item that has no events and says so in `message`.
+ *
+ * A 3S barcode sent within the Netherlands is not there: PostNL's domestic
+ * tracker on jouw.postnl.nl shows it, given the barcode, the country and the
+ * delivery postcode. With a Dutch postcode, or another country's postcode
+ * given with that country, that tracker is asked first.
+ */
+import { recognizeFromLookup } from '../../core/adapter/index.js';
+import { CARRIER_DEFINITIONS } from '../../core/catalog/definitions.js';
 import { DateTime } from 'luxon';
 import { CarrierError, IndeterminateError, InputRequiredError, NoHistoryError, NotFoundError, RateLimitedError, SchemaError, TransportError, UpstreamHttpError, UpstreamNetworkError, } from '../../core/errors/index.js';
 import { runSteps } from '../../core/runner/index.js';
@@ -8,6 +34,7 @@ import { fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/
 import { isRecord } from '../../core/types.js';
 import { postNLCode, postNLDomesticStage, postNLStatus } from './status.js';
 const PROVIDER = 'PostNL';
+const RECOGNIZED = new RegExp(CARRIER_DEFINITIONS['spring-gds']?.tracking.recognitionPattern ?? '(?!)');
 const TOKEN_URL = 'https://postnl.post/api/v1/auth/token';
 const TRACK_URL = 'https://postnl.post/api/v1/tracking-items';
 const DOMESTIC_URL = 'https://jouw.postnl.nl/track-and-trace/api/trackAndTrace';
@@ -449,5 +476,8 @@ export const adapter = (environment) => {
         // on the same host, and each replays once inside the step.
         steps: ['domestic', 'direct'],
         track: (input, context) => tracker.fetch(input.number, context, input.postcode, input.postcodeCountry),
+        // Only the series the catalog's recognition pattern names: a 3S barcode PostNL
+        // does not find may still be on the domestic tracker, behind a postcode.
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => RECOGNIZED.test(comparableIdentifier(number))),
     };
 };

package/dist/carriers/spring-gds/carrier.json

@@ -40,6 +40,10 @@
       "domestic",
       "direct"
     ],
+    "recognition": {
+      "rank": 524,
+      "pattern": "^1810\\d{14}$"
+    },
     "refresh": {
       "minMinutes": 30
     },
@@ -118,6 +122,11 @@
       "id": "spring-gds-3",
       "pattern": "^(?=.{13}$|.{15}$)3S[A-Z]{1,3}\\d+$",
       "confidence": "low"
+    },
+    {
+      "id": "spring-gds-1810",
+      "pattern": "^1810\\d{14}$",
+      "confidence": "low"
     }
   ]
 }

package/dist/carriers/spring-gds/numbers.json

@@ -595,6 +595,23 @@
         "confidence": "high"
       },
       "note": "A PostNL tracking link archived by the Wayback Machine. PostNL's tracker returns its history, an item delivered abroad."
+    },
+    {
+      "number": "181011000000000017",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "donated_real",
+      "shapeConfirmed": "2026-10-29",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "spring-gds",
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Made-up number in the shape of a parcel for Italy that PostNL's international tracker answered: 1810 and fourteen digits."
     }
   ]
 }

package/dist/carriers/techlink/statuses.json

@@ -6,6 +6,7 @@
     {"code": "Warehousing_Packed", "wording": "Parcel has been packed and is ready for outbound shipping", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-21", "note": "Packed at the warehouse for the line abroad; its Chinese name is 包裹装箱."},
     {"code": "Warehousing_Departed", "wording": "Departed from the original facility", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-25", "note": "The parcel left Techlink's warehouse in China."},
     {"code": "Decl_ExportDone", "wording": "Export customs declaration completed", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-25", "note": "China's export declaration, written after the parcel left the warehouse; the parcel is not held in customs."},
-    {"code": "InTransit_Departure", "wording": "Depart from the original airport", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-26", "note": "The flight left the airport in China."}
+    {"code": "InTransit_Departure", "wording": "Depart from the original airport", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-26", "note": "The flight left the airport in China."},
+    {"code": "InTransit_Arrival", "wording": "Arrive at the destination airport", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-29", "note": "The flight landed in the destination country, before its import clearance."}
   ]
 }

package/dist/data/catalog.json

@@ -427,6 +427,8 @@
                     "autoComplete": "postal-code"
                 }
             ],
+            "recognitionRank": 524,
+            "recognitionPattern": "^1810\\d{14}$",
             "refresh": {
                 "minMinutes": 30
             },
@@ -476,6 +478,10 @@
             {
                 "pattern": "^(?=.{13}$|.{15}$)3S[A-Z]{1,3}\\d+$",
                 "confidence": "low"
+            },
+            {
+                "pattern": "^1810\\d{14}$",
+                "confidence": "low"
             }
         ]
     },

package/dist/generated/catalog.d.ts

@@ -298,6 +298,8 @@ export declare const CARRIER_CATALOG: {
                 readonly inputMode: "text";
                 readonly autoComplete: "postal-code";
             }];
+            readonly recognitionRank: 524;
+            readonly recognitionPattern: "^1810\\d{14}$";
             readonly refresh: {
                 readonly minMinutes: 30;
             };
@@ -330,6 +332,9 @@ export declare const CARRIER_CATALOG: {
         }, {
             readonly pattern: "^(?=.{13}$|.{15}$)3S[A-Z]{1,3}\\d+$";
             readonly confidence: "low";
+        }, {
+            readonly pattern: "^1810\\d{14}$";
+            readonly confidence: "low";
         }];
     };
     readonly postlogistics: {

package/dist/generated/catalog.js

@@ -428,6 +428,8 @@ export const CARRIER_CATALOG = {
                     "autoComplete": "postal-code"
                 }
             ],
+            "recognitionRank": 524,
+            "recognitionPattern": "^1810\\d{14}$",
             "refresh": {
                 "minMinutes": 30
             },
@@ -477,6 +479,10 @@ export const CARRIER_CATALOG = {
             {
                 "pattern": "^(?=.{13}$|.{15}$)3S[A-Z]{1,3}\\d+$",
                 "confidence": "low"
+            },
+            {
+                "pattern": "^1810\\d{14}$",
+                "confidence": "low"
             }
         ]
     },
@@ -36392,7 +36398,7 @@ export const DETECTION_RULE_IDS = {
     "aliexpress": ["aliexpress-1", "aliexpress-cnfr", "aliexpress-2", "aliexpress-maersk", "aliexpress-lp-reference", "aliexpress-ap-reference", "aliexpress-cnbr", "aliexpress-cnmex", "aliexpress-cnusup", "aliexpress-cacainiao", "aliexpress-rl", "aliexpress-jncn", "aliexpress-gfus", "aliexpress-ecsc-aaro", "aliexpress-pa", "aliexpress-f", "aliexpress-9c-i", "aliexpress-9c-j", "aliexpress-rtz", "aliexpress-fmp", "aliexpress-sda-waybill", "aliexpress-ty", "aliexpress-mi", "aliexpress-xx"],
     "sunyou": ["sunyou-1", "sunyou-2", "sunyou-3"],
     "hermes": ["hermes-delivery-note"],
-    "spring-gds": ["spring-gds-1", "spring-gds-2", "spring-gds-3"],
+    "spring-gds": ["spring-gds-1", "spring-gds-2", "spring-gds-3", "spring-gds-1810"],
     "postlogistics": ["postlogistics-dashed-reference", "postlogistics-compact-reference"],
     "dachser": [],
     "dhl": ["dhl-1", "dhl-14", "dhl-16", "dhl-15", "dhl-9", "dhl-8", "dhl-10", "dhl-3", "dhl-13", "dhl-12", "dhl-7"],

package/dist/generated/recognition.js

@@ -404,6 +404,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "speedaf": 989,
     "speedex": 938,
     "speedy": 280,
+    "spring-gds": 524,
     "spx-br": 982,
     "st-courier": 753,
     "stallion-express": 105,

package/dist/providers/shared/result.js

@@ -560,13 +560,18 @@ const LOCAL_WALL_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?$/;
 // A flight written before it leaves is still to come: no scan, as the lines' own trackers drop it.
 // 17FEIA's estimated departure, and the flight DHLink, Intel-Valley and Mayi Yinfu book.
 const flightToCome = (label) => FLIGHT_ESTIMATE.test(label) || DHLINK_FLIGHT.test(label) || intelValleyFlight(label) || MAYIYINFU_FLIGHT.test(label);
+// A carrier's schedule, as 17TRACK relays it beside the milestones: an ocean line's estimated vessel departure and
+// arrival, each again once updated, and its cargo cut-off, and a flight's ETD or ETA. Each is dated when it is due,
+// often weeks ahead, so it is no scan.
+const SCHEDULE = /^(?:estimated vessel (?:departure|arrival)|cfs\/cy cut-off date)(?: \(last updated\))?$|^flight et[ad]\b/i;
 // A time or date in brackets with no words, as 17TRACK relays a Juxi Express row between the flight
-// being arranged at the airport and the departure: it says nothing happened, so it is no scan.
-const BARE_TIME = /^[(（]\s*\d{1,2}\s*[:：]\s*\d{1,2}\s*[)）]$/;
+// being arranged at the airport and the departure, and ParcelsApp one dated by month and day ("(10.20)")
+// between its departure and arrival: it says nothing happened, so it is no scan.
+const BARE_TIME = /^[(（]\s*\d{1,2}\s*[:：.．]\s*\d{1,2}\s*[)）]$/;
 function describe(description, stage) {
     // A copy of SunYou's departure drops the last-mile number, as SunYou's own result does.
     const label = sunYouWording(relayedNotice(text(description)).replace(CLEARANCE_STATUS, ''));
-    if (!label || isNotice(label) || flightToCome(label) || BARE_TIME.test(label))
+    if (!label || isNotice(label) || flightToCome(label) || SCHEDULE.test(label) || BARE_TIME.test(label))
         return null;
     const declared = typeof stage === 'string' && Object.hasOwn(STAGES, stage) ? STAGES[stage] : undefined;
     // Established source semantics (e.g. handoff/negation) remain first. A real

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.809.2-main.4367"
+    "version": "0.810.1-main.4374"
   },
   "paths": {
     "/health": {

package/package.json

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