universal-parcel-scraper 0.43.1-main.403 → 0.44.0-main.411

package/README.md

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

package/data/catalog.json

@@ -331,7 +331,7 @@
     ],
     "detectionRules": [
       {
-        "pattern": "^(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}NL$",
+        "pattern": "^(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}NL$",
         "confidence": "high",
         "checksum": "s10"
       },
@@ -1090,7 +1090,7 @@
         "confidence": "low"
       },
       {
-        "pattern": "^(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}FR$",
+        "pattern": "^(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}FR$",
         "confidence": "high",
         "checksum": "s10"
       }
@@ -1131,7 +1131,7 @@
     ],
     "detectionRules": [
       {
-        "pattern": "^(?:PZ|XU|XW|XY)\\d{9}[A-Z]{2}$",
+        "pattern": "^(?:PZ|XR|XT|XU|XW|XY)\\d{9}[A-Z]{2}$",
         "confidence": "high",
         "checksum": "s10"
       },
@@ -1746,7 +1746,7 @@
     "linkRules": [],
     "detectionRules": [
       {
-        "pattern": "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}(?!CA$|CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|CL$)[A-Z]{2}$",
+        "pattern": "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}(?!CA$|CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|TS$|JF$|CL$)[A-Z]{2}$",
         "confidence": "high",
         "checksum": "s10"
       }

package/data/detection-golden.json

@@ -10876,6 +10876,17 @@
       "thailand-post"
     ]
   },
+  {
+    "input": "RR123456785TS",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "chronopost"
+    ],
+    "asked": [
+      "chronopost"
+    ]
+  },
   {
     "input": "RR123456789PL",
     "carrier": "unknown",
@@ -11585,6 +11596,38 @@
     "confidence": "none",
     "candidates": []
   },
+  {
+    "input": "XR123456785TS",
+    "carrier": "chronopost",
+    "confidence": "high",
+    "candidates": [
+      "chronopost"
+    ]
+  },
+  {
+    "input": "XT010847192TS",
+    "carrier": "chronopost",
+    "confidence": "high",
+    "candidates": [
+      "chronopost"
+    ]
+  },
+  {
+    "input": "XT123456785TS",
+    "carrier": "chronopost",
+    "confidence": "high",
+    "candidates": [
+      "chronopost"
+    ]
+  },
+  {
+    "input": "XT335285235FR",
+    "carrier": "chronopost",
+    "confidence": "high",
+    "candidates": [
+      "chronopost"
+    ]
+  },
   {
     "input": "XU123456785FR",
     "carrier": "chronopost",

package/dist/browser/scraper.js

@@ -423,7 +423,7 @@ var ve = {
 			}
 		],
 		detectionRules: [{
-			pattern: "^(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}NL$",
+			pattern: "^(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}NL$",
 			confidence: "high",
 			checksum: "s10"
 		}, {
@@ -966,7 +966,7 @@ var ve = {
 				confidence: "low"
 			},
 			{
-				pattern: "^(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}FR$",
+				pattern: "^(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}FR$",
 				confidence: "high",
 				checksum: "s10"
 			}
@@ -1001,7 +1001,7 @@ var ve = {
 		}],
 		detectionRules: [
 			{
-				pattern: "^(?:PZ|XU|XW|XY)\\d{9}[A-Z]{2}$",
+				pattern: "^(?:PZ|XR|XT|XU|XW|XY)\\d{9}[A-Z]{2}$",
 				confidence: "high",
 				checksum: "s10"
 			},
@@ -1472,7 +1472,7 @@ var ve = {
 		trackingSiteName: "17TRACK",
 		linkRules: [],
 		detectionRules: [{
-			pattern: "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}(?!CA$|CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|CL$)[A-Z]{2}$",
+			pattern: "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}(?!CA$|CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|TS$|JF$|CL$)[A-Z]{2}$",
 			confidence: "high",
 			checksum: "s10"
 		}]
@@ -10758,19 +10758,24 @@ var lc = {
 	unknown: 2,
 	empty: 3,
 	excluded: 4
-}, uc = (e, t) => lc[t === "UPU" ? "unknown" : e?.[t] ?? "unknown"];
-function dc(e, t) {
+};
+function uc(e, t) {
+	let n = lc[e?.[t] ?? "unknown"];
+	return t === "UPU" ? lc.unknown : t === "Postal Ninja" ? Math.max(n, lc.empty) : n;
+}
+var dc = (e) => e === "UPU" ? 2 : +(e === "Postal Ninja");
+function fc(e, t) {
 	let n = (e) => e !== "UPU" && t?.[e] === "excluded";
-	return (e.some((e) => e !== "UPU" && !n(e)) ? e.filter((e) => !n(e)) : [...e]).sort((n, r) => Number(n === "UPU") - Number(r === "UPU") || uc(t, n) - uc(t, r) || Number(oc.has(n)) - Number(oc.has(r)) || e.indexOf(n) - e.indexOf(r));
+	return (e.some((e) => e !== "UPU" && !n(e)) ? e.filter((e) => !n(e)) : [...e]).sort((n, r) => dc(n) - dc(r) || uc(t, n) - uc(t, r) || Number(oc.has(n)) - Number(oc.has(r)) || e.indexOf(n) - e.indexOf(r));
 }
-function fc(e = {}) {
+function pc(e = {}) {
 	let { trackingNumber: t, enablePostalNinja: n = !1 } = e, r = (n ? [
 		"ParcelsApp",
 		"Ship24",
-		"Postal Ninja",
 		"17TRACK",
+		"Postal Ninja",
 		"UPU"
-	] : [...ac]).filter((e) => e !== "UPU" || t === void 0 || b(t)), i = (e.carriers ?? []).find((e) => ic(e)) ?? null, a = ic(i), o = dc(r, a), s = cc(t);
+	] : [...ac]).filter((e) => e !== "UPU" || t === void 0 || b(t)), i = (e.carriers ?? []).find((e) => ic(e)) ?? null, a = ic(i), o = fc(r, a), s = cc(t);
 	return {
 		sources: s ? [s, ...o.filter((e) => e !== s)] : o,
 		carrier: i,
@@ -10778,11 +10783,11 @@ function fc(e = {}) {
 		rank: (e) => uc(a, e)
 	};
 }
-function pc(e = !1, t) {
-	return fc({
+function mc(e = !1, t) {
+	return pc({
 		trackingNumber: t,
 		enablePostalNinja: e
 	}).sources;
 }
 //#endregion
-export { Se as AMAZON_NUMBER_PATTERN, Ne as AUTOMATIC_CARRIER_IDS, oc as BROWSER_SOURCES, f as BudgetExceededError, Ve as CARRIERS, ve as CARRIER_CATALOG, v as CARRIER_DEFINITIONS, ye as CARRIER_IDS, Pe as CARRIER_NAMES, t as CarrierError, a as ChallengeError, No as EXPLICIT_OFFSET_PATTERN, r as IndeterminateError, l as InputRequiredError, u as InvalidInputError, ys as MAX_RECOGNITIONS, s as MaintenanceError, i as NoHistoryError, n as NotFoundError, o as RateLimitedError, Ue as SELECTABLE_CARRIERS, xe as STAGES, c as SchemaError, St as TRACKING_CANDIDATE_PATTERNS, Fe as TRACKING_LINK_RULES, d as TransportError, ac as UNIVERSAL_SOURCES, m as UpstreamHttpError, ee as UpstreamNetworkError, je as activeRequirements, Te as amazonMarketplace, Ee as amazonOrdersUrl, De as amazonShippingOrigin, Oe as amazonShippingUrl, os as calendarDay, es as canadaProvinceTimeZone, Ae as carrierAdapter, y as carrierDefinition, h as carrierErrorKind, He as carrierInfo, Ie as carrierLinkRules, We as carrierRequirements, ke as carrierTimezone, _t as checksumRejections, us as classifyStage, Ut as classifyWording, Jo as countryCode, Yo as countryTimeZone, Is as deliveryHandoff, vt as detectCarrier, x as detectCarrierMatch, is as epochMillisTime, as as epochSecondsTime, ne as errorTypeOf, Rt as eventPoint, Fo as explicitOffsetTime, hs as failureHint, ms as failureKind, _e as formatTrackingNumber, Fs as hasDirectHandoffAdapter, ds as inferStage, Ce as isAmazonTrackingNumber, ge as isPlanzerSharedTrackingNumber, Xe as isValidCorreosSpainCheckLetter, ae as isValidDhlExpressWaybill, $e as isValidDpdParcelNumber, at as isValidGlsParcelNumber, ot as isValidHermesParcelNumber, he as isValidMondialRelayBarcode, pe as isValidPocztaPolskaBarcode, b as isValidS10TrackingNumber, me as isValidSscc, se as isValidTntConsignmentNumber, dt as isValidUspsPackageBarcode, Lo as isoTime, Et as keywordNumberInText, Ht as languageStageStatus, qe as localizedCarrierUrl, Le as matchesDomain, zo as mislabeledLocalTime, Bo as mislabeledWallTime, Ys as normalizeCarrierInputs, zt as normalizeCarrierResult, Xs as normalizeDeliveryPostcode, _ as normalizeTrackingNumber, dc as orderUniversalSources, Mt as parseTrackingInput, cc as priorityUniversalSource, xs as recognitionCandidates, bs as recognitionNumberShape, Cs as recognizeAll, Ct as recognizedNumberInText, rs as regionHasTown, Me as requiredRequirements, Ge as requirementSatisfied, we as requiresAmazonAccount, ps as resolveResult, ls as resultHasUpdate, cs as resultStage, g as retryAfterMsOf, Uo as settleGuessedClocks, Ts as settleRecognition, Vo as sharedClockZone, fs as stageSource, st as supportsSwissPostHandoff, Xo as timeZoneCountry, ts as townKey, Vt as trackingLanguageStage, ze as trackingLink, Re as trackingNumberForLink, Ke as tracksAutomatically, fc as universalPlan, sc as universalSourceBudget, pc as universalSources, Qo as usStateTimeZone, bt as validTrackingNumber, Ks as validateDachserTrackingUrl, Gs as validatePlanzerSharedUrl, Wt as wordingStage, Io as zonedTime };
+export { Se as AMAZON_NUMBER_PATTERN, Ne as AUTOMATIC_CARRIER_IDS, oc as BROWSER_SOURCES, f as BudgetExceededError, Ve as CARRIERS, ve as CARRIER_CATALOG, v as CARRIER_DEFINITIONS, ye as CARRIER_IDS, Pe as CARRIER_NAMES, t as CarrierError, a as ChallengeError, No as EXPLICIT_OFFSET_PATTERN, r as IndeterminateError, l as InputRequiredError, u as InvalidInputError, ys as MAX_RECOGNITIONS, s as MaintenanceError, i as NoHistoryError, n as NotFoundError, o as RateLimitedError, Ue as SELECTABLE_CARRIERS, xe as STAGES, c as SchemaError, St as TRACKING_CANDIDATE_PATTERNS, Fe as TRACKING_LINK_RULES, d as TransportError, ac as UNIVERSAL_SOURCES, m as UpstreamHttpError, ee as UpstreamNetworkError, je as activeRequirements, Te as amazonMarketplace, Ee as amazonOrdersUrl, De as amazonShippingOrigin, Oe as amazonShippingUrl, os as calendarDay, es as canadaProvinceTimeZone, Ae as carrierAdapter, y as carrierDefinition, h as carrierErrorKind, He as carrierInfo, Ie as carrierLinkRules, We as carrierRequirements, ke as carrierTimezone, _t as checksumRejections, us as classifyStage, Ut as classifyWording, Jo as countryCode, Yo as countryTimeZone, Is as deliveryHandoff, vt as detectCarrier, x as detectCarrierMatch, is as epochMillisTime, as as epochSecondsTime, ne as errorTypeOf, Rt as eventPoint, Fo as explicitOffsetTime, hs as failureHint, ms as failureKind, _e as formatTrackingNumber, Fs as hasDirectHandoffAdapter, ds as inferStage, Ce as isAmazonTrackingNumber, ge as isPlanzerSharedTrackingNumber, Xe as isValidCorreosSpainCheckLetter, ae as isValidDhlExpressWaybill, $e as isValidDpdParcelNumber, at as isValidGlsParcelNumber, ot as isValidHermesParcelNumber, he as isValidMondialRelayBarcode, pe as isValidPocztaPolskaBarcode, b as isValidS10TrackingNumber, me as isValidSscc, se as isValidTntConsignmentNumber, dt as isValidUspsPackageBarcode, Lo as isoTime, Et as keywordNumberInText, Ht as languageStageStatus, qe as localizedCarrierUrl, Le as matchesDomain, zo as mislabeledLocalTime, Bo as mislabeledWallTime, Ys as normalizeCarrierInputs, zt as normalizeCarrierResult, Xs as normalizeDeliveryPostcode, _ as normalizeTrackingNumber, fc as orderUniversalSources, Mt as parseTrackingInput, cc as priorityUniversalSource, xs as recognitionCandidates, bs as recognitionNumberShape, Cs as recognizeAll, Ct as recognizedNumberInText, rs as regionHasTown, Me as requiredRequirements, Ge as requirementSatisfied, we as requiresAmazonAccount, ps as resolveResult, ls as resultHasUpdate, cs as resultStage, g as retryAfterMsOf, Uo as settleGuessedClocks, Ts as settleRecognition, Vo as sharedClockZone, fs as stageSource, st as supportsSwissPostHandoff, Xo as timeZoneCountry, ts as townKey, Vt as trackingLanguageStage, ze as trackingLink, Re as trackingNumberForLink, Ke as tracksAutomatically, pc as universalPlan, sc as universalSourceBudget, mc as universalSources, Qo as usStateTimeZone, bt as validTrackingNumber, Ks as validateDachserTrackingUrl, Gs as validatePlanzerSharedUrl, Wt as wordingStage, Io as zonedTime };

package/dist/carriers/chronopost/carrier.json

@@ -28,6 +28,7 @@
   "capabilities": [
     "history",
     "location",
+    "eta",
     "provider_code",
     "delivery_tracking_number"
   ],
@@ -43,11 +44,10 @@
     "scraped": [
       "status",
       "history",
-      "location"
-    ],
-    "discarded": [
+      "location",
       "eta"
     ],
+    "discarded": [],
     "unavailable": []
   },
   "links": [
@@ -67,7 +67,7 @@
   "detection": [
     {
       "id": "chronopost-1",
-      "pattern": "^(?:PZ|XU|XW|XY)\\d{9}[A-Z]{2}$",
+      "pattern": "^(?:PZ|XR|XT|XU|XW|XY)\\d{9}[A-Z]{2}$",
       "confidence": "high",
       "checksum": "s10"
     },

package/dist/carriers/chronopost/numbers.json

@@ -109,6 +109,62 @@
       },
       "note": "Made-up number that follows the published format."
     },
+    {
+      "number": "XR123456785TS",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-10-08",
+      "expect": {
+        "carrier": "chronopost",
+        "confidence": "high"
+      },
+      "note": "Made-up number in the shape of Chronopost parcels whose S10 check digit passes and whose TS suffix is no country."
+    },
+    {
+      "number": "XT123456785TS",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-10-08",
+      "expect": {
+        "carrier": "chronopost",
+        "confidence": "high"
+      },
+      "note": "Made-up number in the shape of Chronopost parcels whose S10 check digit passes and whose TS suffix is no country."
+    },
+    {
+      "number": "XT010847192TS",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://suivi-de-colis.fr/chronopost/",
+        "access": "full_page",
+        "date": "2020-06-04",
+        "dateKind": "comment publication"
+      },
+      "expect": {
+        "carrier": "chronopost",
+        "confidence": "high"
+      },
+      "note": "Parcel number a reader posted under a third-party Chronopost tracking page; the attribution was not independently verified."
+    },
+    {
+      "number": "XT335285235FR",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://suivi-de-colis.fr/chronopost/",
+        "access": "full_page",
+        "date": "2020-06-18",
+        "dateKind": "comment publication"
+      },
+      "expect": {
+        "carrier": "chronopost",
+        "confidence": "high"
+      },
+      "note": "Parcel number a reader posted under a third-party Chronopost tracking page, describing a Chronopost agency; the attribution was not independently verified."
+    },
     {
       "number": "XW295445484JF",
       "role": "shipment",

package/dist/carriers/chronopost/parser.js

@@ -2,7 +2,7 @@ import { DateTime } from 'luxon';
 import { isValidDpdParcelNumber } from '../../core/detection/dpd.js';
 import { ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
 import { languageStageStatus } from '../../core/status/index.js';
-import { countryCode, explicitOffsetTime } from '../../core/time/index.js';
+import { calendarDay, countryCode, explicitOffsetTime } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { xmlDocument } from '../../core/transport/xml.js';
 import { chronopostStage, isChronopostNotification } from './status.js';
@@ -45,6 +45,18 @@ function clock(raw) {
     }
     return raw ? { provider_time_text: clean(raw, 64) } : {};
 }
+/** The recipient's chosen redelivery day, printed as dd/MM/yyyy. */
+function redeliveryDay(value) {
+    const match = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(value);
+    return match ? calendarDay(Number(match[3]), Number(match[2]), Number(match[1])) : null;
+}
+/** The calendar day of a scan's own clock, or '' without one. */
+const clockDay = (event) => {
+    const clock = event.time ?? event.local_time;
+    return typeof clock === 'string' ? /^\d{4}-\d{2}-\d{2}/.exec(clock)?.[0] ?? '' : '';
+};
+/** Stages on the way to a planned delivery. */
+const ONGOING = new Set(['pending', 'registered', 'accepted', 'in_transit', 'customs', 'out_for_delivery']);
 /** Keep operational places, never the delivery-point address or shop contact block. */
 function location(office, place) {
     if (/^[\p{L}\p{M} .,'’()-]{1,100} - [A-Z]{2}(?: \(depot \d{1,6}\))?$/u.test(place))
@@ -95,11 +107,14 @@ export function parseChronopostTrackingXml(xml, rawNumber) {
             throw new SchemaError('Chronopost', 'Chronopost returned an empty tracking event');
         const extras = children(scan, 'infoCompList');
         let place = '';
+        let redelivery;
         for (const extra of extras) {
             const name = scalar(extra, 'name');
             const value = scalar(extra, 'value');
             if (name === 'Lieu')
                 place = value;
+            if (name === 'Date de relivraison')
+                redelivery = redeliveryDay(value);
             if (name === 'Numéro partenaire') {
                 const match = /^(?:GEO\/)?([A-Z0-9]{4,40})$/.exec(value.toUpperCase());
                 if (match) {
@@ -122,7 +137,7 @@ export function parseChronopostTrackingXml(xml, rawNumber) {
             ...(code ? { provider_code: code } : {}),
         };
         const mapped = chronopostStage(code, description);
-        return { event, mapped, notification: isChronopostNotification(description), index };
+        return { event, mapped, notification: isChronopostNotification(description), index, redelivery };
     });
     // The operation returns oldest first. Reorder only when all scan clocks
     // establish instants, so mixed local clocks cannot create a guessed order.
@@ -141,6 +156,17 @@ export function parseChronopostTrackingXml(xml, rawNumber) {
         scan.event.stage = scan.notification ? stage : scan.mapped.stage;
         scan.event.stage_source = scan.notification ? 'none' : scan.mapped.source;
     }
+    // The newest instruction that names a redelivery day decides, even when its
+    // day is unreadable. A later scan that is not progress towards that delivery,
+    // or that falls on a later day, ends it.
+    let promised = null;
+    for (const scan of projected) {
+        if (scan.redelivery !== undefined)
+            promised = scan.redelivery;
+        else if (promised && (clockDay(scan.event) > promised || (!scan.notification && !ONGOING.has(scan.mapped.stage)))) {
+            promised = null;
+        }
+    }
     const events = projected.reverse().slice(0, 100).map(scan => scan.event);
     const latest = events[0];
     const reference = references.size === 1 ? [...references][0] : undefined;
@@ -154,7 +180,7 @@ export function parseChronopostTrackingXml(xml, rawNumber) {
         current_stage_source: stageSource,
         last_status_text: latest.description,
         last_update: latest.time ?? null,
-        expected_delivery: null,
+        expected_delivery: ['delivered', 'returned', 'ready_for_pickup'].includes(stage) ? null : promised,
         ...(reference ? { delivery_tracking_number: reference } : {}),
         ...(partner ? { delivery_carrier: partner } : {}),
         ...(destination ? { destination_country: destination } : {}),

package/dist/carriers/dpd/adapter.js

@@ -6,7 +6,7 @@ import { DELIVERY_POSTCODE, deliveryPostcodeText } from '../../core/catalog/post
 import { dpdParcelNumber } from '../../core/detection/dpd.js';
 import { BudgetExceededError, carrierErrorKind, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError, UpstreamHttpError } from '../../core/errors/index.js';
 import { runSteps } from '../../core/runner/index.js';
-import { isoTime, explicitOffsetTime, zonedTime } from '../../core/time/index.js';
+import { calendarDay, isoTime, explicitOffsetTime, zonedTime } from '../../core/time/index.js';
 import { TrawlClient, decodeText, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { API_LABELS, PROOF_OF_DELIVERY_SCAN, apiStage, apiStatus, scanStage, wordingStatus, } from './status.js';
@@ -254,6 +254,32 @@ function expectedDelivery(payload) {
         return `${date} ${from}–${to}`;
     return from || to ? `${date} ${from || to}` : date;
 }
+/** Scans in which DPD states a delivery day: an estimate, a changed date or the email notice. */
+const DELIVERY_NOTICE = /\b(?:estimated to be|will be) delivered on\b/i;
+const MONTHS = ['january', 'february', 'march', 'april', 'may', 'june', 'july', 'august', 'september',
+    'october', 'november', 'december'];
+/** A notice clock as 24-hour `HH:mm`; it stays the recipient's wall clock. */
+function noticeClock(text) {
+    const match = /^(\d{1,2}):([0-5]\d)(?:\s*([AP])M)?$/i.exec(text ?? '');
+    if (!match)
+        return null;
+    const hour = Number(match[1]);
+    const half = match[3]?.toUpperCase();
+    if (half ? hour < 1 || hour > 12 : hour > 23)
+        return null;
+    return `${String(half ? (hour % 12) + (half === 'P' ? 12 : 0) : hour).padStart(2, '0')}:${match[2]}`;
+}
+/** "…delivered on: Thursday, July 16, 2026", optionally followed by "between 9:00 AM and 12:00 PM". */
+function noticeEstimate(text) {
+    const match = /\bdelivered on:?\s+(?:[a-z]+,\s*)?([a-z]+)\s+(\d{1,2}),\s*(\d{4})(?:\s+between\s+(\d{1,2}:\d{2}(?:\s*[AP]M)?)\s+and\s+(\d{1,2}:\d{2}(?:\s*[AP]M)?))?/i.exec(text);
+    const month = match ? MONTHS.indexOf(match[1].toLowerCase()) + 1 : 0;
+    const day = match && month ? calendarDay(Number(match[3]), month, Number(match[2])) : null;
+    if (!match || !day)
+        return null;
+    const from = noticeClock(match[4]);
+    const to = noticeClock(match[5]);
+    return from && to && from <= to ? `${day} ${from}–${to}` : day;
+}
 /**
  * Newest scan first. The guest API has listed a parcel's scans oldest first,
  * and the summary and freshness watermark read the first event. Equal or
@@ -358,6 +384,16 @@ export function parseDPDTrackingApi(payload, trackingNumber, postcodeVerified) {
     const deliveredAt = status === 'delivered'
         ? events.find((event) => event.stage === 'delivered')?.time
         : undefined;
+    // Only the newest notice counts, so an undated or unreadable one leaves no
+    // older day behind. A day that a later scan has passed, or a parcel waiting
+    // at a pickup point, ends the notice. The payload's own estimate wins; a
+    // notice for that same day can only add the email's window.
+    const notice = events.find((event) => DELIVERY_NOTICE.test(event.description ?? ''));
+    const announced = notice ? noticeEstimate(notice.description ?? '') : null;
+    const newestDay = /^\d{4}-\d{2}-\d{2}/.exec(events[0]?.time ?? '')?.[0];
+    const forecast = announced && stage !== 'ready_for_pickup' && !(newestDay && announced.slice(0, 10) < newestDay)
+        ? announced : null;
+    const listed = expectedDelivery(payload);
     // Never projected: `receiver` (name, contact, address, geoPosition), the
     // sender's id and address, `customerReference1/2`, `gttsZipCode`, `podUrl`
     // and `product`, which holds the recipient's delivery preference.
@@ -366,7 +402,8 @@ export function parseDPDTrackingApi(payload, trackingNumber, postcodeVerified) {
         ...(stage ? { current_stage: stage } : {}),
         last_status_text: statusText,
         last_update: events[0]?.time || apiEventTime(current.eventDateAndTime, '', current.eventDateAndTimeZoneId) || null,
-        expected_delivery: status === 'delivered' || status === 'exception' ? null : expectedDelivery(payload),
+        expected_delivery: status === 'delivered' || status === 'exception' ? null
+            : listed && listed !== forecast?.slice(0, 10) ? listed : forecast ?? listed,
         events,
         source: 'mydpd_guest_api',
         delivery_date: optionalText(payload.deliveryDate),

package/dist/carriers/intl-post/carrier.json

@@ -38,7 +38,7 @@
   "detection": [
     {
       "id": "intl-post-1",
-      "pattern": "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}(?!CA$|CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|CL$)[A-Z]{2}$",
+      "pattern": "^(?![CL][A-Z]\\d{9}DE$)(?!AS\\d{9}US$)(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}(?!CA$|CH$|FR$|IN$|NL$|GB$|IE$|BE$|PT$|NZ$|SG$|JP$|KR$|TH$|HK$|MY$|CN$|NO$|BR$|ES$|SE$|DK$|AT$|YP$|TS$|JF$|CL$)[A-Z]{2}$",
       "confidence": "high",
       "checksum": "s10"
     }

package/dist/carriers/intl-post/numbers.json

@@ -24,6 +24,24 @@
         "confidence": "high"
       },
       "note": "Made-up number that follows the published format."
+    },
+    {
+      "number": "RR123456785TS",
+      "role": "negative",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-10-08",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "chronopost"
+        ],
+        "not": [
+          "intl-post"
+        ]
+      },
+      "note": "Invented number whose S10 check digit passes but whose TS suffix is a Chronopost code rather than an issuing country, so it is not international mail."
     }
   ]
 }

package/dist/carriers/la-poste/carrier.json

@@ -96,7 +96,7 @@
     },
     {
       "id": "la-poste-3",
-      "pattern": "^(?!(?:PZ|XU|XW|XY))[A-Z]{2}\\d{9}FR$",
+      "pattern": "^(?!(?:PZ|XR|XT|XU|XW|XY))[A-Z]{2}\\d{9}FR$",
       "confidence": "high",
       "checksum": "s10"
     }

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

@@ -3,8 +3,8 @@ import type { CarrierResult } from '../../core/result/index.js';
 export declare function normalizePaackTrackingNumber(raw: string): string;
 export declare function normalizePaackPostcode(raw: string): string;
 export declare function paackTrackingUrl(rawTrackingNumber: string, rawPostcode: string): string;
-export declare function parsePaackTrackingResponse(payload: unknown, rawTrackingNumber: string): CarrierResult;
-export declare function parsePaackTrackingHtml(html: string, rawTrackingNumber: string): CarrierResult;
+export declare function parsePaackTrackingResponse(payload: unknown, rawPostcode: string): CarrierResult;
+export declare function parsePaackTrackingHtml(html: string, rawPostcode: string): CarrierResult;
 export interface PaackTrackerOptions {
     timeoutMs?: number;
     /** Test seam; production uses the global fetch. */