@indodev/toolkit 0.4.0 → 0.4.2

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

@@ -59,53 +59,66 @@ var REGENCIES = {
   }
 };
 
-// src/nik/validate.ts
-function validateNIK(nik) {
-  if (!/^\d{16}$/.test(nik)) {
-    return false;
-  }
-  const provinceCode = nik.substring(0, 2);
-  if (!PROVINCES[provinceCode]) {
-    return false;
+// src/nik/utils/date.ts
+function parseNIKDate(nik) {
+  if (nik.length !== 16) {
+    return null;
   }
   const yearStr = nik.substring(6, 8);
   const monthStr = nik.substring(8, 10);
-  const dayStr = nik.substring(10, 12);
+  const dayEncodedStr = nik.substring(10, 12);
   const year = parseInt(yearStr, 10);
+  if (isNaN(year)) return null;
   const fullYear = year > 30 ? 1900 + year : 2e3 + year;
   const month = parseInt(monthStr, 10);
-  let day = parseInt(dayStr, 10);
-  if (day > 40) {
-    day = day - 40;
+  if (isNaN(month)) return null;
+  const dayEncoded = parseInt(dayEncodedStr, 10);
+  if (isNaN(dayEncoded)) return null;
+  const gender = dayEncoded > 40 ? "female" : "male";
+  const day = dayEncoded > 40 ? dayEncoded - 40 : dayEncoded;
+  return { year, fullYear, month, day, gender, dayEncoded };
+}
+function validateNIKDateComponents(year, month, day) {
+  if (month < 1 || month > 12) return false;
+  if (day < 1 || day > 31) return false;
+  const testDate = new Date(year, month - 1, day);
+  return testDate.getFullYear() === year && testDate.getMonth() === month - 1 && testDate.getDate() === day;
+}
+
+// src/nik/validate.ts
+var NIK_PATTERN = /^\d{16}$/;
+function validateNIK(nik) {
+  if (!NIK_PATTERN.test(nik)) {
+    return false;
   }
-  if (month < 1 || month > 12) {
+  const provinceCode = nik.substring(0, 2);
+  if (!PROVINCES[provinceCode]) {
     return false;
   }
-  if (day < 1 || day > 31) {
+  const parsed = parseNIKDate(nik);
+  if (!parsed) {
     return false;
   }
-  const testDate = new Date(fullYear, month - 1, day);
-  if (testDate.getFullYear() !== fullYear || testDate.getMonth() !== month - 1 || testDate.getDate() !== day) {
+  const { fullYear, month, day } = parsed;
+  if (!validateNIKDateComponents(fullYear, month, day)) {
     return false;
   }
   const now = /* @__PURE__ */ new Date();
-  if (testDate > now || testDate < new Date(1900, 0, 1)) {
+  if (new Date(fullYear, month - 1, day) > now || fullYear < 1900) {
     return false;
   }
   return true;
 }
 
 // src/nik/parse.ts
+var NIK_PATTERN2 = /^\d{16}$/;
 function parseNIK(nik) {
-  if (!/^\d{16}$/.test(nik)) {
+  if (!NIK_PATTERN2.test(nik)) {
     return null;
   }
   const provinceCode = nik.substring(0, 2);
   const regencyCode = nik.substring(2, 4);
   const districtCode = nik.substring(4, 6);
-  const yearStr = nik.substring(6, 8);
-  const monthStr = nik.substring(8, 10);
-  const dayStr = nik.substring(10, 12);
   const serialNumber = nik.substring(12, 16);
   const province = PROVINCES[provinceCode];
   if (!province) {
@@ -113,21 +126,15 @@ function parseNIK(nik) {
   }
   const regencies = REGENCIES[provinceCode] || {};
   const regency = regencies[regencyCode] || "Unknown";
-  let day = parseInt(dayStr, 10);
-  const month = parseInt(monthStr, 10);
-  const year = parseInt(yearStr, 10);
-  let gender = null;
-  if (day > 40) {
-    gender = "female";
-    day -= 40;
-  } else {
-    gender = "male";
+  const parsed = parseNIKDate(nik);
+  if (!parsed) {
+    return null;
   }
-  const fullYear = year > 30 ? 1900 + year : 2e3 + year;
-  const birthDate = new Date(fullYear, month - 1, day);
-  if (birthDate.getFullYear() !== fullYear || birthDate.getMonth() !== month - 1 || birthDate.getDate() !== day) {
+  const { fullYear, month, day, gender } = parsed;
+  if (!validateNIKDateComponents(fullYear, month, day)) {
     return null;
   }
+  const birthDate = new Date(fullYear, month - 1, day);
   return {
     province: {
       code: provinceCode,
@@ -717,7 +724,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 +738,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 +820,7 @@ function toInternational(phone) {
   if (!cleaned) {
     return phone;
   }
-  const normalized = normalizeToNational(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return phone;
   }
@@ -788,7 +846,7 @@ function toNational(phone) {
   if (!cleaned) {
     return phone;
   }
-  const normalized = normalizeToNational(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return phone;
   }
@@ -813,7 +871,7 @@ function toE164(phone) {
   if (!cleaned) {
     return phone;
   }
-  const normalized = normalizeToNational(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return phone;
   }
@@ -825,16 +883,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 +908,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 +977,7 @@ function parsePhoneNumber(phone) {
     return null;
   }
   const cleaned = cleanPhoneNumber(phone);
-  const normalized = normalizeToNational2(cleaned);
+  const normalized = normalizePhoneNumber(cleaned);
   if (!normalized) {
     return null;
   }
@@ -942,7 +990,7 @@ function parsePhoneNumber(phone) {
   if (isMobile) {
     operator = getOperator(normalized);
   } else {
-    region = getRegion(normalized);
+    region = getLandlineRegion(normalized);
   }
   return {
     countryCode,
@@ -964,7 +1012,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 +1026,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) {