@lokal-id/core 0.2.2 → 0.4.0

package/README.md

@@ -1,61 +1,61 @@
-# @lokal-id/core
-
-[![npm](https://img.shields.io/npm/v/@lokal-id/core?color=cb3837)](https://www.npmjs.com/package/@lokal-id/core)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/lokal-id/lokal/blob/HEAD/LICENSE)
-
-Indonesian data primitives for apps and AI agents: NIK, NPWP, phone numbers, Rupiah, *terbilang*, holidays and working days, Kemendagri regions with postal codes, and **Samaran**, which masks Indonesian personal data before it reaches an LLM and restores it afterwards.
-
-No dependencies. Part of [Lokal](https://github.com/lokal-id/lokal) · [Bahasa Indonesia](https://github.com/lokal-id/lokal/blob/HEAD/README.id.md)
-
-## Install
-
-```sh
-npm install @lokal-id/core
-```
-
-For Python backends there is a port with identical results: `pip install lokal-id` ([docs](https://github.com/lokal-id/lokal/tree/HEAD/python#readme)).
-
-## Usage
-
-```ts
-import { parseNik, parsePhone, formatRupiah, parseRupiah, terbilang, addWorkingDays, Samaran } from '@lokal-id/core';
-import { listWilayah, searchWilayah, wilayahName, findByPostalCode } from '@lokal-id/core/wilayah';
-
-parseNik('3201011508950001', { lookupWilayah: wilayahName });
-// { valid: true, province: 'Jawa Barat', regency: 'Kabupaten Bogor', gender: 'L', birthDate: '1995-08-15', … }
-parsePhone('0812 3456 7890');           // { e164: '+6281234567890', operator: 'Telkomsel', … }
-formatRupiah(1500000);                  // 'Rp1.500.000'
-parseRupiah('sejuta setengah');         // { amount: 1500000, approximate: false }
-terbilang(1500000, { currency: true }); // 'satu juta lima ratus ribu rupiah'
-addWorkingDays('2026-03-17', 1);        // '2026-03-25', skipping Nyepi and Lebaran
-listWilayah('32.76');                   // districts of Kota Depok
-findByPostalCode('16431');              // villages that use this postal code
-```
-
-### Samaran
-
-```ts
-const samaran = new Samaran();
-const { text } = samaran.mask('nama saya budi santoso, NIK 3201011508950001, HP 0812-3456-7890');
-// 'nama saya [NAME_1], NIK [NIK_1], HP [PHONE_1]'
-
-samaran.unmask(await llm(text));        // placeholders are replaced with the original values
-```
-
-The same value always gets the same placeholder, so the model can still deduplicate and join. Use `mode: 'partial'` for logs and admin screens (`3201********0001`).
-
-`@lokal-id/core/wilayah` loads about 4.4 MB of region data and runs on Node only. The main entry point does not load it and is safe for browsers.
-
-## Data
-
-| Data | Source |
-|---|---|
-| Regions: 38 provinces, 416 regencies, 98 cities, 7,285 districts, 8,496 *kelurahan*, 75,266 villages | [cahyadsn/wilayah](https://github.com/cahyadsn/wilayah) (MIT), following Kepmendagri 300.2.2-2138/2025 |
-| Postal codes for all 83,762 villages | [cahyadsn/wilayah_kodepos](https://github.com/cahyadsn/wilayah_kodepos) (MIT) |
-| Holidays and *cuti bersama* for 2026 and 2027 | SKB 3 Menteri. Other years return an error, not a guess |
-
-Detection limits and full documentation are in the [Lokal README](https://github.com/lokal-id/lokal#limitations).
-
-## License
-
-[MIT](https://github.com/lokal-id/lokal/blob/HEAD/LICENSE)
+# @lokal-id/core
+
+[![npm](https://img.shields.io/npm/v/@lokal-id/core?color=cb3837)](https://www.npmjs.com/package/@lokal-id/core)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/lokal-id/lokal/blob/HEAD/LICENSE)
+
+Indonesian data primitives for apps and AI agents: NIK, NPWP, phone numbers, Rupiah, *terbilang*, holidays and working days, Kemendagri regions with postal codes, and **Samaran**, which masks Indonesian personal data before it reaches an LLM and restores it afterwards.
+
+No dependencies. Part of [Lokal](https://github.com/lokal-id/lokal) · [Bahasa Indonesia](https://github.com/lokal-id/lokal/blob/HEAD/README.id.md)
+
+## Install
+
+```sh
+npm install @lokal-id/core
+```
+
+For Python backends there is a port with identical results: `pip install lokal-id` ([docs](https://github.com/lokal-id/lokal/tree/HEAD/python#readme)).
+
+## Usage
+
+```ts
+import { parseNik, parsePhone, formatRupiah, parseRupiah, terbilang, addWorkingDays, Samaran } from '@lokal-id/core';
+import { listWilayah, searchWilayah, wilayahName, findByPostalCode } from '@lokal-id/core/wilayah';
+
+parseNik('3201011508950001', { lookupWilayah: wilayahName });
+// { valid: true, province: 'Jawa Barat', regency: 'Kabupaten Bogor', gender: 'L', birthDate: '1995-08-15', … }
+parsePhone('0812 3456 7890');           // { e164: '+6281234567890', operator: 'Telkomsel', … }
+formatRupiah(1500000);                  // 'Rp1.500.000'
+parseRupiah('sejuta setengah');         // { amount: 1500000, approximate: false }
+terbilang(1500000, { currency: true }); // 'satu juta lima ratus ribu rupiah'
+addWorkingDays('2026-03-17', 1);        // '2026-03-25', skipping Nyepi and Lebaran
+listWilayah('32.76');                   // districts of Kota Depok
+findByPostalCode('16431');              // villages that use this postal code
+```
+
+### Samaran
+
+```ts
+const samaran = new Samaran();
+const { text } = samaran.mask('nama saya budi santoso, NIK 3201011508950001, HP 0812-3456-7890');
+// 'nama saya [NAME_1], NIK [NIK_1], HP [PHONE_1]'
+
+samaran.unmask(await llm(text));        // placeholders are replaced with the original values
+```
+
+The same value always gets the same placeholder, so the model can still deduplicate and join. Use `mode: 'partial'` for logs and admin screens (`3201********0001`).
+
+`@lokal-id/core/wilayah` loads about 4.4 MB of region data and runs on Node only. The main entry point does not load it and is safe for browsers.
+
+## Data
+
+| Data | Source |
+|---|---|
+| Regions: 38 provinces, 416 regencies, 98 cities, 7,285 districts, 8,496 *kelurahan*, 75,266 villages | [cahyadsn/wilayah](https://github.com/cahyadsn/wilayah) (MIT), following Kepmendagri 300.2.2-2138/2025 |
+| Postal codes for all 83,762 villages | [cahyadsn/wilayah_kodepos](https://github.com/cahyadsn/wilayah_kodepos) (MIT) |
+| Holidays and *cuti bersama* for 2026 and 2027 | SKB 3 Menteri. Other years return an error, not a guess |
+
+Detection limits and full documentation are in the [Lokal README](https://github.com/lokal-id/lokal#limitations).
+
+## License
+
+[MIT](https://github.com/lokal-id/lokal/blob/HEAD/LICENSE)

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { parseNpwp, formatNpwp15, type NpwpInfo, type NpwpKind } from './npwp.ts
 export { parsePhone, normalizePhone, type PhoneInfo, type PhoneType } from './phone.ts';
 export { formatRupiah, formatRupiahShort, parseRupiah, type FormatRupiahOptions, type ParsedRupiah, } from './rupiah.ts';
 export { terbilang, type TerbilangOptions } from './terbilang.ts';
+export { parseQris, setQrisAmount, qrisCrc, type QrisInfo, type QrisField, type QrisMerchantAccount, type QrisTip, type QrisAdditionalData, type QrisAmountOptions, } from './qris.ts';
 export { PROVINCES } from './provinces.ts';
 export { getHolidays, holidaysOn, isWorkingDay, addWorkingDays, countWorkingDays, HOLIDAY_YEARS, type Holiday, type HolidayType, type HolidayYear, type WorkingDayOptions, } from './holidays.ts';
 export { Samaran, maskPii, detectPii, partialMask, fieldType, PII_TYPES, UU_PDP_CATEGORY, type PiiType, type PiiMatch, type MaskedMatch, type MaskResult, type SamaranOptions, type DetectOptions, type Confidence, } from './samaran/index.ts';

package/dist/index.js

@@ -3,6 +3,7 @@ export { parseNpwp, formatNpwp15 } from './npwp.js';
 export { parsePhone, normalizePhone } from './phone.js';
 export { formatRupiah, formatRupiahShort, parseRupiah, } from './rupiah.js';
 export { terbilang } from './terbilang.js';
+export { parseQris, setQrisAmount, qrisCrc, } from './qris.js';
 export { PROVINCES } from './provinces.js';
 export { getHolidays, holidaysOn, isWorkingDay, addWorkingDays, countWorkingDays, HOLIDAY_YEARS, } from './holidays.js';
 export { Samaran, maskPii, detectPii, partialMask, fieldType, PII_TYPES, UU_PDP_CATEGORY, } from './samaran/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAA+D,MAAM,UAAU,CAAC;AAC7G,OAAO,EAAE,SAAS,EAAE,YAAY,EAAgC,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAkC,MAAM,YAAY,CAAC;AACxF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,GAKd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,eAAe,GAQhB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAA+D,MAAM,UAAU,CAAC;AAC7G,OAAO,EAAE,SAAS,EAAE,YAAY,EAAgC,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAkC,MAAM,YAAY,CAAC;AACxF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,OAAO,GAOR,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,GAKd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,eAAe,GAQhB,MAAM,oBAAoB,CAAC"}

package/dist/kembaran-data.d.ts

@@ -0,0 +1,10 @@
+export declare const MALE_FIRST: readonly string[];
+export declare const FEMALE_FIRST: readonly string[];
+export declare const MALE_LAST: readonly string[];
+export declare const FEMALE_LAST: readonly string[];
+export declare const STREETS: readonly string[];
+export declare const HEALTH: readonly string[];
+export declare const RELIGIONS: readonly string[];
+export declare const MARITAL: readonly string[];
+/** Honorifics and connecting words in a name that say nothing about who the person is. */
+export declare const NAME_KEEP: ReadonlySet<string>;

package/dist/kembaran-data.js

@@ -0,0 +1,46 @@
+// Word lists for Kembaran's stand-in values: common Indonesian given names and family names from many regions,
+// street names of the kind found in every town, and harmless health complaints. Combinations are random, so a
+// stand-in that happens to match a real person's name is a coincidence, not a link to them.
+// python/src/lokal/_kembaran_data.py holds the same lists, in the same order.
+export const MALE_FIRST = [
+    'Agus', 'Ahmad', 'Andi', 'Anton', 'Arif', 'Asep', 'Bagus', 'Bambang', 'Bayu', 'Benny', 'Budi', 'Cecep', 'Dadang',
+    'Dani', 'Daniel', 'Dedi', 'Dimas', 'Doni', 'Edi', 'Eko', 'Fajar', 'Farhan', 'Fikri', 'Galih', 'Gede', 'Gilang',
+    'Hadi', 'Hari', 'Hendra', 'Heru', 'Ilham', 'Imam', 'Indra', 'Irfan', 'Ivan', 'Iwan', 'Joko', 'Ketut', 'Kevin',
+    'Komang', 'Krisna', 'Lukman', 'Made', 'Michael', 'Muhammad', 'Nyoman', 'Paulus', 'Putu', 'Rahmat', 'Rangga',
+    'Reza', 'Ridwan', 'Rizki', 'Rudi', 'Satria', 'Sigit', 'Slamet', 'Steven', 'Surya', 'Taufik', 'Teguh', 'Togar',
+    'Tono', 'Ujang', 'Wahyu', 'Wawan', 'Yoga', 'Yohanes', 'Yudi', 'Yusuf', 'Zainal',
+];
+export const FEMALE_FIRST = [
+    'Ana', 'Ani', 'Ayu', 'Butet', 'Citra', 'Desi', 'Dewi', 'Dian', 'Erna', 'Euis', 'Fitri', 'Fransiska', 'Grace',
+    'Hana', 'Iis', 'Indah', 'Intan', 'Irma', 'Jessica', 'Kartika', 'Lina', 'Lusi', 'Maya', 'Mega', 'Nadia', 'Neng',
+    'Nina', 'Novi', 'Nur', 'Nurul', 'Putri', 'Rahma', 'Ratna', 'Rina', 'Rini', 'Rosa', 'Santi', 'Sari', 'Siti', 'Sri',
+    'Susi', 'Tari', 'Tuti', 'Vina', 'Widya', 'Wulan', 'Yanti', 'Yohana', 'Yuni',
+];
+export const MALE_LAST = [
+    'Damanik', 'Daulay', 'Effendi', 'Firmansyah', 'Ginting', 'Gunawan', 'Hakim', 'Halim', 'Harahap', 'Hartono',
+    'Haryanto', 'Hermawan', 'Hidayat', 'Hutapea', 'Kurniawan', 'Lubis', 'Manurung', 'Matondang', 'Maulana', 'Nasution',
+    'Nugroho', 'Panjaitan', 'Pane', 'Pratama', 'Prasetyo', 'Purba', 'Purnomo', 'Rahman', 'Ramadhan', 'Rangkuti',
+    'Santoso', 'Saputra', 'Sembiring', 'Setiawan', 'Simanjuntak', 'Sinaga', 'Siregar', 'Sitepu', 'Sugiarto', 'Suryadi',
+    'Susanto', 'Sutrisno', 'Syahputra', 'Tambunan', 'Tanjung', 'Tarigan', 'Utomo', 'Wahyudi', 'Wibowo', 'Wijaya',
+];
+export const FEMALE_LAST = [
+    'Andriani', 'Anggraini', 'Astuti', 'Damayanti', 'Fitriani', 'Ginting', 'Halim', 'Handayani', 'Hapsari', 'Harahap',
+    'Kartini', 'Kusumawati', 'Lestari', 'Lubis', 'Maharani', 'Nasution', 'Ningsih', 'Novitasari', 'Oktaviani',
+    'Permata', 'Pertiwi', 'Puspita', 'Purnamasari', 'Rahayu', 'Rahmawati', 'Safitri', 'Sari', 'Sinaga', 'Siregar',
+    'Susanti', 'Suryani', 'Tanjung', 'Tarigan', 'Utami', 'Wahyuni', 'Wijaya', 'Wulandari', 'Yuliani',
+];
+export const STREETS = [
+    'Akasia', 'Anggrek', 'Bahagia', 'Bakti', 'Beringin', 'Cemara', 'Cempaka', 'Cendrawasih', 'Dahlia', 'Damai', 'Durian',
+    'Elang', 'Flamboyan', 'Harapan', 'Jati', 'Karya', 'Kelapa', 'Kemuning', 'Kenanga', 'Kutilang', 'Mahoni', 'Mangga',
+    'Melati', 'Merdeka', 'Merpati', 'Nusa Indah', 'Pahlawan', 'Pelita', 'Pemuda', 'Rajawali', 'Rambutan', 'Sejahtera',
+    'Seroja', 'Swadaya', 'Teratai',
+];
+export const HEALTH = ['Sehat', 'Flu', 'Demam', 'Batuk', 'Sakit kepala', 'Alergi ringan', 'Maag', 'Pegal linu'];
+export const RELIGIONS = ['Islam', 'Kristen', 'Katolik', 'Hindu', 'Buddha', 'Konghucu'];
+export const MARITAL = ['Belum Kawin', 'Kawin', 'Cerai Hidup', 'Cerai Mati'];
+/** Honorifics and connecting words in a name that say nothing about who the person is. */
+export const NAME_KEEP = new Set([
+    'bapak', 'bpk', 'ibu', 'bu', 'pak', 'sdr', 'sdri', 'tn', 'ny', 'nn', 'kak', 'mas', 'mbak', 'bin', 'binti', 'dr', 'drs',
+    'dra', 'ir', 'h', 'hj', 'prof', 'st', 'se', 'sh', 'mm', 'skom', 'spd', 'amd',
+]);
+//# sourceMappingURL=kembaran-data.js.map

package/dist/kembaran-data.js.map

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

package/dist/kembaran.d.ts

@@ -0,0 +1,46 @@
+import { type Confidence, type PiiType } from './samaran/index.ts';
+export interface KembaranOptions {
+    /** The same secret gives the same stand-ins on every run. Without one, each run picks a random secret. */
+    secret?: string;
+    /** Types left as they are. Default: gender, religion, marital status, and nationality, which identify no one. */
+    keep?: readonly PiiType[];
+    /** Keep the whole birth date, not just the year: more useful for debugging, easier to single someone out. */
+    keepBirthDate?: boolean;
+    /** "high" replaces only validated or labeled matches. Default "medium". */
+    minConfidence?: Confidence;
+}
+export interface KembaranResult {
+    text: string;
+    /** How many values of each type were replaced. */
+    replaced: Partial<Record<PiiType, number>>;
+}
+export declare const KEEP_BY_DEFAULT: readonly PiiType[];
+interface Day {
+    day: number;
+    month: number;
+}
+export declare class Kembaran {
+    private readonly key;
+    private readonly keep;
+    private readonly keepBirthDate;
+    private readonly minConfidence;
+    private readonly fakes;
+    private readonly used;
+    private readonly nikDays;
+    constructor(options?: KembaranOptions);
+    /** Replaces every piece of personal data in a text: a CSV, an SQL dump, JSON, a log, or prose. */
+    text(input: string): KembaranResult;
+    /** The stand-in for one value of a known type. */
+    value(type: PiiType, original: string, rowDay?: Day): string;
+    /** The words of a name that identify the person: not honorifics, titles, or "bin". */
+    private nameCore;
+    /** A stand-in in canonical form: digits for numbers, words joined by spaces for names. */
+    private make;
+    /** A stand-in in the original's format: its separators, its casing, its titles. */
+    private render;
+    private address;
+    private birthDate;
+}
+/** One-shot: replaces personal data in a text with stand-ins under a random secret. */
+export declare function kembaran(text: string, options?: KembaranOptions): KembaranResult;
+export {};