@ghifari29/id-kit 0.1.1 → 0.3.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
@@ -17,6 +17,8 @@ npm i @ghifari29/id-kit
17
17
  ```ts
18
18
  import { terbilang, rupiah } from "@ghifari29/id-kit/format";
19
19
  import { normalizePhone, isValidPhone } from "@ghifari29/id-kit/phone";
20
+ import { parseNIK, isValidNIK } from "@ghifari29/id-kit/nik";
21
+ import { mask, maskNIK, maskPhone, maskAccount } from "@ghifari29/id-kit/mask";
20
22
 
21
23
  terbilang(1250000);
22
24
  // "satu juta dua ratus lima puluh ribu rupiah"
@@ -29,14 +31,33 @@ normalizePhone("0812-3456-789");
29
31
 
30
32
  isValidPhone("021-555-1234");
31
33
  // false
34
+
35
+ isValidNIK("3171011505900001");
36
+ // true
37
+
38
+ parseNIK("3201025505900002");
39
+ // { valid: true, provinsiKode: "32", provinsi: "Jawa Barat", kabKotaKode: "01", kecamatanKode: "02", tanggalLahir: "1990-05-15", gender: "P", urutan: "0002" }
40
+
41
+ mask("rahasia", { visibleStart: 1, visibleEnd: 1 });
42
+ // "r*****a"
43
+
44
+ maskNIK("3171 0115 0590 0001");
45
+ // "3171********0001"
46
+
47
+ maskPhone("0812-3456-789");
48
+ // "+628******789"
49
+
50
+ maskAccount("123-456-7890");
51
+ // "******7890"
32
52
  ```
33
53
 
34
54
  ## Fitur
35
55
 
36
56
  - [x] `terbilang`, `rupiah`
37
57
  - [x] `normalizePhone`, `isValidPhone`
58
+ - [x] `parseNIK`, `isValidNIK` (validasi NIK)
59
+ - [x] `mask`, `maskNIK`, `maskPhone`, `maskAccount` (masking data pribadi)
38
60
  - [ ] Deteksi operator seluler
39
- - [ ] Validasi NIK
40
61
  - [ ] Validasi NPWP dan nomor rekening
41
62
  - [ ] Libur nasional dan cuti bersama
42
63
  - [ ] Data wilayah
@@ -45,6 +66,8 @@ isValidPhone("021-555-1234");
45
66
 
46
67
  - `terbilang` hanya mendukung bilangan bulat.
47
68
  - `normalizePhone` hanya mengecek pola umum nomor seluler, belum memastikan awalan operator.
69
+ - `parseNIK` dan `isValidNIK` hanya memvalidasi format struktur NIK (bukan bukti keaslian atau keterdaftaran di Dukcapil). Kode kabupaten/kota dan kecamatan tidak divalidasi, dan penentuan abad tahun 2 digit (`YY`) bersifat heuristik terhadap tahun berjalan (UTC).
70
+ - Modul `mask` (`mask`, `maskNIK`, `maskPhone`, `maskAccount`) hanya untuk **TAMPILAN** UI, bukan enkripsi atau anonimisasi. Jangan menyimpan data asli di log hanya karena sudah ada fungsi masking. Hanya `mask()` yang menjamin panjang hasil (dalam Unicode code point) sama dengan panjang input.
48
71
 
49
72
  ## Berkontribusi
50
73
 
@@ -0,0 +1,75 @@
1
+ import {
2
+ normalizePhone
3
+ } from "./chunk-GH7ECGI2.js";
4
+
5
+ // src/mask/mask.ts
6
+ function assertString(input) {
7
+ if (typeof input !== "string") {
8
+ throw new TypeError("Input harus berupa string");
9
+ }
10
+ }
11
+ function validateVisibleCount(value, name) {
12
+ if (!Number.isInteger(value) || value < 0) {
13
+ throw new RangeError(`${name} harus berupa bilangan bulat non-negatif`);
14
+ }
15
+ }
16
+ function validateMaskChar(maskChar) {
17
+ if (typeof maskChar !== "string") {
18
+ throw new TypeError("maskChar harus berupa string");
19
+ }
20
+ if (Array.from(maskChar).length !== 1) {
21
+ throw new RangeError("maskChar harus tepat satu karakter Unicode");
22
+ }
23
+ }
24
+ function fullMask(input, maskChar = "*") {
25
+ return maskChar.repeat(Array.from(input).length);
26
+ }
27
+ function mask(input, options = {}) {
28
+ assertString(input);
29
+ const { visibleStart = 0, visibleEnd = 0, maskChar = "*" } = options;
30
+ validateVisibleCount(visibleStart, "visibleStart");
31
+ validateVisibleCount(visibleEnd, "visibleEnd");
32
+ validateMaskChar(maskChar);
33
+ const chars = Array.from(input);
34
+ if (chars.length === 0) {
35
+ return "";
36
+ }
37
+ if (chars.length <= visibleStart + visibleEnd) {
38
+ return maskChar.repeat(chars.length);
39
+ }
40
+ const start = chars.slice(0, visibleStart).join("");
41
+ const end = visibleEnd > 0 ? chars.slice(-visibleEnd).join("") : "";
42
+ const middle = maskChar.repeat(chars.length - visibleStart - visibleEnd);
43
+ return start + middle + end;
44
+ }
45
+ function maskNIK(input) {
46
+ assertString(input);
47
+ const cleaned = input.replace(/\s+/g, "");
48
+ if (!/^\d{16}$/.test(cleaned)) {
49
+ return fullMask(input);
50
+ }
51
+ return mask(cleaned, { visibleStart: 4, visibleEnd: 4 });
52
+ }
53
+ function maskPhone(input) {
54
+ assertString(input);
55
+ const normalized = normalizePhone(input);
56
+ if (!normalized) {
57
+ return fullMask(input);
58
+ }
59
+ return mask(normalized, { visibleStart: 4, visibleEnd: 3 });
60
+ }
61
+ function maskAccount(input) {
62
+ assertString(input);
63
+ const cleaned = input.replace(/[\s-]+/g, "");
64
+ if (cleaned.length < 8 || !/^\d+$/.test(cleaned)) {
65
+ return fullMask(input);
66
+ }
67
+ return mask(cleaned, { visibleStart: 0, visibleEnd: 4 });
68
+ }
69
+
70
+ export {
71
+ mask,
72
+ maskNIK,
73
+ maskPhone,
74
+ maskAccount
75
+ };
@@ -0,0 +1,111 @@
1
+ // src/nik/nik.ts
2
+ var PROVINSI = {
3
+ "11": "Aceh",
4
+ "12": "Sumatera Utara",
5
+ "13": "Sumatera Barat",
6
+ "14": "Riau",
7
+ "15": "Jambi",
8
+ "16": "Sumatera Selatan",
9
+ "17": "Bengkulu",
10
+ "18": "Lampung",
11
+ "19": "Kepulauan Bangka Belitung",
12
+ "21": "Kepulauan Riau",
13
+ "31": "DKI Jakarta",
14
+ "32": "Jawa Barat",
15
+ "33": "Jawa Tengah",
16
+ "34": "DI Yogyakarta",
17
+ "35": "Jawa Timur",
18
+ "36": "Banten",
19
+ "51": "Bali",
20
+ "52": "Nusa Tenggara Barat",
21
+ "53": "Nusa Tenggara Timur",
22
+ "61": "Kalimantan Barat",
23
+ "62": "Kalimantan Tengah",
24
+ "63": "Kalimantan Selatan",
25
+ "64": "Kalimantan Timur",
26
+ "65": "Kalimantan Utara",
27
+ "71": "Sulawesi Utara",
28
+ "72": "Sulawesi Tengah",
29
+ "73": "Sulawesi Selatan",
30
+ "74": "Sulawesi Tenggara",
31
+ "75": "Gorontalo",
32
+ "76": "Sulawesi Barat",
33
+ "81": "Maluku",
34
+ "82": "Maluku Utara",
35
+ "91": "Papua",
36
+ "92": "Papua Barat",
37
+ "93": "Papua Selatan",
38
+ "94": "Papua Tengah",
39
+ "95": "Papua Pegunungan",
40
+ "96": "Papua Barat Daya"
41
+ };
42
+ function pad2(n) {
43
+ return String(n).padStart(2, "0");
44
+ }
45
+ function resolveBirthYear(yy) {
46
+ const currentTwoDigitYear = (/* @__PURE__ */ new Date()).getUTCFullYear() % 100;
47
+ return yy > currentTwoDigitYear ? 1900 + yy : 2e3 + yy;
48
+ }
49
+ function isValidUTCDate(year, month, day) {
50
+ const date = new Date(Date.UTC(year, month - 1, day));
51
+ return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
52
+ }
53
+ function parseNIK(input) {
54
+ const cleaned = input.replace(/\s+/g, "");
55
+ if (cleaned.length === 0) {
56
+ return { valid: false, alasan: "panjang" };
57
+ }
58
+ if (/\D/.test(cleaned)) {
59
+ return { valid: false, alasan: "bukan-angka" };
60
+ }
61
+ if (cleaned.length !== 16) {
62
+ return { valid: false, alasan: "panjang" };
63
+ }
64
+ const provinsiKode = cleaned.slice(0, 2);
65
+ const provinsi = Object.prototype.hasOwnProperty.call(PROVINSI, provinsiKode) ? PROVINSI[provinsiKode] : void 0;
66
+ if (!provinsi) {
67
+ return { valid: false, alasan: "provinsi" };
68
+ }
69
+ const kabKotaKode = cleaned.slice(2, 4);
70
+ const kecamatanKode = cleaned.slice(4, 6);
71
+ const rawDay = Number(cleaned.slice(6, 8));
72
+ const month = Number(cleaned.slice(8, 10));
73
+ const yy = Number(cleaned.slice(10, 12));
74
+ const urutan = cleaned.slice(12, 16);
75
+ let gender;
76
+ let day;
77
+ if (rawDay >= 1 && rawDay <= 31) {
78
+ gender = "L";
79
+ day = rawDay;
80
+ } else if (rawDay >= 41 && rawDay <= 71) {
81
+ gender = "P";
82
+ day = rawDay - 40;
83
+ } else {
84
+ return { valid: false, alasan: "tanggal" };
85
+ }
86
+ if (month < 1 || month > 12) {
87
+ return { valid: false, alasan: "tanggal" };
88
+ }
89
+ const year = resolveBirthYear(yy);
90
+ if (!isValidUTCDate(year, month, day)) {
91
+ return { valid: false, alasan: "tanggal" };
92
+ }
93
+ return {
94
+ valid: true,
95
+ provinsiKode,
96
+ provinsi,
97
+ kabKotaKode,
98
+ kecamatanKode,
99
+ tanggalLahir: `${year}-${pad2(month)}-${pad2(day)}`,
100
+ gender,
101
+ urutan
102
+ };
103
+ }
104
+ function isValidNIK(input) {
105
+ return parseNIK(input).valid;
106
+ }
107
+
108
+ export {
109
+ parseNIK,
110
+ isValidNIK
111
+ };
package/dist/index.cjs CHANGED
@@ -20,8 +20,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
20
20
  // src/index.ts
21
21
  var src_exports = {};
22
22
  __export(src_exports, {
23
+ isValidNIK: () => isValidNIK,
23
24
  isValidPhone: () => isValidPhone,
25
+ mask: () => mask,
26
+ maskAccount: () => maskAccount,
27
+ maskNIK: () => maskNIK,
28
+ maskPhone: () => maskPhone,
24
29
  normalizePhone: () => normalizePhone,
30
+ parseNIK: () => parseNIK,
25
31
  rupiah: () => rupiah,
26
32
  terbilang: () => terbilang
27
33
  });
@@ -86,10 +92,188 @@ function normalizePhone(input) {
86
92
  function isValidPhone(input) {
87
93
  return normalizePhone(input) !== null;
88
94
  }
95
+
96
+ // src/nik/nik.ts
97
+ var PROVINSI = {
98
+ "11": "Aceh",
99
+ "12": "Sumatera Utara",
100
+ "13": "Sumatera Barat",
101
+ "14": "Riau",
102
+ "15": "Jambi",
103
+ "16": "Sumatera Selatan",
104
+ "17": "Bengkulu",
105
+ "18": "Lampung",
106
+ "19": "Kepulauan Bangka Belitung",
107
+ "21": "Kepulauan Riau",
108
+ "31": "DKI Jakarta",
109
+ "32": "Jawa Barat",
110
+ "33": "Jawa Tengah",
111
+ "34": "DI Yogyakarta",
112
+ "35": "Jawa Timur",
113
+ "36": "Banten",
114
+ "51": "Bali",
115
+ "52": "Nusa Tenggara Barat",
116
+ "53": "Nusa Tenggara Timur",
117
+ "61": "Kalimantan Barat",
118
+ "62": "Kalimantan Tengah",
119
+ "63": "Kalimantan Selatan",
120
+ "64": "Kalimantan Timur",
121
+ "65": "Kalimantan Utara",
122
+ "71": "Sulawesi Utara",
123
+ "72": "Sulawesi Tengah",
124
+ "73": "Sulawesi Selatan",
125
+ "74": "Sulawesi Tenggara",
126
+ "75": "Gorontalo",
127
+ "76": "Sulawesi Barat",
128
+ "81": "Maluku",
129
+ "82": "Maluku Utara",
130
+ "91": "Papua",
131
+ "92": "Papua Barat",
132
+ "93": "Papua Selatan",
133
+ "94": "Papua Tengah",
134
+ "95": "Papua Pegunungan",
135
+ "96": "Papua Barat Daya"
136
+ };
137
+ function pad2(n) {
138
+ return String(n).padStart(2, "0");
139
+ }
140
+ function resolveBirthYear(yy) {
141
+ const currentTwoDigitYear = (/* @__PURE__ */ new Date()).getUTCFullYear() % 100;
142
+ return yy > currentTwoDigitYear ? 1900 + yy : 2e3 + yy;
143
+ }
144
+ function isValidUTCDate(year, month, day) {
145
+ const date = new Date(Date.UTC(year, month - 1, day));
146
+ return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
147
+ }
148
+ function parseNIK(input) {
149
+ const cleaned = input.replace(/\s+/g, "");
150
+ if (cleaned.length === 0) {
151
+ return { valid: false, alasan: "panjang" };
152
+ }
153
+ if (/\D/.test(cleaned)) {
154
+ return { valid: false, alasan: "bukan-angka" };
155
+ }
156
+ if (cleaned.length !== 16) {
157
+ return { valid: false, alasan: "panjang" };
158
+ }
159
+ const provinsiKode = cleaned.slice(0, 2);
160
+ const provinsi = Object.prototype.hasOwnProperty.call(PROVINSI, provinsiKode) ? PROVINSI[provinsiKode] : void 0;
161
+ if (!provinsi) {
162
+ return { valid: false, alasan: "provinsi" };
163
+ }
164
+ const kabKotaKode = cleaned.slice(2, 4);
165
+ const kecamatanKode = cleaned.slice(4, 6);
166
+ const rawDay = Number(cleaned.slice(6, 8));
167
+ const month = Number(cleaned.slice(8, 10));
168
+ const yy = Number(cleaned.slice(10, 12));
169
+ const urutan = cleaned.slice(12, 16);
170
+ let gender;
171
+ let day;
172
+ if (rawDay >= 1 && rawDay <= 31) {
173
+ gender = "L";
174
+ day = rawDay;
175
+ } else if (rawDay >= 41 && rawDay <= 71) {
176
+ gender = "P";
177
+ day = rawDay - 40;
178
+ } else {
179
+ return { valid: false, alasan: "tanggal" };
180
+ }
181
+ if (month < 1 || month > 12) {
182
+ return { valid: false, alasan: "tanggal" };
183
+ }
184
+ const year = resolveBirthYear(yy);
185
+ if (!isValidUTCDate(year, month, day)) {
186
+ return { valid: false, alasan: "tanggal" };
187
+ }
188
+ return {
189
+ valid: true,
190
+ provinsiKode,
191
+ provinsi,
192
+ kabKotaKode,
193
+ kecamatanKode,
194
+ tanggalLahir: `${year}-${pad2(month)}-${pad2(day)}`,
195
+ gender,
196
+ urutan
197
+ };
198
+ }
199
+ function isValidNIK(input) {
200
+ return parseNIK(input).valid;
201
+ }
202
+
203
+ // src/mask/mask.ts
204
+ function assertString(input) {
205
+ if (typeof input !== "string") {
206
+ throw new TypeError("Input harus berupa string");
207
+ }
208
+ }
209
+ function validateVisibleCount(value, name) {
210
+ if (!Number.isInteger(value) || value < 0) {
211
+ throw new RangeError(`${name} harus berupa bilangan bulat non-negatif`);
212
+ }
213
+ }
214
+ function validateMaskChar(maskChar) {
215
+ if (typeof maskChar !== "string") {
216
+ throw new TypeError("maskChar harus berupa string");
217
+ }
218
+ if (Array.from(maskChar).length !== 1) {
219
+ throw new RangeError("maskChar harus tepat satu karakter Unicode");
220
+ }
221
+ }
222
+ function fullMask(input, maskChar = "*") {
223
+ return maskChar.repeat(Array.from(input).length);
224
+ }
225
+ function mask(input, options = {}) {
226
+ assertString(input);
227
+ const { visibleStart = 0, visibleEnd = 0, maskChar = "*" } = options;
228
+ validateVisibleCount(visibleStart, "visibleStart");
229
+ validateVisibleCount(visibleEnd, "visibleEnd");
230
+ validateMaskChar(maskChar);
231
+ const chars = Array.from(input);
232
+ if (chars.length === 0) {
233
+ return "";
234
+ }
235
+ if (chars.length <= visibleStart + visibleEnd) {
236
+ return maskChar.repeat(chars.length);
237
+ }
238
+ const start = chars.slice(0, visibleStart).join("");
239
+ const end = visibleEnd > 0 ? chars.slice(-visibleEnd).join("") : "";
240
+ const middle = maskChar.repeat(chars.length - visibleStart - visibleEnd);
241
+ return start + middle + end;
242
+ }
243
+ function maskNIK(input) {
244
+ assertString(input);
245
+ const cleaned = input.replace(/\s+/g, "");
246
+ if (!/^\d{16}$/.test(cleaned)) {
247
+ return fullMask(input);
248
+ }
249
+ return mask(cleaned, { visibleStart: 4, visibleEnd: 4 });
250
+ }
251
+ function maskPhone(input) {
252
+ assertString(input);
253
+ const normalized = normalizePhone(input);
254
+ if (!normalized) {
255
+ return fullMask(input);
256
+ }
257
+ return mask(normalized, { visibleStart: 4, visibleEnd: 3 });
258
+ }
259
+ function maskAccount(input) {
260
+ assertString(input);
261
+ const cleaned = input.replace(/[\s-]+/g, "");
262
+ if (cleaned.length < 8 || !/^\d+$/.test(cleaned)) {
263
+ return fullMask(input);
264
+ }
265
+ return mask(cleaned, { visibleStart: 0, visibleEnd: 4 });
266
+ }
89
267
  // Annotate the CommonJS export names for ESM import in node:
90
268
  0 && (module.exports = {
269
+ isValidNIK,
91
270
  isValidPhone,
271
+ mask,
272
+ maskAccount,
273
+ maskNIK,
274
+ maskPhone,
92
275
  normalizePhone,
276
+ parseNIK,
93
277
  rupiah,
94
278
  terbilang
95
279
  });
package/dist/index.d.cts CHANGED
@@ -1,2 +1,4 @@
1
1
  export { rupiah, terbilang } from './format.cjs';
2
2
  export { isValidPhone, normalizePhone } from './phone.cjs';
3
+ export { NIKGender, NIKInvalidReason, ParseNIKResult, isValidNIK, parseNIK } from './nik.cjs';
4
+ export { MaskOptions, mask, maskAccount, maskNIK, maskPhone } from './mask.cjs';
package/dist/index.d.ts CHANGED
@@ -1,2 +1,4 @@
1
1
  export { rupiah, terbilang } from './format.js';
2
2
  export { isValidPhone, normalizePhone } from './phone.js';
3
+ export { NIKGender, NIKInvalidReason, ParseNIKResult, isValidNIK, parseNIK } from './nik.js';
4
+ export { MaskOptions, mask, maskAccount, maskNIK, maskPhone } from './mask.js';
package/dist/index.js CHANGED
@@ -2,13 +2,29 @@ import {
2
2
  rupiah,
3
3
  terbilang
4
4
  } from "./chunk-3347TRCX.js";
5
+ import {
6
+ isValidNIK,
7
+ parseNIK
8
+ } from "./chunk-ZIB7HJMG.js";
9
+ import {
10
+ mask,
11
+ maskAccount,
12
+ maskNIK,
13
+ maskPhone
14
+ } from "./chunk-RR7TOTVK.js";
5
15
  import {
6
16
  isValidPhone,
7
17
  normalizePhone
8
18
  } from "./chunk-GH7ECGI2.js";
9
19
  export {
20
+ isValidNIK,
10
21
  isValidPhone,
22
+ mask,
23
+ maskAccount,
24
+ maskNIK,
25
+ maskPhone,
11
26
  normalizePhone,
27
+ parseNIK,
12
28
  rupiah,
13
29
  terbilang
14
30
  };
package/dist/mask.cjs ADDED
@@ -0,0 +1,111 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/mask/index.ts
21
+ var mask_exports = {};
22
+ __export(mask_exports, {
23
+ mask: () => mask,
24
+ maskAccount: () => maskAccount,
25
+ maskNIK: () => maskNIK,
26
+ maskPhone: () => maskPhone
27
+ });
28
+ module.exports = __toCommonJS(mask_exports);
29
+
30
+ // src/phone/index.ts
31
+ function normalizePhone(input) {
32
+ let d = input.replace(/[^\d+]/g, "");
33
+ if (d.startsWith("+62")) d = d.slice(3);
34
+ else if (d.startsWith("62")) d = d.slice(2);
35
+ else if (d.startsWith("0")) d = d.slice(1);
36
+ else return null;
37
+ if (!/^8\d{8,11}$/.test(d)) return null;
38
+ return "+62" + d;
39
+ }
40
+
41
+ // src/mask/mask.ts
42
+ function assertString(input) {
43
+ if (typeof input !== "string") {
44
+ throw new TypeError("Input harus berupa string");
45
+ }
46
+ }
47
+ function validateVisibleCount(value, name) {
48
+ if (!Number.isInteger(value) || value < 0) {
49
+ throw new RangeError(`${name} harus berupa bilangan bulat non-negatif`);
50
+ }
51
+ }
52
+ function validateMaskChar(maskChar) {
53
+ if (typeof maskChar !== "string") {
54
+ throw new TypeError("maskChar harus berupa string");
55
+ }
56
+ if (Array.from(maskChar).length !== 1) {
57
+ throw new RangeError("maskChar harus tepat satu karakter Unicode");
58
+ }
59
+ }
60
+ function fullMask(input, maskChar = "*") {
61
+ return maskChar.repeat(Array.from(input).length);
62
+ }
63
+ function mask(input, options = {}) {
64
+ assertString(input);
65
+ const { visibleStart = 0, visibleEnd = 0, maskChar = "*" } = options;
66
+ validateVisibleCount(visibleStart, "visibleStart");
67
+ validateVisibleCount(visibleEnd, "visibleEnd");
68
+ validateMaskChar(maskChar);
69
+ const chars = Array.from(input);
70
+ if (chars.length === 0) {
71
+ return "";
72
+ }
73
+ if (chars.length <= visibleStart + visibleEnd) {
74
+ return maskChar.repeat(chars.length);
75
+ }
76
+ const start = chars.slice(0, visibleStart).join("");
77
+ const end = visibleEnd > 0 ? chars.slice(-visibleEnd).join("") : "";
78
+ const middle = maskChar.repeat(chars.length - visibleStart - visibleEnd);
79
+ return start + middle + end;
80
+ }
81
+ function maskNIK(input) {
82
+ assertString(input);
83
+ const cleaned = input.replace(/\s+/g, "");
84
+ if (!/^\d{16}$/.test(cleaned)) {
85
+ return fullMask(input);
86
+ }
87
+ return mask(cleaned, { visibleStart: 4, visibleEnd: 4 });
88
+ }
89
+ function maskPhone(input) {
90
+ assertString(input);
91
+ const normalized = normalizePhone(input);
92
+ if (!normalized) {
93
+ return fullMask(input);
94
+ }
95
+ return mask(normalized, { visibleStart: 4, visibleEnd: 3 });
96
+ }
97
+ function maskAccount(input) {
98
+ assertString(input);
99
+ const cleaned = input.replace(/[\s-]+/g, "");
100
+ if (cleaned.length < 8 || !/^\d+$/.test(cleaned)) {
101
+ return fullMask(input);
102
+ }
103
+ return mask(cleaned, { visibleStart: 0, visibleEnd: 4 });
104
+ }
105
+ // Annotate the CommonJS export names for ESM import in node:
106
+ 0 && (module.exports = {
107
+ mask,
108
+ maskAccount,
109
+ maskNIK,
110
+ maskPhone
111
+ });
@@ -0,0 +1,45 @@
1
+ interface MaskOptions {
2
+ /** Jumlah karakter awal yang tetap ditampilkan. Default: `0`. */
3
+ visibleStart?: number;
4
+ /** Jumlah karakter akhir yang tetap ditampilkan. Default: `0`. */
5
+ visibleEnd?: number;
6
+ /** Karakter pengganti untuk bagian yang disensor (harus tepat 1 Unicode code point). Default: `"*"`. */
7
+ maskChar?: string;
8
+ }
9
+ /**
10
+ * Menyensor string untuk kebutuhan tampilan UI.
11
+ *
12
+ * Catatan keamanan & perilaku:
13
+ * - Hanya untuk tampilan, bukan enkripsi atau anonimisasi.
14
+ * - Jika panjang input (dalam Unicode code point) `<= visibleStart + visibleEnd`, seluruh input disensor.
15
+ * - Hanya `mask()` yang menjamin panjang hasil (dalam code point) sama dengan panjang input.
16
+ * - Panjang dihitung per code point via `Array.from`; grapheme cluster gabungan (seperti bendera atau emoji ZWJ)
17
+ * dihitung per code point penyusunnya.
18
+ */
19
+ declare function mask(input: string, options?: MaskOptions): string;
20
+ /**
21
+ * Menyensor NIK 16 digit untuk tampilan UI dengan menampilkan 4 digit awal dan 4 digit akhir.
22
+ *
23
+ * Whitespace (`\s`) dibuang sebelum pemeriksaan. Jika hasilnya bukan tepat 16 digit angka,
24
+ * seluruh input disensor penuh sepanjang input asli (`Array.from(input).length`) tanpa validasi Dukcapil.
25
+ * Hanya untuk tampilan UI, bukan enkripsi atau anonimisasi.
26
+ */
27
+ declare function maskNIK(input: string): string;
28
+ /**
29
+ * Menyensor nomor seluler Indonesia untuk tampilan UI dalam format `+628...` dengan 3 digit akhir terlihat.
30
+ *
31
+ * Memakai `normalizePhone` dari modul `phone`. Jika nomor tidak valid, seluruh input disensor penuh
32
+ * sepanjang input asli (`Array.from(input).length`) tanpa melempar error.
33
+ * Hanya untuk tampilan UI, bukan enkripsi atau anonimisasi.
34
+ */
35
+ declare function maskPhone(input: string): string;
36
+ /**
37
+ * Menyensor nomor rekening untuk tampilan UI dengan hanya menampilkan 4 digit terakhir.
38
+ *
39
+ * Spasi dan tanda hubung (`-`) dibuang terlebih dahulu. Jika mengandung karakter non-angka atau
40
+ * panjang setelah dibersihkan kurang dari 8 digit, seluruh input disensor penuh sepanjang input asli.
41
+ * Hanya untuk tampilan UI, bukan enkripsi atau anonimisasi.
42
+ */
43
+ declare function maskAccount(input: string): string;
44
+
45
+ export { type MaskOptions, mask, maskAccount, maskNIK, maskPhone };
package/dist/mask.d.ts ADDED
@@ -0,0 +1,45 @@
1
+ interface MaskOptions {
2
+ /** Jumlah karakter awal yang tetap ditampilkan. Default: `0`. */
3
+ visibleStart?: number;
4
+ /** Jumlah karakter akhir yang tetap ditampilkan. Default: `0`. */
5
+ visibleEnd?: number;
6
+ /** Karakter pengganti untuk bagian yang disensor (harus tepat 1 Unicode code point). Default: `"*"`. */
7
+ maskChar?: string;
8
+ }
9
+ /**
10
+ * Menyensor string untuk kebutuhan tampilan UI.
11
+ *
12
+ * Catatan keamanan & perilaku:
13
+ * - Hanya untuk tampilan, bukan enkripsi atau anonimisasi.
14
+ * - Jika panjang input (dalam Unicode code point) `<= visibleStart + visibleEnd`, seluruh input disensor.
15
+ * - Hanya `mask()` yang menjamin panjang hasil (dalam code point) sama dengan panjang input.
16
+ * - Panjang dihitung per code point via `Array.from`; grapheme cluster gabungan (seperti bendera atau emoji ZWJ)
17
+ * dihitung per code point penyusunnya.
18
+ */
19
+ declare function mask(input: string, options?: MaskOptions): string;
20
+ /**
21
+ * Menyensor NIK 16 digit untuk tampilan UI dengan menampilkan 4 digit awal dan 4 digit akhir.
22
+ *
23
+ * Whitespace (`\s`) dibuang sebelum pemeriksaan. Jika hasilnya bukan tepat 16 digit angka,
24
+ * seluruh input disensor penuh sepanjang input asli (`Array.from(input).length`) tanpa validasi Dukcapil.
25
+ * Hanya untuk tampilan UI, bukan enkripsi atau anonimisasi.
26
+ */
27
+ declare function maskNIK(input: string): string;
28
+ /**
29
+ * Menyensor nomor seluler Indonesia untuk tampilan UI dalam format `+628...` dengan 3 digit akhir terlihat.
30
+ *
31
+ * Memakai `normalizePhone` dari modul `phone`. Jika nomor tidak valid, seluruh input disensor penuh
32
+ * sepanjang input asli (`Array.from(input).length`) tanpa melempar error.
33
+ * Hanya untuk tampilan UI, bukan enkripsi atau anonimisasi.
34
+ */
35
+ declare function maskPhone(input: string): string;
36
+ /**
37
+ * Menyensor nomor rekening untuk tampilan UI dengan hanya menampilkan 4 digit terakhir.
38
+ *
39
+ * Spasi dan tanda hubung (`-`) dibuang terlebih dahulu. Jika mengandung karakter non-angka atau
40
+ * panjang setelah dibersihkan kurang dari 8 digit, seluruh input disensor penuh sepanjang input asli.
41
+ * Hanya untuk tampilan UI, bukan enkripsi atau anonimisasi.
42
+ */
43
+ declare function maskAccount(input: string): string;
44
+
45
+ export { type MaskOptions, mask, maskAccount, maskNIK, maskPhone };
package/dist/mask.js ADDED
@@ -0,0 +1,13 @@
1
+ import {
2
+ mask,
3
+ maskAccount,
4
+ maskNIK,
5
+ maskPhone
6
+ } from "./chunk-RR7TOTVK.js";
7
+ import "./chunk-GH7ECGI2.js";
8
+ export {
9
+ mask,
10
+ maskAccount,
11
+ maskNIK,
12
+ maskPhone
13
+ };
package/dist/nik.cjs ADDED
@@ -0,0 +1,138 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/nik/index.ts
21
+ var nik_exports = {};
22
+ __export(nik_exports, {
23
+ isValidNIK: () => isValidNIK,
24
+ parseNIK: () => parseNIK
25
+ });
26
+ module.exports = __toCommonJS(nik_exports);
27
+
28
+ // src/nik/nik.ts
29
+ var PROVINSI = {
30
+ "11": "Aceh",
31
+ "12": "Sumatera Utara",
32
+ "13": "Sumatera Barat",
33
+ "14": "Riau",
34
+ "15": "Jambi",
35
+ "16": "Sumatera Selatan",
36
+ "17": "Bengkulu",
37
+ "18": "Lampung",
38
+ "19": "Kepulauan Bangka Belitung",
39
+ "21": "Kepulauan Riau",
40
+ "31": "DKI Jakarta",
41
+ "32": "Jawa Barat",
42
+ "33": "Jawa Tengah",
43
+ "34": "DI Yogyakarta",
44
+ "35": "Jawa Timur",
45
+ "36": "Banten",
46
+ "51": "Bali",
47
+ "52": "Nusa Tenggara Barat",
48
+ "53": "Nusa Tenggara Timur",
49
+ "61": "Kalimantan Barat",
50
+ "62": "Kalimantan Tengah",
51
+ "63": "Kalimantan Selatan",
52
+ "64": "Kalimantan Timur",
53
+ "65": "Kalimantan Utara",
54
+ "71": "Sulawesi Utara",
55
+ "72": "Sulawesi Tengah",
56
+ "73": "Sulawesi Selatan",
57
+ "74": "Sulawesi Tenggara",
58
+ "75": "Gorontalo",
59
+ "76": "Sulawesi Barat",
60
+ "81": "Maluku",
61
+ "82": "Maluku Utara",
62
+ "91": "Papua",
63
+ "92": "Papua Barat",
64
+ "93": "Papua Selatan",
65
+ "94": "Papua Tengah",
66
+ "95": "Papua Pegunungan",
67
+ "96": "Papua Barat Daya"
68
+ };
69
+ function pad2(n) {
70
+ return String(n).padStart(2, "0");
71
+ }
72
+ function resolveBirthYear(yy) {
73
+ const currentTwoDigitYear = (/* @__PURE__ */ new Date()).getUTCFullYear() % 100;
74
+ return yy > currentTwoDigitYear ? 1900 + yy : 2e3 + yy;
75
+ }
76
+ function isValidUTCDate(year, month, day) {
77
+ const date = new Date(Date.UTC(year, month - 1, day));
78
+ return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
79
+ }
80
+ function parseNIK(input) {
81
+ const cleaned = input.replace(/\s+/g, "");
82
+ if (cleaned.length === 0) {
83
+ return { valid: false, alasan: "panjang" };
84
+ }
85
+ if (/\D/.test(cleaned)) {
86
+ return { valid: false, alasan: "bukan-angka" };
87
+ }
88
+ if (cleaned.length !== 16) {
89
+ return { valid: false, alasan: "panjang" };
90
+ }
91
+ const provinsiKode = cleaned.slice(0, 2);
92
+ const provinsi = Object.prototype.hasOwnProperty.call(PROVINSI, provinsiKode) ? PROVINSI[provinsiKode] : void 0;
93
+ if (!provinsi) {
94
+ return { valid: false, alasan: "provinsi" };
95
+ }
96
+ const kabKotaKode = cleaned.slice(2, 4);
97
+ const kecamatanKode = cleaned.slice(4, 6);
98
+ const rawDay = Number(cleaned.slice(6, 8));
99
+ const month = Number(cleaned.slice(8, 10));
100
+ const yy = Number(cleaned.slice(10, 12));
101
+ const urutan = cleaned.slice(12, 16);
102
+ let gender;
103
+ let day;
104
+ if (rawDay >= 1 && rawDay <= 31) {
105
+ gender = "L";
106
+ day = rawDay;
107
+ } else if (rawDay >= 41 && rawDay <= 71) {
108
+ gender = "P";
109
+ day = rawDay - 40;
110
+ } else {
111
+ return { valid: false, alasan: "tanggal" };
112
+ }
113
+ if (month < 1 || month > 12) {
114
+ return { valid: false, alasan: "tanggal" };
115
+ }
116
+ const year = resolveBirthYear(yy);
117
+ if (!isValidUTCDate(year, month, day)) {
118
+ return { valid: false, alasan: "tanggal" };
119
+ }
120
+ return {
121
+ valid: true,
122
+ provinsiKode,
123
+ provinsi,
124
+ kabKotaKode,
125
+ kecamatanKode,
126
+ tanggalLahir: `${year}-${pad2(month)}-${pad2(day)}`,
127
+ gender,
128
+ urutan
129
+ };
130
+ }
131
+ function isValidNIK(input) {
132
+ return parseNIK(input).valid;
133
+ }
134
+ // Annotate the CommonJS export names for ESM import in node:
135
+ 0 && (module.exports = {
136
+ isValidNIK,
137
+ parseNIK
138
+ });
package/dist/nik.d.cts ADDED
@@ -0,0 +1,40 @@
1
+ type NIKGender = "L" | "P";
2
+ type NIKInvalidReason = "panjang" | "bukan-angka" | "provinsi" | "tanggal";
3
+ type ParseNIKResult = {
4
+ valid: true;
5
+ provinsiKode: string;
6
+ provinsi: string;
7
+ kabKotaKode: string;
8
+ kecamatanKode: string;
9
+ tanggalLahir: string;
10
+ gender: NIKGender;
11
+ urutan: string;
12
+ } | {
13
+ valid: false;
14
+ alasan: NIKInvalidReason;
15
+ };
16
+ /**
17
+ * Mem-parse dan memvalidasi format Nomor Induk Kependudukan (NIK) Indonesia 16 digit.
18
+ *
19
+ * Urutan validasi setelah membuang seluruh whitespace (`\s`):
20
+ * 1. String kosong -> `alasan: "panjang"`
21
+ * 2. Mengandung karakter selain angka -> `alasan: "bukan-angka"`
22
+ * 3. Panjang bukan 16 digit -> `alasan: "panjang"`
23
+ * 4. Kode provinsi tidak dikenal (bukan 38 provinsi resmi Kemendagri) -> `alasan: "provinsi"`
24
+ * 5. Tanggal lahir tidak valid secara kalender UTC (DD 01–31 untuk L, DD 41–71 untuk P) -> `alasan: "tanggal"`
25
+ *
26
+ * Catatan penting dan batasan:
27
+ * - Fungsi ini HANYA memvalidasi format struktur NIK, tidak membuktikan NIK asli atau terdaftar di Dukcapil.
28
+ * - Kode kabupaten/kota dan kecamatan tidak divalidasi dan dikembalikan apa adanya.
29
+ * - Penentuan abad pada tahun 2 digit (`YY`) bersifat heuristik: jika `YY` lebih besar dari
30
+ * dua digit tahun berjalan (UTC), dianggap abad 1900-an; selain itu dianggap 2000-an.
31
+ */
32
+ declare function parseNIK(input: string): ParseNIKResult;
33
+ /**
34
+ * Memeriksa apakah string memenuhi format NIK 16 digit yang valid.
35
+ *
36
+ * Hanya memvalidasi format struktur (bukan keaslian atau keterdaftaran di Dukcapil).
37
+ */
38
+ declare function isValidNIK(input: string): boolean;
39
+
40
+ export { type NIKGender, type NIKInvalidReason, type ParseNIKResult, isValidNIK, parseNIK };
package/dist/nik.d.ts ADDED
@@ -0,0 +1,40 @@
1
+ type NIKGender = "L" | "P";
2
+ type NIKInvalidReason = "panjang" | "bukan-angka" | "provinsi" | "tanggal";
3
+ type ParseNIKResult = {
4
+ valid: true;
5
+ provinsiKode: string;
6
+ provinsi: string;
7
+ kabKotaKode: string;
8
+ kecamatanKode: string;
9
+ tanggalLahir: string;
10
+ gender: NIKGender;
11
+ urutan: string;
12
+ } | {
13
+ valid: false;
14
+ alasan: NIKInvalidReason;
15
+ };
16
+ /**
17
+ * Mem-parse dan memvalidasi format Nomor Induk Kependudukan (NIK) Indonesia 16 digit.
18
+ *
19
+ * Urutan validasi setelah membuang seluruh whitespace (`\s`):
20
+ * 1. String kosong -> `alasan: "panjang"`
21
+ * 2. Mengandung karakter selain angka -> `alasan: "bukan-angka"`
22
+ * 3. Panjang bukan 16 digit -> `alasan: "panjang"`
23
+ * 4. Kode provinsi tidak dikenal (bukan 38 provinsi resmi Kemendagri) -> `alasan: "provinsi"`
24
+ * 5. Tanggal lahir tidak valid secara kalender UTC (DD 01–31 untuk L, DD 41–71 untuk P) -> `alasan: "tanggal"`
25
+ *
26
+ * Catatan penting dan batasan:
27
+ * - Fungsi ini HANYA memvalidasi format struktur NIK, tidak membuktikan NIK asli atau terdaftar di Dukcapil.
28
+ * - Kode kabupaten/kota dan kecamatan tidak divalidasi dan dikembalikan apa adanya.
29
+ * - Penentuan abad pada tahun 2 digit (`YY`) bersifat heuristik: jika `YY` lebih besar dari
30
+ * dua digit tahun berjalan (UTC), dianggap abad 1900-an; selain itu dianggap 2000-an.
31
+ */
32
+ declare function parseNIK(input: string): ParseNIKResult;
33
+ /**
34
+ * Memeriksa apakah string memenuhi format NIK 16 digit yang valid.
35
+ *
36
+ * Hanya memvalidasi format struktur (bukan keaslian atau keterdaftaran di Dukcapil).
37
+ */
38
+ declare function isValidNIK(input: string): boolean;
39
+
40
+ export { type NIKGender, type NIKInvalidReason, type ParseNIKResult, isValidNIK, parseNIK };
package/dist/nik.js ADDED
@@ -0,0 +1,8 @@
1
+ import {
2
+ isValidNIK,
3
+ parseNIK
4
+ } from "./chunk-ZIB7HJMG.js";
5
+ export {
6
+ isValidNIK,
7
+ parseNIK
8
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ghifari29/id-kit",
3
- "version": "0.1.1",
3
+ "version": "0.3.0",
4
4
  "description": "Utilitas Indonesia: terbilang, rupiah, nomor telepon, dan lainnya",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -25,6 +25,16 @@
25
25
  "types": "./dist/phone.d.ts",
26
26
  "import": "./dist/phone.js",
27
27
  "require": "./dist/phone.cjs"
28
+ },
29
+ "./nik": {
30
+ "types": "./dist/nik.d.ts",
31
+ "import": "./dist/nik.js",
32
+ "require": "./dist/nik.cjs"
33
+ },
34
+ "./mask": {
35
+ "types": "./dist/mask.d.ts",
36
+ "import": "./dist/mask.js",
37
+ "require": "./dist/mask.cjs"
28
38
  }
29
39
  },
30
40
  "scripts": {