nik-id 1.0.0

package/dist/generate.d.ts

@@ -0,0 +1,83 @@
+import { GenerateOptions } from './types.js';
+
+/**
+ * Modul generator NIK (Nomor Induk Kependudukan).
+ *
+ * Menyediakan fungsi {@link generateNIK} untuk membuat NIK yang valid
+ * secara format, baik full random maupun dengan parameter tertentu
+ * (wilayah, gender, tanggal lahir).
+ *
+ * NIK yang dihasilkan valid secara **format** — semua aturan digit terpenuhi —
+ * tapi **bukan** NIK asli milik orang sungguhan. Cocok untuk testing,
+ * seeding database, atau demo.
+ *
+ * @module generate
+ *
+ * @example
+ * ```typescript
+ * import { generateNIK } from 'nik-id/generate';
+ *
+ * // Full random
+ * const nik1 = generateNIK();
+ *
+ * // Perempuan lahir 25 Agustus 1985
+ * const nik2 = generateNIK({ gender: "F", birthDate: new Date("1985-08-25") });
+ *
+ * // Wilayah spesifik
+ * const nik3 = generateNIK({
+ *   provinceCode: "32",
+ *   regencyCode: "3204",
+ *   districtCode: "320407",
+ * });
+ * ```
+ */
+
+/**
+ * Generate NIK (Nomor Induk Kependudukan) yang valid secara format.
+ *
+ * Semua parameter opsional — yang tidak diisi akan di-random.
+ * NIK yang dihasilkan memenuhi semua aturan format:
+ * - Kode provinsi dalam range 11-97
+ * - Tanggal lahir valid secara kalender
+ * - Gender tercermin di encoding DD (perempuan: DD + 40)
+ * - Sequence number dalam range 0001-9999
+ *
+ * **Catatan:** NIK ini bukan data asli — hanya valid secara format,
+ * cocok untuk testing dan demo.
+ *
+ * @param options - Opsi untuk men-generate NIK (semua opsional)
+ * @returns String NIK 16 digit yang valid secara format
+ * @throws {Error} Jika `provinceCode` di luar range 11-97
+ * @throws {Error} Jika `regencyCode` tidak diawali `provinceCode`
+ * @throws {Error} Jika `districtCode` tidak diawali `regencyCode`
+ *
+ * @example
+ * ```typescript
+ * // Full random
+ * generateNIK();
+ * // "3204071508900123"
+ *
+ * // Gender spesifik
+ * generateNIK({ gender: "F" });
+ * // "xxxxxx5508900456" (DD + 40 untuk perempuan)
+ *
+ * // Tanggal lahir spesifik
+ * generateNIK({ birthDate: new Date("1985-08-25") });
+ * // "xxxxxx2508850789"
+ *
+ * // Gender dan tanggal lahir
+ * generateNIK({ gender: "F", birthDate: new Date("1985-08-25") });
+ * // "xxxxxx6508850234" (25 + 40 = 65 untuk perempuan)
+ *
+ * // Wilayah lengkap
+ * generateNIK({
+ *   provinceCode: "32",
+ *   regencyCode: "3204",
+ *   districtCode: "320407",
+ * });
+ * // "3204071508900001"
+ * ```
+ */
+declare function generateNIK(options?: GenerateOptions): string;
+
+export { generateNIK };

package/dist/generate.js

@@ -0,0 +1,70 @@
+// src/generate.ts
+var MIN_PROVINCE_CODE = 11;
+var MAX_PROVINCE_CODE = 97;
+var MIN_BIRTH_YEAR = 1950;
+var MAX_BIRTH_YEAR = 2005;
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function padZero(num, length) {
+  return String(num).padStart(length, "0");
+}
+function getDaysInMonth(year, month) {
+  return new Date(year, month, 0).getDate();
+}
+function randomBirthDate() {
+  const year = randomInt(MIN_BIRTH_YEAR, MAX_BIRTH_YEAR);
+  const month = randomInt(1, 12);
+  const maxDay = getDaysInMonth(year, month);
+  const day = randomInt(1, maxDay);
+  return new Date(year, month - 1, day);
+}
+function generateNIK(options = {}) {
+  const { gender, birthDate } = options;
+  let provinceCode;
+  if (options.provinceCode !== void 0) {
+    const pc = Number.parseInt(options.provinceCode, 10);
+    if (Number.isNaN(pc) || pc < MIN_PROVINCE_CODE || pc > MAX_PROVINCE_CODE) {
+      throw new Error("Kode provinsi tidak valid (harus 11-97)");
+    }
+    provinceCode = padZero(pc, 2);
+  } else {
+    provinceCode = padZero(randomInt(MIN_PROVINCE_CODE, MAX_PROVINCE_CODE), 2);
+  }
+  let regencyCode;
+  if (options.regencyCode !== void 0) {
+    if (!options.regencyCode.startsWith(provinceCode)) {
+      throw new Error(
+        `Kode kabupaten/kota "${options.regencyCode}" tidak sesuai dengan kode provinsi "${provinceCode}"`
+      );
+    }
+    regencyCode = options.regencyCode;
+  } else {
+    regencyCode = provinceCode + padZero(randomInt(1, 99), 2);
+  }
+  let districtCode;
+  if (options.districtCode !== void 0) {
+    if (!options.districtCode.startsWith(regencyCode)) {
+      throw new Error(
+        `Kode kecamatan "${options.districtCode}" tidak sesuai dengan kode kabupaten/kota "${regencyCode}"`
+      );
+    }
+    districtCode = options.districtCode;
+  } else {
+    districtCode = regencyCode + padZero(randomInt(1, 99), 2);
+  }
+  const birth = birthDate ?? randomBirthDate();
+  const day = birth.getDate();
+  const month = birth.getMonth() + 1;
+  const year = birth.getFullYear();
+  const selectedGender = gender ?? (Math.random() < 0.5 ? "M" : "F");
+  const encodedDay = selectedGender === "F" ? day + 40 : day;
+  const ddStr = padZero(encodedDay, 2);
+  const mmStr = padZero(month, 2);
+  const yyStr = padZero(year % 100, 2);
+  const seq = padZero(randomInt(1, 9999), 4);
+  return districtCode + ddStr + mmStr + yyStr + seq;
+}
+export {
+  generateNIK
+};

package/dist/index.cjs

@@ -0,0 +1,183 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  generateNIK: () => generateNIK,
+  parseNIK: () => parseNIK,
+  validateNIK: () => validateNIK
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/generate.ts
+var MIN_PROVINCE_CODE = 11;
+var MAX_PROVINCE_CODE = 97;
+var MIN_BIRTH_YEAR = 1950;
+var MAX_BIRTH_YEAR = 2005;
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function padZero(num, length) {
+  return String(num).padStart(length, "0");
+}
+function getDaysInMonth(year, month) {
+  return new Date(year, month, 0).getDate();
+}
+function randomBirthDate() {
+  const year = randomInt(MIN_BIRTH_YEAR, MAX_BIRTH_YEAR);
+  const month = randomInt(1, 12);
+  const maxDay = getDaysInMonth(year, month);
+  const day = randomInt(1, maxDay);
+  return new Date(year, month - 1, day);
+}
+function generateNIK(options = {}) {
+  const { gender, birthDate } = options;
+  let provinceCode;
+  if (options.provinceCode !== void 0) {
+    const pc = Number.parseInt(options.provinceCode, 10);
+    if (Number.isNaN(pc) || pc < MIN_PROVINCE_CODE || pc > MAX_PROVINCE_CODE) {
+      throw new Error("Kode provinsi tidak valid (harus 11-97)");
+    }
+    provinceCode = padZero(pc, 2);
+  } else {
+    provinceCode = padZero(randomInt(MIN_PROVINCE_CODE, MAX_PROVINCE_CODE), 2);
+  }
+  let regencyCode;
+  if (options.regencyCode !== void 0) {
+    if (!options.regencyCode.startsWith(provinceCode)) {
+      throw new Error(
+        `Kode kabupaten/kota "${options.regencyCode}" tidak sesuai dengan kode provinsi "${provinceCode}"`
+      );
+    }
+    regencyCode = options.regencyCode;
+  } else {
+    regencyCode = provinceCode + padZero(randomInt(1, 99), 2);
+  }
+  let districtCode;
+  if (options.districtCode !== void 0) {
+    if (!options.districtCode.startsWith(regencyCode)) {
+      throw new Error(
+        `Kode kecamatan "${options.districtCode}" tidak sesuai dengan kode kabupaten/kota "${regencyCode}"`
+      );
+    }
+    districtCode = options.districtCode;
+  } else {
+    districtCode = regencyCode + padZero(randomInt(1, 99), 2);
+  }
+  const birth = birthDate ?? randomBirthDate();
+  const day = birth.getDate();
+  const month = birth.getMonth() + 1;
+  const year = birth.getFullYear();
+  const selectedGender = gender ?? (Math.random() < 0.5 ? "M" : "F");
+  const encodedDay = selectedGender === "F" ? day + 40 : day;
+  const ddStr = padZero(encodedDay, 2);
+  const mmStr = padZero(month, 2);
+  const yyStr = padZero(year % 100, 2);
+  const seq = padZero(randomInt(1, 9999), 4);
+  return districtCode + ddStr + mmStr + yyStr + seq;
+}
+
+// src/utils.ts
+function disambiguateYear(yy) {
+  const currentYY = (/* @__PURE__ */ new Date()).getFullYear() % 100;
+  return yy > currentYY ? 1900 + yy : 2e3 + yy;
+}
+
+// src/validate.ts
+var MIN_PROVINCE_CODE2 = 11;
+var MAX_PROVINCE_CODE2 = 97;
+var NIK_LENGTH = 16;
+var DIGITS_ONLY_PATTERN = /^\d{16}$/;
+function isValidCalendarDate(year, month, day) {
+  const date = new Date(year, month - 1, day);
+  return date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day;
+}
+function validateNIK(nik) {
+  if (typeof nik !== "string") {
+    return { valid: false, error: "NIK harus berupa string" };
+  }
+  if (nik.length !== NIK_LENGTH) {
+    return { valid: false, error: "NIK harus 16 digit" };
+  }
+  if (!DIGITS_ONLY_PATTERN.test(nik)) {
+    return { valid: false, error: "NIK hanya boleh berisi angka" };
+  }
+  const provinceCode = Number.parseInt(nik.substring(0, 2), 10);
+  if (provinceCode < MIN_PROVINCE_CODE2 || provinceCode > MAX_PROVINCE_CODE2) {
+    return { valid: false, error: "Kode provinsi tidak valid" };
+  }
+  const dd = Number.parseInt(nik.substring(6, 8), 10);
+  const mm = Number.parseInt(nik.substring(8, 10), 10);
+  const yy = Number.parseInt(nik.substring(10, 12), 10);
+  const isValidMaleDD = dd >= 1 && dd <= 31;
+  const isValidFemaleDD = dd >= 41 && dd <= 71;
+  if (!isValidMaleDD && !isValidFemaleDD) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  if (mm < 1 || mm > 12) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  const actualDay = isValidFemaleDD ? dd - 40 : dd;
+  const fullYear = disambiguateYear(yy);
+  if (!isValidCalendarDate(fullYear, mm, actualDay)) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  const seq = nik.substring(12, 16);
+  if (seq === "0000") {
+    return { valid: false, error: "Nomor urut tidak valid" };
+  }
+  return { valid: true };
+}
+
+// src/parse.ts
+function parseNIK(nik) {
+  const validation = validateNIK(nik);
+  if (!validation.valid) {
+    return { valid: false, error: validation.error };
+  }
+  const provinceCode = nik.substring(0, 2);
+  const regencyCode = nik.substring(0, 4);
+  const districtCode = nik.substring(0, 6);
+  const dd = Number.parseInt(nik.substring(6, 8), 10);
+  const mm = Number.parseInt(nik.substring(8, 10), 10);
+  const yy = Number.parseInt(nik.substring(10, 12), 10);
+  const isFemale = dd > 40;
+  const actualDay = isFemale ? dd - 40 : dd;
+  const gender = isFemale ? "F" : "M";
+  const fullYear = disambiguateYear(yy);
+  const birthDate = new Date(fullYear, mm - 1, actualDay);
+  const sequenceNumber = nik.substring(12, 16);
+  return {
+    valid: true,
+    nik,
+    provinceCode,
+    regencyCode,
+    districtCode,
+    birthDate,
+    gender,
+    sequenceNumber
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateNIK,
+  parseNIK,
+  validateNIK
+});

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export { generateNIK } from './generate.cjs';
+export { parseNIK } from './parse.cjs';
+export { GenerateOptions, NIKInvalid, NIKResult, NIKValid, ValidationInvalid, ValidationResult, ValidationValid } from './types.cjs';
+export { validateNIK } from './validate.cjs';

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { generateNIK } from './generate.js';
+export { parseNIK } from './parse.js';
+export { GenerateOptions, NIKInvalid, NIKResult, NIKValid, ValidationInvalid, ValidationResult, ValidationValid } from './types.js';
+export { validateNIK } from './validate.js';

package/dist/index.js

@@ -0,0 +1,154 @@
+// src/generate.ts
+var MIN_PROVINCE_CODE = 11;
+var MAX_PROVINCE_CODE = 97;
+var MIN_BIRTH_YEAR = 1950;
+var MAX_BIRTH_YEAR = 2005;
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function padZero(num, length) {
+  return String(num).padStart(length, "0");
+}
+function getDaysInMonth(year, month) {
+  return new Date(year, month, 0).getDate();
+}
+function randomBirthDate() {
+  const year = randomInt(MIN_BIRTH_YEAR, MAX_BIRTH_YEAR);
+  const month = randomInt(1, 12);
+  const maxDay = getDaysInMonth(year, month);
+  const day = randomInt(1, maxDay);
+  return new Date(year, month - 1, day);
+}
+function generateNIK(options = {}) {
+  const { gender, birthDate } = options;
+  let provinceCode;
+  if (options.provinceCode !== void 0) {
+    const pc = Number.parseInt(options.provinceCode, 10);
+    if (Number.isNaN(pc) || pc < MIN_PROVINCE_CODE || pc > MAX_PROVINCE_CODE) {
+      throw new Error("Kode provinsi tidak valid (harus 11-97)");
+    }
+    provinceCode = padZero(pc, 2);
+  } else {
+    provinceCode = padZero(randomInt(MIN_PROVINCE_CODE, MAX_PROVINCE_CODE), 2);
+  }
+  let regencyCode;
+  if (options.regencyCode !== void 0) {
+    if (!options.regencyCode.startsWith(provinceCode)) {
+      throw new Error(
+        `Kode kabupaten/kota "${options.regencyCode}" tidak sesuai dengan kode provinsi "${provinceCode}"`
+      );
+    }
+    regencyCode = options.regencyCode;
+  } else {
+    regencyCode = provinceCode + padZero(randomInt(1, 99), 2);
+  }
+  let districtCode;
+  if (options.districtCode !== void 0) {
+    if (!options.districtCode.startsWith(regencyCode)) {
+      throw new Error(
+        `Kode kecamatan "${options.districtCode}" tidak sesuai dengan kode kabupaten/kota "${regencyCode}"`
+      );
+    }
+    districtCode = options.districtCode;
+  } else {
+    districtCode = regencyCode + padZero(randomInt(1, 99), 2);
+  }
+  const birth = birthDate ?? randomBirthDate();
+  const day = birth.getDate();
+  const month = birth.getMonth() + 1;
+  const year = birth.getFullYear();
+  const selectedGender = gender ?? (Math.random() < 0.5 ? "M" : "F");
+  const encodedDay = selectedGender === "F" ? day + 40 : day;
+  const ddStr = padZero(encodedDay, 2);
+  const mmStr = padZero(month, 2);
+  const yyStr = padZero(year % 100, 2);
+  const seq = padZero(randomInt(1, 9999), 4);
+  return districtCode + ddStr + mmStr + yyStr + seq;
+}
+
+// src/utils.ts
+function disambiguateYear(yy) {
+  const currentYY = (/* @__PURE__ */ new Date()).getFullYear() % 100;
+  return yy > currentYY ? 1900 + yy : 2e3 + yy;
+}
+
+// src/validate.ts
+var MIN_PROVINCE_CODE2 = 11;
+var MAX_PROVINCE_CODE2 = 97;
+var NIK_LENGTH = 16;
+var DIGITS_ONLY_PATTERN = /^\d{16}$/;
+function isValidCalendarDate(year, month, day) {
+  const date = new Date(year, month - 1, day);
+  return date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day;
+}
+function validateNIK(nik) {
+  if (typeof nik !== "string") {
+    return { valid: false, error: "NIK harus berupa string" };
+  }
+  if (nik.length !== NIK_LENGTH) {
+    return { valid: false, error: "NIK harus 16 digit" };
+  }
+  if (!DIGITS_ONLY_PATTERN.test(nik)) {
+    return { valid: false, error: "NIK hanya boleh berisi angka" };
+  }
+  const provinceCode = Number.parseInt(nik.substring(0, 2), 10);
+  if (provinceCode < MIN_PROVINCE_CODE2 || provinceCode > MAX_PROVINCE_CODE2) {
+    return { valid: false, error: "Kode provinsi tidak valid" };
+  }
+  const dd = Number.parseInt(nik.substring(6, 8), 10);
+  const mm = Number.parseInt(nik.substring(8, 10), 10);
+  const yy = Number.parseInt(nik.substring(10, 12), 10);
+  const isValidMaleDD = dd >= 1 && dd <= 31;
+  const isValidFemaleDD = dd >= 41 && dd <= 71;
+  if (!isValidMaleDD && !isValidFemaleDD) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  if (mm < 1 || mm > 12) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  const actualDay = isValidFemaleDD ? dd - 40 : dd;
+  const fullYear = disambiguateYear(yy);
+  if (!isValidCalendarDate(fullYear, mm, actualDay)) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  const seq = nik.substring(12, 16);
+  if (seq === "0000") {
+    return { valid: false, error: "Nomor urut tidak valid" };
+  }
+  return { valid: true };
+}
+
+// src/parse.ts
+function parseNIK(nik) {
+  const validation = validateNIK(nik);
+  if (!validation.valid) {
+    return { valid: false, error: validation.error };
+  }
+  const provinceCode = nik.substring(0, 2);
+  const regencyCode = nik.substring(0, 4);
+  const districtCode = nik.substring(0, 6);
+  const dd = Number.parseInt(nik.substring(6, 8), 10);
+  const mm = Number.parseInt(nik.substring(8, 10), 10);
+  const yy = Number.parseInt(nik.substring(10, 12), 10);
+  const isFemale = dd > 40;
+  const actualDay = isFemale ? dd - 40 : dd;
+  const gender = isFemale ? "F" : "M";
+  const fullYear = disambiguateYear(yy);
+  const birthDate = new Date(fullYear, mm - 1, actualDay);
+  const sequenceNumber = nik.substring(12, 16);
+  return {
+    valid: true,
+    nik,
+    provinceCode,
+    regencyCode,
+    districtCode,
+    birthDate,
+    gender,
+    sequenceNumber
+  };
+}
+export {
+  generateNIK,
+  parseNIK,
+  validateNIK
+};

package/dist/parse.cjs

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/parse.ts
+var parse_exports = {};
+__export(parse_exports, {
+  parseNIK: () => parseNIK
+});
+module.exports = __toCommonJS(parse_exports);
+
+// src/utils.ts
+function disambiguateYear(yy) {
+  const currentYY = (/* @__PURE__ */ new Date()).getFullYear() % 100;
+  return yy > currentYY ? 1900 + yy : 2e3 + yy;
+}
+
+// src/validate.ts
+var MIN_PROVINCE_CODE = 11;
+var MAX_PROVINCE_CODE = 97;
+var NIK_LENGTH = 16;
+var DIGITS_ONLY_PATTERN = /^\d{16}$/;
+function isValidCalendarDate(year, month, day) {
+  const date = new Date(year, month - 1, day);
+  return date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day;
+}
+function validateNIK(nik) {
+  if (typeof nik !== "string") {
+    return { valid: false, error: "NIK harus berupa string" };
+  }
+  if (nik.length !== NIK_LENGTH) {
+    return { valid: false, error: "NIK harus 16 digit" };
+  }
+  if (!DIGITS_ONLY_PATTERN.test(nik)) {
+    return { valid: false, error: "NIK hanya boleh berisi angka" };
+  }
+  const provinceCode = Number.parseInt(nik.substring(0, 2), 10);
+  if (provinceCode < MIN_PROVINCE_CODE || provinceCode > MAX_PROVINCE_CODE) {
+    return { valid: false, error: "Kode provinsi tidak valid" };
+  }
+  const dd = Number.parseInt(nik.substring(6, 8), 10);
+  const mm = Number.parseInt(nik.substring(8, 10), 10);
+  const yy = Number.parseInt(nik.substring(10, 12), 10);
+  const isValidMaleDD = dd >= 1 && dd <= 31;
+  const isValidFemaleDD = dd >= 41 && dd <= 71;
+  if (!isValidMaleDD && !isValidFemaleDD) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  if (mm < 1 || mm > 12) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  const actualDay = isValidFemaleDD ? dd - 40 : dd;
+  const fullYear = disambiguateYear(yy);
+  if (!isValidCalendarDate(fullYear, mm, actualDay)) {
+    return { valid: false, error: "Tanggal lahir tidak valid" };
+  }
+  const seq = nik.substring(12, 16);
+  if (seq === "0000") {
+    return { valid: false, error: "Nomor urut tidak valid" };
+  }
+  return { valid: true };
+}
+
+// src/parse.ts
+function parseNIK(nik) {
+  const validation = validateNIK(nik);
+  if (!validation.valid) {
+    return { valid: false, error: validation.error };
+  }
+  const provinceCode = nik.substring(0, 2);
+  const regencyCode = nik.substring(0, 4);
+  const districtCode = nik.substring(0, 6);
+  const dd = Number.parseInt(nik.substring(6, 8), 10);
+  const mm = Number.parseInt(nik.substring(8, 10), 10);
+  const yy = Number.parseInt(nik.substring(10, 12), 10);
+  const isFemale = dd > 40;
+  const actualDay = isFemale ? dd - 40 : dd;
+  const gender = isFemale ? "F" : "M";
+  const fullYear = disambiguateYear(yy);
+  const birthDate = new Date(fullYear, mm - 1, actualDay);
+  const sequenceNumber = nik.substring(12, 16);
+  return {
+    valid: true,
+    nik,
+    provinceCode,
+    regencyCode,
+    districtCode,
+    birthDate,
+    gender,
+    sequenceNumber
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  parseNIK
+});

package/dist/parse.d.cts

@@ -0,0 +1,81 @@
+import { NIKResult } from './types.cjs';
+
+/**
+ * Modul parsing NIK (Nomor Induk Kependudukan).
+ *
+ * Menyediakan fungsi {@link parseNIK} yang memvalidasi dan mengekstrak
+ * semua komponen dari NIK: kode wilayah (provinsi, kabupaten/kota, kecamatan),
+ * tanggal lahir, jenis kelamin, dan nomor urut registrasi.
+ *
+ * Kode wilayah yang dikembalikan menggunakan format **Kemendagri** (bukan BPS).
+ * Untuk resolve ke nama wilayah, gunakan package `kode-wilayah-id` dengan
+ * fungsi `getProvinceByKemendagriCode()`, `getRegencyByKemendagriCode()`, dll.
+ *
+ * @module parse
+ *
+ * @example
+ * ```typescript
+ * import { parseNIK } from 'nik-id/parse';
+ *
+ * const result = parseNIK("3204076508850001");
+ * if (result.valid) {
+ *   console.log(result.provinceCode);    // "32"
+ *   console.log(result.regencyCode);     // "3204"
+ *   console.log(result.districtCode);    // "320407"
+ *   console.log(result.gender);          // "F"
+ *   console.log(result.birthDate);       // Date: 1985-08-25
+ *   console.log(result.sequenceNumber);  // "0001"
+ * }
+ * ```
+ */
+
+/**
+ * Parse NIK menjadi komponen-komponennya.
+ *
+ * Fungsi ini pertama memvalidasi NIK menggunakan {@link validateNIK},
+ * kemudian mengekstrak setiap komponen ke dalam object {@link NIKResult}.
+ *
+ * Komponen yang diekstrak:
+ * - **provinceCode** — kode provinsi Kemendagri (2 digit)
+ * - **regencyCode** — kode kabupaten/kota Kemendagri (4 digit)
+ * - **districtCode** — kode kecamatan Kemendagri (6 digit)
+ * - **birthDate** — tanggal lahir sebagai `Date` object
+ * - **gender** — jenis kelamin (`"M"` atau `"F"`)
+ * - **sequenceNumber** — nomor urut registrasi (4 digit)
+ *
+ * @param nik - String NIK 16 digit yang akan di-parse
+ * @returns {@link NIKResult} — discriminated union yang bisa di-narrow
+ *          menggunakan `result.valid`
+ *
+ * @example
+ * ```typescript
+ * const result = parseNIK("3204076508850001");
+ * if (result.valid) {
+ *   // result bertipe NIKValid — semua field tersedia
+ *   console.log(result.provinceCode);    // "32"
+ *   console.log(result.regencyCode);     // "3204"
+ *   console.log(result.districtCode);    // "320407"
+ *   console.log(result.birthDate);       // Date: 1985-08-25
+ *   console.log(result.gender);          // "F"
+ *   console.log(result.sequenceNumber);  // "0001"
+ * } else {
+ *   // result bertipe NIKInvalid — ada error
+ *   console.log(result.error); // "NIK harus 16 digit"
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Integrasi dengan kode-wilayah-id
+ * import { getProvinceByKemendagriCode } from 'kode-wilayah-id';
+ *
+ * const result = parseNIK("3204076508850001");
+ * if (result.valid) {
+ *   const prov = getProvinceByKemendagriCode(result.provinceCode);
+ *   console.log(prov?.name); // "JAWA BARAT"
+ * }
+ * ```
+ */
+declare function parseNIK(nik: string): NIKResult;
+
+export { parseNIK };