@indodev/toolkit 0.5.0 → 0.6.0

package/dist/nik/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/nik/constants.ts","../../src/nik/utils/date.ts","../../src/nik/validate.ts","../../src/nik/parse.ts","../../src/nik/format.ts","../../src/nik/utils.ts","../../src/nik/types.ts"],"names":["NIK_PATTERN"],"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};","/**\n * Shared date parsing and validation utilities for NIK module.\n *\n * @module nik/utils/date\n * @packageDocumentation\n */\n\n/**\n * Result of parsing date components from a NIK string.\n *\n * @public\n */\nexport interface ParsedNIKDate {\n  /** 2-digit year code (00-99) from NIK positions 7-8 */\n  year: number;\n  /** Full 4-digit year (1900-1999 or 2000-2099) */\n  fullYear: number;\n  /** Month (1-12) from NIK positions 9-10 */\n  month: number;\n  /** Actual day (1-31), decoded from encoded day */\n  day: number;\n  /** Gender derived from day encoding */\n  gender: 'male' | 'female';\n  /** Original encoded day (1-31 for male, 41-71 for female) */\n  dayEncoded: number;\n}\n\n/**\n * Parses date components from a NIK string.\n *\n * Extracts year, month, and encoded day from positions 7-12 of the NIK.\n * For females, the day is encoded as (actual day + 40).\n *\n * @param nik - 16-digit NIK string\n * @returns ParsedNIKDate or null if NIK format is invalid\n *\n * @example\n * ```typescript\n * const result = parseNIKDate('3201018901310123');\n * // { year: 89, fullYear: 1989, month: 1, day: 31, gender: 'male', dayEncoded: 31 }\n * ```\n *\n * @public\n */\nexport function parseNIKDate(nik: string): ParsedNIKDate | null {\n  if (nik.length !== 16) {\n    return null;\n  }\n\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayEncodedStr = nik.substring(10, 12);\n\n  const year = parseInt(yearStr, 10);\n  if (isNaN(year)) return null;\n\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const month = parseInt(monthStr, 10);\n  if (isNaN(month)) return null;\n\n  const dayEncoded = parseInt(dayEncodedStr, 10);\n  if (isNaN(dayEncoded)) return null;\n\n  const gender: 'male' | 'female' = dayEncoded > 40 ? 'female' : 'male';\n  const day = dayEncoded > 40 ? dayEncoded - 40 : dayEncoded;\n\n  return { year, fullYear, month, day, gender, dayEncoded };\n}\n\n/**\n * Validates if year/month/day form a valid calendar date.\n *\n * Uses JavaScript's Date object to check if the date actually exists\n * (handles leap years, invalid month/day combinations).\n *\n * @param year - Full 4-digit year\n * @param month - Month (1-12)\n * @param day - Day (1-31)\n * @returns true if valid calendar date\n *\n * @example\n * ```typescript\n * validateNIKDateComponents(2024, 2, 29); // true (leap year)\n * validateNIKDateComponents(2023, 2, 29); // false\n * validateNIKDateComponents(2024, 13, 1); // false\n * ```\n *\n * @public\n */\nexport function validateNIKDateComponents(\n  year: number,\n  month: number,\n  day: number\n): boolean {\n  if (month < 1 || month > 12) return false;\n  if (day < 1 || day > 31) return false;\n\n  const testDate = new Date(year, month - 1, day);\n  return (\n    testDate.getFullYear() === year &&\n    testDate.getMonth() === month - 1 &&\n    testDate.getDate() === day\n  );\n}\n","import { PROVINCES } from './constants';\nimport { parseNIKDate, validateNIKDateComponents } from './utils/date';\n\nconst NIK_PATTERN = /^\\d{16}$/;\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 (!NIK_PATTERN.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 parsed = parseNIKDate(nik);\n  if (!parsed) {\n    return false;\n  }\n\n  const { fullYear, month, day } = parsed;\n\n  if (!validateNIKDateComponents(fullYear, month, day)) {\n    return false;\n  }\n\n  const now = new Date();\n  if (new Date(fullYear, month - 1, day) > now || fullYear < 1900) {\n    return false;\n  }\n\n  return true;\n}\n","import { PROVINCES, REGENCIES } from './constants';\nimport { NIKInfo } from './types';\nimport { parseNIKDate, validateNIKDateComponents } from './utils/date';\n\nconst NIK_PATTERN = /^\\d{16}$/;\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 (!NIK_PATTERN.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 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  const parsed = parseNIKDate(nik);\n  if (!parsed) {\n    return null;\n  }\n\n  const { fullYear, month, day, gender } = parsed;\n\n  if (!validateNIKDateComponents(fullYear, month, day)) {\n    return null;\n  }\n\n  const birthDate = new Date(fullYear, month - 1, day);\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}\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","/**\n * Information extracted from a valid NIK.\n *\n * Contains parsed data including location codes, birth date, gender,\n * and serial number from a 16-digit NIK string.\n *\n * @public\n */\nexport interface NIKInfo {\n  /**\n   * Province information extracted from positions 1-2 of the NIK.\n   *\n   * @example\n   * ```typescript\n   * { code: '32', name: 'Jawa Barat' }\n   * ```\n   */\n  province: {\n    /** Two-digit province code (e.g., '32') */\n    code: string;\n    /** Full province name (e.g., 'Jawa Barat') */\n    name: string;\n  };\n\n  /**\n   * Regency (Kabupaten/Kota) information extracted from positions 3-4 of the NIK.\n   *\n   * @example\n   * ```typescript\n   * { code: '01', name: 'Kab. Bogor' }\n   * ```\n   */\n  regency: {\n    /** Two-digit regency code (e.g., '01') */\n    code: string;\n    /** Full regency name (e.g., 'Kab. Bogor') */\n    name: string;\n  };\n\n  /**\n   * District (Kecamatan) information extracted from positions 5-6 of the NIK.\n   * May be `null` if district data is not available.\n   *\n   * @example\n   * ```typescript\n   * { code: '23', name: 'Ciawi' }\n   * ```\n   */\n  district: {\n    /** Two-digit district code (e.g., '23') */\n    code: string;\n    /** Full district name, or `null` if data unavailable */\n    name: string | null;\n  };\n\n  /**\n   * Birth date extracted from positions 7-12 of the NIK.\n   * For females, the day is encoded as (actual day + 40).\n   * Returns `null` if the date is invalid.\n   *\n   * @example\n   * ```typescript\n   * new Date(1989, 0, 31) // January 31, 1989\n   * ```\n   */\n  birthDate: Date | null;\n\n  /**\n   * Gender derived from the day encoding in the NIK.\n   * - 'male': day is 1-31\n   * - 'female': day is 41-71 (actual day + 40)\n   * - `null`: if unable to determine\n   */\n  gender: 'male' | 'female' | null;\n\n  /**\n   * Serial number from positions 13-16 of the NIK.\n   * Uniquely identifies individuals with the same location and birth date.\n   * Returns `null` if unable to extract.\n   *\n   * @example\n   * ```typescript\n   * '0123'\n   * ```\n   */\n  serialNumber: string | null;\n\n  /**\n   * Whether the NIK passed validation checks.\n   * If `false`, other fields may be `null` or contain partial data.\n   */\n  isValid: boolean;\n}\n\n/**\n * Options for masking a NIK to protect privacy.\n *\n * Controls how many characters to show at the start and end,\n * what character to use for masking, and optional separators.\n *\n * @example\n * ```typescript\n * // Default: shows first 4 and last 4 digits\n * { start: 4, end: 4, char: '*' }\n * // Result: '3201********0123'\n *\n * // With separator\n * { start: 4, end: 4, char: '*', separator: '-' }\n * // Result: '3201-****-****-0123'\n * ```\n *\n * @public\n */\nexport interface MaskOptions {\n  /**\n   * Number of characters to show at the start.\n   *\n   * @defaultValue 4\n   */\n  start?: number;\n\n  /**\n   * Number of characters to show at the end.\n   *\n   * @defaultValue 4\n   */\n  end?: number;\n\n  /**\n   * Character to use for masking hidden digits.\n   *\n   * @defaultValue '*'\n   */\n  char?: string;\n\n  /**\n   * Optional separator to add between groups of digits.\n   * If provided, the NIK will be formatted with separators.\n   *\n   * @defaultValue undefined (no separator)\n   *\n   * @example\n   * ```typescript\n   * '-' // Results in format: '3201-****-****-0123'\n   * ' ' // Results in format: '3201 **** **** 0123'\n   * ```\n   */\n  separator?: string;\n}\n\n/**\n * Error thrown when an invalid NIK is provided to a function.\n * Extends native Error with a `code` property for programmatic error handling.\n *\n * @example\n * ```typescript\n * try {\n *   requireNIK('invalid');\n * } catch (error) {\n *   if (error instanceof InvalidNIKError) {\n *     console.log(error.code); // 'INVALID_NIK'\n *   }\n * }\n * ```\n *\n * @public\n */\nexport class InvalidNIKError extends Error {\n  /** Error code for programmatic identification */\n  readonly code = 'INVALID_NIK' as const;\n\n  constructor(message: string = 'Invalid NIK provided') {\n    super(message);\n    this.name = 'InvalidNIKError';\n  }\n}\n"]}
+{"version":3,"sources":["../../src/nik/constants.ts","../../src/nik/utils/date.ts","../../src/nik/validate.ts","../../src/nik/parse.ts","../../src/nik/format.ts","../../src/nik/clean.ts","../../src/nik/validate-detailed.ts","../../src/nik/utils.ts","../../src/nik/types.ts"],"names":["NIK_PATTERN"],"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};","/**\n * Shared date parsing and validation utilities for NIK module.\n *\n * @module nik/utils/date\n * @packageDocumentation\n */\n\n/**\n * Result of parsing date components from a NIK string.\n *\n * @public\n */\nexport interface ParsedNIKDate {\n  /** 2-digit year code (00-99) from NIK positions 7-8 */\n  year: number;\n  /** Full 4-digit year (1900-1999 or 2000-2099) */\n  fullYear: number;\n  /** Month (1-12) from NIK positions 9-10 */\n  month: number;\n  /** Actual day (1-31), decoded from encoded day */\n  day: number;\n  /** Gender derived from day encoding */\n  gender: 'male' | 'female';\n  /** Original encoded day (1-31 for male, 41-71 for female) */\n  dayEncoded: number;\n}\n\n/**\n * Parses date components from a NIK string.\n *\n * Extracts year, month, and encoded day from positions 7-12 of the NIK.\n * For females, the day is encoded as (actual day + 40).\n *\n * @param nik - 16-digit NIK string\n * @returns ParsedNIKDate or null if NIK format is invalid\n *\n * @example\n * ```typescript\n * const result = parseNIKDate('3201018901310123');\n * // { year: 89, fullYear: 1989, month: 1, day: 31, gender: 'male', dayEncoded: 31 }\n * ```\n *\n * @public\n */\nexport function parseNIKDate(nik: string): ParsedNIKDate | null {\n  if (nik.length !== 16) {\n    return null;\n  }\n\n  const yearStr = nik.substring(6, 8);\n  const monthStr = nik.substring(8, 10);\n  const dayEncodedStr = nik.substring(10, 12);\n\n  const year = parseInt(yearStr, 10);\n  if (isNaN(year)) return null;\n\n  const fullYear = year > 30 ? 1900 + year : 2000 + year;\n\n  const month = parseInt(monthStr, 10);\n  if (isNaN(month)) return null;\n\n  const dayEncoded = parseInt(dayEncodedStr, 10);\n  if (isNaN(dayEncoded)) return null;\n\n  const gender: 'male' | 'female' = dayEncoded > 40 ? 'female' : 'male';\n  const day = dayEncoded > 40 ? dayEncoded - 40 : dayEncoded;\n\n  return { year, fullYear, month, day, gender, dayEncoded };\n}\n\n/**\n * Validates if year/month/day form a valid calendar date.\n *\n * Uses JavaScript's Date object to check if the date actually exists\n * (handles leap years, invalid month/day combinations).\n *\n * @param year - Full 4-digit year\n * @param month - Month (1-12)\n * @param day - Day (1-31)\n * @returns true if valid calendar date\n *\n * @example\n * ```typescript\n * validateNIKDateComponents(2024, 2, 29); // true (leap year)\n * validateNIKDateComponents(2023, 2, 29); // false\n * validateNIKDateComponents(2024, 13, 1); // false\n * ```\n *\n * @public\n */\nexport function validateNIKDateComponents(\n  year: number,\n  month: number,\n  day: number\n): boolean {\n  if (month < 1 || month > 12) return false;\n  if (day < 1 || day > 31) return false;\n\n  const testDate = new Date(year, month - 1, day);\n  return (\n    testDate.getFullYear() === year &&\n    testDate.getMonth() === month - 1 &&\n    testDate.getDate() === day\n  );\n}\n","import { PROVINCES } from './constants';\nimport { parseNIKDate, validateNIKDateComponents } from './utils/date';\n\nconst NIK_PATTERN = /^\\d{16}$/;\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 (!NIK_PATTERN.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 parsed = parseNIKDate(nik);\n  if (!parsed) {\n    return false;\n  }\n\n  const { fullYear, month, day } = parsed;\n\n  if (!validateNIKDateComponents(fullYear, month, day)) {\n    return false;\n  }\n\n  const now = new Date();\n  if (new Date(fullYear, month - 1, day) > now || fullYear < 1900) {\n    return false;\n  }\n\n  return true;\n}\n","import { PROVINCES, REGENCIES } from './constants';\nimport { NIKInfo } from './types';\nimport { parseNIKDate, validateNIKDateComponents } from './utils/date';\n\nconst NIK_PATTERN = /^\\d{16}$/;\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 (!NIK_PATTERN.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 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  const parsed = parseNIKDate(nik);\n  if (!parsed) {\n    return null;\n  }\n\n  const { fullYear, month, day, gender } = parsed;\n\n  if (!validateNIKDateComponents(fullYear, month, day)) {\n    return null;\n  }\n\n  const birthDate = new Date(fullYear, month - 1, day);\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}\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 - This branch is theoretically possible for variable-width\n        // parts, but with fixed 2-char NIK segments it cannot be triggered since\n        // no 2-char part can span both the start-visible and end-visible boundaries.\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}\n","/**\n * Cleans a NIK by removing all non-digit characters.\n *\n * Accepts NIK in any format (with separators like `.`, `-`, ` `) and\n * returns a clean 16-digit string. Returns empty string for invalid inputs.\n *\n * @param nik - NIK in any format\n * @returns Clean 16-digit NIK or empty string if invalid\n *\n * @example\n * ```typescript\n * cleanNIK('32-01-01-89-01-31-0123'); // '3201018901310123'\n * cleanNIK('3201.8901.3101.23'); // '32018901310123' (only 14 digits - invalid)\n * cleanNIK('invalid'); // ''\n * ```\n *\n * @public\n */\nexport function cleanNIK(nik: string): string {\n  if (typeof nik !== 'string') {\n    return '';\n  }\n\n  const cleaned = nik.replace(/\\D/g, '');\n\n  if (cleaned.length !== 16) {\n    return '';\n  }\n\n  return cleaned;\n}\n","import { PROVINCES } from './constants';\nimport { NIKValidationResult, NIKValidationError, NIKErrorCode } from './types';\nimport { cleanNIK } from './clean';\nimport { parseNIK } from './parse';\n\nfunction createError(code: NIKErrorCode, message: string): NIKValidationError {\n  return { code, message };\n}\n\n/**\n * Validates a NIK and returns detailed error information.\n *\n * Unlike `validateNIK` which returns a boolean, this function provides\n * structured error reporting for form validation use cases.\n *\n * @param nik - The NIK string to validate (accepts any format with separators)\n * @returns Detailed validation result with errors array\n *\n * @example\n * ```typescript\n * const result = validateNIKDetailed('3201018901310123');\n * if (!result.isValid) {\n *   result.errors.forEach(err => {\n *     console.log(`${err.code}: ${err.message}`);\n *   });\n * }\n * ```\n *\n * @public\n */\nexport function validateNIKDetailed(nik: string): NIKValidationResult {\n  const cleaned = cleanNIK(nik);\n\n  if (cleaned === '') {\n    return {\n      isValid: false,\n      errors: [createError('INVALID_FORMAT', 'NIK must be exactly 16 digits')],\n      nik: null,\n    };\n  }\n\n  const provinceCode = cleaned.substring(0, 2);\n  if (!PROVINCES[provinceCode]) {\n    return {\n      isValid: false,\n      errors: [\n        createError(\n          'INVALID_PROVINCE',\n          `Province code ${provinceCode} not found`\n        ),\n      ],\n      nik: null,\n    };\n  }\n\n  const info = parseNIK(cleaned);\n  if (!info) {\n    return {\n      isValid: false,\n      errors: [createError('INVALID_DATE', 'Invalid date components')],\n      nik: null,\n    };\n  }\n\n  const birthDate = info.birthDate;\n  if (!birthDate) {\n    return {\n      isValid: false,\n      errors: [createError('INVALID_DATE', 'Invalid birth date')],\n      nik: null,\n    };\n  }\n\n  const now = new Date();\n  if (birthDate > now) {\n    return {\n      isValid: false,\n      errors: [\n        createError('FUTURE_DATE', 'Birth date cannot be in the future'),\n      ],\n      nik: null,\n    };\n  }\n\n  return {\n    isValid: true,\n    errors: [],\n    nik: cleaned,\n  };\n}\n","import { parseNIK } from './parse';\nimport { cleanNIK } from './clean';\nimport { Age, GetAgeOptions } from './types';\n\n/**\n * Calculates the age of a person based on their NIK.\n *\n * Returns detailed age breakdown with years, months, and days, or a\n * formatted Indonesian string. This is consistent with `datetime.getAge()`.\n *\n * @param nik - The 16-digit NIK string\n * @param options - Options object with `referenceDate` and `asString`\n * @returns Age object `{ years, months, days }`, formatted string, or null if invalid\n *\n * @example\n * ```typescript\n * // Returns object by default\n * getAge('3201018901310123');\n * // { years: 35, months: 2, days: 6 } (as of 2026-04-06)\n *\n * // Returns formatted string\n * getAge('3201018901310123', { asString: true });\n * // '35 Tahun 2 Bulan 6 Hari'\n *\n * // Custom reference date\n * getAge('3201018901310123', { referenceDate: new Date('2025-01-01') });\n * // { years: 35, months: 11, days: 1 }\n * ```\n *\n * @public\n */\nexport function getAge(\n  nik: string,\n  options: GetAgeOptions = {}\n): Age | string | null {\n  const { referenceDate = new Date(), asString = false } = options;\n\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return null;\n  }\n\n  const birthDate = info.birthDate;\n  let years = referenceDate.getFullYear() - birthDate.getFullYear();\n  let months = referenceDate.getMonth() - birthDate.getMonth();\n  let days = referenceDate.getDate() - birthDate.getDate();\n\n  if (days < 0) {\n    months--;\n    const prevMonth = new Date(\n      referenceDate.getFullYear(),\n      referenceDate.getMonth(),\n      0\n    );\n    days += prevMonth.getDate();\n  }\n\n  if (months < 0) {\n    years--;\n    months += 12;\n  }\n\n  if (asString) {\n    const parts: string[] = [];\n    if (years > 0) parts.push(`${years} Tahun`);\n    if (months > 0) parts.push(`${months} Bulan`);\n    if (days > 0 || parts.length === 0) parts.push(`${days} Hari`);\n    return parts.join(' ');\n  }\n\n  return { years, months, days };\n}\n\n/**\n * Compares two NIKs to check if they belong to the same person.\n *\n * Two NIKs are considered the same person if they have identical:\n * - Province code (positions 1-2)\n * - Regency code (positions 3-4)\n * - District code (positions 5-6)\n * - Birth date (year + month + day)\n * - Gender (derived from day encoding)\n * - Serial number (positions 13-16)\n *\n * @param nik1 - First NIK (accepts any format)\n * @param nik2 - Second NIK (accepts any format)\n * @returns True if both NIKs belong to the same person, false otherwise\n *\n * @example\n * ```typescript\n * // Same person, same format\n * compareNIK('3201018901310123', '3201018901310123'); // true\n *\n * // Same person, different format\n * compareNIK('3201018901310123', '3201-01-89-01-31-0123'); // true\n *\n * // Different serial number\n * compareNIK('3201018901310123', '3201018901310124'); // false\n *\n * // Invalid NIK\n * compareNIK('invalid', '3201018901310123'); // false\n * ```\n *\n * @public\n */\nexport function compareNIK(nik1: string, nik2: string): boolean {\n  const cleaned1 = cleanNIK(nik1);\n  const cleaned2 = cleanNIK(nik2);\n\n  if (\n    cleaned1 === '' ||\n    cleaned2 === '' ||\n    cleaned1.length !== 16 ||\n    cleaned2.length !== 16\n  ) {\n    return false;\n  }\n\n  if (cleaned1 === cleaned2) {\n    return true;\n  }\n\n  const pos1_6_1 = cleaned1.substring(0, 6);\n  const pos1_6_2 = cleaned2.substring(0, 6);\n\n  if (pos1_6_1 !== pos1_6_2) {\n    return false;\n  }\n\n  const birthDate1 = cleaned1.substring(6, 12);\n  const birthDate2 = cleaned2.substring(6, 12);\n\n  if (birthDate1 !== birthDate2) {\n    return false;\n  }\n\n  const serial1 = cleaned1.substring(12, 16);\n  const serial2 = cleaned2.substring(12, 16);\n\n  return serial1 === serial2;\n}\n\n/**\n * Checks if a person is an adult based on their NIK.\n *\n * By default, uses 17 years as the threshold (Indonesian KTP eligibility age).\n * Indonesian law allows KTP at age 17, or upon marriage, or already married.\n *\n * @param nik - The 16-digit NIK string\n * @param minAge - Minimum age threshold (default: 17)\n * @returns True if the person is at least minAge years old, false otherwise\n *\n * @example\n * ```typescript\n * // Born 1995-01-01, reference 2026-04-06 (age 31)\n * isAdult('3201950101950123'); // true (31 >= 17)\n * isAdult('3201950101950123', 21); // true (31 >= 21)\n *\n * // Born 2010-01-01, reference 2026-04-06 (age 16)\n * isAdult('3210010101950123'); // false (16 < 17)\n * isAdult('3210010101950123', 16); // true (16 >= 16)\n *\n * // Invalid NIK\n * isAdult('invalid'); // false\n * ```\n *\n * @public\n */\nexport function isAdult(nik: string, minAge: number = 17): boolean {\n  const age = getAge(nik);\n  if (age === null) {\n    return false;\n  }\n\n  if (typeof age === 'string') {\n    const yearsMatch = age.match(/^(\\d+)/);\n    if (yearsMatch) {\n      return parseInt(yearsMatch[1], 10) >= minAge;\n    }\n    return false;\n  }\n\n  return age.years >= minAge;\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(nik: string): string | null {\n  const info = parseNIK(nik);\n  if (!info || !info.birthDate) {\n    return null;\n  }\n\n  const day = info.birthDate.getDate();\n  const month = info.birthDate.getMonth();\n  const year = info.birthDate.getFullYear();\n\n  const monthNames = [\n    'Januari',\n    'Februari',\n    'Maret',\n    'April',\n    'Mei',\n    'Juni',\n    'Juli',\n    'Agustus',\n    'September',\n    'Oktober',\n    'November',\n    'Desember',\n  ];\n\n  return `${day} ${monthNames[month]} ${year}`;\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","/**\n * Information extracted from a valid NIK.\n *\n * Contains parsed data including location codes, birth date, gender,\n * and serial number from a 16-digit NIK string.\n *\n * @public\n */\nexport interface NIKInfo {\n  /**\n   * Province information extracted from positions 1-2 of the NIK.\n   *\n   * @example\n   * ```typescript\n   * { code: '32', name: 'Jawa Barat' }\n   * ```\n   */\n  province: {\n    /** Two-digit province code (e.g., '32') */\n    code: string;\n    /** Full province name (e.g., 'Jawa Barat') */\n    name: string;\n  };\n\n  /**\n   * Regency (Kabupaten/Kota) information extracted from positions 3-4 of the NIK.\n   *\n   * @example\n   * ```typescript\n   * { code: '01', name: 'Kab. Bogor' }\n   * ```\n   */\n  regency: {\n    /** Two-digit regency code (e.g., '01') */\n    code: string;\n    /** Full regency name (e.g., 'Kab. Bogor') */\n    name: string;\n  };\n\n  /**\n   * District (Kecamatan) information extracted from positions 5-6 of the NIK.\n   * May be `null` if district data is not available.\n   *\n   * @example\n   * ```typescript\n   * { code: '23', name: 'Ciawi' }\n   * ```\n   */\n  district: {\n    /** Two-digit district code (e.g., '23') */\n    code: string;\n    /** Full district name, or `null` if data unavailable */\n    name: string | null;\n  };\n\n  /**\n   * Birth date extracted from positions 7-12 of the NIK.\n   * For females, the day is encoded as (actual day + 40).\n   * Returns `null` if the date is invalid.\n   *\n   * @example\n   * ```typescript\n   * new Date(1989, 0, 31) // January 31, 1989\n   * ```\n   */\n  birthDate: Date | null;\n\n  /**\n   * Gender derived from the day encoding in the NIK.\n   * - 'male': day is 1-31\n   * - 'female': day is 41-71 (actual day + 40)\n   * - `null`: if unable to determine\n   */\n  gender: 'male' | 'female' | null;\n\n  /**\n   * Serial number from positions 13-16 of the NIK.\n   * Uniquely identifies individuals with the same location and birth date.\n   * Returns `null` if unable to extract.\n   *\n   * @example\n   * ```typescript\n   * '0123'\n   * ```\n   */\n  serialNumber: string | null;\n\n  /**\n   * Whether the NIK passed validation checks.\n   * If `false`, other fields may be `null` or contain partial data.\n   */\n  isValid: boolean;\n}\n\n/**\n * Options for masking a NIK to protect privacy.\n *\n * Controls how many characters to show at the start and end,\n * what character to use for masking, and optional separators.\n *\n * @example\n * ```typescript\n * // Default: shows first 4 and last 4 digits\n * { start: 4, end: 4, char: '*' }\n * // Result: '3201********0123'\n *\n * // With separator\n * { start: 4, end: 4, char: '*', separator: '-' }\n * // Result: '3201-****-****-0123'\n * ```\n *\n * @public\n */\nexport interface MaskOptions {\n  /**\n   * Number of characters to show at the start.\n   *\n   * @defaultValue 4\n   */\n  start?: number;\n\n  /**\n   * Number of characters to show at the end.\n   *\n   * @defaultValue 4\n   */\n  end?: number;\n\n  /**\n   * Character to use for masking hidden digits.\n   *\n   * @defaultValue '*'\n   */\n  char?: string;\n\n  /**\n   * Optional separator to add between groups of digits.\n   * If provided, the NIK will be formatted with separators.\n   *\n   * @defaultValue undefined (no separator)\n   *\n   * @example\n   * ```typescript\n   * '-' // Results in format: '3201-****-****-0123'\n   * ' ' // Results in format: '3201 **** **** 0123'\n   * ```\n   */\n  separator?: string;\n}\n\n/**\n * Error thrown when an invalid NIK is provided to a function.\n * Extends native Error with a `code` property for programmatic error handling.\n *\n * @example\n * ```typescript\n * try {\n *   requireNIK('invalid');\n * } catch (error) {\n *   if (error instanceof InvalidNIKError) {\n *     console.log(error.code); // 'INVALID_NIK'\n *   }\n * }\n * ```\n *\n * @public\n */\nexport class InvalidNIKError extends Error {\n  /** Error code for programmatic identification */\n  readonly code = 'INVALID_NIK' as const;\n\n  constructor(message: string = 'Invalid NIK provided') {\n    super(message);\n    this.name = 'InvalidNIKError';\n  }\n}\n\n/**\n * Error codes for detailed NIK validation.\n *\n * @public\n */\nexport type NIKErrorCode =\n  | 'INVALID_FORMAT'\n  | 'INVALID_PROVINCE'\n  | 'INVALID_MONTH'\n  | 'INVALID_DAY'\n  | 'INVALID_DATE'\n  | 'FUTURE_DATE';\n\n/**\n * A single validation error with code and message.\n *\n * @public\n */\nexport interface NIKValidationError {\n  /** Error code for programmatic handling */\n  code: NIKErrorCode;\n  /** Human-readable error message */\n  message: string;\n}\n\n/**\n * Detailed validation result for NIK with structured error reporting.\n *\n * Use this for form validation where you need to show specific error\n * messages per field.\n *\n * @example\n * ```typescript\n * const result = validateNIKDetailed('1234');\n * if (!result.isValid) {\n *   result.errors.forEach(err => {\n *     console.log(err.code, err.message);\n *   });\n * }\n * ```\n *\n * @public\n */\nexport interface NIKValidationResult {\n  /** Whether the NIK is valid */\n  isValid: boolean;\n  /** List of validation errors (empty if valid) */\n  errors: NIKValidationError[];\n  /** Cleaned 16-digit NIK if valid, null otherwise */\n  nik: string | null;\n}\n\n/**\n * Options for getAge function.\n *\n * @public\n */\nexport interface GetAgeOptions {\n  /** Date to calculate age from (default: current date) */\n  referenceDate?: Date;\n  /** Return formatted Indonesian string instead of object */\n  asString?: boolean;\n}\n\n/**\n * Age result object with years, months, and days.\n *\n * @public\n */\nexport interface Age {\n  /** Full years */\n  years: number;\n  /** Remaining months after full years */\n  months: number;\n  /** Remaining days after full months */\n  days: number;\n}\n"]}

package/dist/utils-DT8-jt63.d.cts

@@ -0,0 +1,495 @@
+/**
+ * Validates a NIK (Nomor Induk Kependudukan) format.
+ *
+ * A valid NIK must:
+ * - Be exactly 16 digits
+ * - Have a valid province code (positions 1-2)
+ * - Have a valid date (positions 7-12)
+ * - Not be in the future
+ * - Not be before 1900
+ *
+ * For female NIKs, the day is encoded as (actual day + 40).
+ * For example, a female born on the 15th would have day = 55.
+ *
+ * @param nik - The 16-digit NIK string to validate
+ * @returns `true` if the NIK is valid, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * validateNIK('3201234567890123'); // true - valid NIK
+ * validateNIK('1234'); // false - wrong length
+ * validateNIK('9912345678901234'); // false - invalid province
+ * ```
+ *
+ * @public
+ */
+declare function validateNIK(nik: string): boolean;
+
+/**
+ * Information extracted from a valid NIK.
+ *
+ * Contains parsed data including location codes, birth date, gender,
+ * and serial number from a 16-digit NIK string.
+ *
+ * @public
+ */
+interface NIKInfo {
+    /**
+     * Province information extracted from positions 1-2 of the NIK.
+     *
+     * @example
+     * ```typescript
+     * { code: '32', name: 'Jawa Barat' }
+     * ```
+     */
+    province: {
+        /** Two-digit province code (e.g., '32') */
+        code: string;
+        /** Full province name (e.g., 'Jawa Barat') */
+        name: string;
+    };
+    /**
+     * Regency (Kabupaten/Kota) information extracted from positions 3-4 of the NIK.
+     *
+     * @example
+     * ```typescript
+     * { code: '01', name: 'Kab. Bogor' }
+     * ```
+     */
+    regency: {
+        /** Two-digit regency code (e.g., '01') */
+        code: string;
+        /** Full regency name (e.g., 'Kab. Bogor') */
+        name: string;
+    };
+    /**
+     * District (Kecamatan) information extracted from positions 5-6 of the NIK.
+     * May be `null` if district data is not available.
+     *
+     * @example
+     * ```typescript
+     * { code: '23', name: 'Ciawi' }
+     * ```
+     */
+    district: {
+        /** Two-digit district code (e.g., '23') */
+        code: string;
+        /** Full district name, or `null` if data unavailable */
+        name: string | null;
+    };
+    /**
+     * Birth date extracted from positions 7-12 of the NIK.
+     * For females, the day is encoded as (actual day + 40).
+     * Returns `null` if the date is invalid.
+     *
+     * @example
+     * ```typescript
+     * new Date(1989, 0, 31) // January 31, 1989
+     * ```
+     */
+    birthDate: Date | null;
+    /**
+     * Gender derived from the day encoding in the NIK.
+     * - 'male': day is 1-31
+     * - 'female': day is 41-71 (actual day + 40)
+     * - `null`: if unable to determine
+     */
+    gender: 'male' | 'female' | null;
+    /**
+     * Serial number from positions 13-16 of the NIK.
+     * Uniquely identifies individuals with the same location and birth date.
+     * Returns `null` if unable to extract.
+     *
+     * @example
+     * ```typescript
+     * '0123'
+     * ```
+     */
+    serialNumber: string | null;
+    /**
+     * Whether the NIK passed validation checks.
+     * If `false`, other fields may be `null` or contain partial data.
+     */
+    isValid: boolean;
+}
+/**
+ * Options for masking a NIK to protect privacy.
+ *
+ * Controls how many characters to show at the start and end,
+ * what character to use for masking, and optional separators.
+ *
+ * @example
+ * ```typescript
+ * // Default: shows first 4 and last 4 digits
+ * { start: 4, end: 4, char: '*' }
+ * // Result: '3201********0123'
+ *
+ * // With separator
+ * { start: 4, end: 4, char: '*', separator: '-' }
+ * // Result: '3201-****-****-0123'
+ * ```
+ *
+ * @public
+ */
+interface MaskOptions {
+    /**
+     * Number of characters to show at the start.
+     *
+     * @defaultValue 4
+     */
+    start?: number;
+    /**
+     * Number of characters to show at the end.
+     *
+     * @defaultValue 4
+     */
+    end?: number;
+    /**
+     * Character to use for masking hidden digits.
+     *
+     * @defaultValue '*'
+     */
+    char?: string;
+    /**
+     * Optional separator to add between groups of digits.
+     * If provided, the NIK will be formatted with separators.
+     *
+     * @defaultValue undefined (no separator)
+     *
+     * @example
+     * ```typescript
+     * '-' // Results in format: '3201-****-****-0123'
+     * ' ' // Results in format: '3201 **** **** 0123'
+     * ```
+     */
+    separator?: string;
+}
+/**
+ * Error thrown when an invalid NIK is provided to a function.
+ * Extends native Error with a `code` property for programmatic error handling.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   requireNIK('invalid');
+ * } catch (error) {
+ *   if (error instanceof InvalidNIKError) {
+ *     console.log(error.code); // 'INVALID_NIK'
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+declare class InvalidNIKError extends Error {
+    /** Error code for programmatic identification */
+    readonly code: "INVALID_NIK";
+    constructor(message?: string);
+}
+/**
+ * Error codes for detailed NIK validation.
+ *
+ * @public
+ */
+type NIKErrorCode = 'INVALID_FORMAT' | 'INVALID_PROVINCE' | 'INVALID_MONTH' | 'INVALID_DAY' | 'INVALID_DATE' | 'FUTURE_DATE';
+/**
+ * A single validation error with code and message.
+ *
+ * @public
+ */
+interface NIKValidationError {
+    /** Error code for programmatic handling */
+    code: NIKErrorCode;
+    /** Human-readable error message */
+    message: string;
+}
+/**
+ * Detailed validation result for NIK with structured error reporting.
+ *
+ * Use this for form validation where you need to show specific error
+ * messages per field.
+ *
+ * @example
+ * ```typescript
+ * const result = validateNIKDetailed('1234');
+ * if (!result.isValid) {
+ *   result.errors.forEach(err => {
+ *     console.log(err.code, err.message);
+ *   });
+ * }
+ * ```
+ *
+ * @public
+ */
+interface NIKValidationResult {
+    /** Whether the NIK is valid */
+    isValid: boolean;
+    /** List of validation errors (empty if valid) */
+    errors: NIKValidationError[];
+    /** Cleaned 16-digit NIK if valid, null otherwise */
+    nik: string | null;
+}
+/**
+ * Options for getAge function.
+ *
+ * @public
+ */
+interface GetAgeOptions {
+    /** Date to calculate age from (default: current date) */
+    referenceDate?: Date;
+    /** Return formatted Indonesian string instead of object */
+    asString?: boolean;
+}
+/**
+ * Age result object with years, months, and days.
+ *
+ * @public
+ */
+interface Age {
+    /** Full years */
+    years: number;
+    /** Remaining months after full years */
+    months: number;
+    /** Remaining days after full months */
+    days: number;
+}
+
+/**
+ * Parses a NIK and extracts all embedded information.
+ *
+ * Extracts province, regency, district codes, birth date, gender,
+ * and serial number from a 16-digit NIK string.
+ *
+ * @param nik - The 16-digit NIK string to parse
+ * @returns Parsed NIK information, or `null` if the NIK format is invalid
+ *
+ * @example
+ * Parse a valid male NIK:
+ * ```typescript
+ * const info = parseNIK('3201018901310123');
+ * console.log(info);
+ * // {
+ * //   province: { code: '32', name: 'Jawa Barat' },
+ * //   regency: { code: '01', name: 'Kab. Bogor' },
+ * //   district: { code: '01', name: null },
+ * //   birthDate: Date(1989, 0, 31), // Jan 31, 1989
+ * //   gender: 'male',
+ * //   serialNumber: '0123',
+ * //   isValid: true
+ * // }
+ * ```
+ *
+ * @example
+ * Parse a female NIK (day + 40):
+ * ```typescript
+ * const info = parseNIK('3201019508550123');
+ * console.log(info.gender); // 'female'
+ * console.log(info.birthDate); // Date(1995, 7, 15) - Aug 15, 1995
+ * ```
+ *
+ * @example
+ * Invalid NIK returns null:
+ * ```typescript
+ * const info = parseNIK('invalid');
+ * console.log(info); // null
+ * ```
+ *
+ * @public
+ */
+declare function parseNIK(nik: string): NIKInfo | null;
+
+/**
+ * Formats a NIK with separators for better readability.
+ *
+ * Groups the NIK into logical segments: province, regency, district,
+ * year, month, day, and serial number.
+ *
+ * @param nik - The 16-digit NIK string to format
+ * @param separator - Character to use as separator
+ * @returns Formatted NIK string, or original string if invalid format
+ *
+ * @example
+ * Default separator (dash):
+ * ```typescript
+ * formatNIK('3201234567890123');
+ * // '32-01-23-45-67-89-0123'
+ * ```
+ *
+ * @example
+ * Custom separator:
+ * ```typescript
+ * formatNIK('3201234567890123', ' ');
+ * // '32 01 23 45 67 89 0123'
+ * ```
+ *
+ * @example
+ * Invalid NIK returns as-is:
+ * ```typescript
+ * formatNIK('1234');
+ * // '1234'
+ * ```
+ *
+ * @public
+ */
+declare function formatNIK(nik: string, separator?: string): string;
+/**
+ * Masks a NIK to protect privacy while keeping partial visibility.
+ *
+ * By default, shows the first 4 and last 4 digits, masking the middle 8.
+ * Optionally formats the masked NIK with separators.
+ *
+ * @param nik - The 16-digit NIK string to mask
+ * @param options - Masking configuration options
+ * @returns Masked NIK string, or original string if invalid format
+ *
+ * @example
+ * Default masking (first 4, last 4):
+ * ```typescript
+ * maskNIK('3201234567890123');
+ * // '3201********0123'
+ * ```
+ *
+ * @example
+ * Custom mask character:
+ * ```typescript
+ * maskNIK('3201234567890123', { char: 'X' });
+ * // '3201XXXXXXXX0123'
+ * ```
+ *
+ * @example
+ * With separator:
+ * ```typescript
+ * maskNIK('3201234567890123', { separator: '-' });
+ * // '32-01-**-**-**-**-0123'
+ * ```
+ *
+ * @example
+ * Custom start and end:
+ * ```typescript
+ * maskNIK('3201234567890123', { start: 6, end: 4 });
+ * // '320123******0123'
+ * ```
+ *
+ * @public
+ */
+declare function maskNIK(nik: string, options?: MaskOptions): string;
+
+/**
+ * Calculates the age of a person based on their NIK.
+ *
+ * Returns detailed age breakdown with years, months, and days, or a
+ * formatted Indonesian string. This is consistent with `datetime.getAge()`.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param options - Options object with `referenceDate` and `asString`
+ * @returns Age object `{ years, months, days }`, formatted string, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * // Returns object by default
+ * getAge('3201018901310123');
+ * // { years: 35, months: 2, days: 6 } (as of 2026-04-06)
+ *
+ * // Returns formatted string
+ * getAge('3201018901310123', { asString: true });
+ * // '35 Tahun 2 Bulan 6 Hari'
+ *
+ * // Custom reference date
+ * getAge('3201018901310123', { referenceDate: new Date('2025-01-01') });
+ * // { years: 35, months: 11, days: 1 }
+ * ```
+ *
+ * @public
+ */
+declare function getAge(nik: string, options?: GetAgeOptions): Age | string | null;
+/**
+ * Compares two NIKs to check if they belong to the same person.
+ *
+ * Two NIKs are considered the same person if they have identical:
+ * - Province code (positions 1-2)
+ * - Regency code (positions 3-4)
+ * - District code (positions 5-6)
+ * - Birth date (year + month + day)
+ * - Gender (derived from day encoding)
+ * - Serial number (positions 13-16)
+ *
+ * @param nik1 - First NIK (accepts any format)
+ * @param nik2 - Second NIK (accepts any format)
+ * @returns True if both NIKs belong to the same person, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Same person, same format
+ * compareNIK('3201018901310123', '3201018901310123'); // true
+ *
+ * // Same person, different format
+ * compareNIK('3201018901310123', '3201-01-89-01-31-0123'); // true
+ *
+ * // Different serial number
+ * compareNIK('3201018901310123', '3201018901310124'); // false
+ *
+ * // Invalid NIK
+ * compareNIK('invalid', '3201018901310123'); // false
+ * ```
+ *
+ * @public
+ */
+declare function compareNIK(nik1: string, nik2: string): boolean;
+/**
+ * Checks if a person is an adult based on their NIK.
+ *
+ * By default, uses 17 years as the threshold (Indonesian KTP eligibility age).
+ * Indonesian law allows KTP at age 17, or upon marriage, or already married.
+ *
+ * @param nik - The 16-digit NIK string
+ * @param minAge - Minimum age threshold (default: 17)
+ * @returns True if the person is at least minAge years old, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Born 1995-01-01, reference 2026-04-06 (age 31)
+ * isAdult('3201950101950123'); // true (31 >= 17)
+ * isAdult('3201950101950123', 21); // true (31 >= 21)
+ *
+ * // Born 2010-01-01, reference 2026-04-06 (age 16)
+ * isAdult('3210010101950123'); // false (16 < 17)
+ * isAdult('3210010101950123', 16); // true (16 >= 16)
+ *
+ * // Invalid NIK
+ * isAdult('invalid'); // false
+ * ```
+ *
+ * @public
+ */
+declare function isAdult(nik: string, minAge?: number): boolean;
+/**
+ * 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): 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 Age as A, type GetAgeOptions as G, InvalidNIKError as I, type MaskOptions as M, type NIKInfo as N, formatBirthDate as a, isValidForBirthDate as b, type NIKValidationResult as c, compareNIK as d, isAdult as e, formatNIK as f, getAge as g, type NIKValidationError as h, isValidForGender as i, type NIKErrorCode as j, maskNIK as m, parseNIK as p, validateNIK as v };