@indodev/toolkit 0.3.4 → 0.4.1

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) {
@@ -3322,17 +3339,447 @@ function similarity(str1, str2) {
   return 1 - distance / maxLength;
 }
 
+// src/datetime/types.ts
+var InvalidDateError = class extends Error {
+  constructor(message = "Invalid date provided") {
+    super(message);
+    /** Error code for programmatic identification */
+    this.code = "INVALID_DATE";
+    this.name = "InvalidDateError";
+  }
+};
+var InvalidDateRangeError = class extends Error {
+  constructor(message = "End date must be after start date") {
+    super(message);
+    /** Error code for programmatic identification */
+    this.code = "INVALID_DATE_RANGE";
+    this.name = "InvalidDateRangeError";
+  }
+};
+
+// src/datetime/constants.ts
+var MONTH_NAMES = [
+  "",
+  // Placeholder for 0-index
+  "Januari",
+  "Februari",
+  "Maret",
+  "April",
+  "Mei",
+  "Juni",
+  "Juli",
+  "Agustus",
+  "September",
+  "Oktober",
+  "November",
+  "Desember"
+];
+var MONTH_NAMES_SHORT = [
+  "",
+  // Placeholder for 0-index
+  "Jan",
+  "Feb",
+  "Mar",
+  "Apr",
+  "Mei",
+  "Jun",
+  "Jul",
+  "Agu",
+  "Sep",
+  "Okt",
+  "Nov",
+  "Des"
+];
+var DAY_NAMES = [
+  "Minggu",
+  "Senin",
+  "Selasa",
+  "Rabu",
+  "Kamis",
+  "Jumat",
+  "Sabtu"
+];
+var DAY_NAMES_SHORT = [
+  "Min",
+  "Sen",
+  "Sel",
+  "Rab",
+  "Kam",
+  "Jum",
+  "Sab"
+];
+var TIMEZONE_MAP = {
+  // UTC+7 - WIB
+  "Asia/Jakarta": "WIB",
+  "Asia/Pontianak": "WIB",
+  // UTC+8 - WITA
+  "Asia/Makassar": "WITA",
+  "Asia/Denpasar": "WITA",
+  "Asia/Manado": "WITA",
+  "Asia/Palu": "WITA",
+  // UTC+9 - WIT
+  "Asia/Jayapura": "WIT"
+};
+var VALID_UTC_OFFSETS = [7, 8, 9];
+
+// src/datetime/calc.ts
+function isLeapYear(year) {
+  if (!Number.isFinite(year) || !Number.isInteger(year)) {
+    return false;
+  }
+  return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+}
+function daysInMonth(month, year) {
+  if (!Number.isFinite(month) || !Number.isInteger(month) || !Number.isFinite(year) || !Number.isInteger(year) || month < 1 || month > 12) {
+    return 0;
+  }
+  if ([1, 3, 5, 7, 8, 10, 12].includes(month)) {
+    return 31;
+  }
+  if ([4, 6, 9, 11].includes(month)) {
+    return 30;
+  }
+  return isLeapYear(year) ? 29 : 28;
+}
+function isValidDate(date) {
+  return date instanceof Date && !Number.isNaN(date.getTime());
+}
+function isWeekend(date) {
+  const day = date.getDay();
+  return day === 0 || day === 6;
+}
+function isWorkingDay(date) {
+  const day = date.getDay();
+  return day >= 1 && day <= 5;
+}
+function normalizeDate(date) {
+  let result;
+  if (date instanceof Date) {
+    result = date;
+  } else if (typeof date === "number") {
+    result = new Date(date);
+  } else if (typeof date === "string") {
+    result = new Date(date);
+  } else {
+    throw new InvalidDateError("Date must be a Date, string, or number");
+  }
+  if (Number.isNaN(result.getTime())) {
+    throw new InvalidDateError(`Unable to parse date: ${String(date)}`);
+  }
+  return result;
+}
+function getAge2(birthDate, options = {}) {
+  const birth = normalizeDate(birthDate);
+  const from = options.fromDate ? normalizeDate(options.fromDate) : /* @__PURE__ */ new Date();
+  if (birth.getTime() > from.getTime()) {
+    throw new InvalidDateError(
+      "Birth date cannot be in the future relative to fromDate"
+    );
+  }
+  let years = from.getFullYear() - birth.getFullYear();
+  let months = from.getMonth() - birth.getMonth();
+  let days = from.getDate() - birth.getDate();
+  if (days < 0) {
+    months--;
+    const prevMonth = from.getMonth() === 0 ? 11 : from.getMonth() - 1;
+    const prevMonthYear = from.getMonth() === 0 ? from.getFullYear() - 1 : from.getFullYear();
+    days += daysInMonth(prevMonth + 1, prevMonthYear);
+  }
+  if (months < 0) {
+    years--;
+    months += 12;
+  }
+  const result = { years, months, days };
+  if (options.asString) {
+    return formatAgeString(result);
+  }
+  return result;
+}
+function formatAgeString(age) {
+  const parts = [];
+  if (age.years > 0) {
+    parts.push(`${age.years} Tahun`);
+  }
+  if (age.months > 0) {
+    parts.push(`${age.months} Bulan`);
+  }
+  if (age.days > 0) {
+    parts.push(`${age.days} Hari`);
+  }
+  if (parts.length === 0) {
+    return "0 Hari";
+  }
+  return parts.join(" ");
+}
+
+// src/datetime/parse.ts
+function parseDate(dateStr) {
+  const trimmed = dateStr.trim();
+  if (!trimmed) {
+    return null;
+  }
+  if (trimmed.includes(" ") || trimmed.includes(":")) {
+    return null;
+  }
+  const parts = trimmed.split(/[-/.]/);
+  if (parts.length !== 3) {
+    return null;
+  }
+  const nums = parts.map((p) => parseInt(p, 10));
+  if (nums.some((n) => Number.isNaN(n) || n < 0)) {
+    return null;
+  }
+  const [first, second, third] = nums;
+  let day;
+  let month;
+  let year;
+  if (first > 999 && first > 31) {
+    year = first;
+    month = second;
+    day = third;
+  } else {
+    if (third < 1e3) {
+      return null;
+    }
+    day = first;
+    month = second;
+    year = third;
+  }
+  if (month < 1 || month > 12) {
+    return null;
+  }
+  if (year < 1e3 || year > 9999) {
+    return null;
+  }
+  const maxDays = daysInMonth(month, year);
+  if (maxDays === 0 || day < 1 || day > maxDays) {
+    return null;
+  }
+  const date = new Date(year, month - 1, day);
+  if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+    return null;
+  }
+  return date;
+}
+
+// src/datetime/format.ts
+function normalizeDate2(date) {
+  let result;
+  if (date instanceof Date) {
+    result = date;
+  } else if (typeof date === "number") {
+    result = new Date(date);
+  } else if (typeof date === "string") {
+    result = new Date(date);
+  } else {
+    throw new InvalidDateError("Date must be a Date, string, or number");
+  }
+  if (Number.isNaN(result.getTime())) {
+    throw new InvalidDateError(`Unable to parse date: ${String(date)}`);
+  }
+  return result;
+}
+function formatDate(date, style = "long") {
+  const d = normalizeDate2(date);
+  const day = d.getDate();
+  const month = d.getMonth() + 1;
+  const year = d.getFullYear();
+  const dayOfWeek = d.getDay();
+  switch (style) {
+    case "full":
+      return `${DAY_NAMES[dayOfWeek]}, ${day} ${MONTH_NAMES[month]} ${year}`;
+    case "long":
+      return `${day} ${MONTH_NAMES[month]} ${year}`;
+    case "medium":
+      return `${day} ${MONTH_NAMES_SHORT[month]} ${year}`;
+    case "short": {
+      const dd = String(day).padStart(2, "0");
+      const mm = String(month).padStart(2, "0");
+      return `${dd}/${mm}/${year}`;
+    }
+    case "weekday":
+      return DAY_NAMES[dayOfWeek];
+    case "month":
+      return MONTH_NAMES[month];
+    default:
+      throw new InvalidDateError(`Unknown format style: ${style}`);
+  }
+}
+function formatDateRange(start, end, style = "long") {
+  const s = normalizeDate2(start);
+  const e = normalizeDate2(end);
+  if (e.getTime() < s.getTime()) {
+    throw new InvalidDateRangeError();
+  }
+  if (style === "short") {
+    return `${formatDate(s, "short")} - ${formatDate(e, "short")}`;
+  }
+  if (style === "full") {
+    return `${formatDate(s, "full")} - ${formatDate(e, "full")}`;
+  }
+  const sDay = s.getDate();
+  const eDay = e.getDate();
+  const sMonth = s.getMonth() + 1;
+  const eMonth = e.getMonth() + 1;
+  const sYear = s.getFullYear();
+  const eYear = e.getFullYear();
+  if (sDay === eDay && sMonth === eMonth && sYear === eYear) {
+    return formatDate(s, style);
+  }
+  if (sYear !== eYear) {
+    return `${formatDate(s, style)} - ${formatDate(e, style)}`;
+  }
+  if (sMonth !== eMonth) {
+    if (style === "long") {
+      return `${sDay} ${MONTH_NAMES[sMonth]} - ${eDay} ${MONTH_NAMES[eMonth]} ${eYear}`;
+    }
+    return `${sDay} ${MONTH_NAMES_SHORT[sMonth]} - ${eDay} ${MONTH_NAMES_SHORT[eMonth]} ${eYear}`;
+  }
+  if (style === "long") {
+    return `${sDay} - ${eDay} ${MONTH_NAMES[eMonth]} ${eYear}`;
+  }
+  return `${sDay} - ${eDay} ${MONTH_NAMES_SHORT[eMonth]} ${eYear}`;
+}
+
+// src/datetime/relative.ts
+function normalizeDate3(date) {
+  let result;
+  if (date instanceof Date) {
+    result = date;
+  } else if (typeof date === "number") {
+    result = new Date(date);
+  } else if (typeof date === "string") {
+    result = new Date(date);
+  } else {
+    throw new InvalidDateError("Date must be a Date, string, or number");
+  }
+  if (Number.isNaN(result.getTime())) {
+    throw new InvalidDateError(`Unable to parse date: ${String(date)}`);
+  }
+  return result;
+}
+function toRelativeTime(date, baseDate = /* @__PURE__ */ new Date()) {
+  const d = normalizeDate3(date);
+  const base = normalizeDate3(baseDate);
+  const diffMs = d.getTime() - base.getTime();
+  const diffSec = Math.floor(diffMs / 1e3);
+  const diffMin = Math.floor(diffMs / (1e3 * 60));
+  const diffHour = Math.floor(diffMs / (1e3 * 60 * 60));
+  const diffDay = Math.floor(diffMs / (1e3 * 60 * 60 * 24));
+  if (diffMs === 0) {
+    return "Sekarang";
+  }
+  if (diffMs > 0) {
+    if (diffSec < 60) {
+      return "Baru saja";
+    }
+    if (diffMin < 60) {
+      return `${diffMin} menit lagi`;
+    }
+    if (diffHour < 24) {
+      return `${diffHour} jam lagi`;
+    }
+    if (diffHour < 48) {
+      return "Besok";
+    }
+    if (diffDay <= 30) {
+      return `${diffDay} hari lagi`;
+    }
+    return formatDate(d, "long");
+  }
+  const absDiffSec = Math.abs(diffSec);
+  const absDiffMin = Math.abs(diffMin);
+  const absDiffHour = Math.abs(diffHour);
+  const absDiffDay = Math.abs(diffDay);
+  if (absDiffSec < 60) {
+    return "Baru saja";
+  }
+  if (absDiffMin < 60) {
+    return `${absDiffMin} menit yang lalu`;
+  }
+  if (absDiffHour < 24) {
+    return `${absDiffHour} jam yang lalu`;
+  }
+  if (absDiffHour < 48) {
+    return "Kemarin";
+  }
+  if (absDiffDay <= 30) {
+    return `${absDiffDay} hari yang lalu`;
+  }
+  return formatDate(d, "long");
+}
+
+// src/datetime/timezone.ts
+function getIndonesianTimezone(input) {
+  if (typeof input === "number") {
+    if (!Number.isFinite(input) || !Number.isInteger(input)) {
+      return null;
+    }
+    switch (input) {
+      case 7:
+        return "WIB";
+      case 8:
+        return "WITA";
+      case 9:
+        return "WIT";
+      default:
+        return null;
+    }
+  }
+  if (typeof input !== "string") {
+    return null;
+  }
+  const trimmed = input.trim();
+  const offsetMatch = trimmed.match(/^([+-])(\d{2}):?(\d{2})$/);
+  if (offsetMatch) {
+    const sign = offsetMatch[1];
+    const hours = parseInt(offsetMatch[2], 10);
+    const minutes = parseInt(offsetMatch[3], 10);
+    if (sign === "-") {
+      return null;
+    }
+    if (minutes !== 0) {
+      return null;
+    }
+    switch (hours) {
+      case 7:
+        return "WIB";
+      case 8:
+        return "WITA";
+      case 9:
+        return "WIT";
+      default:
+        return null;
+    }
+  }
+  if (TIMEZONE_MAP[trimmed]) {
+    return TIMEZONE_MAP[trimmed];
+  }
+  return null;
+}
+
+exports.DAY_NAMES = DAY_NAMES;
+exports.DAY_NAMES_SHORT = DAY_NAMES_SHORT;
+exports.InvalidDateError = InvalidDateError;
+exports.InvalidDateRangeError = InvalidDateRangeError;
+exports.MONTH_NAMES = MONTH_NAMES;
+exports.MONTH_NAMES_SHORT = MONTH_NAMES_SHORT;
+exports.TIMEZONE_MAP = TIMEZONE_MAP;
+exports.VALID_UTC_OFFSETS = VALID_UTC_OFFSETS;
 exports.addRupiahSymbol = addRupiahSymbol;
 exports.calculateTax = calculateTax;
 exports.capitalize = capitalize2;
 exports.cleanPhoneNumber = cleanPhoneNumber;
 exports.compareStrings = compareStrings;
 exports.contractAbbreviation = contractAbbreviation;
+exports.daysInMonth = daysInMonth;
 exports.expandAbbreviation = expandAbbreviation;
 exports.extractWords = extractWords;
 exports.formatAccounting = formatAccounting;
 exports.formatBirthDate = formatBirthDate;
 exports.formatCompact = formatCompact;
+exports.formatDate = formatDate;
+exports.formatDateRange = formatDateRange;
 exports.formatNIK = formatNIK;
 exports.formatNPWP = formatNPWP;
 exports.formatPhoneNumber = formatPhoneNumber;
@@ -3342,21 +3789,28 @@ exports.generateSmsLink = generateSmsLink;
 exports.generateTelLink = generateTelLink;
 exports.generateWALink = generateWALink;
 exports.getAge = getAge;
+exports.getAgeFromDate = getAge2;
 exports.getEmailInfo = getEmailInfo;
+exports.getIndonesianTimezone = getIndonesianTimezone;
 exports.getOperator = getOperator;
 exports.getRegionFromPlate = getRegionFromPlate;
 exports.isAlay = isAlay;
 exports.isLandlineNumber = isLandlineNumber;
+exports.isLeapYear = isLeapYear;
 exports.isMobileNumber = isMobileNumber;
 exports.isProvider = isProvider;
+exports.isValidDate = isValidDate;
 exports.isValidForBirthDate = isValidForBirthDate;
 exports.isValidForGender = isValidForGender;
+exports.isWeekend = isWeekend;
+exports.isWorkingDay = isWorkingDay;
 exports.maskEmail = maskEmail;
 exports.maskNIK = maskNIK;
 exports.maskNPWP = maskNPWP;
 exports.maskPhoneNumber = maskPhoneNumber;
 exports.normalizeEmail = normalizeEmail;
 exports.normalizeWhitespace = normalizeWhitespace;
+exports.parseDate = parseDate;
 exports.parseNIK = parseNIK;
 exports.parseNPWP = parseNPWP;
 exports.parsePhoneNumber = parsePhoneNumber;
@@ -3372,6 +3826,7 @@ exports.toE164 = toE164;
 exports.toFormal = toFormal;
 exports.toInternational = toInternational;
 exports.toNational = toNational;
+exports.toRelativeTime = toRelativeTime;
 exports.toSentenceCase = toSentenceCase;
 exports.toTitleCase = toTitleCase;
 exports.toWords = toWords;