universal-parcel-scraper 0.25.1-main.364 → 0.25.3-main.366

package/data/detection-golden.json

@@ -2612,6 +2612,27 @@
       "dpd-fr"
     ]
   },
+  {
+    "input": "2522622410",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "dhl-express",
+      "dhl",
+      "mondial-relay",
+      "relais-colis",
+      "tipsa",
+      "estafeta"
+    ],
+    "preferred": [
+      "dhl-express"
+    ],
+    "asked": [
+      "dhl-express",
+      "relais-colis",
+      "tipsa"
+    ]
+  },
   {
     "input": "25631818",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -7666,7 +7666,9 @@ var co = {
 	IN: "aberdeen|akron|albany|albion|alexandria|anderson|andrews|angola|arcadia|argos|attica|auburn|aurora|austin|avilla|avon|bargersville|basslake|batesville|battleground|bedford|beechgrove|berne|bicknell|bloomfield|bloomington|bluffton|boonville|bourbon|brazil|bremen|bright|bristol|broadripple|brooklyn|brookston|brookville|brownsburg|brownstown|burnsharbor|butler|cambridgecity|cannelton|carmel|cayuga|cedarlake|centerville|chandler|charlestown|chesterfield|chesterton|churubusco|cicero|clarksville|clermont|clinton|cloverdale|columbiacity|columbus|connersville|converse|cordrysweetwaterlakes|corydon|countrysquirelakes|covington|crawfordsville|crothersville|crownpoint|culver|cumberland|dale|daleville|danville|darmstadt|dayton|decatur|delphi|demotte|dillsboro|dunkirk|dunlap|dyer|eastchicago|eaton|edgewood|edinburgh|elkhart|ellettsville|elwood|english|evansville|fairfieldheights|fairmount|fairviewpark|farmersburg|farmland|ferdinand|fishers|fishlake|flora|fortville|fowler|frankfort|franklin|frankton|fremont|frenchlick|ftbranch|ftwayne|galena|galveston|garrett|gary|gascity|geneva|georgetown|goodland|goshen|grabill|granger|greencastle|greendale|greenfield|greensburg|greentown|greenwood|griffith|grissomairforcebase|gulivoirepark|hagerstown|hamilton|hammond|hanover|harlan|hartfordcity|haubstadt|hebron|henryville|heritagelake|hiddenvalley|highland|hobart|hope|hudsonlake|huntertown|huntingburg|huntington|indianapolis|indianheights|ingalls|jasonville|jasper|jeffersonville|jonesboro|kendallville|kentland|kingsfordheights|knightstown|knox|kokomo|koontzlake|kouts|lafayette|lagrange|lakedalecarlia|lakesofthefourseasons|lakestation|lapel|laporte|lawrence|lawrenceburg|lebanon|leocedarville|liberty|ligonier|linton|logansport|longbeach|loogootee|lowell|lynn|madison|marion|markle|martinsville|mccordsville|melodyhill|meridianhills|merrillville|michigancity|middlebury|middletown|milan|milford|mishawaka|mitchell|monon|monroeville|monrovia|monticello|montpelier|mooresville|morocco|morristown|mtvernon|mulberry|muncie|munster|nappanee|nashville|newalbany|newburgh|newcarlisle|newcastle|newchicago|newhaven|newpalestine|newparis|newpekin|newport|newwhiteland|noblesville|northjudson|northliberty|northmadison|northmanchester|northterrehaute|northvernon|northwebster|notredame|oaklandcity|oakpark|odon|ogdendunes|oolitic|orleans|osceola|osgood|ossian|otis|otterbein|owensville|oxford|paoli|parkercity|pendleton|peru|petersburg|pierceton|pittsboro|plainfield|plymouth|portage|porter|portland|poseyville|princeslakes|princeton|redkey|remington|rensselaer|richmond|risingsun|roanoke|rochester|rockport|rockville|romecity|roselawn|rossville|rushville|russiaville|santaclaus|schererville|scottsburg|seelyville|sellersburg|seymour|shadeland|shelburn|shelbyville|sheridan|shoals|shorewoodforest|simontonlake|smithvillesanders|southbend|southhaven|southport|southwhitley|speedway|spencer|stjohn|stpaul|sullivan|sunman|sweetser|syracuse|tellcity|terrehaute|thorntown|tipton|topeka|trafalgar|trailcreek|trilakes|unioncity|upland|valparaiso|veedersburg|versailles|vevay|vincennes|wabash|wakarusa|walkerton|walton|wanatah|warren|warrenpark|warsaw|washington|waterloo|westfield|westlafayette|westport|westterrehaute|westville|whiteland|whitestown|whiting|williamsport|winamac|winchester|winfield|winonalake|wolcottville|woodburn|worthington|yorktown|zionsville",
 	MT: "absarokee|anaconda|baker|belgrade|bigfork|bigsky|bigtimber|billings|bonnerwestriverside|boulder|bozeman|broadus|browning|butte|chester|chinook|choteau|circle|clancy|clinton|colstrip|columbiafalls|columbus|conrad|crowagency|cutbank|deerlodge|dillon|easthelena|eastmissoula|ekalaka|eureka|evergreen|forsyth|fourcorners|frenchtown|ftbelknapagency|ftbenton|glasgow|glendive|greatfalls|hamilton|hardin|harlowton|havre|helena|helenavalleynortheast|helenavalleynorthwest|helenavalleysoutheast|helenavalleywestcentral|helenawestside|hysham|jordan|kalispell|lakeside|lamedeer|laurel|lewistown|libby|lincoln|livingston|lockwood|lolo|malmstromairforcebase|malta|manhattan|milescity|missoula|montanacity|northbrowning|orchardhomes|pablo|philipsburg|plains|plentywood|polson|redlodge|ronan|roundup|ryegate|scobey|seeleylake|shelby|sidney|somers|southbrowning|stanford|stevensville|sunprairie|superior|terry|thompsonfalls|threeforks|townsend|virginiacity|warmsprings|westglendive|westyellowstone|whitefish|whitehall|whitesulphursprings|wibaux|winnett|wolfpoint",
 	NL: "airportheights|baieverte|ballyhaly|bannerman|baybulls|bayroberts|baystgeorgesouth|bellsturn|bishopsfalls|bonavista|botwood|burgeo|burin|carbonear|centrevillewarehamtrinity|channelportauxbasques|churchillpark|clarenville|clarenvilleshoalharbour|clarkesbeach|clovellytrails|conceptionbaysouth|cornerbrook|cowanheights|deerlake|donovans|downtownstjohns|eastmeadows|evergreenvillage|fairviewacres|flatrock|fogoisland|fortune|ftwilliam|gambo|gander|georgestown|glendale|glenridgecrescent|glovertown|goulds|grandbank|grandfallswindsor|happyvalleygoosebay|harbourbreton|harbourgrace|harbourmainchapelscovelakeview|holyrood|humberarmsouth|irishtownsummerside|karwoodestates|kenmountterrace|kilbride|kingwilliamestates|kippens|labradorcity|lewisporte|littlecanada|logybaymiddlecoveoutercove|marystown|masseydrive|mtcashel|mtpearl|mundypond|nain|newwesvalley|paradise|pasadena|pearlgate|placentia|pleasantville|portugalcovestphillips|pouchcove|quidividi|rabbittown|sesamepark|sheaheights|sheshatshiu|signalhill|southlands|spaniardsbay|springdale|sprucemeadows|stalbans|stanthony|stephenville|stephenvillecrossing|stgeorges|stjohns|stlawrence|torbay|trinitybaynorth|twillingate|upperislandcove|victoria|virginiapark|wabana|wabush|waterfordvalley|whitbourne|wishingwellpark|witlessbay",
-	SK: "adelaidechurchill|albertpark|alritchie|arborcreek|arcolaeast|argylepark|aspenridge|assiniboia|avalon|balgonie|battleford|biggar|blairmore|blairmoreurbancentre|boothill|brevoortpark|briarwood|brighton|buenavista|buffalonarrows|canora|carlyle|caswellhill|cathedral|centralbusinessdistrict|centresquare|citypark|collegepark|collegeparkeast|confederation|confederationpark|confederationurbancentre|coreneighbourhoods|coronationpark|creighton|dalmeny|davidson|delisle|dewdneyeast|dieppewesterra|downtown|dundonald|eastview|erindale|esterhazy|estevan|evergreen|exhibition|fairhaven|foamlake|forestgrove|ftquappelle|gladmerpark|gravelbourg|greystoneheights|grosvenorpark|hamptonvillage|harbourlanding|haultain|heritage|hillsdale|holidaypark|holliston|holmwood|hudsonbay|hudsonbaypark|humboldt|indianhead|kamsack|kensington|kerrobert|kindersley|kinggeorge|lakeridge|lakeview|lakewood|lakewoodurbancentre|langenburg|langham|lanigan|laronge|lawson|lawsonheights|lawsonheightsurbancentre|lumsden|macklin|maplecreek|martensville|masseyplace|mcnab|meadowgreen|meadowlake|melfort|melville|montgomeryplace|moosejaw|moosomin|mtroyal|nipawin|normanview|normanviewwest|northbattleford|northcentral|northeastregina|northpark|nutana|nutanapark|nutanasector|nutanaurbancentre|outlook|oxbow|pacificheights|parkridge|pelicannarrows|pilotbutte|pleasanthill|prairieview|preeceville|princealbert|queenelizabeth|regentpark|regina|reginabeach|riverheights|riversdale|rosemontmtroyal|rosetown|rosewood|rosthern|saskatoon|shaunavon|shellbrook|sherwoodmccarthy|silverspring|silverwoodheights|stonebridge|sutherland|swiftcurrent|tisdale|twinlakes|unity|universityheights|universityheightsurbancentre|uofslandssouthmanagementarea|uplands|varsityview|wadena|waldheim|walshacreslakeridgegardenridge|warman|watrous|westmount|westview|weyburn|whitecity|whitmorepark|wildwood|wilkie|willowgrove|wynyard|yorkton"
+	SK: "adelaidechurchill|albertpark|alritchie|arborcreek|arcolaeast|argylepark|aspenridge|assiniboia|avalon|balgonie|battleford|biggar|blairmore|blairmoreurbancentre|boothill|brevoortpark|briarwood|brighton|buenavista|buffalonarrows|canora|carlyle|caswellhill|cathedral|centralbusinessdistrict|centresquare|citypark|collegepark|collegeparkeast|confederation|confederationpark|confederationurbancentre|coreneighbourhoods|coronationpark|creighton|dalmeny|davidson|delisle|dewdneyeast|dieppewesterra|downtown|dundonald|eastview|erindale|esterhazy|estevan|evergreen|exhibition|fairhaven|foamlake|forestgrove|ftquappelle|gladmerpark|gravelbourg|greystoneheights|grosvenorpark|hamptonvillage|harbourlanding|haultain|heritage|hillsdale|holidaypark|holliston|holmwood|hudsonbay|hudsonbaypark|humboldt|indianhead|kamsack|kensington|kerrobert|kindersley|kinggeorge|lakeridge|lakeview|lakewood|lakewoodurbancentre|langenburg|langham|lanigan|laronge|lawson|lawsonheights|lawsonheightsurbancentre|lumsden|macklin|maplecreek|martensville|masseyplace|mcnab|meadowgreen|meadowlake|melfort|melville|montgomeryplace|moosejaw|moosomin|mtroyal|nipawin|normanview|normanviewwest|northbattleford|northcentral|northeastregina|northpark|nutana|nutanapark|nutanasector|nutanaurbancentre|outlook|oxbow|pacificheights|parkridge|pelicannarrows|pilotbutte|pleasanthill|prairieview|preeceville|princealbert|queenelizabeth|regentpark|regina|reginabeach|riverheights|riversdale|rosemontmtroyal|rosetown|rosewood|rosthern|saskatoon|shaunavon|shellbrook|sherwoodmccarthy|silverspring|silverwoodheights|stonebridge|sutherland|swiftcurrent|tisdale|twinlakes|unity|universityheights|universityheightsurbancentre|uofslandssouthmanagementarea|uplands|varsityview|wadena|waldheim|walshacreslakeridgegardenridge|warman|watrous|westmount|westview|weyburn|whitecity|whitmorepark|wildwood|wilkie|willowgrove|wynyard|yorkton",
+	"ES-CN": "adeje|agaete|aguimes|agulo|alajero|antigua|arafo|arona|arrecife|artenara|arucas|barlovento|brenaalta|brenabaja|buenavistadelnorte|candelaria|carrizal|centro|corralejo|costacalma|costateguise|crucedearinaga|elcotillo|elhierro|elpaso|fasnia|firgas|frontera|fuencalientedelapalma|fuerteventura|galdar|garachico|garafia|granadilladeabona|grancanaria|guia|guiadeisora|guimar|haria|hermigua|icoddelosvinos|ingenio|lagomera|lagraciosa|laguancha|lalaguna|lamatanzadeacentejo|lanzarote|laoliva|laorotava|lapalma|laspalmas|laspalmasdegrancanaria|lasrosas|lavictoriadeacentejo|lomodearico|losgigantes|losllanosdearidane|losrealejos|lossilos|macher|maspalomas|mazo|mogan|nazaret|pajara|playablanca|playadelasamericas|playadelingles|playadesanjuan|puertodelacruz|puertodelcarmen|puertodelrosario|puertorico|puntademujeres|puntagorda|puntallana|realejoalto|sanbartolome|sanbartolomedetirajana|sanjuandelarambla|sanmigueldeabona|sannicolas|sansebastiandelagomera|santabrigida|santacruzdelapalma|santacruzdetenerife|santalucia|santaursula|santiagodelteide|sauzal|tacoronte|tamaraceite|tanque|tazacorte|tegueste|teguise|tejeda|telde|tenerife|teror|tias|tijarafe|tinajo|tuineje|vallehermosa|valleseco|valsequillodegrancanaria|vecindario|vegadesanmateo|vilaflor|yaiza",
+	"PT-20": "aguadepau|angradoheroismo|angustias|arrifes|biscoitos|cabouco|caisdopico|corvo|fajadebaixo|fenaisdaajuda|fenaisdaluz|feteira|flores|fontebastardo|furnas|graciosa|horta|lajes|lajesdasflores|mosteiros|nordeste|pico|pontadelgada|pontagarca|portojudeu|portomartins|povoacao|praiadavitoria|rabodepeixe|relva|ribeiragrande|ribeiraseca|ribeirinha|rostodecao|santabarbara|santacruzdagraciosa|santacruzdasflores|santamaria|saomateus|saomiguel|saoroquedopico|saosebastiao|terceira|velas|vilafrancadocampo"
 };
 //#endregion
 //#region core/transport/text.ts

package/dist/carriers/dhl-express/clock.d.ts

@@ -1,6 +1,11 @@
 /**
- * The zone of a DHL Express facility, from its "CITY - COUNTRY" location, when
- * the country keeps one civil time. Spain and Portugal are left out: a country
- * cannot tell their islands' clocks from the mainland's.
+ * The zone of a DHL Express facility, from its location: "CITY - COUNTRY", and
+ * in the USA and Canada "CITY - REGION - COUNTRY" or "CITY, ST - COUNTRY". Null
+ * when the location does not settle one: a country with several clocks and no
+ * region DHL names, or a country it writes in a form this does not know.
+ *
+ * A US state or Canadian province with several clocks takes its majority zone.
+ * Spain and Portugal take their mainland's, except for a town or island of the
+ * Canary Islands or the Azores.
  */
 export declare function facilityZone(location: string): string | null;

package/dist/carriers/dhl-express/clock.js

@@ -1,14 +1,58 @@
-import { countryTimeZone } from '../../core/time/index.js';
+import { canadaProvinceTimeZone, countryTimeZone, regionHasTown, usStateTimeZone } from '../../core/time/index.js';
+// DHL names a US state in full ("Ohio", "New York") or with its code ("VIRGINIA,VA").
+const US_STATES = {
+    ALABAMA: 'AL', ALASKA: 'AK', ARIZONA: 'AZ', ARKANSAS: 'AR', CALIFORNIA: 'CA', COLORADO: 'CO', CONNECTICUT: 'CT',
+    DELAWARE: 'DE', 'DISTRICT OF COLUMBIA': 'DC', FLORIDA: 'FL', GEORGIA: 'GA', HAWAII: 'HI', IDAHO: 'ID', ILLINOIS: 'IL',
+    INDIANA: 'IN', IOWA: 'IA', KANSAS: 'KS', KENTUCKY: 'KY', LOUISIANA: 'LA', MAINE: 'ME', MARYLAND: 'MD',
+    MASSACHUSETTS: 'MA', MICHIGAN: 'MI', MINNESOTA: 'MN', MISSISSIPPI: 'MS', MISSOURI: 'MO', MONTANA: 'MT', NEBRASKA: 'NE',
+    NEVADA: 'NV', 'NEW HAMPSHIRE': 'NH', 'NEW JERSEY': 'NJ', 'NEW MEXICO': 'NM', 'NEW YORK': 'NY', 'NORTH CAROLINA': 'NC',
+    'NORTH DAKOTA': 'ND', OHIO: 'OH', OKLAHOMA: 'OK', OREGON: 'OR', PENNSYLVANIA: 'PA', 'RHODE ISLAND': 'RI',
+    'SOUTH CAROLINA': 'SC', 'SOUTH DAKOTA': 'SD', TENNESSEE: 'TN', TEXAS: 'TX', UTAH: 'UT', VERMONT: 'VT', VIRGINIA: 'VA',
+    WASHINGTON: 'WA', 'WEST VIRGINIA': 'WV', WISCONSIN: 'WI', WYOMING: 'WY',
+};
+// A Canadian province comes as its name or its code: "ONTARIO" and "ON" on scans of one parcel.
+const CANADA_PROVINCES = {
+    ALBERTA: 'AB', 'BRITISH COLUMBIA': 'BC', MANITOBA: 'MB', 'NEW BRUNSWICK': 'NB', 'NEWFOUNDLAND AND LABRADOR': 'NL',
+    'NOVA SCOTIA': 'NS', 'NORTHWEST TERRITORIES': 'NT', NUNAVUT: 'NU', ONTARIO: 'ON', 'PRINCE EDWARD ISLAND': 'PE',
+    QUEBEC: 'QC', SASKATCHEWAN: 'SK', YUKON: 'YT',
+};
+// DHL's own names for countries the English ones do not cover: the forms on its
+// scans, and those of its country list for the countries whose zone is known.
+const COUNTRIES = {
+    UK: 'GB', "PEOPLE'S REPUBLIC OF CHINA": 'CN', 'CHINA, PEOPLES REPUBLIC': 'CN', 'CZECH REPUBLIC': 'CZ',
+    'IRELAND, REPUBLIC OF': 'IE', 'KOREA, REPUBLIC OF (SOUTH K.)': 'KR', TURKEY: 'TR',
+};
+// Island groups an hour behind their mainland, which DHL files under the country.
+const ISLANDS = {
+    'Europe/Madrid': { group: 'ES-CN', zone: 'Atlantic/Canary' },
+    'Europe/Lisbon': { group: 'PT-20', zone: 'Atlantic/Azores' },
+};
+function regionCode(region, names) {
+    const parts = region.toUpperCase().split(',').map((part) => part.trim());
+    return parts.find((part) => /^[A-Z]{2}$/.test(part)) ?? parts.map((part) => names[part]).find(Boolean) ?? '';
+}
 /**
- * The zone of a DHL Express facility, from its "CITY - COUNTRY" location, when
- * the country keeps one civil time. Spain and Portugal are left out: a country
- * cannot tell their islands' clocks from the mainland's.
+ * The zone of a DHL Express facility, from its location: "CITY - COUNTRY", and
+ * in the USA and Canada "CITY - REGION - COUNTRY" or "CITY, ST - COUNTRY". Null
+ * when the location does not settle one: a country with several clocks and no
+ * region DHL names, or a country it writes in a form this does not know.
+ *
+ * A US state or Canadian province with several clocks takes its majority zone.
+ * Spain and Portugal take their mainland's, except for a town or island of the
+ * Canary Islands or the Azores.
  */
 export function facilityZone(location) {
-    const separator = location.lastIndexOf(' - ');
-    if (separator < 0)
-        return null;
-    // DHL writes some countries article last: "NETHERLANDS, THE".
-    const zone = countryTimeZone(location.slice(separator + 3).replace(/, THE$/i, ''));
-    return zone && !['Europe/Madrid', 'Europe/Lisbon'].includes(zone) ? zone : null;
+    const parts = location.split(' - ').map((part) => part.trim());
+    const country = parts.length > 1 ? parts.at(-1).toUpperCase() : '';
+    // The region is a part of its own, or the code that ends the city's.
+    const region = parts.length > 2 ? parts.at(-2) : /, ([A-Z]{2})$/i.exec(parts[0])?.[1] ?? '';
+    if (country === 'USA')
+        return usStateTimeZone(regionCode(region, US_STATES));
+    if (country === 'CANADA')
+        return canadaProvinceTimeZone(regionCode(region, CANADA_PROVINCES));
+    // DHL writes the article first or last: "THE PEOPLE'S REPUBLIC OF CHINA", "NETHERLANDS, THE".
+    const name = country.replace(/^THE /, '').replace(/, THE$/, '');
+    const zone = countryTimeZone(COUNTRIES[name] ?? name.replaceAll(',', ''));
+    const islands = zone ? ISLANDS[zone] : undefined;
+    return islands && regionHasTown(islands.group, parts[0]) ? islands.zone : zone;
 }

package/dist/carriers/dhl-express/numbers.json

@@ -1,6 +1,28 @@
 {
   "carrier": "dhl-express",
   "records": [
+    {
+      "number": "2522622410",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/iFoxz17/sc-delay-prediction/blob/b9e2f99fcdc157b4fb5ff3b0903e79f75f6b32cb/code/m4estro/LambdaTS/Carrier/sample.json",
+        "date": "2025-08-30"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl-express",
+          "dhl",
+          "mondial-relay",
+          "relais-colis",
+          "tipsa",
+          "estafeta"
+        ]
+      },
+      "note": "A provider's reply for a DHL Express waybill, published as sample data with its scans. DHL has since issued the waybill to another shipment."
+    },
     {
       "number": "3408372365",
       "role": "shipment",

package/dist/core/time/index.d.ts

@@ -72,8 +72,11 @@ export declare function townKey(name: string): string;
 /**
  * Whether a town of this name lies in the US state or Canadian province whose
  * code also names a single-clock country: Chicago is in Illinois, not Israel,
- * and Koeln is not in Delaware. Only DE, IL, IN, MT, NL and SK have town lists
- * (generated from GeoNames); false for any other code.
+ * and Koeln is not in Delaware. Also whether it lies in an island group that
+ * keeps another clock than its country, by ISO 3166-2 code: the Canary Islands
+ * (`ES-CN`) and the Azores (`PT-20`), without the names their mainland also
+ * has. Only DE, IL, IN, MT, NL, SK and these two have town lists (generated
+ * from GeoNames); false for any other code.
  */
 export declare function regionHasTown(code: string, town: string): boolean;
 /** Epoch milliseconds (numbers or numeric strings); zero and negatives are rejected. */

package/dist/core/time/index.js

@@ -212,8 +212,11 @@ const REGION_TOWN_SETS = new Map(Object.entries(REGION_TOWNS).map(([code, towns]
 /**
  * Whether a town of this name lies in the US state or Canadian province whose
  * code also names a single-clock country: Chicago is in Illinois, not Israel,
- * and Koeln is not in Delaware. Only DE, IL, IN, MT, NL and SK have town lists
- * (generated from GeoNames); false for any other code.
+ * and Koeln is not in Delaware. Also whether it lies in an island group that
+ * keeps another clock than its country, by ISO 3166-2 code: the Canary Islands
+ * (`ES-CN`) and the Azores (`PT-20`), without the names their mainland also
+ * has. Only DE, IL, IN, MT, NL, SK and these two have town lists (generated
+ * from GeoNames); false for any other code.
  */
 export function regionHasTown(code, town) {
     return REGION_TOWN_SETS.get(code.trim().toUpperCase())?.has(townKey(town)) ?? false;

package/dist/generated/regionTowns.d.ts

@@ -1,2 +1,5 @@
-/** Town keys of the US states and Canadian provinces whose code also names a single-clock country. */
+/**
+ * Town keys of the US states and Canadian provinces whose code also names a single-clock country,
+ * and of the island groups that keep another clock than their country.
+ */
 export declare const REGION_TOWNS: Readonly<Record<string, string>>;

package/dist/generated/regionTowns.js

@@ -1,6 +1,9 @@
 /* This file is generated by scripts/generate-region-towns.mjs. Do not edit. */
 // Towns from GeoNames (https://www.geonames.org), CC BY 4.0, through places.
-/** Town keys of the US states and Canadian provinces whose code also names a single-clock country. */
+/**
+ * Town keys of the US states and Canadian provinces whose code also names a single-clock country,
+ * and of the island groups that keep another clock than their country.
+ */
 export const REGION_TOWNS = {
     DE: 'bear|bellefonte|bethanybeach|blades|bridgeville|brookside|camden|cheswold|claymont|clayton|delawarecity|delmar|dover|doverbasehousing|edgemoor|elsmere|felton|georgetown|glasgow|greenville|greenwood|harrington|highlandacres|hockessin|kentacres|laurel|lewes|longneck|middletown|milford|millsboro|milton|newark|newcastle|newport|northstar|oceanview|pikecreek|pikecreekvalley|rehobothbeach|risingsunlebanon|riverview|rodneyvillage|seaford|selbyville|smyrna|townsend|wilmington|wilmingtonmanor|woodsideeast|wyoming',
     IL: 'abingdon|addison|albanypark|albers|albion|aledo|algonquin|alorton|alsip|altamont|alton|amboy|andalusia|anna|antioch|arcola|arlingtonheights|arthur|ashburn|ashland|assumption|astoria|athens|atlanta|atwood|auburn|auburngresham|aurora|aviston|avondale|bannockburn|barrington|barringtonhills|barry|bartlett|bartonville|batavia|beachpark|beardstown|beckemeyer|beecher|belleville|bellevue|bellwood|belmontcragin|belvidere|bement|benld|bensenville|benton|berkeley|berwyn|bethalto|bethany|bigrock|bloomingdale|bloomington|blueisland|bluemound|bolingbrook|boulderhill|bourbonnais|bradley|braidwood|breese|bridgeport|bridgeview|brighton|brightonpark|broadview|brookfield|buffalogrove|bullvalley|bunkerhill|burbank|burnham|burrridge|bushnell|byron|cahokia|cairo|calumetcity|calumetpark|cambria|cambridge|camppoint|canton|capron|carboncliff|carbondale|carlinville|carlyle|carmi|carolstream|carpentersville|carriermills|carrollton|carterville|carthage|cary|casey|caseyville|catlin|centralcity|centralia|centreville|cerrogordo|champaign|channahon|channellake|charleston|chatham|chatsworth|chebanse|chenoa|cherryvalley|chester|chicago|chicagoheights|chicagolawn|chicagoloop|chicagoridge|chillicothe|chrisman|christopher|cicero|clarendonhills|clifton|clinton|coalcity|coalvalley|cobden|colchester|colfax|collinsville|colona|columbia|cortland|countryclubhills|countryside|crainville|cresthill|crestwood|crete|crevecoeur|crystallake|crystallawns|cuba|danvers|danville|darien|davisjunction|decatur|deerfield|deerpark|dekalb|delavan|depue|desoto|desplaines|diamond|divernon|dixmoor|dixon|dolton|douglas|downersgrove|dunlap|dupo|duquoin|durand|dwight|earlville|eastalton|eastdubuque|eastdundee|eastgarfieldpark|easthazelcrest|eastmoline|eastpeoria|eaststlouis|edgewater|edinburg|edwardsville|effingham|elburn|eldorado|elgin|elizabethtown|elkgrovevillage|elmhurst|elmwood|elmwoodpark|elpaso|elwood|energy|englewood|erie|eureka|evanston|evergreenpark|fairbury|fairfield|fairmont|fairmontcity|fairviewheights|farmercity|farmington|fisher|flanagan|flora|flossmoor|fordheights|forestlake|forestpark|forrest|forreston|forsyth|foxlake|foxlakehills|foxrivergrove|frankfort|frankfortsquare|franklinpark|freeburg|freeport|fulton|gagepark|gageslake|galena|galesburg|galva|gardner|geneseo|geneva|genoa|georgetown|germantown|germantownhills|gibsoncity|gifford|gilberts|gillespie|gilman|girard|glasford|glencarbon|glencoe|glendaleheights|glenellyn|glenview|glenwood|godfrey|golconda|goodingsgrove|goreville|grandboulevard|grandview|grandwoodpark|granitecity|grantpark|granville|grayslake|grayville|greatergrandcrossing|greenfield|greenoaks|greenrock|greenup|greenville|gridley|griggsville|gurnee|hainesville|hamilton|hampshire|hampton|hannacity|hanoverpark|hardin|harrisburg|harristown|hartford|harvard|harvey|harwoodheights|havana|hawthornwoods|hazelcrest|hebron|hennepin|henry|heritagelake|herrin|herscher|heyworth|hickoryhills|highland|highlandpark|highwood|hillcrest|hillsboro|hillside|hinckley|hinsdale|hodgkins|hoffmanestates|holidayshores|homer|homerglen|hometown|homewood|hoopeston|hudson|huntley|hydepark|ina|indianheadpark|ingallspark|inverness|irvingpark|islandlake|itasca|jacksonville|jerome|jerseyville|johnsburg|johnstoncity|joliet|jonesboro|justice|kankakee|kenilworth|kenwood|kewanee|kildeer|kincaid|kingston|kirkland|knollwood|knoxville|lacon|ladd|lagrange|lagrangepark|laharpe|lakebarrington|lakebluff|lakecamelot|lakecatherine|lakeforest|lakeholiday|lakeinthehills|lakemoor|lakeofthewoods|lakesummerset|lakevilla|lakewood|lakewoodshores|lakezurich|lanark|lansing|lasalle|lawrenceville|lebanon|lelandgrove|lemont|lena|leroy|lewistown|lexington|libertyville|lilylake|limestone|lincoln|lincolnpark|lincolnshire|lincolnsquare|lincolnwood|lindenhurst|lisle|litchfield|lockport|logansquare|lombard|longcreek|longgrove|longlake|louisville|lovespark|lovington|lowerwestside|lynwood|lyons|machesneypark|mackinaw|macomb|macon|madison|mahomet|malta|manhattan|manito|manteno|maplepark|marengo|marion|marissa|markham|maroa|marquetteheights|marseilles|marshall|martinsville|maryville|mascoutah|masoncity|matteson|mattoon|maywood|mccullomlake|mchenry|mckinleypark|mcleansboro|medinah|melrosepark|mendota|meredosia|merrionettepark|metamora|metropolis|midlothian|milan|milford|millstadt|minier|minonk|minooka|mitchell|mokena|moline|momence|monee|monmouth|montgomery|monticello|morganpark|morris|morrison|morrisonville|morton|mortongrove|moundcity|moweaqua|mtcarmel|mtcarroll|mtgreenwood|mtmorris|mtolive|mtprospect|mtpulaski|mtsterling|mtvernon|mtzion|mundelein|murphysboro|naperville|nashville|nauvoo|nearnorthside|nearsouthside|neoga|newark|newathens|newbaden|newberlin|newcity|newlenox|newton|niles|nokomis|normal|norridge|norriscity|northaurora|northbarrington|northbrook|northcenter|northchicago|northfield|northlake|northlawndale|northpekin|northpeoria|northriverside|oakbrook|oakbrookterrace|oakforest|oaklawn|oakpark|oakwood|oakwoodhills|oblong|odin|ofallon|oglesby|okawville|olney|olympiafields|onarga|oquawka|oregon|orion|orlandhills|orlandpark|oswego|ottawa|palatine|palestine|palosheights|paloshills|palospark|pana|paris|parkcity|parkforest|parkridge|parkwaygardenhomes|pawnee|paxton|payson|pecatonica|pekin|peoria|peoriaheights|peotone|peru|petersburg|philo|phoenix|pinckneyville|pingreegrove|pistakeehighlands|pittsfield|plainfield|plano|polo|pontiac|pontoonbeach|poplargrove|portagepark|portbarrington|portbyron|posen|prairiegrove|prestbury|prestonheights|princeton|princeville|prophetstown|prospectheights|quincy|ramsey|rantoul|redbud|richmond|richtonpark|riverdale|riverforest|rivergrove|riverside|riverton|riverwoods|roanoke|robbins|robinson|rochelle|rochester|rockdale|rockfalls|rockford|rockisland|rockton|rogerspark|rollingmeadows|rome|romeoville|roodhouse|roscoe|roselle|rosemont|rosewoodheights|rosiclare|rossville|roundlake|roundlakebeach|roundlakeheights|roundlakepark|roxana|royalton|rushville|salem|sandoval|sandwich|saukvillage|savanna|savoy|schaumburg|schillerpark|scottairforcebase|seneca|sesser|shawneetown|shelbyville|sheldon|sheridan|sherman|shiloh|shorewood|sidney|silvis|skokie|sleepyhollow|smithton|somonauk|southbarrington|southbeloit|southchicago|southchicagoheights|southelgin|southernview|southholland|southjacksonville|southlawndale|southpekin|southroxana|southshore|sparta|springfield|springgrove|springvalley|stanne|staunton|stcharles|steeleville|steger|stelmo|sterling|stickney|stillmanvalley|stjacob|stjoseph|stockton|stonepark|streamwood|streator|sugargrove|sullivan|summit|sumner|swansea|sycamore|taylorville|teutopolis|thegalenaterritory|thirdlake|thomasboro|thornton|tilton|tinleypark|toledo|tolono|toluca|toulon|towerlake|tremont|trenton|troy|tuscola|twingrove|ukrainianvillage|universitypark|upperalton|uptown|urbana|valmeyer|vandalia|venetianvillage|venice|vernonhills|vienna|villageofcamptonhills|villagrove|villapark|virden|virginia|volo|wadsworth|walnut|wamac|warren|warrensburg|warrenville|warsaw|wasco|washburn|washington|washingtonpark|waterloo|waterman|watseka|wauconda|waukegan|waverly|wayne|waynecity|westchester|westchicago|westdundee|westelsdon|westenglewood|westernsprings|westfrankfort|westgarfieldpark|westlawn|westmont|westpeoria|westridge|westtown|westville|wheaton|wheeling|whitehall|williamsville|willowbrook|willowsprings|wilmette|wilmington|winchester|windsor|winfield|winnebago|winnetka|winthropharbor|wonderlake|wooddale|woodlawn|woodridge|woodriver|woodstock|worden|worth|wyoming|yorkville|zeigler|zion',
@@ -8,4 +11,6 @@ export const REGION_TOWNS = {
     MT: 'absarokee|anaconda|baker|belgrade|bigfork|bigsky|bigtimber|billings|bonnerwestriverside|boulder|bozeman|broadus|browning|butte|chester|chinook|choteau|circle|clancy|clinton|colstrip|columbiafalls|columbus|conrad|crowagency|cutbank|deerlodge|dillon|easthelena|eastmissoula|ekalaka|eureka|evergreen|forsyth|fourcorners|frenchtown|ftbelknapagency|ftbenton|glasgow|glendive|greatfalls|hamilton|hardin|harlowton|havre|helena|helenavalleynortheast|helenavalleynorthwest|helenavalleysoutheast|helenavalleywestcentral|helenawestside|hysham|jordan|kalispell|lakeside|lamedeer|laurel|lewistown|libby|lincoln|livingston|lockwood|lolo|malmstromairforcebase|malta|manhattan|milescity|missoula|montanacity|northbrowning|orchardhomes|pablo|philipsburg|plains|plentywood|polson|redlodge|ronan|roundup|ryegate|scobey|seeleylake|shelby|sidney|somers|southbrowning|stanford|stevensville|sunprairie|superior|terry|thompsonfalls|threeforks|townsend|virginiacity|warmsprings|westglendive|westyellowstone|whitefish|whitehall|whitesulphursprings|wibaux|winnett|wolfpoint',
     NL: 'airportheights|baieverte|ballyhaly|bannerman|baybulls|bayroberts|baystgeorgesouth|bellsturn|bishopsfalls|bonavista|botwood|burgeo|burin|carbonear|centrevillewarehamtrinity|channelportauxbasques|churchillpark|clarenville|clarenvilleshoalharbour|clarkesbeach|clovellytrails|conceptionbaysouth|cornerbrook|cowanheights|deerlake|donovans|downtownstjohns|eastmeadows|evergreenvillage|fairviewacres|flatrock|fogoisland|fortune|ftwilliam|gambo|gander|georgestown|glendale|glenridgecrescent|glovertown|goulds|grandbank|grandfallswindsor|happyvalleygoosebay|harbourbreton|harbourgrace|harbourmainchapelscovelakeview|holyrood|humberarmsouth|irishtownsummerside|karwoodestates|kenmountterrace|kilbride|kingwilliamestates|kippens|labradorcity|lewisporte|littlecanada|logybaymiddlecoveoutercove|marystown|masseydrive|mtcashel|mtpearl|mundypond|nain|newwesvalley|paradise|pasadena|pearlgate|placentia|pleasantville|portugalcovestphillips|pouchcove|quidividi|rabbittown|sesamepark|sheaheights|sheshatshiu|signalhill|southlands|spaniardsbay|springdale|sprucemeadows|stalbans|stanthony|stephenville|stephenvillecrossing|stgeorges|stjohns|stlawrence|torbay|trinitybaynorth|twillingate|upperislandcove|victoria|virginiapark|wabana|wabush|waterfordvalley|whitbourne|wishingwellpark|witlessbay',
     SK: 'adelaidechurchill|albertpark|alritchie|arborcreek|arcolaeast|argylepark|aspenridge|assiniboia|avalon|balgonie|battleford|biggar|blairmore|blairmoreurbancentre|boothill|brevoortpark|briarwood|brighton|buenavista|buffalonarrows|canora|carlyle|caswellhill|cathedral|centralbusinessdistrict|centresquare|citypark|collegepark|collegeparkeast|confederation|confederationpark|confederationurbancentre|coreneighbourhoods|coronationpark|creighton|dalmeny|davidson|delisle|dewdneyeast|dieppewesterra|downtown|dundonald|eastview|erindale|esterhazy|estevan|evergreen|exhibition|fairhaven|foamlake|forestgrove|ftquappelle|gladmerpark|gravelbourg|greystoneheights|grosvenorpark|hamptonvillage|harbourlanding|haultain|heritage|hillsdale|holidaypark|holliston|holmwood|hudsonbay|hudsonbaypark|humboldt|indianhead|kamsack|kensington|kerrobert|kindersley|kinggeorge|lakeridge|lakeview|lakewood|lakewoodurbancentre|langenburg|langham|lanigan|laronge|lawson|lawsonheights|lawsonheightsurbancentre|lumsden|macklin|maplecreek|martensville|masseyplace|mcnab|meadowgreen|meadowlake|melfort|melville|montgomeryplace|moosejaw|moosomin|mtroyal|nipawin|normanview|normanviewwest|northbattleford|northcentral|northeastregina|northpark|nutana|nutanapark|nutanasector|nutanaurbancentre|outlook|oxbow|pacificheights|parkridge|pelicannarrows|pilotbutte|pleasanthill|prairieview|preeceville|princealbert|queenelizabeth|regentpark|regina|reginabeach|riverheights|riversdale|rosemontmtroyal|rosetown|rosewood|rosthern|saskatoon|shaunavon|shellbrook|sherwoodmccarthy|silverspring|silverwoodheights|stonebridge|sutherland|swiftcurrent|tisdale|twinlakes|unity|universityheights|universityheightsurbancentre|uofslandssouthmanagementarea|uplands|varsityview|wadena|waldheim|walshacreslakeridgegardenridge|warman|watrous|westmount|westview|weyburn|whitecity|whitmorepark|wildwood|wilkie|willowgrove|wynyard|yorkton',
+    'ES-CN': 'adeje|agaete|aguimes|agulo|alajero|antigua|arafo|arona|arrecife|artenara|arucas|barlovento|brenaalta|brenabaja|buenavistadelnorte|candelaria|carrizal|centro|corralejo|costacalma|costateguise|crucedearinaga|elcotillo|elhierro|elpaso|fasnia|firgas|frontera|fuencalientedelapalma|fuerteventura|galdar|garachico|garafia|granadilladeabona|grancanaria|guia|guiadeisora|guimar|haria|hermigua|icoddelosvinos|ingenio|lagomera|lagraciosa|laguancha|lalaguna|lamatanzadeacentejo|lanzarote|laoliva|laorotava|lapalma|laspalmas|laspalmasdegrancanaria|lasrosas|lavictoriadeacentejo|lomodearico|losgigantes|losllanosdearidane|losrealejos|lossilos|macher|maspalomas|mazo|mogan|nazaret|pajara|playablanca|playadelasamericas|playadelingles|playadesanjuan|puertodelacruz|puertodelcarmen|puertodelrosario|puertorico|puntademujeres|puntagorda|puntallana|realejoalto|sanbartolome|sanbartolomedetirajana|sanjuandelarambla|sanmigueldeabona|sannicolas|sansebastiandelagomera|santabrigida|santacruzdelapalma|santacruzdetenerife|santalucia|santaursula|santiagodelteide|sauzal|tacoronte|tamaraceite|tanque|tazacorte|tegueste|teguise|tejeda|telde|tenerife|teror|tias|tijarafe|tinajo|tuineje|vallehermosa|valleseco|valsequillodegrancanaria|vecindario|vegadesanmateo|vilaflor|yaiza',
+    'PT-20': 'aguadepau|angradoheroismo|angustias|arrifes|biscoitos|cabouco|caisdopico|corvo|fajadebaixo|fenaisdaajuda|fenaisdaluz|feteira|flores|fontebastardo|furnas|graciosa|horta|lajes|lajesdasflores|mosteiros|nordeste|pico|pontadelgada|pontagarca|portojudeu|portomartins|povoacao|praiadavitoria|rabodepeixe|relva|ribeiragrande|ribeiraseca|ribeirinha|rostodecao|santabarbara|santacruzdagraciosa|santacruzdasflores|santamaria|saomateus|saomiguel|saoroquedopico|saosebastiao|terceira|velas|vilafrancadocampo',
 };

package/dist/providers/parcelsapp/adapter.js

@@ -10,7 +10,6 @@
 import { load } from 'cheerio';
 import { DateTime } from 'luxon';
 import timers from 'node:timers/promises';
-import { facilityZone } from '../../carriers/dhl-express/clock.js';
 import { carrierTimezone } from '../../core/catalog/index.js';
 import { brandTimeZones, carrierIdFromName, carrierNameCountryZone } from '../../core/catalog/hints.js';
 import { CarrierError, carrierErrorKind, ChallengeError, IndeterminateError, InputRequiredError, NoHistoryError, SchemaError, UpstreamHttpError, UpstreamNetworkError } from '../../core/errors/index.js';
@@ -18,6 +17,7 @@ import { runSteps } from '../../core/runner/index.js';
 import { canadaProvinceTimeZone, countryCode, countryTimeZone, mislabeledLocalTime, mislabeledWallTime, regionHasTown, sharedClockZone, timeZoneCountry, usStateTimeZone, } from '../../core/time/index.js';
 import { isRecord } from '../../core/types.js';
 import { capturedBodies, loadCapture } from '../shared/capture.js';
+import { facilityZone, LatestScan, relaysFacilityClock } from '../shared/facilityClock.js';
 import { universalCarrierHints } from '../shared/hints.js';
 import { event, isNotice, localEvent, numberOf, result } from '../shared/result.js';
 import { carrierScan, markReturnLeg } from '../shared/scans.js';
@@ -130,12 +130,9 @@ function scanZone(payload, state, fallback, number, inNorthAmerica = false) {
     if (zone !== 'UTC' && !(typeof name === 'string' && carrierNameCountryZone(name)))
         return zone;
     const location = typeof state.location === 'string' ? state.location.trim() : '';
-    // DHL Express dates are its facility's clock and its locations read "CITY -
-    // COUNTRY": its mobile API gives the same clocks scan for scan, and scans
-    // were relayed before the instant their label claims (checked 2026-10-06).
-    const facility = carrier === 'dhl-express' ? facilityZone(location) : null;
-    if (facility)
-        return facility;
+    // A facility's clock, whatever the label: no other step applies to it.
+    if (relaysFacilityClock(name))
+        return facilityZone(location);
     const place = location.split(',').at(-1);
     // A state or province the town confirms beats the country its code also
     // names ("Chicago, IL"); a merely possible one comes after ("Koeln, DE").
@@ -220,10 +217,14 @@ function parseHistory(payload, trackingNumber, timezone = null) {
         return wall && text ? `${wall}|${text}` : '';
     };
     const localClocks = new Map(entries.filter((entry) => entry.local).map((entry) => [copyKey(entry), entry.zone]).filter(([key]) => key));
+    const latest = new LatestScan(SOURCE);
     for (const entry of entries) {
         const { raw, name, scan } = entry;
         const zone = (localClocks.size && !entry.local ? localClocks.get(copyKey(entry)) : undefined) ?? entry.zone;
-        const parsed = localEvent((zone ? mislabeledLocalTime(raw.date, zone)?.iso : undefined) ?? raw.date, entry.wording);
+        const unplaced = !zone && relaysFacilityClock(name);
+        const parsed = localEvent((zone ? mislabeledLocalTime(raw.date, zone)?.iso : unplaced ? mislabeledWallTime(raw.date) : undefined) ?? raw.date, entry.wording);
+        if (parsed)
+            latest.see(mislabeledWallTime(raw.date) ?? '', unplaced);
         // Nor has an offset-less date that no zone resolves: a wall time, not an instant.
         if (parsed && !parsed.time) {
             undated++;
@@ -241,6 +242,7 @@ function parseHistory(payload, trackingNumber, timezone = null) {
             scans.push({ event: Object.assign(parsed, { stage: scan.stage, stage_source: 'carrier_map' }), scan });
     }
     markReturnLeg(scans);
+    latest.check();
     if (!events.length) {
         const fields = payload.states.flatMap((raw) => isRecord(raw) && Array.isArray(raw.require_fields) ? raw.require_fields : []);
         if (fields.some((field) => isRecord(field) && field.name === 'zipcode')) {
@@ -293,6 +295,7 @@ export function parseParcelsAppHtml(html, trackingNumber, timezone = null) {
     const carriers = [];
     const scans = [];
     let undated = 0;
+    const latest = new LatestScan(SOURCE);
     nodes.each((_, node) => {
         const row = $(node);
         if (row.find('input, select, form').length)
@@ -323,6 +326,13 @@ export function parseParcelsAppHtml(html, trackingNumber, timezone = null) {
         const state = { date: labeled.toISO(), ...(name ? { carrier: carriers.indexOf(name) } : {}) };
         const zone = scanZone({ carriers }, state, timezone, numberOf(trackingNumber));
         const scan = carrierScan(name ? carrierIdFromName(name) : undefined, description);
+        // The page prints no location, so no DHL Express scan has a facility to read its clock in.
+        const unplaced = !zone && relaysFacilityClock(name);
+        latest.see(mislabeledWallTime(state.date) ?? '', unplaced);
+        if (unplaced) {
+            undated++;
+            return;
+        }
         const parsed = event((zone ? mislabeledLocalTime(state.date, zone)?.iso : undefined) ?? state.date, scan?.wording ?? description);
         if (parsed)
             events.push(parsed);
@@ -330,6 +340,7 @@ export function parseParcelsAppHtml(html, trackingNumber, timezone = null) {
             scans.push({ event: Object.assign(parsed, { stage: scan.stage, stage_source: 'carrier_map' }), scan });
     });
     markReturnLeg(scans);
+    latest.check();
     return { ...result(events, SOURCE), ...(undated ? { undated_event_count: undated } : {}),
         ...universalCarrierHints(carriers.slice(0, 20), numberOf(trackingNumber)) };
 }

package/dist/providers/seventeentrack/adapter.d.ts

@@ -1,13 +1,3 @@
-/**
- * 17TRACK (t.17track.net), a universal aggregator with richer China Post history.
- *
- * Transport: the browser service loads the public tracking page and captures
- * the page's own `restapi` response; unsigned direct probes answer HTTP 200
- * with a rejection code instead of history (verified 2026-09-10). The parser
- * keeps only history whose shipment number equals the requested one, and turns
- * the provider's own rejection codes into typed errors so routing can tell a
- * verification wall from an outage.
- */
 import type { AdapterFactory } from '../../core/adapter/index.js';
 import { ChallengeError, NoHistoryError, TransportError } from '../../core/errors/index.js';
 import type { CarrierResult } from '../../core/result/index.js';

package/dist/providers/seventeentrack/adapter.js

@@ -1,8 +1,20 @@
+/**
+ * 17TRACK (t.17track.net), a universal aggregator with richer China Post history.
+ *
+ * Transport: the browser service loads the public tracking page and captures
+ * the page's own `restapi` response; unsigned direct probes answer HTTP 200
+ * with a rejection code instead of history (verified 2026-09-10). The parser
+ * keeps only history whose shipment number equals the requested one, and turns
+ * the provider's own rejection codes into typed errors so routing can tell a
+ * verification wall from an outage.
+ */
+import { DateTime } from 'luxon';
 import { ChallengeError, NoHistoryError, NotFoundError, SchemaError, TransportError } from '../../core/errors/index.js';
 import { runSteps } from '../../core/runner/index.js';
 import { isRecord } from '../../core/types.js';
 import { universalCarrierHints } from '../shared/hints.js';
 import { capturedBodies, captureFailure, loadCapture } from '../shared/capture.js';
+import { facilityZone, LatestScan, relaysFacilityClock } from '../shared/facilityClock.js';
 import { numberOf, result, text } from '../shared/result.js';
 import { seventeenTrackEvent } from './events.js';
 const SOURCE = '17TRACK';
@@ -57,6 +69,12 @@ function lookupError(code, providerMessage) {
         ? new SeventeenTrackVerificationError(code, providerMessage)
         : new SeventeenTrackLookupError('lookup_unavailable', code, providerMessage);
 }
+/** The offset-less clock of a scan whose offset 17TRACK added itself. */
+function facilityWall(raw) {
+    const clock = isRecord(raw.time_raw) && raw.time_raw.timezone === null ? raw.time_raw : null;
+    return clock && typeof clock.date === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(clock.date)
+        && typeof clock.time === 'string' && /^\d{2}:\d{2}:\d{2}$/.test(clock.time) ? `${clock.date}T${clock.time}` : null;
+}
 export function parse17TrackResponse(payload, trackingNumber) {
     const number = numberOf(trackingNumber);
     if (!isRecord(payload) || !isRecord(payload.meta) || !Number.isInteger(payload.meta.code)) {
@@ -91,6 +109,7 @@ export function parse17TrackResponse(payload, trackingNumber) {
     const events = [];
     let count = 0;
     let undated = 0;
+    const latest = new LatestScan(SOURCE);
     for (const provider of tracking.providers) {
         if (!isRecord(provider) || !Array.isArray(provider.events))
             throw new SchemaError(SOURCE, '17TRACK returned invalid provider history');
@@ -103,17 +122,29 @@ export function parse17TrackResponse(payload, trackingNumber) {
                 throw new SchemaError(SOURCE, '17TRACK returned invalid events');
             if (raw.time_utc == null && raw.time_iso == null)
                 undated++;
+            // A facility's clock, on which 17TRACK puts one offset for the whole parcel.
+            const wall = relaysFacilityClock(name) ? facilityWall(raw) : null;
+            const zone = wall ? facilityZone(text(raw.location)) : null;
+            const placed = wall && zone ? DateTime.fromISO(wall, { zone }) : null;
             let parsed;
             try {
-                parsed = seventeenTrackEvent(raw, operator);
+                parsed = seventeenTrackEvent(placed?.isValid ? { ...raw, time_utc: placed.toUTC().toISO() } : raw, operator);
             }
             catch (cause) {
                 throw new SchemaError(SOURCE, '17TRACK returned an invalid tracking event', { cause });
             }
-            if (parsed)
+            if (!parsed)
+                continue;
+            const unplaced = wall !== null && !placed?.isValid;
+            latest.see(wall ?? String(raw.time_iso ?? raw.time_utc).slice(0, 19), unplaced);
+            // With no zone for the facility it is a wall time, counted like a row without a date.
+            if (unplaced)
+                undated++;
+            else
                 events.push(parsed);
         }
     }
+    latest.check();
     if (count === 0 && isRecord(shipment.latest_status) && shipment.latest_status.status === 'NotFound') {
         throw new NotFoundError(SOURCE);
     }

package/dist/providers/shared/facilityClock.d.ts

@@ -0,0 +1,25 @@
+import { facilityZone } from '../../carriers/dhl-express/clock.js';
+import type { UniversalSource } from './result.js';
+/**
+ * DHL Express dates a scan with its facility's clock and no offset, and the
+ * providers relay that clock under a label of their own: UTC at ParcelsApp, one
+ * offset for the whole parcel at 17TRACK. Ship24 relays it with the facility's
+ * offset, and DHL's mobile API gives the same clocks scan for scan (checked
+ * 2026-10-06). So such a scan is read in its facility's zone, and with no zone
+ * for the facility it is a wall time that no label makes an instant.
+ */
+export declare function relaysFacilityClock(carrierName: unknown): boolean;
+export { facilityZone };
+/**
+ * The newest wall clock of a reply, and whether that scan was left without an
+ * instant. A reply whose latest scan has none cannot say where the parcel is,
+ * and an older scan must not stand in for it.
+ */
+export declare class LatestScan {
+    private readonly source;
+    private wall;
+    private unplaced;
+    constructor(source: UniversalSource);
+    see(wall: string, unplaced: boolean): void;
+    check(): void;
+}

package/dist/providers/shared/facilityClock.js

@@ -0,0 +1,36 @@
+import { facilityZone } from '../../carriers/dhl-express/clock.js';
+import { carrierIdFromName } from '../../core/catalog/hints.js';
+import { IndeterminateError } from '../../core/errors/index.js';
+/**
+ * DHL Express dates a scan with its facility's clock and no offset, and the
+ * providers relay that clock under a label of their own: UTC at ParcelsApp, one
+ * offset for the whole parcel at 17TRACK. Ship24 relays it with the facility's
+ * offset, and DHL's mobile API gives the same clocks scan for scan (checked
+ * 2026-10-06). So such a scan is read in its facility's zone, and with no zone
+ * for the facility it is a wall time that no label makes an instant.
+ */
+export function relaysFacilityClock(carrierName) {
+    return typeof carrierName === 'string' && carrierIdFromName(carrierName) === 'dhl-express';
+}
+export { facilityZone };
+/**
+ * The newest wall clock of a reply, and whether that scan was left without an
+ * instant. A reply whose latest scan has none cannot say where the parcel is,
+ * and an older scan must not stand in for it.
+ */
+export class LatestScan {
+    source;
+    wall = '';
+    unplaced = false;
+    constructor(source) {
+        this.source = source;
+    }
+    see(wall, unplaced) {
+        if (wall > this.wall || (wall === this.wall && unplaced))
+            [this.wall, this.unplaced] = [wall, unplaced];
+    }
+    check() {
+        if (this.unplaced)
+            throw new IndeterminateError(this.source, `${this.source} cannot place the latest DHL Express scan`);
+    }
+}

package/dist/server/openapi.json

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

package/package.json

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