nik-parser-indonesia 1.0.0

package/index.js

@@ -0,0 +1,10 @@
+// index.js
+const NikParser = require("./src/NikParser");
+
+// Buat instance secara internal sekali saja (Singleton pattern)
+const parserInstance = new NikParser();
+
+// Ekspor fungsi parser langsung
+module.exports = {
+  parse: (nik) => parserInstance.parse(nik),
+};

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "nik-parser-indonesia",
+  "version": "1.0.0",
+  "description": "Library untuk melakukan parsing NIK (No Induk Kependudukan) Indonesia untuk mendapatkan info daerah, jenis kelamin, dan tanggal lahir.",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "nik",
+    "parser",
+    "indonesia",
+    "ktp",
+    "wilayah",
+    "kepmendagri"
+  ],
+  "author": "Zealish",
+  "license": "MIT",
+  "dependencies": {}
+}

package/src/NikParser.js

@@ -0,0 +1,89 @@
+// src/NikParser.js
+const path = require("path");
+
+class NikParser {
+  constructor() {
+    // Langsung load data wilayah secara internal dari folder data
+    try {
+      this.dataWilayah = require("../data/data_wilayah.json");
+    } catch (error) {
+      throw new Error(
+        "Gagal memuat data wilayah internal. Pastikan file JSON tersedia di folder data.",
+      );
+    }
+  }
+
+  /**
+   * Memparsing NIK untuk mendapatkan info Wilayah, Tanggal Lahir, dan Jenis Kelamin
+   * @param {string} nik - 16 digit Nomor Induk Kependudukan
+   * @returns {Object} Hasil parsing atau objek error
+   */
+  parse(nik) {
+    // Validation Guard
+    if (!nik || typeof nik !== "string") {
+      return { valid: false, error: "NIK harus berupa string" };
+    }
+
+    const cleanNik = nik.trim();
+    if (cleanNik.length !== 16 || isNaN(cleanNik)) {
+      return { valid: false, error: "NIK harus berjumlah 16 digit angka" };
+    }
+
+    // 1. Parsing Tanggal Lahir & Jenis Kelamin
+    let tanggal = parseInt(cleanNik.substring(6, 8), 10);
+    const bulan = cleanNik.substring(8, 10);
+    const tahun = cleanNik.substring(10, 12);
+
+    let jenisKelamin = "Pria";
+
+    if (tanggal > 40) {
+      jenisKelamin = "Wanita";
+      tanggal = tanggal - 40;
+    }
+
+    const padTanggal = String(tanggal).padStart(2, "0");
+
+    // Aturan Abad: Jika tahun lahir > 26 (Asumsi tahun berjalan 2026), berarti lahir di tahun 19xx
+    const tahunPenuh = parseInt(tahun, 10) > 26 ? `19${tahun}` : `20${tahun}`;
+    const tanggalLahirFull = `${padTanggal}-${bulan}-${tahunPenuh}`;
+
+    // 2. Parsing Wilayah Domisili NIK
+    const kodeProv = cleanNik.substring(0, 2);
+    const kodeKab = `${kodeProv}.${cleanNik.substring(2, 4)}`;
+    const kodeKec = `${kodeKab}.${cleanNik.substring(4, 6)}`;
+
+    // Cari Provinsi
+    const provinsi = this.dataWilayah.find((p) => p.code === kodeProv);
+    if (!provinsi)
+      return { valid: false, error: "Kode Provinsi pada NIK tidak terdaftar" };
+
+    // Cari Kabupaten/Kota
+    const kabupaten = provinsi.kabupaten.find((k) => k.code === kodeKab);
+    if (!browse_result)
+      return {
+        valid: false,
+        error: "Kode Kabupaten/Kota pada NIK tidak terdaftar",
+      };
+
+    // Cari Kecamatan
+    const kecamatan = kabupaten.kecamatan.find((kec) => kec.code === kodeKec);
+    if (!kecamatan)
+      return { valid: false, error: "Kode Kecamatan pada NIK tidak terdaftar" };
+
+    return {
+      valid: true,
+      error: null,
+      biodata: {
+        jenisKelamin,
+        tanggalLahir: tanggalLahirFull,
+      },
+      wilayah: {
+        provinsi: provinsi.name,
+        kabupaten: kabupaten.name,
+        kecamatan: kecamatan.name,
+      },
+    };
+  }
+}
+
+module.exports = NikParser;