@indodev/toolkit 0.2.0 → 0.3.1

package/dist/nik/index.cjs

@@ -210,7 +210,51 @@ function maskNIK(nik, options = {}) {
   return startPart + char.repeat(maskLength) + endPart;
 }
 
+// src/nik/utils.ts
+function getAge(nik, referenceDate = /* @__PURE__ */ new Date()) {
+  const info = parseNIK(nik);
+  if (!info || !info.birthDate) {
+    return null;
+  }
+  const birthDate = info.birthDate;
+  let age = referenceDate.getFullYear() - birthDate.getFullYear();
+  const m = referenceDate.getMonth() - birthDate.getMonth();
+  if (m < 0 || m === 0 && referenceDate.getDate() < birthDate.getDate()) {
+    age--;
+  }
+  return age;
+}
+function formatBirthDate(nik, options = {
+  day: "numeric",
+  month: "long",
+  year: "numeric"
+}, locale = "id-ID") {
+  const info = parseNIK(nik);
+  if (!info || !info.birthDate) {
+    return null;
+  }
+  return new Intl.DateTimeFormat(locale, options).format(info.birthDate);
+}
+function isValidForGender(nik, gender) {
+  const info = parseNIK(nik);
+  if (!info) {
+    return false;
+  }
+  return info.gender === gender;
+}
+function isValidForBirthDate(nik, birthDate) {
+  const info = parseNIK(nik);
+  if (!info || !info.birthDate) {
+    return false;
+  }
+  return info.birthDate.getFullYear() === birthDate.getFullYear() && info.birthDate.getMonth() === birthDate.getMonth() && info.birthDate.getDate() === birthDate.getDate();
+}
+
+exports.formatBirthDate = formatBirthDate;
 exports.formatNIK = formatNIK;
+exports.getAge = getAge;
+exports.isValidForBirthDate = isValidForBirthDate;
+exports.isValidForGender = isValidForGender;
 exports.maskNIK = maskNIK;
 exports.parseNIK = parseNIK;
 exports.validateNIK = validateNIK;

package/dist/nik/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/nik/constants.ts","../../src/nik/validate.ts","../../src/nik/parse.ts","../../src/nik/format.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Indonesian province codes and names\n * Based on Dukcapil Kemendagri data\n */\nexport const PROVINCES: Record<string, string> = {\n  '11': 'Aceh',\n  '12': 'Sumatera Utara',\n  '13': 'Sumatera Barat',\n  '14': 'Riau',\n  '15': 'Jambi',\n  '16': 'Sumatera Selatan',\n  '17': 'Bengkulu',\n  '18': 'Lampung',\n  '19': 'Kepulauan Bangka Belitung',\n  '21': 'Kepulauan Riau',\n  '31': 'DKI Jakarta',\n  '32': 'Jawa Barat',\n  '33': 'Jawa Tengah',\n  '34': 'DI Yogyakarta',\n  '35': 'Jawa Timur',\n  '36': 'Banten',\n  '51': 'Bali',\n  '52': 'Nusa Tenggara Barat',\n  '53': 'Nusa Tenggara Timur',\n  '61': 'Kalimantan Barat',\n  '62': 'Kalimantan Tengah',\n  '63': 'Kalimantan Selatan',\n  '64': 'Kalimantan Timur',\n  '65': 'Kalimantan Utara',\n  '71': 'Sulawesi Utara',\n  '72': 'Sulawesi Tengah',\n  '73': 'Sulawesi Selatan',\n  '74': 'Sulawesi Tenggara',\n  '75': 'Gorontalo',\n  '76': 'Sulawesi Barat',\n  '81': 'Maluku',\n  '82': 'Maluku Utara',\n  '91': 'Papua',\n  '92': 'Papua Barat',\n  '93': 'Papua Selatan',\n  '94': 'Papua Tengah',\n  '95': 'Papua Pegunungan',\n  '96': 'Papua Barat Daya',\n};\n\n/**\n * Regency codes for each province (simplified - only major ones)\n * In a real implementation, you'd have complete data\n */\nexport const REGENCIES: Record<string, Record<string, string>> = {\n  '32': {\n    '01': 'Kab. Bogor',\n    '02': 'Kab. Sukabumi',\n    '03': 'Kab. Cianjur',\n    '71': 'Kota Bandung',\n    '72': 'Kota Bekasi',\n    '73': 'Kota Depok',\n  },\n  '31': { \n    '01': 'Kota Jakarta Selatan',\n    '02': 'Kota Jakarta Timur',\n    '03': 'Kota Jakarta Pusat',\n    '04': 'Kota Jakarta Barat',\n    '05': 'Kota Jakarta Utara',\n  },\n};","import { PROVINCES } from './constants';\n\n/**\n * Validates a NIK (Nomor Induk Kependudukan) format.\n *\n * A valid NIK must:\n * - Be exactly 16 digits\n * - Have a valid province code (positions 1-2)\n * - Have a valid date (positions 7-12)\n * - Not be in the future\n * - Not be before 1900\n *\n * For female NIKs, the day is encoded as (actual day + 40).\n * For example, a female born on the 15th would have day = 55.\n *\n * @param nik - The 16-digit NIK string to validate\n * @returns `true` if the NIK is valid, `false` otherwise\n *\n * @example\n * ```typescript\n * validateNIK('3201234567890123'); // true - valid NIK\n * validateNIK('1234'); // false - wrong length\n * validateNIK('9912345678901234'); // false - invalid province\n * ```\n *\n * @public\n */\nexport function validateNIK(nik: string): boolean {\n  if (!/^\\d{16}$/.test(nik)) {\n    return false;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  if (!PROVINCES[provinceCode]) {\n    return false;\n  }\n\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n\n  const year = parseInt(yearStr, 10);\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const month = parseInt(monthStr, 10);\n  let day = parseInt(dayStr, 10);\n\n  if (day > 40) {\n    day = day - 40;\n  }\n\n  if (month < 1 || month > 12) {\n    return false;\n  }\n\n  if (day < 1 || day > 31) {\n    return false;\n  }\n\n  const testDate = new Date(fullYear, month - 1, day);\n  if (\n    testDate.getFullYear() !== fullYear ||\n    testDate.getMonth() !== month - 1 ||\n    testDate.getDate() !== day\n  ) {\n    return false;\n  }\n\n  const now = new Date();\n  if (testDate > now || testDate < new Date(1900, 0, 1)) {\n    return false;\n  }\n\n  return true;\n}\n","import { PROVINCES, REGENCIES } from './constants';\nimport { NIKInfo } from './types';\n\n/**\n * Parses a NIK and extracts all embedded information.\n *\n * Extracts province, regency, district codes, birth date, gender,\n * and serial number from a 16-digit NIK string.\n *\n * @param nik - The 16-digit NIK string to parse\n * @returns Parsed NIK information, or `null` if the NIK format is invalid\n *\n * @example\n * Parse a valid male NIK:\n * ```typescript\n * const info = parseNIK('3201018901310123');\n * console.log(info);\n * // {\n * //   province: { code: '32', name: 'Jawa Barat' },\n * //   regency: { code: '01', name: 'Kab. Bogor' },\n * //   district: { code: '01', name: null },\n * //   birthDate: Date(1989, 0, 31), // Jan 31, 1989\n * //   gender: 'male',\n * //   serialNumber: '0123',\n * //   isValid: true\n * // }\n * ```\n *\n * @example\n * Parse a female NIK (day + 40):\n * ```typescript\n * const info = parseNIK('3201019508550123');\n * console.log(info.gender); // 'female'\n * console.log(info.birthDate); // Date(1995, 7, 15) - Aug 15, 1995\n * ```\n *\n * @example\n * Invalid NIK returns null:\n * ```typescript\n * const info = parseNIK('invalid');\n * console.log(info); // null\n * ```\n *\n * @public\n */\nexport function parseNIK(nik: string): NIKInfo | null {\n  if (!/^\\d{16}$/.test(nik)) {\n    return null;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  const regencyCode = nik.substring(2, 4);\n  const districtCode = nik.substring(4, 6);\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n  const serialNumber = nik.substring(12, 16);\n\n  const province = PROVINCES[provinceCode];\n  if (!province) {\n    return null;\n  }\n\n  const regencies = REGENCIES[provinceCode] || {};\n  const regency = regencies[regencyCode] || 'Unknown';\n\n  let day = parseInt(dayStr, 10);\n  const month = parseInt(monthStr, 10);\n  const year = parseInt(yearStr, 10);\n\n  let gender: 'male' | 'female' | null = null;\n  if (day > 40) {\n    gender = 'female';\n    day -= 40;\n  } else {\n    gender = 'male';\n  }\n\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const birthDate = new Date(fullYear, month - 1, day);\n  if (\n    birthDate.getFullYear() !== fullYear ||\n    birthDate.getMonth() !== month - 1 ||\n    birthDate.getDate() !== day\n  ) {\n    return null;\n  }\n\n  return {\n    province: {\n      code: provinceCode,\n      name: province,\n    },\n    regency: {\n      code: regencyCode,\n      name: regency,\n    },\n    district: {\n      code: districtCode,\n      name: null,\n    },\n    birthDate,\n    gender,\n    serialNumber,\n    isValid: true,\n  };\n}","import { MaskOptions } from './types';\n\n/**\n * Formats a NIK with separators for better readability.\n *\n * Groups the NIK into logical segments: province, regency, district,\n * year, month, day, and serial number.\n *\n * @param nik - The 16-digit NIK string to format\n * @param separator - Character to use as separator\n * @returns Formatted NIK string, or original string if invalid format\n *\n * @example\n * Default separator (dash):\n * ```typescript\n * formatNIK('3201234567890123');\n * // '32-01-23-45-67-89-0123'\n * ```\n *\n * @example\n * Custom separator:\n * ```typescript\n * formatNIK('3201234567890123', ' ');\n * // '32 01 23 45 67 89 0123'\n * ```\n *\n * @example\n * Invalid NIK returns as-is:\n * ```typescript\n * formatNIK('1234');\n * // '1234'\n * ```\n *\n * @public\n */\nexport function formatNIK(nik: string, separator: string = '-'): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  // Format: PP-KK-DD-YY-MM-DD-XXXX\n  // PP = Province (2 digits)\n  // KK = Regency (2 digits)\n  // DD = District (2 digits)\n  // YY = Year (2 digits)\n  // MM = Month (2 digits)\n  // DD = Day (2 digits, +40 for female)\n  // XXXX = Serial number (4 digits)\n  return [\n    nik.substring(0, 2), // Province\n    nik.substring(2, 4), // Regency\n    nik.substring(4, 6), // District\n    nik.substring(6, 8), // Year\n    nik.substring(8, 10), // Month\n    nik.substring(10, 12), // Day\n    nik.substring(12, 16), // Serial\n  ].join(separator);\n}\n\n/**\n * Masks a NIK to protect privacy while keeping partial visibility.\n *\n * By default, shows the first 4 and last 4 digits, masking the middle 8.\n * Optionally formats the masked NIK with separators.\n *\n * @param nik - The 16-digit NIK string to mask\n * @param options - Masking configuration options\n * @returns Masked NIK string, or original string if invalid format\n *\n * @example\n * Default masking (first 4, last 4):\n * ```typescript\n * maskNIK('3201234567890123');\n * // '3201********0123'\n * ```\n *\n * @example\n * Custom mask character:\n * ```typescript\n * maskNIK('3201234567890123', { char: 'X' });\n * // '3201XXXXXXXX0123'\n * ```\n *\n * @example\n * With separator:\n * ```typescript\n * maskNIK('3201234567890123', { separator: '-' });\n * // '32-01-**-**-**-**-0123'\n * ```\n *\n * @example\n * Custom start and end:\n * ```typescript\n * maskNIK('3201234567890123', { start: 6, end: 4 });\n * // '320123******0123'\n * ```\n *\n * @public\n */\nexport function maskNIK(nik: string, options: MaskOptions = {}): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  const { start = 4, end = 4, char = '*', separator } = options;\n\n  if (start + end >= 16) {\n    return nik;\n  }\n\n  if (separator) {\n    // Format with separator first, then apply masking\n    const formatted = formatNIK(nik, separator);\n    const parts = formatted.split(separator);\n\n    // Calculate which parts to mask\n    // Format: PP-KK-DD-YY-MM-DD-XXXX (7 parts)\n    // Mask parts based on character positions\n    let charCount = 0;\n    const maskedParts = parts.map((part) => {\n      const partStart = charCount;\n      const partEnd = charCount + part.length;\n      charCount += part.length;\n\n      // Check if this part should be fully/partially masked\n      if (partEnd <= start) {\n        // Fully visible (before start)\n        return part;\n      } else if (partStart >= 16 - end) {\n        // Fully visible (after end)\n        return part;\n      } else if (partStart >= start && partEnd <= 16 - end) {\n        // Fully masked\n        return char.repeat(part.length);\n      } else {\n        // Partially masked\n        return part\n          .split('')\n          .map((ch, idx) => {\n            const pos = partStart + idx;\n            if (pos < start || pos >= 16 - end) {\n              return ch;\n            }\n            return char;\n          })\n          .join('');\n      }\n    });\n\n    return maskedParts.join(separator);\n  }\n\n  // Without separator: simple masking\n  const startPart = nik.substring(0, start);\n  const endPart = nik.substring(16 - end);\n  const maskLength = 16 - start - end;\n  return startPart + char.repeat(maskLength) + endPart;\n}"]}
+{"version":3,"sources":["../../src/nik/constants.ts","../../src/nik/validate.ts","../../src/nik/parse.ts","../../src/nik/format.ts","../../src/nik/utils.ts"],"names":[],"mappings":";;;AAIO,IAAM,SAAA,GAAoC;AAAA,EAC/C,IAAA,EAAM,MAAA;AAAA,EACN,IAAA,EAAM,gBAAA;AAAA,EACN,IAAA,EAAM,gBAAA;AAAA,EACN,IAAA,EAAM,MAAA;AAAA,EACN,IAAA,EAAM,OAAA;AAAA,EACN,IAAA,EAAM,kBAAA;AAAA,EACN,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,2BAAA;AAAA,EACN,IAAA,EAAM,gBAAA;AAAA,EACN,IAAA,EAAM,aAAA;AAAA,EACN,IAAA,EAAM,YAAA;AAAA,EACN,IAAA,EAAM,aAAA;AAAA,EACN,IAAA,EAAM,eAAA;AAAA,EACN,IAAA,EAAM,YAAA;AAAA,EACN,IAAA,EAAM,QAAA;AAAA,EACN,IAAA,EAAM,MAAA;AAAA,EACN,IAAA,EAAM,qBAAA;AAAA,EACN,IAAA,EAAM,qBAAA;AAAA,EACN,IAAA,EAAM,kBAAA;AAAA,EACN,IAAA,EAAM,mBAAA;AAAA,EACN,IAAA,EAAM,oBAAA;AAAA,EACN,IAAA,EAAM,kBAAA;AAAA,EACN,IAAA,EAAM,kBAAA;AAAA,EACN,IAAA,EAAM,gBAAA;AAAA,EACN,IAAA,EAAM,iBAAA;AAAA,EACN,IAAA,EAAM,kBAAA;AAAA,EACN,IAAA,EAAM,mBAAA;AAAA,EACN,IAAA,EAAM,WAAA;AAAA,EACN,IAAA,EAAM,gBAAA;AAAA,EACN,IAAA,EAAM,QAAA;AAAA,EACN,IAAA,EAAM,cAAA;AAAA,EACN,IAAA,EAAM,OAAA;AAAA,EACN,IAAA,EAAM,aAAA;AAAA,EACN,IAAA,EAAM,eAAA;AAAA,EACN,IAAA,EAAM,cAAA;AAAA,EACN,IAAA,EAAM,kBAAA;AAAA,EACN,IAAA,EAAM;AACR,CAAA;AAMO,IAAM,SAAA,GAAoD;AAAA,EAC/D,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,YAAA;AAAA,IACN,IAAA,EAAM,eAAA;AAAA,IACN,IAAA,EAAM,cAAA;AAAA,IACN,IAAA,EAAM,cAAA;AAAA,IACN,IAAA,EAAM,aAAA;AAAA,IACN,IAAA,EAAM;AAAA,GACR;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,sBAAA;AAAA,IACN,IAAA,EAAM,oBAAA;AAAA,IACN,IAAA,EAAM,oBAAA;AAAA,IACN,IAAA,EAAM,oBAAA;AAAA,IACN,IAAA,EAAM;AAAA;AAEV,CAAA;;;ACtCO,SAAS,YAAY,GAAA,EAAsB;AAChD,EAAA,IAAI,CAAC,UAAA,CAAW,IAAA,CAAK,GAAG,CAAA,EAAG;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AACvC,EAAA,IAAI,CAAC,SAAA,CAAU,YAAY,CAAA,EAAG;AAC5B,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AAClC,EAAA,MAAM,QAAA,GAAW,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,EAAE,CAAA;AACpC,EAAA,MAAM,MAAA,GAAS,GAAA,CAAI,SAAA,CAAU,EAAA,EAAI,EAAE,CAAA;AAEnC,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,OAAA,EAAS,EAAE,CAAA;AACjC,EAAA,MAAM,QAAA,GAAW,IAAA,GAAO,EAAA,GAAK,IAAA,GAAO,OAAO,GAAA,GAAO,IAAA;AAElD,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,QAAA,EAAU,EAAE,CAAA;AACnC,EAAA,IAAI,GAAA,GAAM,QAAA,CAAS,MAAA,EAAQ,EAAE,CAAA;AAE7B,EAAA,IAAI,MAAM,EAAA,EAAI;AACZ,IAAA,GAAA,GAAM,GAAA,GAAM,EAAA;AAAA,EACd;AAEA,EAAA,IAAI,KAAA,GAAQ,CAAA,IAAK,KAAA,GAAQ,EAAA,EAAI;AAC3B,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,GAAA,GAAM,CAAA,IAAK,GAAA,GAAM,EAAA,EAAI;AACvB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,WAAW,IAAI,IAAA,CAAK,QAAA,EAAU,KAAA,GAAQ,GAAG,GAAG,CAAA;AAClD,EAAA,IACE,QAAA,CAAS,WAAA,EAAY,KAAM,QAAA,IAC3B,QAAA,CAAS,QAAA,EAAS,KAAM,KAAA,GAAQ,CAAA,IAChC,QAAA,CAAS,OAAA,EAAQ,KAAM,GAAA,EACvB;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,GAAA,uBAAU,IAAA,EAAK;AACrB,EAAA,IAAI,QAAA,GAAW,OAAO,QAAA,GAAW,IAAI,KAAK,IAAA,EAAM,CAAA,EAAG,CAAC,CAAA,EAAG;AACrD,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA;AACT;;;AC7BO,SAAS,SAAS,GAAA,EAA6B;AACpD,EAAA,IAAI,CAAC,UAAA,CAAW,IAAA,CAAK,GAAG,CAAA,EAAG;AACzB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AACvC,EAAA,MAAM,WAAA,GAAc,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AACtC,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AACvC,EAAA,MAAM,OAAA,GAAU,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AAClC,EAAA,MAAM,QAAA,GAAW,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,EAAE,CAAA;AACpC,EAAA,MAAM,MAAA,GAAS,GAAA,CAAI,SAAA,CAAU,EAAA,EAAI,EAAE,CAAA;AACnC,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,SAAA,CAAU,EAAA,EAAI,EAAE,CAAA;AAEzC,EAAA,MAAM,QAAA,GAAW,UAAU,YAAY,CAAA;AACvC,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,YAAY,CAAA,IAAK,EAAC;AAC9C,EAAA,MAAM,OAAA,GAAU,SAAA,CAAU,WAAW,CAAA,IAAK,SAAA;AAE1C,EAAA,IAAI,GAAA,GAAM,QAAA,CAAS,MAAA,EAAQ,EAAE,CAAA;AAC7B,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,QAAA,EAAU,EAAE,CAAA;AACnC,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,OAAA,EAAS,EAAE,CAAA;AAEjC,EAAA,IAAI,MAAA,GAAmC,IAAA;AACvC,EAAA,IAAI,MAAM,EAAA,EAAI;AACZ,IAAA,MAAA,GAAS,QAAA;AACT,IAAA,GAAA,IAAO,EAAA;AAAA,EACT,CAAA,MAAO;AACL,IAAA,MAAA,GAAS,MAAA;AAAA,EACX;AAEA,EAAA,MAAM,QAAA,GAAW,IAAA,GAAO,EAAA,GAAK,IAAA,GAAO,OAAO,GAAA,GAAO,IAAA;AAElD,EAAA,MAAM,YAAY,IAAI,IAAA,CAAK,QAAA,EAAU,KAAA,GAAQ,GAAG,GAAG,CAAA;AACnD,EAAA,IACE,SAAA,CAAU,WAAA,EAAY,KAAM,QAAA,IAC5B,SAAA,CAAU,QAAA,EAAS,KAAM,KAAA,GAAQ,CAAA,IACjC,SAAA,CAAU,OAAA,EAAQ,KAAM,GAAA,EACxB;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,QAAA,EAAU;AAAA,MACR,IAAA,EAAM,YAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACR;AAAA,IACA,OAAA,EAAS;AAAA,MACP,IAAA,EAAM,WAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACR;AAAA,IACA,QAAA,EAAU;AAAA,MACR,IAAA,EAAM,YAAA;AAAA,MACN,IAAA,EAAM;AAAA,KACR;AAAA,IACA,SAAA;AAAA,IACA,MAAA;AAAA,IACA,YAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AACF;;;ACxEO,SAAS,SAAA,CAAU,GAAA,EAAa,SAAA,GAAoB,GAAA,EAAa;AACtE,EAAA,IAAI,CAAC,UAAA,CAAW,IAAA,CAAK,GAAG,CAAA,EAAG;AACzB,IAAA,OAAO,GAAA;AAAA,EACT;AAUA,EAAA,OAAO;AAAA,IACL,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AAAA;AAAA,IAClB,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AAAA;AAAA,IAClB,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AAAA;AAAA,IAClB,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AAAA;AAAA,IAClB,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,EAAE,CAAA;AAAA;AAAA,IACnB,GAAA,CAAI,SAAA,CAAU,EAAA,EAAI,EAAE,CAAA;AAAA;AAAA,IACpB,GAAA,CAAI,SAAA,CAAU,EAAA,EAAI,EAAE;AAAA;AAAA,GACtB,CAAE,KAAK,SAAS,CAAA;AAClB;AA0CO,SAAS,OAAA,CAAQ,GAAA,EAAa,OAAA,GAAuB,EAAC,EAAW;AACtE,EAAA,IAAI,CAAC,UAAA,CAAW,IAAA,CAAK,GAAG,CAAA,EAAG;AACzB,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,MAAM,EAAE,QAAQ,CAAA,EAAG,GAAA,GAAM,GAAG,IAAA,GAAO,GAAA,EAAK,WAAU,GAAI,OAAA;AAEtD,EAAA,IAAI,KAAA,GAAQ,OAAO,EAAA,EAAI;AACrB,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,IAAI,SAAA,EAAW;AAEb,IAAA,MAAM,SAAA,GAAY,SAAA,CAAU,GAAA,EAAK,SAAS,CAAA;AAC1C,IAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,KAAA,CAAM,SAAS,CAAA;AAKvC,IAAA,IAAI,SAAA,GAAY,CAAA;AAChB,IAAA,MAAM,WAAA,GAAc,KAAA,CAAM,GAAA,CAAI,CAAC,IAAA,KAAS;AACtC,MAAA,MAAM,SAAA,GAAY,SAAA;AAClB,MAAA,MAAM,OAAA,GAAU,YAAY,IAAA,CAAK,MAAA;AACjC,MAAA,SAAA,IAAa,IAAA,CAAK,MAAA;AAGlB,MAAA,IAAI,WAAW,KAAA,EAAO;AAEpB,QAAA,OAAO,IAAA;AAAA,MACT,CAAA,MAAA,IAAW,SAAA,IAAa,EAAA,GAAK,GAAA,EAAK;AAEhC,QAAA,OAAO,IAAA;AAAA,MACT,CAAA,MAAA,IAAW,SAAA,IAAa,KAAA,IAAS,OAAA,IAAW,KAAK,GAAA,EAAK;AAEpD,QAAA,OAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA;AAAA,MAChC,CAAA,MAAO;AAEL,QAAA,OAAO,KACJ,KAAA,CAAM,EAAE,EACR,GAAA,CAAI,CAAC,IAAI,GAAA,KAAQ;AAChB,UAAA,MAAM,MAAM,SAAA,GAAY,GAAA;AACxB,UAAA,IAAI,GAAA,GAAM,KAAA,IAAS,GAAA,IAAO,EAAA,GAAK,GAAA,EAAK;AAClC,YAAA,OAAO,EAAA;AAAA,UACT;AACA,UAAA,OAAO,IAAA;AAAA,QACT,CAAC,CAAA,CACA,IAAA,CAAK,EAAE,CAAA;AAAA,MACZ;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAO,WAAA,CAAY,KAAK,SAAS,CAAA;AAAA,EACnC;AAGA,EAAA,MAAM,SAAA,GAAY,GAAA,CAAI,SAAA,CAAU,CAAA,EAAG,KAAK,CAAA;AACxC,EAAA,MAAM,OAAA,GAAU,GAAA,CAAI,SAAA,CAAU,EAAA,GAAK,GAAG,CAAA;AACtC,EAAA,MAAM,UAAA,GAAa,KAAK,KAAA,GAAQ,GAAA;AAChC,EAAA,OAAO,SAAA,GAAY,IAAA,CAAK,MAAA,CAAO,UAAU,CAAA,GAAI,OAAA;AAC/C;;;AC/IO,SAAS,MAAA,CACd,GAAA,EACA,aAAA,mBAAsB,IAAI,MAAK,EAChB;AACf,EAAA,MAAM,IAAA,GAAO,SAAS,GAAG,CAAA;AACzB,EAAA,IAAI,CAAC,IAAA,IAAQ,CAAC,IAAA,CAAK,SAAA,EAAW;AAC5B,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,YAAY,IAAA,CAAK,SAAA;AACvB,EAAA,IAAI,GAAA,GAAM,aAAA,CAAc,WAAA,EAAY,GAAI,UAAU,WAAA,EAAY;AAC9D,EAAA,MAAM,CAAA,GAAI,aAAA,CAAc,QAAA,EAAS,GAAI,UAAU,QAAA,EAAS;AAExD,EAAA,IAAI,CAAA,GAAI,KAAM,CAAA,KAAM,CAAA,IAAK,cAAc,OAAA,EAAQ,GAAI,SAAA,CAAU,OAAA,EAAQ,EAAI;AACvE,IAAA,GAAA,EAAA;AAAA,EACF;AAEA,EAAA,OAAO,GAAA;AACT;AAcO,SAAS,eAAA,CACd,KACA,OAAA,GAAsC;AAAA,EACpC,GAAA,EAAK,SAAA;AAAA,EACL,KAAA,EAAO,MAAA;AAAA,EACP,IAAA,EAAM;AACR,CAAA,EACA,SAAiB,OAAA,EACF;AACf,EAAA,MAAM,IAAA,GAAO,SAAS,GAAG,CAAA;AACzB,EAAA,IAAI,CAAC,IAAA,IAAQ,CAAC,IAAA,CAAK,SAAA,EAAW;AAC5B,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAI,KAAK,cAAA,CAAe,MAAA,EAAQ,OAAO,CAAA,CAAE,MAAA,CAAO,KAAK,SAAS,CAAA;AACvE;AASO,SAAS,gBAAA,CACd,KACA,MAAA,EACS;AACT,EAAA,MAAM,IAAA,GAAO,SAAS,GAAG,CAAA;AACzB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAK,MAAA,KAAW,MAAA;AACzB;AASO,SAAS,mBAAA,CAAoB,KAAa,SAAA,EAA0B;AACzE,EAAA,MAAM,IAAA,GAAO,SAAS,GAAG,CAAA;AACzB,EAAA,IAAI,CAAC,IAAA,IAAQ,CAAC,IAAA,CAAK,SAAA,EAAW;AAC5B,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,OACE,KAAK,SAAA,CAAU,WAAA,OAAkB,SAAA,CAAU,WAAA,MAC3C,IAAA,CAAK,SAAA,CAAU,UAAS,KAAM,SAAA,CAAU,UAAS,IACjD,IAAA,CAAK,UAAU,OAAA,EAAQ,KAAM,UAAU,OAAA,EAAQ;AAEnD","file":"index.cjs","sourcesContent":["/**\n * Indonesian province codes and names\n * Based on Dukcapil Kemendagri data\n */\nexport const PROVINCES: Record<string, string> = {\n  '11': 'Aceh',\n  '12': 'Sumatera Utara',\n  '13': 'Sumatera Barat',\n  '14': 'Riau',\n  '15': 'Jambi',\n  '16': 'Sumatera Selatan',\n  '17': 'Bengkulu',\n  '18': 'Lampung',\n  '19': 'Kepulauan Bangka Belitung',\n  '21': 'Kepulauan Riau',\n  '31': 'DKI Jakarta',\n  '32': 'Jawa Barat',\n  '33': 'Jawa Tengah',\n  '34': 'DI Yogyakarta',\n  '35': 'Jawa Timur',\n  '36': 'Banten',\n  '51': 'Bali',\n  '52': 'Nusa Tenggara Barat',\n  '53': 'Nusa Tenggara Timur',\n  '61': 'Kalimantan Barat',\n  '62': 'Kalimantan Tengah',\n  '63': 'Kalimantan Selatan',\n  '64': 'Kalimantan Timur',\n  '65': 'Kalimantan Utara',\n  '71': 'Sulawesi Utara',\n  '72': 'Sulawesi Tengah',\n  '73': 'Sulawesi Selatan',\n  '74': 'Sulawesi Tenggara',\n  '75': 'Gorontalo',\n  '76': 'Sulawesi Barat',\n  '81': 'Maluku',\n  '82': 'Maluku Utara',\n  '91': 'Papua',\n  '92': 'Papua Barat',\n  '93': 'Papua Selatan',\n  '94': 'Papua Tengah',\n  '95': 'Papua Pegunungan',\n  '96': 'Papua Barat Daya',\n};\n\n/**\n * Regency codes for each province (simplified - only major ones)\n * In a real implementation, you'd have complete data\n */\nexport const REGENCIES: Record<string, Record<string, string>> = {\n  '32': {\n    '01': 'Kab. Bogor',\n    '02': 'Kab. Sukabumi',\n    '03': 'Kab. Cianjur',\n    '71': 'Kota Bandung',\n    '72': 'Kota Bekasi',\n    '73': 'Kota Depok',\n  },\n  '31': { \n    '01': 'Kota Jakarta Selatan',\n    '02': 'Kota Jakarta Timur',\n    '03': 'Kota Jakarta Pusat',\n    '04': 'Kota Jakarta Barat',\n    '05': 'Kota Jakarta Utara',\n  },\n};","import { PROVINCES } from './constants';\n\n/**\n * Validates a NIK (Nomor Induk Kependudukan) format.\n *\n * A valid NIK must:\n * - Be exactly 16 digits\n * - Have a valid province code (positions 1-2)\n * - Have a valid date (positions 7-12)\n * - Not be in the future\n * - Not be before 1900\n *\n * For female NIKs, the day is encoded as (actual day + 40).\n * For example, a female born on the 15th would have day = 55.\n *\n * @param nik - The 16-digit NIK string to validate\n * @returns `true` if the NIK is valid, `false` otherwise\n *\n * @example\n * ```typescript\n * validateNIK('3201234567890123'); // true - valid NIK\n * validateNIK('1234'); // false - wrong length\n * validateNIK('9912345678901234'); // false - invalid province\n * ```\n *\n * @public\n */\nexport function validateNIK(nik: string): boolean {\n  if (!/^\\d{16}$/.test(nik)) {\n    return false;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  if (!PROVINCES[provinceCode]) {\n    return false;\n  }\n\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n\n  const year = parseInt(yearStr, 10);\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const month = parseInt(monthStr, 10);\n  let day = parseInt(dayStr, 10);\n\n  if (day > 40) {\n    day = day - 40;\n  }\n\n  if (month < 1 || month > 12) {\n    return false;\n  }\n\n  if (day < 1 || day > 31) {\n    return false;\n  }\n\n  const testDate = new Date(fullYear, month - 1, day);\n  if (\n    testDate.getFullYear() !== fullYear ||\n    testDate.getMonth() !== month - 1 ||\n    testDate.getDate() !== day\n  ) {\n    return false;\n  }\n\n  const now = new Date();\n  if (testDate > now || testDate < new Date(1900, 0, 1)) {\n    return false;\n  }\n\n  return true;\n}\n","import { PROVINCES, REGENCIES } from './constants';\nimport { NIKInfo } from './types';\n\n/**\n * Parses a NIK and extracts all embedded information.\n *\n * Extracts province, regency, district codes, birth date, gender,\n * and serial number from a 16-digit NIK string.\n *\n * @param nik - The 16-digit NIK string to parse\n * @returns Parsed NIK information, or `null` if the NIK format is invalid\n *\n * @example\n * Parse a valid male NIK:\n * ```typescript\n * const info = parseNIK('3201018901310123');\n * console.log(info);\n * // {\n * //   province: { code: '32', name: 'Jawa Barat' },\n * //   regency: { code: '01', name: 'Kab. Bogor' },\n * //   district: { code: '01', name: null },\n * //   birthDate: Date(1989, 0, 31), // Jan 31, 1989\n * //   gender: 'male',\n * //   serialNumber: '0123',\n * //   isValid: true\n * // }\n * ```\n *\n * @example\n * Parse a female NIK (day + 40):\n * ```typescript\n * const info = parseNIK('3201019508550123');\n * console.log(info.gender); // 'female'\n * console.log(info.birthDate); // Date(1995, 7, 15) - Aug 15, 1995\n * ```\n *\n * @example\n * Invalid NIK returns null:\n * ```typescript\n * const info = parseNIK('invalid');\n * console.log(info); // null\n * ```\n *\n * @public\n */\nexport function parseNIK(nik: string): NIKInfo | null {\n  if (!/^\\d{16}$/.test(nik)) {\n    return null;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  const regencyCode = nik.substring(2, 4);\n  const districtCode = nik.substring(4, 6);\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n  const serialNumber = nik.substring(12, 16);\n\n  const province = PROVINCES[provinceCode];\n  if (!province) {\n    return null;\n  }\n\n  const regencies = REGENCIES[provinceCode] || {};\n  const regency = regencies[regencyCode] || 'Unknown';\n\n  let day = parseInt(dayStr, 10);\n  const month = parseInt(monthStr, 10);\n  const year = parseInt(yearStr, 10);\n\n  let gender: 'male' | 'female' | null = null;\n  if (day > 40) {\n    gender = 'female';\n    day -= 40;\n  } else {\n    gender = 'male';\n  }\n\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const birthDate = new Date(fullYear, month - 1, day);\n  if (\n    birthDate.getFullYear() !== fullYear ||\n    birthDate.getMonth() !== month - 1 ||\n    birthDate.getDate() !== day\n  ) {\n    return null;\n  }\n\n  return {\n    province: {\n      code: provinceCode,\n      name: province,\n    },\n    regency: {\n      code: regencyCode,\n      name: regency,\n    },\n    district: {\n      code: districtCode,\n      name: null,\n    },\n    birthDate,\n    gender,\n    serialNumber,\n    isValid: true,\n  };\n}","import { MaskOptions } from './types';\n\n/**\n * Formats a NIK with separators for better readability.\n *\n * Groups the NIK into logical segments: province, regency, district,\n * year, month, day, and serial number.\n *\n * @param nik - The 16-digit NIK string to format\n * @param separator - Character to use as separator\n * @returns Formatted NIK string, or original string if invalid format\n *\n * @example\n * Default separator (dash):\n * ```typescript\n * formatNIK('3201234567890123');\n * // '32-01-23-45-67-89-0123'\n * ```\n *\n * @example\n * Custom separator:\n * ```typescript\n * formatNIK('3201234567890123', ' ');\n * // '32 01 23 45 67 89 0123'\n * ```\n *\n * @example\n * Invalid NIK returns as-is:\n * ```typescript\n * formatNIK('1234');\n * // '1234'\n * ```\n *\n * @public\n */\nexport function formatNIK(nik: string, separator: string = '-'): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  // Format: PP-KK-DD-YY-MM-DD-XXXX\n  // PP = Province (2 digits)\n  // KK = Regency (2 digits)\n  // DD = District (2 digits)\n  // YY = Year (2 digits)\n  // MM = Month (2 digits)\n  // DD = Day (2 digits, +40 for female)\n  // XXXX = Serial number (4 digits)\n  return [\n    nik.substring(0, 2), // Province\n    nik.substring(2, 4), // Regency\n    nik.substring(4, 6), // District\n    nik.substring(6, 8), // Year\n    nik.substring(8, 10), // Month\n    nik.substring(10, 12), // Day\n    nik.substring(12, 16), // Serial\n  ].join(separator);\n}\n\n/**\n * Masks a NIK to protect privacy while keeping partial visibility.\n *\n * By default, shows the first 4 and last 4 digits, masking the middle 8.\n * Optionally formats the masked NIK with separators.\n *\n * @param nik - The 16-digit NIK string to mask\n * @param options - Masking configuration options\n * @returns Masked NIK string, or original string if invalid format\n *\n * @example\n * Default masking (first 4, last 4):\n * ```typescript\n * maskNIK('3201234567890123');\n * // '3201********0123'\n * ```\n *\n * @example\n * Custom mask character:\n * ```typescript\n * maskNIK('3201234567890123', { char: 'X' });\n * // '3201XXXXXXXX0123'\n * ```\n *\n * @example\n * With separator:\n * ```typescript\n * maskNIK('3201234567890123', { separator: '-' });\n * // '32-01-**-**-**-**-0123'\n * ```\n *\n * @example\n * Custom start and end:\n * ```typescript\n * maskNIK('3201234567890123', { start: 6, end: 4 });\n * // '320123******0123'\n * ```\n *\n * @public\n */\nexport function maskNIK(nik: string, options: MaskOptions = {}): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  const { start = 4, end = 4, char = '*', separator } = options;\n\n  if (start + end >= 16) {\n    return nik;\n  }\n\n  if (separator) {\n    // Format with separator first, then apply masking\n    const formatted = formatNIK(nik, separator);\n    const parts = formatted.split(separator);\n\n    // Calculate which parts to mask\n    // Format: PP-KK-DD-YY-MM-DD-XXXX (7 parts)\n    // Mask parts based on character positions\n    let charCount = 0;\n    const maskedParts = parts.map((part) => {\n      const partStart = charCount;\n      const partEnd = charCount + part.length;\n      charCount += part.length;\n\n      // Check if this part should be fully/partially masked\n      if (partEnd <= start) {\n        // Fully visible (before start)\n        return part;\n      } else if (partStart >= 16 - end) {\n        // Fully visible (after end)\n        return part;\n      } else if (partStart >= start && partEnd <= 16 - end) {\n        // Fully masked\n        return char.repeat(part.length);\n      } else {\n        // Partially masked\n        return part\n          .split('')\n          .map((ch, idx) => {\n            const pos = partStart + idx;\n            if (pos < start || pos >= 16 - end) {\n              return ch;\n            }\n            return char;\n          })\n          .join('');\n      }\n    });\n\n    return maskedParts.join(separator);\n  }\n\n  // Without separator: simple masking\n  const startPart = nik.substring(0, start);\n  const endPart = nik.substring(16 - end);\n  const maskLength = 16 - start - end;\n  return startPart + char.repeat(maskLength) + endPart;\n}","import { parseNIK } from './parse';\n\n/**\n * Calculates the age of a person based on their NIK.\n *\n * @param nik - The 16-digit NIK string\n * @param referenceDate - The date to calculate age from (default: current date)\n * @returns The age in years, or null if the NIK is invalid or birth date cannot be parsed\n *\n * @example\n * ```typescript\n * getAge('3201018901310123'); // 35 (as of 2024)\n * ```\n */\nexport function getAge(\n  nik: string,\n  referenceDate: Date = new Date()\n): number | null {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return null;\n  }\n\n  const birthDate = info.birthDate;\n  let age = referenceDate.getFullYear() - birthDate.getFullYear();\n  const m = referenceDate.getMonth() - birthDate.getMonth();\n\n  if (m < 0 || (m === 0 && referenceDate.getDate() < birthDate.getDate())) {\n    age--;\n  }\n\n  return age;\n}\n\n/**\n * Formats the birth date from a NIK into a human-readable string.\n *\n * @param nik - The 16-digit NIK string\n * @param locale - The locale to use for formatting (default: 'id-ID')\n * @returns Formatted birth date string, or null if invalid\n *\n * @example\n * ```typescript\n * formatBirthDate('3201018901310123'); // '31 Januari 1989'\n * ```\n */\nexport function formatBirthDate(\n  nik: string,\n  options: Intl.DateTimeFormatOptions = {\n    day: 'numeric',\n    month: 'long',\n    year: 'numeric',\n  },\n  locale: string = 'id-ID'\n): string | null {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return null;\n  }\n\n  return new Intl.DateTimeFormat(locale, options).format(info.birthDate);\n}\n\n/**\n * Checks if a NIK matches a specific gender.\n *\n * @param nik - The 16-digit NIK string\n * @param gender - The gender to check ('male' | 'female')\n * @returns True if the NIK matches the gender, false otherwise\n */\nexport function isValidForGender(\n  nik: string,\n  gender: 'male' | 'female'\n): boolean {\n  const info = parseNIK(nik);\n  if (!info) {\n    return false;\n  }\n  return info.gender === gender;\n}\n\n/**\n * Checks if a NIK matches a specific birth date.\n *\n * @param nik - The 16-digit NIK string\n * @param birthDate - The birth date to check\n * @returns True if the NIK matches the birth date, false otherwise\n */\nexport function isValidForBirthDate(nik: string, birthDate: Date): boolean {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return false;\n  }\n\n  return (\n    info.birthDate.getFullYear() === birthDate.getFullYear() &&\n    info.birthDate.getMonth() === birthDate.getMonth() &&\n    info.birthDate.getDate() === birthDate.getDate()\n  );\n}\n"]}

package/dist/nik/index.d.cts

@@ -285,4 +285,47 @@ declare function formatNIK(nik: string, separator?: string): string;
  */
 declare function maskNIK(nik: string, options?: MaskOptions): string;
 
-export { type MaskOptions, type NIKInfo, formatNIK, maskNIK, parseNIK, validateNIK };
+/**
+ * Calculates the age of a person based on their NIK.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param referenceDate - The date to calculate age from (default: current date)
+ * @returns The age in years, or null if the NIK is invalid or birth date cannot be parsed
+ *
+ * @example
+ * ```typescript
+ * getAge('3201018901310123'); // 35 (as of 2024)
+ * ```
+ */
+declare function getAge(nik: string, referenceDate?: Date): number | null;
+/**
+ * Formats the birth date from a NIK into a human-readable string.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param locale - The locale to use for formatting (default: 'id-ID')
+ * @returns Formatted birth date string, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * formatBirthDate('3201018901310123'); // '31 Januari 1989'
+ * ```
+ */
+declare function formatBirthDate(nik: string, options?: Intl.DateTimeFormatOptions, locale?: string): string | null;
+/**
+ * Checks if a NIK matches a specific gender.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param gender - The gender to check ('male' | 'female')
+ * @returns True if the NIK matches the gender, false otherwise
+ */
+declare function isValidForGender(nik: string, gender: 'male' | 'female'): boolean;
+/**
+ * Checks if a NIK matches a specific birth date.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param birthDate - The birth date to check
+ * @returns True if the NIK matches the birth date, false otherwise
+ */
+declare function isValidForBirthDate(nik: string, birthDate: Date): boolean;
+
+export { type MaskOptions, type NIKInfo, formatBirthDate, formatNIK, getAge, isValidForBirthDate, isValidForGender, maskNIK, parseNIK, validateNIK };

package/dist/nik/index.d.ts

@@ -285,4 +285,47 @@ declare function formatNIK(nik: string, separator?: string): string;
  */
 declare function maskNIK(nik: string, options?: MaskOptions): string;
 
-export { type MaskOptions, type NIKInfo, formatNIK, maskNIK, parseNIK, validateNIK };
+/**
+ * Calculates the age of a person based on their NIK.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param referenceDate - The date to calculate age from (default: current date)
+ * @returns The age in years, or null if the NIK is invalid or birth date cannot be parsed
+ *
+ * @example
+ * ```typescript
+ * getAge('3201018901310123'); // 35 (as of 2024)
+ * ```
+ */
+declare function getAge(nik: string, referenceDate?: Date): number | null;
+/**
+ * Formats the birth date from a NIK into a human-readable string.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param locale - The locale to use for formatting (default: 'id-ID')
+ * @returns Formatted birth date string, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * formatBirthDate('3201018901310123'); // '31 Januari 1989'
+ * ```
+ */
+declare function formatBirthDate(nik: string, options?: Intl.DateTimeFormatOptions, locale?: string): string | null;
+/**
+ * Checks if a NIK matches a specific gender.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param gender - The gender to check ('male' | 'female')
+ * @returns True if the NIK matches the gender, false otherwise
+ */
+declare function isValidForGender(nik: string, gender: 'male' | 'female'): boolean;
+/**
+ * Checks if a NIK matches a specific birth date.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param birthDate - The birth date to check
+ * @returns True if the NIK matches the birth date, false otherwise
+ */
+declare function isValidForBirthDate(nik: string, birthDate: Date): boolean;
+
+export { type MaskOptions, type NIKInfo, formatBirthDate, formatNIK, getAge, isValidForBirthDate, isValidForGender, maskNIK, parseNIK, validateNIK };

package/dist/nik/index.js

@@ -208,6 +208,46 @@ function maskNIK(nik, options = {}) {
   return startPart + char.repeat(maskLength) + endPart;
 }
 
-export { formatNIK, maskNIK, parseNIK, validateNIK };
+// src/nik/utils.ts
+function getAge(nik, referenceDate = /* @__PURE__ */ new Date()) {
+  const info = parseNIK(nik);
+  if (!info || !info.birthDate) {
+    return null;
+  }
+  const birthDate = info.birthDate;
+  let age = referenceDate.getFullYear() - birthDate.getFullYear();
+  const m = referenceDate.getMonth() - birthDate.getMonth();
+  if (m < 0 || m === 0 && referenceDate.getDate() < birthDate.getDate()) {
+    age--;
+  }
+  return age;
+}
+function formatBirthDate(nik, options = {
+  day: "numeric",
+  month: "long",
+  year: "numeric"
+}, locale = "id-ID") {
+  const info = parseNIK(nik);
+  if (!info || !info.birthDate) {
+    return null;
+  }
+  return new Intl.DateTimeFormat(locale, options).format(info.birthDate);
+}
+function isValidForGender(nik, gender) {
+  const info = parseNIK(nik);
+  if (!info) {
+    return false;
+  }
+  return info.gender === gender;
+}
+function isValidForBirthDate(nik, birthDate) {
+  const info = parseNIK(nik);
+  if (!info || !info.birthDate) {
+    return false;
+  }
+  return info.birthDate.getFullYear() === birthDate.getFullYear() && info.birthDate.getMonth() === birthDate.getMonth() && info.birthDate.getDate() === birthDate.getDate();
+}
+
+export { formatBirthDate, formatNIK, getAge, isValidForBirthDate, isValidForGender, maskNIK, parseNIK, validateNIK };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/nik/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/nik/constants.ts","../../src/nik/validate.ts","../../src/nik/parse.ts","../../src/nik/format.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Indonesian province codes and names\n * Based on Dukcapil Kemendagri data\n */\nexport const PROVINCES: Record<string, string> = {\n  '11': 'Aceh',\n  '12': 'Sumatera Utara',\n  '13': 'Sumatera Barat',\n  '14': 'Riau',\n  '15': 'Jambi',\n  '16': 'Sumatera Selatan',\n  '17': 'Bengkulu',\n  '18': 'Lampung',\n  '19': 'Kepulauan Bangka Belitung',\n  '21': 'Kepulauan Riau',\n  '31': 'DKI Jakarta',\n  '32': 'Jawa Barat',\n  '33': 'Jawa Tengah',\n  '34': 'DI Yogyakarta',\n  '35': 'Jawa Timur',\n  '36': 'Banten',\n  '51': 'Bali',\n  '52': 'Nusa Tenggara Barat',\n  '53': 'Nusa Tenggara Timur',\n  '61': 'Kalimantan Barat',\n  '62': 'Kalimantan Tengah',\n  '63': 'Kalimantan Selatan',\n  '64': 'Kalimantan Timur',\n  '65': 'Kalimantan Utara',\n  '71': 'Sulawesi Utara',\n  '72': 'Sulawesi Tengah',\n  '73': 'Sulawesi Selatan',\n  '74': 'Sulawesi Tenggara',\n  '75': 'Gorontalo',\n  '76': 'Sulawesi Barat',\n  '81': 'Maluku',\n  '82': 'Maluku Utara',\n  '91': 'Papua',\n  '92': 'Papua Barat',\n  '93': 'Papua Selatan',\n  '94': 'Papua Tengah',\n  '95': 'Papua Pegunungan',\n  '96': 'Papua Barat Daya',\n};\n\n/**\n * Regency codes for each province (simplified - only major ones)\n * In a real implementation, you'd have complete data\n */\nexport const REGENCIES: Record<string, Record<string, string>> = {\n  '32': {\n    '01': 'Kab. Bogor',\n    '02': 'Kab. Sukabumi',\n    '03': 'Kab. Cianjur',\n    '71': 'Kota Bandung',\n    '72': 'Kota Bekasi',\n    '73': 'Kota Depok',\n  },\n  '31': { \n    '01': 'Kota Jakarta Selatan',\n    '02': 'Kota Jakarta Timur',\n    '03': 'Kota Jakarta Pusat',\n    '04': 'Kota Jakarta Barat',\n    '05': 'Kota Jakarta Utara',\n  },\n};","import { PROVINCES } from './constants';\n\n/**\n * Validates a NIK (Nomor Induk Kependudukan) format.\n *\n * A valid NIK must:\n * - Be exactly 16 digits\n * - Have a valid province code (positions 1-2)\n * - Have a valid date (positions 7-12)\n * - Not be in the future\n * - Not be before 1900\n *\n * For female NIKs, the day is encoded as (actual day + 40).\n * For example, a female born on the 15th would have day = 55.\n *\n * @param nik - The 16-digit NIK string to validate\n * @returns `true` if the NIK is valid, `false` otherwise\n *\n * @example\n * ```typescript\n * validateNIK('3201234567890123'); // true - valid NIK\n * validateNIK('1234'); // false - wrong length\n * validateNIK('9912345678901234'); // false - invalid province\n * ```\n *\n * @public\n */\nexport function validateNIK(nik: string): boolean {\n  if (!/^\\d{16}$/.test(nik)) {\n    return false;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  if (!PROVINCES[provinceCode]) {\n    return false;\n  }\n\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n\n  const year = parseInt(yearStr, 10);\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const month = parseInt(monthStr, 10);\n  let day = parseInt(dayStr, 10);\n\n  if (day > 40) {\n    day = day - 40;\n  }\n\n  if (month < 1 || month > 12) {\n    return false;\n  }\n\n  if (day < 1 || day > 31) {\n    return false;\n  }\n\n  const testDate = new Date(fullYear, month - 1, day);\n  if (\n    testDate.getFullYear() !== fullYear ||\n    testDate.getMonth() !== month - 1 ||\n    testDate.getDate() !== day\n  ) {\n    return false;\n  }\n\n  const now = new Date();\n  if (testDate > now || testDate < new Date(1900, 0, 1)) {\n    return false;\n  }\n\n  return true;\n}\n","import { PROVINCES, REGENCIES } from './constants';\nimport { NIKInfo } from './types';\n\n/**\n * Parses a NIK and extracts all embedded information.\n *\n * Extracts province, regency, district codes, birth date, gender,\n * and serial number from a 16-digit NIK string.\n *\n * @param nik - The 16-digit NIK string to parse\n * @returns Parsed NIK information, or `null` if the NIK format is invalid\n *\n * @example\n * Parse a valid male NIK:\n * ```typescript\n * const info = parseNIK('3201018901310123');\n * console.log(info);\n * // {\n * //   province: { code: '32', name: 'Jawa Barat' },\n * //   regency: { code: '01', name: 'Kab. Bogor' },\n * //   district: { code: '01', name: null },\n * //   birthDate: Date(1989, 0, 31), // Jan 31, 1989\n * //   gender: 'male',\n * //   serialNumber: '0123',\n * //   isValid: true\n * // }\n * ```\n *\n * @example\n * Parse a female NIK (day + 40):\n * ```typescript\n * const info = parseNIK('3201019508550123');\n * console.log(info.gender); // 'female'\n * console.log(info.birthDate); // Date(1995, 7, 15) - Aug 15, 1995\n * ```\n *\n * @example\n * Invalid NIK returns null:\n * ```typescript\n * const info = parseNIK('invalid');\n * console.log(info); // null\n * ```\n *\n * @public\n */\nexport function parseNIK(nik: string): NIKInfo | null {\n  if (!/^\\d{16}$/.test(nik)) {\n    return null;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  const regencyCode = nik.substring(2, 4);\n  const districtCode = nik.substring(4, 6);\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n  const serialNumber = nik.substring(12, 16);\n\n  const province = PROVINCES[provinceCode];\n  if (!province) {\n    return null;\n  }\n\n  const regencies = REGENCIES[provinceCode] || {};\n  const regency = regencies[regencyCode] || 'Unknown';\n\n  let day = parseInt(dayStr, 10);\n  const month = parseInt(monthStr, 10);\n  const year = parseInt(yearStr, 10);\n\n  let gender: 'male' | 'female' | null = null;\n  if (day > 40) {\n    gender = 'female';\n    day -= 40;\n  } else {\n    gender = 'male';\n  }\n\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const birthDate = new Date(fullYear, month - 1, day);\n  if (\n    birthDate.getFullYear() !== fullYear ||\n    birthDate.getMonth() !== month - 1 ||\n    birthDate.getDate() !== day\n  ) {\n    return null;\n  }\n\n  return {\n    province: {\n      code: provinceCode,\n      name: province,\n    },\n    regency: {\n      code: regencyCode,\n      name: regency,\n    },\n    district: {\n      code: districtCode,\n      name: null,\n    },\n    birthDate,\n    gender,\n    serialNumber,\n    isValid: true,\n  };\n}","import { MaskOptions } from './types';\n\n/**\n * Formats a NIK with separators for better readability.\n *\n * Groups the NIK into logical segments: province, regency, district,\n * year, month, day, and serial number.\n *\n * @param nik - The 16-digit NIK string to format\n * @param separator - Character to use as separator\n * @returns Formatted NIK string, or original string if invalid format\n *\n * @example\n * Default separator (dash):\n * ```typescript\n * formatNIK('3201234567890123');\n * // '32-01-23-45-67-89-0123'\n * ```\n *\n * @example\n * Custom separator:\n * ```typescript\n * formatNIK('3201234567890123', ' ');\n * // '32 01 23 45 67 89 0123'\n * ```\n *\n * @example\n * Invalid NIK returns as-is:\n * ```typescript\n * formatNIK('1234');\n * // '1234'\n * ```\n *\n * @public\n */\nexport function formatNIK(nik: string, separator: string = '-'): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  // Format: PP-KK-DD-YY-MM-DD-XXXX\n  // PP = Province (2 digits)\n  // KK = Regency (2 digits)\n  // DD = District (2 digits)\n  // YY = Year (2 digits)\n  // MM = Month (2 digits)\n  // DD = Day (2 digits, +40 for female)\n  // XXXX = Serial number (4 digits)\n  return [\n    nik.substring(0, 2), // Province\n    nik.substring(2, 4), // Regency\n    nik.substring(4, 6), // District\n    nik.substring(6, 8), // Year\n    nik.substring(8, 10), // Month\n    nik.substring(10, 12), // Day\n    nik.substring(12, 16), // Serial\n  ].join(separator);\n}\n\n/**\n * Masks a NIK to protect privacy while keeping partial visibility.\n *\n * By default, shows the first 4 and last 4 digits, masking the middle 8.\n * Optionally formats the masked NIK with separators.\n *\n * @param nik - The 16-digit NIK string to mask\n * @param options - Masking configuration options\n * @returns Masked NIK string, or original string if invalid format\n *\n * @example\n * Default masking (first 4, last 4):\n * ```typescript\n * maskNIK('3201234567890123');\n * // '3201********0123'\n * ```\n *\n * @example\n * Custom mask character:\n * ```typescript\n * maskNIK('3201234567890123', { char: 'X' });\n * // '3201XXXXXXXX0123'\n * ```\n *\n * @example\n * With separator:\n * ```typescript\n * maskNIK('3201234567890123', { separator: '-' });\n * // '32-01-**-**-**-**-0123'\n * ```\n *\n * @example\n * Custom start and end:\n * ```typescript\n * maskNIK('3201234567890123', { start: 6, end: 4 });\n * // '320123******0123'\n * ```\n *\n * @public\n */\nexport function maskNIK(nik: string, options: MaskOptions = {}): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  const { start = 4, end = 4, char = '*', separator } = options;\n\n  if (start + end >= 16) {\n    return nik;\n  }\n\n  if (separator) {\n    // Format with separator first, then apply masking\n    const formatted = formatNIK(nik, separator);\n    const parts = formatted.split(separator);\n\n    // Calculate which parts to mask\n    // Format: PP-KK-DD-YY-MM-DD-XXXX (7 parts)\n    // Mask parts based on character positions\n    let charCount = 0;\n    const maskedParts = parts.map((part) => {\n      const partStart = charCount;\n      const partEnd = charCount + part.length;\n      charCount += part.length;\n\n      // Check if this part should be fully/partially masked\n      if (partEnd <= start) {\n        // Fully visible (before start)\n        return part;\n      } else if (partStart >= 16 - end) {\n        // Fully visible (after end)\n        return part;\n      } else if (partStart >= start && partEnd <= 16 - end) {\n        // Fully masked\n        return char.repeat(part.length);\n      } else {\n        // Partially masked\n        return part\n          .split('')\n          .map((ch, idx) => {\n            const pos = partStart + idx;\n            if (pos < start || pos >= 16 - end) {\n              return ch;\n            }\n            return char;\n          })\n          .join('');\n      }\n    });\n\n    return maskedParts.join(separator);\n  }\n\n  // Without separator: simple masking\n  const startPart = nik.substring(0, start);\n  const endPart = nik.substring(16 - end);\n  const maskLength = 16 - start - end;\n  return startPart + char.repeat(maskLength) + endPart;\n}"]}
+{"version":3,"sources":["../../src/nik/constants.ts","../../src/nik/validate.ts","../../src/nik/parse.ts","../../src/nik/format.ts","../../src/nik/utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Indonesian province codes and names\n * Based on Dukcapil Kemendagri data\n */\nexport const PROVINCES: Record<string, string> = {\n  '11': 'Aceh',\n  '12': 'Sumatera Utara',\n  '13': 'Sumatera Barat',\n  '14': 'Riau',\n  '15': 'Jambi',\n  '16': 'Sumatera Selatan',\n  '17': 'Bengkulu',\n  '18': 'Lampung',\n  '19': 'Kepulauan Bangka Belitung',\n  '21': 'Kepulauan Riau',\n  '31': 'DKI Jakarta',\n  '32': 'Jawa Barat',\n  '33': 'Jawa Tengah',\n  '34': 'DI Yogyakarta',\n  '35': 'Jawa Timur',\n  '36': 'Banten',\n  '51': 'Bali',\n  '52': 'Nusa Tenggara Barat',\n  '53': 'Nusa Tenggara Timur',\n  '61': 'Kalimantan Barat',\n  '62': 'Kalimantan Tengah',\n  '63': 'Kalimantan Selatan',\n  '64': 'Kalimantan Timur',\n  '65': 'Kalimantan Utara',\n  '71': 'Sulawesi Utara',\n  '72': 'Sulawesi Tengah',\n  '73': 'Sulawesi Selatan',\n  '74': 'Sulawesi Tenggara',\n  '75': 'Gorontalo',\n  '76': 'Sulawesi Barat',\n  '81': 'Maluku',\n  '82': 'Maluku Utara',\n  '91': 'Papua',\n  '92': 'Papua Barat',\n  '93': 'Papua Selatan',\n  '94': 'Papua Tengah',\n  '95': 'Papua Pegunungan',\n  '96': 'Papua Barat Daya',\n};\n\n/**\n * Regency codes for each province (simplified - only major ones)\n * In a real implementation, you'd have complete data\n */\nexport const REGENCIES: Record<string, Record<string, string>> = {\n  '32': {\n    '01': 'Kab. Bogor',\n    '02': 'Kab. Sukabumi',\n    '03': 'Kab. Cianjur',\n    '71': 'Kota Bandung',\n    '72': 'Kota Bekasi',\n    '73': 'Kota Depok',\n  },\n  '31': { \n    '01': 'Kota Jakarta Selatan',\n    '02': 'Kota Jakarta Timur',\n    '03': 'Kota Jakarta Pusat',\n    '04': 'Kota Jakarta Barat',\n    '05': 'Kota Jakarta Utara',\n  },\n};","import { PROVINCES } from './constants';\n\n/**\n * Validates a NIK (Nomor Induk Kependudukan) format.\n *\n * A valid NIK must:\n * - Be exactly 16 digits\n * - Have a valid province code (positions 1-2)\n * - Have a valid date (positions 7-12)\n * - Not be in the future\n * - Not be before 1900\n *\n * For female NIKs, the day is encoded as (actual day + 40).\n * For example, a female born on the 15th would have day = 55.\n *\n * @param nik - The 16-digit NIK string to validate\n * @returns `true` if the NIK is valid, `false` otherwise\n *\n * @example\n * ```typescript\n * validateNIK('3201234567890123'); // true - valid NIK\n * validateNIK('1234'); // false - wrong length\n * validateNIK('9912345678901234'); // false - invalid province\n * ```\n *\n * @public\n */\nexport function validateNIK(nik: string): boolean {\n  if (!/^\\d{16}$/.test(nik)) {\n    return false;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  if (!PROVINCES[provinceCode]) {\n    return false;\n  }\n\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n\n  const year = parseInt(yearStr, 10);\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const month = parseInt(monthStr, 10);\n  let day = parseInt(dayStr, 10);\n\n  if (day > 40) {\n    day = day - 40;\n  }\n\n  if (month < 1 || month > 12) {\n    return false;\n  }\n\n  if (day < 1 || day > 31) {\n    return false;\n  }\n\n  const testDate = new Date(fullYear, month - 1, day);\n  if (\n    testDate.getFullYear() !== fullYear ||\n    testDate.getMonth() !== month - 1 ||\n    testDate.getDate() !== day\n  ) {\n    return false;\n  }\n\n  const now = new Date();\n  if (testDate > now || testDate < new Date(1900, 0, 1)) {\n    return false;\n  }\n\n  return true;\n}\n","import { PROVINCES, REGENCIES } from './constants';\nimport { NIKInfo } from './types';\n\n/**\n * Parses a NIK and extracts all embedded information.\n *\n * Extracts province, regency, district codes, birth date, gender,\n * and serial number from a 16-digit NIK string.\n *\n * @param nik - The 16-digit NIK string to parse\n * @returns Parsed NIK information, or `null` if the NIK format is invalid\n *\n * @example\n * Parse a valid male NIK:\n * ```typescript\n * const info = parseNIK('3201018901310123');\n * console.log(info);\n * // {\n * //   province: { code: '32', name: 'Jawa Barat' },\n * //   regency: { code: '01', name: 'Kab. Bogor' },\n * //   district: { code: '01', name: null },\n * //   birthDate: Date(1989, 0, 31), // Jan 31, 1989\n * //   gender: 'male',\n * //   serialNumber: '0123',\n * //   isValid: true\n * // }\n * ```\n *\n * @example\n * Parse a female NIK (day + 40):\n * ```typescript\n * const info = parseNIK('3201019508550123');\n * console.log(info.gender); // 'female'\n * console.log(info.birthDate); // Date(1995, 7, 15) - Aug 15, 1995\n * ```\n *\n * @example\n * Invalid NIK returns null:\n * ```typescript\n * const info = parseNIK('invalid');\n * console.log(info); // null\n * ```\n *\n * @public\n */\nexport function parseNIK(nik: string): NIKInfo | null {\n  if (!/^\\d{16}$/.test(nik)) {\n    return null;\n  }\n\n  const provinceCode = nik.substring(0, 2);\n  const regencyCode = nik.substring(2, 4);\n  const districtCode = nik.substring(4, 6);\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayStr = nik.substring(10, 12);\n  const serialNumber = nik.substring(12, 16);\n\n  const province = PROVINCES[provinceCode];\n  if (!province) {\n    return null;\n  }\n\n  const regencies = REGENCIES[provinceCode] || {};\n  const regency = regencies[regencyCode] || 'Unknown';\n\n  let day = parseInt(dayStr, 10);\n  const month = parseInt(monthStr, 10);\n  const year = parseInt(yearStr, 10);\n\n  let gender: 'male' | 'female' | null = null;\n  if (day > 40) {\n    gender = 'female';\n    day -= 40;\n  } else {\n    gender = 'male';\n  }\n\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const birthDate = new Date(fullYear, month - 1, day);\n  if (\n    birthDate.getFullYear() !== fullYear ||\n    birthDate.getMonth() !== month - 1 ||\n    birthDate.getDate() !== day\n  ) {\n    return null;\n  }\n\n  return {\n    province: {\n      code: provinceCode,\n      name: province,\n    },\n    regency: {\n      code: regencyCode,\n      name: regency,\n    },\n    district: {\n      code: districtCode,\n      name: null,\n    },\n    birthDate,\n    gender,\n    serialNumber,\n    isValid: true,\n  };\n}","import { MaskOptions } from './types';\n\n/**\n * Formats a NIK with separators for better readability.\n *\n * Groups the NIK into logical segments: province, regency, district,\n * year, month, day, and serial number.\n *\n * @param nik - The 16-digit NIK string to format\n * @param separator - Character to use as separator\n * @returns Formatted NIK string, or original string if invalid format\n *\n * @example\n * Default separator (dash):\n * ```typescript\n * formatNIK('3201234567890123');\n * // '32-01-23-45-67-89-0123'\n * ```\n *\n * @example\n * Custom separator:\n * ```typescript\n * formatNIK('3201234567890123', ' ');\n * // '32 01 23 45 67 89 0123'\n * ```\n *\n * @example\n * Invalid NIK returns as-is:\n * ```typescript\n * formatNIK('1234');\n * // '1234'\n * ```\n *\n * @public\n */\nexport function formatNIK(nik: string, separator: string = '-'): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  // Format: PP-KK-DD-YY-MM-DD-XXXX\n  // PP = Province (2 digits)\n  // KK = Regency (2 digits)\n  // DD = District (2 digits)\n  // YY = Year (2 digits)\n  // MM = Month (2 digits)\n  // DD = Day (2 digits, +40 for female)\n  // XXXX = Serial number (4 digits)\n  return [\n    nik.substring(0, 2), // Province\n    nik.substring(2, 4), // Regency\n    nik.substring(4, 6), // District\n    nik.substring(6, 8), // Year\n    nik.substring(8, 10), // Month\n    nik.substring(10, 12), // Day\n    nik.substring(12, 16), // Serial\n  ].join(separator);\n}\n\n/**\n * Masks a NIK to protect privacy while keeping partial visibility.\n *\n * By default, shows the first 4 and last 4 digits, masking the middle 8.\n * Optionally formats the masked NIK with separators.\n *\n * @param nik - The 16-digit NIK string to mask\n * @param options - Masking configuration options\n * @returns Masked NIK string, or original string if invalid format\n *\n * @example\n * Default masking (first 4, last 4):\n * ```typescript\n * maskNIK('3201234567890123');\n * // '3201********0123'\n * ```\n *\n * @example\n * Custom mask character:\n * ```typescript\n * maskNIK('3201234567890123', { char: 'X' });\n * // '3201XXXXXXXX0123'\n * ```\n *\n * @example\n * With separator:\n * ```typescript\n * maskNIK('3201234567890123', { separator: '-' });\n * // '32-01-**-**-**-**-0123'\n * ```\n *\n * @example\n * Custom start and end:\n * ```typescript\n * maskNIK('3201234567890123', { start: 6, end: 4 });\n * // '320123******0123'\n * ```\n *\n * @public\n */\nexport function maskNIK(nik: string, options: MaskOptions = {}): string {\n  if (!/^\\d{16}$/.test(nik)) {\n    return nik;\n  }\n\n  const { start = 4, end = 4, char = '*', separator } = options;\n\n  if (start + end >= 16) {\n    return nik;\n  }\n\n  if (separator) {\n    // Format with separator first, then apply masking\n    const formatted = formatNIK(nik, separator);\n    const parts = formatted.split(separator);\n\n    // Calculate which parts to mask\n    // Format: PP-KK-DD-YY-MM-DD-XXXX (7 parts)\n    // Mask parts based on character positions\n    let charCount = 0;\n    const maskedParts = parts.map((part) => {\n      const partStart = charCount;\n      const partEnd = charCount + part.length;\n      charCount += part.length;\n\n      // Check if this part should be fully/partially masked\n      if (partEnd <= start) {\n        // Fully visible (before start)\n        return part;\n      } else if (partStart >= 16 - end) {\n        // Fully visible (after end)\n        return part;\n      } else if (partStart >= start && partEnd <= 16 - end) {\n        // Fully masked\n        return char.repeat(part.length);\n      } else {\n        // Partially masked\n        return part\n          .split('')\n          .map((ch, idx) => {\n            const pos = partStart + idx;\n            if (pos < start || pos >= 16 - end) {\n              return ch;\n            }\n            return char;\n          })\n          .join('');\n      }\n    });\n\n    return maskedParts.join(separator);\n  }\n\n  // Without separator: simple masking\n  const startPart = nik.substring(0, start);\n  const endPart = nik.substring(16 - end);\n  const maskLength = 16 - start - end;\n  return startPart + char.repeat(maskLength) + endPart;\n}","import { parseNIK } from './parse';\n\n/**\n * Calculates the age of a person based on their NIK.\n *\n * @param nik - The 16-digit NIK string\n * @param referenceDate - The date to calculate age from (default: current date)\n * @returns The age in years, or null if the NIK is invalid or birth date cannot be parsed\n *\n * @example\n * ```typescript\n * getAge('3201018901310123'); // 35 (as of 2024)\n * ```\n */\nexport function getAge(\n  nik: string,\n  referenceDate: Date = new Date()\n): number | null {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return null;\n  }\n\n  const birthDate = info.birthDate;\n  let age = referenceDate.getFullYear() - birthDate.getFullYear();\n  const m = referenceDate.getMonth() - birthDate.getMonth();\n\n  if (m < 0 || (m === 0 && referenceDate.getDate() < birthDate.getDate())) {\n    age--;\n  }\n\n  return age;\n}\n\n/**\n * Formats the birth date from a NIK into a human-readable string.\n *\n * @param nik - The 16-digit NIK string\n * @param locale - The locale to use for formatting (default: 'id-ID')\n * @returns Formatted birth date string, or null if invalid\n *\n * @example\n * ```typescript\n * formatBirthDate('3201018901310123'); // '31 Januari 1989'\n * ```\n */\nexport function formatBirthDate(\n  nik: string,\n  options: Intl.DateTimeFormatOptions = {\n    day: 'numeric',\n    month: 'long',\n    year: 'numeric',\n  },\n  locale: string = 'id-ID'\n): string | null {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return null;\n  }\n\n  return new Intl.DateTimeFormat(locale, options).format(info.birthDate);\n}\n\n/**\n * Checks if a NIK matches a specific gender.\n *\n * @param nik - The 16-digit NIK string\n * @param gender - The gender to check ('male' | 'female')\n * @returns True if the NIK matches the gender, false otherwise\n */\nexport function isValidForGender(\n  nik: string,\n  gender: 'male' | 'female'\n): boolean {\n  const info = parseNIK(nik);\n  if (!info) {\n    return false;\n  }\n  return info.gender === gender;\n}\n\n/**\n * Checks if a NIK matches a specific birth date.\n *\n * @param nik - The 16-digit NIK string\n * @param birthDate - The birth date to check\n * @returns True if the NIK matches the birth date, false otherwise\n */\nexport function isValidForBirthDate(nik: string, birthDate: Date): boolean {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return false;\n  }\n\n  return (\n    info.birthDate.getFullYear() === birthDate.getFullYear() &&\n    info.birthDate.getMonth() === birthDate.getMonth() &&\n    info.birthDate.getDate() === birthDate.getDate()\n  );\n}\n"]}

package/dist/npwp/index.cjs

@@ -0,0 +1,95 @@
+'use strict';
+
+// src/npwp/validate.ts
+function validateNPWP(npwp) {
+  if (!npwp || typeof npwp !== "string") {
+    return false;
+  }
+  const cleaned = npwp.replace(/[^\d]/g, "");
+  if (cleaned.length !== 15 && cleaned.length !== 16) {
+    return false;
+  }
+  if (!/^\d+$/.test(cleaned)) {
+    return false;
+  }
+  return true;
+}
+
+// src/npwp/format.ts
+function formatNPWP(npwp) {
+  if (!validateNPWP(npwp)) {
+    return npwp;
+  }
+  const cleaned = npwp.replace(/[^\d]/g, "");
+  if (cleaned.length === 15) {
+    return `${cleaned.substring(0, 2)}.${cleaned.substring(
+      2,
+      5
+    )}.${cleaned.substring(5, 8)}.${cleaned.substring(8, 9)}-${cleaned.substring(
+      9,
+      12
+    )}.${cleaned.substring(12, 15)}`;
+  }
+  return cleaned;
+}
+function parseNPWP(npwp) {
+  if (!validateNPWP(npwp)) {
+    return null;
+  }
+  const cleaned = npwp.replace(/[^\d]/g, "");
+  const isNikBased = cleaned.length === 16;
+  if (isNikBased) {
+    return {
+      npwp: cleaned,
+      type: cleaned.substring(0, 2),
+      serial: cleaned.substring(2, 8),
+      checksum: cleaned.substring(8, 9),
+      taxOfficeCode: cleaned.substring(9, 12),
+      branchCode: cleaned.substring(12, 16),
+      isNikBased: true
+    };
+  }
+  return {
+    npwp: cleaned,
+    type: cleaned.substring(0, 2),
+    serial: cleaned.substring(2, 8),
+    checksum: cleaned.substring(8, 9),
+    taxOfficeCode: cleaned.substring(9, 12),
+    branchCode: cleaned.substring(12, 15),
+    isNikBased: false
+  };
+}
+function maskNPWP(npwp, options) {
+  if (!npwp) return "";
+  const { visibleStart = 2, visibleEnd = 3, maskChar = "*" } = options || {};
+  if (npwp.includes(".") || npwp.includes("-")) {
+    let digitCount = 0;
+    const digitsOnly = npwp.replace(/[^\d]/g, "");
+    const totalDigits = digitsOnly.length;
+    return npwp.split("").map((char) => {
+      if (/\d/.test(char)) {
+        digitCount++;
+        if (digitCount <= visibleStart || digitCount > totalDigits - visibleEnd) {
+          return char;
+        }
+        return maskChar;
+      }
+      return char;
+    }).join("");
+  }
+  const cleaned = npwp.replace(/[^\d]/g, "");
+  if (cleaned.length < visibleStart + visibleEnd) {
+    return cleaned.replace(/./g, maskChar);
+  }
+  const start = cleaned.substring(0, visibleStart);
+  const end = cleaned.substring(cleaned.length - visibleEnd);
+  const middle = maskChar.repeat(cleaned.length - visibleStart - visibleEnd);
+  return `${start}${middle}${end}`;
+}
+
+exports.formatNPWP = formatNPWP;
+exports.maskNPWP = maskNPWP;
+exports.parseNPWP = parseNPWP;
+exports.validateNPWP = validateNPWP;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/npwp/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/npwp/validate.ts","../../src/npwp/format.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Validates an Indonesian NPWP (Nomor Pokok Wajib Pajak).\n *\n * Supports both 15-digit (standard) and 16-digit (new NIK-based) formats.\n *\n * @param npwp - The NPWP string to validate\n * @returns `true` if valid, `false` otherwise\n *\n * @example\n * ```typescript\n * validateNPWP('01.234.567.8-012.000'); // true\n * validateNPWP('012345678012000'); // true\n * ```\n */\nexport function validateNPWP(npwp: string): boolean {\n  if (!npwp || typeof npwp !== 'string') {\n    return false;\n  }\n\n  const cleaned = npwp.replace(/[^\\d]/g, '');\n\n  // Must be 15 or 16 digits\n  if (cleaned.length !== 15 && cleaned.length !== 16) {\n    return false;\n  }\n\n  // Basic check: all numeric\n  if (!/^\\d+$/.test(cleaned)) {\n    return false;\n  }\n\n  return true;\n}\n","import { validateNPWP } from './validate';\nimport { NPWPInfo, MaskOptions } from './types';\n\n/**\n * Formats an NPWP string into standard Indonesian format (99.999.999.9-999.999).\n *\n * @param npwp - The NPWP string to format\n * @returns Formatted NPWP string, or original if invalid\n *\n * @example\n * ```typescript\n * formatNPWP('012345678012000'); // '01.234.567.8-012.000'\n * ```\n */\nexport function formatNPWP(npwp: string): string {\n  if (!validateNPWP(npwp)) {\n    return npwp;\n  }\n\n  const cleaned = npwp.replace(/[^\\d]/g, '');\n\n  if (cleaned.length === 15) {\n    return `${cleaned.substring(0, 2)}.${cleaned.substring(\n      2,\n      5\n    )}.${cleaned.substring(5, 8)}.${cleaned.substring(8, 9)}-${cleaned.substring(\n      9,\n      12\n    )}.${cleaned.substring(12, 15)}`;\n  }\n\n  // 16-digit NPWP (NIK) usually doesn't have a standard \"dots\" format like 15-digit\n  // but if it's NIK, it might be formatted as NIK elsewhere.\n  // For now, return as is or implement a simple format.\n  return cleaned;\n}\n\n/**\n * Parses an NPWP string into its components.\n *\n * @param npwp - The NPWP string to parse\n * @returns NPWPInfo object, or null if invalid\n */\nexport function parseNPWP(npwp: string): NPWPInfo | null {\n  if (!validateNPWP(npwp)) {\n    return null;\n  }\n\n  const cleaned = npwp.replace(/[^\\d]/g, '');\n  const isNikBased = cleaned.length === 16;\n\n  if (isNikBased) {\n    return {\n      npwp: cleaned,\n      type: cleaned.substring(0, 2),\n      serial: cleaned.substring(2, 8),\n      checksum: cleaned.substring(8, 9),\n      taxOfficeCode: cleaned.substring(9, 12),\n      branchCode: cleaned.substring(12, 16),\n      isNikBased: true,\n    };\n  }\n\n  return {\n    npwp: cleaned,\n    type: cleaned.substring(0, 2),\n    serial: cleaned.substring(2, 8),\n    checksum: cleaned.substring(8, 9),\n    taxOfficeCode: cleaned.substring(9, 12),\n    branchCode: cleaned.substring(12, 15),\n    isNikBased: false,\n  };\n}\n\n/**\n * Masks an NPWP string for privacy.\n *\n * @param npwp - The NPWP string to mask\n * @param options - Masking options\n * @returns Masked NPWP string\n */\nexport function maskNPWP(npwp: string, options?: MaskOptions): string {\n  if (!npwp) return '';\n\n  const { visibleStart = 2, visibleEnd = 3, maskChar = '*' } = options || {};\n\n  // If input is formatted, we mask the digits but keep the symbols in place\n  if (npwp.includes('.') || npwp.includes('-')) {\n    let digitCount = 0;\n    const digitsOnly = npwp.replace(/[^\\d]/g, '');\n    const totalDigits = digitsOnly.length;\n\n    return npwp\n      .split('')\n      .map((char) => {\n        if (/\\d/.test(char)) {\n          digitCount++;\n          if (\n            digitCount <= visibleStart ||\n            digitCount > totalDigits - visibleEnd\n          ) {\n            return char;\n          }\n          return maskChar;\n        }\n        return char;\n      })\n      .join('');\n  }\n\n  const cleaned = npwp.replace(/[^\\d]/g, '');\n\n  if (cleaned.length < visibleStart + visibleEnd) {\n    return cleaned.replace(/./g, maskChar);\n  }\n\n  const start = cleaned.substring(0, visibleStart);\n  const end = cleaned.substring(cleaned.length - visibleEnd);\n  const middle = maskChar.repeat(cleaned.length - visibleStart - visibleEnd);\n\n  return `${start}${middle}${end}`;\n}\n"]}

package/dist/npwp/index.d.cts

@@ -0,0 +1,76 @@
+/**
+ * Validates an Indonesian NPWP (Nomor Pokok Wajib Pajak).
+ *
+ * Supports both 15-digit (standard) and 16-digit (new NIK-based) formats.
+ *
+ * @param npwp - The NPWP string to validate
+ * @returns `true` if valid, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * validateNPWP('01.234.567.8-012.000'); // true
+ * validateNPWP('012345678012000'); // true
+ * ```
+ */
+declare function validateNPWP(npwp: string): boolean;
+
+/**
+ * Information extracted from an NPWP string.
+ */
+interface NPWPInfo {
+    /** The full 15 or 16 digit numeric string */
+    npwp: string;
+    /** Taxpayer type (e.g., 01-03 for individual, etc.) */
+    type: string;
+    /** Serial number */
+    serial: string;
+    /** Checksum digit */
+    checksum: string;
+    /** Tax office code */
+    taxOfficeCode: string;
+    /** Branch code (usually 000 for head office) */
+    branchCode: string;
+    /** Whether the NPWP is a 16-digit (NIK-based) NPWP */
+    isNikBased: boolean;
+}
+/**
+ * Options for NPWP masking.
+ */
+interface MaskOptions {
+    /** Number of characters to keep visible at the start (default: 2) */
+    visibleStart?: number;
+    /** Number of characters to keep visible at the end (default: 3) */
+    visibleEnd?: number;
+    /** Character to use for masking (default: '*') */
+    maskChar?: string;
+}
+
+/**
+ * Formats an NPWP string into standard Indonesian format (99.999.999.9-999.999).
+ *
+ * @param npwp - The NPWP string to format
+ * @returns Formatted NPWP string, or original if invalid
+ *
+ * @example
+ * ```typescript
+ * formatNPWP('012345678012000'); // '01.234.567.8-012.000'
+ * ```
+ */
+declare function formatNPWP(npwp: string): string;
+/**
+ * Parses an NPWP string into its components.
+ *
+ * @param npwp - The NPWP string to parse
+ * @returns NPWPInfo object, or null if invalid
+ */
+declare function parseNPWP(npwp: string): NPWPInfo | null;
+/**
+ * Masks an NPWP string for privacy.
+ *
+ * @param npwp - The NPWP string to mask
+ * @param options - Masking options
+ * @returns Masked NPWP string
+ */
+declare function maskNPWP(npwp: string, options?: MaskOptions): string;
+
+export { type MaskOptions, type NPWPInfo, formatNPWP, maskNPWP, parseNPWP, validateNPWP };