universal-parcel-scraper 0.63.0-main.816 → 0.64.0-main.817

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 **119 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **120 dedicated adapters** and **5 universal fallbacks**
 
 <sub>128 catalog entries · 58 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 3,335 such statuses, each filed under one stage.
+The carrier folders record 3,341 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

@@ -5279,8 +5279,10 @@
     "selectable": true,
     "timezone": "UTC",
     "tracking": {
-      "mode": "link-only",
-      "adapter": null
+      "mode": "automatic",
+      "adapter": "j-and-t-cargo",
+      "recognitionRank": 47,
+      "localClocks": true
     },
     "canaryUrl": "https://www.jtcargo.id/",
     "trackingUrlTemplate": "https://www.jtcargo.id/networkQuery?waybillNo={trackingNumber}&type=0",
@@ -5299,6 +5301,10 @@
       {
         "pattern": "^20\\d{10}$",
         "confidence": "low"
+      },
+      {
+        "pattern": "^20\\d{13}$",
+        "confidence": "low"
       }
     ]
   },

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 128,
-  "activeAdapters": 119,
+  "activeAdapters": 120,
   "countries": 58,
   "referenceCarriers": 114,
   "comparison": {

package/data/detection-golden.json

@@ -5556,6 +5556,7 @@
       "sf-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5583,6 +5584,7 @@
       "fedex"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5606,6 +5608,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5630,6 +5633,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5653,6 +5657,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5678,10 +5683,10 @@
     ],
     "asked": [
       "purolator",
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
-      "sto",
-      "j-and-t"
+      "sto"
     ]
   },
   {
@@ -5701,6 +5706,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5724,6 +5730,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5770,6 +5777,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5794,6 +5802,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5820,6 +5829,7 @@
       "sagawa"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5861,6 +5871,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5884,6 +5895,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -5896,9 +5908,11 @@
     "confidence": "low",
     "candidates": [
       "brt",
-      "yunda"
+      "yunda",
+      "j-and-t-cargo"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt"
     ]
   },
@@ -5956,6 +5970,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",
@@ -6001,6 +6016,7 @@
       "lbc-express"
     ],
     "asked": [
+      "j-and-t-cargo",
       "brt",
       "colis-prive",
       "sto",

package/dist/browser/scraper.js

@@ -4267,8 +4267,10 @@ var be = {
 		selectable: !0,
 		timezone: "UTC",
 		tracking: {
-			mode: "link-only",
-			adapter: null
+			mode: "automatic",
+			adapter: "j-and-t-cargo",
+			recognitionRank: 47,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.jtcargo.id/",
 		trackingUrlTemplate: "https://www.jtcargo.id/networkQuery?waybillNo={trackingNumber}&type=0",
@@ -4280,6 +4282,9 @@ var be = {
 		detectionRules: [{
 			pattern: "^20\\d{10}$",
 			confidence: "low"
+		}, {
+			pattern: "^20\\d{13}$",
+			confidence: "low"
 		}]
 	},
 	"lbc-express": {
@@ -4846,7 +4851,7 @@ var be = {
 		"intelcom-2",
 		"intelcom-3"
 	],
-	"j-and-t-cargo": ["j-and-t-cargo-1"],
+	"j-and-t-cargo": ["j-and-t-cargo-1", "j-and-t-cargo-2"],
 	"lbc-express": ["lbc-domestic"],
 	"nova-poshta": ["nova-poshta-domestic"],
 	omgo: ["omgo-1"],
@@ -9554,6 +9559,7 @@ var mc = {
 	"hermes-de": 40,
 	inpost: 38,
 	"j-and-t": 9,
+	"j-and-t-cargo": 47,
 	"la-poste": 80,
 	nacex: 41,
 	"ninja-van": 28,

package/dist/carriers/j-and-t-cargo/adapter.d.ts

@@ -0,0 +1,12 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+export declare class JntCargoTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<import("../../index.js").CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/j-and-t-cargo/adapter.js

@@ -0,0 +1,51 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { BudgetExceededError, CarrierError, UpstreamHttpError, UpstreamNetworkError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { JNT_CARGO_ENDPOINT, JNT_CARGO_MAX_BYTES, JNT_CARGO_PROVIDER, normalizeJntCargoNumber, parseJntCargoJson } from './parser.js';
+export class JntCargoTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeJntCargoNumber(raw);
+        const budgetMs = context.budgetMs ?? 15_000;
+        if (!Number.isFinite(budgetMs))
+            throw new TypeError('J&T Cargo budget must be finite');
+        return runSteps({ carrier: JNT_CARGO_PROVIDER, budgetMs, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    try {
+                        const { bytes } = await fetchBounded(JNT_CARGO_ENDPOINT, {
+                            method: 'POST', signal, headers: { 'Content-Type': 'application/json', 'User-Agent': userAgentOf(this.options.userAgent) },
+                            body: JSON.stringify({ waybillNo: number, langType: 'EN', searchWaybillOrCustomerOrderId: '1' }),
+                        }, { provider: JNT_CARGO_PROVIDER, timeoutMs: Math.max(1, Math.floor(remainingMs)), maxBytes: JNT_CARGO_MAX_BYTES,
+                            fetcher: this.options.fetcher });
+                        signal.throwIfAborted();
+                        return parseJntCargoJson(decodeText(bytes), number);
+                    }
+                    catch (error) {
+                        if (signal.aborted) {
+                            if (signal.reason instanceof DOMException && signal.reason.name === 'TimeoutError')
+                                throw new BudgetExceededError(JNT_CARGO_PROVIDER, budgetMs);
+                            throw signal.reason;
+                        }
+                        // Bounded transport diagnostics can contain the waybill or recipient
+                        // details. Keep the taxonomy and retry window without those payloads.
+                        if (error instanceof UpstreamHttpError || error instanceof UpstreamNetworkError) {
+                            const kind = error instanceof UpstreamHttpError && [404, 410].includes(error.status) ? 'transport' : error.kind;
+                            throw new CarrierError(kind, JNT_CARGO_PROVIDER, `J&T Cargo tracking failed (${kind})`, {
+                                status: error.status, retryAfterMs: error.retryAfterMs, reason: error.reason,
+                            });
+                        }
+                        throw error;
+                    }
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new JntCargoTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return { id: JNT_CARGO_PROVIDER, recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeJntCargoNumber(number))) };
+};

package/dist/carriers/j-and-t-cargo/carrier.json

@@ -16,25 +16,26 @@
   "selectable": true,
   "timezone": "UTC",
   "tracking": {
-    "mode": "link-only",
-    "adapter": null,
-    "steps": []
+    "mode": "automatic",
+    "adapter": "j-and-t-cargo",
+    "steps": ["direct"],
+    "recognition": { "rank": 47 },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": ["history", "location", "provider_code", "service_name"],
   "portal": {
     "url": "https://www.jtcargo.id/networkQuery?waybillNo={trackingNumber}&type=0",
     "searchUrl": "https://www.jtcargo.id/networkQuery",
     "canaryUrl": "https://www.jtcargo.id/",
     "shows": [
       "status",
-      "history"
+      "history",
+      "location",
+      "service_name"
     ],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": [
-      "status",
-      "history"
-    ]
+    "scraped": ["status", "history", "location", "provider_code", "service_name"],
+    "discarded": ["customer_messages", "recipient_details", "staff_details", "proof_images", "consignment_totals", "progress_rail"],
+    "unavailable": []
   },
   "links": [
     {
@@ -51,6 +52,11 @@
       "id": "j-and-t-cargo-1",
       "pattern": "^20\\d{10}$",
       "confidence": "low"
+    },
+    {
+      "id": "j-and-t-cargo-2",
+      "pattern": "^20\\d{13}$",
+      "confidence": "low"
     }
   ]
 }

package/dist/carriers/j-and-t-cargo/numbers.json

@@ -444,7 +444,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate",
+        "assessment": "confirmed",
         "service": "jt cargo multi piece 44",
         "reportedRole": "master_consignment"
       },
@@ -477,7 +477,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate",
+        "assessment": "confirmed",
         "service": "jt cargo multi piece",
         "reportedRole": "child_consignment"
       },
@@ -486,7 +486,8 @@
         "confidence": "low",
         "candidates": [
           "brt",
-          "yunda"
+          "yunda",
+          "j-and-t-cargo"
         ]
       },
       "note": "J&T Cargo's public reply identifies this piece of the linked consignment.",
@@ -514,7 +515,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate",
+        "assessment": "confirmed",
         "service": "jt cargo insured fragile",
         "reportedRole": "reported_shipment"
       },

package/dist/carriers/j-and-t-cargo/parser.d.ts

@@ -0,0 +1,8 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const JNT_CARGO_PROVIDER = "j-and-t-cargo";
+export declare const JNT_CARGO_ENDPOINT = "https://office.jtcargo.co.id/official/waybill/trackingCustomerByWaybillNo";
+export declare const JNT_CARGO_MAX_BYTES = 2000000;
+export declare function normalizeJntCargoNumber(raw: string): string;
+/** Parse exactly the requested master or piece, never an aggregate of related waybills. */
+export declare function parseJntCargo(payload: unknown, rawNumber: string): CarrierResult;
+export declare function parseJntCargoJson(text: string, number: string): CarrierResult;

package/dist/carriers/j-and-t-cargo/parser.js

@@ -0,0 +1,124 @@
+import { DateTime } from 'luxon';
+import { isJntCargoTrackingNumber } from '../../core/detection/jntCargo.js';
+import { normalizeTrackingNumber } from '../../core/detection/normalize.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, SchemaError } from '../../core/errors/index.js';
+import { classifyWording, languageStageStatus } from '../../core/status/index.js';
+import { clean } from '../../core/transport/text.js';
+import { isRecord } from '../../core/types.js';
+import { jntCargoStage } from './status.js';
+export const JNT_CARGO_PROVIDER = 'j-and-t-cargo';
+export const JNT_CARGO_ENDPOINT = 'https://office.jtcargo.co.id/official/waybill/trackingCustomerByWaybillNo';
+export const JNT_CARGO_MAX_BYTES = 2_000_000;
+const MAX_SCANS = 500;
+export function normalizeJntCargoNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!isJntCargoTrackingNumber(number))
+        throw new InvalidInputError(JNT_CARGO_PROVIDER, 'J&T Cargo requires a supported master or piece waybill');
+    return number;
+}
+function invalid(message = 'J&T Cargo returned an invalid tracking reply') {
+    throw new SchemaError(JNT_CARGO_PROVIDER, message);
+}
+function optionalText(value, limit) {
+    if (value != null && typeof value !== 'string')
+        invalid('J&T Cargo returned an invalid scan field');
+    return clean(value, limit);
+}
+/** UTC validates the calendar only: Indonesia has three zones, and the feed establishes none. */
+function localClock(value) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2} (?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d$/.test(value)) {
+        invalid('J&T Cargo returned an invalid scan clock');
+    }
+    const local = value.replace(' ', 'T');
+    const parsed = DateTime.fromISO(local, { zone: 'UTC' });
+    if (!parsed.isValid || parsed.year < 2000)
+        invalid('J&T Cargo returned an invalid scan clock');
+    return local;
+}
+function project(row, number) {
+    if (!isRecord(row) || row.billCode !== number)
+        invalid('J&T Cargo returned a scan of a different waybill');
+    const code = typeof row.code === 'number' && Number.isInteger(row.code) && row.code >= 0 && row.code <= 999999
+        ? String(row.code) : typeof row.code === 'string' && /^\d{1,6}$/.test(row.code) ? row.code : invalid('J&T Cargo returned an invalid scan code');
+    // These are the feed's fixed labels. The customer sentence, remarks, staff
+    // and proof fields contain personal details and are never projected.
+    const description = optionalText(row.status, 100) || optionalText(row.scanTypeName, 100);
+    if (!description)
+        invalid('J&T Cargo returned an empty scan label');
+    const location = [optionalText(row.scanNetworkCity, 100), optionalText(row.scanNetworkProvince, 100)].filter(Boolean).join(', ');
+    const mapped = jntCargoStage(code);
+    const wording = mapped ? undefined : classifyWording(description, 'pending');
+    return { description, local_time: localClock(row.scanTime), provider_code: code,
+        ...(location ? { location } : {}),
+        stage: mapped ?? wording.stage, stage_source: mapped ? 'carrier_map' : wording.source };
+}
+/** Parse exactly the requested master or piece, never an aggregate of related waybills. */
+export function parseJntCargo(payload, rawNumber) {
+    const number = normalizeJntCargoNumber(rawNumber);
+    if (!isRecord(payload) || typeof payload.code !== 'number' || !Number.isInteger(payload.code)
+        || typeof payload.succ !== 'boolean' || typeof payload.fail !== 'boolean')
+        invalid();
+    // The official client treats these as expired/refused account authentication.
+    // A future gate must not be reported as a missing shipment.
+    if ([148013016, 148013017].includes(payload.code))
+        throw new ChallengeError(JNT_CARGO_PROVIDER, 'J&T Cargo refused tracking authentication');
+    if (payload.code !== 1 || !payload.succ || payload.fail)
+        throw new IndeterminateError(JNT_CARGO_PROVIDER, 'J&T Cargo could not complete the tracking request');
+    if (!Array.isArray(payload.data))
+        invalid();
+    if (!payload.data.length)
+        throw new IndeterminateError(JNT_CARGO_PROVIDER, 'J&T Cargo returned no identity-bound history');
+    if (payload.data.length !== 1)
+        invalid('J&T Cargo returned several waybills');
+    const bill = payload.data[0];
+    if (!isRecord(bill) || bill.keyword !== number)
+        invalid('J&T Cargo returned a different waybill');
+    // Unknown numbers return a success envelope with the query echoed and null
+    // shipment fields. That placeholder does not establish absence or ownership.
+    if (bill.details === null || Array.isArray(bill.details) && !bill.details.length) {
+        throw new IndeterminateError(JNT_CARGO_PROVIDER, 'J&T Cargo returned the waybill without shipment history');
+    }
+    if (!Array.isArray(bill.details))
+        invalid();
+    if (bill.details.length > MAX_SCANS)
+        invalid('J&T Cargo returned excessive tracking history');
+    const events = [];
+    const seen = new Set();
+    for (const scan of bill.details) {
+        const event = project(scan, number);
+        const key = JSON.stringify(event);
+        if (!seen.has(key)) {
+            seen.add(key);
+            events.push(event);
+        }
+    }
+    // The public client displays this newest-first order. Local clocks cannot
+    // safely reorder scans between facilities in different Indonesian zones.
+    const latest = events[0];
+    const stage = latest.stage_source === 'none' ? undefined : latest.stage;
+    const service = optionalText(bill.expressTypeName, 80);
+    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,
+        ...(service ? { service_name: service } : {}), ...(events.length > 100 ? { history_truncated: true } : {}),
+        events: events.slice(0, 100) };
+}
+export function parseJntCargoJson(text, number) {
+    if (text.length > JNT_CARGO_MAX_BYTES || new TextEncoder().encode(text).length > JNT_CARGO_MAX_BYTES)
+        invalid('J&T Cargo returned excessive tracking data');
+    const body = text.replace(/^\uFEFF/, '').trim();
+    if (/^</.test(body) && /<title>\s*Just a moment|cf-chl-|challenge-platform|cf-turnstile|captcha|access denied|captcha-delivery\.com/i.test(body)
+        || /^access denied\b/i.test(body)) {
+        throw new ChallengeError(JNT_CARGO_PROVIDER);
+    }
+    if (!body)
+        throw new IndeterminateError(JNT_CARGO_PROVIDER, 'J&T Cargo returned an empty reply');
+    let payload;
+    try {
+        payload = JSON.parse(body);
+    }
+    catch {
+        invalid('J&T Cargo returned invalid tracking JSON');
+    }
+    return parseJntCargo(payload, number);
+}

package/dist/carriers/j-and-t-cargo/status.d.ts

@@ -0,0 +1,4 @@
+import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+export declare const jntCargoStage: (code: string) => Stage | undefined;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/j-and-t-cargo/status.js

@@ -0,0 +1,4 @@
+import statuses from './statuses.json' with { type: 'json' };
+const STAGES = new Map(statuses.entries.map(entry => [entry.code, entry.stage]));
+export const jntCargoStage = (code) => STAGES.get(code);
+export const statusMap = { stage: code => code ? jntCargoStage(code) : undefined, gaps: [] };

package/dist/carriers/j-and-t-cargo/statuses.json

@@ -1,4 +1,11 @@
 {
   "carrier": "j-and-t-cargo",
-  "entries": []
+  "entries": [
+    { "code": "10", "wording": "sudah di ambil", "language": "id", "stage": "accepted", "confirmedBy": "live" },
+    { "code": "50", "wording": "dalam proses delivery", "language": "id", "stage": "in_transit", "confirmedBy": "live", "note": "Departure scan, not final delivery." },
+    { "code": "90", "wording": "dalam proses delivery", "language": "id", "stage": "in_transit", "confirmedBy": "live", "note": "Arrival at an operations centre." },
+    { "code": "92", "wording": "dalam proses delivery", "language": "id", "stage": "in_transit", "confirmedBy": "live", "note": "Arrival at an outlet." },
+    { "code": "94", "wording": "dalam proses distribusi", "language": "id", "stage": "out_for_delivery", "confirmedBy": "live" },
+    { "code": "100", "wording": "Sudah Diterima", "language": "id", "stage": "delivered", "confirmedBy": "live" }
+  ]
 }

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

@@ -5,7 +5,7 @@ import { type StepRecorder } from '../../core/telemetry/index.js';
 import { TrawlClient } from '../../core/transport/index.js';
 export declare function upsTrackingUrl(trackingNumber: string): string;
 /**
- * Akamai rejected the session (HTTP 401/403/419/429, or a page that carries no
+ * Akamai rejected the session (HTTP 401/403/419, or a page that carries no
  * XSRF token). It stays a distinct class because the adapter reacts to it: the
  * cached session is refreshed once, then dropped, before the browser tier runs.
  */

package/dist/carriers/ups/adapter.js

@@ -1,7 +1,7 @@
 import { load } from 'cheerio';
 import makeFetchCookie from 'fetch-cookie';
 import { CookieJar } from 'tough-cookie';
-import { ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError, TransportError } from '../../core/errors/index.js';
+import { carrierErrorKind, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
 import { isValidUpsTrackingNumber } from '../../core/detection/ups.js';
 import { uspsPackageIdentifier } from '../../core/detection/usps.js';
 import { runSteps, singleFlight, takeTurn } from '../../core/runner/index.js';
@@ -21,7 +21,7 @@ const DEFAULT_TIMEOUT_MS = 90_000;
 const DEFAULT_DIRECT_TIMEOUT_MS = 20_000;
 // How long the browser may wait for the page's own status call after the page settles.
 const SETTLE_TIMEOUT_MS = 15_000;
-// Captured replies beyond this many are noise, never the answer.
+// Retain the latest bounded sequence of matching replies.
 const MAX_CAPTURED = 20;
 // Provider strings are short; the rendered page's whole text is not, and the
 // identity check reads all of it, so it passes its own limit to `clean`.
@@ -34,7 +34,7 @@ export function upsTrackingUrl(trackingNumber) {
     return url.toString();
 }
 /**
- * Akamai rejected the session (HTTP 401/403/419/429, or a page that carries no
+ * Akamai rejected the session (HTTP 401/403/419, or a page that carries no
  * XSRF token). It stays a distinct class because the adapter reacts to it: the
  * cached session is refreshed once, then dropped, before the browser tier runs.
  */
@@ -133,15 +133,27 @@ class UPSHttpSession {
         }
     }
     async request(url, init, description, bounds) {
-        const result = await fetchBounded(url, { ...init, signal: bounds.signal }, {
-            provider: description,
-            timeoutMs: Math.max(1, Math.floor(Math.min(this.timeoutMs, bounds.deadline - performance.now()))),
-            maxBytes: MAX_BYTES,
-            redirect: 'follow',
-            fetcher: this.#fetcher,
-            allowHttpError: true,
-        });
-        if ([401, 403, 419, 429].includes(result.response.status)) {
+        let result;
+        try {
+            result = await fetchBounded(url, { ...init, signal: bounds.signal }, {
+                provider: description,
+                timeoutMs: Math.max(1, Math.floor(Math.min(this.timeoutMs, bounds.deadline - performance.now()))),
+                maxBytes: MAX_BYTES,
+                redirect: 'follow',
+                fetcher: this.#fetcher,
+                allowHttpStatuses: [401, 403, 419],
+            });
+        }
+        catch (error) {
+            // A throttle keeps the transport's status and Retry-After and never
+            // refreshes the session. Other HTTP failures retain UPS's inconclusive
+            // classification: even a 404 says nothing about the shipment.
+            if (error instanceof UpstreamHttpError && error.status !== 429) {
+                throw new IndeterminateError('UPS', `${description} returned HTTP ${error.status}`);
+            }
+            throw error;
+        }
+        if ([401, 403, 419].includes(result.response.status)) {
             throw new UPSSessionRejected(`${description} returned HTTP ${result.response.status}`);
         }
         // Any other rejected status proves nothing about the shipment, so the
@@ -154,7 +166,20 @@ class UPSHttpSession {
 }
 /** An answer no other tier or rendered page may replace. */
 function isFinalAnswer(error) {
-    return error instanceof InvalidInputError || error instanceof NotFoundError || error instanceof UPSUnavailableError;
+    return error instanceof InvalidInputError || error instanceof NotFoundError || error instanceof UPSUnavailableError
+        || carrierErrorKind(error) === 'rate_limited';
+}
+/** Headers from a captured response are case-insensitive, like HTTP headers. */
+function capturedHttpError(status, headers) {
+    if (status === 404 || status === 410) {
+        return new IndeterminateError('UPS', `UPS status API returned HTTP ${status}`);
+    }
+    if (status === 419)
+        return new ChallengeError('UPS', 'UPS rejected the browser session', { status });
+    const retryHeader = Object.entries(headers).find(([key]) => key.toLowerCase() === 'retry-after')?.[1];
+    const delay = retryHeader === undefined ? NaN : /^\d+$/.test(retryHeader.trim())
+        ? Number(retryHeader) * 1_000 : Date.parse(retryHeader) - Date.now();
+    return new UpstreamHttpError('UPS', status, Number.isFinite(delay) ? Math.max(0, delay) : undefined);
 }
 function withoutIcons(value) {
     return clean(value.replace(/\b(?:check_circle|content_copy|expand_more|check)\b/g, ' '));
@@ -530,28 +555,31 @@ export class UPSTracker {
             maxBytes: MAX_BYTES,
             fetcher: this.#fetcher,
             signal,
+            captureWindow: 'last',
         });
-        let captureError;
-        // Newest first: a later reply is the page's final answer.
-        for (const entry of page.capturedResponses.slice(0, MAX_CAPTURED).reverse()) {
-            if (entry.url !== STATUS_API || entry.status !== 200 || entry.truncated || entry.body === null)
-                continue;
+        // The last matching response is authoritative. An earlier success cannot
+        // answer after the page's retry was refused or returned invalid data.
+        const entry = page.capturedResponses.filter((capture) => capture.url === STATUS_API).slice(-MAX_CAPTURED).at(-1);
+        // UPS's 428 verification flow can still leave a valid rendered answer.
+        if (entry && entry.status !== 428) {
+            if (entry.status >= 400)
+                throw capturedHttpError(entry.status, entry.headers);
+            if (entry.status !== 200 || entry.truncated || entry.body === null || entry.base64Encoded || entry.error) {
+                throw new SchemaError('UPS', 'UPS returned an unreadable status response');
+            }
+            let payload;
             try {
-                return this.#structuredResult(number, JSON.parse(entry.body));
+                payload = JSON.parse(entry.body);
             }
-            catch (error) {
-                if (isFinalAnswer(error))
-                    throw error;
-                // An unreadable or unrelated reply; the rendered page may still answer.
-                captureError = error instanceof Error ? error : new SchemaError('UPS', 'UPS returned invalid tracking data', { cause: error });
+            catch {
+                throw new SchemaError('UPS', 'UPS returned invalid tracking JSON');
             }
+            return this.#structuredResult(number, payload);
         }
         try {
             return this.#renderedResult(page.html, number);
         }
         catch (error) {
-            if (captureError)
-                throw captureError;
             throw new TransportError('UPS', 'TRAWL did not capture the UPS status response', { cause: error });
         }
     }

package/dist/core/catalog/statusMaps.js

@@ -24,6 +24,7 @@ import { statusMap as emile } from '../../carriers/emile/status.js';
 import { statusMap as gofoFr } from '../../carriers/gofo-fr/status.js';
 import { statusMap as gofoIt } from '../../carriers/gofo-it/status.js';
 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 oldDominion } from '../../carriers/old-dominion/status.js';
 import { statusMap as omgo } from '../../carriers/omgo/status.js';
@@ -43,7 +44,7 @@ import { CARRIER_DEFINITIONS } from './definitions.js';
 export const STATUS_MAPS = {
     aliexpress, 'an-post': anPost, 'china-post': chinaPost, chronopost, 'correos-spain': correosSpain, 'dhl-express': dhlExpress,
     dpd, 'dpd-de': dpdDe, 'dpd-fr': dpdFr, 'dpd-pl': dpdPl, emile, 'gofo-fr': gofoFr, 'gofo-it': gofoIt,
-    'j-and-t': jAndT, 'la-poste': laPoste, 'old-dominion': oldDominion, omgo,
+    'j-and-t': jAndT, 'j-and-t-cargo': jntCargo, 'la-poste': laPoste, 'old-dominion': oldDominion, omgo,
     postlogistics, sagawa, speedx, sto, 'swiss-post': swissPost, 'thailand-post': thailandPost, tnt, ups, yunexpress,
 };
 /** The carrier the app files the universal providers' scans under. */

package/dist/core/detection/jntCargo.d.ts

@@ -0,0 +1,5 @@
+/** J&T Cargo Indonesia masters and pieces confirmed by its own tracking feed. */
+export declare const JNT_CARGO_MASTER_PATTERN = "^20\\d{10}$";
+export declare const JNT_CARGO_PIECE_PATTERN = "^20\\d{13}$";
+/** Shape eligibility only; neither a master nor a piece is confirmed offline. */
+export declare function isJntCargoTrackingNumber(number: string): boolean;

package/dist/core/detection/jntCargo.js

@@ -0,0 +1,9 @@
+/** J&T Cargo Indonesia masters and pieces confirmed by its own tracking feed. */
+export const JNT_CARGO_MASTER_PATTERN = '^20\\d{10}$';
+export const JNT_CARGO_PIECE_PATTERN = '^20\\d{13}$';
+const MASTER = new RegExp(JNT_CARGO_MASTER_PATTERN);
+const PIECE = new RegExp(JNT_CARGO_PIECE_PATTERN);
+/** Shape eligibility only; neither a master nor a piece is confirmed offline. */
+export function isJntCargoTrackingNumber(number) {
+    return MASTER.test(number) || PIECE.test(number);
+}

package/dist/core/transport/trawl.d.ts

@@ -54,6 +54,8 @@ export interface TrawlCallOptions {
     signal?: AbortSignal;
     /** Require a solved browser tier (2 or 3) with HTTP 200. Default true. */
     requireSolved?: boolean;
+    /** Which bounded capture window to retain. Defaults to the first 50 responses. */
+    captureWindow?: 'first' | 'last';
 }
 export declare class TrawlError extends CarrierError {
     constructor(provider: string, message: string, options?: CarrierErrorOptions);

package/dist/core/transport/trawl.js

@@ -64,10 +64,11 @@ export function trawlEndpoint(configured) {
     endpoint.hash = '';
     return endpoint;
 }
-function captured(value) {
+function captured(value, window = 'first') {
     if (!Array.isArray(value))
         return [];
-    return value.filter(isRecord).slice(0, 50).map((entry) => ({
+    const records = value.filter(isRecord);
+    return (window === 'last' ? records.slice(-50) : records.slice(0, 50)).map((entry) => ({
         url: typeof entry.url === 'string' ? entry.url : '',
         status: Number.isInteger(entry.status) ? Number(entry.status) : 0,
         headers: isRecord(entry.headers)
@@ -238,7 +239,7 @@ export class TrawlClient {
             userAgent: typeof value.userAgent === 'string' ? value.userAgent : null,
             tier,
             statusCode,
-            capturedResponses: captured(value.capturedResponses),
+            capturedResponses: captured(value.capturedResponses, options.captureWindow),
             raw: value,
         };
     }

package/dist/data/catalog.json

@@ -5279,8 +5279,10 @@
         "selectable": true,
         "timezone": "UTC",
         "tracking": {
-            "mode": "link-only",
-            "adapter": null
+            "mode": "automatic",
+            "adapter": "j-and-t-cargo",
+            "recognitionRank": 47,
+            "localClocks": true
         },
         "canaryUrl": "https://www.jtcargo.id/",
         "trackingUrlTemplate": "https://www.jtcargo.id/networkQuery?waybillNo={trackingNumber}&type=0",
@@ -5299,6 +5301,10 @@
             {
                 "pattern": "^20\\d{10}$",
                 "confidence": "low"
+            },
+            {
+                "pattern": "^20\\d{13}$",
+                "confidence": "low"
             }
         ]
     },

package/dist/generated/catalog.d.ts

@@ -3606,8 +3606,10 @@ export declare const CARRIER_CATALOG: {
         readonly selectable: true;
         readonly timezone: "UTC";
         readonly tracking: {
-            readonly mode: "link-only";
-            readonly adapter: null;
+            readonly mode: "automatic";
+            readonly adapter: "j-and-t-cargo";
+            readonly recognitionRank: 47;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.jtcargo.id/";
         readonly trackingUrlTemplate: "https://www.jtcargo.id/networkQuery?waybillNo={trackingNumber}&type=0";
@@ -3619,6 +3621,9 @@ export declare const CARRIER_CATALOG: {
         readonly detectionRules: readonly [{
             readonly pattern: "^20\\d{10}$";
             readonly confidence: "low";
+        }, {
+            readonly pattern: "^20\\d{13}$";
+            readonly confidence: "low";
         }];
     };
     readonly "lbc-express": {

package/dist/generated/catalog.js

@@ -5280,8 +5280,10 @@ export const CARRIER_CATALOG = {
         "selectable": true,
         "timezone": "UTC",
         "tracking": {
-            "mode": "link-only",
-            "adapter": null
+            "mode": "automatic",
+            "adapter": "j-and-t-cargo",
+            "recognitionRank": 47,
+            "localClocks": true
         },
         "canaryUrl": "https://www.jtcargo.id/",
         "trackingUrlTemplate": "https://www.jtcargo.id/networkQuery?waybillNo={trackingNumber}&type=0",
@@ -5300,6 +5302,10 @@ export const CARRIER_CATALOG = {
             {
                 "pattern": "^20\\d{10}$",
                 "confidence": "low"
+            },
+            {
+                "pattern": "^20\\d{13}$",
+                "confidence": "low"
             }
         ]
     },
@@ -5837,7 +5843,7 @@ export const DETECTION_RULE_IDS = {
     "gofo-fr": ["gofo-fr-1", "gofo-fr-2"],
     "gofo-it": ["gofo-it-1"],
     "intelcom": ["intelcom-1", "intelcom-2", "intelcom-3"],
-    "j-and-t-cargo": ["j-and-t-cargo-1"],
+    "j-and-t-cargo": ["j-and-t-cargo-1", "j-and-t-cargo-2"],
     "lbc-express": ["lbc-domestic"],
     "nova-poshta": ["nova-poshta-domestic"],
     "omgo": ["omgo-1"],

package/dist/generated/recognition.js

@@ -33,6 +33,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "hermes-de": 40,
     "inpost": 38,
     "j-and-t": 9,
+    "j-and-t-cargo": 47,
     "la-poste": 80,
     "nacex": 41,
     "ninja-van": 28,

package/dist/generated/registry.js

@@ -64,6 +64,7 @@ import { adapter as indiaPost } from '../carriers/india-post/adapter.js';
 import { adapter as inpost } from '../carriers/inpost/adapter.js';
 import { adapter as intelcom } from '../carriers/intelcom/adapter.js';
 import { adapter as jAndT } from '../carriers/j-and-t/adapter.js';
+import { adapter as jAndTCargo } from '../carriers/j-and-t-cargo/adapter.js';
 import { adapter as japanPost } from '../carriers/japan-post/adapter.js';
 import { adapter as jdLogistics } from '../carriers/jd-logistics/adapter.js';
 import { adapter as koreaPost } from '../carriers/korea-post/adapter.js';
@@ -185,6 +186,7 @@ export const REGISTRY = {
         "inpost": inpost,
         "intelcom": intelcom,
         "j-and-t": jAndT,
+        "j-and-t-cargo": jAndTCargo,
         "japan-post": japanPost,
         "jd-logistics": jdLogistics,
         "korea-post": koreaPost,
@@ -309,7 +311,7 @@ export const REGISTRY = {
         "intelcom": "intelcom",
         "intl-post": "universal",
         "j-and-t": "j-and-t",
-        "j-and-t-cargo": null,
+        "j-and-t-cargo": "j-and-t-cargo",
         "japan-post": "japan-post",
         "jd-logistics": "jd-logistics",
         "korea-post": "korea-post",

package/dist/server/openapi.json

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

package/package.json

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