universal-parcel-scraper 0.428.0-main.2178 → 0.430.0-main.2182

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 **463 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **465 dedicated adapters** and **5 universal fallbacks**
 
 <sub>767 catalog entries · 134 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 14,524 such statuses, each filed under one stage.
+The carrier folders record 14,530 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

@@ -15237,7 +15237,8 @@
     "timezone": "America/New_York",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "gsi-express",
+      "localClocks": true
     },
     "canaryUrl": "https://www.gsiexpress.com/tracking_query.php",
     "trackingUrlTemplate": "https://www.gsiexpress.com/track_pop.php?textfield={trackingNumber}&track_type=invoice_no",
@@ -29631,7 +29632,9 @@
     "timezone": "Asia/Kolkata",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "vrl-logistics",
+      "recognitionRank": 935,
+      "localClocks": true
     },
     "canaryUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",
     "trackingSearchUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 767,
-  "activeAdapters": 463,
+  "activeAdapters": 465,
   "countries": 134,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -47323,6 +47323,14 @@
       "dhl-ecommerce-pl"
     ]
   },
+  {
+    "input": "6258970",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "seur"
+    ]
+  },
   {
     "input": "626020539",
     "carrier": "unknown",

package/dist/browser/scraper.js

@@ -11694,7 +11694,8 @@ var Re = {
 		timezone: "America/New_York",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "gsi-express",
+			localClocks: !0
 		},
 		canaryUrl: "https://www.gsiexpress.com/tracking_query.php",
 		trackingUrlTemplate: "https://www.gsiexpress.com/track_pop.php?textfield={trackingNumber}&track_type=invoice_no",
@@ -22265,7 +22266,9 @@ var Re = {
 		timezone: "Asia/Kolkata",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "vrl-logistics",
+			recognitionRank: 935,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.vrlgroup.in/Tracking/TrackShipment",
 		trackingSearchUrl: "https://www.vrlgroup.in/Tracking/TrackShipment",
@@ -29494,6 +29497,7 @@ var _l = {
 	venipak: 240,
 	"via-cargo": 936,
 	"vinted-go": 410,
+	"vrl-logistics": 935,
 	wanbexpress: 33,
 	whistl: 320,
 	winit: 855,

package/dist/carriers/gsi-express/adapter.d.ts

@@ -0,0 +1,16 @@
+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';
+/** The page the tracker's invoice-number search opens for the number typed in. */
+export declare const GSI_EXPRESS_TRACKING = "https://www.gsiexpress.com/track_pop.php";
+export declare class GsiExpressTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    private read;
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/gsi-express/adapter.js

@@ -0,0 +1,47 @@
+import { 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 { GSI_EXPRESS_MAX_BYTES, normalizeGsiExpressNumber, parseGsiExpress, PROVIDER } from './parser.js';
+/** The page the tracker's invoice-number search opens for the number typed in. */
+export const GSI_EXPRESS_TRACKING = 'https://www.gsiexpress.com/track_pop.php';
+const REDIRECTS = [301, 302, 303, 307, 308];
+const GONE = [404, 410];
+const DEFAULT_BUDGET_MS = 15_000;
+export class GsiExpressTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async read(number, signal, timeoutMs) {
+        const url = `${GSI_EXPRESS_TRACKING}?${new URLSearchParams({ textfield: number, track_type: 'invoice_no' })}`;
+        const { response, bytes } = await fetchBounded(url, { method: 'GET', signal, headers: {
+                Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent),
+            } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: GSI_EXPRESS_MAX_BYTES, redirect: 'manual',
+            fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, ...GONE] });
+        // The tracker answers a known and an unknown number alike with HTTP 200.
+        if (REDIRECTS.includes(response.status))
+            throw new TransportError(PROVIDER, 'GSI Express redirected its tracker', { status: response.status });
+        if (GONE.includes(response.status))
+            throw new TransportError(PROVIDER, 'GSI Express tracker is unavailable', { status: response.status });
+        return parseGsiExpress(decodeText(bytes), number);
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeGsiExpressNumber(raw);
+        // A read that fails to reach GSI Express, or hangs, is sent once more: the
+        // first try gets half of the budget.
+        return runSteps({ carrier: 'gsi-express', budgetMs: context.budgetMs ?? DEFAULT_BUDGET_MS, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => this.read(number, signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => this.read(number, signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new GsiExpressTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'gsi-express', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+    };
+};

package/dist/carriers/gsi-express/carrier.json

@@ -18,18 +18,52 @@
   "timezone": "America/New_York",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "gsi-express",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "delivery_partner",
+    "delivery_tracking_number"
+  ],
   "portal": {
     "url": "https://www.gsiexpress.com/track_pop.php?textfield={trackingNumber}&track_type=invoice_no",
     "searchUrl": "https://www.gsiexpress.com/tracking_query.php",
     "canaryUrl": "https://www.gsiexpress.com/tracking_query.php",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "delivery_tracking_number",
+      "related_awb_numbers",
+      "order_reference",
+      "recipient_name",
+      "recipient_address"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "discarded": [
+      "related_awb_numbers",
+      "order_reference",
+      "recipient_name",
+      "recipient_address"
+    ],
+    "unavailable": [
+      "location",
+      "eta",
+      "weight",
+      "delivered_at",
+      "offset_timestamps",
+      "service_name",
+      "sender_name"
+    ]
   },
   "links": [
     {

package/dist/carriers/gsi-express/numbers.json

@@ -56,7 +56,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -65,7 +65,7 @@
           "seur"
         ]
       },
-      "note": "An archived lookup of a receipt number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a receipt number on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
     },
     {
       "number": "3241306",
@@ -78,7 +78,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -87,7 +87,7 @@
           "seur"
         ]
       },
-      "note": "An archived lookup of a receipt number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a receipt number on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
     },
     {
       "number": "3468869",
@@ -100,7 +100,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -109,7 +109,7 @@
           "seur"
         ]
       },
-      "note": "An archived lookup of a receipt number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a receipt number on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
     },
     {
       "number": "3650251",
@@ -122,7 +122,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -131,7 +131,7 @@
           "seur"
         ]
       },
-      "note": "An archived lookup of a receipt number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a receipt number on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
     },
     {
       "number": "4262236",
@@ -144,7 +144,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -153,7 +153,7 @@
           "seur"
         ]
       },
-      "note": "An archived lookup of a receipt number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a receipt number on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
     },
     {
       "number": "4274023",
@@ -166,7 +166,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -175,7 +175,27 @@
           "seur"
         ]
       },
-      "note": "An archived lookup of a receipt number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a receipt number on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
+    },
+    {
+      "number": "6258970",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.gsiexpress.com/track_pop.php?textfield=6258970&sd=2022-07-29",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "seur"
+        ]
+      },
+      "note": "A search engine indexes this lookup on GSI Express's own tracker, which returns the parcel with its departure, customs clearance and Korea Post number."
     },
     {
       "number": "6099726383792",
@@ -240,7 +260,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -253,7 +273,7 @@
           "korea-post"
         ]
       },
-      "note": "An archived lookup of a Korea Post registered number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a Korea Post registered number on GSI Express's own tracker, which returns it as the waybill of a GSI parcel."
     },
     {
       "number": "6063009754271",
@@ -266,7 +286,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -279,7 +299,7 @@
           "korea-post"
         ]
       },
-      "note": "An archived lookup of a Korea Post registered number on GSI Express's own tracker. The capture was not opened."
+      "note": "An archived lookup of a Korea Post registered number on GSI Express's own tracker, which returns it as the waybill of a GSI parcel."
     }
   ]
 }

package/dist/carriers/gsi-express/parser.d.ts

@@ -0,0 +1,14 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "GSI Express";
+export declare const GSI_EXPRESS_MAX_BYTES: number;
+/** A GSI Express receipt number: seven digits; anything else is not one its tracker reads. */
+export declare function normalizeGsiExpressNumber(raw: string): string;
+/**
+ * The tracker's page for one receipt number, `track_pop.php`. Each field has a
+ * row of its own: the receipt number, the master air waybill, the waybill of
+ * the domestic leg, the merchant's order number, the recipient, the time the
+ * parcel left the US warehouse, the flight table, the customs clearance date
+ * and the domestic delivery section. A receipt number the tracker has no
+ * record of gets its notice that there is no data.
+ */
+export declare function parseGsiExpress(html: string, rawNumber: string): CarrierResult;

package/dist/carriers/gsi-express/parser.js

@@ -0,0 +1,165 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { clean } from '../../core/transport/index.js';
+import { gsiExpressStage } from './status.js';
+export const PROVIDER = 'GSI Express';
+// A page is about sixteen kilobytes, most of it script.
+export const GSI_EXPRESS_MAX_BYTES = 512 * 1024;
+// The receipt number GSI Express issues for each parcel, which its tracker calls the invoice number.
+const NUMBER = /^\d{7}$/;
+// The tracker's whole answer to a receipt number it has no record of.
+const NOT_FOUND = '해당 데이타가 존재하지 않습니다';
+// A firewall or bot check's page, which can come back with HTTP 200.
+const BLOCKED = /<title>\s*(?:Just a moment|Attention Required|Access Denied|Request Rejected)|_cf_chl_opt|cf-turnstile|g-recaptcha|h-captcha|captcha/i;
+// The page's field labels, each heading one row.
+const RECEIPT = 'GSI 접수번호';
+const WAYBILL = '운송장번호';
+const DEPARTED = '출고시간';
+const FLIGHTS = 'Flight Plan Information';
+const CLEARED = '통관완료일';
+const DOMESTIC = '현지 국내배송상황';
+// The departure is shown twice, in Korean time and thirteen hours earlier as US Eastern time.
+const KOREAN_CLOCK = /(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\s*\(한국시간\)/;
+const CLEARED_DAY = /^(\d{4})년\s*(\d{2})월\s*(\d{2})일\s*\(한국시간\)$/;
+// The domestic section's own lines: the numbered delivery waybill and its table's headings.
+const DOMESTIC_LINE = /^\d+\.\s*주송장번호\s*:\s*[A-Z\d-]*$|^(?:처리일시|배송상태|처리지점)$/;
+// Korea Post's domestic parcel numbers, the ones its own rule suggests.
+const KOREA_POST_PARCEL = /^6\d{12}$/;
+/** A GSI Express receipt number: seven digits; anything else is not one its tracker reads. */
+export function normalizeGsiExpressNumber(raw) {
+    const number = typeof raw === 'string' && raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'GSI Express receipt numbers are seven digits');
+    return number;
+}
+function unexpected(html, message) {
+    if (BLOCKED.test(html.slice(0, 64_000)))
+        throw new ChallengeError(PROVIDER, 'GSI Express answered with a browser check');
+    throw new SchemaError(PROVIDER, message);
+}
+/** The row a field label heads: the label sits in a small table of its own in the row's first cell. */
+function fieldRow($, label) {
+    const labels = $('td[bgcolor] > b').filter((_, element) => clean($(element).text(), 80) === label);
+    if (labels.length > 1)
+        throw new SchemaError(PROVIDER, `GSI Express returned a page with two ${label} fields`);
+    const row = labels.closest('table').parent().closest('tr');
+    return row.length === 1 ? row : null;
+}
+/** The text of the cells after a field's label. */
+function fieldValue($, label) {
+    const row = fieldRow($, label);
+    return row ? clean(row.children('td').slice(1).text(), 300) : null;
+}
+/** A wall clock checked digit for digit: parsing in UTC reads the calendar alone, and Luxon rolls 24:00 over. */
+function wallClock(text, format) {
+    const parsed = DateTime.fromFormat(text, format, { zone: 'UTC' });
+    if (!parsed.isValid || parsed.toFormat(format) !== text)
+        throw new SchemaError(PROVIDER, 'GSI Express returned an invalid date');
+    return parsed.toFormat(format.includes('H') ? "yyyy-MM-dd'T'HH:mm:ss" : 'yyyy-MM-dd');
+}
+/**
+ * The time the parcel left the warehouse in the United States, in Korean
+ * time. The page derives the US Eastern clock beside it by taking thirteen
+ * hours off all year, so one of the two is an hour out in winter: the clock
+ * stays a wall clock.
+ */
+function departure(text) {
+    if (!/\d/.test(text))
+        return null;
+    const clock = KOREAN_CLOCK.exec(text)?.[1];
+    if (!clock)
+        throw new SchemaError(PROVIDER, 'GSI Express returned a departure without its Korean time');
+    return wallClock(clock, 'yyyy-MM-dd HH:mm:ss');
+}
+/** The day Korean customs cleared the parcel. */
+function clearance(text) {
+    // The cell goes on with a button to the Korea Customs Service's lookup, which has no text.
+    if (!/\d/.test(text))
+        return null;
+    const day = CLEARED_DAY.exec(text);
+    if (!day)
+        throw new SchemaError(PROVIDER, 'GSI Express returned an invalid customs clearance date');
+    return wallClock(`${day[1]}-${day[2]}-${day[3]}`, 'yyyy-MM-dd');
+}
+function scan(local, description) {
+    const staged = gsiExpressStage(description);
+    return { local_time: local, description, ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}) };
+}
+/**
+ * Whether the page lists flights or domestic scans the adapter does not read:
+ * rows under the flight table's headings, or lines in the domestic section
+ * besides its waybill and headings.
+ */
+function unreadRows($) {
+    const flights = fieldRow($, FLIGHTS)?.next('tr').find('tr').slice(1).toArray() ?? [];
+    const domestic = fieldRow($, DOMESTIC)?.closest('table').closest('tr').next('tr').find('td')
+        .filter((_, cell) => $(cell).find('td').length === 0).toArray() ?? [];
+    return flights.some((row) => clean($(row).text(), 40) !== '')
+        || domestic.some((cell) => {
+            const text = clean($(cell).text(), 200);
+            return text !== '' && !DOMESTIC_LINE.test(text);
+        });
+}
+/**
+ * The waybill of the domestic leg. Korea Post's domestic parcel numbers are
+ * thirteen digits from 6; GSI Express's other partner in Korea, CJ Logistics,
+ * and Sagawa in Japan use shorter ones. A parcel the page clears through
+ * Korean customs under such a number is handed to Korea Post. Any other single
+ * waybill is kept without a carrier.
+ */
+function handoff($, korean) {
+    const shown = fieldValue($, WAYBILL) ?? '';
+    if (!/^[A-Z\d-]+$/i.test(shown))
+        return {};
+    const number = normalizeTrackingNumber(shown);
+    if (!/^[A-Z0-9]{4,40}$/.test(number))
+        return {};
+    return { ...(korean && KOREA_POST_PARCEL.test(number) ? { delivery_carrier: 'korea-post' } : {}), delivery_tracking_number: number };
+}
+/**
+ * The tracker's page for one receipt number, `track_pop.php`. Each field has a
+ * row of its own: the receipt number, the master air waybill, the waybill of
+ * the domestic leg, the merchant's order number, the recipient, the time the
+ * parcel left the US warehouse, the flight table, the customs clearance date
+ * and the domestic delivery section. A receipt number the tracker has no
+ * record of gets its notice that there is no data.
+ */
+export function parseGsiExpress(html, rawNumber) {
+    const number = normalizeGsiExpressNumber(rawNumber);
+    const $ = load(html);
+    const notices = $('font').filter((_, element) => clean($(element).text(), 80) === NOT_FOUND);
+    if (notices.length && !fieldRow($, RECEIPT))
+        throw new NotFoundError(PROVIDER);
+    const receipt = fieldValue($, RECEIPT);
+    if (receipt === null || !/^\d+$/.test(receipt))
+        unexpected(html, 'GSI Express returned a page without the receipt number');
+    if (receipt !== number)
+        throw new IndeterminateError(PROVIDER, 'GSI Express answered for another shipment');
+    const departed = fieldValue($, DEPARTED);
+    const cleared = fieldValue($, CLEARED);
+    if (departed === null && cleared === null)
+        throw new SchemaError(PROVIDER, 'GSI Express returned a page without its milestones');
+    const left = departed === null ? null : departure(departed);
+    const day = cleared === null ? null : clearance(cleared);
+    // Newest first, in the order the parcel passes them; a clearance date has no hour to compare.
+    const events = [...(day ? [scan(day, '통관완료')] : []), ...(left ? [scan(left, '출고')] : [])];
+    if (!events.length)
+        throw new NoHistoryError(PROVIDER);
+    const newest = events[0];
+    const stage = newest.stage;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: newest.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: null,
+        // The clearance row is Korean customs'.
+        ...handoff($, cleared !== null),
+        events,
+        ...(unreadRows($) ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/gsi-express/status.d.ts

@@ -0,0 +1,7 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives a milestone. */
+export declare function gsiExpressMappedStage(wording: string): Stage | undefined;
+/** A milestone's stage: the map's, else the shared wording rules', else nothing. */
+export declare function gsiExpressStage(wording: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/gsi-express/status.js

@@ -0,0 +1,27 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The milestones the tracker shows as fields, named by the field's label
+ * without its 시간 ("time") or 일 ("date"). Its flights and the domestic
+ * carrier's scans are not read.
+ */
+const WORDINGS = new Map([
+    ['출고', 'in_transit'], // The parcel left GSI Express's warehouse in the United States for its flight.
+    ['통관완료', 'in_transit'], // Korean customs cleared the parcel, which goes on to the delivery carrier.
+].map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+/** The stage the map gives a milestone. */
+export function gsiExpressMappedStage(wording) {
+    return WORDINGS.get(normalizeStatusWording(wording));
+}
+/** A milestone's stage: the map's, else the shared wording rules', else nothing. */
+export function gsiExpressStage(wording) {
+    const mapped = gsiExpressMappedStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+export const statusMap = {
+    stage: (_code, wording) => gsiExpressMappedStage(wording),
+    gaps: [],
+};

package/dist/carriers/gsi-express/statuses.json

@@ -1,7 +1,7 @@
 {
   "carrier": "gsi-express",
   "entries": [
-    {"wording": "출고시간", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "Field label on the tracker: the time the parcel left GSI Express's US warehouse, in Korean and US Eastern time."},
-    {"wording": "통관완료일", "stage": "customs", "language": "ko", "confirmedBy": "portal", "note": "Field label on the tracker: the date Korean customs cleared the parcel."}
+    {"wording": "출고", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "The tracker's 출고시간 field: the time the parcel left GSI Express's warehouse in the United States for its flight, in Korean and US Eastern time."},
+    {"wording": "통관완료", "stage": "in_transit", "language": "ko", "confirmedBy": "portal", "note": "The tracker's 통관완료일 field: the day Korean customs cleared the parcel, which goes on to the delivery carrier."}
   ]
 }

package/dist/carriers/vrl-logistics/adapter.d.ts

@@ -0,0 +1,15 @@
+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';
+/** The tracking page on www.vrlgroup.in, whose form posts the LR number back to it. */
+export declare const VRL_TRACKER = "https://www.vrlgroup.in/Tracking/TrackShipment";
+export declare class VrlTracker {
+    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/vrl-logistics/adapter.js

@@ -0,0 +1,47 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { 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 { normalizeVrlNumber, parseVrl, PROVIDER, VRL_MAX_BYTES } from './parser.js';
+/** The tracking page on www.vrlgroup.in, whose form posts the LR number back to it. */
+export const VRL_TRACKER = 'https://www.vrlgroup.in/Tracking/TrackShipment';
+const REDIRECTS = [301, 302, 303, 307, 308];
+export class VrlTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeVrlNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            // The form also sends its anti-forgery token and cookie, which the page does not check.
+            const { response, bytes } = await fetchBounded(VRL_TRACKER, { method: 'POST', signal, headers: {
+                    Accept: 'text/html', 'Content-Type': 'application/x-www-form-urlencoded', 'User-Agent': userAgentOf(this.options.userAgent),
+                }, body: new URLSearchParams({ lrno: number }).toString() }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)),
+                maxBytes: VRL_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'VRL redirected its tracking page');
+            // The page answers an unknown LR number with HTTP 200; a 404 is a moved route.
+            if (response.status === 404 || response.status === 410)
+                throw new TransportError(PROVIDER, 'VRL tracking page is unavailable');
+            return parseVrl(decodeText(bytes), number);
+        };
+        // A request that fails to reach the site, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'vrl-logistics', 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 VrlTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'vrl-logistics', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeVrlNumber(number))),
+    };
+};

package/dist/carriers/vrl-logistics/carrier.json

@@ -19,17 +19,59 @@
   "timezone": "Asia/Kolkata",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "vrl-logistics",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 935
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location"
+  ],
   "portal": {
     "searchUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",
     "canaryUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "scan_times",
+      "origin",
+      "destination",
+      "parcel_count",
+      "delivery_method",
+      "depot_code",
+      "progress_rail"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location"
+    ],
+    "discarded": [
+      "scan_times",
+      "origin",
+      "destination",
+      "parcel_count",
+      "delivery_method",
+      "depot_code",
+      "progress_rail"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "delivered_at",
+      "offset_timestamps",
+      "sender_name",
+      "recipient_name",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

package/dist/carriers/vrl-logistics/numbers.json

@@ -145,7 +145,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -161,7 +161,7 @@
           "gls-es"
         ]
       },
-      "note": "An archived lookup on VRL's consignment tracking page; the opened capture loads the result separately and shows no details, so it does not confirm the LR."
+      "note": "An archived lookup on VRL's consignment tracking page; the opened capture loads the result separately and shows no details. VRL's current tracker knows the LR, with its booking, transit rows and delivery."
     }
   ]
 }

package/dist/carriers/vrl-logistics/parser.d.ts

@@ -0,0 +1,15 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "VRL Logistics";
+export declare const VRL_MAX_BYTES: number;
+/** An LR (lorry receipt) number: nine or ten digits. Anything else is not a number VRL issues. */
+export declare function normalizeVrlNumber(raw: string): string;
+/**
+ * The page `POST /Tracking/TrackShipment` answers for one LR number. The
+ * server renders the consignment's details card (its number, booking branch,
+ * destination branch, booking day and delivery type), then a transit card with
+ * its current status and a rail of its scans between the booking and the
+ * destination, oldest first, in two layouts: wide screens and phones. The
+ * phone layout is read. A hidden sample card ships with every page. An LR
+ * number the tracker does not know comes back as the form with an error toast.
+ */
+export declare function parseVrl(html: string, raw: string): CarrierResult;

package/dist/carriers/vrl-logistics/parser.js

@@ -0,0 +1,160 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { clean } from '../../core/transport/index.js';
+import { vrlMappedStage, vrlStage } from './status.js';
+export const PROVIDER = 'VRL Logistics';
+// The page is under a hundred kilobytes, most of it menus and styles.
+export const VRL_MAX_BYTES = 1024 * 1024;
+const NUMBER = /^\d{9,10}$/;
+const DAY = /^\d{2}-[A-Z][a-z]{2}-\d{4}$/;
+const DAY_FORMAT = 'dd-LLL-yyyy';
+// A scan's clock as the page writes it, "19:03, 06-Mar-2026": the hour, then the month where the minutes belong.
+const SCAN_CLOCK = /^([01]\d|2[0-3]):[0-5]\d, (\S+)$/;
+// The page's answer for an LR number it does not know, in an error toast above the form.
+const NO_DATA = 'No data found';
+// The toast for an LR number the tracker refuses outright, also its answer to a request without one.
+const INVALID = /^Invalid LR number\b/i;
+// Bot checks a CDN or firewall could put in place of the page.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>\s*(?:Just a moment|Attention Required|Access Denied|Request Rejected)|requested URL was rejected|g-recaptcha|h-captcha|AwsWafIntegration|awswaf\.com|_Incapsula_Resource/i;
+// The ends of the progress rail: the booking day at the origin, the delivery day at the destination.
+const MARKERS = new Set(['ORIGIN', 'DESTINATION']);
+const MAX_ROWS = 500;
+/** An LR (lorry receipt) number: nine or ten digits. Anything else is not a number VRL issues. */
+export function normalizeVrlNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'VRL LR numbers are nine or ten digits');
+    return number;
+}
+/** A day as the page writes it, "06-Mar-2026", as an ISO calendar day. */
+function calendarDay(text) {
+    // Parsing in UTC checks the calendar alone; a day that reads back changed is not one.
+    const parsed = DateTime.fromFormat(text, DAY_FORMAT, { zone: 'UTC', locale: 'en-US' });
+    if (!DAY.test(text) || !parsed.isValid || parsed.toFormat(DAY_FORMAT, { locale: 'en-US' }) !== text) {
+        throw new SchemaError(PROVIDER, 'VRL returned an invalid date');
+    }
+    return parsed.toISODate();
+}
+/** The labelled values of a card section, by label. */
+function labelled($, section) {
+    const values = new Map();
+    section.find('p.track-label').each((_, node) => {
+        const value = $(node).next('p.track-value');
+        if (value.length)
+            values.set(clean($(node).text(), 80), clean(value.text(), 120));
+    });
+    return values;
+}
+/** The rail's scans in the page's order, oldest first, without its two ends and the rows that have no date. */
+function scansOf($, timeline) {
+    const rails = timeline.find('div.track-container.sm-scr-progress');
+    if (rails.length !== 1)
+        throw new SchemaError(PROVIDER, 'VRL returned a page without its transit rail');
+    const steps = rails.children('div.track-stepp');
+    if (steps.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'VRL returned an oversized history');
+    const rows = [];
+    steps.each((index, node) => {
+        const content = $(node).children('div.step-content');
+        const code = clean(content.find('div.step-labell div.status').text(), 40);
+        const clock = content.children('div.step-date');
+        if (!clock.length) {
+            if (!MARKERS.has(code))
+                throw new SchemaError(PROVIDER, 'VRL returned a transit row without its date');
+            return;
+        }
+        const written = clean(clock.text(), 40);
+        // The page can list a row with neither a time nor a day, as ", ".
+        if (/^,?$/.test(written))
+            return;
+        const match = SCAN_CLOCK.exec(written);
+        if (!match)
+            throw new SchemaError(PROVIDER, 'VRL returned an invalid scan time');
+        const description = clean(content.children('label').first().text(), 120);
+        const location = clean(content.find('div.step-labell div.city').text(), 120);
+        if (!description || !location)
+            throw new SchemaError(PROVIDER, 'VRL returned a transit row without its status or branch');
+        const day = calendarDay(match[2]);
+        rows.push({ event: { local_time: day, location, description }, day, index });
+    });
+    return rows;
+}
+/**
+ * The page `POST /Tracking/TrackShipment` answers for one LR number. The
+ * server renders the consignment's details card (its number, booking branch,
+ * destination branch, booking day and delivery type), then a transit card with
+ * its current status and a rail of its scans between the booking and the
+ * destination, oldest first, in two layouts: wide screens and phones. The
+ * phone layout is read. A hidden sample card ships with every page. An LR
+ * number the tracker does not know comes back as the form with an error toast.
+ */
+export function parseVrl(html, raw) {
+    const number = normalizeVrlNumber(raw);
+    const $ = load(html);
+    const details = $('section.track-card--details').not('.d-none');
+    const timeline = $('section.track-card--timeline').not('.d-none');
+    if (!details.length && !timeline.length) {
+        const toast = clean($('#errorToast .toast-body').text(), 200);
+        if (toast === NO_DATA)
+            throw new NotFoundError(PROVIDER);
+        // A nine- or ten-digit number is one the tracker takes: a refusal means the request changed.
+        if (INVALID.test(toast))
+            throw new SchemaError(PROVIDER, 'VRL refused the LR number as invalid');
+        if (!$('#trackingForm').length && CHALLENGE.test(html.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'VRL answered with a browser check');
+        throw new SchemaError(PROVIDER, 'VRL returned a page without an answer');
+    }
+    if (details.length !== 1 || timeline.length !== 1)
+        throw new SchemaError(PROVIDER, 'VRL returned an unexpected number of consignments');
+    const heading = details.find('#lrnum');
+    if (heading.length !== 1)
+        throw new SchemaError(PROVIDER, 'VRL returned a consignment without its number');
+    const echoed = clean(heading.text(), 40).replace(/^#\s*/, '');
+    if (echoed !== number)
+        throw new SchemaError(PROVIDER, 'VRL answered for a different LR number');
+    const booking = labelled($, details);
+    const transit = labelled($, timeline);
+    if (!booking.has('Booking Date') || !booking.has('Booking From'))
+        throw new SchemaError(PROVIDER, 'VRL returned a consignment without its booking');
+    const rows = scansOf($, timeline);
+    const bookedOn = booking.get('Booking Date');
+    const bookedAt = booking.get('Booking From');
+    // The rail starts with the booking day at the first word of the booking branch's name; the details card names it whole.
+    if (bookedOn) {
+        const day = calendarDay(bookedOn);
+        rows.unshift({ event: { local_time: day, ...(bookedAt ? { location: bookedAt } : {}), description: 'Booked' }, day, index: -1 });
+    }
+    if (!rows.length)
+        throw new NoHistoryError(PROVIDER);
+    // Days in order; within a day, the page's order. Without the hour, a row the
+    // same day at the same branch with the same status says nothing new.
+    const ordered = rows.sort((a, b) => a.day.localeCompare(b.day) || a.index - b.index).reverse();
+    const seen = new Set();
+    const events = [];
+    for (const { event } of ordered) {
+        const key = JSON.stringify([event.local_time, event.description, event.location]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const staged = vrlStage(event.description);
+        events.push({ ...event, ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}) });
+    }
+    // The transit card's current status decides when the map knows it; else the newest scan with a stage.
+    const summary = transit.get('Current Status') ?? '';
+    const summarized = summary ? vrlMappedStage(summary) : undefined;
+    const decider = summarized ? undefined : events.find((event) => event.stage);
+    const stage = (summarized ?? decider?.stage);
+    const newest = events[0];
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: summarized ? 'carrier_map' : decider.stage_source } : {}),
+        last_status_text: summarized ? summary : newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: null,
+        events,
+    };
+}

package/dist/carriers/vrl-logistics/status.d.ts

@@ -0,0 +1,7 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives a wording, if it knows it. */
+export declare function vrlMappedStage(wording: string): Stage | undefined;
+/** A wording's stage from the map, else from the shared wording rules; wording neither knows stays without one. */
+export declare function vrlStage(wording: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/vrl-logistics/status.js

@@ -0,0 +1,32 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The tracker's scans and its current status carry wording only, in capitals:
+ * a move between branches, the arrival at the destination branch and the
+ * delivery. The adapter words the booking `Booked`. Only wording seen on the
+ * current tracker is mapped; other wording, such as the former tracker's,
+ * falls to the shared rules.
+ */
+const WORDINGS = new Map([
+    ['booked', 'accepted'],
+    ['in-transit', 'in_transit'],
+    // The page does not say whether the parcel waits there for collection or goes out to the door.
+    ['arrived at destination', 'in_transit'],
+    ['delivered', 'delivered'],
+]);
+/** The stage the map gives a wording, if it knows it. */
+export function vrlMappedStage(wording) {
+    return WORDINGS.get(normalizeStatusWording(wording));
+}
+/** A wording's stage from the map, else from the shared wording rules; wording neither knows stays without one. */
+export function vrlStage(wording) {
+    const mapped = vrlMappedStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+export const statusMap = {
+    stage: (code, wording) => (code ? undefined : vrlMappedStage(wording)),
+    gaps: [],
+};

package/dist/carriers/vrl-logistics/statuses.json

@@ -1,6 +1,12 @@
 {
   "carrier": "vrl-logistics",
   "entries": [
+    {"wording": "Booked", "stage": "accepted", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "Written by the adapter for the details card's booking day, at the booking branch."},
+    {"wording": "IN-TRANSIT", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "A transit row at a branch or transhipment point on the way, several a day."},
+    {"wording": "ARRIVED AT DESTINATION", "stage": "in_transit", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "A transit row at the destination branch, and the current status of a consignment that stays there. The page does not say whether it waits for collection or goes out to the door."},
+    {"wording": "DELIVERED", "stage": "delivered", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "A transit row at the destination branch, and the current status once delivered, for an office delivery too. An undated row with this wording can sit under a consignment still at its destination; the adapter skips undated rows."},
+    {"wording": "ORIGIN", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "The start of the progress rail, with the booking day and the first word of the booking branch's name; not a scan."},
+    {"wording": "DESTINATION", "language": "en", "confirmedBy": "live", "firstSeen": "2026-10-19", "note": "The end of the progress rail, with the destination town and, once delivered, the delivery day; not a scan."},
     {"wording": "MATERIAL DELIVERED", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "Seen in an archived capture of the LR tracking page, on a delivery run."},
     {"wording": "MATERIAL OUT FOR DELIVERY", "stage": "out_for_delivery", "language": "en", "confirmedBy": "portal", "note": "Seen in an archived capture of the LR tracking page, on a delivery run."},
     {"wording": "NOT DELIVERED", "stage": "failed_attempt", "language": "en", "confirmedBy": "portal", "note": "Seen in an archived capture of the LR tracking page, on a delivery run cancelled with a reason."},

package/dist/core/catalog/statusMaps.js

@@ -164,6 +164,7 @@ import { statusMap as gofoFr } from '../../carriers/gofo-fr/status.js';
 import { statusMap as gofoIt } from '../../carriers/gofo-it/status.js';
 import { statusMap as gofoNl } from '../../carriers/gofo-nl/status.js';
 import { statusMap as gogoXpress } from '../../carriers/gogo-xpress/status.js';
+import { statusMap as gsiExpress } from '../../carriers/gsi-express/status.js';
 import { statusMap as gzyl } from '../../carriers/gzyl/status.js';
 import { statusMap as hanjin } from '../../carriers/hanjin/status.js';
 import { statusMap as happyPost } from '../../carriers/happy-post/status.js';
@@ -370,6 +371,7 @@ import { statusMap as venipak } from '../../carriers/venipak/status.js';
 import { statusMap as viaCargo } from '../../carriers/via-cargo/status.js';
 import { statusMap as viettelPost } from '../../carriers/viettel-post/status.js';
 import { statusMap as vintedGo } from '../../carriers/vinted-go/status.js';
+import { statusMap as vrlLogistics } from '../../carriers/vrl-logistics/status.js';
 import { statusMap as wanbexpress } from '../../carriers/wanbexpress/status.js';
 import { statusMap as whistl } from '../../carriers/whistl/status.js';
 import { statusMap as winit } from '../../carriers/winit/status.js';
@@ -412,7 +414,7 @@ export const STATUS_MAPS = {
     'flash-express-ph': flashExpressPh,
     'four-px': fourPx, foxpost, fukuyama, gati, gdex,
     'gebrueder-weiss': gebruederWeiss, geis, 'geniki-taxydromiki': geniki, 'geodis-pl': geodisPl, 'gls-es': glsEs, 'gls-it': glsIt,
-    'go-express': goExpress, globalpost, go4, gofo, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'gofo-nl': gofoNl, 'gogo-xpress': gogoXpress, gzyl, hanjin, 'happy-post': happyPost, haypost, 'hct-logistics': hctLogistics,
+    'go-express': goExpress, globalpost, go4, gofo, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'gofo-nl': gofoNl, 'gogo-xpress': gogoXpress, 'gsi-express': gsiExpress, gzyl, hanjin, 'happy-post': happyPost, haypost, 'hct-logistics': hctLogistics,
     helthjem, hepsijet, 'hermes-at': hermesAt, hispapost, 'hr-parcel': hrParcel,
     'hrvatska-posta': hrvatskaPosta, 'hunter-express': hunterExpress, hywl, 'ids-logistik': idsLogistik, imile, 'indah-logistik': indahLogistik,
     instabox, 'internet-express': internetExpress, interrapidisimo,
@@ -446,7 +448,7 @@ export const STATUS_MAPS = {
     trackon, 'tracx-logis': tracxLogis, transaher, transcorp, transmission, tsjy, 'tws-express': twsExpress, 'ubi-smart-parcel': ubiSmartParcel,
     'united-delivery-service': unitedDeliveryService, ups, urbano, urvaam,
     'uzbekistan-post': uzbekistanPost, valmo, 'vasp-expresso': vaspExpresso, veloces, venipak, 'via-cargo': viaCargo, 'viettel-post': viettelPost,
-    'vinted-go': vintedGo, wanbexpress, whistl, winit, 'xde-logistics': xdeLogistics, xdp, xlcourier, 'xpo-ltl': xpoLtl,
+    'vinted-go': vintedGo, 'vrl-logistics': vrlLogistics, wanbexpress, whistl, winit, 'xde-logistics': xdeLogistics, xdp, xlcourier, 'xpo-ltl': xpoLtl,
     'yilong-logistics': yilongLogistics, yunexpress, zto,
     'yurtici-kargo': yurticiKargo, zajil, zeleris, 'zr-express': zrExpress,
 };

package/dist/data/catalog.json

@@ -15237,7 +15237,8 @@
         "timezone": "America/New_York",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "gsi-express",
+            "localClocks": true
         },
         "canaryUrl": "https://www.gsiexpress.com/tracking_query.php",
         "trackingUrlTemplate": "https://www.gsiexpress.com/track_pop.php?textfield={trackingNumber}&track_type=invoice_no",
@@ -29631,7 +29632,9 @@
         "timezone": "Asia/Kolkata",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "vrl-logistics",
+            "recognitionRank": 935,
+            "localClocks": true
         },
         "canaryUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",
         "trackingSearchUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",

package/dist/generated/catalog.d.ts

@@ -9845,7 +9845,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "America/New_York";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "gsi-express";
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.gsiexpress.com/tracking_query.php";
         readonly trackingUrlTemplate: "https://www.gsiexpress.com/track_pop.php?textfield={trackingNumber}&track_type=invoice_no";
@@ -18868,7 +18869,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Asia/Kolkata";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "vrl-logistics";
+            readonly recognitionRank: 935;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.vrlgroup.in/Tracking/TrackShipment";
         readonly trackingSearchUrl: "https://www.vrlgroup.in/Tracking/TrackShipment";

package/dist/generated/catalog.js

@@ -15238,7 +15238,8 @@ export const CARRIER_CATALOG = {
         "timezone": "America/New_York",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "gsi-express",
+            "localClocks": true
         },
         "canaryUrl": "https://www.gsiexpress.com/tracking_query.php",
         "trackingUrlTemplate": "https://www.gsiexpress.com/track_pop.php?textfield={trackingNumber}&track_type=invoice_no",
@@ -29632,7 +29633,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Asia/Kolkata",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "vrl-logistics",
+            "recognitionRank": 935,
+            "localClocks": true
         },
         "canaryUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",
         "trackingSearchUrl": "https://www.vrlgroup.in/Tracking/TrackShipment",

package/dist/generated/recognition.js

@@ -322,6 +322,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "venipak": 240,
     "via-cargo": 936,
     "vinted-go": 410,
+    "vrl-logistics": 935,
     "wanbexpress": 33,
     "whistl": 320,
     "winit": 855,

package/dist/generated/registry.js

@@ -193,6 +193,7 @@ import { adapter as gofoFr } from '../carriers/gofo-fr/adapter.js';
 import { adapter as gofoIt } from '../carriers/gofo-it/adapter.js';
 import { adapter as gofoNl } from '../carriers/gofo-nl/adapter.js';
 import { adapter as gogoXpress } from '../carriers/gogo-xpress/adapter.js';
+import { adapter as gsiExpress } from '../carriers/gsi-express/adapter.js';
 import { adapter as gzyl } from '../carriers/gzyl/adapter.js';
 import { adapter as hanjin } from '../carriers/hanjin/adapter.js';
 import { adapter as happyPost } from '../carriers/happy-post/adapter.js';
@@ -443,6 +444,7 @@ import { adapter as venipak } from '../carriers/venipak/adapter.js';
 import { adapter as viaCargo } from '../carriers/via-cargo/adapter.js';
 import { adapter as viettelPost } from '../carriers/viettel-post/adapter.js';
 import { adapter as vintedGo } from '../carriers/vinted-go/adapter.js';
+import { adapter as vrlLogistics } from '../carriers/vrl-logistics/adapter.js';
 import { adapter as wanbexpress } from '../carriers/wanbexpress/adapter.js';
 import { adapter as whistl } from '../carriers/whistl/adapter.js';
 import { adapter as winit } from '../carriers/winit/adapter.js';
@@ -658,6 +660,7 @@ export const REGISTRY = {
         "gofo-it": gofoIt,
         "gofo-nl": gofoNl,
         "gogo-xpress": gogoXpress,
+        "gsi-express": gsiExpress,
         "gzyl": gzyl,
         "hanjin": hanjin,
         "happy-post": happyPost,
@@ -908,6 +911,7 @@ export const REGISTRY = {
         "via-cargo": viaCargo,
         "viettel-post": viettelPost,
         "vinted-go": vintedGo,
+        "vrl-logistics": vrlLogistics,
         "wanbexpress": wanbexpress,
         "whistl": whistl,
         "winit": winit,
@@ -1234,7 +1238,7 @@ export const REGISTRY = {
         "grand-slam-express": "universal",
         "groupe-guilbault": "universal",
         "gs-postbox": "universal",
-        "gsi-express": "universal",
+        "gsi-express": "gsi-express",
         "gta-airskip": "universal",
         "gtl-goto": "universal",
         "guatex": "universal",
@@ -1666,7 +1670,7 @@ export const REGISTRY = {
         "vitran-express": "universal",
         "vnpost": "universal",
         "vozovoz": "universal",
-        "vrl-logistics": "universal",
+        "vrl-logistics": "vrl-logistics",
         "wahana": "universal",
         "wanbexpress": "wanbexpress",
         "ward-trucking": "universal",

package/dist/server/openapi.json

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

package/package.json

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