@ghifari29/id-kit 0.2.0 → 0.4.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 +21 -2
- package/dist/chunk-ER6I6HKP.js +88 -0
- package/dist/chunk-MFPJTZB7.js +75 -0
- package/dist/index.cjs +144 -0
- package/dist/index.d.cts +2 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.js +16 -4
- package/dist/mask.cjs +111 -0
- package/dist/mask.d.cts +45 -0
- package/dist/mask.d.ts +45 -0
- package/dist/mask.js +13 -0
- package/dist/phone.cjs +73 -0
- package/dist/phone.d.cts +27 -1
- package/dist/phone.d.ts +27 -1
- package/dist/phone.js +3 -1
- package/package.json +6 -1
- package/dist/chunk-GH7ECGI2.js +0 -18
package/README.md
CHANGED
|
@@ -16,8 +16,9 @@ npm i @ghifari29/id-kit
|
|
|
16
16
|
|
|
17
17
|
```ts
|
|
18
18
|
import { terbilang, rupiah } from "@ghifari29/id-kit/format";
|
|
19
|
-
import { normalizePhone, isValidPhone } from "@ghifari29/id-kit/phone";
|
|
19
|
+
import { normalizePhone, isValidPhone, detectOperator } from "@ghifari29/id-kit/phone";
|
|
20
20
|
import { parseNIK, isValidNIK } from "@ghifari29/id-kit/nik";
|
|
21
|
+
import { mask, maskNIK, maskPhone, maskAccount } from "@ghifari29/id-kit/mask";
|
|
21
22
|
|
|
22
23
|
terbilang(1250000);
|
|
23
24
|
// "satu juta dua ratus lima puluh ribu rupiah"
|
|
@@ -31,11 +32,26 @@ normalizePhone("0812-3456-789");
|
|
|
31
32
|
isValidPhone("021-555-1234");
|
|
32
33
|
// false
|
|
33
34
|
|
|
35
|
+
detectOperator("0812-3456-789");
|
|
36
|
+
// { valid: true, operator: "Telkomsel", grup: "Telkomsel", prefix: "0812" }
|
|
37
|
+
|
|
34
38
|
isValidNIK("3171011505900001");
|
|
35
39
|
// true
|
|
36
40
|
|
|
37
41
|
parseNIK("3201025505900002");
|
|
38
42
|
// { valid: true, provinsiKode: "32", provinsi: "Jawa Barat", kabKotaKode: "01", kecamatanKode: "02", tanggalLahir: "1990-05-15", gender: "P", urutan: "0002" }
|
|
43
|
+
|
|
44
|
+
mask("rahasia", { visibleStart: 1, visibleEnd: 1 });
|
|
45
|
+
// "r*****a"
|
|
46
|
+
|
|
47
|
+
maskNIK("3171 0115 0590 0001");
|
|
48
|
+
// "3171********0001"
|
|
49
|
+
|
|
50
|
+
maskPhone("0812-3456-789");
|
|
51
|
+
// "+628******789"
|
|
52
|
+
|
|
53
|
+
maskAccount("123-456-7890");
|
|
54
|
+
// "******7890"
|
|
39
55
|
```
|
|
40
56
|
|
|
41
57
|
## Fitur
|
|
@@ -43,7 +59,8 @@ parseNIK("3201025505900002");
|
|
|
43
59
|
- [x] `terbilang`, `rupiah`
|
|
44
60
|
- [x] `normalizePhone`, `isValidPhone`
|
|
45
61
|
- [x] `parseNIK`, `isValidNIK` (validasi NIK)
|
|
46
|
-
- [
|
|
62
|
+
- [x] `mask`, `maskNIK`, `maskPhone`, `maskAccount` (masking data pribadi)
|
|
63
|
+
- [x] `detectOperator` (deteksi operator seluler asal)
|
|
47
64
|
- [ ] Validasi NPWP dan nomor rekening
|
|
48
65
|
- [ ] Libur nasional dan cuti bersama
|
|
49
66
|
- [ ] Data wilayah
|
|
@@ -52,7 +69,9 @@ parseNIK("3201025505900002");
|
|
|
52
69
|
|
|
53
70
|
- `terbilang` hanya mendukung bilangan bulat.
|
|
54
71
|
- `normalizePhone` hanya mengecek pola umum nomor seluler, belum memastikan awalan operator.
|
|
72
|
+
- `detectOperator` hanya mengidentifikasi **operator asal berdasarkan alokasi awalan**, bukan operator aktif saat ini karena adanya *number portability*, dan `grup` dapat berubah karena merger/akuisisi. Data mengacu pada penomoran Komdigi dan informasi resmi operator (terakhir diverifikasi `2026-11-18`; belum ada satu tabel resmi tunggal yang lengkap). Awalan yang belum terverifikasi (`0834`–`0837`, `0879`, `0893`, `0894`) maupun yang telah dicabut (`0828`, `0868`) sengaja mengembalikan `"awalan-tidak-dikenal"`, sehingga nomor yang valid menurut `isValidPhone` tetap dapat mengembalikan `"awalan-tidak-dikenal"`.
|
|
55
73
|
- `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).
|
|
74
|
+
- 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.
|
|
56
75
|
|
|
57
76
|
## Berkontribusi
|
|
58
77
|
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
// src/phone/operator.ts
|
|
2
|
+
var OPERATOR_PREFIXES = [
|
|
3
|
+
{ prefix: "0811", operator: "Telkomsel", grup: "Telkomsel" },
|
|
4
|
+
{ prefix: "0812", operator: "Telkomsel", grup: "Telkomsel" },
|
|
5
|
+
{ prefix: "0813", operator: "Telkomsel", grup: "Telkomsel" },
|
|
6
|
+
{ prefix: "0821", operator: "Telkomsel", grup: "Telkomsel" },
|
|
7
|
+
{ prefix: "0822", operator: "Telkomsel", grup: "Telkomsel" },
|
|
8
|
+
{ prefix: "0823", operator: "Telkomsel", grup: "Telkomsel" },
|
|
9
|
+
{ prefix: "0851", operator: "Telkomsel", grup: "Telkomsel" },
|
|
10
|
+
{ prefix: "0852", operator: "Telkomsel", grup: "Telkomsel" },
|
|
11
|
+
{ prefix: "0853", operator: "Telkomsel", grup: "Telkomsel" },
|
|
12
|
+
{ prefix: "0814", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
13
|
+
{ prefix: "0815", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
14
|
+
{ prefix: "0816", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
15
|
+
{ prefix: "0855", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
16
|
+
{ prefix: "0856", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
17
|
+
{ prefix: "0857", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
18
|
+
{ prefix: "0858", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
19
|
+
{ prefix: "0895", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
20
|
+
{ prefix: "0896", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
21
|
+
{ prefix: "0897", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
22
|
+
{ prefix: "0898", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
23
|
+
{ prefix: "0899", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
24
|
+
{ prefix: "0817", operator: "XL", grup: "XLSmart" },
|
|
25
|
+
{ prefix: "0818", operator: "XL", grup: "XLSmart" },
|
|
26
|
+
{ prefix: "0819", operator: "XL", grup: "XLSmart" },
|
|
27
|
+
{ prefix: "0859", operator: "XL", grup: "XLSmart" },
|
|
28
|
+
{ prefix: "0877", operator: "XL", grup: "XLSmart" },
|
|
29
|
+
{ prefix: "0878", operator: "XL", grup: "XLSmart" },
|
|
30
|
+
{ prefix: "0831", operator: "AXIS", grup: "XLSmart" },
|
|
31
|
+
{ prefix: "0832", operator: "AXIS", grup: "XLSmart" },
|
|
32
|
+
{ prefix: "0833", operator: "AXIS", grup: "XLSmart" },
|
|
33
|
+
{ prefix: "0838", operator: "AXIS", grup: "XLSmart" },
|
|
34
|
+
{ prefix: "0881", operator: "Smartfren", grup: "XLSmart" },
|
|
35
|
+
{ prefix: "0882", operator: "Smartfren", grup: "XLSmart" },
|
|
36
|
+
{ prefix: "0883", operator: "Smartfren", grup: "XLSmart" },
|
|
37
|
+
{ prefix: "0884", operator: "Smartfren", grup: "XLSmart" },
|
|
38
|
+
{ prefix: "0885", operator: "Smartfren", grup: "XLSmart" },
|
|
39
|
+
{ prefix: "0886", operator: "Smartfren", grup: "XLSmart" },
|
|
40
|
+
{ prefix: "0887", operator: "Smartfren", grup: "XLSmart" },
|
|
41
|
+
{ prefix: "0888", operator: "Smartfren", grup: "XLSmart" },
|
|
42
|
+
{ prefix: "0889", operator: "Smartfren", grup: "XLSmart" }
|
|
43
|
+
];
|
|
44
|
+
var SORTED_PREFIXES = [...OPERATOR_PREFIXES].sort(
|
|
45
|
+
(a, b) => b.prefix.length - a.prefix.length || a.prefix.localeCompare(b.prefix)
|
|
46
|
+
);
|
|
47
|
+
function detectOperator(input) {
|
|
48
|
+
if (typeof input !== "string") {
|
|
49
|
+
throw new TypeError("Input harus berupa string");
|
|
50
|
+
}
|
|
51
|
+
const normalized = normalizePhone(input);
|
|
52
|
+
if (!normalized) {
|
|
53
|
+
return { valid: false, alasan: "format" };
|
|
54
|
+
}
|
|
55
|
+
const localNumber = "0" + normalized.slice(3);
|
|
56
|
+
const matched = SORTED_PREFIXES.find(
|
|
57
|
+
(entry) => localNumber.startsWith(entry.prefix)
|
|
58
|
+
);
|
|
59
|
+
if (!matched) {
|
|
60
|
+
return { valid: false, alasan: "awalan-tidak-dikenal" };
|
|
61
|
+
}
|
|
62
|
+
return {
|
|
63
|
+
valid: true,
|
|
64
|
+
operator: matched.operator,
|
|
65
|
+
grup: matched.grup,
|
|
66
|
+
prefix: matched.prefix
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// src/phone/index.ts
|
|
71
|
+
function normalizePhone(input) {
|
|
72
|
+
let d = input.replace(/[^\d+]/g, "");
|
|
73
|
+
if (d.startsWith("+62")) d = d.slice(3);
|
|
74
|
+
else if (d.startsWith("62")) d = d.slice(2);
|
|
75
|
+
else if (d.startsWith("0")) d = d.slice(1);
|
|
76
|
+
else return null;
|
|
77
|
+
if (!/^8\d{8,11}$/.test(d)) return null;
|
|
78
|
+
return "+62" + d;
|
|
79
|
+
}
|
|
80
|
+
function isValidPhone(input) {
|
|
81
|
+
return normalizePhone(input) !== null;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export {
|
|
85
|
+
detectOperator,
|
|
86
|
+
normalizePhone,
|
|
87
|
+
isValidPhone
|
|
88
|
+
};
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import {
|
|
2
|
+
normalizePhone
|
|
3
|
+
} from "./chunk-ER6I6HKP.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
|
+
};
|
package/dist/index.cjs
CHANGED
|
@@ -20,8 +20,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
20
20
|
// src/index.ts
|
|
21
21
|
var src_exports = {};
|
|
22
22
|
__export(src_exports, {
|
|
23
|
+
detectOperator: () => detectOperator,
|
|
23
24
|
isValidNIK: () => isValidNIK,
|
|
24
25
|
isValidPhone: () => isValidPhone,
|
|
26
|
+
mask: () => mask,
|
|
27
|
+
maskAccount: () => maskAccount,
|
|
28
|
+
maskNIK: () => maskNIK,
|
|
29
|
+
maskPhone: () => maskPhone,
|
|
25
30
|
normalizePhone: () => normalizePhone,
|
|
26
31
|
parseNIK: () => parseNIK,
|
|
27
32
|
rupiah: () => rupiah,
|
|
@@ -75,6 +80,75 @@ function rupiah(n) {
|
|
|
75
80
|
return "Rp" + new Intl.NumberFormat("id-ID").format(n);
|
|
76
81
|
}
|
|
77
82
|
|
|
83
|
+
// src/phone/operator.ts
|
|
84
|
+
var OPERATOR_PREFIXES = [
|
|
85
|
+
{ prefix: "0811", operator: "Telkomsel", grup: "Telkomsel" },
|
|
86
|
+
{ prefix: "0812", operator: "Telkomsel", grup: "Telkomsel" },
|
|
87
|
+
{ prefix: "0813", operator: "Telkomsel", grup: "Telkomsel" },
|
|
88
|
+
{ prefix: "0821", operator: "Telkomsel", grup: "Telkomsel" },
|
|
89
|
+
{ prefix: "0822", operator: "Telkomsel", grup: "Telkomsel" },
|
|
90
|
+
{ prefix: "0823", operator: "Telkomsel", grup: "Telkomsel" },
|
|
91
|
+
{ prefix: "0851", operator: "Telkomsel", grup: "Telkomsel" },
|
|
92
|
+
{ prefix: "0852", operator: "Telkomsel", grup: "Telkomsel" },
|
|
93
|
+
{ prefix: "0853", operator: "Telkomsel", grup: "Telkomsel" },
|
|
94
|
+
{ prefix: "0814", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
95
|
+
{ prefix: "0815", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
96
|
+
{ prefix: "0816", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
97
|
+
{ prefix: "0855", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
98
|
+
{ prefix: "0856", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
99
|
+
{ prefix: "0857", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
100
|
+
{ prefix: "0858", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
101
|
+
{ prefix: "0895", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
102
|
+
{ prefix: "0896", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
103
|
+
{ prefix: "0897", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
104
|
+
{ prefix: "0898", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
105
|
+
{ prefix: "0899", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
106
|
+
{ prefix: "0817", operator: "XL", grup: "XLSmart" },
|
|
107
|
+
{ prefix: "0818", operator: "XL", grup: "XLSmart" },
|
|
108
|
+
{ prefix: "0819", operator: "XL", grup: "XLSmart" },
|
|
109
|
+
{ prefix: "0859", operator: "XL", grup: "XLSmart" },
|
|
110
|
+
{ prefix: "0877", operator: "XL", grup: "XLSmart" },
|
|
111
|
+
{ prefix: "0878", operator: "XL", grup: "XLSmart" },
|
|
112
|
+
{ prefix: "0831", operator: "AXIS", grup: "XLSmart" },
|
|
113
|
+
{ prefix: "0832", operator: "AXIS", grup: "XLSmart" },
|
|
114
|
+
{ prefix: "0833", operator: "AXIS", grup: "XLSmart" },
|
|
115
|
+
{ prefix: "0838", operator: "AXIS", grup: "XLSmart" },
|
|
116
|
+
{ prefix: "0881", operator: "Smartfren", grup: "XLSmart" },
|
|
117
|
+
{ prefix: "0882", operator: "Smartfren", grup: "XLSmart" },
|
|
118
|
+
{ prefix: "0883", operator: "Smartfren", grup: "XLSmart" },
|
|
119
|
+
{ prefix: "0884", operator: "Smartfren", grup: "XLSmart" },
|
|
120
|
+
{ prefix: "0885", operator: "Smartfren", grup: "XLSmart" },
|
|
121
|
+
{ prefix: "0886", operator: "Smartfren", grup: "XLSmart" },
|
|
122
|
+
{ prefix: "0887", operator: "Smartfren", grup: "XLSmart" },
|
|
123
|
+
{ prefix: "0888", operator: "Smartfren", grup: "XLSmart" },
|
|
124
|
+
{ prefix: "0889", operator: "Smartfren", grup: "XLSmart" }
|
|
125
|
+
];
|
|
126
|
+
var SORTED_PREFIXES = [...OPERATOR_PREFIXES].sort(
|
|
127
|
+
(a, b) => b.prefix.length - a.prefix.length || a.prefix.localeCompare(b.prefix)
|
|
128
|
+
);
|
|
129
|
+
function detectOperator(input) {
|
|
130
|
+
if (typeof input !== "string") {
|
|
131
|
+
throw new TypeError("Input harus berupa string");
|
|
132
|
+
}
|
|
133
|
+
const normalized = normalizePhone(input);
|
|
134
|
+
if (!normalized) {
|
|
135
|
+
return { valid: false, alasan: "format" };
|
|
136
|
+
}
|
|
137
|
+
const localNumber = "0" + normalized.slice(3);
|
|
138
|
+
const matched = SORTED_PREFIXES.find(
|
|
139
|
+
(entry) => localNumber.startsWith(entry.prefix)
|
|
140
|
+
);
|
|
141
|
+
if (!matched) {
|
|
142
|
+
return { valid: false, alasan: "awalan-tidak-dikenal" };
|
|
143
|
+
}
|
|
144
|
+
return {
|
|
145
|
+
valid: true,
|
|
146
|
+
operator: matched.operator,
|
|
147
|
+
grup: matched.grup,
|
|
148
|
+
prefix: matched.prefix
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
|
|
78
152
|
// src/phone/index.ts
|
|
79
153
|
function normalizePhone(input) {
|
|
80
154
|
let d = input.replace(/[^\d+]/g, "");
|
|
@@ -195,10 +269,80 @@ function parseNIK(input) {
|
|
|
195
269
|
function isValidNIK(input) {
|
|
196
270
|
return parseNIK(input).valid;
|
|
197
271
|
}
|
|
272
|
+
|
|
273
|
+
// src/mask/mask.ts
|
|
274
|
+
function assertString(input) {
|
|
275
|
+
if (typeof input !== "string") {
|
|
276
|
+
throw new TypeError("Input harus berupa string");
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
function validateVisibleCount(value, name) {
|
|
280
|
+
if (!Number.isInteger(value) || value < 0) {
|
|
281
|
+
throw new RangeError(`${name} harus berupa bilangan bulat non-negatif`);
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
function validateMaskChar(maskChar) {
|
|
285
|
+
if (typeof maskChar !== "string") {
|
|
286
|
+
throw new TypeError("maskChar harus berupa string");
|
|
287
|
+
}
|
|
288
|
+
if (Array.from(maskChar).length !== 1) {
|
|
289
|
+
throw new RangeError("maskChar harus tepat satu karakter Unicode");
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
function fullMask(input, maskChar = "*") {
|
|
293
|
+
return maskChar.repeat(Array.from(input).length);
|
|
294
|
+
}
|
|
295
|
+
function mask(input, options = {}) {
|
|
296
|
+
assertString(input);
|
|
297
|
+
const { visibleStart = 0, visibleEnd = 0, maskChar = "*" } = options;
|
|
298
|
+
validateVisibleCount(visibleStart, "visibleStart");
|
|
299
|
+
validateVisibleCount(visibleEnd, "visibleEnd");
|
|
300
|
+
validateMaskChar(maskChar);
|
|
301
|
+
const chars = Array.from(input);
|
|
302
|
+
if (chars.length === 0) {
|
|
303
|
+
return "";
|
|
304
|
+
}
|
|
305
|
+
if (chars.length <= visibleStart + visibleEnd) {
|
|
306
|
+
return maskChar.repeat(chars.length);
|
|
307
|
+
}
|
|
308
|
+
const start = chars.slice(0, visibleStart).join("");
|
|
309
|
+
const end = visibleEnd > 0 ? chars.slice(-visibleEnd).join("") : "";
|
|
310
|
+
const middle = maskChar.repeat(chars.length - visibleStart - visibleEnd);
|
|
311
|
+
return start + middle + end;
|
|
312
|
+
}
|
|
313
|
+
function maskNIK(input) {
|
|
314
|
+
assertString(input);
|
|
315
|
+
const cleaned = input.replace(/\s+/g, "");
|
|
316
|
+
if (!/^\d{16}$/.test(cleaned)) {
|
|
317
|
+
return fullMask(input);
|
|
318
|
+
}
|
|
319
|
+
return mask(cleaned, { visibleStart: 4, visibleEnd: 4 });
|
|
320
|
+
}
|
|
321
|
+
function maskPhone(input) {
|
|
322
|
+
assertString(input);
|
|
323
|
+
const normalized = normalizePhone(input);
|
|
324
|
+
if (!normalized) {
|
|
325
|
+
return fullMask(input);
|
|
326
|
+
}
|
|
327
|
+
return mask(normalized, { visibleStart: 4, visibleEnd: 3 });
|
|
328
|
+
}
|
|
329
|
+
function maskAccount(input) {
|
|
330
|
+
assertString(input);
|
|
331
|
+
const cleaned = input.replace(/[\s-]+/g, "");
|
|
332
|
+
if (cleaned.length < 8 || !/^\d+$/.test(cleaned)) {
|
|
333
|
+
return fullMask(input);
|
|
334
|
+
}
|
|
335
|
+
return mask(cleaned, { visibleStart: 0, visibleEnd: 4 });
|
|
336
|
+
}
|
|
198
337
|
// Annotate the CommonJS export names for ESM import in node:
|
|
199
338
|
0 && (module.exports = {
|
|
339
|
+
detectOperator,
|
|
200
340
|
isValidNIK,
|
|
201
341
|
isValidPhone,
|
|
342
|
+
mask,
|
|
343
|
+
maskAccount,
|
|
344
|
+
maskNIK,
|
|
345
|
+
maskPhone,
|
|
202
346
|
normalizePhone,
|
|
203
347
|
parseNIK,
|
|
204
348
|
rupiah,
|
package/dist/index.d.cts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
1
|
export { rupiah, terbilang } from './format.cjs';
|
|
2
|
-
export { isValidPhone, normalizePhone } from './phone.cjs';
|
|
2
|
+
export { DetectOperatorReason, DetectOperatorResult, OperatorBrand, OperatorGroup, detectOperator, isValidPhone, normalizePhone } from './phone.cjs';
|
|
3
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,3 +1,4 @@
|
|
|
1
1
|
export { rupiah, terbilang } from './format.js';
|
|
2
|
-
export { isValidPhone, normalizePhone } from './phone.js';
|
|
2
|
+
export { DetectOperatorReason, DetectOperatorResult, OperatorBrand, OperatorGroup, detectOperator, isValidPhone, normalizePhone } from './phone.js';
|
|
3
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,17 +2,29 @@ import {
|
|
|
2
2
|
rupiah,
|
|
3
3
|
terbilang
|
|
4
4
|
} from "./chunk-3347TRCX.js";
|
|
5
|
-
import {
|
|
6
|
-
isValidPhone,
|
|
7
|
-
normalizePhone
|
|
8
|
-
} from "./chunk-GH7ECGI2.js";
|
|
9
5
|
import {
|
|
10
6
|
isValidNIK,
|
|
11
7
|
parseNIK
|
|
12
8
|
} from "./chunk-ZIB7HJMG.js";
|
|
9
|
+
import {
|
|
10
|
+
mask,
|
|
11
|
+
maskAccount,
|
|
12
|
+
maskNIK,
|
|
13
|
+
maskPhone
|
|
14
|
+
} from "./chunk-MFPJTZB7.js";
|
|
15
|
+
import {
|
|
16
|
+
detectOperator,
|
|
17
|
+
isValidPhone,
|
|
18
|
+
normalizePhone
|
|
19
|
+
} from "./chunk-ER6I6HKP.js";
|
|
13
20
|
export {
|
|
21
|
+
detectOperator,
|
|
14
22
|
isValidNIK,
|
|
15
23
|
isValidPhone,
|
|
24
|
+
mask,
|
|
25
|
+
maskAccount,
|
|
26
|
+
maskNIK,
|
|
27
|
+
maskPhone,
|
|
16
28
|
normalizePhone,
|
|
17
29
|
parseNIK,
|
|
18
30
|
rupiah,
|
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
|
+
});
|
package/dist/mask.d.cts
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.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
package/dist/phone.cjs
CHANGED
|
@@ -20,10 +20,82 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
20
20
|
// src/phone/index.ts
|
|
21
21
|
var phone_exports = {};
|
|
22
22
|
__export(phone_exports, {
|
|
23
|
+
detectOperator: () => detectOperator,
|
|
23
24
|
isValidPhone: () => isValidPhone,
|
|
24
25
|
normalizePhone: () => normalizePhone
|
|
25
26
|
});
|
|
26
27
|
module.exports = __toCommonJS(phone_exports);
|
|
28
|
+
|
|
29
|
+
// src/phone/operator.ts
|
|
30
|
+
var OPERATOR_PREFIXES = [
|
|
31
|
+
{ prefix: "0811", operator: "Telkomsel", grup: "Telkomsel" },
|
|
32
|
+
{ prefix: "0812", operator: "Telkomsel", grup: "Telkomsel" },
|
|
33
|
+
{ prefix: "0813", operator: "Telkomsel", grup: "Telkomsel" },
|
|
34
|
+
{ prefix: "0821", operator: "Telkomsel", grup: "Telkomsel" },
|
|
35
|
+
{ prefix: "0822", operator: "Telkomsel", grup: "Telkomsel" },
|
|
36
|
+
{ prefix: "0823", operator: "Telkomsel", grup: "Telkomsel" },
|
|
37
|
+
{ prefix: "0851", operator: "Telkomsel", grup: "Telkomsel" },
|
|
38
|
+
{ prefix: "0852", operator: "Telkomsel", grup: "Telkomsel" },
|
|
39
|
+
{ prefix: "0853", operator: "Telkomsel", grup: "Telkomsel" },
|
|
40
|
+
{ prefix: "0814", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
41
|
+
{ prefix: "0815", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
42
|
+
{ prefix: "0816", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
43
|
+
{ prefix: "0855", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
44
|
+
{ prefix: "0856", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
45
|
+
{ prefix: "0857", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
46
|
+
{ prefix: "0858", operator: "IM3", grup: "Indosat Ooredoo Hutchison" },
|
|
47
|
+
{ prefix: "0895", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
48
|
+
{ prefix: "0896", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
49
|
+
{ prefix: "0897", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
50
|
+
{ prefix: "0898", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
51
|
+
{ prefix: "0899", operator: "Tri", grup: "Indosat Ooredoo Hutchison" },
|
|
52
|
+
{ prefix: "0817", operator: "XL", grup: "XLSmart" },
|
|
53
|
+
{ prefix: "0818", operator: "XL", grup: "XLSmart" },
|
|
54
|
+
{ prefix: "0819", operator: "XL", grup: "XLSmart" },
|
|
55
|
+
{ prefix: "0859", operator: "XL", grup: "XLSmart" },
|
|
56
|
+
{ prefix: "0877", operator: "XL", grup: "XLSmart" },
|
|
57
|
+
{ prefix: "0878", operator: "XL", grup: "XLSmart" },
|
|
58
|
+
{ prefix: "0831", operator: "AXIS", grup: "XLSmart" },
|
|
59
|
+
{ prefix: "0832", operator: "AXIS", grup: "XLSmart" },
|
|
60
|
+
{ prefix: "0833", operator: "AXIS", grup: "XLSmart" },
|
|
61
|
+
{ prefix: "0838", operator: "AXIS", grup: "XLSmart" },
|
|
62
|
+
{ prefix: "0881", operator: "Smartfren", grup: "XLSmart" },
|
|
63
|
+
{ prefix: "0882", operator: "Smartfren", grup: "XLSmart" },
|
|
64
|
+
{ prefix: "0883", operator: "Smartfren", grup: "XLSmart" },
|
|
65
|
+
{ prefix: "0884", operator: "Smartfren", grup: "XLSmart" },
|
|
66
|
+
{ prefix: "0885", operator: "Smartfren", grup: "XLSmart" },
|
|
67
|
+
{ prefix: "0886", operator: "Smartfren", grup: "XLSmart" },
|
|
68
|
+
{ prefix: "0887", operator: "Smartfren", grup: "XLSmart" },
|
|
69
|
+
{ prefix: "0888", operator: "Smartfren", grup: "XLSmart" },
|
|
70
|
+
{ prefix: "0889", operator: "Smartfren", grup: "XLSmart" }
|
|
71
|
+
];
|
|
72
|
+
var SORTED_PREFIXES = [...OPERATOR_PREFIXES].sort(
|
|
73
|
+
(a, b) => b.prefix.length - a.prefix.length || a.prefix.localeCompare(b.prefix)
|
|
74
|
+
);
|
|
75
|
+
function detectOperator(input) {
|
|
76
|
+
if (typeof input !== "string") {
|
|
77
|
+
throw new TypeError("Input harus berupa string");
|
|
78
|
+
}
|
|
79
|
+
const normalized = normalizePhone(input);
|
|
80
|
+
if (!normalized) {
|
|
81
|
+
return { valid: false, alasan: "format" };
|
|
82
|
+
}
|
|
83
|
+
const localNumber = "0" + normalized.slice(3);
|
|
84
|
+
const matched = SORTED_PREFIXES.find(
|
|
85
|
+
(entry) => localNumber.startsWith(entry.prefix)
|
|
86
|
+
);
|
|
87
|
+
if (!matched) {
|
|
88
|
+
return { valid: false, alasan: "awalan-tidak-dikenal" };
|
|
89
|
+
}
|
|
90
|
+
return {
|
|
91
|
+
valid: true,
|
|
92
|
+
operator: matched.operator,
|
|
93
|
+
grup: matched.grup,
|
|
94
|
+
prefix: matched.prefix
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
// src/phone/index.ts
|
|
27
99
|
function normalizePhone(input) {
|
|
28
100
|
let d = input.replace(/[^\d+]/g, "");
|
|
29
101
|
if (d.startsWith("+62")) d = d.slice(3);
|
|
@@ -38,6 +110,7 @@ function isValidPhone(input) {
|
|
|
38
110
|
}
|
|
39
111
|
// Annotate the CommonJS export names for ESM import in node:
|
|
40
112
|
0 && (module.exports = {
|
|
113
|
+
detectOperator,
|
|
41
114
|
isValidPhone,
|
|
42
115
|
normalizePhone
|
|
43
116
|
});
|
package/dist/phone.d.cts
CHANGED
|
@@ -1,4 +1,30 @@
|
|
|
1
|
+
type OperatorBrand = "Telkomsel" | "IM3" | "Tri" | "XL" | "AXIS" | "Smartfren";
|
|
2
|
+
type OperatorGroup = "Telkomsel" | "Indosat Ooredoo Hutchison" | "XLSmart";
|
|
3
|
+
type DetectOperatorReason = "format" | "awalan-tidak-dikenal";
|
|
4
|
+
type DetectOperatorResult = {
|
|
5
|
+
valid: true;
|
|
6
|
+
operator: OperatorBrand;
|
|
7
|
+
grup: OperatorGroup;
|
|
8
|
+
prefix: string;
|
|
9
|
+
} | {
|
|
10
|
+
valid: false;
|
|
11
|
+
alasan: DetectOperatorReason;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Mendeteksi operator seluler asal berdasarkan awalan nomor telepon Indonesia.
|
|
15
|
+
*
|
|
16
|
+
* Catatan penting & batasan:
|
|
17
|
+
* - Hasil menunjukkan **operator asal berdasarkan alokasi awalan**, bukan operator aktif saat ini,
|
|
18
|
+
* karena nomor dapat berpindah operator melalui *number portability*.
|
|
19
|
+
* - Field `grup` adalah perusahaan induk saat data diverifikasi dan dapat berubah karena merger/akuisisi.
|
|
20
|
+
* - Data awalan mengacu pada penomoran Komdigi dan informasi resmi operator
|
|
21
|
+
* (terakhir diverifikasi 2026-11-18); tidak ada satu tabel resmi tunggal yang lengkap.
|
|
22
|
+
* - Hanya menerima nomor seluler yang lolos `normalizePhone`; telepon rumah dan format tidak valid
|
|
23
|
+
* mengembalikan `{ valid: false, alasan: "format" }`.
|
|
24
|
+
*/
|
|
25
|
+
declare function detectOperator(input: string): DetectOperatorResult;
|
|
26
|
+
|
|
1
27
|
declare function normalizePhone(input: string): string | null;
|
|
2
28
|
declare function isValidPhone(input: string): boolean;
|
|
3
29
|
|
|
4
|
-
export { isValidPhone, normalizePhone };
|
|
30
|
+
export { type DetectOperatorReason, type DetectOperatorResult, type OperatorBrand, type OperatorGroup, detectOperator, isValidPhone, normalizePhone };
|
package/dist/phone.d.ts
CHANGED
|
@@ -1,4 +1,30 @@
|
|
|
1
|
+
type OperatorBrand = "Telkomsel" | "IM3" | "Tri" | "XL" | "AXIS" | "Smartfren";
|
|
2
|
+
type OperatorGroup = "Telkomsel" | "Indosat Ooredoo Hutchison" | "XLSmart";
|
|
3
|
+
type DetectOperatorReason = "format" | "awalan-tidak-dikenal";
|
|
4
|
+
type DetectOperatorResult = {
|
|
5
|
+
valid: true;
|
|
6
|
+
operator: OperatorBrand;
|
|
7
|
+
grup: OperatorGroup;
|
|
8
|
+
prefix: string;
|
|
9
|
+
} | {
|
|
10
|
+
valid: false;
|
|
11
|
+
alasan: DetectOperatorReason;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Mendeteksi operator seluler asal berdasarkan awalan nomor telepon Indonesia.
|
|
15
|
+
*
|
|
16
|
+
* Catatan penting & batasan:
|
|
17
|
+
* - Hasil menunjukkan **operator asal berdasarkan alokasi awalan**, bukan operator aktif saat ini,
|
|
18
|
+
* karena nomor dapat berpindah operator melalui *number portability*.
|
|
19
|
+
* - Field `grup` adalah perusahaan induk saat data diverifikasi dan dapat berubah karena merger/akuisisi.
|
|
20
|
+
* - Data awalan mengacu pada penomoran Komdigi dan informasi resmi operator
|
|
21
|
+
* (terakhir diverifikasi 2026-11-18); tidak ada satu tabel resmi tunggal yang lengkap.
|
|
22
|
+
* - Hanya menerima nomor seluler yang lolos `normalizePhone`; telepon rumah dan format tidak valid
|
|
23
|
+
* mengembalikan `{ valid: false, alasan: "format" }`.
|
|
24
|
+
*/
|
|
25
|
+
declare function detectOperator(input: string): DetectOperatorResult;
|
|
26
|
+
|
|
1
27
|
declare function normalizePhone(input: string): string | null;
|
|
2
28
|
declare function isValidPhone(input: string): boolean;
|
|
3
29
|
|
|
4
|
-
export { isValidPhone, normalizePhone };
|
|
30
|
+
export { type DetectOperatorReason, type DetectOperatorResult, type OperatorBrand, type OperatorGroup, detectOperator, isValidPhone, normalizePhone };
|
package/dist/phone.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ghifari29/id-kit",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Utilitas Indonesia: terbilang, rupiah, nomor telepon, dan lainnya",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": false,
|
|
@@ -30,6 +30,11 @@
|
|
|
30
30
|
"types": "./dist/nik.d.ts",
|
|
31
31
|
"import": "./dist/nik.js",
|
|
32
32
|
"require": "./dist/nik.cjs"
|
|
33
|
+
},
|
|
34
|
+
"./mask": {
|
|
35
|
+
"types": "./dist/mask.d.ts",
|
|
36
|
+
"import": "./dist/mask.js",
|
|
37
|
+
"require": "./dist/mask.cjs"
|
|
33
38
|
}
|
|
34
39
|
},
|
|
35
40
|
"scripts": {
|
package/dist/chunk-GH7ECGI2.js
DELETED
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
// src/phone/index.ts
|
|
2
|
-
function normalizePhone(input) {
|
|
3
|
-
let d = input.replace(/[^\d+]/g, "");
|
|
4
|
-
if (d.startsWith("+62")) d = d.slice(3);
|
|
5
|
-
else if (d.startsWith("62")) d = d.slice(2);
|
|
6
|
-
else if (d.startsWith("0")) d = d.slice(1);
|
|
7
|
-
else return null;
|
|
8
|
-
if (!/^8\d{8,11}$/.test(d)) return null;
|
|
9
|
-
return "+62" + d;
|
|
10
|
-
}
|
|
11
|
-
function isValidPhone(input) {
|
|
12
|
-
return normalizePhone(input) !== null;
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
export {
|
|
16
|
-
normalizePhone,
|
|
17
|
-
isValidPhone
|
|
18
|
-
};
|