universal-parcel-scraper 0.684.1-main.3243 → 0.684.2-main.3246

package/data/catalog.json

@@ -1153,6 +1153,8 @@
           "autoComplete": "postal-code"
         }
       ],
+      "recognitionRank": 894,
+      "recognitionPattern": "^FV\\d{8}$",
       "browser": true
     },
     "canaryUrl": "https://www.mondialrelay.fr/suivi-de-colis/",
@@ -1180,6 +1182,10 @@
       {
         "pattern": "^(?:\\d{8}|\\d{10}|\\d{12})$",
         "confidence": "low"
+      },
+      {
+        "pattern": "^FV\\d{8}$",
+        "confidence": "low"
       }
     ]
   },

package/data/detection-golden.json

@@ -73983,6 +73983,19 @@
       "fleetoptics"
     ]
   },
+  {
+    "input": "FV00000001",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "mondial-relay",
+      "tnt-it"
+    ],
+    "asked": [
+      "mondial-relay",
+      "tnt-it"
+    ]
+  },
   {
     "input": "FVGL9999999999",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -1210,6 +1210,8 @@ var Ze = {
 				inputMode: "text",
 				autoComplete: "postal-code"
 			}],
+			recognitionRank: 894,
+			recognitionPattern: "^FV\\d{8}$",
 			browser: !0
 		},
 		canaryUrl: "https://www.mondialrelay.fr/suivi-de-colis/",
@@ -1224,14 +1226,21 @@ var Ze = {
 				"trackingNumber"
 			]
 		}],
-		detectionRules: [{
-			pattern: "^[0-9]{26}$",
-			confidence: "high",
-			checksum: "mondial-relay"
-		}, {
-			pattern: "^(?:\\d{8}|\\d{10}|\\d{12})$",
-			confidence: "low"
-		}]
+		detectionRules: [
+			{
+				pattern: "^[0-9]{26}$",
+				confidence: "high",
+				checksum: "mondial-relay"
+			},
+			{
+				pattern: "^(?:\\d{8}|\\d{10}|\\d{12})$",
+				confidence: "low"
+			},
+			{
+				pattern: "^FV\\d{8}$",
+				confidence: "low"
+			}
+		]
 	},
 	"relais-colis": {
 		displayName: "Relais Colis",
@@ -24455,7 +24464,11 @@ var Ze = {
 		"dpd-fr-3",
 		"dpd-fr-2"
 	],
-	"mondial-relay": ["mondial-relay-1", "mondial-relay-2"],
+	"mondial-relay": [
+		"mondial-relay-1",
+		"mondial-relay-2",
+		"mondial-relay-3"
+	],
 	"relais-colis": [
 		"relais-colis-1",
 		"relais-colis-2",
@@ -31345,6 +31358,7 @@ var Ul = {
 	"metropolitan-warehouse": 8,
 	"micro-express": 697,
 	"mng-kargo": 360,
+	"mondial-relay": 894,
 	"mongol-infinity-post": 681,
 	"morning-global": 682,
 	mtscn: 986,

package/dist/carriers/mondial-relay/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type AdapterFactory, type Recognition, type TrackingContext } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 import { type StepRecorder } from '../../core/telemetry/index.js';
 import { type TrawlClient } from '../../core/transport/index.js';
@@ -41,6 +41,11 @@ export declare class MondialRelayTracker {
     readonly directTimeoutMs: number;
     constructor(options?: MondialRelayTrackerOptions);
     fetch(rawShipment: string, rawPostcode?: string, context?: TrackingContext): Promise<CarrierResult>;
+    /**
+     * Only InPost Spain's own numbers are recognized: its page answers each one alone and a number it
+     * does not hold is not found. Mondial Relay's own numbers need a browser or an account.
+     */
+    recognize(rawShipment: string, context?: TrackingContext): Promise<Recognition>;
 }
 export declare const adapter: AdapterFactory;
 export {};

package/dist/carriers/mondial-relay/adapter.js

@@ -1,5 +1,6 @@
 import { load } from 'cheerio';
 import { DateTime } from 'luxon';
+import { recognizeFromLookup } from '../../core/adapter/index.js';
 import { DELIVERY_POSTCODE, deliveryPostcodeText } from '../../core/catalog/postcode.js';
 import { isValidMondialRelayBarcode } from '../../core/detection/index.js';
 import { ChallengeError, InputRequiredError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
@@ -364,6 +365,14 @@ export class MondialRelayTracker {
         // same solved browser identity, and the app's access token is renewed once.
         return takeTurn(this.#serialize, 'Mondial Relay', context, (left) => this.#lookup(normalizeMondialRelayCredential(rawShipment, rawPostcode), left));
     }
+    /**
+     * Only InPost Spain's own numbers are recognized: its page answers each one alone and a number it
+     * does not hold is not found. Mondial Relay's own numbers need a browser or an account.
+     */
+    recognize(rawShipment, context = {}) {
+        const inpost = inpostSpainNumber(rawShipment);
+        return recognizeFromLookup(() => this.#inpostSpain(inpost, context), () => inpost !== null);
+    }
     async #lookup(credential, context) {
         // Cloudflare blocks every non-browser client of the website with an HTTP
         // 403 WAF block (verified from multiple networks, 2026-09-10). The app's
@@ -458,5 +467,6 @@ export const adapter = (environment) => {
         // InPost Spain's own numbers are read from its page, retried once when it cannot be reached.
         steps: ['app', 'trawl', 'inpost-es', 'retry'],
         track: (input, context) => tracker.fetch(input.number, input.postcode ?? '', context),
+        recognize: (number, context) => tracker.recognize(number, context),
     };
 };

package/dist/carriers/mondial-relay/carrier.json

@@ -43,6 +43,10 @@
       "inpost-es",
       "retry"
     ],
+    "recognition": {
+      "rank": 894,
+      "pattern": "^FV\\d{8}$"
+    },
     "browser": true
   },
   "capabilities": [
@@ -106,6 +110,11 @@
       "id": "mondial-relay-2",
       "pattern": "^(?:\\d{8}|\\d{10}|\\d{12})$",
       "confidence": "low"
+    },
+    {
+      "id": "mondial-relay-3",
+      "pattern": "^FV\\d{8}$",
+      "confidence": "low"
     }
   ]
 }

package/dist/carriers/mondial-relay/numbers.json

@@ -1124,6 +1124,22 @@
         "confidence": "high"
       },
       "note": "An archived tracking link with a 26-digit label barcode whose check digits pass. Mondial Relay's tracker finds no parcel under it any more."
+    },
+    {
+      "number": "FV00000001",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "donated_real",
+      "shapeConfirmed": "2026-10-23",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "mondial-relay",
+          "tnt-it"
+        ]
+      },
+      "note": "Made-up number in the shape of a parcel the app tracked, which InPost Spain’s own tracking page answered and a universal provider filed under InPost (ES): FV and eight digits."
     }
   ]
 }

package/dist/data/catalog.json

@@ -1153,6 +1153,8 @@
                     "autoComplete": "postal-code"
                 }
             ],
+            "recognitionRank": 894,
+            "recognitionPattern": "^FV\\d{8}$",
             "browser": true
         },
         "canaryUrl": "https://www.mondialrelay.fr/suivi-de-colis/",
@@ -1180,6 +1182,10 @@
             {
                 "pattern": "^(?:\\d{8}|\\d{10}|\\d{12})$",
                 "confidence": "low"
+            },
+            {
+                "pattern": "^FV\\d{8}$",
+                "confidence": "low"
             }
         ]
     },

package/dist/generated/catalog.d.ts

@@ -745,6 +745,8 @@ export declare const CARRIER_CATALOG: {
                 readonly inputMode: "text";
                 readonly autoComplete: "postal-code";
             }];
+            readonly recognitionRank: 894;
+            readonly recognitionPattern: "^FV\\d{8}$";
             readonly browser: true;
         };
         readonly canaryUrl: "https://www.mondialrelay.fr/suivi-de-colis/";
@@ -761,6 +763,9 @@ export declare const CARRIER_CATALOG: {
         }, {
             readonly pattern: "^(?:\\d{8}|\\d{10}|\\d{12})$";
             readonly confidence: "low";
+        }, {
+            readonly pattern: "^FV\\d{8}$";
+            readonly confidence: "low";
         }];
     };
     readonly "relais-colis": {

package/dist/generated/catalog.js

@@ -1154,6 +1154,8 @@ export const CARRIER_CATALOG = {
                     "autoComplete": "postal-code"
                 }
             ],
+            "recognitionRank": 894,
+            "recognitionPattern": "^FV\\d{8}$",
             "browser": true
         },
         "canaryUrl": "https://www.mondialrelay.fr/suivi-de-colis/",
@@ -1181,6 +1183,10 @@ export const CARRIER_CATALOG = {
             {
                 "pattern": "^(?:\\d{8}|\\d{10}|\\d{12})$",
                 "confidence": "low"
+            },
+            {
+                "pattern": "^FV\\d{8}$",
+                "confidence": "low"
             }
         ]
     },
@@ -33082,7 +33088,7 @@ export const DETECTION_RULE_IDS = {
     "gls-ch": ["gls-ch-1", "gls-ch-2", "gls-ch-3", "gls-ch-4"],
     "dpd": ["dpd-2", "dpd-1", "dpd-3"],
     "dpd-fr": ["dpd-fr-1", "dpd-fr-4", "dpd-fr-3", "dpd-fr-2"],
-    "mondial-relay": ["mondial-relay-1", "mondial-relay-2"],
+    "mondial-relay": ["mondial-relay-1", "mondial-relay-2", "mondial-relay-3"],
     "relais-colis": ["relais-colis-1", "relais-colis-2", "relais-colis-3"],
     "la-poste": ["la-poste-1", "la-poste-4", "la-poste-5", "la-poste-6", "la-poste-7", "la-poste-2", "la-poste-3"],
     "chronopost": ["chronopost-1", "chronopost-own-suffix", "chronopost-2", "chronopost-3", "chronopost-4"],

package/dist/generated/recognition.js

@@ -273,6 +273,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "metropolitan-warehouse": 8,
     "micro-express": 697,
     "mng-kargo": 360,
+    "mondial-relay": 894,
     "mongol-infinity-post": 681,
     "morning-global": 682,
     "mtscn": 986,

package/dist/server/openapi.json

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

package/package.json

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