bps-mcp-server 0.1.0 → 0.3.0

package/README.md

@@ -8,7 +8,9 @@ MCP (Model Context Protocol) server untuk data statistik BPS (Badan Pusat Statis
 
 ## Fitur
 
-- **32 tools** mencakup seluruh endpoint BPS API v1
+- **34 tools** mencakup seluruh endpoint BPS WebAPI v1 + AllStats Search
+- **Integrasi AllStats Search** — pencarian unified + full-text PDF search (tanpa API key)
+- **Smart fallback** — WebAPI search otomatis fallback ke AllStats jika tidak ada hasil
 - **3 MCP Resources** — domain list, kabupaten per provinsi, subjek per domain
 - **5 MCP Prompts** — template analisis data siap pakai
 - **Domain resolver** dengan fuzzy matching (ketik "Jatim" → Jawa Timur)
@@ -41,6 +43,38 @@ npm run build
 BPS_API_KEY=your_key npm start
 ```
 
+## Akses Remote via Cloudflare Workers
+
+Server ini tersedia secara publik di:
+
+```
+https://bps-mcp-server.murphi.my.id/mcp
+```
+
+Tambahkan ke MCP client manapun (Claude Desktop, Cursor, dll.) via remote transport:
+
+```json
+{
+  "mcpServers": {
+    "bps-statistics": {
+      "type": "http",
+      "url": "https://bps-mcp-server.murphi.my.id/mcp",
+      "headers": {
+        "X-BPS-API-Key": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Self-hosted
+
+Ingin deploy sendiri? Deploy sebagai serverless worker di akun Cloudflare kamu:
+
+[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/setiapam/bps-mcp-server)
+
+Lihat panduan lengkap di [docs/DEPLOY-WORKERS.md](docs/DEPLOY-WORKERS.md).
+
 ## Konfigurasi MCP Client
 
 ### Claude Desktop
@@ -101,7 +135,9 @@ File `~/.cursor/mcp.json` atau `.vscode/mcp.json`:
 }
 ```
 
-## Tools (32)
+## Tools (34)
+
+### WebAPI Tools (32)
 
 | Tool | Deskripsi |
 |------|-----------|
@@ -135,9 +171,82 @@ File `~/.cursor/mcp.json` atau `.vscode/mcp.json`:
 | `list_csa_tables` | Tabel CSA per subjek |
 | `get_csa_table` | Detail tabel CSA (HTML) |
 | `list_glossary` | Glosarium istilah statistik |
-| `search` | Pencarian lintas tipe |
+| `search` | Pencarian lintas tipe (WebAPI + AllStats fallback) |
 | `cache_clear` | Bersihkan cache |
 
+### AllStats Search Tools (2)
+
+| Tool | Deskripsi |
+|------|-----------|
+| `allstats_search` | Pencarian unified semua konten BPS (publikasi, tabel, BRS, infografis, data mikro, glosarium, klasifikasi) |
+| `allstats_deep_search` | Full-text search di dalam isi PDF publikasi BPS — **fitur unik, tidak tersedia di WebAPI** |
+
+## Integrasi AllStats Search
+
+Server ini mengintegrasikan dua sumber data yang saling melengkapi:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    BPS MCP Server                        │
+│                                                         │
+│  ┌──────────────────┐    ┌────────────────────────┐     │
+│  │   WebAPI BPS      │    │  AllStats Search        │     │
+│  │   (Primary)       │    │  (Supplementary)        │     │
+│  │                   │    │                          │     │
+│  │  + Structured     │    │  + Full-text PDF search  │     │
+│  │    data (JSON)    │    │  + Unified search        │     │
+│  │  + Dynamic tables │    │    semua tipe konten     │     │
+│  │  + Ekspor/Impor   │    │  + Tanpa API key         │     │
+│  │  + Sensus data    │    │  + Filter wilayah 550+   │     │
+│  │  - No PDF search  │    │  - HTML scraping         │     │
+│  └──────────────────┘    └────────────────────────┘     │
+│                                                         │
+│  Strategi interaksi:                                    │
+│  1. search → WebAPI dulu, fallback AllStats jika kosong │
+│  2. allstats_search → langsung ke AllStats Search       │
+│  3. allstats_deep_search → cari teks di dalam PDF       │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Cara Kerja
+
+**`search` (smart fallback)**
+- Prioritas: WebAPI BPS (structured JSON)
+- Jika WebAPI mengembalikan hasil kosong atau error, otomatis fallback ke AllStats Search
+- User mendapat notifikasi sumber data yang digunakan
+
+**`allstats_search` (unified discovery)**
+- Langsung query ke `searchengine.web.bps.go.id`
+- Mendukung filter: tipe konten, wilayah, rentang tahun, urutan
+- Tidak memerlukan API key BPS
+- Cocok untuk discovery atau pencarian broad
+
+**`allstats_deep_search` (PDF full-text)**
+- Cari teks di dalam isi PDF publikasi BPS
+- Memerlukan `publication_id` (24 karakter hex) dari hasil `allstats_search`
+- Mengembalikan halaman PDF yang cocok beserta cuplikan teks
+- Fitur unik yang tidak tersedia di WebAPI
+
+### Workflow Contoh
+
+```
+1. Discovery → Deep Search:
+   allstats_search("akses internet", content="publication")
+   → dapat publication_id
+   → allstats_deep_search("akses internet", publication_id="131385d0253c6aae7c7a59fa")
+   → halaman PDF yang membahas "akses internet"
+
+2. Smart fallback:
+   search(keyword="kemiskinan Papua")
+   → WebAPI kosong → otomatis cari via AllStats
+   → hasil dari AllStats ditampilkan dengan catatan fallback
+
+3. Parallel enrichment (oleh AI):
+   - get_dynamic_data → data angka terstruktur
+   - allstats_search("inflasi", content="pressrelease") → BRS terbaru
+   → AI menggabungkan data angka + konteks dari BRS
+```
+
 ## Resources (3)
 
 | URI | Deskripsi |
@@ -163,6 +272,8 @@ File `~/.cursor/mcp.json` atau `.vscode/mcp.json`:
 "Bandingkan angka kemiskinan Jawa Timur vs Jawa Barat 2020-2023"
 "Cari BRS terbaru tentang inflasi"
 "Data ekspor kopi Indonesia tahun 2024"
+"Cari publikasi tentang statistik telekomunikasi"
+"Cari teks tentang akses internet di dalam publikasi BPS"
 ```
 
 ## Environment Variables

package/dist/client/allstats-client.d.ts

@@ -0,0 +1,72 @@
+import type { ICacheProvider } from "../services/cache.js";
+export type AllStatsContentType = "all" | "publication" | "table" | "pressrelease" | "infographic" | "microdata" | "news" | "glosarium" | "kbli2020" | "kbli2017" | "kbli2015" | "kbli2009";
+export type AllStatsSortOrder = "terbaru" | "relevansi";
+export interface AllStatsSearchParams {
+    query: string;
+    content?: AllStatsContentType;
+    domain?: string;
+    page?: number;
+    titleOnly?: boolean;
+    yearFrom?: string;
+    yearTo?: string;
+    sort?: AllStatsSortOrder;
+}
+export interface AllStatsSearchResult {
+    url: string;
+    title: string;
+    description: string;
+    contentType: string;
+    domain: string;
+    deepSearchId?: string;
+}
+export interface AllStatsSearchResponse {
+    query: string;
+    totalResults: number;
+    currentPage: number;
+    totalPages: number;
+    results: AllStatsSearchResult[];
+}
+export interface AllStatsDeepSearchParams {
+    query: string;
+    publicationId: string;
+    domain?: string;
+    page?: number;
+}
+export interface AllStatsDeepSearchMatch {
+    pageNumber: number;
+    excerpt: string;
+    highlights: string[];
+    pdfViewerUrl: string;
+}
+export interface AllStatsDeepSearchPublication {
+    title: string;
+    publisher: string;
+    coverUrl: string;
+    publicationUrl: string;
+    pdfDownloadBase: string;
+}
+export interface AllStatsDeepSearchResponse {
+    query: string;
+    publication: AllStatsDeepSearchPublication;
+    totalMatches: number;
+    currentPage: number;
+    totalPages: number;
+    matches: AllStatsDeepSearchMatch[];
+}
+export declare class AllStatsClient {
+    private readonly cache;
+    constructor(cache: ICacheProvider | null);
+    private fetchHtml;
+    private fetchWithRetry;
+    private doFetch;
+    search(params: AllStatsSearchParams): Promise<AllStatsSearchResponse>;
+    private parseSearchResults;
+    deepSearch(params: AllStatsDeepSearchParams): Promise<AllStatsDeepSearchResponse>;
+    private parseDeepSearchResults;
+}
+export declare class AllStatsError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly endpoint?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, endpoint?: string | undefined);
+}
+//# sourceMappingURL=allstats-client.d.ts.map

package/dist/client/allstats-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allstats-client.d.ts","sourceRoot":"","sources":["../../src/client/allstats-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAa3D,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,aAAa,GACb,OAAO,GACP,cAAc,GACd,aAAa,GACb,WAAW,GACX,MAAM,GACN,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,6BAA6B,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAiBD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc,GAAG,IAAI;YAI3C,SAAS;YA2BT,cAAc;YA4Bd,OAAO;IAiCf,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAe3E,OAAO,CAAC,kBAAkB;IAoEpB,UAAU,CACd,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IAYtC,OAAO,CAAC,sBAAsB;CAwE/B;AAID,qBAAa,aAAc,SAAQ,KAAK;aAGpB,UAAU,CAAC,EAAE,MAAM;aACnB,QAAQ,CAAC,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC"}

package/dist/client/allstats-client.js

@@ -0,0 +1,247 @@
+import * as cheerio from "cheerio";
+import { logger } from "../utils/logger.js";
+// ========== Constants ==========
+const ALLSTATS_BASE = "https://searchengine.web.bps.go.id";
+const USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36";
+const FETCH_TIMEOUT_MS = 30_000;
+const MAX_RETRIES = 3;
+const RETRY_BASE_DELAY_MS = 1_000;
+// ========== OCR Cleanup ==========
+const OCR_PATTERNS = [
+    /^Ps\s*\/\/\s*W\s*Ww\s*\.Bp\s*S\.G\s*O\.I\s*D\s*/i,
+    /^Ht\s*Tp\s*\/\/\s*.*?\.Bp\s*S\s*\.\s*Go\s*\.\s*Id\s*/i,
+];
+function cleanExcerpt(text) {
+    let cleaned = text;
+    for (const p of OCR_PATTERNS)
+        cleaned = cleaned.replace(p, "");
+    return cleaned.replace(/\s+/g, " ").trim();
+}
+// ========== Client ==========
+export class AllStatsClient {
+    cache;
+    constructor(cache) {
+        this.cache = cache;
+    }
+    // ---------- HTTP ----------
+    async fetchHtml(path, params) {
+        const url = new URL(path, ALLSTATS_BASE);
+        for (const [k, v] of Object.entries(params)) {
+            url.searchParams.set(k, v);
+        }
+        const cacheKey = `allstats:${url.toString()}`;
+        // Check cache
+        if (this.cache) {
+            const cached = await this.cache.get(cacheKey);
+            if (cached) {
+                logger.debug(`AllStats cache hit: ${cacheKey}`);
+                return cached;
+            }
+        }
+        const html = await this.fetchWithRetry(url.toString());
+        // Cache for 30 minutes
+        if (this.cache) {
+            await this.cache.set(cacheKey, html, 30 * 60);
+        }
+        return html;
+    }
+    async fetchWithRetry(url) {
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                return await this.doFetch(url);
+            }
+            catch (error) {
+                lastError = error;
+                // Retry on 403 (rate limit) and 5xx
+                const isRetryable = error instanceof AllStatsError &&
+                    error.statusCode !== undefined &&
+                    (error.statusCode === 403 || error.statusCode >= 500);
+                if (!isRetryable || attempt === MAX_RETRIES - 1) {
+                    throw error;
+                }
+                const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+                logger.warn(`AllStats retry (${attempt + 1}/${MAX_RETRIES}) after ${delay}ms: ${url}`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw lastError;
+    }
+    async doFetch(url) {
+        logger.debug(`AllStats fetch: ${url}`);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        let res;
+        try {
+            res = await fetch(url, {
+                headers: {
+                    "User-Agent": USER_AGENT,
+                    Accept: "text/html,application/xhtml+xml",
+                },
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new AllStatsError(`Request timeout after ${FETCH_TIMEOUT_MS}ms`, 408, url);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        if (!res.ok) {
+            throw new AllStatsError(`AllStats HTTP ${res.status} ${res.statusText}`, res.status, url);
+        }
+        return res.text();
+    }
+    // ---------- Search ----------
+    async search(params) {
+        const html = await this.fetchHtml("/search", {
+            q: params.query,
+            content: params.content || "all",
+            page: String(params.page || 1),
+            title: params.titleOnly ? "1" : "0",
+            mfd: params.domain || "0000",
+            from: params.yearFrom || "all",
+            to: params.yearTo || "all",
+            sort: params.sort || "terbaru",
+        });
+        return this.parseSearchResults(html, params.query, params.page || 1);
+    }
+    parseSearchResults(html, query, currentPage) {
+        const $ = cheerio.load(html);
+        // Total results: "Menampilkan 4.079 hasil pencarian dalam 0.367 detik"
+        const totalMatch = $("body")
+            .text()
+            .match(/Menampilkan\s+([\d.]+)\s+hasil pencarian/);
+        const totalResults = totalMatch
+            ? parseInt(totalMatch[1].replace(/\./g, ""))
+            : 0;
+        // Pagination
+        const pages = [];
+        $("a[onclick*='changePage']").each((_, el) => {
+            const m = $(el).attr("onclick")?.match(/changePage\((\d+)\)/);
+            if (m)
+                pages.push(parseInt(m[1]));
+        });
+        const totalPages = pages.length > 0 ? Math.max(...pages) : 1;
+        // Results
+        const results = [];
+        $("div.card-result").each((_, el) => {
+            const $c = $(el);
+            const url = $c.find("a.stretched-link").attr("href") || "";
+            const title = $c.find("h5.fw-medium").text().trim();
+            const description = $c
+                .find("p.text-body-secondary.text-truncate")
+                .text()
+                .trim();
+            const badges = $c.find("div.badge");
+            const contentType = badges.first().text().trim();
+            const domain = $c.find("div.badge.text-bg-light").text().trim() ||
+                badges.last().text().trim();
+            let deepSearchId;
+            const deepHref = $c.find('a[href*="deep"]').attr("href");
+            if (deepHref) {
+                const m = deepHref.match(/id=([a-f0-9]{24})/);
+                if (m)
+                    deepSearchId = m[1];
+            }
+            results.push({
+                url,
+                title,
+                description,
+                contentType,
+                domain,
+                deepSearchId,
+            });
+        });
+        return {
+            query,
+            totalResults,
+            currentPage,
+            totalPages,
+            results,
+        };
+    }
+    // ---------- Deep Search ----------
+    async deepSearch(params) {
+        const html = await this.fetchHtml("/deep", {
+            q: params.query,
+            id: params.publicationId,
+            content: "publication",
+            mfd: params.domain || "0000",
+            page: String(params.page || 1),
+        });
+        return this.parseDeepSearchResults(html, params.query, params.page || 1);
+    }
+    parseDeepSearchResults(html, query, currentPage) {
+        const $ = cheerio.load(html);
+        // Publication metadata
+        const publication = {
+            title: $("h5.card-title.fw-semibold").first().text().trim(),
+            publisher: $("p.card-text.text-body-secondary").first().text().trim(),
+            coverUrl: $("img.foreground").attr("src") || "",
+            publicationUrl: $('a.btn-info[href*="bps.go.id/publication"]').attr("href") || "",
+            pdfDownloadBase: "",
+        };
+        // PDF download base from inline script
+        $("script").each((_, el) => {
+            const content = $(el).html() || "";
+            const m = content.match(/https:\/\/web-api\.bps\.go\.id\/download\.php\?f=[^#"]*/);
+            if (m)
+                publication.pdfDownloadBase = m[0];
+        });
+        // Total matches: "Menampilkan 11 halaman dengan kata kunci "akses internet""
+        const totalMatch = $("body")
+            .text()
+            .match(/Menampilkan\s+(\d+)\s+halaman dengan kata kunci/);
+        const totalMatches = totalMatch ? parseInt(totalMatch[1]) : 0;
+        // Pagination
+        const pages = [];
+        $("a[onclick*='changePage']").each((_, el) => {
+            const m = $(el).attr("onclick")?.match(/changePage\((\d+)\)/);
+            if (m)
+                pages.push(parseInt(m[1]));
+        });
+        const totalPages = pages.length > 0 ? Math.max(...pages) : 1;
+        // Matches
+        const matches = [];
+        $("div.card-result").each((_, el) => {
+            const $c = $(el);
+            const pageNumber = parseInt($c.find("a.linkhalaman").attr("data-page") || "0");
+            const excerptEl = $c.find('p[id^="deskripsi-"]');
+            const excerpt = cleanExcerpt(excerptEl.text());
+            const highlights = [];
+            excerptEl.find("mark").each((_, mark) => {
+                const kw = $(mark).text().trim().toLowerCase();
+                if (!highlights.includes(kw))
+                    highlights.push(kw);
+            });
+            const pdfViewerUrl = publication.pdfDownloadBase
+                ? `${publication.pdfDownloadBase}#page=${pageNumber}`
+                : "";
+            matches.push({ pageNumber, excerpt, highlights, pdfViewerUrl });
+        });
+        return {
+            query,
+            publication,
+            totalMatches,
+            currentPage,
+            totalPages,
+            matches,
+        };
+    }
+}
+// ========== Error ==========
+export class AllStatsError extends Error {
+    statusCode;
+    endpoint;
+    constructor(message, statusCode, endpoint) {
+        super(message);
+        this.statusCode = statusCode;
+        this.endpoint = endpoint;
+        this.name = "AllStatsError";
+    }
+}
+//# sourceMappingURL=allstats-client.js.map

package/dist/client/allstats-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allstats-client.js","sourceRoot":"","sources":["../../src/client/allstats-client.ts"],"names":[],"mappings":"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"}

package/dist/client/bps-client.d.ts

@@ -8,8 +8,12 @@ export declare class BpsClient {
     private readonly baseUrl;
     private readonly defaultLang;
     private readonly defaultDomain;
+    /** In-flight request deduplication map: cacheKey → pending Promise */
+    private readonly inflight;
     constructor(auth: IAuthProvider, cache: ICacheProvider | null, config: Config);
     private fetchJson;
+    private fetchWithRetry;
+    private doFetch;
     private authParams;
     /**
      * Perform a list request: /api/list/model/{model}/...

package/dist/client/bps-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bps-client.d.ts","sourceRoot":"","sources":["../../src/client/bps-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AASjD,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,QAAQ,EACT,MAAM,YAAY,CAAC;AAIpB,qBAAa,SAAS;IAMlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAGpB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,cAAc,GAAG,IAAI,EAC7C,MAAM,EAAE,MAAM;YAOF,SAAS;YAgDT,UAAU;IAIxB;;OAEG;YACW,WAAW;IAkBzB;;OAEG;YACW,WAAW;IAkBzB,OAAO,CAAC,gBAAgB;IAUlB,WAAW,CACf,IAAI,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,WAAmB,EAClD,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAiB5C,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAShG,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAYrE,aAAa,CACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAS9C,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAStF,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IASpF,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASlE,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAShF,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAW9C,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,CAAC;IAU5B,gBAAgB,CACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IASjD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAWzE,iBAAiB,CACrB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IASlD,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAWrE,gBAAgB,CACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IASjD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWnE,uBAAuB,CAC3B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAWxD,YAAY,CAChB,MAAM,EAAE,CAAC,GAAG,CAAC,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IAmBb,gBAAgB,CACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IASjD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAWzE,QAAQ,CACZ,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAS1C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAW3D,YAAY,CAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAWlD,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS3E,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAStG,aAAa,CACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAS9C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWnE,gBAAgB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ7C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAU7D,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;CASjD"}
+{"version":3,"file":"bps-client.d.ts","sourceRoot":"","sources":["../../src/client/bps-client.ts"],"names":[],"mappings":"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"}

package/dist/client/bps-client.js

@@ -1,12 +1,20 @@
 import { buildListUrl, buildViewUrl, buildDomainUrl, buildTradeUrl, buildInteropUrl, MODELS, } from "./endpoints.js";
 import { BpsApiError, BpsAuthError, BpsNotFoundError } from "../utils/error.js";
 import { logger } from "../utils/logger.js";
+/** Default fetch timeout in milliseconds */
+const FETCH_TIMEOUT_MS = 30_000;
+/** Maximum retry attempts for transient errors */
+const MAX_RETRIES = 3;
+/** Base delay for exponential backoff in milliseconds */
+const RETRY_BASE_DELAY_MS = 500;
 export class BpsClient {
     auth;
     cache;
     baseUrl;
     defaultLang;
     defaultDomain;
+    /** In-flight request deduplication map: cacheKey → pending Promise */
+    inflight = new Map();
     constructor(auth, cache, config) {
         this.auth = auth;
         this.cache = cache;
@@ -23,14 +31,67 @@ export class BpsClient {
                 return JSON.parse(cached);
             }
         }
+        // Deduplicate concurrent requests for the same cache key
+        const existing = this.inflight.get(cacheKey);
+        if (existing) {
+            logger.debug(`Dedup hit: ${cacheKey}`);
+            return existing;
+        }
+        const promise = this.fetchWithRetry(url, cacheKey, ttl);
+        this.inflight.set(cacheKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.inflight.delete(cacheKey);
+        }
+    }
+    async fetchWithRetry(url, cacheKey, ttl) {
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                return await this.doFetch(url, cacheKey, ttl);
+            }
+            catch (error) {
+                lastError = error;
+                // Only retry on transient server errors (5xx)
+                const isRetryable = error instanceof BpsApiError &&
+                    error.statusCode !== undefined &&
+                    error.statusCode >= 500;
+                if (!isRetryable || attempt === MAX_RETRIES - 1) {
+                    throw error;
+                }
+                const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+                logger.warn(`Retrying (${attempt + 1}/${MAX_RETRIES}) after ${delay}ms: ${url}`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw lastError;
+    }
+    async doFetch(url, cacheKey, ttl) {
         logger.debug(`Fetching: ${url}`);
         const authHeaders = await this.auth.getHeaders();
-        const res = await fetch(url, {
-            headers: {
-                Accept: "application/json",
-                ...authHeaders,
-            },
-        });
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        let res;
+        try {
+            res = await fetch(url, {
+                headers: {
+                    Accept: "application/json",
+                    ...authHeaders,
+                },
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new BpsApiError(`Request timeout after ${FETCH_TIMEOUT_MS}ms`, 408, url);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
         if (res.status === 401 || res.status === 403) {
             throw new BpsAuthError();
         }