universal-parcel-scraper 0.181.0 → 0.183.0-main.1321

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

@@ -0,0 +1,190 @@
+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 { firstOccurrence } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { leopardsStage } from './status.js';
+export const PROVIDER = 'Leopards';
+// A results page is about 120 kB.
+export const LEOPARDS_MAX_BYTES = 1_000_000;
+export const LEOPARDS_ORIGIN = 'https://pk.leopardscourier.com';
+/** The lookup the tracking box sends the number to. */
+export const LEOPARDS_LOOKUP = `${LEOPARDS_ORIGIN}/shipment_tracking-new`;
+/** The page that shows the consignment the lookup kept in the session. */
+export const LEOPARDS_VIEW = `${LEOPARDS_ORIGIN}/shipment_tracking_view`;
+// Two letters and nine or ten digits. The tracker pads nine digits with a leading zero.
+const NUMBER = /^([A-Z]{2})(\d{9,10})$/;
+const ZONE = 'Asia/Karachi';
+// The date and the minute, as "22 September, 2026" and "(09:26)".
+const CLOCK_FORMAT = 'd MMMM, yyyy HH:mm';
+const DATE = /^\d{1,2} [A-Z][a-z]+, \d{4}$/;
+const MINUTE = /^\((\d{2}:\d{2})\)$/;
+const CONSIGNMENT = /^Consignment No\.\s*:\s*([A-Z0-9]{1,20})$/;
+const NOT_FOUND = /^Your query about "([^"]{0,64})" appeared to be invalid \/ record not found\./;
+// A wording that ends with the city it happened in, as "Inter Transfer at KARACHI".
+const PLACED = /^(.*\S)\s+(?:at|in)\s+([A-Z][A-Z .'()/-]*[A-Z.)])$/;
+// Bot checks and block pages a CDN or firewall could put in place of the site's.
+const BLOCKED = /_cf_chl_opt|cf-turnstile|g-recaptcha|hcaptcha|_Incapsula_Resource|AwsWafIntegration|awswaf\.com|<title>\s*(?:Just a moment|Attention Required|Access Denied|Request Rejected|403 Forbidden)/i;
+const MAX_EVENTS = 300;
+/** A Leopards consignment number: two letters and ten digits, nine digits taking a leading zero as the tracker does. */
+export function normalizeLeopardsNumber(raw) {
+    const match = NUMBER.exec(raw.length <= 64 ? normalizeTrackingNumber(raw) : '');
+    if (!match)
+        throw new InvalidInputError(PROVIDER, 'Leopards consignment numbers are two letters and nine or ten digits');
+    return `${match[1]}${match[2].padStart(10, '0')}`;
+}
+/** Whether a page is a firewall's or bot check's instead of the site's. */
+export function isLeopardsBlockPage(html) {
+    return BLOCKED.test(html.slice(0, 64_000));
+}
+/** The site's notice for a number it has no record of, and the number it names. */
+function notFoundNotice($) {
+    for (const cell of $('td').toArray()) {
+        const named = NOT_FOUND.exec(clean($(cell).text(), 400))?.[1];
+        if (named !== undefined)
+            return named;
+    }
+    return undefined;
+}
+/**
+ * The lookup's reply: `{"success":true}` once the site has kept the
+ * consignment in the session, or the tracking page with its notice for a
+ * number it has no record of.
+ */
+export function readLeopardsLookup(body, raw) {
+    const number = normalizeLeopardsNumber(raw);
+    if (/^\s*[{[]/.test(body)) {
+        let reply;
+        try {
+            reply = JSON.parse(body);
+        }
+        catch (cause) {
+            throw new SchemaError(PROVIDER, 'Leopards returned a reply that is not JSON', { cause });
+        }
+        if (!isRecord(reply) || typeof reply.success !== 'boolean')
+            throw new SchemaError(PROVIDER, 'Leopards returned an invalid lookup reply');
+        // The tracking box then opens the page with the site's notice; the reply says nothing about the parcel.
+        if (!reply.success)
+            throw new IndeterminateError(PROVIDER, 'Leopards did not complete the lookup');
+        return;
+    }
+    const named = notFoundNotice(load(body));
+    if (named === undefined) {
+        if (isLeopardsBlockPage(body))
+            throw new ChallengeError(PROVIDER, 'Leopards answered with a block page');
+        throw new SchemaError(PROVIDER, 'Leopards did not answer the lookup');
+    }
+    if (named !== number)
+        throw new IndeterminateError(PROVIDER, 'Leopards answered for another consignment');
+    throw new NotFoundError(PROVIDER);
+}
+/** A wall clock to the minute, read in Karachi time: Leopards' scans are made in Pakistan, which keeps one offset. */
+function clock(date, minute) {
+    const written = `${date} ${MINUTE.exec(minute)?.[1] ?? ''}`;
+    // UTC only checks the calendar fields. Luxon rolls 24:00 over to the next day.
+    const checked = DateTime.fromFormat(written, CLOCK_FORMAT, { zone: 'UTC', locale: 'en-US' });
+    // The day may be written with a leading zero.
+    if (!DATE.test(date) || !checked.isValid || ![CLOCK_FORMAT, `d${CLOCK_FORMAT}`].some(format => checked.toFormat(format, { locale: 'en-US' }) === written)) {
+        throw new SchemaError(PROVIDER, 'Leopards returned an invalid time');
+    }
+    const zoned = firstOccurrence(DateTime.fromISO(checked.toFormat("yyyy-MM-dd'T'HH:mm"), { zone: ZONE }));
+    return { time: zoned.toISO({ suppressMilliseconds: true }), at: zoned.toMillis() };
+}
+/** Who signed for the parcel, as the page's "Signed for by" line names them before a dash. */
+function signatoryOf($) {
+    const label = $('td').filter((_, cell) => clean($(cell).text(), 40) === 'Signed for by :').first();
+    return clean(label.next('td').text(), 200).replace(/\s*-(?:\s.*)?$/, '');
+}
+/**
+ * A wording without who took the parcel. A delivery reads "Delivered at
+ * LAHORE NAME ~ RELATION": the name is cut when it is the signatory's, else
+ * only the wording before the city is kept, or its first word without a city.
+ */
+function withoutReceiver(wording, signatory) {
+    const tilde = wording.indexOf('~');
+    if (tilde < 0)
+        return wording;
+    const head = wording.slice(0, tilde).trim();
+    if (signatory && head.toUpperCase().endsWith(` ${signatory.toUpperCase()}`)) {
+        const rest = head.slice(0, head.length - signatory.length).trim();
+        if (PLACED.test(rest))
+            return rest;
+    }
+    const parts = head.split(/\s+(?:at|in)\s+/);
+    return parts.length > 1 ? parts[0].trim() : head.split(' ')[0];
+}
+/**
+ * The tracking page for the consignment the lookup kept in the session: its
+ * number, a delivery box naming who signed, the booking details and its scans
+ * newest first, each with a date, a minute and Leopards' wording. The booking
+ * details, the signatory and the receiver named in a delivery's wording are
+ * not read.
+ */
+export function parseLeopards(html, raw) {
+    const number = normalizeLeopardsNumber(raw);
+    const $ = load(html);
+    const named = $('td').map((_, cell) => CONSIGNMENT.exec(clean($(cell).text(), 200))?.[1]).get();
+    if (!named.length) {
+        // The page without a consignment in the session names none: the session was not kept.
+        const notice = notFoundNotice($);
+        if (notice !== undefined)
+            throw new IndeterminateError(PROVIDER, 'Leopards did not keep the lookup in the session', { reason: 'session_rejected' });
+        if (isLeopardsBlockPage(html))
+            throw new ChallengeError(PROVIDER, 'Leopards answered with a block page');
+        throw new SchemaError(PROVIDER, 'Leopards did not return its tracking page');
+    }
+    if (named.length !== 1)
+        throw new SchemaError(PROVIDER, 'Leopards returned several consignments');
+    if (named[0] !== number)
+        throw new IndeterminateError(PROVIDER, 'Leopards answered for another consignment');
+    const items = $('.tracking-list .tracking-item');
+    if (items.length > MAX_EVENTS)
+        throw new SchemaError(PROVIDER, 'Leopards returned an invalid history');
+    const signatory = signatoryOf($);
+    const seen = new Set();
+    const scans = [];
+    items.each((order, node) => {
+        const item = $(node);
+        const date = item.find('.tracking-date');
+        const content = item.find('.tracking-content');
+        if (date.length !== 1 || content.length !== 1)
+            throw new SchemaError(PROVIDER, 'Leopards returned an invalid scan');
+        const minute = clean(date.find('span').text(), 16);
+        const when = clock(clean(date.clone().children().remove().end().text(), 40), minute);
+        const description = withoutReceiver(clean(content.text(), 300), signatory);
+        if (!description)
+            throw new SchemaError(PROVIDER, 'Leopards returned a scan without wording');
+        const location = PLACED.exec(description)?.[2];
+        const staged = leopardsStage(description);
+        const event = {
+            time: when.time, description, ...(location ? { location } : {}),
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        };
+        const identity = JSON.stringify([event.time, description]);
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        scans.push({ event, at: when.at, order });
+    });
+    if (!scans.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first; scans at the same minute keep the page's order, which is newest first.
+    const events = scans.sort((a, b) => b.at - a.at || a.order - b.order).map(({ event }) => event);
+    const newest = events[0];
+    const current = events.find(event => event.stage);
+    const stage = current?.stage;
+    const delivered = stage === 'delivered' ? current : undefined;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time,
+        expected_delivery: null,
+        ...(delivered ? { delivered_at: delivered.time } : {}),
+        ...(normalizeTrackingNumber(raw) !== number ? { canonical_tracking_number: number } : {}),
+        events,
+    };
+}

package/dist/carriers/leopards-courier/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 a Leopards wording starts with, read case-insensitively. */
+export declare function leopardsWordingStage(wording: string): Stage | undefined;
+/** A scan's stage: its wording, else the shared wording rules, else nothing. */
+export declare function leopardsStage(wording: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

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

@@ -0,0 +1,34 @@
+import { classifyWording } from '../../core/status/index.js';
+/**
+ * Leopards' wordings, read by how they start: the city after "at" or "in" and
+ * a pending delivery's reason vary. The first three come from its older COD
+ * tracker.
+ */
+const ACTIONS = [
+    [/^posted for consignment booking\b/, 'registered'],
+    [/^shipment picked\b/, 'accepted'],
+    // Handed to a courier for delivery. The page writes "Leopards" where the courier's name would be.
+    [/^assign to courier\b/, 'out_for_delivery'],
+    [/^assigned to leopards\b/, 'out_for_delivery'],
+    [/^inter transfer\b/, 'in_transit'],
+    // The delivery waits, with the reason in capitals, as "Pending WRONG/INCORRECT ADDRESS".
+    [/^pending\b/, 'failed_attempt'],
+    [/^delivered\b/, 'delivered'],
+];
+/** The stage a Leopards wording starts with, read case-insensitively. */
+export function leopardsWordingStage(wording) {
+    const text = wording.toLowerCase().trim().split(/\s+/).join(' ');
+    return ACTIONS.find(([pattern]) => pattern.test(text))?.[1];
+}
+/** A scan's stage: its wording, else the shared wording rules, else nothing. */
+export function leopardsStage(wording) {
+    const mapped = leopardsWordingStage(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) => leopardsWordingStage(wording),
+    gaps: [],
+};

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

@@ -5,6 +5,9 @@
     {"wording": "Shipment Picked in ISLAMABAD", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "In an archived page of Leopards' COD tracker on leopardscod.com. The city is the pickup city."},
     {"wording": "Inter Transfer", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "In an archived page of Leopards' COD tracker on leopardscod.com."},
     {"wording": "Pending WRONG/INCORRECT ADDRESS", "stage": "failed_attempt", "language": "en", "confirmedBy": "portal", "note": "In an archived page of Leopards' COD tracker on leopardscod.com. Delivery is pending because of the address."},
-    {"wording": "Assign to Courier", "stage": "out_for_delivery", "language": "en", "confirmedBy": "portal", "note": "In an archived page of Leopards' COD tracker on leopardscod.com. Handed to a courier for delivery."}
+    {"wording": "Assign to Courier", "stage": "out_for_delivery", "language": "en", "confirmedBy": "portal", "note": "In an archived page of Leopards' COD tracker on leopardscod.com. Handed to a courier for delivery."},
+    {"wording": "Inter Transfer at KARACHI", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "On Leopards' tracking page. Sent on between its cities; the city is where it left."},
+    {"wording": "Assigned to Leopards in LAHORE", "stage": "out_for_delivery", "language": "en", "confirmedBy": "portal", "note": "On Leopards' tracking page, a few hours before the delivery in the same city. Handed to a courier, whom the page names as Leopards."},
+    {"wording": "Delivered at LAHORE", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "On Leopards' tracking page, followed by who took the parcel and their relation to the consignee, which the adapter drops."}
   ]
 }

package/dist/carriers/pos-indonesia/adapter.d.ts

@@ -0,0 +1,14 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+export declare const POS_INDONESIA_ENDPOINT = "https://jembatan.posindonesia.co.id/utility/2.0.0/tracking/";
+export declare class PosIndonesiaTracker {
+    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/pos-indonesia/adapter.js

@@ -0,0 +1,74 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { isPosIndonesiaNotFound, normalizePosIndonesiaNumber, parsePosIndonesia, posIndonesiaPayload, POS_INDONESIA_MAX_BYTES, PROVIDER } from './parser.js';
+// The service Pos Indonesia's mobile app tracks items with. The tracking page
+// at posindonesia.co.id asks it through a server action that checks a
+// Cloudflare Turnstile token; the app sends its own key, the same for every
+// install, and no token.
+export const POS_INDONESIA_ENDPOINT = 'https://jembatan.posindonesia.co.id/utility/2.0.0/tracking/';
+const APP_KEY = 'CpFzVJWl7MgFLWT8wL8Aqz1Jvo3zyytF'; // gitleaks:allow
+// A firewall or server error page instead of the service's JSON.
+const BLOCKED = /<html|<!doctype|akses diblokir|access denied|forbidden|just a moment/i;
+export class PosIndonesiaTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizePosIndonesiaNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            let reply;
+            try {
+                reply = await fetchBounded(`${POS_INDONESIA_ENDPOINT}${encodeURIComponent(number)}`, { method: 'GET', signal,
+                    headers: { Accept: 'application/json', 'Content-Type': 'application/json', 'X-API-KEY': APP_KEY,
+                        'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: POS_INDONESIA_MAX_BYTES,
+                    fetcher: this.options.fetcher, allowHttpStatuses: [400, 401] });
+            }
+            catch (error) {
+                // An unknown number has its own notice; a missing route is not a missing item.
+                if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
+                    throw new TransportError(PROVIDER, 'Pos Indonesia tracking service is unavailable', { cause: error });
+                }
+                throw error;
+            }
+            const { response, bytes } = reply;
+            if (response.status === 401)
+                throw new ChallengeError(PROVIDER, 'Pos Indonesia refused the app’s key', { status: 401 });
+            const body = decodeText(bytes);
+            let payload;
+            try {
+                payload = posIndonesiaPayload(body);
+            }
+            catch (error) {
+                if (BLOCKED.test(body.slice(0, 64_000))) {
+                    throw new ChallengeError(PROVIDER, 'Pos Indonesia answered with a block page', { status: response.status, cause: error });
+                }
+                throw error;
+            }
+            // HTTP 400 carries the not-found notice, and nothing else is read from it.
+            if (response.status === 400 && !isPosIndonesiaNotFound(payload)) {
+                throw new IndeterminateError(PROVIDER, 'Pos Indonesia refused the lookup', { status: 400 });
+            }
+            return parsePosIndonesia(payload, number);
+        };
+        // A request that fails to reach the service, or hangs, gets one more try:
+        // the first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'pos-indonesia', 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 PosIndonesiaTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'pos-indonesia', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizePosIndonesiaNumber(number))),
+    };
+};

package/dist/carriers/pos-indonesia/carrier.json

@@ -20,18 +20,64 @@
   "timezone": "Asia/Jakarta",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "pos-indonesia",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 964
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "provider_code",
+    "weight",
+    "destination_country"
+  ],
   "portal": {
     "url": "https://www.posindonesia.co.id/id/tracking/{trackingNumber}",
     "searchUrl": "https://www.posindonesia.co.id/id/tracking",
     "canaryUrl": "https://www.posindonesia.co.id/id/tracking",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "service_name",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "staff_details",
+      "signatory",
+      "postcodes",
+      "payment_details"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "provider_code",
+      "weight",
+      "destination_country"
+    ],
+    "discarded": [
+      "service_name",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "staff_details",
+      "signatory",
+      "postcodes",
+      "payment_details"
+    ],
+    "unavailable": [
+      "eta",
+      "offset_timestamps",
+      "pickup_point",
+      "dimensions"
+    ]
   },
   "links": [
     {

package/dist/carriers/pos-indonesia/numbers.json

@@ -12,7 +12,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -21,7 +21,7 @@
           "pos-indonesia"
         ]
       },
-      "note": "Pos Indonesia's reply to a Media Konsumen letter about a parcel to the Sula islands gives it as the barcode."
+      "note": "Pos Indonesia's reply to a Media Konsumen letter about a parcel to the Sula islands gives it as the barcode; Pos Indonesia's app service finds the item."
     },
     {
       "number": "P2312190008251",
@@ -34,7 +34,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -43,7 +43,7 @@
           "pos-indonesia"
         ]
       },
-      "note": "A Media Konsumen letter about a letter sent with Pos Indonesia gives it as the resi."
+      "note": "A Media Konsumen letter about a letter sent with Pos Indonesia gives it as the resi; Pos Indonesia's app service finds the item."
     },
     {
       "number": "15941320968",
@@ -134,13 +134,13 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "intl-post",
         "confidence": "high"
       },
-      "note": "Pos Indonesia's reply to a Media Konsumen letter about an item to China gives it as the barcode."
+      "note": "Pos Indonesia's reply to a Media Konsumen letter about an item to China gives it as the barcode; Pos Indonesia's app service finds the item."
     },
     {
       "number": "P2208030060194",
@@ -153,7 +153,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -162,7 +162,7 @@
           "pos-indonesia"
         ]
       },
-      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened."
+      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened. Pos Indonesia's app service finds the item."
     },
     {
       "number": "P2407110206496",
@@ -175,7 +175,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -184,7 +184,7 @@
           "pos-indonesia"
         ]
       },
-      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened."
+      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened. Pos Indonesia's app service finds the item."
     },
     {
       "number": "p2504170015857",
@@ -197,7 +197,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -206,7 +206,7 @@
           "pos-indonesia"
         ]
       },
-      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened. Kept in the lowercase form the lookup used."
+      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened. Pos Indonesia's app service finds the item. Kept in the lowercase form the lookup used."
     },
     {
       "number": "RR046768837ID",
@@ -219,13 +219,13 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "intl-post",
         "confidence": "high"
       },
-      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened."
+      "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened. Pos Indonesia's app service finds the item."
     },
     {
       "number": "CC014356389ID",
@@ -290,6 +290,44 @@
         ]
       },
       "note": "An archived lookup on Pos Indonesia's own tracking page passes it as the barcode; the capture was not opened."
+    },
+    {
+      "number": "LP107221675JP",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20261005043931/https://www.posindonesia.co.id/id/tracking/LP107221675JP",
+        "date": "2026-10-05",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "japan-post",
+        "confidence": "high"
+      },
+      "note": "An archived lookup on Pos Indonesia's own tracking page passes this item from Japan as the barcode; the capture was not opened. Pos Indonesia's app service finds its delivery in Indonesia."
+    },
+    {
+      "number": "EE205187475BN",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260123134244/https://www.posindonesia.co.id/en/tracking/EE205187475BN",
+        "date": "2026-01-23",
+        "dateKind": "capture",
+        "access": "indexed_excerpt"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "intl-post",
+        "confidence": "high"
+      },
+      "note": "An archived lookup on Pos Indonesia's own tracking page passes this item from Brunei as the barcode; the capture was not opened. Pos Indonesia's app service finds its delivery in Indonesia."
     }
   ]
 }

package/dist/carriers/pos-indonesia/parser.d.ts

@@ -0,0 +1,25 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Pos Indonesia";
+export declare const POS_INDONESIA_MAX_BYTES = 512000;
+/** A number for Pos Indonesia's service: a waybill, an older domestic barcode or an S10 item code, Indonesian or inbound. */
+export declare function normalizePosIndonesiaNumber(raw: string): string;
+/**
+ * The service's reply as JSON. For items it holds no waybill for, inbound
+ * items among them, it fills its template with nothing for numeric fields,
+ * which is not JSON; those fields are read as null.
+ */
+export declare function posIndonesiaPayload(text: string): unknown;
+/** The not-found notice; the service sends it with HTTP 400. */
+export declare function isPosIndonesiaNotFound(payload: unknown): boolean;
+/**
+ * A scan's wording without the staff member who scanned it, the recipient a
+ * delivery names, phone numbers and office codes, which carry postcodes.
+ */
+export declare function posIndonesiaWording(content: string): string;
+/**
+ * The service's reply for one number: the waybill, then its history. The
+ * waybill names the number it was made for, and is empty for an item the
+ * service holds no waybill for; every scan names the item's number. Each must
+ * be the whole requested number: the service also answers for a booking code.
+ */
+export declare function parsePosIndonesia(payload: unknown, raw: string): CarrierResult;