@damarkuncoro/posindonesia 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 damarkuncoro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# @damarkuncoro/posindonesia
+
+[![NPM Version](https://img.shields.io/npm/v/@damarkuncoro/posindonesia.svg)](https://www.npmjs.com/package/@damarkuncoro/posindonesia)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Layanan Integrasi Data Kode Pos Indonesia**
+
+Pustaka Node.js profesional yang menyediakan akses programatik ke database kode pos resmi Indonesia. Dirancang untuk keandalan tinggi, akurasi data, dan kemudahan integrasi ke dalam sistem skala perusahaan (*enterprise*).
+
+## Ikhtisar Layanan
+
+Paket ini memungkinkan pengembang untuk melakukan sinkronisasi data wilayah administrasi Indonesia (Provinsi, Kabupaten/Kota, Kecamatan, Desa/Kelurahan) dengan database kode pos terbaru melalui jalur integrasi yang dioptimalkan.
+
+### Fitur Utama
+
+- **Akurasi Data Terjamin**: Mengambil informasi langsung dari sumber data primer integrasi wilayah.
+- **Smart Validation Engine**: Algoritma pencocokan cerdas yang mengoreksi variasi penulisan nama daerah untuk memastikan kode pos yang tepat.
+- **Efisiensi Batch**: Kemampuan pemrosesan data masal (*bulk processing*) dengan manajemen beban kerja (*rate limiting*) otomatis.
+- **Arsitektur Modular**: Mendukung penggunaan sebagai Command Line Interface (CLI) maupun sebagai Library (SDK) dalam aplikasi Node.js/TypeScript.
+
+## Instalasi
+
+Gunakan pengelola paket npm untuk menginstal SDK ini ke dalam proyek Anda:
+
+```bash
+npm install @damarkuncoro/posindonesia
+```
+
+## Panduan Penggunaan
+
+### Integrasi SDK (Library Mode)
+
+SDK ini dirancang dengan dukungan TypeScript penuh untuk pengalaman pengembangan yang maksimal.
+
+```typescript
+import { runScraper } from '@damarkuncoro/posindonesia';
+
+async function syncPostalData() {
+  const results = await runScraper({
+    input: './data/villages.csv',
+    limit: 100,
+    delay: 1000
+  }, (current, total, village) => {
+    console.log(`Sinkronisasi: ${village} (${current}/${total})`);
+  });
+}
+```
+
+### Antarmuka Baris Perintah (CLI Mode)
+
+Gunakan perintah `scrape-pos` untuk menjalankan sinkronisasi data secara langsung melalui terminal:
+
+```bash
+# Menjalankan sinkronisasi default
+npm start
+
+# Menjalankan dengan konfigurasi kustom
+npm start -- --input ./data_input.csv --output ./hasil_sinkronisasi.json --limit 500 --delay 2000
+```
+
+## Spesifikasi Data Output
+
+Hasil integrasi akan disajikan dalam format JSON standar industri:
+
+```json
+{
+  "code": "11.01.01.2001",
+  "name": "Keude Bakongan",
+  "districtCode": "11.01.01",
+  "type": "DESA",
+  "provinceName": "Aceh",
+  "regencyName": "Kab. Aceh Selatan",
+  "districtName": "Bakongan",
+  "postalCode": "23773"
+}
+```
+
+## Keamanan & Kepatuhan
+
+Kami sangat menghargai integritas data dan keberlangsungan layanan. Pengguna diharapkan untuk:
+1. Mematuhi kebijakan penggunaan data wilayah yang berlaku.
+2. Menggunakan jeda waktu (`delay`) yang wajar dalam pemrosesan masal untuk menjaga stabilitas layanan.
+
+## Lisensi
+
+Didistribusikan di bawah lisensi [MIT](LICENSE).
+
+---
+*Dikembangkan secara profesional untuk mendukung digitalisasi data wilayah Indonesia.*

package/lib/cjs/api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sends a POST request to Pos Indonesia CariKodepos endpoint.
+ * @param keyword - The search keyword (village name or postal code)
+ * @param cookie - Optional session cookie
+ * @returns The raw HTML response
+ */
+export declare function fetchPostalCodeHtml(keyword: string, cookie?: string): Promise<string>;
+//# sourceMappingURL=api.d.ts.map

package/lib/cjs/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB3F"}

package/lib/cjs/api.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchPostalCodeHtml = fetchPostalCodeHtml;
+const axios_1 = __importDefault(require("axios"));
+const qs_1 = __importDefault(require("qs"));
+/**
+ * Sends a POST request to Pos Indonesia CariKodepos endpoint.
+ * @param keyword - The search keyword (village name or postal code)
+ * @param cookie - Optional session cookie
+ * @returns The raw HTML response
+ */
+async function fetchPostalCodeHtml(keyword, cookie) {
+    const URL = 'https://kodepos.posindonesia.co.id/CariKodepos';
+    const payload = qs_1.default.stringify({ kodepos: keyword });
+    try {
+        const response = await axios_1.default.post(URL, payload, {
+            headers: {
+                'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
+                'accept-language': 'en-US,en;q=0.9,id;q=0.8,ms;q=0.7',
+                'content-type': 'application/x-www-form-urlencoded',
+                'origin': 'https://kodepos.posindonesia.co.id',
+                'referer': 'https://kodepos.posindonesia.co.id/CariKodepos',
+                'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36',
+                'cookie': cookie || 'ci_session=siodf5sn3081n9fb1h3pfh7k8r92sjvt; TS011d97f9=01dc40192af9d2c68e0588cf6826f2541733c6f742d0e6382757bb95d8a2f8d27f6da94b22391892939703ae744a8f47fe7d578583'
+            },
+            timeout: 15000
+        });
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch data for ${keyword}: ${error.message}`);
+    }
+}
+//# sourceMappingURL=api.js.map

package/lib/cjs/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":";;;;;AASA,kDAqBC;AA9BD,kDAA0B;AAC1B,4CAAoB;AAEpB;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB,CAAC,OAAe,EAAE,MAAe;IACtE,MAAM,GAAG,GAAG,gDAAgD,CAAC;IAC7D,MAAM,OAAO,GAAG,YAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAEnD,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAS,GAAG,EAAE,OAAO,EAAE;YACpD,OAAO,EAAE;gBACL,QAAQ,EAAE,yIAAyI;gBACnJ,iBAAiB,EAAE,kCAAkC;gBACrD,cAAc,EAAE,mCAAmC;gBACnD,QAAQ,EAAE,oCAAoC;gBAC9C,SAAS,EAAE,gDAAgD;gBAC3D,YAAY,EAAE,uHAAuH;gBACrI,QAAQ,EAAE,MAAM,IAAI,oKAAoK;aAC3L;YACD,OAAO,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;AACL,CAAC"}

package/lib/cjs/core.d.ts

@@ -0,0 +1,25 @@
+export interface ScraperOptions {
+    input: string;
+    limit: number;
+    delay: number;
+    cookie?: string;
+}
+export interface ScrapedVillage {
+    code: string;
+    name: string;
+    districtCode: string;
+    type: string;
+    provinceName: string;
+    regencyName: string;
+    districtName: string;
+    postalCode: string;
+}
+export type ProgressCallback = (current: number, total: number, village: string) => void;
+/**
+ * Core scraping logic separated from CLI.
+ * @param options - Configuration options
+ * @param onProgress - Callback for progress updates
+ * @returns Scraped results
+ */
+export declare function runScraper(options: ScraperOptions, onProgress?: ProgressCallback): Promise<ScrapedVillage[]>;
+//# sourceMappingURL=core.d.ts.map

package/lib/cjs/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzF;;;;;GAKG;AACH,wBAAsB,UAAU,CAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,GAAE,gBAA2B,GACxC,OAAO,CAAC,cAAc,EAAE,CAAC,CAkD3B"}

package/lib/cjs/core.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScraper = runScraper;
+const fs = __importStar(require("fs"));
+const api_1 = require("./api");
+const parser_1 = require("./parser");
+const utils_1 = require("./utils");
+/**
+ * Core scraping logic separated from CLI.
+ * @param options - Configuration options
+ * @param onProgress - Callback for progress updates
+ * @returns Scraped results
+ */
+async function runScraper(options, onProgress = () => { }) {
+    const { input, limit, delay, cookie } = options;
+    if (!fs.existsSync(input)) {
+        throw new Error(`Input file not found at ${input}`);
+    }
+    const csvData = fs.readFileSync(input, 'utf-8');
+    const lines = csvData.split('\n').filter(line => line.trim() !== '');
+    const rows = lines.slice(1);
+    const totalToProcess = Math.min(rows.length, limit);
+    const scrapedResults = [];
+    for (let i = 0; i < totalToProcess; i++) {
+        const values = rows[i].split(',');
+        const code = values[0];
+        const name = values[1];
+        const prov = values[2];
+        const kab = values[3];
+        const kec = values[4];
+        onProgress(i, totalToProcess, name);
+        try {
+            const html = await (0, api_1.fetchPostalCodeHtml)(name, cookie);
+            const results = (0, parser_1.parsePostalCodeTable)(html);
+            const bestMatch = (0, utils_1.findBestMatch)(results, name, kec);
+            scrapedResults.push({
+                code: (0, utils_1.formatCode)(code),
+                name: name,
+                districtCode: (0, utils_1.formatCode)(code.substring(0, 6)),
+                type: "DESA",
+                provinceName: prov,
+                regencyName: kab,
+                districtName: kec,
+                postalCode: bestMatch ? bestMatch.kodepos : ""
+            });
+        }
+        catch (error) {
+            console.error(`\n⚠️ Failed to scrape ${name}: ${error.message}`);
+        }
+        if (i < totalToProcess - 1) {
+            await new Promise(r => setTimeout(r, delay));
+        }
+    }
+    onProgress(totalToProcess, totalToProcess, 'Completed!');
+    return scrapedResults;
+}
+//# sourceMappingURL=core.js.map

package/lib/cjs/core.js.map

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

package/lib/cjs/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/lib/cjs/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const cliProgress = __importStar(require("cli-progress"));
+const core_1 = require("./core");
+commander_1.program
+    .name('@damarkuncoro/posindonesia')
+    .description('Professional Indonesian Postal Code Scraper')
+    .version('1.0.0')
+    .option('-i, --input <path>', 'Input CSV file path', path.join(__dirname, '../../../docs/database_final.csv'))
+    .option('-o, --output <path>', 'Output JSON file path', path.join(__dirname, '../results/scraped_villages_detailed.json'))
+    .option('-l, --limit <number>', 'Number of rows to process', '10')
+    .option('-d, --delay <ms>', 'Delay between requests in milliseconds', '1000')
+    .option('-c, --cookie <string>', 'Custom session cookie for Pos Indonesia site')
+    .action(async (options) => {
+    const { output, limit, delay } = options;
+    console.log(chalk_1.default.blue.bold('\n🚀 Starting Indonesian Postal Code Scraper (TypeScript)\n'));
+    const progressBar = new cliProgress.SingleBar({
+        format: chalk_1.default.green('Progress |') + chalk_1.default.cyan('{bar}') + '| {percentage}% || {value}/{total} Villages || {village}',
+        barCompleteChar: '\u2588',
+        barIncompleteChar: '\u2591',
+        hideCursor: true
+    });
+    try {
+        const results = await (0, core_1.runScraper)({
+            ...options,
+            limit: parseInt(limit),
+            delay: parseInt(delay)
+        }, (current, total, village) => {
+            if (current === 0) {
+                progressBar.start(total, 0, { village });
+            }
+            else {
+                progressBar.update(current, { village });
+            }
+        });
+        progressBar.stop();
+        // Ensure output directory exists
+        const outputDir = path.dirname(output);
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        fs.writeFileSync(output, JSON.stringify(results, null, 2));
+        console.log(chalk_1.default.green.bold(`\n✅ Success! Scraped data saved to:`));
+        console.log(chalk_1.default.underline(output));
+        console.log('\n');
+    }
+    catch (error) {
+        if (progressBar.isActive)
+            progressBar.stop();
+        console.error(chalk_1.default.red(`\n❌ Error: ${error.message}`));
+        process.exit(1);
+    }
+});
+commander_1.program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

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

package/lib/cjs/logger.d.ts

@@ -0,0 +1,4 @@
+import winston from 'winston';
+declare const logger: winston.Logger;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/cjs/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,QAAA,MAAM,MAAM,gBAeV,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/lib/cjs/logger.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const winston_1 = __importDefault(require("winston"));
+const path_1 = __importDefault(require("path"));
+const logger = winston_1.default.createLogger({
+    level: 'info',
+    format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.json()),
+    transports: [
+        new winston_1.default.transports.File({
+            filename: path_1.default.join(__dirname, '../results/error.log'),
+            level: 'error'
+        }),
+        new winston_1.default.transports.File({
+            filename: path_1.default.join(__dirname, '../results/combined.log')
+        }),
+    ],
+});
+exports.default = logger;
+//# sourceMappingURL=logger.js.map

package/lib/cjs/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";;;;;AAAA,sDAA8B;AAC9B,gDAAwB;AAExB,MAAM,MAAM,GAAG,iBAAO,CAAC,YAAY,CAAC;IAClC,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,iBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,iBAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;IACD,UAAU,EAAE;QACV,IAAI,iBAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;YACtD,KAAK,EAAE,OAAO;SACf,CAAC;QACF,IAAI,iBAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC;SAC1D,CAAC;KACH;CACF,CAAC,CAAC;AAEH,kBAAe,MAAM,CAAC"}

package/lib/cjs/main.d.ts

@@ -0,0 +1,5 @@
+export * from './core';
+export * from './api';
+export * from './parser';
+export * from './utils';
+//# sourceMappingURL=main.d.ts.map

package/lib/cjs/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/lib/cjs/main.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core"), exports);
+__exportStar(require("./api"), exports);
+__exportStar(require("./parser"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=main.js.map

package/lib/cjs/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,wCAAsB;AACtB,2CAAyB;AACzB,0CAAwB"}

package/lib/cjs/parser.d.ts

@@ -0,0 +1,15 @@
+export interface PostalCodeResult {
+    no: string;
+    kodepos: string;
+    desa_kelurahan: string;
+    kecamatan: string;
+    kabupaten_kota: string;
+    provinsi: string;
+}
+/**
+ * Parses the raw HTML response from Pos Indonesia CariKodepos.
+ * @param html - The raw HTML content
+ * @returns List of parsed postal code objects
+ */
+export declare function parsePostalCodeTable(html: string): PostalCodeResult[];
+//# sourceMappingURL=parser.d.ts.map

package/lib/cjs/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmBrE"}

package/lib/cjs/parser.js

@@ -0,0 +1,61 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePostalCodeTable = parsePostalCodeTable;
+const cheerio = __importStar(require("cheerio"));
+/**
+ * Parses the raw HTML response from Pos Indonesia CariKodepos.
+ * @param html - The raw HTML content
+ * @returns List of parsed postal code objects
+ */
+function parsePostalCodeTable(html) {
+    const $ = cheerio.load(html);
+    const results = [];
+    $('table tbody tr').each((_i, row) => {
+        const cols = $(row).find('td');
+        if (cols.length >= 6) {
+            results.push({
+                no: $(cols[0]).text().trim(),
+                kodepos: $(cols[1]).text().trim(),
+                desa_kelurahan: $(cols[2]).text().trim(),
+                kecamatan: $(cols[3]).text().trim(),
+                kabupaten_kota: $(cols[4]).text().trim(),
+                provinsi: $(cols[5]).text().trim()
+            });
+        }
+    });
+    return results;
+}
+//# sourceMappingURL=parser.js.map

package/lib/cjs/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,oDAmBC;AAnCD,iDAAmC;AAWnC;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,IAAY;IAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACjC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACxC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACnC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;aACrC,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/lib/cjs/utils.d.ts

@@ -0,0 +1,16 @@
+import { PostalCodeResult } from './parser';
+/**
+ * Formats a raw numerical code into standard Indonesian administrative format (PP.KK.CC.DD).
+ * @param code - The raw code (e.g., 1101012001)
+ * @returns The formatted code (e.g., 11.01.01.2001)
+ */
+export declare function formatCode(code: string): string;
+/**
+ * Finds the best match in a list of search results using Fuzzy Matching.
+ * @param results - The list of parsed results
+ * @param villageName - The target village name
+ * @param districtName - The target district name
+ * @returns The best matching object or null
+ */
+export declare function findBestMatch(results: PostalCodeResult[], villageName: string, districtName: string): PostalCodeResult | null;
+//# sourceMappingURL=utils.d.ts.map

package/lib/cjs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACrB,gBAAgB,GAAG,IAAI,CAkCzB"}

package/lib/cjs/utils.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCode = formatCode;
+exports.findBestMatch = findBestMatch;
+const fuse_js_1 = __importDefault(require("fuse.js"));
+/**
+ * Formats a raw numerical code into standard Indonesian administrative format (PP.KK.CC.DD).
+ * @param code - The raw code (e.g., 1101012001)
+ * @returns The formatted code (e.g., 11.01.01.2001)
+ */
+function formatCode(code) {
+    if (!code)
+        return '';
+    const cleanCode = code.replace(/\./g, '');
+    const p1 = cleanCode.substring(0, 2);
+    const p2 = cleanCode.substring(2, 4);
+    const p3 = cleanCode.substring(4, 6);
+    const p4 = cleanCode.substring(6);
+    return [p1, p2, p3, p4].filter(Boolean).join('.');
+}
+/**
+ * Finds the best match in a list of search results using Fuzzy Matching.
+ * @param results - The list of parsed results
+ * @param villageName - The target village name
+ * @param districtName - The target district name
+ * @returns The best matching object or null
+ */
+function findBestMatch(results, villageName, districtName) {
+    if (!results || results.length === 0)
+        return null;
+    // 1. Try Exact Match First
+    const exactMatch = results.find(r => r.desa_kelurahan.toLowerCase() === villageName.toLowerCase() &&
+        r.kecamatan.toLowerCase() === districtName.toLowerCase());
+    if (exactMatch)
+        return exactMatch;
+    // 2. Fuzzy Match using Fuse.js
+    const fuseOptions = {
+        keys: [
+            { name: 'desa_kelurahan', weight: 0.7 },
+            { name: 'kecamatan', weight: 0.3 }
+        ],
+        threshold: 0.4, // Adjust for strictness (0.0 perfect, 1.0 match anything)
+        includeScore: true
+    };
+    const fuse = new fuse_js_1.default(results, fuseOptions);
+    const fuzzyResults = fuse.search(`${villageName} ${districtName}`);
+    if (fuzzyResults.length > 0) {
+        return fuzzyResults[0].item;
+    }
+    // 3. Fallback to simple contains logic
+    return results.find(r => (r.desa_kelurahan.toLowerCase().includes(villageName.toLowerCase()) ||
+        villageName.toLowerCase().includes(r.desa_kelurahan.toLowerCase())) &&
+        (r.kecamatan.toLowerCase().includes(districtName.toLowerCase()) ||
+            districtName.toLowerCase().includes(r.kecamatan.toLowerCase()))) || results[0];
+}
+//# sourceMappingURL=utils.js.map

package/lib/cjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";;;;;AAQA,gCAQC;AASD,sCAsCC;AA/DD,sDAA2B;AAG3B;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CACzB,OAA2B,EAC3B,WAAmB,EACnB,YAAoB;IAEpB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,2BAA2B;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAChC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE;QAC5D,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAC3D,CAAC;IACF,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,+BAA+B;IAC/B,MAAM,WAAW,GAAG;QAChB,IAAI,EAAE;YACF,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE;YACvC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE;SACrC;QACD,SAAS,EAAE,GAAG,EAAE,0DAA0D;QAC1E,YAAY,EAAE,IAAI;KACrB,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,iBAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,IAAI,YAAY,EAAE,CAAC,CAAC;IAEnE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,uCAAuC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACpB,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAClE,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAC9D,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CACnE,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/lib/esm/api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sends a POST request to Pos Indonesia CariKodepos endpoint.
+ * @param keyword - The search keyword (village name or postal code)
+ * @param cookie - Optional session cookie
+ * @returns The raw HTML response
+ */
+export declare function fetchPostalCodeHtml(keyword: string, cookie?: string): Promise<string>;
+//# sourceMappingURL=api.d.ts.map

package/lib/esm/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB3F"}

package/lib/esm/api.js

@@ -0,0 +1,31 @@
+import axios from 'axios';
+import qs from 'qs';
+/**
+ * Sends a POST request to Pos Indonesia CariKodepos endpoint.
+ * @param keyword - The search keyword (village name or postal code)
+ * @param cookie - Optional session cookie
+ * @returns The raw HTML response
+ */
+export async function fetchPostalCodeHtml(keyword, cookie) {
+    const URL = 'https://kodepos.posindonesia.co.id/CariKodepos';
+    const payload = qs.stringify({ kodepos: keyword });
+    try {
+        const response = await axios.post(URL, payload, {
+            headers: {
+                'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
+                'accept-language': 'en-US,en;q=0.9,id;q=0.8,ms;q=0.7',
+                'content-type': 'application/x-www-form-urlencoded',
+                'origin': 'https://kodepos.posindonesia.co.id',
+                'referer': 'https://kodepos.posindonesia.co.id/CariKodepos',
+                'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36',
+                'cookie': cookie || 'ci_session=siodf5sn3081n9fb1h3pfh7k8r92sjvt; TS011d97f9=01dc40192af9d2c68e0588cf6826f2541733c6f742d0e6382757bb95d8a2f8d27f6da94b22391892939703ae744a8f47fe7d578583'
+            },
+            timeout: 15000
+        });
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch data for ${keyword}: ${error.message}`);
+    }
+}
+//# sourceMappingURL=api.js.map

package/lib/esm/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe,EAAE,MAAe;IACtE,MAAM,GAAG,GAAG,gDAAgD,CAAC;IAC7D,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAEnD,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAS,GAAG,EAAE,OAAO,EAAE;YACpD,OAAO,EAAE;gBACL,QAAQ,EAAE,yIAAyI;gBACnJ,iBAAiB,EAAE,kCAAkC;gBACrD,cAAc,EAAE,mCAAmC;gBACnD,QAAQ,EAAE,oCAAoC;gBAC9C,SAAS,EAAE,gDAAgD;gBAC3D,YAAY,EAAE,uHAAuH;gBACrI,QAAQ,EAAE,MAAM,IAAI,oKAAoK;aAC3L;YACD,OAAO,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;AACL,CAAC"}

package/lib/esm/core.d.ts

@@ -0,0 +1,25 @@
+export interface ScraperOptions {
+    input: string;
+    limit: number;
+    delay: number;
+    cookie?: string;
+}
+export interface ScrapedVillage {
+    code: string;
+    name: string;
+    districtCode: string;
+    type: string;
+    provinceName: string;
+    regencyName: string;
+    districtName: string;
+    postalCode: string;
+}
+export type ProgressCallback = (current: number, total: number, village: string) => void;
+/**
+ * Core scraping logic separated from CLI.
+ * @param options - Configuration options
+ * @param onProgress - Callback for progress updates
+ * @returns Scraped results
+ */
+export declare function runScraper(options: ScraperOptions, onProgress?: ProgressCallback): Promise<ScrapedVillage[]>;
+//# sourceMappingURL=core.d.ts.map

package/lib/esm/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzF;;;;;GAKG;AACH,wBAAsB,UAAU,CAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,GAAE,gBAA2B,GACxC,OAAO,CAAC,cAAc,EAAE,CAAC,CAkD3B"}

package/lib/esm/core.js

@@ -0,0 +1,54 @@
+import * as fs from 'fs';
+import { fetchPostalCodeHtml } from './api';
+import { parsePostalCodeTable } from './parser';
+import { formatCode, findBestMatch } from './utils';
+/**
+ * Core scraping logic separated from CLI.
+ * @param options - Configuration options
+ * @param onProgress - Callback for progress updates
+ * @returns Scraped results
+ */
+export async function runScraper(options, onProgress = () => { }) {
+    const { input, limit, delay, cookie } = options;
+    if (!fs.existsSync(input)) {
+        throw new Error(`Input file not found at ${input}`);
+    }
+    const csvData = fs.readFileSync(input, 'utf-8');
+    const lines = csvData.split('\n').filter(line => line.trim() !== '');
+    const rows = lines.slice(1);
+    const totalToProcess = Math.min(rows.length, limit);
+    const scrapedResults = [];
+    for (let i = 0; i < totalToProcess; i++) {
+        const values = rows[i].split(',');
+        const code = values[0];
+        const name = values[1];
+        const prov = values[2];
+        const kab = values[3];
+        const kec = values[4];
+        onProgress(i, totalToProcess, name);
+        try {
+            const html = await fetchPostalCodeHtml(name, cookie);
+            const results = parsePostalCodeTable(html);
+            const bestMatch = findBestMatch(results, name, kec);
+            scrapedResults.push({
+                code: formatCode(code),
+                name: name,
+                districtCode: formatCode(code.substring(0, 6)),
+                type: "DESA",
+                provinceName: prov,
+                regencyName: kab,
+                districtName: kec,
+                postalCode: bestMatch ? bestMatch.kodepos : ""
+            });
+        }
+        catch (error) {
+            console.error(`\n⚠️ Failed to scrape ${name}: ${error.message}`);
+        }
+        if (i < totalToProcess - 1) {
+            await new Promise(r => setTimeout(r, delay));
+        }
+    }
+    onProgress(totalToProcess, totalToProcess, 'Completed!');
+    return scrapedResults;
+}
+//# sourceMappingURL=core.js.map

package/lib/esm/core.js.map

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

package/lib/esm/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/lib/esm/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import * as cliProgress from 'cli-progress';
+import { runScraper } from './core';
+program
+    .name('@damarkuncoro/posindonesia')
+    .description('Professional Indonesian Postal Code Scraper')
+    .version('1.0.0')
+    .option('-i, --input <path>', 'Input CSV file path', path.join(__dirname, '../../../docs/database_final.csv'))
+    .option('-o, --output <path>', 'Output JSON file path', path.join(__dirname, '../results/scraped_villages_detailed.json'))
+    .option('-l, --limit <number>', 'Number of rows to process', '10')
+    .option('-d, --delay <ms>', 'Delay between requests in milliseconds', '1000')
+    .option('-c, --cookie <string>', 'Custom session cookie for Pos Indonesia site')
+    .action(async (options) => {
+    const { output, limit, delay } = options;
+    console.log(chalk.blue.bold('\n🚀 Starting Indonesian Postal Code Scraper (TypeScript)\n'));
+    const progressBar = new cliProgress.SingleBar({
+        format: chalk.green('Progress |') + chalk.cyan('{bar}') + '| {percentage}% || {value}/{total} Villages || {village}',
+        barCompleteChar: '\u2588',
+        barIncompleteChar: '\u2591',
+        hideCursor: true
+    });
+    try {
+        const results = await runScraper({
+            ...options,
+            limit: parseInt(limit),
+            delay: parseInt(delay)
+        }, (current, total, village) => {
+            if (current === 0) {
+                progressBar.start(total, 0, { village });
+            }
+            else {
+                progressBar.update(current, { village });
+            }
+        });
+        progressBar.stop();
+        // Ensure output directory exists
+        const outputDir = path.dirname(output);
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        fs.writeFileSync(output, JSON.stringify(results, null, 2));
+        console.log(chalk.green.bold(`\n✅ Success! Scraped data saved to:`));
+        console.log(chalk.underline(output));
+        console.log('\n');
+    }
+    catch (error) {
+        if (progressBar.isActive)
+            progressBar.stop();
+        console.error(chalk.red(`\n❌ Error: ${error.message}`));
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

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

package/lib/esm/logger.d.ts

@@ -0,0 +1,4 @@
+import winston from 'winston';
+declare const logger: winston.Logger;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/esm/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,QAAA,MAAM,MAAM,gBAeV,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/lib/esm/logger.js

@@ -0,0 +1,17 @@
+import winston from 'winston';
+import path from 'path';
+const logger = winston.createLogger({
+    level: 'info',
+    format: winston.format.combine(winston.format.timestamp(), winston.format.json()),
+    transports: [
+        new winston.transports.File({
+            filename: path.join(__dirname, '../results/error.log'),
+            level: 'error'
+        }),
+        new winston.transports.File({
+            filename: path.join(__dirname, '../results/combined.log')
+        }),
+    ],
+});
+export default logger;
+//# sourceMappingURL=logger.js.map

package/lib/esm/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAClC,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;IACD,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;YACtD,KAAK,EAAE,OAAO;SACf,CAAC;QACF,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC;SAC1D,CAAC;KACH;CACF,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/lib/esm/main.d.ts

@@ -0,0 +1,5 @@
+export * from './core';
+export * from './api';
+export * from './parser';
+export * from './utils';
+//# sourceMappingURL=main.d.ts.map

package/lib/esm/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/lib/esm/main.js

@@ -0,0 +1,5 @@
+export * from './core';
+export * from './api';
+export * from './parser';
+export * from './utils';
+//# sourceMappingURL=main.js.map

package/lib/esm/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/lib/esm/parser.d.ts

@@ -0,0 +1,15 @@
+export interface PostalCodeResult {
+    no: string;
+    kodepos: string;
+    desa_kelurahan: string;
+    kecamatan: string;
+    kabupaten_kota: string;
+    provinsi: string;
+}
+/**
+ * Parses the raw HTML response from Pos Indonesia CariKodepos.
+ * @param html - The raw HTML content
+ * @returns List of parsed postal code objects
+ */
+export declare function parsePostalCodeTable(html: string): PostalCodeResult[];
+//# sourceMappingURL=parser.d.ts.map

package/lib/esm/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmBrE"}

package/lib/esm/parser.js

@@ -0,0 +1,25 @@
+import * as cheerio from 'cheerio';
+/**
+ * Parses the raw HTML response from Pos Indonesia CariKodepos.
+ * @param html - The raw HTML content
+ * @returns List of parsed postal code objects
+ */
+export function parsePostalCodeTable(html) {
+    const $ = cheerio.load(html);
+    const results = [];
+    $('table tbody tr').each((_i, row) => {
+        const cols = $(row).find('td');
+        if (cols.length >= 6) {
+            results.push({
+                no: $(cols[0]).text().trim(),
+                kodepos: $(cols[1]).text().trim(),
+                desa_kelurahan: $(cols[2]).text().trim(),
+                kecamatan: $(cols[3]).text().trim(),
+                kabupaten_kota: $(cols[4]).text().trim(),
+                provinsi: $(cols[5]).text().trim()
+            });
+        }
+    });
+    return results;
+}
+//# sourceMappingURL=parser.js.map

package/lib/esm/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAWnC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACjC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACxC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACnC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;aACrC,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/lib/esm/utils.d.ts

@@ -0,0 +1,16 @@
+import { PostalCodeResult } from './parser';
+/**
+ * Formats a raw numerical code into standard Indonesian administrative format (PP.KK.CC.DD).
+ * @param code - The raw code (e.g., 1101012001)
+ * @returns The formatted code (e.g., 11.01.01.2001)
+ */
+export declare function formatCode(code: string): string;
+/**
+ * Finds the best match in a list of search results using Fuzzy Matching.
+ * @param results - The list of parsed results
+ * @param villageName - The target village name
+ * @param districtName - The target district name
+ * @returns The best matching object or null
+ */
+export declare function findBestMatch(results: PostalCodeResult[], villageName: string, districtName: string): PostalCodeResult | null;
+//# sourceMappingURL=utils.d.ts.map

package/lib/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACrB,gBAAgB,GAAG,IAAI,CAkCzB"}

package/lib/esm/utils.js

@@ -0,0 +1,52 @@
+import Fuse from 'fuse.js';
+/**
+ * Formats a raw numerical code into standard Indonesian administrative format (PP.KK.CC.DD).
+ * @param code - The raw code (e.g., 1101012001)
+ * @returns The formatted code (e.g., 11.01.01.2001)
+ */
+export function formatCode(code) {
+    if (!code)
+        return '';
+    const cleanCode = code.replace(/\./g, '');
+    const p1 = cleanCode.substring(0, 2);
+    const p2 = cleanCode.substring(2, 4);
+    const p3 = cleanCode.substring(4, 6);
+    const p4 = cleanCode.substring(6);
+    return [p1, p2, p3, p4].filter(Boolean).join('.');
+}
+/**
+ * Finds the best match in a list of search results using Fuzzy Matching.
+ * @param results - The list of parsed results
+ * @param villageName - The target village name
+ * @param districtName - The target district name
+ * @returns The best matching object or null
+ */
+export function findBestMatch(results, villageName, districtName) {
+    if (!results || results.length === 0)
+        return null;
+    // 1. Try Exact Match First
+    const exactMatch = results.find(r => r.desa_kelurahan.toLowerCase() === villageName.toLowerCase() &&
+        r.kecamatan.toLowerCase() === districtName.toLowerCase());
+    if (exactMatch)
+        return exactMatch;
+    // 2. Fuzzy Match using Fuse.js
+    const fuseOptions = {
+        keys: [
+            { name: 'desa_kelurahan', weight: 0.7 },
+            { name: 'kecamatan', weight: 0.3 }
+        ],
+        threshold: 0.4, // Adjust for strictness (0.0 perfect, 1.0 match anything)
+        includeScore: true
+    };
+    const fuse = new Fuse(results, fuseOptions);
+    const fuzzyResults = fuse.search(`${villageName} ${districtName}`);
+    if (fuzzyResults.length > 0) {
+        return fuzzyResults[0].item;
+    }
+    // 3. Fallback to simple contains logic
+    return results.find(r => (r.desa_kelurahan.toLowerCase().includes(villageName.toLowerCase()) ||
+        villageName.toLowerCase().includes(r.desa_kelurahan.toLowerCase())) &&
+        (r.kecamatan.toLowerCase().includes(districtName.toLowerCase()) ||
+            districtName.toLowerCase().includes(r.kecamatan.toLowerCase()))) || results[0];
+}
+//# sourceMappingURL=utils.js.map

package/lib/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CACzB,OAA2B,EAC3B,WAAmB,EACnB,YAAoB;IAEpB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,2BAA2B;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAChC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE;QAC5D,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAC3D,CAAC;IACF,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,+BAA+B;IAC/B,MAAM,WAAW,GAAG;QAChB,IAAI,EAAE;YACF,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE;YACvC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE;SACrC;QACD,SAAS,EAAE,GAAG,EAAE,0DAA0D;QAC1E,YAAY,EAAE,IAAI;KACrB,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,IAAI,YAAY,EAAE,CAAC,CAAC;IAEnE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,uCAAuC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACpB,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAClE,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAC9D,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CACnE,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@damarkuncoro/posindonesia",
+  "version": "1.0.0",
+  "description": "Indonesian Postal Code Scraper from Pos Indonesia Official Website",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/damarkuncoro/posindonesia.git"
+  },
+  "bugs": {
+    "url": "https://github.com/damarkuncoro/posindonesia/issues"
+  },
+  "homepage": "https://github.com/damarkuncoro/posindonesia#readme",
+  "main": "lib/cjs/main.js",
+  "module": "lib/esm/main.js",
+  "types": "lib/cjs/main.d.ts",
+  "exports": {
+    ".": {
+      "import": "./lib/esm/main.js",
+      "require": "./lib/cjs/main.js",
+      "types": "./lib/cjs/main.d.ts"
+    }
+  },
+  "bin": {
+    "scrape-pos": "lib/cjs/index.js"
+  },
+  "scripts": {
+    "start": "ts-node src/index.ts",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build": "rm -rf lib && npm run build:cjs && npm run build:esm",
+    "prepublishOnly": "npm run build && npm test",
+    "scrape": "ts-node src/index.ts",
+    "test": "jest"
+  },
+  "keywords": [
+    "indonesia",
+    "postal-code",
+    "kodepos",
+    "scraper",
+    "pos-indonesia",
+    "typescript"
+  ],
+  "author": "damarkuncoro",
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "axios": "^1.13.6",
+    "chalk": "^4.1.2",
+    "cheerio": "^1.2.0",
+    "cli-progress": "^3.12.0",
+    "commander": "^14.0.3",
+    "puppeteer": "^24.39.0",
+    "qs": "^6.15.0",
+    "fuse.js": "^7.1.0",
+    "winston": "^3.19.0"
+  },
+  "devDependencies": {
+    "@types/axios": "^0.9.36",
+    "@types/chalk": "^0.4.31",
+    "@types/cheerio": "^0.22.35",
+    "@types/cli-progress": "^3.11.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "@types/qs": "^6.15.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}