universal-parcel-scraper 0.241.0 → 0.241.1-main.1513

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

package/dist/browser/scraper.js

@@ -21798,7 +21798,7 @@ for (let e of [
 ]) {
 	let t = e === "en" ? ss : new Intl.DisplayNames([e], { type: "region" });
 	for (let n of cs) {
-		let r = t.of(n), i = e === "de" ? [r, r.replace(/[äöüÄÖÜ]/g, (e) => `${e.normalize("NFD")[0]}e`)] : [r];
+		let r = t.of(n), i = e === "de" ? [r, r.replace(/[äöüÄÖÜ]/g, (e) => `${e.normalize("NFD")[0]}e`)] : e === "en" ? [r, r.replace(/ & /g, " and ").replace(/^St\. /, "Saint ")] : [r];
 		for (let t of i.map(ls)) !us.has(t) && (e === "en" || !Jo(t)) && us.set(t, n);
 	}
 }

package/dist/carriers/imile/parser.js

@@ -2,6 +2,7 @@ import { DateTime } from 'luxon';
 import { normalizeTrackingNumber } from '../../core/detection/index.js';
 import { IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, RateLimitedError, SchemaError } from '../../core/errors/index.js';
 import { languageStageStatus } from '../../core/status/index.js';
+import { countryTimeZone, isoTime } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { imileStage } from './status.js';
@@ -71,8 +72,7 @@ export function imileWording(raw) {
 }
 /**
  * A scan's clock: a wall clock to the second with no zone. The page says it
- * is the recipient country's time, and several of iMile's countries have
- * more than one zone, so it stays local.
+ * is the recipient country's time, which places it once that country is known.
  */
 function scanClock(row) {
     const stamp = text(row, 'time', 32);
@@ -160,15 +160,23 @@ export function parseImile(payload, raw) {
     const stage = current?.stage;
     const code = text(shipment, 'country', 8).toUpperCase();
     const country = Object.hasOwn(COUNTRIES, code) ? COUNTRIES[code] : undefined;
+    // Every scan shows the recipient country's clock: a country of one zone
+    // places them all, and one of several leaves them local.
+    const zone = country ? countryTimeZone(country) : null;
+    const placed = zone ? newestFirst.map(({ local_time, ...event }) => {
+        const time = isoTime(local_time, zone)?.iso;
+        return time ? { time, ...event } : { local_time, ...event };
+    }) : newestFirst;
+    const latest = placed[0];
     return {
         status: stage ? languageStageStatus(stage) : 'unknown',
         ...(stage ? { current_stage: stage, current_stage_source: current.stage_source } : {}),
         last_status_text: newest.description,
-        last_update: null,
-        last_update_local: newest.local_time,
+        last_update: latest.time ?? null,
+        ...(latest.time ? {} : { last_update_local: newest.local_time }),
         expected_delivery: null,
         ...(country ? { destination_country: country } : {}),
-        events: newestFirst.slice(0, MAX_EVENTS),
+        events: placed.slice(0, MAX_EVENTS),
         ...(newestFirst.length > MAX_EVENTS ? { history_truncated: true } : {}),
     };
 }

package/dist/carriers/imile/status.js

@@ -45,6 +45,7 @@ const PHRASES = new Map([
     ['airplane clearance finish,ready to ship to', 'in_transit'],
     // The driver is named before the parcel leaves the centre; the misspelling is iMile's.
     ['your order has assigned delivery drvier', 'in_transit'],
+    ['dispatch task assigned to da', 'in_transit'],
     ['our delivery associate is out for delivery', 'out_for_delivery'],
     ['delivery attempt finished,return to local logistics company warehouse', 'failed_attempt'],
     // Drivers' reasons, each followed by the attempt's end and the return to the centre.
@@ -53,6 +54,9 @@ const PHRASES = new Map([
     ['route not completed', 'failed_attempt'],
     ['user not at home', 'failed_attempt'],
     ['wrong address', 'failed_attempt'],
+    ['<bad address>', 'failed_attempt'],
+    // A recipient iMile cannot reach, on the delivery run before the return starts.
+    ['need to return', 'exception'],
     ['lost order', null],
     ['inventory count scan', null],
     ['your order has been delivered successfully', 'delivered'],
@@ -66,6 +70,8 @@ const PHRASES = new Map([
  * flight and a scheduled delivery day are no movement.
  */
 const OPENINGS = [
+    // The origin airport's warehouse took the parcel in; the flight it books follows.
+    [/^origin port warehouse receive\b/, 'in_transit'],
     [/^flight schedule etd\b/, null],
     [/^shipment is scheduled to\b/, null],
     [/^the driver failed to deliver\b/, 'failed_attempt'],

package/dist/carriers/imile/statuses.json

@@ -38,6 +38,10 @@
     {"code": "1003", "wording": "wrong address", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "note": "A driver's reason, followed by the attempt's end."},
     {"code": "1003", "wording": "Lost order", "language": "en", "confirmedBy": "live", "unmapped": true, "note": "A driver's reason during a delivery run, followed by the attempt's end; the parcel it was seen on went out again and was delivered, so it does not establish a loss."},
     {"code": "1003", "wording": "Delivery attempt finished,return to Local logistics company warehouse.", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "note": "The parcel goes back to the station after an attempt."},
+    {"wording": "Origin port warehouse receive，Flight Schedule ETD【MIA】<2026-01-13 07:05:00>, ETA【BOG】<2026-01-13 09:50:00>", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "The origin airport's warehouse took the parcel in, with the flight booked for it; logged without a code."},
+    {"code": "1003", "wording": "【Sample DS】Dispatch task assigned to DA.", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "A delivery associate named before the run."},
+    {"code": "1003", "wording": "<Bad Address>", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "note": "A driver's reason during a delivery run; the parcel went out again after it."},
+    {"code": "1003", "wording": "【Contact Error】need to return.", "stage": "exception", "language": "en", "confirmedBy": "live", "note": "The recipient could not be reached; the return starts after it."},
     {"code": "2060", "wording": "Your order has been delivered successfully.", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "Some countries add who took the parcel, which the adapter drops."},
     {"code": "2060", "wording": "【DS CCA】Your package was received.", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "The Brazilian wording; the reply names who took the parcel and adds iMile's support contacts, which the adapter drops."},
     {"code": "1008", "wording": "Order delivery failed, returning to sender.", "stage": "returned", "language": "en", "confirmedBy": "live", "note": "Return Handling Process; the reply adds a support line, which the adapter drops."},

package/dist/core/time/index.js

@@ -192,7 +192,10 @@ for (const language of ['en', 'de', 'fr', 'it', 'es', 'nl']) {
     for (const code of REGION_CODES) {
         const name = names.of(code);
         // German written without umlauts puts an e after the vowel: "Oesterreich".
-        const spellings = language === 'de' ? [name, name.replace(/[äöüÄÖÜ]/g, (vowel) => `${vowel.normalize('NFD')[0]}e`)] : [name];
+        // English names Intl abbreviates are also written out: "Bosnia and
+        // Herzegovina", "Saint Lucia".
+        const spellings = language === 'de' ? [name, name.replace(/[äöüÄÖÜ]/g, (vowel) => `${vowel.normalize('NFD')[0]}e`)]
+            : language === 'en' ? [name, name.replace(/ & /g, ' and ').replace(/^St\. /, 'Saint ')] : [name];
         for (const key of spellings.map(regionKey)) {
             // A name a large town shares names the town as often as the country.
             if (!REGION_BY_NAME.has(key) && (language === 'en' || !townName(key)))

package/dist/providers/shared/result.js

@@ -157,6 +157,27 @@ function providerWordingStage(description) {
     // A return on its way back to the sender, as other unfinished returns.
     if (/^the shipment is handled by a return consolidator[.!]?$/i.test(value))
         return 'exception';
+    // Relay's notices on Vinted parcels, from the label to the parcel in its hands.
+    if (/^awaiting your vinted parcel[.!]?$|^expecting your parcel[.!]?$/i.test(value))
+        return 'registered';
+    if (/^parcel received by relay[.!]?$|^received your parcel[.!]?$/i.test(value))
+        return 'accepted';
+    // SF Express's pickup notice, which goes on to name the courier.
+    if (/^sf express has received your package\b/i.test(value))
+        return 'accepted';
+    // iMile's scans as aggregators relay them, its 【】 place names cut or dropped.
+    // A wrong address sends the parcel out again; a recipient who cannot be
+    // reached closes the delivery and starts the return.
+    if (/^order submit+ed[.!]?$/i.test(value))
+        return 'registered';
+    if (/^we have received the shipment from the sender[.!]?$/i.test(value))
+        return 'accepted';
+    if (/^(?:\S+ )?cent(?:er|re) (?:received|parcel shipped to \S+)[.!]?$|^origin port warehouse receive\b|^the flight has taken off[.!]?$|^(?:\S+ )?dispatch task assigned to da[.!]?$/i.test(value))
+        return 'in_transit';
+    if (/^<bad address>$/i.test(value))
+        return 'failed_attempt';
+    if (/^contact error,? need to return[.!]?$|^start returning\b|^\S*devolucion\S* order closed[.!]?$/i.test(value))
+        return 'exception';
     if (/^warehouse receipt[.!]?$|^(?:package |parcel )?received by (?:the )?warehouse[.!]?$|^(?:package|parcel) (?:bulk )?received(?: and scanned)? at (?:the )?warehouse[.!]?$|^we['’]ve got it[.!]?$|^received at evri[.!]?$|^acceptance, sent to [a-z ]+$|^china post has received the mail\b|^envio recogido en origen[.!]?$|^first parcel scan along poste italiane['’]s logistic network\b|已收寄|^仓库收货$|^rfid confirmed pick-?up$|^usps in possession of item\b/i.test(value))
         return 'accepted';
     if (/^goods leave the operation cent(?:er|re)[.!]?$|^the shipment has left (?:the )?origin country[.!]?$|^(?:delivery\. )?your order has been shipped from (?:the distribution|\d\) [a-z ]{1,40}) cent(?:er|re)[.!]?$|^nuevo reparto(?:\. concertacion entrega flexible)?[.!]?$|^new delivery, flexible delivery arrangement[.!]?$|^inventory in a warehouse[.!]?$|^hand over to airline[.!]?$|^in lavorazione[.!]?$|^uscita centro postale[.!]?$|^przesyłka w oddziale \w{2,20}[.!]?$|^(?:package |parcel )?(?:left|leaves?) the warehouse[.!]?$|^we['’]re processing your parcel at our hub\b|^warehouse\. (?:inbound warehouse|delivery in last mile facilities|ready to hand over to last-mile supplier)[.!]?$|^hand over to last mile[.!]?$|^at destination country\/region[.!]?$|^(?:beladung|entladung)$|^entrance to the terminal from the driver$|^outbou?n?d from pickup terminal to the line ?h[ao]u?l$|^inbound from l?ine ?h[ao]u?l to (?:the )?terminal$|^[\w ]+ warehouse, .{1,80}? processing,? (?:order has been (?:in|out)bounded|assembling operation)$|^received in site[- ]|^exported[.!]?$|^(?:the )?plane has landed[.!]?$|^received by (?:the )?airline[.!]?$|^flight delay(?:ed)?[.!](?:$| the flight scheduled\b)|^wi\s*[–-]\s*intermediate warehouse\. (?:container received|package received at intermediate warehouse)[.!]?$|^delivery branch\. received at distribution branch[.!]?$|^receiving destination mail\. received by distributor[.!]?$|^container reception[.!]?$|(?:邮件|快件)(?:到达|离开)处理中心|航空公司接收|已交承运商运输|已完成分拣|^出口海关\/放行|^启运|^干线中转/i.test(value))

package/dist/server/openapi.json

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

package/package.json

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