bps-mcp-server 0.1.0 → 0.3.0

package/dist/tools/allstats.tools.js

@@ -0,0 +1,171 @@
+import { z } from "zod";
+import { appendAttribution } from "../services/attribution.js";
+// ========== Formatters ==========
+function formatSearchResults(res) {
+    const lines = [];
+    lines.push(`## Hasil AllStats Search: "${res.query}"`);
+    lines.push("");
+    lines.push(`Ditemukan **${res.totalResults.toLocaleString("id-ID")}** hasil (halaman ${res.currentPage}/${res.totalPages})`);
+    lines.push("");
+    if (res.results.length === 0) {
+        lines.push("_Tidak ada hasil ditemukan._");
+        return lines.join("\n");
+    }
+    for (let i = 0; i < res.results.length; i++) {
+        const r = res.results[i];
+        lines.push(`### ${i + 1}. ${r.title}`);
+        if (r.description)
+            lines.push(`> ${r.description}`);
+        lines.push("");
+        lines.push(`- **Tipe:** ${r.contentType}`);
+        lines.push(`- **Sumber:** ${r.domain}`);
+        if (r.url)
+            lines.push(`- **URL:** ${r.url}`);
+        if (r.deepSearchId) {
+            lines.push(`- **Deep Search ID:** \`${r.deepSearchId}\` _(gunakan allstats_deep_search untuk cari teks di dalam publikasi ini)_`);
+        }
+        lines.push("");
+    }
+    if (res.currentPage < res.totalPages) {
+        lines.push(`---\n_Halaman ${res.currentPage} dari ${res.totalPages}. Gunakan parameter \`page\` untuk melihat halaman berikutnya._`);
+    }
+    return lines.join("\n");
+}
+function formatDeepSearchResults(res) {
+    const lines = [];
+    const pub = res.publication;
+    lines.push(`## Deep Search: "${res.query}"`);
+    lines.push("");
+    lines.push(`### Publikasi: ${pub.title}`);
+    if (pub.publisher)
+        lines.push(`**Penerbit:** ${pub.publisher}`);
+    if (pub.publicationUrl)
+        lines.push(`**URL:** ${pub.publicationUrl}`);
+    lines.push("");
+    lines.push(`Ditemukan **${res.totalMatches}** halaman cocok (halaman hasil ${res.currentPage}/${res.totalPages})`);
+    lines.push("");
+    if (res.matches.length === 0) {
+        lines.push("_Tidak ada halaman yang cocok ditemukan._");
+        return lines.join("\n");
+    }
+    for (const match of res.matches) {
+        lines.push(`#### Halaman ${match.pageNumber}`);
+        if (match.excerpt) {
+            lines.push(`> ${match.excerpt}`);
+        }
+        if (match.highlights.length > 0) {
+            lines.push(`**Kata kunci:** ${match.highlights.join(", ")}`);
+        }
+        if (match.pdfViewerUrl) {
+            lines.push(`**PDF:** ${match.pdfViewerUrl}`);
+        }
+        lines.push("");
+    }
+    if (res.currentPage < res.totalPages) {
+        lines.push(`---\n_Halaman ${res.currentPage} dari ${res.totalPages}. Gunakan parameter \`page\` untuk melihat halaman berikutnya._`);
+    }
+    return lines.join("\n");
+}
+// ========== Tool Registration ==========
+export function registerAllStatsTools(server, allStatsClient) {
+    // ---------- allstats_search ----------
+    server.tool("allstats_search", "Pencarian konten BPS melalui AllStats Search Engine (publikasi, tabel, BRS, infografis, data mikro, glosarium, klasifikasi). Berguna untuk discovery, mencari publikasi, atau sebagai alternatif/fallback dari WebAPI search. Tidak memerlukan API key.", {
+        query: z.string().describe("Kata kunci pencarian"),
+        content: z
+            .enum([
+            "all",
+            "publication",
+            "table",
+            "pressrelease",
+            "infographic",
+            "microdata",
+            "news",
+            "glosarium",
+            "kbli2020",
+            "kbli2017",
+            "kbli2015",
+            "kbli2009",
+        ])
+            .default("all")
+            .describe("Filter tipe konten: all, publication, table, pressrelease, infographic, microdata, news, glosarium, kbli2020/2017/2015/2009"),
+        domain: z
+            .string()
+            .default("0000")
+            .describe("Kode wilayah MFD. 'all'=semua, '0000'=nasional, 2 digit=provinsi (cth: 3500=Jatim), 4 digit=kab/kota"),
+        page: z
+            .number()
+            .default(1)
+            .describe("Nomor halaman (10 hasil per halaman)"),
+        title_only: z
+            .boolean()
+            .default(false)
+            .describe("Cari di judul saja (true) atau semua field (false)"),
+        year_from: z
+            .string()
+            .default("all")
+            .describe("Filter tahun mulai ('all' atau tahun, cth: '2020')"),
+        year_to: z
+            .string()
+            .default("all")
+            .describe("Filter tahun sampai ('all' atau tahun, cth: '2024')"),
+        sort: z
+            .enum(["terbaru", "relevansi"])
+            .default("terbaru")
+            .describe("Urutan hasil: 'terbaru' (newest first) atau 'relevansi'"),
+    }, async ({ query, content, domain, page, title_only, year_from, year_to, sort }) => {
+        try {
+            const result = await allStatsClient.search({
+                query,
+                content,
+                domain,
+                page,
+                titleOnly: title_only,
+                yearFrom: year_from,
+                yearTo: year_to,
+                sort,
+            });
+            const text = appendAttribution(formatSearchResults(result));
+            return { content: [{ type: "text", text }] };
+        }
+        catch (error) {
+            const message = error instanceof Error
+                ? `Gagal melakukan pencarian AllStats: ${error.message}`
+                : "Terjadi kesalahan saat mengakses AllStats Search.";
+            return { content: [{ type: "text", text: message }], isError: true };
+        }
+    });
+    // ---------- allstats_deep_search ----------
+    server.tool("allstats_deep_search", "Full-text search di dalam isi PDF publikasi BPS. Mengembalikan halaman yang cocok beserta cuplikan teks. Dapatkan publication_id dari hasil allstats_search (field deep_search_id). Fitur unik — tidak tersedia di WebAPI. Tidak memerlukan API key.", {
+        query: z.string().describe("Kata kunci untuk dicari di dalam publikasi"),
+        publication_id: z
+            .string()
+            .regex(/^[a-f0-9]{24}$/, "Harus berupa 24 karakter hex")
+            .describe("ID publikasi (24 karakter hex) dari URL publikasi BPS atau dari field deep_search_id di hasil allstats_search"),
+        domain: z
+            .string()
+            .default("0000")
+            .describe("Kode wilayah MFD"),
+        page: z
+            .number()
+            .default(1)
+            .describe("Halaman hasil (bukan halaman PDF)"),
+    }, async ({ query, publication_id, domain, page }) => {
+        try {
+            const result = await allStatsClient.deepSearch({
+                query,
+                publicationId: publication_id,
+                domain,
+                page,
+            });
+            const text = appendAttribution(formatDeepSearchResults(result));
+            return { content: [{ type: "text", text }] };
+        }
+        catch (error) {
+            const message = error instanceof Error
+                ? `Gagal melakukan deep search AllStats: ${error.message}`
+                : "Terjadi kesalahan saat mengakses AllStats Deep Search.";
+            return { content: [{ type: "text", text: message }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=allstats.tools.js.map

package/dist/tools/allstats.tools.js.map

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

package/dist/tools/search.tools.d.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { BpsClient } from "../client/bps-client.js";
-export declare function registerSearchTools(server: McpServer, client: BpsClient): void;
+import type { AllStatsClient } from "../client/allstats-client.js";
+export declare function registerSearchTools(server: McpServer, client: BpsClient, allStatsClient?: AllStatsClient): void;
 //# sourceMappingURL=search.tools.d.ts.map

package/dist/tools/search.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.tools.d.ts","sourceRoot":"","sources":["../../src/tools/search.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIzD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAuB9E"}
+{"version":3,"file":"search.tools.d.ts","sourceRoot":"","sources":["../../src/tools/search.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,8BAA8B,CAAC;AAuC3F,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,cAAc,CAAC,EAAE,cAAc,GAC9B,IAAI,CAuHN"}

package/dist/tools/search.tools.js

@@ -1,22 +1,128 @@
 import { z } from "zod";
 import { appendAttribution } from "../services/attribution.js";
 import { formatErrorForUser } from "../utils/error.js";
-export function registerSearchTools(server, client) {
-    server.tool("search", "Pencarian data lintas tipe di BPS. Bisa mencari tabel statis, publikasi, BRS, indikator, dan data lainnya.", {
+import { BpsNotFoundError } from "../utils/error.js";
+import { logger } from "../utils/logger.js";
+/** Map WebAPI type names to AllStats content types */
+const WEBAPI_TO_ALLSTATS_CONTENT = {
+    statictable: "table",
+    pressrelease: "pressrelease",
+    publication: "publication",
+    strategicindicator: "table",
+};
+function formatAllStatsFallback(res) {
+    const lines = [];
+    lines.push(`### Hasil dari AllStats Search (fallback)`);
+    lines.push(`Ditemukan **${res.totalResults.toLocaleString("id-ID")}** hasil via AllStats Search Engine`);
+    lines.push("");
+    for (let i = 0; i < res.results.length; i++) {
+        const r = res.results[i];
+        lines.push(`**${i + 1}. ${r.title}**`);
+        if (r.description)
+            lines.push(`> ${r.description}`);
+        lines.push(`- Tipe: ${r.contentType} | Sumber: ${r.domain}`);
+        if (r.url)
+            lines.push(`- URL: ${r.url}`);
+        if (r.deepSearchId) {
+            lines.push(`- Deep Search ID: \`${r.deepSearchId}\` _(gunakan allstats_deep_search untuk cari di dalam publikasi)_`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function registerSearchTools(server, client, allStatsClient) {
+    server.tool("search", "Pencarian data lintas tipe di BPS. Mencari via WebAPI (tabel statis, publikasi, BRS, indikator). Jika WebAPI tidak menemukan hasil, otomatis fallback ke AllStats Search Engine untuk hasil yang lebih luas.", {
         domain: z.string().default("0000").describe("Kode domain BPS"),
         keyword: z.string().describe("Kata kunci pencarian"),
-        type: z.string().optional().describe("Filter tipe hasil: 'statictable', 'pressrelease', 'publication', 'strategicindicator' (opsional)"),
+        type: z
+            .string()
+            .optional()
+            .describe("Filter tipe hasil: 'statictable', 'pressrelease', 'publication', 'strategicindicator' (opsional)"),
         page: z.number().optional().describe("Nomor halaman"),
     }, async ({ domain, keyword, type, page }) => {
+        // --- Step 1: Try WebAPI ---
+        let webapiResult = null;
+        let webapiError = null;
         try {
-            const result = await client.search(domain, keyword, type, page);
+            webapiResult = await client.search(domain, keyword, type, page);
+        }
+        catch (error) {
+            webapiError = error;
+            logger.debug(`WebAPI search failed for "${keyword}": ${error instanceof Error ? error.message : "unknown"}`);
+        }
+        // Check if WebAPI returned data
+        const webapiHasData = webapiResult !== null &&
+            Array.isArray(webapiResult.data) &&
+            webapiResult.data.length > 0;
+        if (webapiHasData) {
+            // WebAPI returned results — use them
             const text = appendAttribution(`## Hasil Pencarian: "${keyword}"\n\n` +
-                "```json\n" + JSON.stringify(result, null, 2) + "\n```");
+                "```json\n" +
+                JSON.stringify(webapiResult, null, 2) +
+                "\n```");
             return { content: [{ type: "text", text }] };
         }
-        catch (error) {
-            return { content: [{ type: "text", text: formatErrorForUser(error) }], isError: true };
+        // --- Step 2: Fallback to AllStats ---
+        if (allStatsClient) {
+            try {
+                const allStatsContent = type && WEBAPI_TO_ALLSTATS_CONTENT[type]
+                    ? WEBAPI_TO_ALLSTATS_CONTENT[type]
+                    : "all";
+                const allStatsResult = await allStatsClient.search({
+                    query: keyword,
+                    content: allStatsContent,
+                    domain,
+                    page: page || 1,
+                });
+                if (allStatsResult.results.length > 0) {
+                    const parts = [];
+                    parts.push(`## Hasil Pencarian: "${keyword}"\n`);
+                    // Indicate fallback if WebAPI was attempted
+                    if (webapiError) {
+                        parts.push(`> **Catatan:** WebAPI BPS tidak tersedia (${webapiError instanceof Error ? webapiError.message : "error"}). Menampilkan hasil dari AllStats Search.\n`);
+                    }
+                    else if (webapiResult && !webapiHasData) {
+                        parts.push(`> **Catatan:** WebAPI BPS tidak menemukan hasil untuk "${keyword}". Menampilkan hasil dari AllStats Search.\n`);
+                    }
+                    parts.push(formatAllStatsFallback(allStatsResult));
+                    const text = appendAttribution(parts.join("\n"));
+                    return { content: [{ type: "text", text }] };
+                }
+            }
+            catch (allStatsError) {
+                logger.debug(`AllStats fallback also failed for "${keyword}": ${allStatsError instanceof Error ? allStatsError.message : "unknown"}`);
+                // If both fail, return the original error
+            }
+        }
+        // --- Step 3: Both failed or no results ---
+        if (webapiError) {
+            // WebAPI had an error and AllStats also failed or not available
+            if (webapiError instanceof BpsNotFoundError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Tidak ditemukan hasil untuk "${keyword}" di WebAPI maupun AllStats Search.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: formatErrorForUser(webapiError) }],
+                isError: true,
+            };
         }
+        // WebAPI returned empty
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Tidak ditemukan hasil untuk "${keyword}".`,
+                },
+            ],
+            isError: true,
+        };
     });
 }
 //# sourceMappingURL=search.tools.js.map

package/dist/tools/search.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.tools.js","sourceRoot":"","sources":["../../src/tools/search.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAiB;IACtE,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,4GAA4G,EAC5G;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kGAAkG,CAAC;QACxI,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;KACtD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,iBAAiB,CAC5B,wBAAwB,OAAO,OAAO;gBACtC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,CACxD,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search.tools.js","sourceRoot":"","sources":["../../src/tools/search.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,sDAAsD;AACtD,MAAM,0BAA0B,GAA2B;IACzD,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,kBAAkB,EAAE,OAAO;CAC5B,CAAC;AAEF,SAAS,sBAAsB,CAAC,GAA2B;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CACR,eAAe,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC,qCAAqC,CAC7F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CACR,uBAAuB,CAAC,CAAC,YAAY,mEAAmE,CACzG,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAiB,EACjB,MAAiB,EACjB,cAA+B;IAE/B,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,8MAA8M,EAC9M;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpD,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,kGAAkG,CACnG;QACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;KACtD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACxC,6BAA6B;QAC7B,IAAI,YAAY,GAA+B,IAAI,CAAC;QACpD,IAAI,WAAW,GAAY,IAAI,CAAC;QAEhC,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,GAAG,KAAK,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,6BAA6B,OAAO,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/G,CAAC;QAED,gCAAgC;QAChC,MAAM,aAAa,GACjB,YAAY,KAAK,IAAI;YACrB,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAE/B,IAAI,aAAa,EAAE,CAAC;YAClB,qCAAqC;YACrC,MAAM,IAAI,GAAG,iBAAiB,CAC5B,wBAAwB,OAAO,OAAO;gBACpC,WAAW;gBACX,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrC,OAAO,CACV,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/C,CAAC;QAED,uCAAuC;QACvC,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,eAAe,GACnB,IAAI,IAAI,0BAA0B,CAAC,IAAI,CAAC;oBACtC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC;oBAClC,CAAC,CAAC,KAAK,CAAC;gBAEZ,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC;oBACjD,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,eAAwB;oBACjC,MAAM;oBACN,IAAI,EAAE,IAAI,IAAI,CAAC;iBAChB,CAAC,CAAC;gBAEH,IAAI,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtC,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,KAAK,CAAC,CAAC;oBAEjD,4CAA4C;oBAC5C,IAAI,WAAW,EAAE,CAAC;wBAChB,KAAK,CAAC,IAAI,CACR,6CAA6C,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,8CAA8C,CACxJ,CAAC;oBACJ,CAAC;yBAAM,IAAI,YAAY,IAAI,CAAC,aAAa,EAAE,CAAC;wBAC1C,KAAK,CAAC,IAAI,CACR,0DAA0D,OAAO,8CAA8C,CAChH,CAAC;oBACJ,CAAC;oBAED,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;oBAEnD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;oBACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,CACV,sCAAsC,OAAO,MAAM,aAAa,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACxH,CAAC;gBACF,0CAA0C;YAC5C,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,IAAI,WAAW,EAAE,CAAC;YAChB,gEAAgE;YAChE,IAAI,WAAW,YAAY,gBAAgB,EAAE,CAAC;gBAC5C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,gCAAgC,OAAO,qCAAqC;yBACnF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gCAAgC,OAAO,IAAI;iBAClD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bps-mcp-server",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MCP server for BPS (Badan Pusat Statistik) Indonesia statistics data",
   "author": "Murphi",
   "license": "MIT",
@@ -27,22 +27,29 @@
     "start": "node --env-file=.env dist/index.js",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
+    "typecheck:worker": "tsc --noEmit --project tsconfig.worker.json",
     "test": "vitest run",
     "test:unit": "vitest run tests/unit",
     "test:integration": "vitest run tests/integration",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "dev:worker": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "deploy:dry": "wrangler deploy --dry-run"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "cheerio": "^1.2.0",
     "zod": "^3.24.4"
   },
   "devDependencies": {
+    "@cloudflare/workers-types": "^4.20250414.0",
     "@eslint/js": "^10.0.1",
     "@types/node": "^22.15.3",
     "eslint": "^10.1.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.58.0",
-    "vitest": "^3.1.2"
+    "vitest": "^3.1.2",
+    "wrangler": "^4.0.0"
   },
   "engines": {
     "node": ">=18.0.0"