universal-parcel-scraper 0.69.7-main.899 → 0.70.0-main.901

package/data/catalog.json

@@ -1312,6 +1312,21 @@
     "tracking": {
       "mode": "automatic",
       "adapter": "colis-prive",
+      "requirements": [
+        {
+          "field": "postcode",
+          "whenTrackingNumber": "^[A-Z0-9]{12}$",
+          "validator": "colisPrivePostcode",
+          "label": "Delivery postcode",
+          "type": "text",
+          "placeholder": "75001",
+          "help": "Colis Privé needs the recipient postcode with the 12-character number: 5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg.",
+          "pattern": "^(?:(?:0[1-9]|[1-8][0-9]|9[0-578])[0-9]{3}|(?:(?:[Bb][Ee]?|[Ll][Uu]?)[ \\-]?)?[1-9][0-9]{3})$",
+          "maxLength": 7,
+          "inputMode": "text",
+          "autoComplete": "postal-code"
+        }
+      ],
       "recognitionRank": 30
     },
     "canaryUrl": "https://colisprive.com/moncolis/pages/DetailColis.aspx",

package/dist/browser/scraper.js

@@ -1194,6 +1194,19 @@ var ye = {
 		tracking: {
 			mode: "automatic",
 			adapter: "colis-prive",
+			requirements: [{
+				field: "postcode",
+				whenTrackingNumber: "^[A-Z0-9]{12}$",
+				validator: "colisPrivePostcode",
+				label: "Delivery postcode",
+				type: "text",
+				placeholder: "75001",
+				help: "Colis Privé needs the recipient postcode with the 12-character number: 5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg.",
+				pattern: "^(?:(?:0[1-9]|[1-8][0-9]|9[0-578])[0-9]{3}|(?:(?:[Bb][Ee]?|[Ll][Uu]?)[ \\-]?)?[1-9][0-9]{3})$",
+				maxLength: 7,
+				inputMode: "text",
+				autoComplete: "postal-code"
+			}],
 			recognitionRank: 30
 		},
 		canaryUrl: "https://colisprive.com/moncolis/pages/DetailColis.aspx",
@@ -11947,9 +11960,15 @@ var Yc = /^(?=.{3,12}$)(?=.*\d)[A-Z0-9]+(?:[ -][A-Z0-9]+)*$/;
 function Xc(e) {
 	return e.trim().toUpperCase().replace(/\s+/g, " ");
 }
+function Zc(e) {
+	let t = e.toUpperCase().replace(/\s+/g, "");
+	if (/^(?:0[1-9]|[1-8]\d|9[0-5]|97|98)\d{3}$/.test(t)) return t;
+	let n = /^(?:(BE?|LU?)-?)?([1-9]\d{3})$/.exec(t);
+	return n ? `${n[1]?.charAt(0) ?? ""}${n[2]}` : null;
+}
 //#endregion
 //#region core/catalog/inputs.ts
-function Zc(e, t, n, r) {
+function Qc(e, t, n, r) {
 	let i = {
 		trackingUrl: n.trim() || null,
 		postcode: r.trim() || null
@@ -11960,7 +11979,7 @@ function Zc(e, t, n, r) {
 		field: "postcode",
 		validator: "internationalPostcode"
 	});
-	for (let [e, t] of Object.entries(i)) if (t !== null && !o.has(e)) throw TypeError(e === "trackingUrl" ? "A tracking URL is not used for this carrier or tracking number" : "A delivery postcode is not used for this carrier");
+	for (let [e, t] of Object.entries(i)) if (t !== null && !o.has(e)) throw TypeError(e === "trackingUrl" ? "A tracking URL is not used for this carrier or tracking number" : "A delivery postcode is not used for this carrier or tracking number");
 	for (let [n, r] of o) {
 		let a = i[n];
 		if (!a) {
@@ -11994,17 +12013,23 @@ function Zc(e, t, n, r) {
 				i[n] = e.replace(/\s+/g, "");
 				break;
 			}
+			case "colisPrivePostcode": {
+				let t = Zc(a);
+				if (!t) throw TypeError(`${x(e).displayName} requires a French, Belgian or Luxembourg delivery postcode`);
+				i[n] = t;
+				break;
+			}
 			default: r.validator;
 		}
 	}
 	return i;
 }
-function Qc(e) {
+function $c(e) {
 	let t = Xc(e);
 	if (!Yc.test(t)) throw TypeError("A valid delivery postcode is required");
 	return t;
 }
-var $c = { carriers: [
+var el = { carriers: [
 	{
 		carrier: "dhl",
 		direct: "Yes",
@@ -15970,80 +15995,80 @@ var $c = { carriers: [
 			}
 		}]
 	}
-] }, el = [
+] }, tl = [
 	"Ship24",
 	"ParcelsApp",
 	"17TRACK",
 	"Postal Ninja",
 	"UPU"
-], tl = /* @__PURE__ */ new Set([
+], nl = /* @__PURE__ */ new Set([
 	"no_history",
 	"summary_only",
 	"undated",
 	"sign_in",
 	"postcode_prompt"
-]), nl = $c.carriers, rl = new Map(nl.map((e) => [e.carrier, e]));
-function il(e) {
+]), rl = el.carriers, il = new Map(rl.map((e) => [e.carrier, e]));
+function al(e) {
 	return typeof e == "number" || e === "history" || typeof e == "object" && !!e;
 }
-function al(e, t) {
-	let n = t.filter((t) => t.results[e] !== void 0), r = n.some((t) => !t.stale && (tl.has(t.results[e]) || t.results[e] === "wrong_carrier") && Object.entries(t.results).some(([t, n]) => t !== e && t !== "UPU" && il(n)));
-	return n.some((t) => il(t.results[e])) ? n.some((t) => typeof t.results[e] == "object") || r ? "partial" : "full" : n.some((t) => ["wrong_carrier", "refused"].includes(t.results[e])) ? "excluded" : n.some((t) => !t.stale && tl.has(t.results[e])) ? "empty" : "unknown";
+function ol(e, t) {
+	let n = t.filter((t) => t.results[e] !== void 0), r = n.some((t) => !t.stale && (nl.has(t.results[e]) || t.results[e] === "wrong_carrier") && Object.entries(t.results).some(([t, n]) => t !== e && t !== "UPU" && al(n)));
+	return n.some((t) => al(t.results[e])) ? n.some((t) => typeof t.results[e] == "object") || r ? "partial" : "full" : n.some((t) => ["wrong_carrier", "refused"].includes(t.results[e])) ? "excluded" : n.some((t) => !t.stale && nl.has(t.results[e])) ? "empty" : "unknown";
 }
-function ol(e) {
-	let t = e ? rl.get(e) : void 0;
-	return t ? Object.fromEntries(el.map((e) => [e, al(e, t.references)])) : null;
+function sl(e) {
+	let t = e ? il.get(e) : void 0;
+	return t ? Object.fromEntries(tl.map((e) => [e, ol(e, t.references)])) : null;
 }
 //#endregion
 //#region providers/plan.ts
-var sl = [
+var cl = [
 	"ParcelsApp",
 	"Ship24",
 	"17TRACK",
 	"UPU"
-], cl = /* @__PURE__ */ new Set(["17TRACK", "Postal Ninja"]);
-function ll(e) {
+], ll = /* @__PURE__ */ new Set(["17TRACK", "Postal Ninja"]);
+function ul(e) {
 	return e === "ParcelsApp" ? 45e3 : e === "UPU" ? 8e3 : 3e4;
 }
-function ul(e) {
+function dl(e) {
 	return e && /^\d{10}$/.test(y(e)) ? "Ship24" : e && /^[CL][A-Z]\d{9}CN$/.test(y(e)) && ft(e) ? "17TRACK" : void 0;
 }
-var dl = {
+var fl = {
 	full: 0,
 	partial: 1,
 	unknown: 2,
 	empty: 3,
 	excluded: 4
 };
-function fl(e, t) {
-	let n = dl[e?.[t] ?? "unknown"];
-	return t === "UPU" ? dl.unknown : t === "Postal Ninja" ? Math.max(n, dl.empty) : n;
+function pl(e, t) {
+	let n = fl[e?.[t] ?? "unknown"];
+	return t === "UPU" ? fl.unknown : t === "Postal Ninja" ? Math.max(n, fl.empty) : n;
 }
-var pl = (e) => e === "UPU" ? 2 : +(e === "Postal Ninja");
-function ml(e, t) {
+var ml = (e) => e === "UPU" ? 2 : +(e === "Postal Ninja");
+function hl(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) => pl(n) - pl(r) || fl(t, n) - fl(t, r) || Number(cl.has(n)) - Number(cl.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) => ml(n) - ml(r) || pl(t, n) - pl(t, r) || Number(ll.has(n)) - Number(ll.has(r)) || e.indexOf(n) - e.indexOf(r));
 }
-function hl(e = {}) {
+function gl(e = {}) {
 	let { trackingNumber: t, enablePostalNinja: n = !1 } = e, r = (n ? [
 		"ParcelsApp",
 		"Ship24",
 		"17TRACK",
 		"Postal Ninja",
 		"UPU"
-	] : [...sl]).filter((e) => e !== "UPU" || t === void 0 || ft(t)), i = (e.carriers ?? []).find((e) => ol(e)) ?? null, a = ol(i), o = ml(r, a), s = ul(t);
+	] : [...cl]).filter((e) => e !== "UPU" || t === void 0 || ft(t)), i = (e.carriers ?? []).find((e) => sl(e)) ?? null, a = sl(i), o = hl(r, a), s = dl(t);
 	return {
 		sources: s ? [s, ...o.filter((e) => e !== s)] : o,
 		carrier: i,
 		tier: (e) => a?.[e] ?? "unknown",
-		rank: (e) => fl(a, e)
+		rank: (e) => pl(a, e)
 	};
 }
-function gl(e = !1, t) {
-	return hl({
+function _l(e = !1, t) {
+	return gl({
 		trackingNumber: t,
 		enablePostalNinja: e
 	}).sources;
 }
 //#endregion
-export { Ce as AMAZON_NUMBER_PATTERN, Pe as AUTOMATIC_CARRIER_IDS, cl as BROWSER_SOURCES, f as BudgetExceededError, S as CARRIERS, ye as CARRIER_CATALOG, b as CARRIER_DEFINITIONS, be as CARRIER_IDS, Fe as CARRIER_NAMES, t as CarrierError, a as ChallengeError, Lo as EXPLICIT_OFFSET_PATTERN, r as IndeterminateError, l as InputRequiredError, u as InvalidInputError, vc as MAX_RECOGNITIONS, s as MaintenanceError, i as NoHistoryError, n as NotFoundError, o as RateLimitedError, Ue as SELECTABLE_CARRIERS, Se as STAGES, c as SchemaError, Mt as TRACKING_CANDIDATE_PATTERNS, Ie as TRACKING_LINK_RULES, d as TransportError, sl as UNIVERSAL_SOURCES, m as UpstreamHttpError, ee as UpstreamNetworkError, Me as activeRequirements, Ee as amazonMarketplace, De as amazonOrdersUrl, Oe as amazonShippingOrigin, ke as amazonShippingUrl, ds as calendarDay, as as canadaProvinceTimeZone, je as carrierAdapter, x as carrierDefinition, g as carrierErrorKind, He as carrierInfo, Le as carrierLinkRules, We as carrierRequirements, Ae as carrierTimezone, Dt as checksumRejections, lc as classifyStage, ic as classifyWording, $o as countryCode, es as countryTimeZone, Rc as deliveryHandoff, Ot as detectCarrier, C as detectCarrierMatch, ls as epochMillisTime, us as epochSecondsTime, te as errorTypeOf, xs as eventPoint, zo as explicitOffsetTime, mc as failureHint, pc as failureKind, ge as formatTrackingNumber, Lc as hasDirectHandoffAdapter, uc as inferStage, we as isAmazonTrackingNumber, he as isPlanzerSharedTrackingNumber, Xe as isValidCorreosSpainCheckLetter, v as isValidDhlExpressWaybill, $e as isValidDpdParcelNumber, ct as isValidGlsParcelNumber, lt as isValidHermesParcelNumber, me as isValidMondialRelayBarcode, fe as isValidPocztaPolskaBarcode, ft as isValidS10TrackingNumber, pe as isValidSscc, oe as isValidTntConsignmentNumber, bt as isValidUspsPackageBarcode, Vo as isoTime, It as keywordNumberInText, rc as languageStageStatus, qe as localizedCarrierUrl, Re as matchesDomain, Uo as mislabeledLocalTime, Wo as mislabeledWallTime, Zc as normalizeCarrierInputs, Ss as normalizeCarrierResult, Qc as normalizeDeliveryPostcode, y as normalizeTrackingNumber, ml as orderUniversalSources, Ht as parseTrackingInput, ul as priorityUniversalSource, xc as recognitionCandidates, yc as recognitionNumberShape, Cc as recognizeAll, Nt as recognizedNumberInText, cs as regionHasTown, Ne as requiredRequirements, Ge as requirementSatisfied, Te as requiresAmazonAccount, fc as resolveResult, cc as resultHasUpdate, sc as resultStage, _ as retryAfterMsOf, qo as settleGuessedClocks, Dc as settleRecognition, Go as sharedClockZone, dc as stageSource, mt as supportsSwissPostHandoff, ts as timeZoneCountry, os as townKey, nc as trackingLanguageStage, Be as trackingLink, ze as trackingNumberForLink, Ke as tracksAutomatically, hl as universalPlan, ll as universalSourceBudget, gl as universalSources, rs as usStateTimeZone, yt as uspsPackageIdentifier, At as validTrackingNumber, Jc as validateDachserTrackingUrl, qc as validatePlanzerSharedUrl, ac as wordingStage, Bo as zonedTime };
+export { Ce as AMAZON_NUMBER_PATTERN, Pe as AUTOMATIC_CARRIER_IDS, ll as BROWSER_SOURCES, f as BudgetExceededError, S as CARRIERS, ye as CARRIER_CATALOG, b as CARRIER_DEFINITIONS, be as CARRIER_IDS, Fe as CARRIER_NAMES, t as CarrierError, a as ChallengeError, Lo as EXPLICIT_OFFSET_PATTERN, r as IndeterminateError, l as InputRequiredError, u as InvalidInputError, vc as MAX_RECOGNITIONS, s as MaintenanceError, i as NoHistoryError, n as NotFoundError, o as RateLimitedError, Ue as SELECTABLE_CARRIERS, Se as STAGES, c as SchemaError, Mt as TRACKING_CANDIDATE_PATTERNS, Ie as TRACKING_LINK_RULES, d as TransportError, cl as UNIVERSAL_SOURCES, m as UpstreamHttpError, ee as UpstreamNetworkError, Me as activeRequirements, Ee as amazonMarketplace, De as amazonOrdersUrl, Oe as amazonShippingOrigin, ke as amazonShippingUrl, ds as calendarDay, as as canadaProvinceTimeZone, je as carrierAdapter, x as carrierDefinition, g as carrierErrorKind, He as carrierInfo, Le as carrierLinkRules, We as carrierRequirements, Ae as carrierTimezone, Dt as checksumRejections, lc as classifyStage, ic as classifyWording, $o as countryCode, es as countryTimeZone, Rc as deliveryHandoff, Ot as detectCarrier, C as detectCarrierMatch, ls as epochMillisTime, us as epochSecondsTime, te as errorTypeOf, xs as eventPoint, zo as explicitOffsetTime, mc as failureHint, pc as failureKind, ge as formatTrackingNumber, Lc as hasDirectHandoffAdapter, uc as inferStage, we as isAmazonTrackingNumber, he as isPlanzerSharedTrackingNumber, Xe as isValidCorreosSpainCheckLetter, v as isValidDhlExpressWaybill, $e as isValidDpdParcelNumber, ct as isValidGlsParcelNumber, lt as isValidHermesParcelNumber, me as isValidMondialRelayBarcode, fe as isValidPocztaPolskaBarcode, ft as isValidS10TrackingNumber, pe as isValidSscc, oe as isValidTntConsignmentNumber, bt as isValidUspsPackageBarcode, Vo as isoTime, It as keywordNumberInText, rc as languageStageStatus, qe as localizedCarrierUrl, Re as matchesDomain, Uo as mislabeledLocalTime, Wo as mislabeledWallTime, Qc as normalizeCarrierInputs, Ss as normalizeCarrierResult, $c as normalizeDeliveryPostcode, y as normalizeTrackingNumber, hl as orderUniversalSources, Ht as parseTrackingInput, dl as priorityUniversalSource, xc as recognitionCandidates, yc as recognitionNumberShape, Cc as recognizeAll, Nt as recognizedNumberInText, cs as regionHasTown, Ne as requiredRequirements, Ge as requirementSatisfied, Te as requiresAmazonAccount, fc as resolveResult, cc as resultHasUpdate, sc as resultStage, _ as retryAfterMsOf, qo as settleGuessedClocks, Dc as settleRecognition, Go as sharedClockZone, dc as stageSource, mt as supportsSwissPostHandoff, ts as timeZoneCountry, os as townKey, nc as trackingLanguageStage, Be as trackingLink, ze as trackingNumberForLink, Ke as tracksAutomatically, gl as universalPlan, ul as universalSourceBudget, _l as universalSources, rs as usStateTimeZone, yt as uspsPackageIdentifier, At as validTrackingNumber, Jc as validateDachserTrackingUrl, qc as validatePlanzerSharedUrl, ac as wordingStage, Bo as zonedTime };

package/dist/carriers/colis-prive/adapter.d.ts

@@ -7,10 +7,11 @@
  * before any text is read, so nothing identifying a person can reach the result.
  *
  * The lookup credential is the 12-character shipment number followed by the
- * recipient's postcode: five digits in France, or B (Belgium) or L (Luxembourg)
- * and four digits. The postcode is what makes the page reachable,
- * so it is part of the tracking credential: it is never logged, put in an issue
- * or written into a fixture.
+ * recipient's postcode: five digits in France, four in Belgium, bare or after
+ * B, or L and four digits in Luxembourg. The postcode comes at the end of the
+ * number, as in Colis Privé's own links, or as a separate input. It is what
+ * makes the page reachable, so it is part of the tracking credential: it is
+ * never logged, put in an issue or written into a fixture.
  */
 import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import { NotFoundError } from '../../core/errors/index.js';
@@ -23,8 +24,13 @@ export { classifyStatus } from './status.js';
 export declare class ColisPriveTrackingError extends NotFoundError {
     constructor();
 }
-export declare function normalizeColisPriveCredential(raw: string): string;
-export declare function colisPriveTrackingUrl(rawCredential: string): string;
+/**
+ * The value the page is opened with: the shipment and the postcode, written
+ * after it or given apart. A bare shipment is a missing credential, as the
+ * page never opens without its postcode.
+ */
+export declare function normalizeColisPriveCredential(raw: string, rawPostcode?: string): string;
+export declare function colisPriveTrackingUrl(rawCredential: string, rawPostcode?: string): string;
 export declare function parseColisPriveTrackingHtml(html: string, rawCredential: string): CarrierResult;
 export interface ColisPriveTrackerOptions {
     timeoutMs?: number;
@@ -36,6 +42,6 @@ export declare class ColisPriveTracker {
     #private;
     readonly timeoutMs: number;
     constructor(options?: ColisPriveTrackerOptions);
-    fetch(rawCredential: string, context?: TrackingContext): Promise<CarrierResult>;
+    fetch(rawCredential: string, rawPostcode?: string, context?: TrackingContext): Promise<CarrierResult>;
 }
 export declare const adapter: AdapterFactory;

package/dist/carriers/colis-prive/adapter.js

@@ -7,14 +7,16 @@
  * before any text is read, so nothing identifying a person can reach the result.
  *
  * The lookup credential is the 12-character shipment number followed by the
- * recipient's postcode: five digits in France, or B (Belgium) or L (Luxembourg)
- * and four digits. The postcode is what makes the page reachable,
- * so it is part of the tracking credential: it is never logged, put in an issue
- * or written into a fixture.
+ * recipient's postcode: five digits in France, four in Belgium, bare or after
+ * B, or L and four digits in Luxembourg. The postcode comes at the end of the
+ * number, as in Colis Privé's own links, or as a separate input. It is what
+ * makes the page reachable, so it is part of the tracking credential: it is
+ * never logged, put in an issue or written into a fixture.
  */
 import { load } from 'cheerio';
-import { accepted, lookupBudget, recognizeFromLookup } from '../../core/adapter/index.js';
-import { InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { lookupBudget, recognizeFromLookup } from '../../core/adapter/index.js';
+import { colisPrivePostcode } from '../../core/catalog/postcode.js';
+import { InputRequiredError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
 import { UpstreamHttpError, clean, decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
 import { calendarDay } from '../../core/time/index.js';
 import { classifyStatus, comparableText } from './status.js';
@@ -25,6 +27,14 @@ const TIMEZONE = 'Europe/Paris';
 const MAX_RESPONSE_BYTES = 500_000;
 const DEFAULT_TIMEOUT_MS = 15_000;
 const MAX_EVENTS_TO_RETURN = 100;
+const CREDENTIAL_MESSAGE = 'Colis Privé tracking requires the 12-character shipment number and the recipient postcode '
+    + '(5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg)';
+const SHIPMENT = /^[A-Z0-9]{12}$/;
+/** The shipment with its postcode at the end, as Colis Privé's links carry it. */
+function combined(number) {
+    const postcode = number.slice(12);
+    return SHIPMENT.test(number.slice(0, 12)) && colisPrivePostcode(postcode) === postcode;
+}
 function shipmentPart(credential) {
     return credential.slice(0, 12);
 }
@@ -60,12 +70,24 @@ export class ColisPriveTrackingError extends NotFoundError {
         this.name = 'ColisPriveTrackingError';
     }
 }
-export function normalizeColisPriveCredential(raw) {
-    const credential = raw.trim().toLocaleUpperCase('en-US');
-    if (!/^[A-Z0-9]{12}(?:(?:0[1-9]|[1-8]\d|9[0-5]|97|98)\d{3}|[BL][1-9]\d{3})$/.test(credential)) {
-        throw new InvalidInputError(PROVIDER, 'Colis Privé tracking requires the 12-character shipment number followed by the recipient postcode (5 digits, or B or L and 4 digits)');
+/**
+ * The value the page is opened with: the shipment and the postcode, written
+ * after it or given apart. A bare shipment is a missing credential, as the
+ * page never opens without its postcode.
+ */
+export function normalizeColisPriveCredential(raw, rawPostcode = '') {
+    const number = raw.trim().toLocaleUpperCase('en-US');
+    if (rawPostcode.trim()) {
+        const postcode = colisPrivePostcode(rawPostcode);
+        if (!SHIPMENT.test(number) || !postcode)
+            throw new InvalidInputError(PROVIDER, CREDENTIAL_MESSAGE);
+        return `${number}${postcode}`;
     }
-    return credential;
+    if (SHIPMENT.test(number))
+        throw new InputRequiredError(PROVIDER, 'the recipient postcode', CREDENTIAL_MESSAGE);
+    if (!combined(number))
+        throw new InvalidInputError(PROVIDER, CREDENTIAL_MESSAGE);
+    return number;
 }
 /** The day a row announces for a confirmed appointment or a relay drop-off: "… le DD/MM/YYYY". */
 function plannedDay(description) {
@@ -75,8 +97,8 @@ function plannedDay(description) {
     return match ? calendarDay(Number(match[3]), Number(match[2]), Number(match[1])) : null;
 }
 const SETTLED = new Set(['delivered', 'returned', 'exception', 'failed_attempt', 'ready_for_pickup']);
-export function colisPriveTrackingUrl(rawCredential) {
-    const credential = normalizeColisPriveCredential(rawCredential);
+export function colisPriveTrackingUrl(rawCredential, rawPostcode = '') {
+    const credential = normalizeColisPriveCredential(rawCredential, rawPostcode);
     const url = new URL(TRACKING_ENDPOINT);
     url.searchParams.set('numColis', credential);
     url.searchParams.set('lang', 'fr');
@@ -164,8 +186,8 @@ export class ColisPriveTracker {
         this.#fetcher = options.fetcher;
         this.#userAgent = userAgentOf(options.userAgent);
     }
-    async fetch(rawCredential, context = {}) {
-        const credential = normalizeColisPriveCredential(rawCredential);
+    async fetch(rawCredential, rawPostcode = '', context = {}) {
+        const credential = normalizeColisPriveCredential(rawCredential, rawPostcode);
         const budget = lookupBudget(context, this.timeoutMs);
         const { response, bytes } = await fetchBounded(colisPriveTrackingUrl(credential), {
             signal: budget.signal,
@@ -197,9 +219,9 @@ export const adapter = (environment) => {
     return {
         id: 'colis-prive',
         steps: ['direct'],
-        // The postcode is already part of the stored number for this carrier.
-        track: (input, context) => tracker.fetch(input.number, context),
-        // A bare 12-character number needs the postcode appended: it reads as unknown.
-        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeColisPriveCredential(number))),
+        // The postcode ends the number, or a bare number carries it apart.
+        track: (input, context) => tracker.fetch(input.number, input.postcode ?? '', context),
+        // Recognition gets no postcode, so a bare 12-character number reads as unknown.
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, '', context), () => combined(number.trim().toLocaleUpperCase('en-US'))),
     };
 };

package/dist/carriers/colis-prive/carrier.json

@@ -19,6 +19,21 @@
   "tracking": {
     "mode": "automatic",
     "adapter": "colis-prive",
+    "requirements": [
+      {
+        "field": "postcode",
+        "whenTrackingNumber": "^[A-Z0-9]{12}$",
+        "validator": "colisPrivePostcode",
+        "label": "Delivery postcode",
+        "type": "text",
+        "placeholder": "75001",
+        "help": "Colis Privé needs the recipient postcode with the 12-character number: 5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg.",
+        "pattern": "^(?:(?:0[1-9]|[1-8][0-9]|9[0-578])[0-9]{3}|(?:(?:[Bb][Ee]?|[Ll][Uu]?)[ \\-]?)?[1-9][0-9]{3})$",
+        "maxLength": 7,
+        "inputMode": "text",
+        "autoComplete": "postal-code"
+      }
+    ],
     "steps": [
       "direct"
     ],

package/dist/core/catalog/inputs.js

@@ -3,7 +3,7 @@ import { activeRequirements, carrierDefinition } from './index.js';
 import { isValidMondialRelayBarcode } from '../detection/index.js';
 import { validateDachserTrackingUrl } from './urls.js';
 import { validatePlanzerSharedUrl } from './urls.js';
-import { DELIVERY_POSTCODE, deliveryPostcodeText } from './postcode.js';
+import { DELIVERY_POSTCODE, colisPrivePostcode, deliveryPostcodeText } from './postcode.js';
 export { AUTOMATIC_CARRIER_IDS, CARRIER_NAMES, activeRequirements, carrierAdapter, carrierDefinition, carrierTimezone, requiredRequirements, } from './index.js';
 export { isValidS10TrackingNumber, supportsSwissPostHandoff, } from '../detection/index.js';
 export function normalizeCarrierInputs(carrierId, trackingNumber, trackingUrl, postcode) {
@@ -29,7 +29,7 @@ export function normalizeCarrierInputs(carrierId, trackingNumber, trackingUrl, p
             if (field === 'trackingUrl') {
                 throw new TypeError('A tracking URL is not used for this carrier or tracking number');
             }
-            throw new TypeError('A delivery postcode is not used for this carrier');
+            throw new TypeError('A delivery postcode is not used for this carrier or tracking number');
         }
     }
     for (const [field, requirement] of requirements) {
@@ -93,6 +93,14 @@ export function normalizeCarrierInputs(carrierId, trackingNumber, trackingUrl, p
                 supplied[field] = rawPostcode.replace(/\s+/g, '');
                 break;
             }
+            case 'colisPrivePostcode': {
+                const normalized = colisPrivePostcode(value);
+                if (!normalized) {
+                    throw new TypeError(`${carrierDefinition(carrierId).displayName} requires a French, Belgian or Luxembourg delivery postcode`);
+                }
+                supplied[field] = normalized;
+                break;
+            }
             default:
                 requirement.validator;
         }

package/dist/core/catalog/postcode.d.ts

@@ -2,3 +2,10 @@
 export declare const DELIVERY_POSTCODE: RegExp;
 /** A typed postcode as it is checked and sent: trimmed, in capitals, with single spaces. */
 export declare function deliveryPostcodeText(value: string): string;
+/**
+ * A Colis Privé recipient postcode as its page takes it after the shipment
+ * number: France's five digits, or Belgium's or Luxembourg's four, bare or
+ * after B or L. A written country prefix (B-1000, LU 1234) becomes that
+ * letter. Null for anything else.
+ */
+export declare function colisPrivePostcode(value: string): string | null;

package/dist/core/catalog/postcode.js

@@ -4,3 +4,18 @@ export const DELIVERY_POSTCODE = /^(?=.{3,12}$)(?=.*\d)[A-Z0-9]+(?:[ -][A-Z0-9]+
 export function deliveryPostcodeText(value) {
     return value.trim().toUpperCase().replace(/\s+/g, ' ');
 }
+/**
+ * A Colis Privé recipient postcode as its page takes it after the shipment
+ * number: France's five digits, or Belgium's or Luxembourg's four, bare or
+ * after B or L. A written country prefix (B-1000, LU 1234) becomes that
+ * letter. Null for anything else.
+ */
+export function colisPrivePostcode(value) {
+    const text = value.toUpperCase().replace(/\s+/g, '');
+    if (/^(?:0[1-9]|[1-8]\d|9[0-5]|97|98)\d{3}$/.test(text))
+        return text;
+    const match = /^(?:(BE?|LU?)-?)?([1-9]\d{3})$/.exec(text);
+    if (!match)
+        return null;
+    return `${match[1]?.charAt(0) ?? ''}${match[2]}`;
+}

package/dist/core/catalog/types.d.ts

@@ -11,7 +11,7 @@ import type { CarrierId } from '../../generated/catalog.js';
 import type { DetectionConfidence } from '../detection/types.js';
 export type CarrierTrackingMode = 'automatic' | 'link-only';
 export type CarrierInputField = 'trackingUrl' | 'postcode';
-export type CarrierInputValidator = 'planzerSharedUrl' | 'dachserCapabilityUrl' | 'swissPostcode' | 'francePostcode' | 'germanyPostcode' | 'swissOrFrancePostcode' | 'internationalPostcode' | 'paackPostcode';
+export type CarrierInputValidator = 'planzerSharedUrl' | 'dachserCapabilityUrl' | 'swissPostcode' | 'francePostcode' | 'germanyPostcode' | 'swissOrFrancePostcode' | 'internationalPostcode' | 'paackPostcode' | 'colisPrivePostcode';
 /** What the "add a parcel" forms render for a carrier that needs extra input. */
 export interface CarrierInputRequirement {
     field: CarrierInputField;

package/dist/data/catalog.json

@@ -1312,6 +1312,21 @@
         "tracking": {
             "mode": "automatic",
             "adapter": "colis-prive",
+            "requirements": [
+                {
+                    "field": "postcode",
+                    "whenTrackingNumber": "^[A-Z0-9]{12}$",
+                    "validator": "colisPrivePostcode",
+                    "label": "Delivery postcode",
+                    "type": "text",
+                    "placeholder": "75001",
+                    "help": "Colis Privé needs the recipient postcode with the 12-character number: 5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg.",
+                    "pattern": "^(?:(?:0[1-9]|[1-8][0-9]|9[0-578])[0-9]{3}|(?:(?:[Bb][Ee]?|[Ll][Uu]?)[ \\-]?)?[1-9][0-9]{3})$",
+                    "maxLength": 7,
+                    "inputMode": "text",
+                    "autoComplete": "postal-code"
+                }
+            ],
             "recognitionRank": 30
         },
         "canaryUrl": "https://colisprive.com/moncolis/pages/DetailColis.aspx",

package/dist/generated/catalog.d.ts

@@ -840,6 +840,19 @@ export declare const CARRIER_CATALOG: {
         readonly tracking: {
             readonly mode: "automatic";
             readonly adapter: "colis-prive";
+            readonly requirements: readonly [{
+                readonly field: "postcode";
+                readonly whenTrackingNumber: "^[A-Z0-9]{12}$";
+                readonly validator: "colisPrivePostcode";
+                readonly label: "Delivery postcode";
+                readonly type: "text";
+                readonly placeholder: "75001";
+                readonly help: "Colis Privé needs the recipient postcode with the 12-character number: 5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg.";
+                readonly pattern: "^(?:(?:0[1-9]|[1-8][0-9]|9[0-578])[0-9]{3}|(?:(?:[Bb][Ee]?|[Ll][Uu]?)[ \\-]?)?[1-9][0-9]{3})$";
+                readonly maxLength: 7;
+                readonly inputMode: "text";
+                readonly autoComplete: "postal-code";
+            }];
             readonly recognitionRank: 30;
         };
         readonly canaryUrl: "https://colisprive.com/moncolis/pages/DetailColis.aspx";

package/dist/generated/catalog.js

@@ -1313,6 +1313,21 @@ export const CARRIER_CATALOG = {
         "tracking": {
             "mode": "automatic",
             "adapter": "colis-prive",
+            "requirements": [
+                {
+                    "field": "postcode",
+                    "whenTrackingNumber": "^[A-Z0-9]{12}$",
+                    "validator": "colisPrivePostcode",
+                    "label": "Delivery postcode",
+                    "type": "text",
+                    "placeholder": "75001",
+                    "help": "Colis Privé needs the recipient postcode with the 12-character number: 5 digits in France, 4 in Belgium, or L and 4 digits in Luxembourg.",
+                    "pattern": "^(?:(?:0[1-9]|[1-8][0-9]|9[0-578])[0-9]{3}|(?:(?:[Bb][Ee]?|[Ll][Uu]?)[ \\-]?)?[1-9][0-9]{3})$",
+                    "maxLength": 7,
+                    "inputMode": "text",
+                    "autoComplete": "postal-code"
+                }
+            ],
             "recognitionRank": 30
         },
         "canaryUrl": "https://colisprive.com/moncolis/pages/DetailColis.aspx",

package/dist/server/openapi.json

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

package/package.json

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