@indodev/toolkit 0.4.0 → 0.4.1

package/README.md

@@ -9,7 +9,7 @@
 
 </div>
 
-TypeScript utilities for Indonesian data. Handles Rupiah formatting, terbilang, NIK validation, phone normalization, and text rules that generic libraries don't cover.
+TypeScript utilities for Indonesian data. Handles Rupiah formatting, terbilang, NIK validation, phone normalization, date formatting, and text rules that generic libraries don't cover.
 
 ## Install
 
@@ -64,12 +64,27 @@ toTitleCase('pt bank central asia tbk'); // 'PT Bank Central Asia Tbk'
 slugify('Pria & Wanita'); // 'pria-dan-wanita'
 ```
 
+Format dates with Indonesian locale:
+
+```typescript
+import {
+  formatDate,
+  parseDate,
+  toRelativeTime,
+} from '@indodev/toolkit/datetime';
+
+formatDate(new Date('2026-01-02'), 'long'); // '2 Januari 2026'
+parseDate('02-01-2026'); // Date(2026, 0, 2)
+toRelativeTime(new Date(Date.now() - 3600000)); // '1 jam yang lalu'
+```
+
 ## Modules
 
 | Module                                                          | Description                                                    |
 | --------------------------------------------------------------- | -------------------------------------------------------------- |
-| [Currency](https://toolkit.adamm.cloud/docs/financial/currency) | Format Rupiah, terbilang, split amounts, percentages           |
-| [Text](https://toolkit.adamm.cloud/docs/text-utils/text)        | Title case, slugs, abbreviations, case conversion, masking     |
+| [Currency](https://toolkit.adamm.cloud/docs/utilities/currency) | Format Rupiah, terbilang, split amounts, percentages           |
+| [Text](https://toolkit.adamm.cloud/docs/utilities/text)         | Title case, slugs, abbreviations, case conversion, masking     |
+| [DateTime](https://toolkit.adamm.cloud/docs/utilities/datetime) | Indonesian date formatting, relative time, age calculation     |
 | [NIK](https://toolkit.adamm.cloud/docs/identity/nik)            | Validate, parse, and mask Indonesian National Identity Numbers |
 | [NPWP](https://toolkit.adamm.cloud/docs/identity/npwp)          | Validate and format Tax Identification Numbers                 |
 | [Phone](https://toolkit.adamm.cloud/docs/contact/phone)         | Format, validate, and detect mobile operators                  |
@@ -77,6 +92,7 @@ slugify('Pria & Wanita'); // 'pria-dan-wanita'
 | [Plate](https://toolkit.adamm.cloud/docs/vehicles/plate)        | Validate license plates with region detection                  |
 | [VIN](https://toolkit.adamm.cloud/docs/vehicles/vin)            | Validate Vehicle Identification Numbers (ISO 3779)             |
 
+
 Full docs, examples, and API reference at [toolkit.adamm.cloud](https://toolkit.adamm.cloud/docs)
 
 MIT

package/dist/index.cjs

@@ -717,7 +717,7 @@ function isMobileNumber(phone) {
   let normalized;
   if (cleaned.startsWith("+62")) {
     normalized = "0" + cleaned.substring(3);
-  } else if (cleaned.startsWith("62")) {
+  } else if (cleaned.startsWith("62") && !cleaned.startsWith("620")) {
     normalized = "0" + cleaned.substring(2);
   } else {
     normalized = cleaned;
@@ -731,19 +731,70 @@ function isLandlineNumber(phone) {
   return !isMobileNumber(phone);
 }
 
+// src/phone/utils.ts
+function normalizePhoneNumber(phone) {
+  if (!phone || typeof phone !== "string") {
+    return "";
+  }
+  if (phone.startsWith("+62")) {
+    return "0" + phone.substring(3);
+  }
+  if (phone.startsWith("62") && !phone.startsWith("620")) {
+    return "0" + phone.substring(2);
+  }
+  if (phone.startsWith("0")) {
+    return phone;
+  }
+  return "";
+}
+function normalizeToNational(phone) {
+  if (phone.startsWith("+62")) {
+    return "0" + phone.substring(3);
+  }
+  if (phone.startsWith("62") && !phone.startsWith("620")) {
+    return "0" + phone.substring(2);
+  }
+  if (phone.startsWith("0")) {
+    return phone;
+  }
+  return "";
+}
+function getLandlineRegion(phone) {
+  if (!phone || typeof phone !== "string") {
+    return null;
+  }
+  const cleaned = phone.replace(/[^\d+]/g, "");
+  const normalized = normalizeToNational(cleaned);
+  if (!normalized || !normalized.startsWith("0")) {
+    return null;
+  }
+  if (normalized.startsWith("08")) {
+    return null;
+  }
+  const areaCode4 = normalized.substring(0, 4);
+  if (AREA_CODES[areaCode4]) {
+    return AREA_CODES[areaCode4];
+  }
+  const areaCode3 = normalized.substring(0, 3);
+  if (AREA_CODES[areaCode3]) {
+    return AREA_CODES[areaCode3];
+  }
+  const areaCode2 = normalized.substring(0, 2);
+  if (AREA_CODES[areaCode2]) {
+    return AREA_CODES[areaCode2];
+  }
+  return null;
+}
+
 // 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;
+  const normalized = normalizePhoneNumber(cleaned);
+  if (!normalized) {
+    return phone;
   }
   switch (format) {
     case "international":
@@ -762,7 +813,7 @@ function toInternational(phone) {
   if (!cleaned) {
     return phone;
   }
-  const normalized = normalizeToNational(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return phone;
   }
@@ -788,7 +839,7 @@ function toNational(phone) {
   if (!cleaned) {
     return phone;
   }
-  const normalized = normalizeToNational(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return phone;
   }
@@ -813,7 +864,7 @@ function toE164(phone) {
   if (!cleaned) {
     return phone;
   }
-  const normalized = normalizeToNational(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return phone;
   }
@@ -825,16 +876,6 @@ function cleanPhoneNumber(phone) {
   }
   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]) {
@@ -860,7 +901,7 @@ function maskPhoneNumber(phone, options = {}) {
   if (isInternational) {
     toMask = cleaned;
   } else {
-    const normalized = normalizeToNational(cleaned);
+    const normalized = normalizePhoneNumber(cleaned);
     toMask = normalized || cleaned;
   }
   if (toMask.length < 4) {
@@ -929,7 +970,7 @@ function parsePhoneNumber(phone) {
     return null;
   }
   const cleaned = cleanPhoneNumber(phone);
-  const normalized = normalizeToNational2(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return null;
   }
@@ -942,7 +983,7 @@ function parsePhoneNumber(phone) {
   if (isMobile) {
     operator = getOperator(normalized);
   } else {
-    region = getRegion(normalized);
+    region = getLandlineRegion(normalized);
   }
   return {
     countryCode,
@@ -964,7 +1005,7 @@ function getOperator(phone) {
     return null;
   }
   const cleaned = cleanPhoneNumber(phone);
-  const normalized = normalizeToNational2(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized || normalized.length < 4) {
     return null;
   }
@@ -978,30 +1019,6 @@ function isProvider(phone, providerName) {
   }
   return operator.toLowerCase() === providerName.toLowerCase();
 }
-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 "";
-}
 
 // src/npwp/validate.ts
 function validateNPWP(npwp) {