universal-parcel-scraper 0.374.0-main.2018 → 0.375.0-main.2020

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 **405 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **406 dedicated adapters** and **5 universal fallbacks**
 
 <sub>727 catalog entries · 133 countries represented</sub>
 <!-- /GENERATED:summary -->

package/data/catalog.json

@@ -25879,7 +25879,8 @@
     "timezone": "Asia/Dhaka",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "sundarban-courier",
+      "localClocks": true
     },
     "canaryUrl": "https://operation.sundarbancourierltd.com/",
     "trackingUrlTemplate": "https://operation.sundarbancourierltd.com/?cnnumber={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 727,
-  "activeAdapters": 405,
+  "activeAdapters": 406,
   "countries": 133,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -19533,7 +19533,8 @@ var Pe = {
 		timezone: "Asia/Dhaka",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "sundarban-courier",
+			localClocks: !0
 		},
 		canaryUrl: "https://operation.sundarbancourierltd.com/",
 		trackingUrlTemplate: "https://operation.sundarbancourierltd.com/?cnnumber={trackingNumber}",

package/dist/carriers/sundarban-courier/adapter.d.ts

@@ -0,0 +1,23 @@
+import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+/** Sundarban's tracking page, whose script gives every visitor the lookup's key. */
+export declare const SUNDARBAN_PAGE = "https://operation.sundarbancourierltd.com/";
+/** The lookup the tracking page makes for a CN number. */
+export declare const SUNDARBAN_API = "https://operation.sundarbancourierltd.com/Home/getDatabyCN";
+/** The key the tracking page's script sends with every lookup, the same for every visitor. */
+export declare const SUNDARBAN_KEY = "CzbZcWnwf7TNTzluD9rxyXCUqzN4xOhs";
+/** The page's request: one CN number, looked up as a CN number over its default period. */
+export declare function sundarbanLookupBody(number: string): string;
+export declare class SundarbanTracker {
+    #private;
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+        key?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/sundarban-courier/adapter.js

@@ -0,0 +1,104 @@
+import { ChallengeError, SchemaError, TransportError } 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, userAgentOf } from '../../core/transport/index.js';
+import { normalizeSundarbanNumber, parseSundarban, PROVIDER, SUNDARBAN_MAX_BYTES } from './parser.js';
+/** Sundarban's tracking page, whose script gives every visitor the lookup's key. */
+export const SUNDARBAN_PAGE = 'https://operation.sundarbancourierltd.com/';
+/** The lookup the tracking page makes for a CN number. */
+export const SUNDARBAN_API = 'https://operation.sundarbancourierltd.com/Home/getDatabyCN';
+/** The key the tracking page's script sends with every lookup, the same for every visitor. */
+export const SUNDARBAN_KEY = 'CzbZcWnwf7TNTzluD9rxyXCUqzN4xOhs'; // gitleaks:allow
+const REDIRECTS = [301, 302, 303, 307, 308];
+const PAGE_MAX_BYTES = 1024 * 1024;
+// The service's answer to a lookup without the page's key, as a JSON string.
+const REFUSED = 'UNAUTHORIZED';
+// The page script's header for the lookup.
+const PAGE_KEY = /setRequestHeader\(\s*["']key["']\s*,\s*["']([A-Za-z0-9]{8,128})["']\s*\)/;
+// Bot checks a CDN or firewall could put in place of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|challenge-platform|<title>\s*(?:Just a moment|Attention Required)/i;
+/** The page's request: one CN number, looked up as a CN number over its default period. */
+export function sundarbanLookupBody(number) {
+    return JSON.stringify({ selectedtypes: 'cnno', selectedtimes: '7', inputvalue: number });
+}
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Sundarban answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Sundarban returned a reply that is not JSON', { cause });
+    }
+}
+export class SundarbanTracker {
+    options;
+    #key;
+    constructor(options = {}) {
+        this.options = options;
+        this.#key = options.key ?? SUNDARBAN_KEY;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeSundarbanNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const deadline = performance.now() + timeoutMs;
+            const left = () => Math.max(1, Math.floor(deadline - performance.now()));
+            const key = this.#key;
+            const reply = await this.#query(number, key, signal, left());
+            if (reply !== REFUSED)
+                return parseSundarban(reply, number);
+            // A refused key may have been replaced: the page gives the current one.
+            const current = await this.#pageKey(signal, left());
+            if (current === key)
+                throw new SchemaError(PROVIDER, 'Sundarban refused its tracking page\'s key');
+            const retried = await this.#query(number, current, signal, left());
+            if (retried === REFUSED)
+                throw new SchemaError(PROVIDER, 'Sundarban refused its tracking page\'s key');
+            this.#key = current;
+            return parseSundarban(retried, number);
+        };
+        // A read that fails to reach Sundarban, or hangs, gets one more: the first
+        // gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'sundarban-courier', 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)),
+        ]);
+    }
+    /** The decoded reply for the number. */
+    async #query(number, key, signal, timeoutMs) {
+        const { response, bytes } = await fetchBounded(SUNDARBAN_API, { method: 'POST', signal, headers: {
+                Accept: 'application/json, text/javascript, */*; q=0.01', 'Content-Type': 'application/json;charset=utf-8', key,
+                'User-Agent': userAgentOf(this.options.userAgent),
+            }, body: sundarbanLookupBody(number) }, { provider: PROVIDER, timeoutMs, maxBytes: SUNDARBAN_MAX_BYTES, redirect: 'manual',
+            fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410] });
+        if (REDIRECTS.includes(response.status))
+            throw new TransportError(PROVIDER, 'Sundarban redirected its tracking lookup');
+        if (response.status !== 200)
+            throw new TransportError(PROVIDER, 'Sundarban tracking lookup is unavailable', { status: response.status });
+        return json(decodeText(bytes));
+    }
+    /** The key the tracking page's script sends now. */
+    async #pageKey(signal, timeoutMs) {
+        const { response, bytes } = await fetchBounded(SUNDARBAN_PAGE, { method: 'GET', signal,
+            headers: { Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs, maxBytes: PAGE_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher,
+            allowHttpStatuses: [...REDIRECTS, 404, 410] });
+        if (response.status !== 200)
+            throw new TransportError(PROVIDER, 'Sundarban\'s tracking page is unavailable', { status: response.status });
+        const page = decodeText(bytes);
+        const key = PAGE_KEY.exec(page)?.[1];
+        if (key)
+            return key;
+        if (CHALLENGE.test(page.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Sundarban answered its tracking page with a browser check');
+        throw new SchemaError(PROVIDER, 'Sundarban\'s tracking page no longer gives its lookup key');
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new SundarbanTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'sundarban-courier', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+    };
+};

package/dist/carriers/sundarban-courier/carrier.json

@@ -18,18 +18,64 @@
   "timezone": "Asia/Dhaka",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "sundarban-courier",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "pickup_point"
+  ],
   "portal": {
     "url": "https://operation.sundarbancourierltd.com/?cnnumber={trackingNumber}",
     "searchUrl": "https://operation.sundarbancourierltd.com/",
     "canaryUrl": "https://operation.sundarbancourierltd.com/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "pickup_point",
+      "origin",
+      "destination",
+      "departure_date",
+      "parcel_count",
+      "order_contents",
+      "recipient_contact",
+      "event_details",
+      "remarks"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "pickup_point"
+    ],
+    "discarded": [
+      "origin",
+      "destination",
+      "departure_date",
+      "parcel_count",
+      "order_contents",
+      "recipient_contact",
+      "event_details",
+      "remarks"
+    ],
+    "unavailable": [
+      "offset_timestamps",
+      "scan_times",
+      "eta",
+      "weight",
+      "delivered_at",
+      "service_name",
+      "proof_of_delivery",
+      "delivery_partner"
+    ]
   },
   "links": [
     {

package/dist/carriers/sundarban-courier/parser.d.ts

@@ -0,0 +1,12 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Sundarban Courier";
+export declare const SUNDARBAN_MAX_BYTES: number;
+/** A CN number for Sundarban's tracker; anything else is not one Sundarban issues. */
+export declare function normalizeSundarbanNumber(raw: string): string;
+/**
+ * The reply of the tracking page's lookup, `POST /Home/getDatabyCN`: a list of
+ * the shipments under the CN number, each naming its `cnNumber`. For a number
+ * it holds nothing for, the list is empty and the page only says an error
+ * occurred and asks for the correct format, so that answer is inconclusive.
+ */
+export declare function parseSundarban(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/sundarban-courier/parser.js

@@ -0,0 +1,162 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { SUNDARBAN_CODES, sundarbanStage } from './status.js';
+export const PROVIDER = 'Sundarban Courier';
+// A shipment with its history is about five kilobytes.
+export const SUNDARBAN_MAX_BYTES = 512 * 1024;
+// A CN number, or a sub-CN: fourteen or seventeen digits.
+const NUMBER = /^\d{14}(?:\d{3})?$/;
+const CLOCK = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?$/;
+const MAX_ENTRIES = 50;
+const MAX_ROWS = 300;
+const MAX_EVENTS = 100;
+/** A CN number for Sundarban's tracker; anything else is not one Sundarban issues. */
+export function normalizeSundarbanNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Sundarban CN numbers are fourteen digits, or seventeen for a sub-CN');
+    return number;
+}
+/** An optional text field; anything but a string is a changed reply. */
+function text(row, key, maxLength = 200) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string')
+        throw new SchemaError(PROVIDER, `Sundarban returned an invalid ${key}`);
+    return clean(value, maxLength);
+}
+/**
+ * A `statusDate`, "2026-08-04T00:00:00": the branch's wall clock with no zone.
+ * The service keeps the day only and writes it at midnight, so a clock at
+ * midnight exactly keeps only its day.
+ */
+function wallClock(value) {
+    const match = CLOCK.exec(value);
+    const day = match ? calendarDay(Number(match[1]), Number(match[2]), Number(match[3])) : null;
+    if (!match || !day || Number(match[4]) > 23 || Number(match[5]) > 59 || Number(match[6]) > 59) {
+        throw new SchemaError(PROVIDER, 'Sundarban returned an invalid status date');
+    }
+    return `${match[4]}${match[5]}${match[6]}` === '000000' ? day : `${day}T${match[4]}:${match[5]}:${match[6]}`;
+}
+/** A status as the page labels it: an international code by its label, a domestic status as written. */
+function statusOf(status) {
+    return Object.hasOwn(SUNDARBAN_CODES, status) ? { description: SUNDARBAN_CODES[status].label, code: status } : { description: status, code: null };
+}
+/**
+ * A row of `cnStatusList`: its status, day and the branch it happened at. The
+ * branch it was sent towards, the vehicle, the bag or manifest number and the
+ * remarks are not kept. A row without a status is left out.
+ */
+function scanOf(row) {
+    if (!isRecord(row))
+        throw new SchemaError(PROVIDER, 'Sundarban returned an invalid status row');
+    const status = text(row, 'status', 120);
+    const local = wallClock(text(row, 'statusDate', 40));
+    if (!status)
+        return null;
+    const { description, code } = statusOf(status);
+    const location = text(row, 'fromSubBranch', 120);
+    const staged = sundarbanStage(code, status);
+    return {
+        local_time: local,
+        ...(location ? { location } : {}),
+        description,
+        ...(code ? { provider_code: code } : {}),
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+}
+/** The shipment's statuses, newest first. The service lists them oldest first. */
+function history(shipment) {
+    const rows = shipment.cnStatusList ?? [];
+    if (!Array.isArray(rows))
+        throw new SchemaError(PROVIDER, 'Sundarban returned a shipment with an invalid history');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Sundarban returned an oversized history');
+    const scans = rows.map((row, index) => ({ event: scanOf(row), index }))
+        .filter((scan) => scan.event !== null);
+    // A day without a clock sorts before that day's clocks; within one, the later row is newer.
+    return scans.sort((a, b) => b.event.local_time.localeCompare(a.event.local_time) || b.index - a.index)
+        .map(({ event }) => event);
+}
+/**
+ * The branch counter the parcel waits at, or was collected from: the page's
+ * "Ready for C/D" names it, when nothing but a delivery followed.
+ */
+function counter(events) {
+    const [newest, before] = events;
+    const ready = newest?.stage === 'ready_for_pickup' ? newest : newest?.stage === 'delivered' && before?.stage === 'ready_for_pickup' ? before : undefined;
+    return ready?.location;
+}
+/** The shipment's current status alone, when the service lists no history for it. */
+function summary(shipment) {
+    const status = text(shipment, 'status', 120);
+    if (!status)
+        throw new NoHistoryError(PROVIDER);
+    const { description, code } = statusOf(status);
+    const staged = sundarbanStage(code, status);
+    const date = text(shipment, 'statusDate', 40);
+    return {
+        status: staged ? languageStageStatus(staged.stage) : 'unknown',
+        ...(staged ? { current_stage: staged.stage, current_stage_source: staged.source } : {}),
+        last_status_text: description,
+        ...(code ? { provider_code: code } : {}),
+        last_update: null,
+        ...(date ? { last_update_local: wallClock(date) } : {}),
+        summary_only: true,
+        events: [],
+    };
+}
+function project(shipment) {
+    const events = history(shipment);
+    if (!events.length)
+        return summary(shipment);
+    const newest = events[0];
+    const staged = events.find((event) => event.stage);
+    const stage = staged?.stage;
+    const point = counter(events);
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: staged.stage_source ?? 'carrier_map' } : {}),
+        last_status_text: newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: null,
+        ...(point ? { pickup_point: point } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}
+/**
+ * The reply of the tracking page's lookup, `POST /Home/getDatabyCN`: a list of
+ * the shipments under the CN number, each naming its `cnNumber`. For a number
+ * it holds nothing for, the list is empty and the page only says an error
+ * occurred and asks for the correct format, so that answer is inconclusive.
+ */
+export function parseSundarban(payload, raw) {
+    const number = normalizeSundarbanNumber(raw);
+    if (!Array.isArray(payload))
+        throw new SchemaError(PROVIDER, 'Sundarban returned an invalid reply');
+    if (payload.length > MAX_ENTRIES)
+        throw new SchemaError(PROVIDER, 'Sundarban returned too many shipments');
+    if (!payload.length) {
+        throw new IndeterminateError(PROVIDER, 'Sundarban\'s tracker shows nothing for the number', { reason: 'portal_not_found' });
+    }
+    const shipments = payload.filter((entry) => {
+        if (!isRecord(entry))
+            throw new SchemaError(PROVIDER, 'Sundarban returned an invalid shipment');
+        const own = text(entry, 'cnNumber', 64);
+        if (!own)
+            throw new SchemaError(PROVIDER, 'Sundarban returned a shipment without its CN number');
+        return normalizeTrackingNumber(own) === number;
+    });
+    if (shipments.length > 1)
+        throw new IndeterminateError(PROVIDER, 'Sundarban returned several shipments under the number');
+    if (!shipments.length)
+        throw new IndeterminateError(PROVIDER, 'Sundarban answered for another shipment');
+    return project(shipments[0]);
+}

package/dist/carriers/sundarban-courier/status.d.ts

@@ -0,0 +1,18 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/**
+ * The codes the service gives an international shipment's statuses, with the
+ * label the page shows for each.
+ */
+export declare const SUNDARBAN_CODES: Readonly<Record<string, {
+    label: string;
+    stage: Stage;
+}>>;
+/** The stage the map gives a domestic status, if it knows the wording. */
+export declare function sundarbanWordingStage(wording: string): Stage | undefined;
+/** The stage the map gives an international status code, if it knows it. */
+export declare function sundarbanCodeStage(code: string): Stage | undefined;
+/** A status's stage: its code or wording, else the shared wording rules, else nothing. */
+export declare function sundarbanStage(code: string | null, wording: string): ClassifiedWording | null;
+/** International statuses carry their code, domestic ones only their wording. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/sundarban-courier/status.js

@@ -0,0 +1,64 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The statuses a domestic CN goes through, as the tracking service words them.
+ * The page prints each as a Bengali sentence naming the branch; the two
+ * sentences without a branch are mapped too.
+ */
+const WORDINGS = new Map(Object.entries({
+    'Booking Complete': 'accepted',
+    // Sent on from a branch or hub towards the next one.
+    'Out for Destination': 'in_transit',
+    // Received at the next hub or at the delivering branch.
+    'Received by Dest.': 'in_transit',
+    'Out for Delivery': 'out_for_delivery',
+    // Ready for collection at the branch counter.
+    'Ready for C/D': 'ready_for_pickup',
+    'Delivered': 'delivered',
+    // Returned to the sender.
+    'Return': 'returned',
+    'Return at office': 'returned',
+    // The return has reached the sender.
+    'Return & Delivered': 'returned',
+    'Damage': 'exception',
+    'পণ্যটি ডেলিভারি সম্পন্ন হয়েছে।': 'delivered',
+    'আপনার পণ্যটি প্রেরকের কাছে রিটার্ন করা হয়েছে।': 'returned',
+}).map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+/**
+ * The codes the service gives an international shipment's statuses, with the
+ * label the page shows for each.
+ */
+export const SUNDARBAN_CODES = {
+    export_processing: { label: 'Export Processing', stage: 'in_transit' },
+    export_customs_processing: { label: 'Export Customs Processing', stage: 'customs' },
+    shipment_in_transit: { label: 'Shipment In Transit', stage: 'in_transit' },
+    shipment_off_loaded: { label: 'Shipment Offloaded', stage: 'in_transit' },
+    shipment_delayed_in_transit: { label: 'Shipment Delayed In Transit', stage: 'in_transit' },
+    shipment_arrived_at_dest: { label: 'Shipment Arrived At Destination', stage: 'in_transit' },
+    customs_clearance_at_dest: { label: 'Customs Clearance At Destination', stage: 'customs' },
+    customs_clearance_delay: { label: 'Customs Clearance Delay', stage: 'customs' },
+    shipment_ready_for_delivery: { label: 'Shipment Ready For Delivery', stage: 'in_transit' },
+    shipment_delivered: { label: 'Shipment Delivered', stage: 'delivered' },
+    delivery_missed_rcpt_unavailable: { label: 'Delivery Missed Due To Recipient Unavailable', stage: 'failed_attempt' },
+};
+/** The stage the map gives a domestic status, if it knows the wording. */
+export function sundarbanWordingStage(wording) {
+    return WORDINGS.get(normalizeStatusWording(wording));
+}
+/** The stage the map gives an international status code, if it knows it. */
+export function sundarbanCodeStage(code) {
+    return Object.hasOwn(SUNDARBAN_CODES, code) ? SUNDARBAN_CODES[code].stage : undefined;
+}
+/** A status's stage: its code or wording, else the shared wording rules, else nothing. */
+export function sundarbanStage(code, wording) {
+    const mapped = code ? sundarbanCodeStage(code) : sundarbanWordingStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** International statuses carry their code, domestic ones only their wording. */
+export const statusMap = {
+    stage: (code, wording) => (code ? sundarbanCodeStage(code) : sundarbanWordingStage(wording)),
+    gaps: [],
+};

package/dist/carriers/sundarban-courier/statuses.json

@@ -1,12 +1,12 @@
 {
   "carrier": "sundarban-courier",
   "entries": [
-    {"wording": "Booking Complete", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "Booked at the sending branch. Seen in an archived reply of the tracking service; the page shows it as a Bengali sentence naming the branch."},
-    {"wording": "Out for Destination", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "Sent on from a branch or hub towards the next one. Seen in an archived reply of the tracking service; the page shows it as a Bengali sentence naming the branch."},
-    {"wording": "Received by Dest.", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "Received at the next hub or the delivering branch. Seen in an archived reply of the tracking service; the page shows it as a Bengali sentence naming the branch."},
-    {"wording": "Out for Delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "portal", "note": "Seen in an archived reply of the tracking service; the page shows it as a Bengali sentence naming the branch."},
+    {"wording": "Booking Complete", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "Booked at the sending branch; the page shows it as a Bengali sentence naming the branch."},
+    {"wording": "Out for Destination", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Sent on from a branch or hub towards the next one; the page shows it as a Bengali sentence naming both."},
+    {"wording": "Received by Dest.", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Received at the next hub or the delivering branch; the page shows it as a Bengali sentence naming the branch."},
+    {"wording": "Out for Delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live", "note": "The page shows it as a Bengali sentence naming the branch."},
     {"wording": "Ready for C/D", "stage": "ready_for_pickup", "language": "en", "confirmedBy": "official-doc", "note": "Status the tracking page's script expects: ready for collection at the branch counter."},
-    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "official-doc", "note": "Status the tracking page's script expects."},
+    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "The page shows it as a Bengali sentence."},
     {"wording": "Return", "stage": "returned", "language": "en", "confirmedBy": "official-doc", "note": "Status the tracking page's script expects: returned to the sender."},
     {"wording": "Return at office", "stage": "returned", "language": "en", "confirmedBy": "official-doc", "note": "Status the tracking page's script expects."},
     {"wording": "Return & Delivered", "stage": "returned", "language": "en", "confirmedBy": "official-doc", "note": "Status the tracking page's script expects: the return has reached the sender."},

package/dist/core/catalog/statusMaps.js

@@ -279,6 +279,7 @@ import { statusMap as spxVn } from '../../carriers/spx-vn/status.js';
 import { statusMap as stallionExpress } from '../../carriers/stallion-express/status.js';
 import { statusMap as starken } from '../../carriers/starken/status.js';
 import { statusMap as sto } from '../../carriers/sto/status.js';
+import { statusMap as sundarbanCourier } from '../../carriers/sundarban-courier/status.js';
 import { statusMap as swiftx } from '../../carriers/swiftx/status.js';
 import { statusMap as swissPost } from '../../carriers/swiss-post/status.js';
 import { statusMap as tCat } from '../../carriers/t-cat/status.js';
@@ -369,7 +370,7 @@ export const STATUS_MAPS = {
     sending, serpost, servientrega, sfc, shadowfax, shipentegra, 'skroutz-last-mile': skroutzLastMile, 'skynet-worldwide': skynetWorldwide, 'slovak-parcel-service': slovakParcelService,
     'slovenska-posta': slovenskaPosta, 'smsa-express': smsaExpress, 'south-african-post-office': southAfricanPost,
     'southeastern-freight-lines': southeasternFreightLines, 'sp-express': spExpress, speedaf, speedex, speedx, speedy, 'spx-br': spxBr, 'spx-id': spxId, 'spx-my': spxMy,
-    'spx-th': spxTh, 'spx-tw': spxTw, 'spx-vn': spxVn, 'stallion-express': stallionExpress, starken, sto, swiftx, 'swiss-post': swissPost,
+    'spx-th': spxTh, 'spx-tw': spxTw, 'spx-vn': spxVn, 'stallion-express': stallionExpress, starken, sto, 'sundarban-courier': sundarbanCourier, swiftx, 'swiss-post': swissPost,
     't-cat': tCat, 't-group': tGroup, taxydema, 'tci-express': tciExpress, 'tcs-pakistan': tcsPakistan, tdn, tealca,
     'team-global-express': teamGlobalExpress, teleship, 'tforce-freight': tforceFreight, 'thailand-post': thailandPost, thhy, tiki,
     'tmm-express': tmmExpress, tnt, 'tnt-it': tntIt, toptrans, torrestir, 'total-express': totalExpress, transaher, transmission, tsjy,

package/dist/data/catalog.json

@@ -25879,7 +25879,8 @@
         "timezone": "Asia/Dhaka",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "sundarban-courier",
+            "localClocks": true
         },
         "canaryUrl": "https://operation.sundarbancourierltd.com/",
         "trackingUrlTemplate": "https://operation.sundarbancourierltd.com/?cnnumber={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -16501,7 +16501,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Asia/Dhaka";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "sundarban-courier";
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://operation.sundarbancourierltd.com/";
         readonly trackingUrlTemplate: "https://operation.sundarbancourierltd.com/?cnnumber={trackingNumber}";

package/dist/generated/catalog.js

@@ -25880,7 +25880,8 @@ export const CARRIER_CATALOG = {
         "timezone": "Asia/Dhaka",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "sundarban-courier",
+            "localClocks": true
         },
         "canaryUrl": "https://operation.sundarbancourierltd.com/",
         "trackingUrlTemplate": "https://operation.sundarbancourierltd.com/?cnnumber={trackingNumber}",

package/dist/generated/registry.js

@@ -345,6 +345,7 @@ import { adapter as spxVn } from '../carriers/spx-vn/adapter.js';
 import { adapter as stallionExpress } from '../carriers/stallion-express/adapter.js';
 import { adapter as starken } from '../carriers/starken/adapter.js';
 import { adapter as sto } from '../carriers/sto/adapter.js';
+import { adapter as sundarbanCourier } from '../carriers/sundarban-courier/adapter.js';
 import { adapter as sunyou } from '../carriers/sunyou/adapter.js';
 import { adapter as swiftx } from '../carriers/swiftx/adapter.js';
 import { adapter as swissPost } from '../carriers/swiss-post/adapter.js';
@@ -752,6 +753,7 @@ export const REGISTRY = {
         "stallion-express": stallionExpress,
         "starken": starken,
         "sto": sto,
+        "sundarban-courier": sundarbanCourier,
         "sunyou": sunyou,
         "swiftx": swiftx,
         "swiss-post": swissPost,
@@ -1439,7 +1441,7 @@ export const REGISTRY = {
         "steadfast": "universal",
         "sto": "sto",
         "straightship": "universal",
-        "sundarban-courier": "universal",
+        "sundarban-courier": "sundarban-courier",
         "sunyou": "sunyou",
         "surat-kargo": "universal",
         "swiftx": "swiftx",

package/dist/server/openapi.json

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

package/package.json

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