universal-parcel-scraper 0.3.1-main.313 → 0.3.3-main.315

package/README.md

@@ -15,7 +15,7 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
 <!-- GENERATED:summary -->
 **3,500+ carriers** through **85 dedicated adapters** and **5 universal fallbacks**
 
-<sub>105 carriers in the catalog · 58 countries represented</sub>
+<sub>105 catalog entries · 58 countries represented</sub>
 <!-- /GENERATED:summary -->
 
 [Try it](#try-it) · [Ways to run it](#ways-to-run-it) · [Benchmark](#benchmark) · [Carriers](carriers/) · [Add a carrier](CONTRIBUTING.md)
@@ -33,9 +33,9 @@ its own as a command, a Node library or an HTTP server.
 ## Benchmark
 
 <!-- GENERATED:coverage -->
-Benchmarked against 100 popular carriers, it returns tracking history for **70**. The best single aggregator returns 50.
+In a curated benchmark of 100 carriers, dedicated adapters return tracking history for **62**, rising to **75** with all fallbacks enabled. The best single aggregator returns 52.
 
-<img src="docs/assets/coverage.svg" alt="Carriers with tracking history: This project, all fallbacks enabled 70, This project, dedicated adapters alone 51, ParcelsApp 50, Postal Ninja 41, 17TRACK 40, Ship24 38, UPU 11." width="760">
+<img src="docs/assets/coverage.svg" alt="Carriers with tracking history: This project, all fallbacks enabled 75, This project, dedicated adapters alone 62, ParcelsApp 52, Postal Ninja 43, 17TRACK 40, Ship24 41, UPU 12." width="760">
 <!-- /GENERATED:coverage -->
 
 [Method and results per carrier](providers/COVERAGE.md)

package/data/catalog.json

@@ -998,6 +998,10 @@
         "pattern": "^[68][A-Z]\\d{11}$",
         "confidence": "high"
       },
+      {
+        "pattern": "^870\\d{11,12}$",
+        "confidence": "high"
+      },
       {
         "pattern": "^[A-Z0-9]{2}\\d{11}$",
         "confidence": "low"

package/data/coverage-summary.json

@@ -4,14 +4,14 @@
   "countries": 58,
   "referenceCarriers": 100,
   "comparison": {
-    "combined": 70,
-    "direct": 51,
+    "combined": 75,
+    "direct": 62,
     "providers": {
-      "ParcelsApp": 50,
-      "Postal Ninja": 41,
+      "ParcelsApp": 52,
+      "Postal Ninja": 43,
       "17TRACK": 40,
-      "Ship24": 38,
-      "UPU": 11
+      "Ship24": 41,
+      "UPU": 12
     }
   }
 }

package/data/detection-golden.json

@@ -2677,40 +2677,26 @@
   },
   {
     "input": "87000918244878",
-    "carrier": "unknown",
-    "confidence": "low",
+    "carrier": "la-poste",
+    "confidence": "high",
     "candidates": [
-      "dpd",
-      "ciblex",
-      "hermes-de",
-      "seur",
-      "brt",
-      "delhivery"
-    ],
-    "asked": [
-      "dpd",
-      "seur",
-      "brt",
-      "hermes-de",
-      "ciblex"
+      "la-poste"
     ]
   },
   {
     "input": "87000918635108",
-    "carrier": "unknown",
-    "confidence": "low",
+    "carrier": "la-poste",
+    "confidence": "high",
     "candidates": [
-      "dpd",
-      "ciblex",
-      "seur",
-      "brt",
-      "delhivery"
-    ],
-    "asked": [
-      "dpd",
-      "seur",
-      "brt",
-      "ciblex"
+      "la-poste"
+    ]
+  },
+  {
+    "input": "870012345678901",
+    "carrier": "la-poste",
+    "confidence": "high",
+    "candidates": [
+      "la-poste"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -832,6 +832,10 @@ var ue = {
 				pattern: "^[68][A-Z]\\d{11}$",
 				confidence: "high"
 			},
+			{
+				pattern: "^870\\d{11,12}$",
+				confidence: "high"
+			},
 			{
 				pattern: "^[A-Z0-9]{2}\\d{11}$",
 				confidence: "low"
@@ -8107,20 +8111,36 @@ var fs = { carriers: [
 	{
 		carrier: "bpost",
 		direct: "Yes",
-		sample: "No history; alternate ✓ 11",
-		references: [{ results: {
-			Ship24: "no_history",
-			ParcelsApp: "postcode_prompt",
-			"17TRACK": "no_history",
-			"Postal Ninja": "no_history",
-			UPU: "n/a"
-		} }, {
-			note: "An S10 item through Landmark Global",
-			results: {
-				ParcelsApp: 20,
-				"17TRACK": 14
+		sample: "✓ 11",
+		references: [
+			{
+				note: "A domestic parcel",
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: "postcode_prompt",
+					"17TRACK": "no_history",
+					"Postal Ninja": "no_history",
+					UPU: "n/a"
+				}
+			},
+			{
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: "postcode_prompt",
+					"17TRACK": "no_history",
+					"Postal Ninja": "no_history",
+					UPU: "n/a"
+				},
+				note: "Another comparison reference"
+			},
+			{
+				note: "An S10 item through Landmark Global",
+				results: {
+					ParcelsApp: 20,
+					"17TRACK": 14
+				}
 			}
-		}]
+		]
 	},
 	{
 		carrier: "austrian-post",
@@ -8167,25 +8187,41 @@ var fs = { carriers: [
 	{
 		carrier: "aramex",
 		direct: "Yes",
-		sample: "No history; alternate ✓ 26",
-		references: [{ results: {
-			Ship24: "no_history",
-			ParcelsApp: "no_history",
-			"17TRACK": "no_history",
-			"Postal Ninja": {
-				rows: 16,
-				partial: "undated rows"
+		sample: "✓ 16",
+		references: [
+			{
+				note: "A domestic shipment",
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: "no_history",
+					"17TRACK": "no_history",
+					"Postal Ninja": 16,
+					UPU: "n/a"
+				}
 			},
-			UPU: "n/a"
-		} }, {
-			note: "An international shipment",
-			results: {
-				Ship24: 26,
-				ParcelsApp: "no_history",
-				"17TRACK": 26,
-				"Postal Ninja": 26
+			{
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: "no_history",
+					"17TRACK": "no_history",
+					"Postal Ninja": {
+						rows: 16,
+						partial: "undated rows"
+					},
+					UPU: "n/a"
+				},
+				note: "Another comparison reference"
+			},
+			{
+				note: "An international shipment",
+				results: {
+					Ship24: 26,
+					ParcelsApp: "no_history",
+					"17TRACK": 26,
+					"Postal Ninja": 26
+				}
 			}
-		}]
+		]
 	},
 	{
 		carrier: "yunexpress",
@@ -8313,14 +8349,26 @@ var fs = { carriers: [
 	{
 		carrier: "correios-br",
 		direct: "Yes (local OCR)",
-		sample: "No history; alternate ✓ 14",
-		references: [{ results: {
-			Ship24: 8,
-			ParcelsApp: "no_history",
-			"17TRACK": 8,
-			"Postal Ninja": 8,
-			UPU: "no_history"
-		} }]
+		sample: "✓ 8",
+		references: [{
+			note: "A Brazilian postal item",
+			results: {
+				Ship24: 8,
+				ParcelsApp: "no_history",
+				"17TRACK": 8,
+				"Postal Ninja": "error",
+				UPU: "no_history"
+			}
+		}, {
+			results: {
+				Ship24: 8,
+				ParcelsApp: "no_history",
+				"17TRACK": 8,
+				"Postal Ninja": 8,
+				UPU: "no_history"
+			},
+			note: "Another comparison reference"
+		}]
 	},
 	{
 		carrier: "singapore-post",
@@ -8355,23 +8403,39 @@ var fs = { carriers: [
 	{
 		carrier: "korea-post",
 		direct: "Yes (international)",
-		sample: "Domestic unsupported; alternate ✓ 20",
-		references: [{ results: {
-			Ship24: "no_history",
-			ParcelsApp: "no_history",
-			"17TRACK": "no_history",
-			"Postal Ninja": "no_history",
-			UPU: "n/a"
-		} }, {
-			note: "An EMS item",
-			results: {
-				Ship24: "history",
-				ParcelsApp: "history",
-				"17TRACK": "history",
-				"Postal Ninja": "no_history",
-				UPU: "history"
+		sample: "✓ 20",
+		references: [
+			{
+				note: "An EMS item",
+				results: {
+					Ship24: 36,
+					ParcelsApp: 41,
+					"17TRACK": 28,
+					"Postal Ninja": 27,
+					UPU: 1
+				}
+			},
+			{
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: "no_history",
+					"17TRACK": "no_history",
+					"Postal Ninja": "no_history",
+					UPU: "n/a"
+				},
+				note: "Another comparison reference"
+			},
+			{
+				note: "An EMS item",
+				results: {
+					Ship24: "history",
+					ParcelsApp: "history",
+					"17TRACK": "history",
+					"Postal Ninja": "no_history",
+					UPU: "history"
+				}
 			}
-		}]
+		]
 	},
 	{
 		carrier: "planzer",
@@ -8457,14 +8521,26 @@ var fs = { carriers: [
 	{
 		carrier: "delhivery",
 		direct: "Yes",
-		sample: "No history; alternate summary + 1 undated scan",
-		references: [{ results: {
-			Ship24: "no_history",
-			ParcelsApp: "no_history",
-			"17TRACK": "no_history",
-			"Postal Ninja": "no_history",
-			UPU: "n/a"
-		} }]
+		sample: "✓ 2, partial (one undated scan and a status snapshot)",
+		references: [{
+			note: "A domestic parcel",
+			results: {
+				Ship24: "no_history",
+				ParcelsApp: "no_history",
+				"17TRACK": "no_history",
+				"Postal Ninja": "no_history",
+				UPU: "n/a"
+			}
+		}, {
+			results: {
+				Ship24: "no_history",
+				ParcelsApp: "no_history",
+				"17TRACK": "no_history",
+				"Postal Ninja": "no_history",
+				UPU: "n/a"
+			},
+			note: "Another comparison reference"
+		}]
 	},
 	{
 		carrier: "blue-dart",
@@ -8481,14 +8557,26 @@ var fs = { carriers: [
 	{
 		carrier: "dtdc",
 		direct: "Yes",
-		sample: "No history; alternate ✓ 9",
-		references: [{ results: {
-			Ship24: "no_history",
-			ParcelsApp: 35,
-			"17TRACK": "no_history",
-			"Postal Ninja": "refused",
-			UPU: "n/a"
-		} }]
+		sample: "✓ 9",
+		references: [{
+			note: "A domestic parcel",
+			results: {
+				Ship24: "no_history",
+				ParcelsApp: 37,
+				"17TRACK": "no_history",
+				"Postal Ninja": "no_history",
+				UPU: "n/a"
+			}
+		}, {
+			results: {
+				Ship24: "no_history",
+				ParcelsApp: 35,
+				"17TRACK": "no_history",
+				"Postal Ninja": "refused",
+				UPU: "n/a"
+			},
+			note: "Another comparison reference"
+		}]
 	},
 	{
 		carrier: "ninja-van",
@@ -8505,8 +8593,17 @@ var fs = { carriers: [
 	{
 		carrier: "packeta",
 		direct: "Yes",
-		sample: "No history",
+		sample: "✓ 6",
 		references: [{
+			note: "A parcel handed to a delivery partner",
+			results: {
+				Ship24: 11,
+				ParcelsApp: "no_history",
+				"17TRACK": "no_history",
+				"Postal Ninja": 12,
+				UPU: "n/a"
+			}
+		}, {
 			stale: !0,
 			results: {
 				Ship24: "no_history",
@@ -8514,7 +8611,8 @@ var fs = { carriers: [
 				"17TRACK": "no_history",
 				"Postal Ninja": "no_history",
 				UPU: "n/a"
-			}
+			},
+			note: "Another comparison reference"
 		}]
 	},
 	{
@@ -8538,14 +8636,26 @@ var fs = { carriers: [
 	{
 		carrier: "bring-posten",
 		direct: "Yes",
-		sample: "Not tested; alternate ✓ 3",
-		references: [{ results: {
-			Ship24: 12,
-			ParcelsApp: 15,
-			"17TRACK": 19,
-			"Postal Ninja": 16,
-			UPU: 3
-		} }]
+		sample: "✓ 12",
+		references: [{
+			note: "A Norwegian postal item",
+			results: {
+				Ship24: 12,
+				ParcelsApp: 15,
+				"17TRACK": 19,
+				"Postal Ninja": 16,
+				UPU: 3
+			}
+		}, {
+			results: {
+				Ship24: 12,
+				ParcelsApp: 15,
+				"17TRACK": 19,
+				"Postal Ninja": 16,
+				UPU: 3
+			},
+			note: "Another comparison reference"
+		}]
 	},
 	{
 		carrier: "posti",
@@ -8598,14 +8708,26 @@ var fs = { carriers: [
 	{
 		carrier: "brt",
 		direct: "Yes",
-		sample: "Not tested; alternate ✓ 7",
-		references: [{ results: {
-			Ship24: "no_history",
-			ParcelsApp: 23,
-			"17TRACK": "no_history",
-			"Postal Ninja": 5,
-			UPU: "n/a"
-		} }]
+		sample: "✓ 9",
+		references: [{
+			note: "An international parcel",
+			results: {
+				Ship24: "no_history",
+				ParcelsApp: 23,
+				"17TRACK": "no_history",
+				"Postal Ninja": 5,
+				UPU: "n/a"
+			}
+		}, {
+			results: {
+				Ship24: "no_history",
+				ParcelsApp: 23,
+				"17TRACK": "no_history",
+				"Postal Ninja": 5,
+				UPU: "n/a"
+			},
+			note: "Another comparison reference"
+		}]
 	},
 	{
 		carrier: "seur",
@@ -8634,38 +8756,64 @@ var fs = { carriers: [
 	{
 		carrier: "mrw",
 		direct: "Yes",
-		sample: "Summary only; alternate ✓ 14",
+		sample: "✓ 14",
+		references: [
+			{
+				note: "A delivered parcel",
+				results: {
+					Ship24: 14,
+					ParcelsApp: 14,
+					"17TRACK": "no_history",
+					"Postal Ninja": 14,
+					UPU: "n/a"
+				}
+			},
+			{
+				stale: !0,
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: "no_history",
+					"17TRACK": 1,
+					"Postal Ninja": "no_history",
+					UPU: "n/a"
+				},
+				note: "Another comparison reference"
+			},
+			{
+				note: "A September parcel",
+				results: {
+					Ship24: 14,
+					ParcelsApp: 14,
+					"17TRACK": "no_history",
+					"Postal Ninja": 14
+				}
+			}
+		]
+	},
+	{
+		carrier: "nacex",
+		direct: "Yes",
+		sample: "✓ 13",
 		references: [{
-			stale: !0,
+			note: "An agency/shipment reference",
 			results: {
-				Ship24: "no_history",
-				ParcelsApp: "no_history",
-				"17TRACK": 1,
-				"Postal Ninja": "no_history",
+				Ship24: "refused",
+				ParcelsApp: "refused",
+				"17TRACK": "refused",
+				"Postal Ninja": "refused",
 				UPU: "n/a"
 			}
 		}, {
-			note: "A September parcel",
 			results: {
-				Ship24: 14,
-				ParcelsApp: 14,
-				"17TRACK": "no_history",
-				"Postal Ninja": 14
-			}
+				Ship24: "error",
+				ParcelsApp: "error",
+				"17TRACK": "error",
+				"Postal Ninja": "error",
+				UPU: "n/a"
+			},
+			note: "Another comparison reference"
 		}]
 	},
-	{
-		carrier: "nacex",
-		direct: "Yes",
-		sample: "Not tested; alternate ✓ 14",
-		references: [{ results: {
-			Ship24: "error",
-			ParcelsApp: "error",
-			"17TRACK": "error",
-			"Postal Ninja": "error",
-			UPU: "n/a"
-		} }]
-	},
 	{
 		carrier: "colis-prive",
 		direct: "Yes (postcode)",

package/dist/carriers/la-poste/adapter.js

@@ -70,9 +70,10 @@ export function normalizeLaPosteTrackingNumber(raw) {
     const value = raw.toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
     const domestic = /^[A-Z0-9]{2}\d{11}$/.test(value);
     const international = /^[A-Z]{2}\d{9}[A-Z]{2}$/.test(value);
+    const numericMail = /^\d{14,15}$/.test(value);
     const foreignExpress = /^\d{14}[A-Z]$/.test(value);
-    if (!domestic && !international && !foreignExpress) {
-        throw new InvalidInputError('La Poste', 'La Poste tracking numbers must use a supported 13- or 15-character format');
+    if (!domestic && !international && !numericMail && !foreignExpress) {
+        throw new InvalidInputError('La Poste', 'La Poste tracking numbers must use a supported 13-, 14- or 15-character format');
     }
     return value;
 }

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

@@ -72,6 +72,11 @@
       "pattern": "^[68][A-Z]\\d{11}$",
       "confidence": "high"
     },
+    {
+      "id": "la-poste-4",
+      "pattern": "^870\\d{11,12}$",
+      "confidence": "high"
+    },
     {
       "id": "la-poste-2",
       "pattern": "^[A-Z0-9]{2}\\d{11}$",

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

@@ -35,18 +35,10 @@
         "url": "https://marketplace.fnacdarty.com/s/article/Dois-je-obligatoirement-renseigner-un-num%C3%A9ro-de-suivi-tracking-pour-ma-commande?language=fr_BE"
       },
       "expect": {
-        "carrier": "unknown",
-        "confidence": "low",
-        "candidates": [
-          "dpd",
-          "ciblex",
-          "hermes-de",
-          "seur",
-          "brt",
-          "delhivery"
-        ]
+        "carrier": "la-poste",
+        "confidence": "high"
       },
-      "note": "Published integration example, not a real shipment. The source attributes it to La Poste / Colissimo, which no rule claims."
+      "note": "Published integration example, not a real shipment."
     },
     {
       "number": "87000918635108",
@@ -56,17 +48,10 @@
         "url": "https://marketplace.fnacdarty.com/s/article/Dois-je-obligatoirement-renseigner-un-num%C3%A9ro-de-suivi-tracking-pour-ma-commande?language=fr_BE"
       },
       "expect": {
-        "carrier": "unknown",
-        "confidence": "low",
-        "candidates": [
-          "dpd",
-          "ciblex",
-          "seur",
-          "brt",
-          "delhivery"
-        ]
+        "carrier": "la-poste",
+        "confidence": "high"
       },
-      "note": "Published integration example, not a real shipment. The source attributes it to La Poste / Colissimo, which no rule claims."
+      "note": "Published integration example, not a real shipment."
     },
     {
       "number": "88000019255788Y",
@@ -135,6 +120,18 @@
         "confidence": "high"
       },
       "note": "Made-up number that follows the published format."
+    },
+    {
+      "number": "870012345678901",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-10-04",
+      "expect": {
+        "carrier": "la-poste",
+        "confidence": "high"
+      },
+      "note": "Made-up numeric tracked-mail identifier; La Poste documents fifteen-character tracked mail."
     }
   ]
 }

package/dist/carriers/packeta/adapter.js

@@ -59,11 +59,13 @@ export function parsePacketaTrackingResponse(payload, trackingNumber) {
             throw new NotFoundError('Packeta');
         throw new SchemaError('Packeta', 'Packeta returned an invalid tracking response');
     }
-    const returned = clean(item.barcode, 64).toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
+    const returned = typeof item.barcode === 'string'
+        ? item.barcode.toLocaleUpperCase('en-US').replace(/[\s.-]/g, '') : '';
     if (!returned)
         throw new SchemaError('Packeta', 'Packeta did not return a shipment identifier');
-    if (returned !== requested)
+    if (returned !== requested && returned !== requested.slice(1)) {
         throw new SchemaError('Packeta', 'Packeta returned a different shipment');
+    }
     const code = clean(item.packetStatusId, 16);
     const classified = classifyPacketaStatus(code);
     const rawDetails = item.trackingDetails;

package/dist/data/catalog.json

@@ -998,6 +998,10 @@
                 "pattern": "^[68][A-Z]\\d{11}$",
                 "confidence": "high"
             },
+            {
+                "pattern": "^870\\d{11,12}$",
+                "confidence": "high"
+            },
             {
                 "pattern": "^[A-Z0-9]{2}\\d{11}$",
                 "confidence": "low"

package/dist/generated/catalog.d.ts

@@ -611,6 +611,9 @@ export declare const CARRIER_CATALOG: {
         readonly detectionRules: readonly [{
             readonly pattern: "^[68][A-Z]\\d{11}$";
             readonly confidence: "high";
+        }, {
+            readonly pattern: "^870\\d{11,12}$";
+            readonly confidence: "high";
         }, {
             readonly pattern: "^[A-Z0-9]{2}\\d{11}$";
             readonly confidence: "low";

package/dist/generated/catalog.js

@@ -999,6 +999,10 @@ export const CARRIER_CATALOG = {
                 "pattern": "^[68][A-Z]\\d{11}$",
                 "confidence": "high"
             },
+            {
+                "pattern": "^870\\d{11,12}$",
+                "confidence": "high"
+            },
             {
                 "pattern": "^[A-Z0-9]{2}\\d{11}$",
                 "confidence": "low"

package/dist/providers/coverage.json

@@ -531,9 +531,10 @@
     {
       "carrier": "bpost",
       "direct": "Yes",
-      "sample": "No history; alternate ✓ 11",
+      "sample": "✓ 11",
       "references": [
         {
+          "note": "A domestic parcel",
           "results": {
             "Ship24": "no_history",
             "ParcelsApp": "postcode_prompt",
@@ -542,6 +543,16 @@
             "UPU": "n/a"
           }
         },
+        {
+          "results": {
+            "Ship24": "no_history",
+            "ParcelsApp": "postcode_prompt",
+            "17TRACK": "no_history",
+            "Postal Ninja": "no_history",
+            "UPU": "n/a"
+          },
+          "note": "Another comparison reference"
+        },
         {
           "note": "An S10 item through Landmark Global",
           "results": {
@@ -608,8 +619,18 @@
     {
       "carrier": "aramex",
       "direct": "Yes",
-      "sample": "No history; alternate ✓ 26",
+      "sample": "✓ 16",
       "references": [
+        {
+          "note": "A domestic shipment",
+          "results": {
+            "Ship24": "no_history",
+            "ParcelsApp": "no_history",
+            "17TRACK": "no_history",
+            "Postal Ninja": 16,
+            "UPU": "n/a"
+          }
+        },
         {
           "results": {
             "Ship24": "no_history",
@@ -620,7 +641,8 @@
               "partial": "undated rows"
             },
             "UPU": "n/a"
-          }
+          },
+          "note": "Another comparison reference"
         },
         {
           "note": "An international shipment",
@@ -799,16 +821,27 @@
     {
       "carrier": "correios-br",
       "direct": "Yes (local OCR)",
-      "sample": "No history; alternate ✓ 14",
+      "sample": "✓ 8",
       "references": [
         {
+          "note": "A Brazilian postal item",
           "results": {
             "Ship24": 8,
             "ParcelsApp": "no_history",
             "17TRACK": 8,
-            "Postal Ninja": 8,
+            "Postal Ninja": "error",
             "UPU": "no_history"
           }
+        },
+        {
+          "results": {
+            "Ship24": 8,
+            "ParcelsApp": "no_history",
+            "17TRACK": 8,
+            "Postal Ninja": 8,
+            "UPU": "no_history"
+          },
+          "note": "Another comparison reference"
         }
       ]
     },
@@ -853,8 +886,18 @@
     {
       "carrier": "korea-post",
       "direct": "Yes (international)",
-      "sample": "Domestic unsupported; alternate ✓ 20",
+      "sample": "✓ 20",
       "references": [
+        {
+          "note": "An EMS item",
+          "results": {
+            "Ship24": 36,
+            "ParcelsApp": 41,
+            "17TRACK": 28,
+            "Postal Ninja": 27,
+            "UPU": 1
+          }
+        },
         {
           "results": {
             "Ship24": "no_history",
@@ -862,7 +905,8 @@
             "17TRACK": "no_history",
             "Postal Ninja": "no_history",
             "UPU": "n/a"
-          }
+          },
+          "note": "Another comparison reference"
         },
         {
           "note": "An EMS item",
@@ -982,9 +1026,10 @@
     {
       "carrier": "delhivery",
       "direct": "Yes",
-      "sample": "No history; alternate summary + 1 undated scan",
+      "sample": "✓ 2, partial (one undated scan and a status snapshot)",
       "references": [
         {
+          "note": "A domestic parcel",
           "results": {
             "Ship24": "no_history",
             "ParcelsApp": "no_history",
@@ -992,6 +1037,16 @@
             "Postal Ninja": "no_history",
             "UPU": "n/a"
           }
+        },
+        {
+          "results": {
+            "Ship24": "no_history",
+            "ParcelsApp": "no_history",
+            "17TRACK": "no_history",
+            "Postal Ninja": "no_history",
+            "UPU": "n/a"
+          },
+          "note": "Another comparison reference"
         }
       ]
     },
@@ -1014,8 +1069,18 @@
     {
       "carrier": "dtdc",
       "direct": "Yes",
-      "sample": "No history; alternate ✓ 9",
+      "sample": "✓ 9",
       "references": [
+        {
+          "note": "A domestic parcel",
+          "results": {
+            "Ship24": "no_history",
+            "ParcelsApp": 37,
+            "17TRACK": "no_history",
+            "Postal Ninja": "no_history",
+            "UPU": "n/a"
+          }
+        },
         {
           "results": {
             "Ship24": "no_history",
@@ -1023,7 +1088,8 @@
             "17TRACK": "no_history",
             "Postal Ninja": "refused",
             "UPU": "n/a"
-          }
+          },
+          "note": "Another comparison reference"
         }
       ]
     },
@@ -1046,8 +1112,18 @@
     {
       "carrier": "packeta",
       "direct": "Yes",
-      "sample": "No history",
+      "sample": "✓ 6",
       "references": [
+        {
+          "note": "A parcel handed to a delivery partner",
+          "results": {
+            "Ship24": 11,
+            "ParcelsApp": "no_history",
+            "17TRACK": "no_history",
+            "Postal Ninja": 12,
+            "UPU": "n/a"
+          }
+        },
         {
           "stale": true,
           "results": {
@@ -1056,7 +1132,8 @@
             "17TRACK": "no_history",
             "Postal Ninja": "no_history",
             "UPU": "n/a"
-          }
+          },
+          "note": "Another comparison reference"
         }
       ]
     },
@@ -1086,9 +1163,10 @@
     {
       "carrier": "bring-posten",
       "direct": "Yes",
-      "sample": "Not tested; alternate ✓ 3",
+      "sample": "✓ 12",
       "references": [
         {
+          "note": "A Norwegian postal item",
           "results": {
             "Ship24": 12,
             "ParcelsApp": 15,
@@ -1096,6 +1174,16 @@
             "Postal Ninja": 16,
             "UPU": 3
           }
+        },
+        {
+          "results": {
+            "Ship24": 12,
+            "ParcelsApp": 15,
+            "17TRACK": 19,
+            "Postal Ninja": 16,
+            "UPU": 3
+          },
+          "note": "Another comparison reference"
         }
       ]
     },
@@ -1166,9 +1254,10 @@
     {
       "carrier": "brt",
       "direct": "Yes",
-      "sample": "Not tested; alternate ✓ 7",
+      "sample": "✓ 9",
       "references": [
         {
+          "note": "An international parcel",
           "results": {
             "Ship24": "no_history",
             "ParcelsApp": 23,
@@ -1176,6 +1265,16 @@
             "Postal Ninja": 5,
             "UPU": "n/a"
           }
+        },
+        {
+          "results": {
+            "Ship24": "no_history",
+            "ParcelsApp": 23,
+            "17TRACK": "no_history",
+            "Postal Ninja": 5,
+            "UPU": "n/a"
+          },
+          "note": "Another comparison reference"
         }
       ]
     },
@@ -1214,8 +1313,18 @@
     {
       "carrier": "mrw",
       "direct": "Yes",
-      "sample": "Summary only; alternate ✓ 14",
+      "sample": "✓ 14",
       "references": [
+        {
+          "note": "A delivered parcel",
+          "results": {
+            "Ship24": 14,
+            "ParcelsApp": 14,
+            "17TRACK": "no_history",
+            "Postal Ninja": 14,
+            "UPU": "n/a"
+          }
+        },
         {
           "stale": true,
           "results": {
@@ -1224,7 +1333,8 @@
             "17TRACK": 1,
             "Postal Ninja": "no_history",
             "UPU": "n/a"
-          }
+          },
+          "note": "Another comparison reference"
         },
         {
           "note": "A September parcel",
@@ -1240,8 +1350,18 @@
     {
       "carrier": "nacex",
       "direct": "Yes",
-      "sample": "Not tested; alternate ✓ 14",
+      "sample": "✓ 13",
       "references": [
+        {
+          "note": "An agency/shipment reference",
+          "results": {
+            "Ship24": "refused",
+            "ParcelsApp": "refused",
+            "17TRACK": "refused",
+            "Postal Ninja": "refused",
+            "UPU": "n/a"
+          }
+        },
         {
           "results": {
             "Ship24": "error",
@@ -1249,7 +1369,8 @@
             "17TRACK": "error",
             "Postal Ninja": "error",
             "UPU": "n/a"
-          }
+          },
+          "note": "Another comparison reference"
         }
       ]
     },

package/dist/server/openapi.json

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

package/package.json

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