universal-parcel-scraper 0.776.0-main.4145 → 0.776.2-main.4151

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,127 such statuses, each filed under one stage.
+The carrier folders record 17,129 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/correios-br/status.js

@@ -30,6 +30,8 @@ const codes = {
     'PAR/21': { status: 'in_transit', stage: 'customs' },
     // The import waits for the recipient's tax number before customs can clear it.
     'FC/16': { status: 'in_transit', stage: 'customs' },
+    // The import waits for customs to settle the product's classification code.
+    'FC/40': { status: 'in_transit', stage: 'customs' },
     'PAR/24': { status: 'exception', stage: 'returned' },
 };
 export function classifyCorreiosStatus(code) {

package/dist/carriers/correios-br/statuses.json

@@ -14,6 +14,7 @@
     { "code": "PAR/07", "wording": "Análise concluída - importação autorizada", "language": "pt", "stage": "in_transit", "confirmedBy": "live" },
     { "code": "PAR/21", "wording": "Informações enviadas para análise da autoridade aduaneira/órgãos anuentes", "language": "pt", "stage": "customs", "confirmedBy": "live" },
     { "code": "FC/16", "wording": "Necessidade de informar CPF/CNPJ do destinatário", "language": "pt", "stage": "customs", "confirmedBy": "live", "note": "The import waits for the recipient's tax number (CPF or CNPJ) before customs can clear it." },
+    { "code": "FC/40", "wording": "Objeto em processo de identificação do código de classificação do produto", "language": "pt", "stage": "customs", "confirmedBy": "live", "note": "The import waits for customs to settle the product's classification code, after Correios received the item." },
     { "code": "BDI/01", "wording": "Objeto entregue ao destinatário", "language": "pt", "stage": "delivered", "confirmedBy": "live" },
     { "code": "BDE/10", "wording": "Objeto não entregue - cliente mudou-se", "language": "pt", "stage": "failed_attempt", "confirmedBy": "live" },
     { "code": "BDE/20", "wording": "Objeto não entregue - carteiro não atendido", "language": "pt", "stage": "failed_attempt", "confirmedBy": "live" },

package/dist/carriers/dpd-uk/identity.js

@@ -1,11 +1,17 @@
 import { dpdUkWording, withoutDriverName } from './wording.js';
-const wording = (scan) => dpdUkWording(withoutDriverName(scan.description));
+// DPD UK rewords a depot scan as the parcel moves on: it has arrived at the depot, it is there
+// ready for delivery, then it is at the depot. The three are one scan.
+const DEPOT = /^your parcel (?:has arrived at|is at) our depot(?: ready for delivery)?$/;
+function wording(scan) {
+    const text = dpdUkWording(withoutDriverName(scan.description));
+    return DEPOT.test(text) ? 'your parcel is at our depot' : text;
+}
 /** One scan, by its wording and place. DPD UK's scans have no code. */
 function sameScan(incoming, stored) {
     return wording(incoming) !== '' && wording(incoming) === wording(stored) && incoming.location.trim() === stored.location.trim();
 }
-// The round's notice drops the hour it gave for the delivery once the round is over, and
-// earlier releases kept the driver's name a scan gives. The scan keeps its row either way.
+// The round's notice drops the hour it gave for the delivery once the round is over, a depot
+// scan is reworded, and earlier releases kept the driver's name a scan gives. The scan keeps its row.
 export const sameInstantIdentityPolicy = {
     sourceCarrierId: 'dpd-uk', storedSources: ['dpd-uk'], requireProviderCode: false, matchEachScan: true, matches: sameScan,
 };

package/dist/carriers/dpd-uk/parser.js

@@ -57,6 +57,7 @@ const VERIFIED_WORDING = {
     'the parcel is on the vehicle for delivery': 'out_for_delivery',
     'your parcel is at our depot': 'in_transit',
     'your parcel has arrived at our depot': 'in_transit',
+    'your parcel is at our depot ready for delivery': 'in_transit',
     "your parcel has left our sortation facility and is on it's onwards journey": 'in_transit',
     'the parcel has arrived at the delivery depot': 'in_transit',
     'the parcel is in transit to its final destination': 'in_transit',

package/dist/carriers/dpd-uk/statuses.json

@@ -8,6 +8,7 @@
     { "wording": "We have your parcel and it's on its way to you", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-08" },
     { "wording": "Your parcel is at our depot", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-08" },
     { "wording": "Your parcel has arrived at our depot", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-08" },
+    { "wording": "Your parcel is at our depot ready for delivery", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-28", "note": "A depot scan as DPD rewords it once the parcel is ready for its round; later it reads \"Your parcel is at our depot\"." },
     { "wording": "Your parcel has left our sortation facility and is on it's onwards journey", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-08", "note": "On a parcel leaving the UK." },
     { "wording": "The parcel is in transit to its final destination", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-08", "note": "The partner's wording on a parcel delivered abroad, as are the other entries starting with \"The parcel\"." },
     { "wording": "The parcel is undergoing customs clearance", "language": "en", "stage": "customs", "confirmedBy": "live", "firstSeen": "2026-10-08" },

package/dist/carriers/magyar-posta/adapter.d.ts

@@ -20,7 +20,7 @@ export declare function magyarPostaBrowser(trawl: TrawlClient, raw: string, sign
  * the number, bound to the whole number. The reply is the item, as later reads
  * of the id return it.
  */
-export declare function magyarPostaAppBrowser(trawl: TrawlClient, raw: string, applicationId: string, signal: AbortSignal, remainingMs: number): Promise<CarrierResult>;
+export declare function magyarPostaAppBrowser(trawl: TrawlClient, raw: string, applicationId: string, signal: AbortSignal, remainingMs: number, rememberApplication?: () => void, supportsRegistrationCache?: () => void): Promise<CarrierResult>;
 export declare class MagyarPostaTracker {
     #private;
     private readonly options;

package/dist/carriers/magyar-posta/adapter.js

@@ -82,7 +82,7 @@ export async function magyarPostaBrowser(trawl, raw, signal, remainingMs) {
  * the number, bound to the whole number. The reply is the item, as later reads
  * of the id return it.
  */
-export async function magyarPostaAppBrowser(trawl, raw, applicationId, signal, remainingMs) {
+export async function magyarPostaAppBrowser(trawl, raw, applicationId, signal, remainingMs, rememberApplication, supportsRegistrationCache) {
     const number = normalizeMagyarPostaNumber(raw);
     const timeoutMs = Math.floor(remainingMs - 2000);
     if (timeoutMs < 1)
@@ -90,6 +90,10 @@ export async function magyarPostaAppBrowser(trawl, raw, applicationId, signal, r
     const page = await trawl.scrape({ url: magyarPostaAppTrackingUrl(applicationId, number), skipHttp: true, maxTier: 3,
         captureResponses: [MAGYAR_POSTA_APP_TRACKING], maxTimeout: timeoutMs, settleTimeout: timeoutMs }, { provider: PROVIDER, timeoutMs, signal, requireSolved: false, captureWindow: 'last', maxBytes: 2 * MAGYAR_POSTA_MAX_BYTES });
     signal.throwIfAborted();
+    if (page.capturedResponses.some(row => row.headers['x-magyar-posta-registration-cache'] === 'memory'
+        && ((row.url === MAGYAR_POSTA_APP_PAGE && row.error === REFUSED)
+            || (row.url === MAGYAR_POSTA_APP_TRACKING && row.trackingNumberSubmitted === number))))
+        supportsRegistrationCache?.();
     if (page.capturedResponses.some(row => row.url === MAGYAR_POSTA_APP_PAGE && row.error === REFUSED)) {
         throw new ChallengeError(PROVIDER, 'Google refused Magyar Posta\'s audio challenge', { reason: 'verification_refused' });
     }
@@ -100,10 +104,13 @@ export async function magyarPostaAppBrowser(trawl, raw, applicationId, signal, r
     // No addition left the widget page: its page failed, or the widget issued no token.
     if (!reply)
         throw httpFailure(page.statusCode) ?? new ChallengeError(PROVIDER, 'Magyar Posta\'s app widget issued no token');
+    if (reply.error === 'Magyar Posta returned no bound cached history')
+        throw new SchemaError(PROVIDER, 'Magyar Posta returned unbound cached history');
     if (reply.error || reply.truncated || reply.base64Encoded)
         throw new TransportError(PROVIDER, 'Magyar Posta returned an incomplete app reply');
     const payload = reply.body === null ? null : magyarPostaAppJson(reply.body);
-    if (reply.status === 502 && typeof payload === 'object' && payload !== null && payload.message === UNADDED) {
+    if (reply.headers['x-magyar-posta-registration'] !== 'retained' && reply.status === 502
+        && typeof payload === 'object' && payload !== null && payload.message === UNADDED) {
         throw new UnaddedError(PROVIDER, 'Magyar Posta\'s app did not add the number');
     }
     const failure = magyarPostaAppFailure(reply.status, reply.headers['retry-after']);
@@ -112,12 +119,18 @@ export async function magyarPostaAppBrowser(trawl, raw, applicationId, signal, r
     const result = parseMagyarPostaApp(payload, number);
     if (!result)
         throw new SchemaError(PROVIDER, 'Magyar Posta\'s app added the number without returning it');
+    // A retained registration belongs to the helper, not to this new app id.
+    // Its capability stays in the helper's memory rather than entering results.
+    if (reply.headers['x-magyar-posta-registration'] !== 'retained')
+        rememberApplication?.();
     return result;
 }
 export class MagyarPostaTracker {
     options;
     /** Until when Google's refusal holds, for the app's widget and for the tracker's checkbox, which have their own keys. */
     #refusedUntil = { app: 0, web: 0 };
+    /** A helper with retained registrations checks those before its own widget cooldown. */
+    #registrationCache = false;
     /** The application id each added number is read under, oldest first. */
     #added = new Map();
     /** The id new numbers go to, generated when first needed, and how many it took. */
@@ -178,7 +191,7 @@ export class MagyarPostaTracker {
                     const id = await this.#applicationId(signal, remainingMs);
                     const route = id ? 'app' : 'web';
                     // Another solve soon after a refusal would hold a browser for the same answer.
-                    if (Date.now() < this.#refusedUntil[route]) {
+                    if (Date.now() < this.#refusedUntil[route] && !(route === 'app' && this.#registrationCache)) {
                         throw new ChallengeError(PROVIDER, 'Google refused Magyar Posta\'s audio challenge recently', { reason: 'verification_refused' });
                     }
                     if (id && (this.#unadded.get(number) ?? 0) > Date.now()) {
@@ -190,10 +203,13 @@ export class MagyarPostaTracker {
                         if (!id)
                             return await magyarPostaBrowser(trawl, number, signal, left);
                         const current = this.#current;
-                        const result = await magyarPostaAppBrowser(trawl, number, id, signal, left);
-                        if (current && this.#current === current)
-                            current.count++;
-                        this.#remember(number, id);
+                        let added = false;
+                        const result = await magyarPostaAppBrowser(trawl, number, id, signal, left, () => { added = true; }, () => { this.#registrationCache = true; });
+                        if (added) {
+                            if (current && this.#current === current)
+                                current.count++;
+                            this.#remember(number, id);
+                        }
                         return result;
                     }
                     catch (error) {

package/dist/providers/shared/result.js

@@ -246,6 +246,12 @@ function providerWordingStage(description) {
         return 'registered';
     if (/^export declaration in progress[.!]?$/i.test(value))
         return 'customs';
+    // KTD's steps as ParcelsApp relays them: the first carrier's local warehouse taking the parcel in and
+    // sending it on to KTD's warehouse, the parcel leaving that, its export cleared and its flight taking off.
+    if (/^package received and scanned at the carrier['’]s local warehouse[.!]?$/i.test(value))
+        return 'accepted';
+    if (/^package leaves the carrier['’]s local warehouse[.!]?$|^your item has left the [a-z ]{1,40} warehouse[.!]?$|^export declaration completed[.!]?$|^take ?off[.!]?$/i.test(value))
+        return 'in_transit';
     // MRW's own wording for a parcel left at one of its pickup points, relayed by a provider,
     // and for its pickup from the sender still to come, as MRW's own map reads them.
     if (/^depositado en punto mrw[.!]?$/i.test(value))

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.776.0-main.4145"
+    "version": "0.776.2-main.4151"
   },
   "paths": {
     "/health": {

package/package.json

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