universal-parcel-scraper 0.734.2-main.3759 → 0.736.0-main.3771

package/data/catalog.json

@@ -14902,6 +14902,11 @@
       {
         "pattern": "^CLFOX\\d{15}$",
         "confidence": "high"
+      },
+      {
+        "pattern": "^66639\\d{5,15}$",
+        "confidence": "low",
+        "preferred": true
       }
     ]
   },
@@ -20625,6 +20630,16 @@
         "confidence": "low",
         "checksum": "magyar-posta",
         "preferred": true
+      },
+      {
+        "pattern": "^RL\\d{14}$",
+        "confidence": "low",
+        "preferred": true
+      },
+      {
+        "pattern": "^JJH[A-Z0-9]{17}$",
+        "confidence": "low",
+        "preferred": true
       }
     ]
   },
@@ -32531,7 +32546,12 @@
     },
     "canaryUrl": "https://t.17track.net/",
     "linkRules": [],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^ZL[A-Z]{2}\\d{9}$",
+        "confidence": "low"
+      }
+    ]
   },
   "zajil": {
     "displayName": "Zajil Express",

package/data/detection-golden.json

@@ -50473,6 +50473,27 @@
       "heppner"
     ]
   },
+  {
+    "input": "6663900000001",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "foxpost",
+      "la-poste",
+      "correos-chile",
+      "delhivery",
+      "yunda",
+      "korea-post"
+    ],
+    "preferred": [
+      "foxpost"
+    ],
+    "asked": [
+      "foxpost",
+      "la-poste",
+      "delhivery"
+    ]
+  },
   {
     "input": "6679804342",
     "carrier": "unknown",
@@ -78103,6 +78124,17 @@
       "posti"
     ]
   },
+  {
+    "input": "JJH30AAAAAPL00000001",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "magyar-posta"
+    ],
+    "preferred": [
+      "magyar-posta"
+    ]
+  },
   {
     "input": "JJITA8UW1A2B345678",
     "carrier": "poste-italiane",
@@ -87140,6 +87172,17 @@
       "chronopost"
     ]
   },
+  {
+    "input": "RL15050014358643",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "magyar-posta"
+    ],
+    "preferred": [
+      "magyar-posta"
+    ]
+  },
   {
     "input": "RL330279383MD",
     "carrier": "intl-post",
@@ -94754,6 +94797,14 @@
       "tnt-it"
     ]
   },
+  {
+    "input": "ZLXX000000017",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "z-leading"
+    ]
+  },
   {
     "input": "ZND170922989053",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -11556,6 +11556,10 @@ var Ze = {
 		detectionRules: [{
 			pattern: "^CLFOX\\d{15}$",
 			confidence: "high"
+		}, {
+			pattern: "^66639\\d{5,15}$",
+			confidence: "low",
+			preferred: !0
 		}]
 	},
 	"franch-express": {
@@ -15788,17 +15792,30 @@ var Ze = {
 			pathPattern: "^/nyomkovetes/nyitooldal/?$",
 			params: ["searchvalue"]
 		}],
-		detectionRules: [{
-			pattern: "^[A-Z]{2}\\d{9}HU$",
-			confidence: "low",
-			checksum: "s10",
-			preferred: !0
-		}, {
-			pattern: "^P[A-Z][0-9A-Z]{3}\\d{8}$",
-			confidence: "low",
-			checksum: "magyar-posta",
-			preferred: !0
-		}]
+		detectionRules: [
+			{
+				pattern: "^[A-Z]{2}\\d{9}HU$",
+				confidence: "low",
+				checksum: "s10",
+				preferred: !0
+			},
+			{
+				pattern: "^P[A-Z][0-9A-Z]{3}\\d{8}$",
+				confidence: "low",
+				checksum: "magyar-posta",
+				preferred: !0
+			},
+			{
+				pattern: "^RL\\d{14}$",
+				confidence: "low",
+				preferred: !0
+			},
+			{
+				pattern: "^JJH[A-Z0-9]{17}$",
+				confidence: "low",
+				preferred: !0
+			}
+		]
 	},
 	mailamericas: {
 		displayName: "MailAmericas",
@@ -24568,7 +24585,10 @@ var Ze = {
 		},
 		canaryUrl: "https://t.17track.net/",
 		linkRules: [],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^ZL[A-Z]{2}\\d{9}$",
+			confidence: "low"
+		}]
 	},
 	zajil: {
 		displayName: "Zajil Express",
@@ -25446,7 +25466,7 @@ var Ze = {
 	followmont: [],
 	"forward-air": [],
 	"forza-delivery": ["forza-delivery-1"],
-	foxpost: ["foxpost-1"],
+	foxpost: ["foxpost-1", "foxpost-home-delivery"],
 	"franch-express": [],
 	fukuyama: [],
 	gaash: [],
@@ -25608,7 +25628,12 @@ var Ze = {
 	"m-one": ["m-one-s10"],
 	"madhur-courier": [],
 	"maersk-ecommerce": ["maersk-ecommerce-1"],
-	"magyar-posta": ["magyar-posta-s10", "magyar-posta-domestic"],
+	"magyar-posta": [
+		"magyar-posta-s10",
+		"magyar-posta-domestic",
+		"magyar-posta-letter",
+		"magyar-posta-europe-standard"
+	],
 	mailamericas: [
 		"mailamericas-ml",
 		"mailamericas-mmxqp",
@@ -25939,7 +25964,7 @@ var Ze = {
 	"yurtici-kargo": [],
 	ywe: ["ywe-1"],
 	yypost: ["yypost-1"],
-	"z-leading": [],
+	"z-leading": ["z-leading-1"],
 	zajil: [],
 	zeleris: ["zeleris-1"],
 	zheldor: [],
@@ -31286,6 +31311,7 @@ var Rl = /* @__PURE__ */ new Map([
 	["DE", "dhl"],
 	["DK", "postnord"],
 	["DZ", "algerie-poste"],
+	["EE", "omniva"],
 	["EG", "egypt-post"],
 	["ES", "correos-spain"],
 	["FI", "posti"],

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

@@ -6,13 +6,13 @@ import { type FedExApiCredentials } from './api.js';
 export declare function normalizeFedExTrackingNumber(raw: string): string;
 export declare function fedexTrackingUrl(trackingNumber: string): string;
 /** The structured answer of the tracking page's own API call. */
-export declare function parseFedExTrackingResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare function parseFedExTrackingResponse(payload: unknown, trackingNumber: string, readAt?: number): CarrierResult;
 /**
  * The official Track API's answer (`POST /track/v1/trackingnumbers`). It reads
  * the scans, the latest status, the delivery dates and the hold location; the
  * recipient, shipper, signatory, package and service blocks are never read.
  */
-export declare function parseFedExApiResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare function parseFedExApiResponse(payload: unknown, trackingNumber: string, readAt?: number): CarrierResult;
 /**
  * The page the browser rendered, read only to tell a bot challenge from an
  * inconclusive load. The page renders its "can't find that tracking number"

package/dist/carriers/fedex/adapter.js

@@ -1,4 +1,5 @@
 import { load } from 'cheerio';
+import { DateTime } from 'luxon';
 import { recognizeFromBrowserLookup } from '../../core/adapter/index.js';
 import { fillPartialAnswer } from '../../core/result/partial.js';
 import { fedexBarcodeTrackingNumber, fedexGroundEconomyUspsNumber } from '../../core/detection/fedex.js';
@@ -6,7 +7,7 @@ import { uspsPackageIdentifier } from '../../core/detection/usps.js';
 import { ChallengeError, InputRequiredError, InvalidInputError, RateLimitedError, SchemaError, TransportError, UpstreamHttpError, } from '../../core/errors/index.js';
 import { runSteps } from '../../core/runner/index.js';
 import { NOOP_RECORDER } from '../../core/telemetry/index.js';
-import { calendarDay, explicitOffsetTime } from '../../core/time/index.js';
+import { calendarDay, canadaProvinceTimeZone, countryTimeZone, explicitOffsetTime, firstOccurrence, usStateTimeZone, } from '../../core/time/index.js';
 import { clean, cleanScalar, TRAWL_TRANSPORT_ALLOWANCE_MS } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { FedExApiClient, fedexApiCredentials } from './api.js';
@@ -85,6 +86,55 @@ function scanClock(scan) {
         ? calendarDay(Number(day[1]), Number(day[2]), Number(day[3])) : null;
     return local ? { local_time: local } : {};
 }
+// US states and Canadian provinces with places on more than one clock, and the
+// countries whose islands keep another clock than the mainland zone they are given.
+const SEVERAL_CLOCKS = new Set(['AK', 'FL', 'ID', 'IN', 'KS', 'KY', 'MI', 'ND', 'NE', 'NV', 'OR', 'SD', 'TN', 'TX',
+    'BC', 'NL', 'NU', 'ON', 'QC', 'ES', 'PT']);
+/** The zone of a place that keeps one clock: its country's, or its US state's or Canadian province's. */
+function placeZone(country, region) {
+    if (country === 'US')
+        return SEVERAL_CLOCKS.has(region) ? null : usStateTimeZone(region);
+    if (country === 'CA')
+        return SEVERAL_CLOCKS.has(region) ? null : canadaProvinceTimeZone(region);
+    return SEVERAL_CLOCKS.has(country) ? null : countryTimeZone(country);
+}
+/** The page names a US or Canadian scan's state ("MEMPHIS, TN") and any other scan's country ("BOLOGNA IT"). */
+function pageZone(location) {
+    const [, comma, code] = /(,?) ([A-Z]{2})$/.exec(location) ?? [];
+    if (!code)
+        return null;
+    if (comma && usStateTimeZone(code))
+        return placeZone('US', code);
+    if (comma && canadaProvinceTimeZone(code))
+        return placeZone('CA', code);
+    return placeZone(code, '');
+}
+function apiZone(value) {
+    if (!isRecord(value))
+        return null;
+    return placeZone(cleanScalar(value.countryCode).toUpperCase(), cleanScalar(value.stateOrProvinceCode).toUpperCase());
+}
+/**
+ * FedEx labels a scan it records after a clock change with the offset its
+ * place has kept since, even when the scan came before: a hub's departure the
+ * evening before October's change came as +01:00 among scans it had recorded
+ * in time as +02:00. A label that is the place's offset at `readAt` but not at
+ * the scan's wall clock is put back on the place's clock. A wall clock the
+ * place repeats or skips keeps its label.
+ */
+function placeClock(clock, zone, readAt) {
+    const shown = clock.time && zone ? DateTime.fromISO(clock.time, { setZone: true }) : null;
+    if (!zone || !shown?.isValid || DateTime.fromMillis(readAt, { zone }).offset !== shown.offset)
+        return clock;
+    const { year, month, day, hour, minute, second } = shown;
+    const own = firstOccurrence(DateTime.fromObject({ year, month, day, hour, minute, second }, { zone }));
+    if (!own.isValid || own.hour !== hour || own.minute !== minute)
+        return clock;
+    if (own.getPossibleOffsets().some((possible) => possible.offset === shown.offset))
+        return clock;
+    const time = own.toISO({ suppressMilliseconds: true });
+    return time ? { ...clock, time } : clock;
+}
 /**
  * Newest first. A scan with a time sorts by its instant, since each carries
  * its own offset, and one without a clock comes last. A scan dated by its day
@@ -259,7 +309,7 @@ function shipmentResult(shipment, number) {
     };
 }
 /** The structured answer of the tracking page's own API call. */
-export function parseFedExTrackingResponse(payload, trackingNumber) {
+export function parseFedExTrackingResponse(payload, trackingNumber, readAt = Date.now()) {
     const number = normalizeFedExTrackingNumber(trackingNumber);
     if (!isRecord(payload) || !isRecord(payload.output)) {
         throw new SchemaError('FedEx', 'FedEx returned an invalid tracking response');
@@ -303,7 +353,7 @@ export function parseFedExTrackingResponse(payload, trackingNumber) {
             description: scanDescription(clean(raw.status), clean(raw.scanDetails)),
             wording: `${clean(raw.status)} ${clean(raw.scanDetails)}`,
             code: cleanScalar(raw.statusCD).toLocaleUpperCase('en-US'),
-            clock: scanClock(raw),
+            clock: placeClock(scanClock(raw), pageZone(clean(raw.scanLocation)), readAt),
             location: clean(raw.scanLocation),
         })),
         statusText: keyStatus,
@@ -329,7 +379,7 @@ function apiDate(result, ...types) {
  * the scans, the latest status, the delivery dates and the hold location; the
  * recipient, shipper, signatory, package and service blocks are never read.
  */
-export function parseFedExApiResponse(payload, trackingNumber) {
+export function parseFedExApiResponse(payload, trackingNumber, readAt = Date.now()) {
     const number = normalizeFedExTrackingNumber(trackingNumber);
     const complete = isRecord(payload) && isRecord(payload.output) && Array.isArray(payload.output.completeTrackResults)
         ? payload.output.completeTrackResults.filter(isRecord) : null;
@@ -369,7 +419,7 @@ export function parseFedExApiResponse(payload, trackingNumber) {
             description: scanDescription(clean(raw.eventDescription), clean(raw.exceptionDescription)),
             wording: `${clean(raw.eventDescription)} ${clean(raw.exceptionDescription)}`,
             code: cleanScalar(raw.eventType).toLocaleUpperCase('en-US'),
-            clock: apiClock(raw.date),
+            clock: placeClock(apiClock(raw.date), apiZone(raw.scanLocation), readAt),
             location: apiPlace(raw.scanLocation),
         })),
         statusText,

package/dist/carriers/fedex/identity.js

@@ -1,7 +1,11 @@
 // The official API and the tracking page's own reply can word or place one
 // scan differently. A scan read from one takes over the row the other stored
-// at its instant when both read it as the same step.
+// at its instant when both read it as the same step. FedEx labels a scan it
+// records after a clock change with the offset its place took then, which an
+// earlier release stored, so a scan read on its place's own clock takes over
+// the row that shows its wall clock under the other offset.
 export const sameInstantIdentityPolicy = {
     sourceCarrierId: 'fedex', storedSources: ['fedex'], requireProviderCode: false,
     matches: (incoming, stored) => incoming.stage === stored.stage,
+    matchWallClock: true,
 };

package/dist/carriers/foxpost/carrier.json

@@ -80,6 +80,12 @@
       "id": "foxpost-1",
       "pattern": "^CLFOX\\d{15}$",
       "confidence": "high"
+    },
+    {
+      "id": "foxpost-home-delivery",
+      "pattern": "^66639\\d{5,15}$",
+      "confidence": "low",
+      "preferred": true
     }
   ]
 }

package/dist/carriers/foxpost/numbers.json

@@ -228,6 +228,26 @@
         "confidence": "high"
       },
       "note": "Looked up on Foxpost's own tracker, as an archived address shows; the capture was not opened."
+    },
+    {
+      "number": "6663900000001",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-10-25",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "foxpost",
+          "la-poste",
+          "correos-chile",
+          "delhivery",
+          "yunda",
+          "korea-post"
+        ]
+      },
+      "note": "Made-up number with the prefix Foxpost's tracking page and help give its home deliveries. No source gives their length; Foxpost's API caps a parcel's barcode at twenty characters."
     }
   ]
 }

package/dist/carriers/foxpost/parser.d.ts

@@ -1,6 +1,6 @@
 import type { CarrierResult } from '../../core/result/index.js';
 export declare const PROVIDER = "Foxpost";
-/** A CLFOX parcel ID, a Z number or a ten-digit number starting 66, as Foxpost's tracker takes them. */
+/** A CLFOX parcel ID, a Z number, a ten-digit number starting 66 or a home delivery's 66639 number, as Foxpost's tracker takes them. */
 export declare function normalizeFoxpostNumber(raw: string): string;
 /**
  * The tracker's reply for one parcel: its scans and the locker it waits at.

package/dist/carriers/foxpost/parser.js

@@ -9,9 +9,10 @@ import { firstOccurrence } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { foxpostScanStage } from './status.js';
 export const PROVIDER = 'Foxpost';
-// A Foxpost parcel ID, a Packeta number the tracker also answers for, and the
-// ten-digit IDs starting 66 it issues as well.
-const NUMBER = /^(?:CLFOX\d{15}|Z\d{10}|66\d{8})$/;
+// A Foxpost parcel ID, a Packeta number the tracker also answers for, the
+// ten-digit IDs starting 66 it issues as well, and its home deliveries' numbers
+// starting 66639, of up to the twenty characters its API allows a barcode.
+const NUMBER = /^(?:CLFOX\d{15}|Z\d{10}|66\d{8}|66639\d{5,15})$/;
 // The page's answer for a number it does not know.
 const ABSENT = /^A megadott csomag azonosító nem található a rendszerünkben\b/;
 const CLOCK = /^(\d{4})\.(\d{2})\.(\d{2}) (\d{2}):(\d{2})$/;
@@ -20,11 +21,11 @@ const POINT_PAGE = /^\/~\/[A-Za-z0-9_-]{1,40}$/;
 const ZONE = 'Europe/Budapest';
 const MAX_ROWS = 200;
 const MAX_EVENTS = 100;
-/** A CLFOX parcel ID, a Z number or a ten-digit number starting 66, as Foxpost's tracker takes them. */
+/** A CLFOX parcel ID, a Z number, a ten-digit number starting 66 or a home delivery's 66639 number, as Foxpost's tracker takes them. */
 export function normalizeFoxpostNumber(raw) {
     const number = normalizeTrackingNumber(raw);
     if (!NUMBER.test(number)) {
-        throw new InvalidInputError(PROVIDER, 'Foxpost tracks CLFOX parcel IDs, Z numbers and ten-digit numbers starting 66');
+        throw new InvalidInputError(PROVIDER, 'Foxpost tracks CLFOX parcel IDs, Z numbers, ten-digit numbers starting 66 and home deliveries\' numbers starting 66639');
     }
     return number;
 }

package/dist/carriers/hermes-de/adapter.js

@@ -72,27 +72,30 @@ const DEPOT_PLACES = [
 ];
 const COUNTRY_PLACES = [
     /\barrived in the destination country (.+?)(?: and is prepared\b|\.?$)/i,
-    /\bprepared for further shipping \(([^()]+)\)/i,
+    /\bfor further shipping \(([^()]+)\)/i,
 ];
 // The town after the postcode closing a ParcelShop's address, before the
 // collection deadline the ready-for-pickup wording appends.
 const SHOP_TOWN = /,\s*\d{5}\s+([^\d,]+?)(?:\s+max\.\s.*|\s+abgegeben)?\.?\s*$/;
 /**
  * Where a row's wording puts the parcel. Hermes's own depots and ParcelShops
- * are in Germany; a country abroad is named alone.
+ * are in Germany. A partner's scan (`INTERNATIONAL_…`) names the country after
+ * its depot, "prepared in EXEMPLEVILLE for further shipping (France)",
+ * or the country alone.
  */
 function wordedPlace(text, code) {
     const place = (pattern) => clean(pattern.exec(text)?.[1], 120);
+    const country = COUNTRY_PLACES.map(place).find(Boolean) ?? '';
+    const partner = code.startsWith('INTERNATIONAL_');
     for (const pattern of DEPOT_PLACES) {
         const depot = place(pattern);
+        if (depot && partner)
+            return country ? `${depot}, ${country}` : depot;
         if (depot)
             return `${depot}, Germany`;
     }
-    for (const pattern of COUNTRY_PLACES) {
-        const country = place(pattern);
-        if (country)
-            return country;
-    }
+    if (country)
+        return country;
     const town = code.startsWith('PARCELSHOP_') ? place(SHOP_TOWN) : '';
     return town ? `${town}, Germany` : null;
 }

package/dist/carriers/magyar-posta/carrier.json

@@ -106,6 +106,18 @@
       "confidence": "low",
       "preferred": true,
       "checksum": "magyar-posta"
+    },
+    {
+      "id": "magyar-posta-letter",
+      "pattern": "^RL\\d{14}$",
+      "confidence": "low",
+      "preferred": true
+    },
+    {
+      "id": "magyar-posta-europe-standard",
+      "pattern": "^JJH[A-Z0-9]{17}$",
+      "confidence": "low",
+      "preferred": true
     }
   ]
 }

package/dist/carriers/magyar-posta/numbers.json

@@ -269,6 +269,50 @@
         ]
       },
       "note": "Magyar Posta's tracking API guide lists it in an example reply; it is not described as a live shipment."
+    },
+    {
+      "number": "RL15050014358643",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20220727091109/https://www.posta.hu/nyomkovetes/nyitooldal?searchvalue=RL15050014358643",
+        "date": "2022-07-27",
+        "dateKind": "capture",
+        "access": "full_page"
+      },
+      "context": {
+        "service": "domestic registered letter",
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "magyar-posta"
+        ]
+      },
+      "note": "Looked up on Magyar Posta's tracker, as an archived address shows; the capture holds only the search form. The tracker names the RL series as its domestic letters, sixteen characters long."
+    },
+    {
+      "number": "JJH30AAAAAPL00000001",
+      "role": "shipment",
+      "evidence": "official_documentation_example",
+      "source": {
+        "url": "https://www.posta.hu/ikrnyomkovproxy/",
+        "access": "full_page"
+      },
+      "context": {
+        "service": "MPL Europe Standard",
+        "assessment": "candidate"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "magyar-posta"
+        ]
+      },
+      "note": "Magyar Posta's tracker gives it as the example of an MPL Europe Standard (DHL) parcel number; it is not described as a live shipment."
     }
   ]
 }

package/dist/carriers/z-leading/carrier.json

@@ -30,5 +30,11 @@
     "unavailable": []
   },
   "links": [],
-  "detection": []
+  "detection": [
+    {
+      "id": "z-leading-1",
+      "pattern": "^ZL[A-Z]{2}\\d{9}$",
+      "confidence": "low"
+    }
+  ]
 }

package/dist/carriers/z-leading/numbers.json

@@ -1,5 +1,21 @@
 {
   "carrier": "z-leading",
   "gap": "No public page shows a whole Z-Leading tracking number.",
-  "records": []
+  "records": [
+    {
+      "number": "ZLXX000000017",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "donated_real",
+      "shapeConfirmed": "2026-10-25",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "z-leading"
+        ]
+      },
+      "note": "Made-up number in the shape of a parcel the app tracked, which two universal providers filed under Zhongling."
+    }
+  ]
 }

package/dist/core/adapter/track.js

@@ -4,6 +4,7 @@ import { normalizeCarrierResult } from '../result/index.js';
 import { runSteps } from '../runner/index.js';
 import { NOOP_RECORDER } from '../telemetry/index.js';
 import { dateLocalClocks } from '../../places/clocks.js';
+import { restoreLostLetters } from '../../places/index.js';
 /**
  * One carrier lookup, leaving provider selection and scheduling to the consumer.
  * The adapter gets the normalized number, as from `createTracker()`: a number
@@ -25,7 +26,7 @@ export async function trackCarrier(carrier, typed, options) {
                 : await runSteps({ carrier, budgetMs: options.budgetMs ?? 120_000, signal: options.signal,
                     recorder: options.recorder ?? NOOP_RECORDER }, [{ id: registered.steps[0] ?? 'direct',
                         run: ({ signal, remainingMs }) => registered.track(input, ...(options.signal || options.budgetMs !== undefined ? [{ signal, budgetMs: context.budgetMs === undefined ? undefined : Math.min(context.budgetMs, remainingMs) }] : [])) }]);
-            return dateLocalClocks(carrier, normalizeCarrierResult(result));
+            return dateLocalClocks(carrier, restoreLostLetters(normalizeCarrierResult(result)));
         }
         catch (error) {
             // A caller's cancellation is the caller's reason, not a carrier failure.

package/dist/core/catalog/hints.js

@@ -59,13 +59,14 @@ const CATALOG_NAMES = new Set([
 // from France, and dates its own scans on Taiwan time. Pošta Srbije, Pošta
 // Slovenije, Cyprus Post, MaltaPost, POST Luxembourg and Magyar Posta follow mail
 // from abroad under the sending post's number; Magyar Posta's lookup opens a
-// browser. The host also checks adapter availability and required inputs before
+// browser. Omniva's tracker carries the scans in Estonia of mail from abroad,
+// on UTC clocks. The host also checks adapter availability and required inputs before
 // making a request.
 const NATIONAL_POSTS = new Map([
     ['AM', 'haypost'], ['AR', 'correo-argentino'], ['AT', 'austrian-post'], ['AU', 'australia-post'], ['BD', 'bangladesh-post'],
     ['BE', 'bpost'], ['BG', 'bulgarian-posts'], ['BR', 'correios-br'], ['BY', 'belpost'], ['CA', 'canada-post'],
     ['CH', 'swiss-post'], ['CU', 'correos-cuba'], ['CY', 'cyprus-post'], ['CZ', 'ceska-posta'], ['DE', 'dhl'], ['DK', 'postnord'], ['DZ', 'algerie-poste'],
-    ['EG', 'egypt-post'], ['ES', 'correos-spain'], ['FI', 'posti'], ['FO', 'posta-faroe'], ['FR', 'la-poste'],
+    ['EE', 'omniva'], ['EG', 'egypt-post'], ['ES', 'correos-spain'], ['FI', 'posti'], ['FO', 'posta-faroe'], ['FR', 'la-poste'],
     ['GB', 'royal-mail'], ['GR', 'elta'], ['HR', 'hrvatska-posta'], ['HU', 'magyar-posta'], ['IE', 'an-post'], ['IS', 'posturinn'],
     ['IT', 'poste-italiane'], ['JO', 'jordan-post'], ['JP', 'japan-post'], ['KE', 'posta-kenya'], ['LT', 'lietuvos-pastas'],
     ['LU', 'post-luxembourg'], ['LV', 'latvijas-pasts'], ['MA', 'barid-al-maghrib'], ['MK', 'posta-north-macedonia'], ['MT', 'maltapost'],

package/dist/data/catalog.json

@@ -14902,6 +14902,11 @@
             {
                 "pattern": "^CLFOX\\d{15}$",
                 "confidence": "high"
+            },
+            {
+                "pattern": "^66639\\d{5,15}$",
+                "confidence": "low",
+                "preferred": true
             }
         ]
     },
@@ -20625,6 +20630,16 @@
                 "confidence": "low",
                 "checksum": "magyar-posta",
                 "preferred": true
+            },
+            {
+                "pattern": "^RL\\d{14}$",
+                "confidence": "low",
+                "preferred": true
+            },
+            {
+                "pattern": "^JJH[A-Z0-9]{17}$",
+                "confidence": "low",
+                "preferred": true
             }
         ]
     },
@@ -32531,7 +32546,12 @@
         },
         "canaryUrl": "https://t.17track.net/",
         "linkRules": [],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^ZL[A-Z]{2}\\d{9}$",
+                "confidence": "low"
+            }
+        ]
     },
     "zajil": {
         "displayName": "Zajil Express",

package/dist/generated/catalog.d.ts

@@ -9664,6 +9664,10 @@ export declare const CARRIER_CATALOG: {
         readonly detectionRules: readonly [{
             readonly pattern: "^CLFOX\\d{15}$";
             readonly confidence: "high";
+        }, {
+            readonly pattern: "^66639\\d{5,15}$";
+            readonly confidence: "low";
+            readonly preferred: true;
         }];
     };
     readonly "franch-express": {
@@ -13288,6 +13292,14 @@ export declare const CARRIER_CATALOG: {
             readonly confidence: "low";
             readonly checksum: "magyar-posta";
             readonly preferred: true;
+        }, {
+            readonly pattern: "^RL\\d{14}$";
+            readonly confidence: "low";
+            readonly preferred: true;
+        }, {
+            readonly pattern: "^JJH[A-Z0-9]{17}$";
+            readonly confidence: "low";
+            readonly preferred: true;
         }];
     };
     readonly mailamericas: {
@@ -20790,7 +20802,10 @@ export declare const CARRIER_CATALOG: {
         };
         readonly canaryUrl: "https://t.17track.net/";
         readonly linkRules: readonly [];
-        readonly detectionRules: readonly [];
+        readonly detectionRules: readonly [{
+            readonly pattern: "^ZL[A-Z]{2}\\d{9}$";
+            readonly confidence: "low";
+        }];
     };
     readonly zajil: {
         readonly displayName: "Zajil Express";

package/dist/generated/catalog.js

@@ -14903,6 +14903,11 @@ export const CARRIER_CATALOG = {
             {
                 "pattern": "^CLFOX\\d{15}$",
                 "confidence": "high"
+            },
+            {
+                "pattern": "^66639\\d{5,15}$",
+                "confidence": "low",
+                "preferred": true
             }
         ]
     },
@@ -20626,6 +20631,16 @@ export const CARRIER_CATALOG = {
                 "confidence": "low",
                 "checksum": "magyar-posta",
                 "preferred": true
+            },
+            {
+                "pattern": "^RL\\d{14}$",
+                "confidence": "low",
+                "preferred": true
+            },
+            {
+                "pattern": "^JJH[A-Z0-9]{17}$",
+                "confidence": "low",
+                "preferred": true
             }
         ]
     },
@@ -32532,7 +32547,12 @@ export const CARRIER_CATALOG = {
         },
         "canaryUrl": "https://t.17track.net/",
         "linkRules": [],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^ZL[A-Z]{2}\\d{9}$",
+                "confidence": "low"
+            }
+        ]
     },
     "zajil": {
         "displayName": "Zajil Express",
@@ -33919,7 +33939,7 @@ export const DETECTION_RULE_IDS = {
     "followmont": [],
     "forward-air": [],
     "forza-delivery": ["forza-delivery-1"],
-    "foxpost": ["foxpost-1"],
+    "foxpost": ["foxpost-1", "foxpost-home-delivery"],
     "franch-express": [],
     "fukuyama": [],
     "gaash": [],
@@ -34068,7 +34088,7 @@ export const DETECTION_RULE_IDS = {
     "m-one": ["m-one-s10"],
     "madhur-courier": [],
     "maersk-ecommerce": ["maersk-ecommerce-1"],
-    "magyar-posta": ["magyar-posta-s10", "magyar-posta-domestic"],
+    "magyar-posta": ["magyar-posta-s10", "magyar-posta-domestic", "magyar-posta-letter", "magyar-posta-europe-standard"],
     "mailamericas": ["mailamericas-ml", "mailamericas-mmxqp", "mailamericas-domc", "mailamericas-s10"],
     "mailplus-au": ["mailplus-au-1"],
     "mainfreight": ["mainfreight-1"],
@@ -34369,7 +34389,7 @@ export const DETECTION_RULE_IDS = {
     "yurtici-kargo": [],
     "ywe": ["ywe-1"],
     "yypost": ["yypost-1"],
-    "z-leading": [],
+    "z-leading": ["z-leading-1"],
     "zajil": [],
     "zeleris": ["zeleris-1"],
     "zheldor": [],

package/dist/places/index.d.ts

@@ -1,3 +1,4 @@
+import type { CarrierResult } from '../core/result/index.js';
 export { carrierHomeZone, dateLocalClocks, type ZoneBasis } from './clocks.js';
 /** Where a scan happened, as precisely as its free-text location allows. */
 export interface EventPlace {
@@ -47,6 +48,11 @@ export declare function placeTimeZone(place: EventPlace): string | null;
  * place we can be confident about. A wrong dot is worse than no dot.
  */
 export declare function locatePlace(location: string | null | undefined, hints?: PlaceHints): EventPlace | null;
+/**
+ * The result with the letters its scans' "Town, Country" places lost restored
+ * (`restoredTownName`), in the place and wherever the wording names it.
+ */
+export declare function restoreLostLetters(result: CarrierResult): CarrierResult;
 /**
  * Places for a parcel's scans, oldest first. A scan that names no country
  * borrows one from the scans around it, then the destination and the

package/dist/places/index.js

@@ -1,7 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { brotliDecompressSync } from 'node:zlib';
 import { CARRIER_DEFINITIONS } from '../core/catalog/definitions.js';
-import { timeZoneCountry } from '../core/time/index.js';
+import { countryCode, timeZoneCountry } from '../core/time/index.js';
 import { ambiguousAddressCodes, militaryPostOffice, trackingPlace } from './trackingLocation.js';
 import facilityList from './facilities.json' with { type: 'json' };
 import hubList from './hubs.json' with { type: 'json' };
@@ -511,6 +511,70 @@ export function locatePlace(location, hints = {}) {
     // Alone, a name two towns of a country share alike says neither.
     return found && !found.twins ? found.place : null;
 }
+const LOST = '\uFFFD';
+/**
+ * A town's name with the letters a carrier lost on the way, each a replacement
+ * character, filled from the one spelling of a town of `country` that fits:
+ * "SAINT-\uFFFDTIENNE" is Saint-Étienne's. A letter inside a word takes the
+ * case of the letters beside it, one starting a word the town's own. Null when
+ * no letter is lost or no single spelling fits.
+ */
+function restoredTownName(town, country) {
+    if (!town.includes(LOST))
+        return null;
+    const chars = [...town];
+    const source = chars.map((char) => char === LOST ? '(\\p{L})' : /[\s-]/u.test(char) ? '[\\s-]'
+        : char.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('');
+    const pattern = new RegExp(`^${source}$`, 'iu');
+    const data = gazetteer();
+    const fills = new Set();
+    for (const index of countryPlaces(country)) {
+        const match = pattern.exec(data.names[index]);
+        if (match)
+            fills.add(match.slice(1).join(' '));
+    }
+    if (new Set([...fills].map((fill) => fill.toLowerCase())).size !== 1)
+        return null;
+    const letters = [...fills][0].split(' ');
+    const letter = (char) => char !== undefined && char !== LOST && /\p{L}/u.test(char);
+    return chars.map((char, at) => {
+        if (char !== LOST)
+            return char;
+        const filled = letters.shift();
+        if (!letter(chars[at - 1]))
+            return filled;
+        const beside = [chars[at - 1], chars[at + 1]].filter(letter);
+        return beside.every((other) => other === other.toUpperCase()) ? filled.toUpperCase() : filled.toLowerCase();
+    }).join('');
+}
+/**
+ * The result with the letters its scans' "Town, Country" places lost restored
+ * (`restoredTownName`), in the place and wherever the wording names it.
+ */
+export function restoreLostLetters(result) {
+    if (!result.events?.some((event) => event.location?.includes(LOST)))
+        return result;
+    const restored = new Map();
+    for (const event of result.events) {
+        const [, town, country] = /^(.+), ([^,]+)$/.exec(event.location ?? '') ?? [];
+        const code = country ? countryCode(country) : null;
+        const name = town && code && !restored.has(town) ? restoredTownName(town, code) : null;
+        if (name)
+            restored.set(town, name);
+    }
+    if (!restored.size)
+        return result;
+    const spell = (text) => [...restored].reduce((spelled, [lost, name]) => spelled.replaceAll(lost, name), text);
+    return {
+        ...result,
+        ...(result.last_status_text ? { last_status_text: spell(result.last_status_text) } : {}),
+        events: result.events.map((event) => ({
+            ...event,
+            ...(event.location ? { location: spell(event.location) } : {}),
+            ...(event.description ? { description: spell(event.description) } : {}),
+        })),
+    };
+}
 /** `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();

package/dist/server/openapi.json

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

package/package.json

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