@indodev/toolkit 0.0.1

package/dist/phone/index.js

@@ -0,0 +1,718 @@
+// src/phone/constants.ts
+var OPERATOR_PREFIXES = {
+  // Telkomsel (Halo, Simpati, by.U)
+  "0811": "Telkomsel",
+  "0812": "Telkomsel",
+  "0813": "Telkomsel",
+  "0821": "Telkomsel",
+  "0822": "Telkomsel",
+  "0823": "Telkomsel",
+  "0851": "Telkomsel",
+  "0852": "Telkomsel",
+  "0853": "Telkomsel",
+  // XL Axiata (XL Prepaid, XL Prioritas, LIVE.ON)
+  "0817": "XL",
+  "0818": "XL",
+  "0819": "XL",
+  "0859": "XL",
+  "0877": "XL",
+  "0878": "XL",
+  "0879": "XL",
+  // Indosat Ooredoo (IM3, Mentari)
+  // Note: Tri (3 Indonesia) merged with Indosat
+  "0814": "Indosat",
+  "0815": "Indosat",
+  "0816": "Indosat",
+  "0855": "Indosat",
+  "0856": "Indosat",
+  "0857": "Indosat",
+  "0858": "Indosat",
+  "0895": "Indosat",
+  "0896": "Indosat",
+  "0897": "Indosat",
+  "0898": "Indosat",
+  "0899": "Indosat",
+  // Smartfren (Smartfren Power Up)
+  "0881": "Smartfren",
+  "0882": "Smartfren",
+  "0883": "Smartfren",
+  "0884": "Smartfren",
+  "0885": "Smartfren",
+  "0886": "Smartfren",
+  "0887": "Smartfren",
+  "0888": "Smartfren",
+  "0889": "Smartfren",
+  // Axis (Acquired by XL but maintains separate branding)
+  "0831": "Axis",
+  "0832": "Axis",
+  "0833": "Axis",
+  "0838": "Axis"
+};
+var AREA_CODES = {
+  // ========================================
+  // JAKARTA, BANTEN & WEST JAVA
+  // ========================================
+  // Jakarta & Greater Jakarta
+  "021": "Jakarta",
+  // Banten
+  "0252": "Lebak",
+  "0253": "Pandeglang",
+  "0254": "Cilegon & Serang",
+  // West Java
+  "022": "Bandung",
+  "0231": "Cirebon",
+  "0232": "Kuningan",
+  "0233": "Majalengka",
+  "0234": "Indramayu",
+  "0251": "Bogor",
+  "0260": "Subang",
+  "0261": "Sumedang",
+  "0262": "Garut",
+  "0263": "Cianjur",
+  "0264": "Purwakarta",
+  "0265": "Tasikmalaya",
+  "0266": "Sukabumi",
+  "0267": "Karawang",
+  // ========================================
+  // CENTRAL JAVA & YOGYAKARTA
+  // ========================================
+  // Central Java
+  "024": "Semarang",
+  "0271": "Solo",
+  "0272": "Klaten",
+  "0273": "Wonogiri",
+  "0275": "Purworejo",
+  "0276": "Boyolali",
+  "0280": "Cilacap",
+  "0281": "Banyumas & Purbalingga",
+  "0282": "Cilacap",
+  "0283": "Tegal & Brebes",
+  "0284": "Pemalang",
+  "0285": "Pekalongan",
+  "0286": "Banjarnegara & Wonosobo",
+  "0287": "Kebumen",
+  "0289": "Bumiayu",
+  "0291": "Kudus & Jepara",
+  "0292": "Grobogan",
+  "0293": "Magelang",
+  "0294": "Kendal",
+  "0295": "Pati & Rembang",
+  "0296": "Blora",
+  "0297": "Karimun Jawa",
+  "0298": "Salatiga",
+  // Yogyakarta
+  "0274": "Yogyakarta",
+  // ========================================
+  // EAST JAVA, BALI & NUSA TENGGARA
+  // ========================================
+  // East Java
+  "031": "Surabaya",
+  "0321": "Mojokerto & Jombang",
+  "0322": "Lamongan",
+  "0323": "Sampang",
+  "0324": "Pamekasan",
+  "0325": "Bawean",
+  "0326": "Masalembu",
+  "0327": "Kangean",
+  "0328": "Sumenep",
+  "0331": "Jember",
+  "0332": "Bondowoso",
+  "0333": "Banyuwangi",
+  "0334": "Lumajang",
+  "0335": "Probolinggo",
+  "0336": "Jember",
+  "0338": "Situbondo",
+  "0341": "Malang",
+  "0342": "Blitar",
+  "0343": "Pasuruan",
+  "0351": "Madiun",
+  "0352": "Ponorogo",
+  "0353": "Bojonegoro",
+  "0354": "Kediri",
+  "0355": "Tulungagung",
+  "0356": "Tuban",
+  "0357": "Pacitan",
+  "0358": "Nganjuk",
+  // Bali
+  "0361": "Denpasar",
+  "0362": "Singaraja",
+  "0363": "Amlapura",
+  "0365": "Negara",
+  "0366": "Tabanan",
+  "0368": "Gianyar",
+  // Nusa Tenggara Barat (NTB)
+  "0370": "Mataram",
+  "0371": "Sumbawa",
+  "0372": "West Sumbawa",
+  "0373": "Dompu",
+  "0374": "Bima",
+  "0376": "East Lombok",
+  // Nusa Tenggara Timur (NTT)
+  "0379": "Alor",
+  "0380": "Kupang",
+  "0381": "Ende",
+  "0382": "Sikka",
+  "0383": "East Flores",
+  "0384": "Ngada",
+  "0385": "Manggarai",
+  "0386": "West Manggarai",
+  "0387": "Sumba",
+  "0388": "North & South Central Timor",
+  "0389": "Belu",
+  // ========================================
+  // SULAWESI
+  // ========================================
+  // South Sulawesi
+  "0410": "Pangkajene",
+  "0411": "Makassar",
+  "0413": "Bantaeng & Bulukumba",
+  "0414": "Selayar",
+  "0417": "Malino",
+  "0418": "Takalar",
+  "0419": "Jeneponto",
+  "0420": "Enrekang",
+  "0421": "Pare Pare",
+  "0423": "Tana Toraja",
+  "0427": "Barru",
+  "0471": "Luwu",
+  "0472": "Wajo (Pitumpanua)",
+  "0473": "North Luwu",
+  "0474": "East Luwu",
+  "0475": "Sorowako",
+  "0481": "Bone",
+  "0482": "Sinjai",
+  "0484": "Soppeng",
+  "0485": "Wajo",
+  // West Sulawesi
+  "0422": "Majene",
+  "0426": "Mamuju",
+  "0428": "Polewali",
+  "0429": "Central Mamuju",
+  // Central Sulawesi
+  "0409": "Morowali",
+  "0445": "Buol",
+  "0450": "Parigi Moutong",
+  "0451": "Palu",
+  "0452": "Poso",
+  "0453": "Toli-Toli",
+  "0454": "Tinombo",
+  "0455": "Moutong",
+  "0457": "Donggala",
+  "0458": "Tentena",
+  "0461": "Banggai",
+  "0462": "Banggai Island",
+  "0463": "Bunta",
+  "0464": "Tojo Una-Una",
+  "0465": "North Morowali",
+  // Southeast Sulawesi
+  "0401": "Kendari",
+  "0402": "Buton",
+  "0403": "Muna",
+  "0404": "Wakatobi",
+  "0405": "Kolaka",
+  "0408": "Konawe",
+  // North Sulawesi
+  "0430": "South Minahasa",
+  "0431": "Manado",
+  "0432": "Sangihe",
+  "0433": "Talaud",
+  "0434": "Bolaang Mongondow",
+  "0438": "Bitung",
+  // Gorontalo
+  "0435": "Gorontalo",
+  "0442": "North Gorontalo",
+  "0443": "Pohuwato",
+  // ========================================
+  // KALIMANTAN
+  // ========================================
+  // West Kalimantan
+  "0534": "Ketapang",
+  "0535": "Kayong Utara",
+  "0561": "Pontianak",
+  "0562": "Sambas & Singkawang",
+  "0563": "Landak",
+  "0564": "Sanggau",
+  "0565": "Sintang",
+  "0567": "Kapuas Hulu",
+  "0568": "Melawi",
+  // Central Kalimantan
+  "0513": "Kapuas",
+  "0519": "North Barito",
+  "0526": "South & East Barito",
+  "0528": "Murung Raya",
+  "0531": "East Kotawaringin",
+  "0532": "West Kotawaringin",
+  "0536": "Palangka Raya",
+  "0537": "Gunung Mas",
+  "0538": "Seruyan",
+  "0539": "Seruyan & East Kotawaringin",
+  // South Kalimantan
+  "0511": "Banjarmasin",
+  "0512": "Tanah Laut",
+  "0517": "Hulu Sungai Selatan",
+  "0518": "Tanah Bumbu",
+  "0527": "Hulu Sungai Utara",
+  // East Kalimantan
+  "0541": "Samarinda",
+  "0542": "Balikpapan",
+  "0543": "Paser",
+  "0545": "West Kutai",
+  "0548": "Bontang",
+  "0549": "East Kutai",
+  "0554": "Berau",
+  // North Kalimantan
+  "0551": "Tarakan",
+  "0552": "Bulungan",
+  "0553": "Malinau",
+  "0556": "Nunukan",
+  // ========================================
+  // SUMATRA
+  // ========================================
+  // Aceh
+  "0627": "Subulussalam & Dairi (North Sumatra)",
+  "0629": "Southeast Aceh",
+  "0641": "Langsa",
+  "0642": "Gayo Lues",
+  "0643": "Central Aceh",
+  "0644": "Bireuen",
+  "0645": "Lhokseumawe",
+  "0646": "East Aceh",
+  "0650": "Simeulue",
+  "0651": "Banda Aceh",
+  "0652": "Sabang",
+  "0653": "Pidie",
+  "0654": "Aceh Jaya",
+  "0655": "West Aceh",
+  "0656": "South Aceh",
+  "0657": "South Aceh",
+  "0658": "Singkil",
+  "0659": "Southwest Aceh",
+  // North Sumatra
+  "061": "Medan",
+  "0620": "Pangkalan Brandan",
+  "0621": "Tebing Tinggi",
+  "0622": "Pematang Siantar",
+  "0623": "Asahan",
+  "0624": "Labuhan Batu",
+  "0625": "Parapat",
+  "0626": "Samosir",
+  // '0627': 'Dairi', // for this prefix, it same with Subulussalam (Aceh)
+  "0628": "Karo",
+  "0630": "South Nias",
+  "0631": "Sibolga",
+  "0632": "Toba Samosir",
+  "0633": "North Tapanuli",
+  "0634": "Padang Sidempuan",
+  "0635": "South Tapanuli",
+  "0636": "Mandailing Natal",
+  "0638": "Barus",
+  "0639": "Nias",
+  // West Sumatra
+  "0751": "Padang",
+  "0752": "Bukittinggi",
+  "0753": "Pasaman",
+  "0754": "Sawahlunto",
+  "0755": "Solok",
+  "0756": "South Pesisir",
+  "0757": "South Pesisir",
+  "0759": "Mentawai",
+  // Riau
+  "0760": "Kuantan Singingi",
+  "0761": "Pekanbaru",
+  "0762": "Kampar",
+  "0763": "Bengkalis",
+  "0764": "Siak",
+  "0765": "Dumai",
+  "0766": "Bengkalis",
+  "0767": "Rokan Hulu",
+  "0768": "Indragiri Hilir",
+  "0769": "Indragiri Hulu",
+  // Riau Islands
+  "0770": "Muka Kuning Batamindo",
+  "0771": "Tanjungpinang",
+  "0772": "Anambas",
+  "0773": "Natuna",
+  "0776": "Lingga",
+  "0777": "Great Karimun",
+  "0778": "Batam",
+  "0779": "Kundur",
+  // Jambi
+  "0741": "Jambi",
+  "0742": "West Tanjung Jabung",
+  "0743": "Batanghari",
+  "0744": "Tebo",
+  "0745": "Sarolangun",
+  "0746": "Merangin",
+  "0747": "Bungo",
+  "0748": "Kerinci",
+  // South Sumatra
+  "0702": "Empat Lawang",
+  "0711": "Palembang",
+  "0712": "Ogan Komering Ilir",
+  "0713": "Prabumulih",
+  "0714": "Musi Banyuasin",
+  "0730": "Pagar Alam",
+  "0731": "Lahat",
+  "0733": "Lubuklinggau",
+  "0734": "Muara Enim",
+  "0735": "Ogan Komering Ulu",
+  // Bangka Belitung
+  "0715": "Belinyu",
+  "0716": "West Bangka",
+  "0717": "Pangkal Pinang",
+  "0718": "Central & South Bangka",
+  "0719": "Belitung",
+  // Bengkulu
+  "0732": "Rejang Lebong",
+  "0736": "Bengkulu",
+  "0737": "North Bengkulu",
+  "0739": "South Bengkulu",
+  // Lampung
+  "0721": "Bandar Lampung",
+  "0722": "Tanggamus",
+  "0723": "Way Kanan",
+  "0724": "North Lampung",
+  "0725": "Metro",
+  "0726": "Tulang Bawang",
+  "0727": "South Lampung",
+  "0728": "West Lampung",
+  "0729": "Pringsewu",
+  // ========================================
+  // MALUKU & PAPUA
+  // ========================================
+  // Maluku
+  "0910": "Ambon",
+  "0911": "Southeast Maluku",
+  "0913": "Tual",
+  "0914": "Saumlaki",
+  "0916": "Namlea",
+  "0918": "Ternate",
+  "0921": "Sanana",
+  "0924": "Tobelo",
+  // Papua & West Papua
+  "0901": "Timika",
+  "0902": "Agats",
+  "0951": "Sorong",
+  "0952": "South Sorong",
+  "0967": "Manokwari",
+  "0969": "Sorong",
+  "0971": "Merauke",
+  "0975": "Boven Digoel",
+  "0979": "Tembagapura",
+  "0981": "Jayapura",
+  "0986": "Wamena"
+};
+
+// src/phone/validate.ts
+function validatePhoneNumber(phone) {
+  if (!phone || typeof phone !== "string") {
+    return false;
+  }
+  if (!/^[\d\s\-+().]+$/.test(phone)) {
+    return false;
+  }
+  const cleaned = phone.replace(/[\s\-().]/g, "");
+  let normalized;
+  if (cleaned.startsWith("+62")) {
+    normalized = "0" + cleaned.substring(3);
+  } else if (cleaned.startsWith("62") && !cleaned.startsWith("620")) {
+    normalized = "0" + cleaned.substring(2);
+  } else if (cleaned.startsWith("0")) {
+    normalized = cleaned;
+  } else {
+    return false;
+  }
+  if (normalized.startsWith("08")) {
+    return validateMobileNumber(normalized);
+  }
+  if (normalized.startsWith("0")) {
+    return validateLandlineNumber(normalized);
+  }
+  return false;
+}
+function validateMobileNumber(phone) {
+  if (phone.length < 10 || phone.length > 13) {
+    return false;
+  }
+  const prefix = phone.substring(0, 4);
+  if (!OPERATOR_PREFIXES[prefix]) {
+    return false;
+  }
+  if (!/^\d+$/.test(phone)) {
+    return false;
+  }
+  return true;
+}
+function validateLandlineNumber(phone) {
+  if (phone.length < 9 || phone.length > 11) {
+    return false;
+  }
+  const areaCode3 = phone.substring(0, 3);
+  const areaCode4 = phone.substring(0, 4);
+  if (AREA_CODES[areaCode3] || AREA_CODES[areaCode4]) {
+    return true;
+  }
+  if (/^0[2-9]\d{7,9}$/.test(phone)) {
+    return true;
+  }
+  return false;
+}
+function isMobileNumber(phone) {
+  if (!validatePhoneNumber(phone)) {
+    return false;
+  }
+  const cleaned = phone.replace(/[^\d+]/g, "");
+  let normalized;
+  if (cleaned.startsWith("+62")) {
+    normalized = "0" + cleaned.substring(3);
+  } else if (cleaned.startsWith("62")) {
+    normalized = "0" + cleaned.substring(2);
+  } else {
+    normalized = cleaned;
+  }
+  return normalized.startsWith("08");
+}
+function isLandlineNumber(phone) {
+  if (!validatePhoneNumber(phone)) {
+    return false;
+  }
+  return !isMobileNumber(phone);
+}
+
+// src/phone/format.ts
+function formatPhoneNumber(phone, format = "national") {
+  if (!validatePhoneNumber(phone)) {
+    return phone;
+  }
+  const cleaned = cleanPhoneNumber(phone);
+  let normalized;
+  if (cleaned.startsWith("+62")) {
+    normalized = "0" + cleaned.substring(3);
+  } else if (cleaned.startsWith("62") && !cleaned.startsWith("620")) {
+    normalized = "0" + cleaned.substring(2);
+  } else {
+    normalized = cleaned;
+  }
+  switch (format) {
+    case "international":
+      return toInternational(normalized);
+    case "national":
+    case "display":
+      return toNational(normalized);
+    case "e164":
+      return toE164(normalized);
+    default:
+      return phone;
+  }
+}
+function toInternational(phone) {
+  const cleaned = cleanPhoneNumber(phone);
+  if (!cleaned) {
+    return phone;
+  }
+  const normalized = normalizeToNational(cleaned);
+  if (!normalized) {
+    return phone;
+  }
+  const withoutZero = normalized.substring(1);
+  if (normalized.startsWith("08")) {
+    if (withoutZero.length === 11) {
+      return `+62 ${withoutZero.substring(0, 3)}-${withoutZero.substring(3, 7)}-${withoutZero.substring(7)}`;
+    } else if (withoutZero.length === 10) {
+      return `+62 ${withoutZero.substring(0, 3)}-${withoutZero.substring(3, 6)}-${withoutZero.substring(6)}`;
+    } else if (withoutZero.length === 9) {
+      return `+62 ${withoutZero.substring(0, 3)}-${withoutZero.substring(3)}`;
+    } else if (withoutZero.length === 12) {
+      return `+62 ${withoutZero.substring(0, 3)}-${withoutZero.substring(3, 7)}-${withoutZero.substring(7)}`;
+    }
+  }
+  const areaCodeLength = getAreaCodeLength(normalized);
+  const areaCode = normalized.substring(1, areaCodeLength + 1);
+  const localNumber = normalized.substring(areaCodeLength + 1);
+  return `+62 ${areaCode}-${localNumber}`;
+}
+function toNational(phone) {
+  const cleaned = cleanPhoneNumber(phone);
+  if (!cleaned) {
+    return phone;
+  }
+  const normalized = normalizeToNational(cleaned);
+  if (!normalized) {
+    return phone;
+  }
+  if (normalized.startsWith("08")) {
+    if (normalized.length === 12) {
+      return `${normalized.substring(0, 4)}-${normalized.substring(4, 8)}-${normalized.substring(8)}`;
+    } else if (normalized.length === 11) {
+      return `${normalized.substring(0, 4)}-${normalized.substring(4, 7)}-${normalized.substring(7)}`;
+    } else if (normalized.length === 10) {
+      return `${normalized.substring(0, 4)}-${normalized.substring(4)}`;
+    } else if (normalized.length === 13) {
+      return `${normalized.substring(0, 4)}-${normalized.substring(4, 8)}-${normalized.substring(8)}`;
+    }
+  }
+  const areaCodeLength = getAreaCodeLength(normalized);
+  const areaCodeWithZero = normalized.substring(0, areaCodeLength + 1);
+  const localNumber = normalized.substring(areaCodeLength + 1);
+  return `${areaCodeWithZero}-${localNumber}`;
+}
+function toE164(phone) {
+  const cleaned = cleanPhoneNumber(phone);
+  if (!cleaned) {
+    return phone;
+  }
+  const normalized = normalizeToNational(cleaned);
+  if (!normalized) {
+    return phone;
+  }
+  return "62" + normalized.substring(1);
+}
+function cleanPhoneNumber(phone) {
+  if (!phone || typeof phone !== "string") {
+    return "";
+  }
+  return phone.replace(/[^\d+]/g, "");
+}
+function normalizeToNational(phone) {
+  if (phone.startsWith("+62")) {
+    return "0" + phone.substring(3);
+  } else if (phone.startsWith("62") && !phone.startsWith("620")) {
+    return "0" + phone.substring(2);
+  } else if (phone.startsWith("0")) {
+    return phone;
+  }
+  return "";
+}
+function getAreaCodeLength(normalized) {
+  const fourDigitCode = normalized.substring(0, 5);
+  if (AREA_CODES[fourDigitCode]) {
+    return 4;
+  }
+  const threeDigitCode = normalized.substring(0, 4);
+  if (AREA_CODES[threeDigitCode]) {
+    return 3;
+  }
+  const twoDigitCode = normalized.substring(0, 3);
+  if (AREA_CODES[twoDigitCode]) {
+    return 2;
+  }
+  return 2;
+}
+function maskPhoneNumber(phone, options = {}) {
+  const cleaned = cleanPhoneNumber(phone);
+  if (!cleaned) {
+    return phone;
+  }
+  const isInternational = cleaned.startsWith("+");
+  let toMask;
+  if (isInternational) {
+    toMask = cleaned;
+  } else {
+    const normalized = normalizeToNational(cleaned);
+    toMask = normalized || cleaned;
+  }
+  if (toMask.length < 4) {
+    return phone;
+  }
+  const { char = "*", separator } = options;
+  let { start = 4, end = 4 } = options;
+  if (start + end >= toMask.length) {
+    if (toMask.length < 10) {
+      const minMaskLength = 1;
+      const availableForVisible = toMask.length - minMaskLength;
+      if (availableForVisible >= 2) {
+        start = Math.floor(availableForVisible / 2);
+        end = availableForVisible - start;
+      } else {
+        return toMask;
+      }
+    } else {
+      return toMask;
+    }
+  }
+  const startPart = toMask.substring(0, start);
+  const endPart = toMask.substring(toMask.length - end);
+  const maskLength = toMask.length - start - end;
+  const masked = startPart + char.repeat(maskLength) + endPart;
+  if (separator) {
+    return `${masked.substring(0, start)}${separator}${masked.substring(start, masked.length - end)}${separator}${masked.substring(masked.length - end)}`;
+  }
+  return masked;
+}
+
+// src/phone/parse.ts
+function parsePhoneNumber(phone) {
+  if (!validatePhoneNumber(phone)) {
+    return null;
+  }
+  const cleaned = cleanPhoneNumber(phone);
+  const normalized = normalizeToNational2(cleaned);
+  if (!normalized) {
+    return null;
+  }
+  const countryCode = "62";
+  const number = normalized.substring(1);
+  const isMobile = normalized.startsWith("08");
+  const isLandline = !isMobile;
+  let operator = null;
+  let region = null;
+  if (isMobile) {
+    operator = getOperator(normalized);
+  } else {
+    region = getRegion(normalized);
+  }
+  return {
+    countryCode,
+    operator,
+    number,
+    formatted: {
+      international: toInternational(normalized),
+      national: toNational(normalized),
+      e164: toE164(normalized)
+    },
+    isValid: true,
+    isMobile,
+    isLandline,
+    region
+  };
+}
+function getOperator(phone) {
+  if (!isMobileNumber(phone)) {
+    return null;
+  }
+  const cleaned = cleanPhoneNumber(phone);
+  const normalized = normalizeToNational2(cleaned);
+  if (!normalized || normalized.length < 4) {
+    return null;
+  }
+  const prefix = normalized.substring(0, 4);
+  return OPERATOR_PREFIXES[prefix] || null;
+}
+function getRegion(phone) {
+  if (!phone.startsWith("0")) {
+    return null;
+  }
+  const areaCode4 = phone.substring(0, 4);
+  if (AREA_CODES[areaCode4]) {
+    return AREA_CODES[areaCode4];
+  }
+  const areaCode3 = phone.substring(0, 3);
+  if (AREA_CODES[areaCode3]) {
+    return AREA_CODES[areaCode3];
+  }
+  return null;
+}
+function normalizeToNational2(phone) {
+  if (phone.startsWith("+62")) {
+    return "0" + phone.substring(3);
+  } else if (phone.startsWith("62")) {
+    return "0" + phone.substring(2);
+  } else if (phone.startsWith("0")) {
+    return phone;
+  }
+  return "";
+}
+
+export { cleanPhoneNumber, formatPhoneNumber, getOperator, isLandlineNumber, isMobileNumber, maskPhoneNumber, parsePhoneNumber, toE164, toInternational, toNational, validatePhoneNumber };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map