universal-parcel-scraper 0.77.0-main.937 → 0.78.0-main.939

package/README.md

@@ -13,7 +13,7 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
 [![License: Apache-2.0](https://img.shields.io/badge/core-Apache--2.0-blue.svg)](LICENSE)
 
 <!-- GENERATED:summary -->
-**3,500+ carriers** through **134 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **135 dedicated adapters** and **5 universal fallbacks**
 
 <sub>207 catalog entries · 66 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,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 3,732 such statuses, each filed under one stage.
+The carrier folders record 3,852 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

@@ -7194,7 +7194,8 @@
     "timezone": "Europe/Tallinn",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "omniva",
+      "recognitionRank": 64
     },
     "canaryUrl": "https://minu.omniva.ee/track",
     "trackingUrlTemplate": "https://minu.omniva.ee/track/{trackingNumber}",
@@ -7230,6 +7231,12 @@
       {
         "pattern": "^JJEE[A-Z]{3}\\d{11}$",
         "confidence": "high"
+      },
+      {
+        "pattern": "^[A-Z]{2}\\d{9}EE$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
       }
     ]
   },

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 207,
-  "activeAdapters": 134,
+  "activeAdapters": 135,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -25371,6 +25371,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -25382,6 +25383,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -25599,6 +25601,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -25634,6 +25637,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -25653,6 +25657,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -25683,6 +25688,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -26573,6 +26579,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -26724,6 +26731,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -30508,6 +30516,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -32984,6 +32993,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33006,6 +33016,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33017,6 +33028,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33424,6 +33436,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33435,6 +33448,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33446,6 +33460,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33457,6 +33472,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },
@@ -33468,6 +33484,7 @@
       "intl-post"
     ],
     "asked": [
+      "omniva",
       "chronopost"
     ]
   },

package/dist/browser/scraper.js

@@ -5715,7 +5715,8 @@ var ye = {
 		timezone: "Europe/Tallinn",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "omniva",
+			recognitionRank: 64
 		},
 		canaryUrl: "https://minu.omniva.ee/track",
 		trackingUrlTemplate: "https://minu.omniva.ee/track/{trackingNumber}",
@@ -5735,13 +5736,22 @@ var ye = {
 			pathPattern: "^/(?:era/jalgimine|abi/jalgimine|verslo/siuntos_sekimas)/?$",
 			params: ["barcode"]
 		}],
-		detectionRules: [{
-			pattern: "^JJEE\\d{17}$",
-			confidence: "high"
-		}, {
-			pattern: "^JJEE[A-Z]{3}\\d{11}$",
-			confidence: "high"
-		}]
+		detectionRules: [
+			{
+				pattern: "^JJEE\\d{17}$",
+				confidence: "high"
+			},
+			{
+				pattern: "^JJEE[A-Z]{3}\\d{11}$",
+				confidence: "high"
+			},
+			{
+				pattern: "^[A-Z]{2}\\d{9}EE$",
+				confidence: "low",
+				checksum: "s10",
+				preferred: !0
+			}
+		]
 	},
 	"orlen-paczka": {
 		displayName: "ORLEN Paczka",
@@ -6976,7 +6986,11 @@ var ye = {
 	nationex: [],
 	"nova-poshta": ["nova-poshta-domestic"],
 	omgo: ["omgo-1"],
-	omniva: ["omniva-1", "omniva-2"],
+	omniva: [
+		"omniva-1",
+		"omniva-2",
+		"omniva-s10"
+	],
 	"orlen-paczka": ["orlen-paczka-1"],
 	"osm-worldwide": ["osm-worldwide-1"],
 	paquetexpress: [],
@@ -11738,6 +11752,7 @@ var _c = {
 	"ninja-van": 28,
 	"nz-post": 32,
 	omgo: 1,
+	omniva: 64,
 	ontrac: 21,
 	"orlen-paczka": 49,
 	"poczta-polska": 31,

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

@@ -0,0 +1,14 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+export declare const OMNIVA_ENDPOINT = "https://mobile-be.omniva.ee/api/v2/shipment/trackSingleShipment/";
+export declare class OmnivaTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/omniva/adapter.js

@@ -0,0 +1,60 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
+import { normalizeOmnivaNumber, OMNIVA_MAX_BYTES, parseOmniva, PROVIDER } from './parser.js';
+// The guest lookup of Omniva's app. The web trackers' own API wants a
+// Turnstile token; this one answers without a key, cookie or token.
+export const OMNIVA_ENDPOINT = 'https://mobile-be.omniva.ee/api/v2/shipment/trackSingleShipment/';
+// A Cloudflare challenge, or the application gateway's own 403 page.
+const BLOCKED = /<title>\s*(?:Just a moment|Attention Required|403 Forbidden)|cf-chl-|challenge-platform|cf-turnstile|Application-Gateway/i;
+export class OmnivaTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeOmnivaNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            let bytes;
+            try {
+                ({ bytes } = await fetchBounded(OMNIVA_ENDPOINT + encodeURIComponent(number), { signal,
+                    headers: { Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: OMNIVA_MAX_BYTES, fetcher: this.options.fetcher }));
+            }
+            catch (error) {
+                // An unknown number is an empty object; a missing route is not a missing item.
+                if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
+                    throw new TransportError(PROVIDER, 'Omniva tracking endpoint is unavailable', { cause: error });
+                }
+                throw error;
+            }
+            let payload;
+            try {
+                payload = parseJsonBytes(bytes, PROVIDER);
+            }
+            catch (cause) {
+                if (BLOCKED.test(decodeText(bytes.subarray(0, 64_000))))
+                    throw new ChallengeError(PROVIDER, 'Omniva answered with a block page', { cause });
+                throw new SchemaError(PROVIDER, 'Omniva returned invalid tracking JSON', { cause });
+            }
+            return parseOmniva(payload, number);
+        };
+        // A request that fails to reach Omniva, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'omniva', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => read(signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => read(signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new OmnivaTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'omniva', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeOmnivaNumber(number))),
+    };
+};

package/dist/carriers/omniva/carrier.json

@@ -19,18 +19,54 @@
   "timezone": "Europe/Tallinn",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "omniva",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 64
+    }
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "delivered_at",
+    "pickup_point",
+    "destination_country"
+  ],
   "portal": {
     "url": "https://minu.omniva.ee/track/{trackingNumber}",
     "searchUrl": "https://minu.omniva.ee/track",
     "canaryUrl": "https://minu.omniva.ee/track",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "delivered_at",
+      "pickup_point"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "delivered_at",
+      "pickup_point",
+      "destination_country"
+    ],
+    "discarded": [
+      "postcodes",
+      "event_details"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {
@@ -65,6 +101,13 @@
       "id": "omniva-2",
       "pattern": "^JJEE[A-Z]{3}\\d{11}$",
       "confidence": "high"
+    },
+    {
+      "id": "omniva-s10",
+      "pattern": "^[A-Z]{2}\\d{9}EE$",
+      "confidence": "low",
+      "preferred": true,
+      "checksum": "s10"
     }
   ]
 }

package/dist/carriers/omniva/numbers.json

@@ -133,7 +133,7 @@
         "carrier": "unknown",
         "confidence": "none"
       },
-      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows; the capture was not opened. Omniva documents no layout of ten characters starting ZA."
+      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows, and an archived reply of the tracker's API holds its history. Omniva documents no layout of ten characters starting ZA, so no rule claims it."
     },
     {
       "number": "CE213390194EE",
@@ -165,13 +165,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "intl-post",
         "confidence": "high"
       },
-      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows. Omniva's tracking service answers for it; detection selects the generic postal carrier."
     },
     {
       "number": "LL002789060EE",
@@ -184,13 +184,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "intl-post",
         "confidence": "high"
       },
-      "note": "Looked up on Omniva's own Latvian tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Omniva's own Latvian tracker, as an archived address shows. Omniva's tracking service answers for it; detection selects the generic postal carrier."
     },
     {
       "number": "CC404213205EE",
@@ -203,13 +203,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "intl-post",
         "confidence": "high"
       },
-      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows. Omniva's tracking service answers for it; detection selects the generic postal carrier."
     },
     {
       "number": "JJEE51086300000202035",
@@ -222,13 +222,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "omniva",
         "confidence": "high"
       },
-      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows; the capture was not opened."
+      "note": "Looked up on Omniva's own Lithuanian tracker, as an archived address shows. Omniva's tracking service returns its history."
     }
   ]
 }

package/dist/carriers/omniva/parser.d.ts

@@ -0,0 +1,15 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Omniva";
+export declare const OMNIVA_MAX_BYTES = 512000;
+/**
+ * Omniva tracks UPU S10 items, its own and those from other posts, and its
+ * parcel ids: JJEE and seventeen digits, or JJEE, three letters and eleven
+ * digits. Its Lithuanian tracker also answered ZA and eight digits.
+ */
+export declare function normalizeOmnivaNumber(raw: string): string;
+/**
+ * The tracking service's reply for one number: its scans in no set order,
+ * each with an event code, English wording and a UTC clock, and the item's
+ * state. A number it does not know comes back as an empty object.
+ */
+export declare function parseOmniva(payload: unknown, rawNumber: string): CarrierResult;

package/dist/carriers/omniva/parser.js

@@ -0,0 +1,149 @@
+import { isValidS10TrackingNumber, normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { lastMovement } from '../../core/result/pickup.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { countryCode, explicitOffsetTime } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { isOmnivaNotice, omnivaEventStage, omnivaState, RETURN_CANCELLED, RETURN_STARTS } from './status.js';
+export const PROVIDER = 'Omniva';
+// A long history is a few tens of kilobytes.
+export const OMNIVA_MAX_BYTES = 512_000;
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+const CODE = /^[A-Z][A-Z0-9_]{1,79}$/;
+/**
+ * Omniva tracks UPU S10 items, its own and those from other posts, and its
+ * parcel ids: JJEE and seventeen digits, or JJEE, three letters and eleven
+ * digits. Its Lithuanian tracker also answered ZA and eight digits.
+ */
+export function normalizeOmnivaNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (/^JJEE(?:\d{17}|[A-Z]{3}\d{11})$/.test(number) || /^ZA\d{8}$/.test(number) || isValidS10TrackingNumber(number))
+        return number;
+    throw new InvalidInputError(PROVIDER, 'Omniva tracks S10 item codes and its JJEE parcel ids');
+}
+// Omniva's own and its partners' sites, by their service point type. Other
+// types are a sender's or recipient's address or a home letterbox.
+const PLACES = new Set(['PARCEL_MACHINE', 'POST_OFFICE', 'POST_STATION', 'PICK_UP_POINT', 'PARTNER_PICK_UP_POINT', 'PARCEL_BOX',
+    'DISTRIBUTION_POINT', 'LOGISTIC_CENTER', 'WORKSTATION', 'IMPC', 'WAREHOUSE', 'SUPPORT_POINT']);
+// The sites a recipient collects an item from.
+const PICKUP = new Set(['PARCEL_MACHINE', 'POST_OFFICE', 'POST_STATION', 'PICK_UP_POINT', 'PARTNER_PICK_UP_POINT', 'PARCEL_BOX']);
+/** A site's English name, else its own, as the trackers show it. Postcodes are left out. */
+function placeOf(value) {
+    if (!isRecord(value))
+        return null;
+    const type = clean(value.servicePointTypeCode, 64);
+    if (!PLACES.has(type))
+        return null;
+    const english = isRecord(value.translations) && isRecord(value.translations.en) ? clean(value.translations.en.name, 160) : '';
+    const name = english || clean(value.locationName, 160);
+    // A sorting workstation can carry an internal code, such as IPS_GENERAL, for a name.
+    return name && !/^[A-Z0-9]+(?:_[A-Z0-9]+)+$/.test(name) ? { name, type } : null;
+}
+/**
+ * The tracking service's reply for one number: its scans in no set order,
+ * each with an event code, English wording and a UTC clock, and the item's
+ * state. A number it does not know comes back as an empty object.
+ */
+export function parseOmniva(payload, rawNumber) {
+    const number = normalizeOmnivaNumber(rawNumber);
+    if (!isRecord(payload))
+        throw new SchemaError(PROVIDER, 'Omniva did not return a shipment');
+    if (!Object.keys(payload).length)
+        throw new NotFoundError(PROVIDER);
+    if (typeof payload.shipmentBarcode !== 'string' || payload.shipmentBarcode.trim().toUpperCase() !== number) {
+        throw new SchemaError(PROVIDER, 'Omniva answered for a different shipment');
+    }
+    const rows = payload.events ?? [];
+    if (!Array.isArray(rows) || rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Omniva returned an invalid shipment history');
+    const stateCode = clean(payload.currentStateCode, 80);
+    if (stateCode && !CODE.test(stateCode))
+        throw new SchemaError(PROVIDER, 'Omniva returned an invalid shipment state');
+    const scans = [];
+    const seen = new Set();
+    rows.forEach((row, index) => {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'Omniva returned an invalid scan');
+        const code = clean(row.eventCode, 80);
+        const at = explicitOffsetTime(row.eventDate);
+        if (!CODE.test(code) || !at)
+            throw new SchemaError(PROVIDER, 'Omniva returned a scan without a code or clock');
+        const place = placeOf(row.location);
+        const event = { time: at.iso, description: clean(row.eventName, 300) || code, provider_code: code,
+            ...(place ? { location: place.name } : {}) };
+        const identity = JSON.stringify(event);
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        scans.push({ event, at: at.timestamp, code, place, index });
+    });
+    // Newest first; scans at the same instant follow the reply's order, reversed.
+    scans.sort((left, right) => right.at - left.at || right.index - left.index);
+    // Oldest first: a notice keeps the stage of the scan before it, and a
+    // delivery on a return reaches the sender. The reply flags a return even
+    // when its history no longer holds the scan that started it.
+    const returnFlag = payload.returningShipment === true;
+    let returning = returnFlag && !scans.some(scan => RETURN_STARTS.has(scan.code));
+    let previous;
+    for (const scan of [...scans].reverse()) {
+        if (RETURN_STARTS.has(scan.code))
+            returning = true;
+        else if (scan.code === RETURN_CANCELLED)
+            returning = false;
+        if (isOmnivaNotice(scan.code)) {
+            if (previous)
+                Object.assign(scan.event, { stage: previous, stage_source: 'none' });
+            continue;
+        }
+        const mapped = omnivaEventStage(scan.code);
+        const stage = mapped === 'delivered' && returning ? 'returned' : mapped;
+        if (stage)
+            Object.assign(scan.event, { stage, stage_source: 'carrier_map' });
+        previous = stage;
+    }
+    const events = scans.map(scan => scan.event);
+    const state = stateCode ? omnivaState(stateCode) : undefined;
+    // The trackers headline the state. A delivered state on a return is the sender's collection.
+    const stateStage = state?.stage === 'delivered' && returnFlag ? 'returned' : state?.stage;
+    const decider = scans.find(scan => !isOmnivaNotice(scan.code)) ?? scans[0];
+    if (!decider && !stateCode)
+        throw new IndeterminateError(PROVIDER, 'Omniva returned a shipment without a state or scans');
+    const stage = decider?.event.stage ?? stateStage;
+    const fromState = Boolean(stage) && !decider?.event.stage;
+    // The site an item waits at is its pickup point; a delivered item was
+    // collected there when it was delivered at one, or waited there last. The
+    // recipient's chosen site stands in while the scan names none. A return's
+    // site is the sender's.
+    const deliveryPlace = placeOf(payload.deliveryLocation);
+    let point = '';
+    if (!returning && !returnFlag) {
+        if (stage === 'ready_for_pickup') {
+            point = (decider?.place && PICKUP.has(decider.place.type) ? decider.place : deliveryPlace && PICKUP.has(deliveryPlace.type) ? deliveryPlace : null)?.name ?? '';
+        }
+        else if (stage === 'delivered' && decider) {
+            const earlier = scans.slice(scans.indexOf(decider) + 1);
+            const waited = lastMovement(earlier.map(scan => scan.event)) === 'ready_for_pickup'
+                ? earlier.find(scan => scan.event.stage === 'ready_for_pickup' && !isOmnivaNotice(scan.code))?.place : null;
+            point = [decider.place, waited].find(place => place && PICKUP.has(place.type))?.name ?? '';
+        }
+    }
+    const destination = isRecord(payload.deliveryLocation) ? countryCode(payload.deliveryLocation.countryCode) : null;
+    const delivered = stage === 'delivered' && decider?.event.stage === 'delivered' ? decider.event.time : undefined;
+    // An old item's history keeps only its delivery.
+    const trimmed = events.length > 0 && events.every(event => event.stage === 'delivered' || event.stage === 'returned');
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: fromState ? 'carrier_map' : decider.event.stage_source } : {}),
+        last_status_text: decider?.event.description ?? state?.wording ?? stateCode,
+        ...(events.length ? {} : { provider_code: stateCode, summary_only: true }),
+        last_update: events[0]?.time ?? null,
+        expected_delivery: null,
+        ...(delivered ? { delivered_at: delivered } : {}),
+        ...(point ? { pickup_point: point } : {}),
+        ...(destination ? { destination_country: destination } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS || trimmed ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/omniva/status.d.ts

@@ -0,0 +1,15 @@
+import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** Scans that start a return: a delivery after one reaches the sender. */
+export declare const RETURN_STARTS: ReadonlySet<string>;
+/** The scan that calls a return off. */
+export declare const RETURN_CANCELLED = "TRT_SHIPMENT_RETURN_CANCELLED";
+export declare function omnivaEventStage(code: string): Stage | undefined;
+export declare function isOmnivaNotice(code: string): boolean;
+/** The English wording and stage of an item's state, if the map knows it. */
+export declare function omnivaState(code: string): {
+    wording: string;
+    stage: Stage;
+} | undefined;
+/** Event codes and state codes do not overlap: events carry a TRT or CARGO prefix. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/omniva/status.js

@@ -0,0 +1,164 @@
+// Omniva names each scan with an event code from its trackers' dictionary and
+// words it in English. TRT codes are its own network's, with the UPU EDI
+// events of a cross-border item under their UPU letters; CARGO codes come from
+// its freight partners.
+const EVENTS = {
+    TRT_SHIPMENT_REGISTERED: 'registered',
+    TRT_SHIPMENT_REGISTERED_IN_OMNIVA: 'registered',
+    TRT_SHIPMENT_HANDOVER_TO_PM: 'accepted',
+    TRT_SHIPMENT_HANDOVER_TO_PO: 'accepted',
+    TRT_SHIPMENT_PICKED_UP_BY_COURIER: 'accepted',
+    TRT_SHIPMENT_EMA: 'accepted',
+    TRT_SHIPMENT_DEPARTED_FROM_PM: 'in_transit',
+    TRT_SHIPMENT_ARRIVED_TO_PO: 'in_transit',
+    TRT_SHIPMENT_SORTED: 'in_transit',
+    TRT_SHIPMENT_REDIRECTION: 'in_transit',
+    TRT_SHIPMENT_MOVEMENT_RESTORED: 'in_transit',
+    // The return is called off and the item goes on to its recipient.
+    TRT_SHIPMENT_RETURN_CANCELLED: 'in_transit',
+    TRT_SHIPMENT_RELEASED_FROM_CUSTOMS: 'in_transit',
+    TRT_SHIPMENT_EMB: 'in_transit',
+    TRT_SHIPMENT_EMC: 'in_transit',
+    TRT_SHIPMENT_EMD: 'in_transit',
+    TRT_SHIPMENT_EMF: 'in_transit',
+    TRT_SHIPMENT_EMG: 'in_transit',
+    TRT_SHIPMENT_EMJ: 'in_transit',
+    TRT_SHIPMENT_EDC: 'in_transit',
+    TRT_SHIPMENT_EDD: 'in_transit',
+    TRT_SHIPMENT_EDE: 'in_transit',
+    CARGO_SHIPMENT_ARRIVED_TO_TRANSIT_HUB: 'in_transit',
+    CARGO_SHIPMENT_DEPARTED_FROM_TRANSIT_HUB: 'in_transit',
+    CARGO_SHIPMENT_IN_TRANSIT_TO_DESTINATION_COUNTRY: 'in_transit',
+    CARGO_SHIPMENT_ARRIVING_TO_DESTINATION_COUNTRY: 'in_transit',
+    CARGO_SHIPMENT_ARRIVED_TO_DESTINATION_COUNTRY: 'in_transit',
+    CARGO_SHIPMENT_ARRIVED_TO_CUSTOMS_CLEARANCE_HUB: 'in_transit',
+    CARGO_SHIPMENT_RELEASED_FROM_CUSTOMS: 'in_transit',
+    CARGO_SHIPMENT_HANDOVER_FROM_LINEHAUL_EVENT: 'in_transit',
+    CARGO_SHIPMENT_HANDED_TO_LAST_MILE: 'in_transit',
+    CARGO_SHIPMENT_ARRIVED_TO_SORTING: 'in_transit',
+    CARGO_SHIPMENT_DEPARTED_FROM_SORTING: 'in_transit',
+    CARGO_SHIPMENT_ARRIVED_TO_LAST_DELIVERY_OFFICE: 'in_transit',
+    CARGO_SHIPMENT_DEPARTED_FROM_RETURNING_COUNTRY: 'in_transit',
+    CARGO_SHIPMENT_ARRIVED_TO_RETURNING_COUNTRY_HUB: 'in_transit',
+    TRT_SHIPMENT_TAKEN_TO_CUSTOMS: 'customs',
+    TRT_SHIPMENT_HELD_IN_CUSTOMS: 'customs',
+    TRT_SHIPMENT_ASSIGN_CUSTOMS_INSPECTION: 'customs',
+    // An item from outside the EU waits at customs for its recipient's
+    // declaration or payment; these notices ask for them.
+    TRT_SHIPMENT_ARRIVAL_CUSTOMS_NOTIFICATION: 'customs',
+    TRT_SHIPMENT_CD_REMINDER_NOTIFICATION: 'customs',
+    TRT_SHIPMENT_CD_ADD_PAYMENT_NOTIFICATION: 'customs',
+    TRT_SHIPMENT_CD_ADD_PAYMENT_REMINDER_NOTIFICATION: 'customs',
+    TRT_SHIPMENT_CUSTOMS_PAYMENT_REQ_REMINDER: 'customs',
+    TRT_SHIPMENT_EDB: 'customs',
+    TRT_SHIPMENT_EME: 'customs',
+    CARGO_SHIPMENT_PRESENTED_TO_CUSTOMS: 'customs',
+    CARGO_SHIPMENT_HELD_IN_CUSTOMS: 'customs',
+    TRT_SHIPMENT_COURIER_DELIVERY_STARTED: 'out_for_delivery',
+    TRT_SHIPMENT_EDG: 'out_for_delivery',
+    CARGO_SHIPMENT_OUT_FOR_DELIVERY: 'out_for_delivery',
+    TRT_SHIPMENT_FAILED_DELIVERY_ATTEMPT: 'failed_attempt',
+    TRT_SHIPMENT_EMH: 'failed_attempt',
+    CARGO_SHIPMENT_DELIVERY_FAILED: 'failed_attempt',
+    TRT_SHIPMENT_STORED_IN_PM: 'ready_for_pickup',
+    TRT_SHIPMENT_ARRIVED_TO_FINAL_PO: 'ready_for_pickup',
+    TRT_SHIPMENT_EDH: 'ready_for_pickup',
+    TRT_SHIPMENT_DELIVERED: 'delivered',
+    TRT_SHIPMENT_EMI: 'delivered',
+    CARGO_SHIPMENT_DELIVERED: 'delivered',
+    CARGO_SHIPMENT_RETURNED: 'returned',
+    // A return under way: the item is not delivered and not back yet.
+    TRT_SHIPMENT_RETURN: 'exception',
+    CARGO_SHIPMENT_POSTED_IN_RETURNING_COUNTRY: 'exception',
+    TRT_SHIPMENT_CANCELLED: 'exception',
+    TRT_SHIPMENT_MOVEMENT_STOPPED: 'exception',
+    TRT_SHIPMENT_MISSING_IN_PM: 'exception',
+    TRT_SHIPMENT_PREDECLARED_MISSING: 'exception',
+    TRT_SHIPMENT_PROHIBIT: 'exception',
+    TRT_SHIPMENT_EDX: 'exception',
+    TRT_SHIPMENT_EXX: 'exception',
+    CARGO_SHIPMENT_CANCELLED: 'exception',
+    CARGO_SHIPMENT_DESTROYED: 'exception',
+    CARGO_SHIPMENT_MISSING_IN_PM: 'exception',
+    CARGO_SHIPMENT_NOT_ARRIVED_IN_BAG_EVENT: 'exception',
+};
+/** Scans that start a return: a delivery after one reaches the sender. */
+export const RETURN_STARTS = new Set(['TRT_SHIPMENT_RETURN', 'CARGO_SHIPMENT_POSTED_IN_RETURNING_COUNTRY']);
+/** The scan that calls a return off. */
+export const RETURN_CANCELLED = 'TRT_SHIPMENT_RETURN_CANCELLED';
+// Messages to the recipient and bookkeeping: no movement, so the item keeps its stage.
+const NOTICES = new Map([
+    ['TRT_SHIPMENT_ARRIVAL_PM_NOTIFICATION', 'The recipient is told the item waits in a parcel machine.'],
+    ['TRT_SHIPMENT_ARRIVAL_PO_NOTIFICATION', 'The recipient is told the item waits at a post office.'],
+    ['TRT_SHIPMENT_REMINDER_PM_NOTIFICATION', 'A reminder that the item waits in a parcel machine.'],
+    ['TRT_SHIPMENT_REMINDER_PO_NOTIFICATION', 'A reminder that the item waits at a post office.'],
+    ['TRT_SHIPMENT_RECIPIENT_NOTIFICATION_EVENT', 'A message to the recipient.'],
+    ['TRT_COURIER_PRE_DELIVERY_RECIPIENT_NOTIFICATION', 'The recipient is told the courier is coming.'],
+    ['TRT_COURIER_CALLED_TO_RECEIVER', 'The courier contacted the recipient about the delivery.'],
+    ['TRT_SHIPMENT_RECIPIENT_CONTACT_UPDATED', 'The recipient\'s contact details changed.'],
+    ['TRT_SHIPMENT_DELIVERY_PARTNER_BARCODE_ASSIGNED', 'A delivery partner\'s number was attached to the item.'],
+    ['CARGO_SHIPMENT_DELIVERY_PARTNER_BARCODE_ASSIGNED', 'A delivery partner\'s number was attached to the item.'],
+    ['TRT_SHIPMENT_MEASURED', 'The item was measured.'],
+]);
+// Codes whose meaning for the delivery is unclear, left without a stage.
+const UNSTAGED = new Map([
+    ['TRT_SHIPMENT_EDA', 'Held at the inward office of exchange, for customs or for another reason the event does not give.'],
+    ['TRT_SHIPMENT_EDF', 'Held at the delivery depot, for a reason the event does not give.'],
+    ['TRT_SHIPMENT_DOC_RETURN_SENDER', 'A document about the item went back to the sender, not the item itself.'],
+    ['TRT_SHIPMENT_RETURNED_BY_CUSTOMER', 'A customer return sent through Omniva; no reply showed where it stands in the delivery.'],
+    ['TRT_SHIPMENT_COURIER_DELIVERY_CANCELLED', 'The courier round was called off; the event does not say what happens next.'],
+    ['TRT_SHIPMENT_DECLARATION_CANCELLED', 'A customs declaration was withdrawn; the item may still be held or move on.'],
+    ['CARGO_SHIPMENT_DELIVERED_TO_RETURNS_CENTER', 'Reached a returns centre, which may end a customer return or start one to the sender.'],
+    ['CARGO_SHIPMENT_WAITING_FOR_PAYMENT', 'Waits for a payment the event does not name, such as duties or a delivery charge.'],
+    ['CARGO_SHIPMENT_ARRIVED_TO_LAST_PICKUP_POINT', 'Either waiting for the recipient or reaching the last hub before delivery; no reply showed which.'],
+]);
+/**
+ * The item's state, which Omniva's trackers show as the headline. The trackers
+ * know seven; the dictionary lists the older ones too.
+ */
+const STATES = new Map([
+    ['REGISTERED', { wording: 'Registered', stage: 'registered' }],
+    ['REGISTERED_IN_OMNIVA', { wording: 'Shipment registered', stage: 'registered' }],
+    ['IPS_POSTED_EMA', { wording: 'Item is posted by the sender/collected by the Post', stage: 'accepted' }],
+    ['IN_PROGRESS', { wording: 'In progress', stage: 'in_transit' }],
+    ['IN_TRANSIT', { wording: 'Shipment is on the way', stage: 'in_transit' }],
+    ['IN_POST_OFFICE', { wording: 'Shipment is at the postal facility', stage: 'in_transit' }],
+    ['IN_LOGISTIC_CENTER', { wording: 'Shipment is at the sorting centre', stage: 'in_transit' }],
+    ['IPS_DEPARTED_EMC', { wording: 'Departure from sender country', stage: 'in_transit' }],
+    ['IPS_ARRIVED_EMD', { wording: 'Arrived to destination country', stage: 'in_transit' }],
+    ['RELEASED_FROM_CUSTOMS', { wording: 'Released from customs', stage: 'in_transit' }],
+    ['MOVEMENT_RESTORED', { wording: 'Movement restored', stage: 'in_transit' }],
+    ['RETURN_CANCELLED', { wording: 'Return cancelled', stage: 'in_transit' }],
+    ['REDIRECTED', { wording: 'Redirected', stage: 'in_transit' }],
+    ['IN_CUSTOMS', { wording: 'In customs', stage: 'customs' }],
+    ['TAKEN_TO_CUSTOMS', { wording: 'In customs', stage: 'customs' }],
+    ['ON_COURIER_DELIVERY', { wording: 'On your way', stage: 'out_for_delivery' }],
+    ['FAILED_DELIVERY', { wording: 'Failed delivery attempt', stage: 'failed_attempt' }],
+    ['READY_FOR_PICKUP', { wording: 'Ready for pickup', stage: 'ready_for_pickup' }],
+    ['IN_PARCEL_MACHINE', { wording: 'Shipment delivered to the parcel machine', stage: 'ready_for_pickup' }],
+    ['DELIVERED', { wording: 'Delivered', stage: 'delivered' }],
+    ['RETURNED', { wording: 'Returned', stage: 'returned' }],
+    ['CANCELLED', { wording: 'Cancelled', stage: 'exception' }],
+    ['WRITTEN_OFF', { wording: 'Shipment written off', stage: 'exception' }],
+    ['STOPPED', { wording: 'Shipment stopped', stage: 'exception' }],
+    ['MISSING', { wording: 'Shipment missing', stage: 'exception' }],
+    ['LOST', { wording: 'Shipment missing', stage: 'exception' }],
+]);
+export function omnivaEventStage(code) {
+    return Object.hasOwn(EVENTS, code) ? EVENTS[code] : undefined;
+}
+export function isOmnivaNotice(code) {
+    return NOTICES.has(code);
+}
+/** The English wording and stage of an item's state, if the map knows it. */
+export function omnivaState(code) {
+    return STATES.get(code);
+}
+/** Event codes and state codes do not overlap: events carry a TRT or CARGO prefix. */
+export const statusMap = {
+    stage: code => (code ? omnivaEventStage(code) ?? omnivaState(code)?.stage : undefined),
+    gaps: [
+        ...[...NOTICES].map(([code, note]) => ({ code, note: `${note} Not a movement: the item keeps the stage it had.` })),
+        ...[...UNSTAGED].map(([code, note]) => ({ code, note })),
+    ],
+};

package/dist/carriers/omniva/statuses.json

@@ -1,4 +1,125 @@
 {
   "carrier": "omniva",
-  "entries": []
+  "entries": [
+    { "code": "TRT_SHIPMENT_REGISTERED", "wording": "Shipment registered. Shipment has not been handed over to Omniva", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "The sender registered the item; Omniva does not have it yet." },
+    { "code": "TRT_COURIER_CALLED_TO_RECEIVER", "wording": "Courier has reached out to the recipient for delivery", "language": "en", "confirmedBy": "portal", "note": "The courier contacted the recipient about the delivery. Not a movement: the item keeps the stage it had. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_DOC_RETURN_SENDER", "wording": "Shipment document returned to sender", "language": "en", "confirmedBy": "portal", "note": "A document about the item went back to the sender, not the item itself. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_FAILED_DELIVERY_ATTEMPT", "wording": "Delivery attempt made", "language": "en", "stage": "failed_attempt", "confirmedBy": "portal", "note": "The wording reads like a delivery, but the code is a failed attempt. A parameter gives the reason, which the adapter drops. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_PROHIBIT", "wording": "Shipment prohibit", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_ARRIVED_TO_FINAL_PO", "wording": "Shipment is ready for pickup at the post office", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "portal", "note": "Its site names the post office the item waits at. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_ARRIVED_TO_PO", "wording": "Shipment has arrived at a postal facility for further processing", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Its site names the terminal or sorting line, by its English name when it has one." },
+    { "code": "TRT_SHIPMENT_CANCELLED", "wording": "Shipment has been cancelled", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_CUSTOMS_PAYMENT_REQ_REMINDER", "wording": "Shipment customs payment req reminder", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_DECLARATION_CANCELLED", "wording": "Shipment declaration has been cancelled", "language": "en", "confirmedBy": "portal", "note": "A customs declaration was withdrawn; the item may still be held or move on. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_DELIVERED", "wording": "Shipment delivered", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "Its site names the parcel machine or post office the item was collected from. After a return starts, the adapter reads it as returned." },
+    { "code": "TRT_SHIPMENT_HANDOVER_TO_PM", "wording": "Sender has placed the shipment in the parcel machine", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "Its site names the parcel machine the sender used." },
+    { "code": "TRT_SHIPMENT_HANDOVER_TO_PO", "wording": "Shipment has been handed over to the post office for processing", "language": "en", "stage": "accepted", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_HELD_IN_CUSTOMS", "wording": "Shipment held in customs", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_ASSIGN_CUSTOMS_INSPECTION", "wording": "Shipment assign customs inspection", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_PICKED_UP_BY_COURIER", "wording": "The courier has picked up the shipment", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "The courier collected the item from the sender." },
+    { "code": "TRT_SHIPMENT_REDIRECTION", "wording": "Shipment has been redirected to a different location", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_RELEASED_FROM_CUSTOMS", "wording": "Shipment released from the customs and is on the way", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_RETURN", "wording": "Shipment is being returned to the sender", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "A return under way. A delivery after it reaches the sender, so the adapter reads it as returned. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_RETURN_CANCELLED", "wording": "Shipment return has been cancelled", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Ends a return: a delivery after it reaches the recipient. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_STORED_IN_PM", "wording": "Shipment is ready for collection from the parcel machine", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "portal", "note": "Its site names the parcel machine the item waits in. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_TAKEN_TO_CUSTOMS", "wording": "Shipment has been sent for customs clearance", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_SORTED", "wording": "Shipment is sorted", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_ARRIVAL_PM_NOTIFICATION", "wording": "A notification of shipment arrival has been sent", "language": "en", "confirmedBy": "portal", "note": "The recipient is told the item waits in a parcel machine. Not a movement: the item keeps the stage it had. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_ARRIVAL_PO_NOTIFICATION", "wording": "Notification of shipment arrival has been sent", "language": "en", "confirmedBy": "portal", "note": "The recipient is told the item waits at a post office. Not a movement: the item keeps the stage it had. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_REMINDER_PM_NOTIFICATION", "wording": "A notification of shipment arrival has been resent", "language": "en", "confirmedBy": "portal", "note": "A reminder that the item waits in a parcel machine. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_REMINDER_PO_NOTIFICATION", "wording": "A notification of shipment arrival has been resent", "language": "en", "confirmedBy": "portal", "note": "A reminder that the item waits at a post office. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_ARRIVAL_CUSTOMS_NOTIFICATION", "wording": "A notification of shipment arrival to customs has been sent", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Asks the recipient to declare an item held at customs. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_CD_REMINDER_NOTIFICATION", "wording": "Customs notification has been resent", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Asks the recipient again to declare an item held at customs. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_CD_ADD_PAYMENT_NOTIFICATION", "wording": "A notification of additional payment for customs declaration has been sent", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_CD_ADD_PAYMENT_REMINDER_NOTIFICATION", "wording": "Reminder of additional payment for a customs declaration", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_COURIER_DELIVERY_STARTED", "wording": "The shipment has been handed over to the courier", "language": "en", "stage": "out_for_delivery", "confirmedBy": "portal", "note": "The courier set out to deliver the item. Seen in archived replies of the web trackers' API." },
+    { "code": "TRT_SHIPMENT_COURIER_DELIVERY_CANCELLED", "wording": "Courier delivery has been cancelled", "language": "en", "confirmedBy": "portal", "note": "The courier round was called off; the event does not say what happens next. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EDA", "wording": "Held at inward Office of Exchange", "language": "en", "confirmedBy": "portal", "note": "Held at the inward office of exchange, for customs or for another reason the event does not give. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EDB", "wording": "Shipment is under customs review", "language": "en", "stage": "customs", "confirmedBy": "live", "note": "A UPU event from the destination post, without a site." },
+    { "code": "TRT_SHIPMENT_EDC", "wording": "Shipment released from the customs and is moving forward", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EDD", "wording": "Shipment is being processed at sorting center", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EDF", "wording": "Shipment is on hold at the delivery depot", "language": "en", "confirmedBy": "portal", "note": "Held at the delivery depot, for a reason the event does not give. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EDG", "wording": "Shipment is on its way for final delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EDH", "wording": "Shipment is ready for pickup at the post office", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EDX", "wording": "Import process terminated", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EMA", "wording": "Shipment has been posted by the sender or collected by the postal service", "language": "en", "stage": "accepted", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EMB", "wording": "Arrival at outward Office of Exchange", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EMC", "wording": "Shipment is on the way to the destination country", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EMD", "wording": "Arrival to destination country", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EME", "wording": "Shipment is being held by customs for further inspection", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EMF", "wording": "Departure from inward Office of Exchange", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EMG", "wording": "Shipment has reached the postal facility for further sorting", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_EMH", "wording": "Delivery attempt failed", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "note": "A UPU event from the destination post, without a site." },
+    { "code": "TRT_SHIPMENT_EXX", "wording": "Export cancellation", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_TRANSIT_HUB", "wording": "Shipment arrived to transit hub", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DEPARTED_FROM_TRANSIT_HUB", "wording": "Shipment has left the transit hub and is moving forward", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_DESTINATION_COUNTRY", "wording": "Shipment arrived to destination country", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_LAST_PICKUP_POINT", "wording": "Shipment has reached the final pickup location", "language": "en", "confirmedBy": "portal", "note": "Either waiting for the recipient or reaching the last hub before delivery; no reply showed which. Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DELIVERED", "wording": "Shipment has been successfully delivered", "language": "en", "stage": "delivered", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DELIVERY_FAILED", "wording": "Shipment delivery failed", "language": "en", "stage": "failed_attempt", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_LAST_DELIVERY_OFFICE", "wording": "Shipment is in transit and has reached an intermediate hub", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_RETURNED", "wording": "Shipment has been returned to the sender", "language": "en", "stage": "returned", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_PRESENTED_TO_CUSTOMS", "wording": "Shipment is under customs review", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_RELEASED_FROM_CUSTOMS", "wording": "Shipment released from the customs and is on the way", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_HELD_IN_CUSTOMS", "wording": "Shipment held in customs", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_DEPARTED_FROM_PM", "wording": "Shipment departed from parcel machine", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "TRT_SHIPMENT_MOVEMENT_STOPPED", "wording": "Shipment movement stopped", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_MOVEMENT_RESTORED", "wording": "Shipment movement restored", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EMI", "wording": "Shipment delivered", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "A UPU event from the destination post, without a site." },
+    { "code": "CARGO_SHIPMENT_DESTROYED", "wording": "Shipment destroyed", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_RETURNED_BY_CUSTOMER", "wording": "Shipment is being returned via Omniva", "language": "en", "confirmedBy": "portal", "note": "A customer return sent through Omniva; no reply showed where it stands in the delivery. Listed in the trackers' event dictionary." },
+    { "code": "TRT_COURIER_PRE_DELIVERY_RECIPIENT_NOTIFICATION", "wording": "A notification of courier arrival has been sent", "language": "en", "confirmedBy": "portal", "note": "The recipient is told the courier is coming. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_POSTED_IN_RETURNING_COUNTRY", "wording": "Shipment has been processed for return", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "A return under way. A delivery after it reaches the sender. Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DEPARTED_FROM_RETURNING_COUNTRY", "wording": "Shipment has left the return hub and is in transit", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_RETURNING_COUNTRY_HUB", "wording": "Shipment has arrived in the return hub of the sender's country", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_RECIPIENT_CONTACT_UPDATED", "wording": "Recipient contact details updated", "language": "en", "confirmedBy": "portal", "note": "The recipient's contact details changed. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_DELIVERY_PARTNER_BARCODE_ASSIGNED", "wording": "Delivery partner barcode assigned to shipment", "language": "en", "confirmedBy": "portal", "note": "A delivery partner's number was attached to the item. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DELIVERY_PARTNER_BARCODE_ASSIGNED", "wording": "Delivery partner barcode assigned to shipment", "language": "en", "confirmedBy": "portal", "note": "A delivery partner's number was attached to the item. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_MISSING_IN_PM", "wording": "Shipment is missing from the parcel machine, please check with support", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DELIVERED_TO_RETURNS_CENTER", "wording": "Shipment delivered to returns center", "language": "en", "confirmedBy": "portal", "note": "Reached a returns centre, which may end a customer return or start one to the sender. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EMJ", "wording": "Shipment has reached the transit processing center", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_REGISTERED_IN_OMNIVA", "wording": "Shipment registered", "language": "en", "stage": "registered", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_CANCELLED", "wording": "Shipment cancelled", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_WAITING_FOR_PAYMENT", "wording": "Shipment waiting for payment", "language": "en", "confirmedBy": "portal", "note": "Waits for a payment the event does not name, such as duties or a delivery charge. Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_IN_TRANSIT_TO_DESTINATION_COUNTRY", "wording": "Shipment in transit to destination country", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_HANDOVER_FROM_LINEHAUL_EVENT", "wording": "Shipment handover from linehaul", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_RECIPIENT_NOTIFICATION_EVENT", "wording": "Recipient has been notified", "language": "en", "confirmedBy": "portal", "note": "A message to the recipient. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVING_TO_DESTINATION_COUNTRY", "wording": "Shipment arriving to destination country", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_MISSING_IN_PM", "wording": "Shipment missing in the parcel machine", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_NOT_ARRIVED_IN_BAG_EVENT", "wording": "Shipment not arrived in bag", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_CUSTOMS_CLEARANCE_HUB", "wording": "Shipment arrived to custom clearance hub", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_HANDED_TO_LAST_MILE", "wording": "Shipment handed over to last mile", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_PREDECLARED_MISSING", "wording": "Predeclared shipment is missing", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_MEASURED", "wording": "Shipment measured", "language": "en", "confirmedBy": "portal", "note": "The item was measured. Not a movement: the item keeps the stage it had. Listed in the trackers' event dictionary." },
+    { "code": "TRT_SHIPMENT_EDE", "wording": "Item out of sorting centre", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_ARRIVED_TO_SORTING", "wording": "Shipment arrived to sorting hub", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_DEPARTED_FROM_SORTING", "wording": "Shipment departed from sorting hub", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "CARGO_SHIPMENT_OUT_FOR_DELIVERY", "wording": "Shipment out for delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "portal", "note": "Listed in the trackers' event dictionary." },
+    { "code": "REGISTERED", "wording": "Registered", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "The item's state, which the adapter reads when the reply has no scans." },
+    { "code": "IN_TRANSIT", "wording": "Shipment is on the way", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IN_CUSTOMS", "wording": "In customs", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IN_POST_OFFICE", "wording": "Shipment is at the postal facility", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IN_PARCEL_MACHINE", "wording": "Shipment delivered to the parcel machine", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "ON_COURIER_DELIVERY", "wording": "On your way", "language": "en", "stage": "out_for_delivery", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "DELIVERED", "wording": "Delivered", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "The item's state, which the adapter reads when the reply has no scans." },
+    { "code": "CANCELLED", "wording": "Cancelled", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IN_LOGISTIC_CENTER", "wording": "Shipment is at the sorting centre", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "WRITTEN_OFF", "wording": "Shipment written off", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "STOPPED", "wording": "Shipment stopped", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "MISSING", "wording": "Shipment missing", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "LOST", "wording": "Shipment missing", "language": "en", "stage": "exception", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "RETURNED", "wording": "Returned", "language": "en", "stage": "returned", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "REDIRECTED", "wording": "Redirected", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IPS_DEPARTED_EMC", "wording": "Departure from sender country", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IPS_ARRIVED_EMD", "wording": "Arrived to destination country", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "TAKEN_TO_CUSTOMS", "wording": "In customs", "language": "en", "stage": "customs", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "RELEASED_FROM_CUSTOMS", "wording": "Released from customs", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "MOVEMENT_RESTORED", "wording": "Movement restored", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IPS_POSTED_EMA", "wording": "Item is posted by the sender/collected by the Post", "language": "en", "stage": "accepted", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "RETURN_CANCELLED", "wording": "Return cancelled", "language": "en", "stage": "in_transit", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "FAILED_DELIVERY", "wording": "Failed delivery attempt", "language": "en", "stage": "failed_attempt", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "REGISTERED_IN_OMNIVA", "wording": "Shipment registered", "language": "en", "stage": "registered", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Listed in the trackers' state dictionary." },
+    { "code": "IN_PROGRESS", "wording": "In progress", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The item's state, which the adapter reads when the reply has no scans." },
+    { "code": "READY_FOR_PICKUP", "wording": "Ready for pickup", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "portal", "note": "The item's state, which the adapter reads when the reply has no scans. Seen in archived replies of the web trackers' API." }
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -37,6 +37,7 @@ import { statusMap as jntCargo } from '../../carriers/j-and-t-cargo/status.js';
 import { statusMap as laPoste } from '../../carriers/la-poste/status.js';
 import { statusMap as oldDominion } from '../../carriers/old-dominion/status.js';
 import { statusMap as omgo } from '../../carriers/omgo/status.js';
+import { statusMap as omniva } from '../../carriers/omniva/status.js';
 import { statusMap as orlenPaczka } from '../../carriers/orlen-paczka/status.js';
 import { statusMap as postlogistics } from '../../carriers/postlogistics/status.js';
 import { statusMap as ppl } from '../../carriers/ppl/status.js';
@@ -59,8 +60,8 @@ export const STATUS_MAPS = {
     'acs-courier': acsCourier, aliexpress, 'an-post': anPost, 'box-now': boxNow, 'china-post': chinaPost, chronopost, 'correos-spain': correosSpain,
     'dhl-express': dhlExpress, dpd, 'dpd-de': dpdDe, 'dpd-fr': dpdFr, 'dpd-ie': dpdIe, 'dpd-pl': dpdPl, econt, elta, emile, 'fan-courier': fanCourier,
     foxpost, 'geniki-taxydromiki': geniki, 'gls-it': glsIt, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo,
-    'la-poste': laPoste, 'old-dominion': oldDominion, omgo, 'orlen-paczka': orlenPaczka, postlogistics, ppl, sagawa, sameday, speedx, speedy, sto,
-    'swiss-post': swissPost, 'thailand-post': thailandPost, tnt, ups, venipak, yunexpress,
+    'la-poste': laPoste, 'old-dominion': oldDominion, omgo, omniva, 'orlen-paczka': orlenPaczka, postlogistics, ppl, sagawa, sameday, speedx, speedy,
+    sto, 'swiss-post': swissPost, 'thailand-post': thailandPost, tnt, ups, venipak, yunexpress,
 };
 /** The carrier the app files the universal providers' scans under. */
 const UNIVERSAL_CARRIER = 'unknown';

package/dist/data/catalog.json

@@ -7194,7 +7194,8 @@
         "timezone": "Europe/Tallinn",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "omniva",
+            "recognitionRank": 64
         },
         "canaryUrl": "https://minu.omniva.ee/track",
         "trackingUrlTemplate": "https://minu.omniva.ee/track/{trackingNumber}",
@@ -7230,6 +7231,12 @@
             {
                 "pattern": "^JJEE[A-Z]{3}\\d{11}$",
                 "confidence": "high"
+            },
+            {
+                "pattern": "^[A-Z]{2}\\d{9}EE$",
+                "confidence": "low",
+                "checksum": "s10",
+                "preferred": true
             }
         ]
     },

package/dist/generated/catalog.d.ts

@@ -4841,7 +4841,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Tallinn";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "omniva";
+            readonly recognitionRank: 64;
         };
         readonly canaryUrl: "https://minu.omniva.ee/track";
         readonly trackingUrlTemplate: "https://minu.omniva.ee/track/{trackingNumber}";
@@ -4860,6 +4861,11 @@ export declare const CARRIER_CATALOG: {
         }, {
             readonly pattern: "^JJEE[A-Z]{3}\\d{11}$";
             readonly confidence: "high";
+        }, {
+            readonly pattern: "^[A-Z]{2}\\d{9}EE$";
+            readonly confidence: "low";
+            readonly checksum: "s10";
+            readonly preferred: true;
         }];
     };
     readonly "orlen-paczka": {

package/dist/generated/catalog.js

@@ -7195,7 +7195,8 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Tallinn",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "omniva",
+            "recognitionRank": 64
         },
         "canaryUrl": "https://minu.omniva.ee/track",
         "trackingUrlTemplate": "https://minu.omniva.ee/track/{trackingNumber}",
@@ -7231,6 +7232,12 @@ export const CARRIER_CATALOG = {
             {
                 "pattern": "^JJEE[A-Z]{3}\\d{11}$",
                 "confidence": "high"
+            },
+            {
+                "pattern": "^[A-Z]{2}\\d{9}EE$",
+                "confidence": "low",
+                "checksum": "s10",
+                "preferred": true
             }
         ]
     },
@@ -8716,7 +8723,7 @@ export const DETECTION_RULE_IDS = {
     "nationex": [],
     "nova-poshta": ["nova-poshta-domestic"],
     "omgo": ["omgo-1"],
-    "omniva": ["omniva-1", "omniva-2"],
+    "omniva": ["omniva-1", "omniva-2", "omniva-s10"],
     "orlen-paczka": ["orlen-paczka-1"],
     "osm-worldwide": ["osm-worldwide-1"],
     "paquetexpress": [],

package/dist/generated/recognition.js

@@ -48,6 +48,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "ninja-van": 28,
     "nz-post": 32,
     "omgo": 1,
+    "omniva": 64,
     "ontrac": 21,
     "orlen-paczka": 49,
     "poczta-polska": 31,

package/dist/generated/registry.js

@@ -88,6 +88,7 @@ import { adapter as novaPoshta } from '../carriers/nova-poshta/adapter.js';
 import { adapter as nzPost } from '../carriers/nz-post/adapter.js';
 import { adapter as oldDominion } from '../carriers/old-dominion/adapter.js';
 import { adapter as omgo } from '../carriers/omgo/adapter.js';
+import { adapter as omniva } from '../carriers/omniva/adapter.js';
 import { adapter as ontrac } from '../carriers/ontrac/adapter.js';
 import { adapter as orlenPaczka } from '../carriers/orlen-paczka/adapter.js';
 import { adapter as paack } from '../carriers/paack/adapter.js';
@@ -224,6 +225,7 @@ export const REGISTRY = {
         "nz-post": nzPost,
         "old-dominion": oldDominion,
         "omgo": omgo,
+        "omniva": omniva,
         "ontrac": ontrac,
         "orlen-paczka": orlenPaczka,
         "paack": paack,
@@ -404,7 +406,7 @@ export const REGISTRY = {
         "nz-post": "nz-post",
         "old-dominion": "old-dominion",
         "omgo": "omgo",
-        "omniva": "universal",
+        "omniva": "omniva",
         "ontrac": "ontrac",
         "orlen-paczka": "orlen-paczka",
         "osm-worldwide": "universal",

package/dist/server/openapi.json

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

package/package.json

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