@indodev/toolkit 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -181,8 +181,17 @@ function maskNIK(nik, options = {}) {
   if (!/^\d{16}$/.test(nik)) {
     return nik;
   }
-  const { start = 4, end = 4, char = "*", separator } = options;
-  if (start + end >= 16) {
+  const { visibleStart, visibleEnd, maskChar, separator, start, end, char } = options;
+  const hasLegacyOptions = start !== void 0 || end !== void 0 || char !== void 0;
+  if (hasLegacyOptions) {
+    console.warn(
+      "[DEPRECATED] Mask options start/end/char are deprecated. Use visibleStart/visibleEnd/maskChar instead. These old names will be removed in v1.0.0."
+    );
+  }
+  const effectiveStart = visibleStart !== void 0 ? visibleStart : start !== void 0 ? start : 4;
+  const effectiveEnd = visibleEnd !== void 0 ? visibleEnd : end !== void 0 ? end : 4;
+  const effectiveChar = maskChar !== void 0 ? maskChar : char !== void 0 ? char : "*";
+  if (effectiveStart + effectiveEnd >= 16) {
     return nik;
   }
   if (separator) {
@@ -193,28 +202,28 @@ function maskNIK(nik, options = {}) {
       const partStart = charCount;
       const partEnd = charCount + part.length;
       charCount += part.length;
-      if (partEnd <= start) {
+      if (partEnd <= effectiveStart) {
         return part;
-      } else if (partStart >= 16 - end) {
+      } else if (partStart >= 16 - effectiveEnd) {
         return part;
-      } else if (partStart >= start && partEnd <= 16 - end) {
-        return char.repeat(part.length);
+      } else if (partStart >= effectiveStart && partEnd <= 16 - effectiveEnd) {
+        return effectiveChar.repeat(part.length);
       } else {
         return part.split("").map((ch, idx) => {
           const pos = partStart + idx;
-          if (pos < start || pos >= 16 - end) {
+          if (pos < effectiveStart || pos >= 16 - effectiveEnd) {
             return ch;
           }
-          return char;
+          return effectiveChar;
         }).join("");
       }
     });
     return maskedParts.join(separator);
   }
-  const startPart = nik.substring(0, start);
-  const endPart = nik.substring(16 - end);
-  const maskLength = 16 - start - end;
-  return startPart + char.repeat(maskLength) + endPart;
+  const startPart = nik.substring(0, effectiveStart);
+  const endPart = nik.substring(16 - effectiveEnd);
+  const maskLength = 16 - effectiveStart - effectiveEnd;
+  return startPart + effectiveChar.repeat(maskLength) + endPart;
 }
 
 // src/nik/utils.ts
@@ -934,28 +943,42 @@ function maskPhoneNumber(phone, options = {}) {
   if (toMask.length < 4) {
     return phone;
   }
-  const { char = "*", separator } = options;
-  let { start = 4, end = 4 } = options;
-  if (start + end >= toMask.length) {
+  const { maskChar, separator, visibleStart, visibleEnd, start, end, char } = options;
+  const hasLegacyOptions = start !== void 0 || end !== void 0 || char !== void 0;
+  if (hasLegacyOptions) {
+    console.warn(
+      "[DEPRECATED] Mask options start/end/char are deprecated. Use visibleStart/visibleEnd/maskChar instead. These old names will be removed in v1.0.0."
+    );
+  }
+  const effectiveStart = visibleStart !== void 0 ? visibleStart : start !== void 0 ? start : 4;
+  const effectiveEnd = visibleEnd !== void 0 ? visibleEnd : end !== void 0 ? end : 4;
+  const effectiveChar = maskChar !== void 0 ? maskChar : char !== void 0 ? char : "*";
+  if (effectiveStart + effectiveEnd >= 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;
+        const newStart = Math.floor(availableForVisible / 2);
+        const newEnd = availableForVisible - newStart;
+        const startPart2 = toMask.substring(0, newStart);
+        const endPart2 = toMask.substring(toMask.length - newEnd);
+        const masked2 = startPart2 + effectiveChar + endPart2;
+        if (separator) {
+          return `${startPart2}${separator}${effectiveChar}${separator}${endPart2}`;
+        }
+        return masked2;
       } else {
         return toMask;
       }
-    } else {
-      return toMask;
     }
+    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;
+  const startPart = toMask.substring(0, effectiveStart);
+  const endPart = toMask.substring(toMask.length - effectiveEnd);
+  const maskLength = toMask.length - effectiveStart - effectiveEnd;
+  const masked = startPart + effectiveChar.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.substring(0, effectiveStart)}${separator}${masked.substring(effectiveStart, masked.length - effectiveEnd)}${separator}${masked.substring(masked.length - effectiveEnd)}`;
   }
   return masked;
 }
@@ -1047,6 +1070,15 @@ function isProvider(phone, providerName) {
   return operator.toLowerCase() === providerName.toLowerCase();
 }
 
+// src/phone/errors.ts
+var InvalidPhoneError = class extends Error {
+  constructor(message = "Invalid phone number provided") {
+    super(message);
+    this.code = "INVALID_PHONE";
+    this.name = "InvalidPhoneError";
+  }
+};
+
 // src/npwp/validate.ts
 function validateNPWP(npwp) {
   if (!npwp || typeof npwp !== "string") {
@@ -1134,6 +1166,15 @@ function maskNPWP(npwp, options) {
   return `${start}${middle}${end}`;
 }
 
+// src/npwp/errors.ts
+var InvalidNPWPError = class extends Error {
+  constructor(message = "Invalid NPWP provided") {
+    super(message);
+    this.code = "INVALID_NPWP";
+    this.name = "InvalidNPWPError";
+  }
+};
+
 // src/plate/regions.ts
 var PLATE_REGIONS = {
   A: "Banten",
@@ -1225,6 +1266,61 @@ function formatPlate(plate) {
   return `${match[1]} ${match[2]} ${match[3]}`;
 }
 
+// src/plate/errors.ts
+var InvalidPlateError = class extends Error {
+  constructor(message = "Invalid plate provided") {
+    super(message);
+    this.code = "INVALID_PLATE";
+    this.name = "InvalidPlateError";
+  }
+};
+
+// src/plate/parse.ts
+function parsePlate(plate) {
+  if (!plate || typeof plate !== "string") {
+    return null;
+  }
+  const cleaned = plate.replace(/\s+/g, "").toUpperCase();
+  const privatePlateRegex = /^[A-Z]{1,2}\d{1,4}[A-Z]{1,3}$/;
+  const publicPlateRegex = /^[A-Z]{1,2}\d{1,4}[A-Z]{0,3}$/;
+  if (!privatePlateRegex.test(cleaned) && !publicPlateRegex.test(cleaned)) {
+    return null;
+  }
+  const isValid = validatePlate(plate);
+  const match = cleaned.match(/^([A-Z]{1,2})(\d{1,4})([A-Z]{0,3})$/);
+  if (!match) {
+    return null;
+  }
+  const prefix = match[1];
+  const number = match[2];
+  const suffix = match[3] || "";
+  const type = determinePlateType(cleaned);
+  return {
+    prefix,
+    number,
+    suffix,
+    type,
+    formatted: formatPlate(plate),
+    isValid
+  };
+}
+function determinePlateType(plate) {
+  const cleaned = plate.replace(/\s+/g, "").toUpperCase();
+  if (cleaned.startsWith("CD") || cleaned.startsWith("CC") || cleaned.startsWith("KL")) {
+    return "diplomat";
+  }
+  if (/^[A-Z]{1,2}\d{1,4}[A-Z]{0,3}$/.test(cleaned)) {
+    const numDigits = cleaned.match(/\d+/)?.[0].length || 0;
+    if (numDigits <= 4) {
+      return "private";
+    }
+  }
+  if (/^[A-Z]{1,2}\d{1,4}[A-Z]{0,3}$/.test(cleaned)) {
+    return "public";
+  }
+  return null;
+}
+
 // src/vin/constants.ts
 var VIN_LENGTH = 17;
 var VIN_CHECK_DIGIT_INDEX = 8;
@@ -1295,6 +1391,68 @@ function validateVIN(vin) {
   return actualCheckDigit === expectedCheckDigit;
 }
 
+// src/vin/errors.ts
+var InvalidVINError = class extends Error {
+  constructor(message = "Invalid VIN provided") {
+    super(message);
+    this.code = "INVALID_VIN";
+    this.name = "InvalidVINError";
+  }
+};
+
+// src/vin/parse.ts
+function parseVIN(vin) {
+  if (!vin || typeof vin !== "string") {
+    return null;
+  }
+  const normalizedVIN = vin.toUpperCase();
+  if (normalizedVIN.length !== VIN_LENGTH) {
+    return null;
+  }
+  for (const char of EXCLUDED_VIN_CHARS) {
+    if (normalizedVIN.includes(char)) {
+      return null;
+    }
+  }
+  for (const char of normalizedVIN) {
+    if (VIN_CHAR_VALUES[char] === void 0) {
+      return null;
+    }
+  }
+  const isValid = validateCheckDigit(normalizedVIN);
+  const wmi = normalizedVIN.substring(0, 3);
+  const vds = normalizedVIN.substring(3, 9);
+  const checkDigit = normalizedVIN[VIN_CHECK_DIGIT_INDEX];
+  const modelYearCode = normalizedVIN[9];
+  const plantCode = normalizedVIN[10];
+  const serialNumber = normalizedVIN.substring(11, 17);
+  return {
+    wmi,
+    vds,
+    checkDigit,
+    modelYearCode,
+    plantCode,
+    serialNumber,
+    isValid
+  };
+}
+function validateCheckDigit(vin) {
+  let sum = 0;
+  for (let i = 0; i < VIN_LENGTH; i++) {
+    const char = vin[i];
+    const weight = VIN_WEIGHTS[i];
+    const val = VIN_CHAR_VALUES[char];
+    if (val === void 0) {
+      return false;
+    }
+    sum += val * weight;
+  }
+  const checkDigitValue = sum % VIN_MODULUS;
+  const expectedCheckDigit = checkDigitValue === 10 ? VIN_CHECK_DIGIT_X : checkDigitValue.toString();
+  const actualCheckDigit = vin[VIN_CHECK_DIGIT_INDEX];
+  return actualCheckDigit === expectedCheckDigit;
+}
+
 // src/email-validator/constants.ts
 var EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$/;
 var DISPOSABLE_DOMAINS = [
@@ -1368,6 +1526,15 @@ function normalizeEmail(email) {
   return email.trim().toLowerCase();
 }
 
+// src/email-validator/errors.ts
+var InvalidEmailError = class extends Error {
+  constructor(message = "Invalid email provided") {
+    super(message);
+    this.code = "INVALID_EMAIL";
+    this.name = "InvalidEmailError";
+  }
+};
+
 // src/currency/format.ts
 function formatRupiah(amount, options) {
   const {
@@ -3366,6 +3533,78 @@ function similarity(str1, str2) {
   return 1 - distance / maxLength;
 }
 
+// src/text/mask.ts
+function maskText(text, options) {
+  if (!text) return text;
+  const {
+    pattern = "middle",
+    maskChar,
+    visibleStart,
+    visibleEnd,
+    separator,
+    start,
+    end,
+    char
+  } = options || {};
+  const hasLegacyOptions = start !== void 0 || end !== void 0 || char !== void 0;
+  if (hasLegacyOptions) {
+    console.warn(
+      "[DEPRECATED] Mask options start/end/char are deprecated. Use visibleStart/visibleEnd/maskChar instead. These old names will be removed in v1.0.0."
+    );
+  }
+  const effectivePattern = pattern || "middle";
+  const effectiveStart = visibleStart !== void 0 ? visibleStart : start !== void 0 ? start : 2;
+  const effectiveEnd = visibleEnd !== void 0 ? visibleEnd : end !== void 0 ? end : 2;
+  const effectiveChar = maskChar !== void 0 ? maskChar : char !== void 0 ? char : "*";
+  switch (effectivePattern) {
+    case "all":
+      return maskAll(text, effectiveChar);
+    case "email":
+      return maskEmail2(text, effectiveChar);
+    case "middle":
+    default:
+      return maskMiddle(
+        text,
+        effectiveChar,
+        effectiveStart,
+        effectiveEnd,
+        separator
+      );
+  }
+}
+function maskAll(text, maskChar) {
+  return text.split("").map((char) => char === " " ? " " : maskChar).join("");
+}
+function maskMiddle(text, maskChar, visibleStart, visibleEnd, separator) {
+  const length = text.length;
+  const totalVisible = visibleStart + visibleEnd;
+  if (length < totalVisible) {
+    return maskChar.repeat(length);
+  }
+  const start = text.slice(0, visibleStart);
+  const middle = maskChar.repeat(length - totalVisible);
+  const end = text.slice(length - visibleEnd);
+  if (separator) {
+    return `${start}${separator}${middle}${separator}${end}`;
+  }
+  return start + middle + end;
+}
+function maskEmail2(text, maskChar) {
+  const atIndex = text.indexOf("@");
+  if (atIndex === -1) {
+    return maskMiddle(text, maskChar, 2, 0);
+  }
+  const localPart = text.slice(0, atIndex);
+  const domain = text.slice(atIndex);
+  if (localPart.length <= 2) {
+    const maskedLocal2 = localPart + maskChar.repeat(Math.max(0, 2 - localPart.length));
+    return maskedLocal2 + domain;
+  }
+  const visibleLocal = localPart.slice(0, 2);
+  const maskedLocal = visibleLocal + maskChar.repeat(localPart.length - 2);
+  return maskedLocal + domain;
+}
+
 // src/datetime/types.ts
 var InvalidDateError = class extends Error {
   constructor(message = "Invalid date provided") {
@@ -3789,6 +4028,11 @@ exports.DAY_NAMES = DAY_NAMES;
 exports.DAY_NAMES_SHORT = DAY_NAMES_SHORT;
 exports.InvalidDateError = InvalidDateError;
 exports.InvalidDateRangeError = InvalidDateRangeError;
+exports.InvalidEmailError = InvalidEmailError;
+exports.InvalidNPWPError = InvalidNPWPError;
+exports.InvalidPhoneError = InvalidPhoneError;
+exports.InvalidPlateError = InvalidPlateError;
+exports.InvalidVINError = InvalidVINError;
 exports.MONTH_NAMES = MONTH_NAMES;
 exports.MONTH_NAMES_SHORT = MONTH_NAMES_SHORT;
 exports.TIMEZONE_MAP = TIMEZONE_MAP;
@@ -3835,13 +4079,16 @@ exports.maskEmail = maskEmail;
 exports.maskNIK = maskNIK;
 exports.maskNPWP = maskNPWP;
 exports.maskPhoneNumber = maskPhoneNumber;
+exports.maskText = maskText;
 exports.normalizeEmail = normalizeEmail;
 exports.normalizeWhitespace = normalizeWhitespace;
 exports.parseDate = parseDate;
 exports.parseNIK = parseNIK;
 exports.parseNPWP = parseNPWP;
 exports.parsePhoneNumber = parsePhoneNumber;
+exports.parsePlate = parsePlate;
 exports.parseRupiah = parseRupiah;
+exports.parseVIN = parseVIN;
 exports.profanityFilter = profanityFilter;
 exports.removeAccents = removeAccents;
 exports.removeStopwords = removeStopwords;