universal-parcel-scraper 0.654.0-main.3113 → 0.654.2-main.3118

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,485 such statuses, each filed under one stage.
+The carrier folders record 16,496 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/correos-chile/status.js

@@ -1,6 +1,23 @@
 function comparable(value) {
-    return value.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toUpperCase().replace(/\s+/g, ' ').trim();
+    return value.normalize('NFD').replace(/[̀-ͯ]/g, '').toUpperCase().replace(/\s+/g, ' ').trim();
 }
+const TRANSIT = { status: 'in_transit', stage: 'in_transit' };
+// Scans of a parcel leaving Chile and of the legs before delivery, as providers and an
+// open-source client relay them, without the portal's code. The whole wording must match.
+const WORDINGS = new Map([
+    ['RECIBIDO POR CORREOSCHILE', { status: 'in_transit', stage: 'accepted' }],
+    ['RECIBIDO EN PLANTA DE ORIGEN', TRANSIT],
+    ['RECIBIDO EN PLANTA ORIGEN', TRANSIT],
+    ['ENVIO DESPACHADO', TRANSIT],
+    ['DESPACHADO A OFICINA DE CORREOSCHILE', TRANSIT],
+    ['RECIBIDO EN OFICINA DE CORREOSCHILE', TRANSIT],
+    ['DISPONIBLE PARA SALIR AL PAIS DE DESTINO', TRANSIT],
+    ['ENVIO DESPACHADO AL PAIS DE DESTINO', TRANSIT],
+    ['ENVIO INGRESA A PAIS DE DESTINO', TRANSIT],
+    ['RECEPCION INTERNACIONAL POR CORREOSCHILE', TRANSIT],
+    // The destination country's import, after the parcel entered it.
+    ['ENVIO EN PROCESO DE INTERNACION', { status: 'in_transit', stage: 'customs' }],
+]);
 /** Only actual scan wording establishes progress; the portal also sends future rail markers. */
 export function classifyCorreosChileScan(code, wording) {
     const label = comparable(wording);
@@ -13,5 +30,5 @@ export function classifyCorreosChileScan(code, wording) {
     if ((code === '006' || code === '010') && label === 'ENVIO ENTREGADO') {
         return { status: 'delivered', stage: 'delivered' };
     }
-    return null;
+    return WORDINGS.get(label) ?? null;
 }

package/dist/carriers/correos-chile/statuses.json

@@ -7,6 +7,83 @@
       "language": "es",
       "stage": "customs",
       "confirmedBy": "live"
+    },
+    {
+      "wording": "RECIBIDO POR CORREOSCHILE",
+      "language": "es",
+      "stage": "accepted",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "RECIBIDO EN PLANTA DE ORIGEN",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "ENVIO DESPACHADO",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "DISPONIBLE PARA SALIR AL PAIS DE DESTINO",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "ENVIO DESPACHADO AL PAIS DE DESTINO",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "ENVIO INGRESA A PAIS DE DESTINO",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "ENVIO EN PROCESO DE INTERNACION",
+      "language": "es",
+      "stage": "customs",
+      "confirmedBy": "live",
+      "note": "A parcel leaving Chile, as a universal provider relays it without the portal code."
+    },
+    {
+      "wording": "RECIBIDO EN PLANTA ORIGEN",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "note": "In the example reply of an open-source Correos de Chile client, without the portal code."
+    },
+    {
+      "wording": "DESPACHADO A OFICINA DE CORREOSCHILE",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "note": "In the example reply of an open-source Correos de Chile client, without the portal code."
+    },
+    {
+      "wording": "RECIBIDO EN OFICINA DE CORREOSCHILE",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "note": "In the example reply of an open-source Correos de Chile client, without the portal code."
+    },
+    {
+      "wording": "RECEPCION INTERNACIONAL POR CORREOSCHILE",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "prior-art",
+      "note": "In the example reply of an open-source Correos de Chile client, without the portal code."
     }
   ]
 }

package/dist/carriers/dhl/adapter.d.ts

@@ -61,8 +61,8 @@ export declare class DHLTracker {
     /**
      * Whether DHL Paket knows the number, over HTTP alone: the direct session,
      * renewed as for a lookup, and never the browser. DHL's explicit no-data
-     * answer is unknown; a rejected session, another DHL service or a postcode
-     * request stays inconclusive.
+     * answer is unknown; a postcode request for a parcel DHL holds is known; a
+     * rejected session or another DHL service stays inconclusive.
      */
     recognizes(trackingNumber: string, context?: TrackingContext): Promise<Recognition>;
     private lookup;

package/dist/carriers/dhl/adapter.js

@@ -97,10 +97,12 @@ export function parseDHLTrackingResponse(payload, trackingNumber) {
     if (matches.length !== 1)
         throw new SchemaError(PROVIDER, 'DHL did not return one matching shipment');
     const shipment = matches[0];
+    const missing = isRecord(shipment.sendungNichtGefunden) ? shipment.sendungNichtGefunden : {};
     if (shipment.plzBenoetigt === true || shipment.versandDatumBenoetigt === true) {
-        throw new InputRequiredError(PROVIDER, 'a postcode or shipping date', 'DHL requires additional verification on its tracking website');
+        // DHL asks the recipient's postcode to show a parcel it holds; a record it also calls not found names none.
+        const held = shipment.plzBenoetigt === true && !Object.values(missing).some((flag) => flag === true);
+        throw new InputRequiredError(PROVIDER, 'a postcode or shipping date', 'DHL requires additional verification on its tracking website', held ? { reason: 'parcel_found' } : undefined);
     }
-    const missing = isRecord(shipment.sendungNichtGefunden) ? shipment.sendungNichtGefunden : {};
     // DHL Paket's tracker answered that it holds no Paket shipment under the number. Another DHL
     // service may still know it, so it stays inconclusive, but it is an answer, not an outage.
     if (missing.keineDhlPaketSendung === true || missing.sendungsnummerNichtSuchbar === true) {
@@ -274,8 +276,8 @@ export class DHLTracker {
     /**
      * Whether DHL Paket knows the number, over HTTP alone: the direct session,
      * renewed as for a lookup, and never the browser. DHL's explicit no-data
-     * answer is unknown; a rejected session, another DHL service or a postcode
-     * request stays inconclusive.
+     * answer is unknown; a postcode request for a parcel DHL holds is known; a
+     * rejected session or another DHL service stays inconclusive.
      */
     async recognizes(trackingNumber, context = {}) {
         return takeTurn(this.serialize, 'dhl', context, (left) => {

package/dist/places/index.js

@@ -411,7 +411,8 @@ function candidates(data, key, carriers) {
 export function locatePlace(location, hints = {}) {
     return locate(location, hints)?.place ?? null;
 }
-function locate(location, hints) {
+/** `split` reads a country the text names apart from its town; without it the whole text is the town's. */
+function locate(location, hints, split = true) {
     const text = location?.trim();
     // A military post office's base can be anywhere in its region (`militaryPostOffice`).
     if (!text || militaryPostOffice(text))
@@ -420,7 +421,7 @@ function locate(location, hints) {
     if (facility)
         return { place: facility, text: true };
     const data = gazetteer();
-    const explicit = trackingPlace(text);
+    const explicit = split ? trackingPlace(text) : { country: null, place: text };
     let country = explicit.country && data.countries.has(explicit.country) ? explicit.country : null;
     let rest = explicit.country ? explicit.place : text;
     const context = hints.countries ?? [];
@@ -569,6 +570,16 @@ function locate(location, hints) {
             },
         };
     }
+    // A hub named after a city that shares a country's name: GIG Logistics' "BENIN HUB"
+    // is in Benin City. On a parcel in the city's country, and not in the named one, the
+    // city it is, when it is a large one.
+    const facilityWords = tokens(rest);
+    if (country && !context.includes(country) && text.endsWith(rest) && facilityWords.length
+        && facilityWords.every((token) => FACILITY_WORDS.has(token.key))) {
+        const town = locate(text, hints, false);
+        if (town?.place.precision === 'city' && context.includes(town.place.country) && (town.thousands ?? 0) >= NAMESAKE_THOUSANDS)
+            return town;
+    }
     // A two-letter code with no town of its country before it, on a parcel nothing else puts
     // there, may be no country at all: Royal Mail ends its mail centres with MC and its
     // delivery offices with DO, India's states are written like countries. A town the text

package/dist/server/openapi.json

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

package/package.json

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