@fauzitech/nusakit

Toolkit validasi & format data Indonesia — NIK, NPWP, nomor HP, Rupiah (+ terbilang), dan rekening bank. Zero dependencies, tree-shakeable, TypeScript.

⚠️ Penting — baca dulu

• Validasi bersifat struktural & offline. Library ini tidak terhubung ke Dukcapil, DJP, atau sistem perbankan. Data yang "valid" secara struktur belum tentu terdaftar resmi.
• Kewajiban perlindungan data pribadi (UU PDP No. 27/2022) berada pada aplikasi yang memproses & menyimpan data, bukan pada utility ini. Library ini netral — ia hanya memvalidasi format angka yang sudah Anda miliki.
• Modul dummy menghasilkan data untuk testing/seeding saja — bukan identitas asli. Jangan gunakan untuk membuat identitas palsu.

Install

npm install @fauzitech/nusakit

Pakai

Import seluruhnya, atau per-modul untuk bundle minimal:

import { validateNik, terbilang } from '@fauzitech/nusakit';
// atau
import { validateNik } from '@fauzitech/nusakit/nik';
import { terbilang } from '@fauzitech/nusakit/rupiah';

NIK

import { validateNik, isValidNik, parseNik } from '@fauzitech/nusakit/nik';

const r = validateNik('3171015708900002');
// {
//   valid: true,
//   info: {
//     province: 'DKI Jakarta', provinceCode: '31',
//     gender: 'P', birthDateISO: '1990-08-17', age: 35, serial: '0002', ...
//   }
// }

isValidNik('3171 0117 0890 0001'); // true (toleran spasi/titik)
parseNik('123');                   // null

Terurai: provinsi, kode kab/kota, kecamatan, tanggal lahir, jenis kelamin (perempuan = tanggal + 40), dan umur.

Rupiah & terbilang

import { formatRupiah, parseRupiah, terbilang, terbilangRupiah } from '@fauzitech/nusakit/rupiah';

formatRupiah(1500000);                 // "Rp 1.500.000"
formatRupiah(1500.5, { decimals: 2 }); // "Rp 1.500,50"
parseRupiah('Rp 1.500.000');           // 1500000

terbilang(1500000);        // "satu juta lima ratus ribu"
terbilang(1000);           // "seribu"
terbilangRupiah(1500000);  // "satu juta lima ratus ribu rupiah"

Nomor HP

import { validatePhone, formatPhone, detectOperator } from '@fauzitech/nusakit/phone';

formatPhone('081234567890', 'international'); // "+6281234567890"
formatPhone('+6281234567890', 'local');       // "081234567890"
detectOperator('081234567890');               // "Telkomsel"

Menerima 08xx, 8xx, 62xx, +62xx (toleran strip/spasi). Deteksi operator: Telkomsel, Indosat, XL, Axis, Tri, Smartfren.

NPWP

import { validateNpwp, formatNpwp } from '@fauzitech/nusakit/npwp';

formatNpwp('012345678901000'); // "01.234.567.8-901.000"
validateNpwp('3171011708900001').info.format; // 16 (format baru = NIK)

Mendukung format lama (15 digit) dan format baru (16 digit = NIK).

Bank & rekening

import { findBank, searchBank, validateAccount } from '@fauzitech/nusakit/bank';

findBank('014');                       // { code: '014', name: 'Bank Central Asia (BCA)', ... }
searchBank('mandiri');                 // [{ code: '008', ... }]
validateAccount('014', '1234567890');  // { valid: true, bank: {...} }

Validasi rekening bersifat struktural (panjang & digit), bukan verifikasi kepemilikan.

Data dummy (testing only)

import { dummyNik, dummyPhone, dummyNpwp } from '@fauzitech/nusakit/dummy';

dummyNik({ gender: 'P', provinceCode: '31', birthYear: 1995 });
dummyPhone();
dummyNpwp();

Menghasilkan data yang lolos validasi struktur — untuk unit test, seeding DB dev, fixture. Bukan identitas asli.

Lisensi

MIT © Muhammad Fauzi Azhar