universal-parcel-scraper 0.92.0-main.985 → 0.93.0-main.987

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 **150 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **151 dedicated adapters** and **5 universal fallbacks**
 
 <sub>208 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 4,098 such statuses, each filed under one stage.
+The carrier folders record 4,117 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

@@ -6938,7 +6938,9 @@
     "timezone": "Europe/Riga",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "latvijas-pasts",
+      "recognitionRank": 820,
+      "localClocks": true
     },
     "canaryUrl": "https://www.pasts.lv/izsekot-sutijumu",
     "trackingUrlTemplate": "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
@@ -6954,7 +6956,14 @@
         ]
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^[A-Z]{2}\\d{9}LV$",
+        "confidence": "low",
+        "checksum": "s10",
+        "preferred": true
+      }
+    ]
   },
   "lbc-express": {
     "displayName": "LBC Express",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 208,
-  "activeAdapters": 150,
+  "activeAdapters": 151,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -25585,6 +25585,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -25596,6 +25597,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -25607,6 +25609,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -27047,6 +27050,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31655,6 +31659,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31666,6 +31671,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31677,6 +31683,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31688,6 +31695,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31699,6 +31707,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31710,6 +31719,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31721,6 +31731,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31732,6 +31743,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -31743,6 +31755,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -34250,6 +34263,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -35419,6 +35433,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -36887,6 +36902,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },
@@ -37173,6 +37189,7 @@
       "intl-post"
     ],
     "asked": [
+      "latvijas-pasts",
       "chronopost"
     ]
   },

package/dist/browser/scraper.js

@@ -5527,7 +5527,9 @@ var be = {
 		timezone: "Europe/Riga",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "latvijas-pasts",
+			recognitionRank: 820,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.pasts.lv/izsekot-sutijumu",
 		trackingUrlTemplate: "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
@@ -5537,7 +5539,12 @@ var be = {
 			pathPattern: "^/track/?$",
 			params: ["id"]
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^[A-Z]{2}\\d{9}LV$",
+			confidence: "low",
+			checksum: "s10",
+			preferred: !0
+		}]
 	},
 	"lbc-express": {
 		displayName: "LBC Express",
@@ -7143,7 +7150,7 @@ var be = {
 	"j-and-t-cargo": ["j-and-t-cargo-1", "j-and-t-cargo-2"],
 	jitsu: [],
 	"kuehne-nagel": ["kuehne-nagel-1", "kuehne-nagel-2"],
-	"latvijas-pasts": [],
+	"latvijas-pasts": ["latvijas-pasts-s10"],
 	"lbc-express": ["lbc-domestic"],
 	"lietuvos-pastas": ["lietuvos-pastas-1"],
 	"loomis-express": ["loomis-express-1", "loomis-express-2"],
@@ -11937,6 +11944,7 @@ var bc = {
 	"j-and-t": 90,
 	"j-and-t-cargo": 470,
 	"la-poste": 800,
+	"latvijas-pasts": 820,
 	matkahuolto: 690,
 	"mng-kargo": 740,
 	nacex: 410,

package/dist/carriers/latvijas-pasts/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 LATVIJAS_PASTS_ENDPOINT = "https://mans.pasts.lv/tracking-api";
+export declare class LatvijasPastsTracker {
+    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/latvijas-pasts/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 { LATVIJAS_PASTS_MAX_BYTES, normalizeLatvijasPastsNumber, parseLatvijasPasts, PROVIDER } from './parser.js';
+// The service mans.pasts.lv's tracking page reads. It answers JSON only when
+// asked for it, and XML otherwise.
+export const LATVIJAS_PASTS_ENDPOINT = 'https://mans.pasts.lv/tracking-api';
+// A CloudFront or web application firewall block page.
+const BLOCKED = /<title>\s*(?:ERROR: The request could not be satisfied|Request blocked|Access Denied|Just a moment|Attention Required)|cf-chl-|cf-turnstile|Generated by cloudfront/i;
+export class LatvijasPastsTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeLatvijasPastsNumber(raw);
+        const url = `${LATVIJAS_PASTS_ENDPOINT}?${new URLSearchParams({ id: number, lang: 'en-US', include_group: 'true' })}`;
+        const read = async (signal, timeoutMs) => {
+            let bytes;
+            try {
+                ({ bytes } = await fetchBounded(url, { signal, headers: { Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: LATVIJAS_PASTS_MAX_BYTES, fetcher: this.options.fetcher }));
+            }
+            catch (error) {
+                // A missing route is not a missing item: the service answers unknown codes with a notice.
+                if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
+                    throw new TransportError(PROVIDER, 'Latvijas Pasts 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, 'Latvijas Pasts answered with a block page', { cause });
+                throw new SchemaError(PROVIDER, 'Latvijas Pasts returned invalid tracking JSON', { cause });
+            }
+            return parseLatvijasPasts(payload, number);
+        };
+        // A request that fails to reach Latvijas Pasts, or hangs, gets one more
+        // try: the first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'latvijas-pasts', 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 LatvijasPastsTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'latvijas-pasts', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeLatvijasPastsNumber(number))),
+    };
+};

package/dist/carriers/latvijas-pasts/carrier.json

@@ -17,18 +17,48 @@
   "timezone": "Europe/Riga",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "latvijas-pasts",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 820
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "pickup_point"
+  ],
   "portal": {
     "url": "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
     "searchUrl": "https://www.pasts.lv/izsekot-sutijumu",
     "canaryUrl": "https://www.pasts.lv/izsekot-sutijumu",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "event_details"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "pickup_point"
+    ],
+    "discarded": [
+      "event_details"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {
@@ -41,5 +71,13 @@
       ]
     }
   ],
-  "detection": []
+  "detection": [
+    {
+      "id": "latvijas-pasts-s10",
+      "pattern": "^[A-Z]{2}\\d{9}LV$",
+      "confidence": "low",
+      "preferred": true,
+      "checksum": "s10"
+    }
+  ]
 }

package/dist/carriers/latvijas-pasts/parser.d.ts

@@ -0,0 +1,12 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Latvijas Pasts";
+export declare const LATVIJAS_PASTS_MAX_BYTES = 256000;
+/** Latvijas Pasts tracks UPU S10 items, its own and those it delivers for other posts. */
+export declare function normalizeLatvijasPastsNumber(raw: string): string;
+/**
+ * The tracker's reply for one item: its scans newest first, each with an event
+ * code, wording, a wall clock and the office, or the country of a foreign
+ * post's event, or a notice instead. The reply does not repeat the number; it
+ * answers for the one number the request names.
+ */
+export declare function parseLatvijasPasts(payload: unknown, rawNumber: string): CarrierResult;

package/dist/carriers/latvijas-pasts/parser.js

@@ -0,0 +1,121 @@
+import { DateTime } from 'luxon';
+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 { clean, cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { latvijasPastsStage } from './status.js';
+export const PROVIDER = 'Latvijas Pasts';
+// A long history is a few kilobytes.
+export const LATVIJAS_PASTS_MAX_BYTES = 256_000;
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+const CODE = /^\d{1,6}$/;
+const CLOCK = /^(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})(?:\.\d{1,6})?$/;
+// The notices the English tracker gives instead of a history.
+const NOT_FOUND = 'No information received on the tracking of the postal item. Please, try again!';
+const MALFORMED = 'Postal item number entered incorrectly. Please check it and enter it again.';
+// An office without an English name comes back as the company's own name, which places nothing.
+const NO_PLACE = /^(?:latvijas )?pasts$/i;
+// An office's postcode, which the Latvian names carry.
+const POSTCODE = /,?\s*\bLV-?\d{4}\b/gi;
+/** Latvijas Pasts tracks UPU S10 items, its own and those it delivers for other posts. */
+export function normalizeLatvijasPastsNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (isValidS10TrackingNumber(number))
+        return number;
+    throw new InvalidInputError(PROVIDER, 'Latvijas Pasts tracks S10 item codes');
+}
+/** The scan's clock ("2026-03-04 09:15:00.000") as a wall clock. It carries no offset. */
+function wallClock(value) {
+    const match = typeof value === 'string' ? CLOCK.exec(value.trim()) : null;
+    if (!match)
+        return null;
+    // UTC only checks the calendar fields. No offset is assigned.
+    const parsed = DateTime.fromFormat(`${match[1]} ${match[2]}`, 'yyyy-MM-dd HH:mm:ss', { zone: 'UTC' });
+    return parsed.isValid ? parsed.toFormat("yyyy-MM-dd'T'HH:mm:ss") : null;
+}
+/** The office the scan names, else the country a foreign post's event comes from. */
+function placeOf(row) {
+    const office = clean(row.office, 200).replace(POSTCODE, '').trim();
+    if (office)
+        return { name: NO_PLACE.test(office) ? '' : office, office: true };
+    return { name: clean(row.country, 100), office: false };
+}
+/**
+ * The tracker's reply for one item: its scans newest first, each with an event
+ * code, wording, a wall clock and the office, or the country of a foreign
+ * post's event, or a notice instead. The reply does not repeat the number; it
+ * answers for the one number the request names.
+ */
+export function parseLatvijasPasts(payload, rawNumber) {
+    normalizeLatvijasPastsNumber(rawNumber);
+    if (!isRecord(payload))
+        throw new SchemaError(PROVIDER, 'Latvijas Pasts did not return an item');
+    // The tracker shows the history when there is one, else the notice.
+    if (!Object.hasOwn(payload, 'data')) {
+        if (typeof payload.info !== 'string')
+            throw new SchemaError(PROVIDER, 'Latvijas Pasts returned neither a history nor a notice');
+        const notice = clean(payload.info, 300);
+        if (notice === NOT_FOUND)
+            throw new NotFoundError(PROVIDER);
+        if (notice === MALFORMED)
+            throw new InvalidInputError(PROVIDER, 'Latvijas Pasts does not accept this item code');
+        throw new IndeterminateError(PROVIDER, 'Latvijas Pasts returned a notice instead of the item history');
+    }
+    const rows = payload.data;
+    if (!Array.isArray(rows) || rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Latvijas Pasts returned an invalid item history');
+    const scans = [];
+    const seen = new Set();
+    rows.forEach((row, index) => {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'Latvijas Pasts returned an invalid scan');
+        const code = cleanScalar(row.event_code, 16);
+        const time = wallClock(row.event_timestamp);
+        if (!CODE.test(code) || !time)
+            throw new SchemaError(PROVIDER, 'Latvijas Pasts returned a scan without a code or clock');
+        const place = placeOf(row);
+        const event = { local_time: time, description: clean(row.event, 300) || code, provider_code: code,
+            ...(place.name ? { location: place.name } : {}) };
+        // A foreign post's event can come twice.
+        const identity = JSON.stringify(event);
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        const group = Number(row.event_group_sequence_number);
+        scans.push({ event, office: place.office, group: Number.isInteger(group) ? group : 0, index });
+    });
+    if (!scans.length)
+        throw new IndeterminateError(PROVIDER, 'Latvijas Pasts returned no scans');
+    // Newest first. Scans at the same second follow the tracker's progress
+    // groups, from created to delivered, then the reply's order.
+    scans.sort((left, right) => (right.event.local_time > left.event.local_time ? 1
+        : right.event.local_time < left.event.local_time ? -1 : right.group - left.group || left.index - right.index));
+    const events = scans.map(({ event }) => event);
+    for (const event of events) {
+        const classified = latvijasPastsStage(event.provider_code, event.description);
+        if (classified)
+            Object.assign(event, { stage: classified.stage, stage_source: classified.source });
+    }
+    const latest = events[0];
+    const stage = latest.stage;
+    // The Latvian office an item waits at is its pickup point. A delivered item
+    // was collected there when it waited there last before the delivery.
+    const waiting = stage === 'ready_for_pickup' ? scans[0]
+        : stage === 'delivered' && lastMovement(events.slice(1)) === 'ready_for_pickup'
+            ? scans.slice(1).find(scan => scan.event.stage === 'ready_for_pickup') : undefined;
+    const point = waiting?.office ? waiting.event.location ?? '' : '';
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: latest.stage_source } : {}),
+        last_status_text: latest.description,
+        last_update: null,
+        last_update_local: latest.local_time,
+        expected_delivery: null,
+        ...(point ? { pickup_point: point } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/latvijas-pasts/status.d.ts

@@ -0,0 +1,11 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage Latvijas Pasts' event code gives a scan, if the map knows it. */
+export declare function latvijasPastsCodeStage(code: string): Stage | undefined;
+/**
+ * A scan's stage from its code, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export declare function latvijasPastsStage(code: string, wording: string): ClassifiedWording | null;
+/** Every scan carries a code; the map reads the code alone. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/latvijas-pasts/status.js

@@ -0,0 +1,51 @@
+import { classifyWording } from '../../core/status/index.js';
+/**
+ * Latvijas Pasts names each scan with a numeric event code and words it in the
+ * requested language. Its own offices and the foreign posts' events it relays
+ * share one code list. Several codes read as the wrong milestone to the shared
+ * classifier: "Item returned from Customs" is a release, not a return.
+ */
+const EVENTS = {
+    // Electronic data: the item is announced, not yet handed over.
+    1112: 'registered',
+    1114: 'registered',
+    1: 'accepted',
+    78: 'accepted',
+    3: 'in_transit',
+    // Presented to customs at the office of exchange; code 7 is its release.
+    4: 'customs',
+    7: 'in_transit',
+    8: 'in_transit',
+    12: 'in_transit',
+    30: 'in_transit',
+    32: 'in_transit',
+    35: 'in_transit',
+    69: 'in_transit',
+    77: 'in_transit',
+    1113: 'in_transit',
+    1120: 'in_transit',
+    39: 'out_for_delivery',
+    // The delivery office printed the invitation to collect the item there.
+    1134: 'ready_for_pickup',
+    37: 'delivered',
+};
+/** The stage Latvijas Pasts' event code gives a scan, if the map knows it. */
+export function latvijasPastsCodeStage(code) {
+    return Object.hasOwn(EVENTS, code) ? EVENTS[code] : undefined;
+}
+/**
+ * A scan's stage from its code, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export function latvijasPastsStage(code, wording) {
+    const mapped = latvijasPastsCodeStage(code);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** Every scan carries a code; the map reads the code alone. */
+export const statusMap = {
+    stage: code => (code ? latvijasPastsCodeStage(code) : undefined),
+    gaps: [],
+};

package/dist/carriers/latvijas-pasts/statuses.json

@@ -1,4 +1,24 @@
 {
   "carrier": "latvijas-pasts",
-  "entries": []
+  "entries": [
+    { "code": "1112", "wording": "Electronic data about shipment received", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "The sender's data reached Latvijas Pasts, here imported from Mans Pasts; the item is not handed over yet." },
+    { "code": "1114", "wording": "Item information received", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "The sender registered the item; Latvijas Pasts does not have it yet." },
+    { "code": "78", "wording": "Item received from sender", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "Comes before or beside the posting scan when a business sender hands items over." },
+    { "code": "1", "wording": "Item posted / received from customer", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "Also the foreign post's posting scan of an item from abroad." },
+    { "code": "3", "wording": "Item arrived at office of exchange", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The outward office of exchange, in Riga or in the foreign post of an item from abroad." },
+    { "code": "4", "wording": "Item sent to the Customs", "language": "en", "stage": "customs", "confirmedBy": "live", "note": "Presented to export customs at the office of exchange." },
+    { "code": "7", "wording": "Item returned from Customs", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Released by customs. The shared rules would read the wording as a return." },
+    { "code": "8", "wording": "Item sent abroad", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Left the outward office of exchange." },
+    { "code": "12", "wording": "Item sent abroad (EDI-received)", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The foreign post's dispatch of an item from abroad, relayed by its electronic data." },
+    { "code": "30", "wording": "Item arrived at office of exchange", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The inward office of exchange, in Latvia or in the destination country." },
+    { "code": "32", "wording": "Item arrived at processing facility", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "35", "wording": "Item sent to next processing facility", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "77", "wording": "Item sent to next processing facility", "language": "en", "stage": "in_transit", "confirmedBy": "live" },
+    { "code": "69", "wording": "Item awaiting next planned cycle", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Waiting for the next dispatch at the office of exchange." },
+    { "code": "1113", "wording": "Item sent to delivery facility", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The reply also names the delivery office, which the adapter does not read." },
+    { "code": "1120", "wording": "Item received at delivery office", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The item can still go out for delivery from there." },
+    { "code": "39", "wording": "Item handed over for delivery", "language": "en", "stage": "out_for_delivery", "confirmedBy": "live", "note": "Seen from foreign posts' events in the destination country." },
+    { "code": "1134", "wording": "Notification - pick-up invitation printed", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "live", "note": "The delivery office printed the invitation to collect the item there; its office is the pickup point." },
+    { "code": "37", "wording": "Item delivered", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "Also the foreign post's delivery of an item sent abroad." }
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -44,6 +44,7 @@ import { statusMap as hrvatskaPosta } from '../../carriers/hrvatska-posta/status
 import { statusMap as jAndT } from '../../carriers/j-and-t/status.js';
 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 latvijasPasts } from '../../carriers/latvijas-pasts/status.js';
 import { statusMap as matkahuolto } from '../../carriers/matkahuolto/status.js';
 import { statusMap as mngKargo } from '../../carriers/mng-kargo/status.js';
 import { statusMap as oldDominion } from '../../carriers/old-dominion/status.js';
@@ -76,7 +77,8 @@ export const STATUS_MAPS = {
     'ceska-posta': ceskaPosta, '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, 'express-one': expressOne, 'fan-courier': fanCourier, foxpost,
     'geniki-taxydromiki': geniki, 'gls-es': glsEs, 'gls-it': glsIt, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, helthjem,
-    'hrvatska-posta': hrvatskaPosta, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo, 'la-poste': laPoste, matkahuolto, 'mng-kargo': mngKargo, 'old-dominion': oldDominion, omgo, omniva,
+    'hrvatska-posta': hrvatskaPosta, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo, 'la-poste': laPoste, 'latvijas-pasts': latvijasPasts,
+    matkahuolto, 'mng-kargo': mngKargo, 'old-dominion': oldDominion, omgo, omniva,
     'orlen-paczka': orlenPaczka, 'posta-slovenije': postaSlovenije, postlogistics, ppl, ptt, sagawa, sameday, speedx, speedy, sto, 'swiss-post': swissPost, 'thailand-post': thailandPost,
     tnt, ups, venipak, 'vinted-go': vintedGo, yunexpress, 'yurtici-kargo': yurticiKargo,
 };

package/dist/data/catalog.json

@@ -6938,7 +6938,9 @@
         "timezone": "Europe/Riga",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "latvijas-pasts",
+            "recognitionRank": 820,
+            "localClocks": true
         },
         "canaryUrl": "https://www.pasts.lv/izsekot-sutijumu",
         "trackingUrlTemplate": "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
@@ -6954,7 +6956,14 @@
                 ]
             }
         ],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^[A-Z]{2}\\d{9}LV$",
+                "confidence": "low",
+                "checksum": "s10",
+                "preferred": true
+            }
+        ]
     },
     "lbc-express": {
         "displayName": "LBC Express",

package/dist/generated/catalog.d.ts

@@ -4673,7 +4673,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Riga";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "latvijas-pasts";
+            readonly recognitionRank: 820;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.pasts.lv/izsekot-sutijumu";
         readonly trackingUrlTemplate: "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}";
@@ -4683,7 +4685,12 @@ export declare const CARRIER_CATALOG: {
             readonly pathPattern: "^/track/?$";
             readonly params: readonly ["id"];
         }];
-        readonly detectionRules: readonly [];
+        readonly detectionRules: readonly [{
+            readonly pattern: "^[A-Z]{2}\\d{9}LV$";
+            readonly confidence: "low";
+            readonly checksum: "s10";
+            readonly preferred: true;
+        }];
     };
     readonly "lbc-express": {
         readonly displayName: "LBC Express";

package/dist/generated/catalog.js

@@ -6939,7 +6939,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Riga",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "latvijas-pasts",
+            "recognitionRank": 820,
+            "localClocks": true
         },
         "canaryUrl": "https://www.pasts.lv/izsekot-sutijumu",
         "trackingUrlTemplate": "https://mans.pasts.lv/track?locale=lv-LV&id={trackingNumber}",
@@ -6955,7 +6957,14 @@ export const CARRIER_CATALOG = {
                 ]
             }
         ],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^[A-Z]{2}\\d{9}LV$",
+                "confidence": "low",
+                "checksum": "s10",
+                "preferred": true
+            }
+        ]
     },
     "lbc-express": {
         "displayName": "LBC Express",
@@ -8909,7 +8918,7 @@ export const DETECTION_RULE_IDS = {
     "j-and-t-cargo": ["j-and-t-cargo-1", "j-and-t-cargo-2"],
     "jitsu": [],
     "kuehne-nagel": ["kuehne-nagel-1", "kuehne-nagel-2"],
-    "latvijas-pasts": [],
+    "latvijas-pasts": ["latvijas-pasts-s10"],
     "lbc-express": ["lbc-domestic"],
     "lietuvos-pastas": ["lietuvos-pastas-1"],
     "loomis-express": ["loomis-express-1", "loomis-express-2"],

package/dist/generated/recognition.js

@@ -51,6 +51,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "j-and-t": 90,
     "j-and-t-cargo": 470,
     "la-poste": 800,
+    "latvijas-pasts": 820,
     "matkahuolto": 690,
     "mng-kargo": 740,
     "nacex": 410,

package/dist/generated/registry.js

@@ -88,6 +88,7 @@ import { adapter as jdLogistics } from '../carriers/jd-logistics/adapter.js';
 import { adapter as koreaPost } from '../carriers/korea-post/adapter.js';
 import { adapter as laPoste } from '../carriers/la-poste/adapter.js';
 import { adapter as landmarkGlobal } from '../carriers/landmark-global/adapter.js';
+import { adapter as latvijasPasts } from '../carriers/latvijas-pasts/adapter.js';
 import { adapter as lbcExpress } from '../carriers/lbc-express/adapter.js';
 import { adapter as matkahuolto } from '../carriers/matkahuolto/adapter.js';
 import { adapter as mngKargo } from '../carriers/mng-kargo/adapter.js';
@@ -240,6 +241,7 @@ export const REGISTRY = {
         "korea-post": koreaPost,
         "la-poste": laPoste,
         "landmark-global": landmarkGlobal,
+        "latvijas-pasts": latvijasPasts,
         "lbc-express": lbcExpress,
         "matkahuolto": matkahuolto,
         "mng-kargo": mngKargo,
@@ -418,7 +420,7 @@ export const REGISTRY = {
         "kuehne-nagel": "universal",
         "la-poste": "la-poste",
         "landmark-global": "landmark-global",
-        "latvijas-pasts": "universal",
+        "latvijas-pasts": "latvijas-pasts",
         "lbc-express": "lbc-express",
         "lietuvos-pastas": "universal",
         "loomis-express": "universal",

package/dist/server/openapi.json

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

package/package.json

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