@ghifari29/id-kit 0.3.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 CHANGED
@@ -16,7 +16,7 @@ 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
21
  import { mask, maskNIK, maskPhone, maskAccount } from "@ghifari29/id-kit/mask";
22
22
 
@@ -32,6 +32,9 @@ normalizePhone("0812-3456-789");
32
32
  isValidPhone("021-555-1234");
33
33
  // false
34
34
 
35
+ detectOperator("0812-3456-789");
36
+ // { valid: true, operator: "Telkomsel", grup: "Telkomsel", prefix: "0812" }
37
+
35
38
  isValidNIK("3171011505900001");
36
39
  // true
37
40
 
@@ -57,7 +60,7 @@ maskAccount("123-456-7890");
57
60
  - [x] `normalizePhone`, `isValidPhone`
58
61
  - [x] `parseNIK`, `isValidNIK` (validasi NIK)
59
62
  - [x] `mask`, `maskNIK`, `maskPhone`, `maskAccount` (masking data pribadi)
60
- - [ ] Deteksi operator seluler
63
+ - [x] `detectOperator` (deteksi operator seluler asal)
61
64
  - [ ] Validasi NPWP dan nomor rekening
62
65
  - [ ] Libur nasional dan cuti bersama
63
66
  - [ ] Data wilayah
@@ -66,6 +69,7 @@ maskAccount("123-456-7890");
66
69
 
67
70
  - `terbilang` hanya mendukung bilangan bulat.
68
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"`.
69
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).
70
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.
71
75
 
@@ -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
+ };
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  normalizePhone
3
- } from "./chunk-GH7ECGI2.js";
3
+ } from "./chunk-ER6I6HKP.js";
4
4
 
5
5
  // src/mask/mask.ts
6
6
  function assertString(input) {
package/dist/index.cjs CHANGED
@@ -20,6 +20,7 @@ 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,
25
26
  mask: () => mask,
@@ -79,6 +80,75 @@ function rupiah(n) {
79
80
  return "Rp" + new Intl.NumberFormat("id-ID").format(n);
80
81
  }
81
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
+
82
152
  // src/phone/index.ts
83
153
  function normalizePhone(input) {
84
154
  let d = input.replace(/[^\d+]/g, "");
@@ -266,6 +336,7 @@ function maskAccount(input) {
266
336
  }
267
337
  // Annotate the CommonJS export names for ESM import in node:
268
338
  0 && (module.exports = {
339
+ detectOperator,
269
340
  isValidNIK,
270
341
  isValidPhone,
271
342
  mask,
package/dist/index.d.cts CHANGED
@@ -1,4 +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
4
  export { MaskOptions, mask, maskAccount, maskNIK, maskPhone } from './mask.cjs';
package/dist/index.d.ts CHANGED
@@ -1,4 +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
4
  export { MaskOptions, mask, maskAccount, maskNIK, maskPhone } from './mask.js';
package/dist/index.js CHANGED
@@ -11,12 +11,14 @@ import {
11
11
  maskAccount,
12
12
  maskNIK,
13
13
  maskPhone
14
- } from "./chunk-RR7TOTVK.js";
14
+ } from "./chunk-MFPJTZB7.js";
15
15
  import {
16
+ detectOperator,
16
17
  isValidPhone,
17
18
  normalizePhone
18
- } from "./chunk-GH7ECGI2.js";
19
+ } from "./chunk-ER6I6HKP.js";
19
20
  export {
21
+ detectOperator,
20
22
  isValidNIK,
21
23
  isValidPhone,
22
24
  mask,
package/dist/mask.js CHANGED
@@ -3,8 +3,8 @@ import {
3
3
  maskAccount,
4
4
  maskNIK,
5
5
  maskPhone
6
- } from "./chunk-RR7TOTVK.js";
7
- import "./chunk-GH7ECGI2.js";
6
+ } from "./chunk-MFPJTZB7.js";
7
+ import "./chunk-ER6I6HKP.js";
8
8
  export {
9
9
  mask,
10
10
  maskAccount,
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
@@ -1,8 +1,10 @@
1
1
  import {
2
+ detectOperator,
2
3
  isValidPhone,
3
4
  normalizePhone
4
- } from "./chunk-GH7ECGI2.js";
5
+ } from "./chunk-ER6I6HKP.js";
5
6
  export {
7
+ detectOperator,
6
8
  isValidPhone,
7
9
  normalizePhone
8
10
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ghifari29/id-kit",
3
- "version": "0.3.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,
@@ -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
- };