@ghifari29/id-kit 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -22,6 +22,8 @@ import { mask, maskNIK, maskPhone, maskAccount } from "@ghifari29/id-kit/mask";
22
22
  import { parseNPWP, parseNITKU, isValidNPWP, isValidNITKU } from "@ghifari29/id-kit/npwp";
23
23
  import { getBank, listBank } from "@ghifari29/id-kit/bank";
24
24
  import { cekLibur, daftarLibur, tahunTersedia } from "@ghifari29/id-kit/libur";
25
+ import { formatTanggal, formatWaktu, formatTanggalWaktu, keZonaWaktu, zonaWaktuProvinsi } from "@ghifari29/id-kit/waktu";
26
+ import { getProvinsi, listProvinsi, getKabKota, listKabKota, cariWilayah } from "@ghifari29/id-kit/wilayah";
25
27
 
26
28
  terbilang(1250000);
27
29
  // "satu juta dua ratus lima puluh ribu rupiah"
@@ -70,6 +72,21 @@ cekLibur("2026-08-17");
70
72
 
71
73
  cekLibur("2099-01-01");
72
74
  // { status: "data-tidak-tersedia", tahun: 2099 }
75
+
76
+ formatTanggal("2026-11-18", { denganHari: true });
77
+ // "Rabu, 18 November 2026"
78
+
79
+ formatTanggalWaktu("2026-11-18T13:35:00Z", { zona: "WITA" });
80
+ // "18 November 2026, 21:35 WITA"
81
+
82
+ zonaWaktuProvinsi("64");
83
+ // "WITA"
84
+
85
+ getKabKota("3171");
86
+ // { kode: "31.71", provinsiKode: "31", nama: "Kota Administrasi Jakarta Pusat", jenis: "kota" }
87
+
88
+ cariWilayah("sorong");
89
+ // [{ tingkat: "kabupaten", kode: "96.01", ... }, { tingkat: "kabupaten", kode: "96.02", ... }, { tingkat: "kota", kode: "96.71", ... }]
73
90
  ```
74
91
 
75
92
  ## Fitur
@@ -82,8 +99,8 @@ cekLibur("2099-01-01");
82
99
  - [x] `parseNPWP`, `isValidNPWP`, `parseNITKU`, `isValidNITKU` (validasi format NPWP & NITKU)
83
100
  - [x] `getBank`, `listBank` (daftar kode bank 3 digit)
84
101
  - [x] `cekLibur`, `daftarLibur`, `tahunTersedia` (libur nasional dan cuti bersama)
85
- - [ ] Validasi nomor rekening
86
- - [ ] Data wilayah
102
+ - [x] `formatTanggal`, `formatWaktu`, `formatTanggalWaktu`, `keZonaWaktu`, `zonaWaktuProvinsi` (format & zona waktu Indonesia)
103
+ - [x] `getProvinsi`, `listProvinsi`, `getKabKota`, `listKabKota`, `cariWilayah` (data 38 provinsi dan 514 kabupaten/kota)
87
104
 
88
105
  ## Batasan
89
106
 
@@ -95,6 +112,8 @@ cekLibur("2099-01-01");
95
112
  - `parseNPWP`, `isValidNPWP`, `parseNITKU`, dan `isValidNITKU` hanya memvalidasi format dan panjang (tanpa checksum), bukan bukti terdaftar di DJP. Klasifikasi `"nik"` hanya menunjukkan bentuk cocok dengan NIK, bukan bukti NPWP orang pribadi terdaftar (WNA bukan penduduk tidak memakai NIK); pola `"badan-awalan-0"` (`0 + 15 digit`) hanya berlaku untuk entitas terdaftar sebelum 14 Juli 2022.
96
113
  - Modul `bank` (`getBank`, `listBank`) diverifikasi pada `2026-11-18` dari sumber sekunder (jaringan switching dan situs bank) karena Bank Indonesia tidak menerbitkan satu tabel terbuka untuk semua kode 3 digit. Daftar bisa usang akibat perubahan nama atau merger—cocokkan dengan sumber resmi bank sebelum dipakai untuk transaksi. Tidak ada validasi panjang nomor rekening, dengan sengaja.
97
114
  - Modul `libur` (`cekLibur`, `daftarLibur`, `tahunTersedia`) diverifikasi pada `2026-11-18` dari SKB 3 Menteri (Kemenag, Kemnaker, KemenPAN-RB). SKB dapat direvisi di tengah tahun (contoh: pada 2025, satu hari cuti bersama ditambahkan pada Agustus), sehingga data bisa kedaluwarsa dan library membutuhkan rilis baru tiap tahun untuk menambah data tahun berikutnya. Tahun tanpa data menghasilkan `"data-tidak-tersedia"`, bukan `"bukan-libur"`. Ini bukan nasihat hukum mengenai hak cuti atau upah lembur, dan hari libur lokal atau daerah tidak termasuk.
115
+ - Modul `waktu` menolak string ISO tanpa zona waktu eksplisit agar tidak bergantung pada zona waktu mesin lokal (`YYYY-MM-DD` hanya diterima pada `formatTanggal`). Konversi memakai offset tetap (`WIB` `+07:00`, `WITA` `+08:00`, `WIT` `+09:00`) tanpa DST. `zonaWaktuProvinsi` menggunakan 38 kode provinsi Kemendagri (`11`–`96`) agar konsisten dengan modul `nik`, bukan kode wilayah kerja statistik BPS yang berbeda di wilayah Papua.
116
+ - Modul `wilayah` berisi data 38 provinsi dan 514 kabupaten/kota berdasarkan kode wilayah Kemendagri (terakhir diverifikasi `2026-11-18`; penamaan provinsi `31` dan `34` diseragamkan menjadi `"DKI Jakarta"` dan `"DI Yogyakarta"` agar konsisten dengan modul `nik`). Kecamatan, kelurahan/desa, serta kode wilayah kerja statistik BPS tidak disertakan, dan data dapat berubah bila terjadi pemekaran wilayah baru.
98
117
 
99
118
  ## Berkontribusi
100
119