nik-parser-indonesia 1.0.1 → 1.0.2

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const parse: (nik: string) => import("./src/types").ParseResult;
+export * from './src/types';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = void 0;
+// index.ts
+const NikParser_1 = require("./src/NikParser");
+const parserInstance = new NikParser_1.NikParser();
+const parse = (nik) => parserInstance.parse(nik);
+exports.parse = parse;
+__exportStar(require("./src/types"), exports); // Ekspor tipe datanya juga agar bisa dipakai client

package/dist/src/NikParser.d.ts

@@ -0,0 +1,6 @@
+import { ParseResult } from './types';
+export declare class NikParser {
+    private dataWilayah;
+    constructor();
+    parse(nik: string): ParseResult;
+}

package/dist/src/NikParser.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NikParser = void 0;
+//  Gunakan import statis di bagian paling atas file
+const data_wilayah_json_1 = __importDefault(require("../data/data_wilayah.json"));
+class NikParser {
+    dataWilayah;
+    constructor() {
+        //  Sangat bersih! Tidak perlu try-catch lagi untuk load file,
+        // karena jika file JSON hilang atau salah path, compiler TS akan langsung error saat build.
+        this.dataWilayah = data_wilayah_json_1.default;
+    }
+    parse(nik) {
+        // Validation Guard
+        if (!nik || typeof nik !== 'string') {
+            return { isValid: false, error: "NIK harus berupa string", biodata: null, wilayah: null };
+        }
+        const cleanNik = nik.trim();
+        if (cleanNik.length !== 16 || isNaN(Number(cleanNik))) {
+            return { isValid: false, error: "NIK harus berjumlah 16 digit angka", biodata: null, wilayah: null };
+        }
+        // 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 jenis_kelamin = "Pria";
+        if (tanggal > 40) {
+            jenis_kelamin = "Wanita";
+            tanggal = tanggal - 40;
+        }
+        const padTanggal = String(tanggal).padStart(2, '0');
+        const tahunPenuh = parseInt(tahun, 10) > 26 ? `19${tahun}` : `20${tahun}`;
+        const tanggal_lahir = `${padTanggal}-${bulan}-${tahunPenuh}`;
+        // 2. Parsing Wilayah Domisili
+        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 { isValid: false, error: "Kode Provinsi tidak terdaftar", biodata: null, wilayah: null };
+        // Cari Kabupaten/Kota
+        const kabupaten = provinsi.kabupaten?.find(k => k.code === kodeKab);
+        if (!kabupaten)
+            return { isValid: false, error: "Kode Kabupaten/Kota tidak terdaftar", biodata: null, wilayah: null };
+        // Cari Kecamatan
+        const kecamatan = kabupaten.kecamatan?.find(kec => kec.code === kodeKec);
+        if (!kecamatan)
+            return { isValid: false, error: "Kode Kecamatan tidak terdaftar", biodata: null, wilayah: null };
+        return {
+            isValid: true,
+            error: null,
+            biodata: {
+                jenis_kelamin,
+                tanggal_lahir
+            },
+            wilayah: {
+                provinsi: provinsi.name,
+                kabupaten: kabupaten.name,
+                kecamatan: kecamatan.name
+            }
+        };
+    }
+}
+exports.NikParser = NikParser;

package/dist/src/types.d.ts

@@ -0,0 +1,26 @@
+export interface Biodata {
+    jenis_kelamin: "Pria" | "Wanita";
+    tanggal_lahir: string;
+}
+export interface Wilayah {
+    provinsi: string;
+    kabupaten: string;
+    kecamatan: string;
+}
+export interface ParseResult {
+    isValid: boolean;
+    error: string | null;
+    biodata: Biodata | null;
+    wilayah: Wilayah | null;
+}
+export interface RegionNode {
+    code: string;
+    name: string;
+    kabupaten?: RegionNode[];
+    kecamatan?: RegionNode[];
+    desa?: Array<{
+        code: string;
+        name: string;
+        type: string;
+    }>;
+}

package/dist/src/types.js

@@ -0,0 +1,3 @@
+"use strict";
+// src/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/index.ts

@@ -0,0 +1,7 @@
+// index.ts
+import { NikParser } from './src/NikParser';
+
+const parserInstance = new NikParser();
+
+export const parse = (nik: string) => parserInstance.parse(nik);
+export * from './src/types'; // Ekspor tipe datanya juga agar bisa dipakai client

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "nik-parser-indonesia",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Library untuk melakukan parsing NIK (No Induk Kependudukan) Indonesia untuk mendapatkan info daerah, jenis kelamin, dan tanggal lahir.",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc"
   },
   "keywords": [
     "nik",
@@ -16,5 +17,7 @@
   ],
   "author": "Zealish",
   "license": "MIT",
-  "dependencies": {}
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
 }

package/src/NikParser.ts

@@ -0,0 +1,73 @@
+import { ParseResult, RegionNode } from './types';
+
+//  Gunakan import statis di bagian paling atas file
+import dataWilayahJson from '../data/data_wilayah.json';
+
+export class NikParser {
+    private dataWilayah: RegionNode[];
+
+    constructor() {
+        //  Sangat bersih! Tidak perlu try-catch lagi untuk load file,
+        // karena jika file JSON hilang atau salah path, compiler TS akan langsung error saat build.
+        this.dataWilayah = dataWilayahJson as RegionNode[];
+    }
+
+    public parse(nik: string): ParseResult {
+        // Validation Guard
+        if (!nik || typeof nik !== 'string') {
+            return { isValid: false, error: "NIK harus berupa string", biodata: null, wilayah: null };
+        }
+        
+        const cleanNik = nik.trim();
+        if (cleanNik.length !== 16 || isNaN(Number(cleanNik))) {
+            return { isValid: false, error: "NIK harus berjumlah 16 digit angka", biodata: null, wilayah: null };
+        }
+
+        // 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 jenis_kelamin: "Pria" | "Wanita" = "Pria";
+
+        if (tanggal > 40) {
+            jenis_kelamin = "Wanita";
+            tanggal = tanggal - 40;
+        }
+
+        const padTanggal = String(tanggal).padStart(2, '0');
+        const tahunPenuh = parseInt(tahun, 10) > 26 ? `19${tahun}` : `20${tahun}`;
+        const tanggal_lahir = `${padTanggal}-${bulan}-${tahunPenuh}`;
+
+        // 2. Parsing Wilayah Domisili
+        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 { isValid: false, error: "Kode Provinsi tidak terdaftar", biodata: null, wilayah: null };
+
+        // Cari Kabupaten/Kota
+        const kabupaten = provinsi.kabupaten?.find(k => k.code === kodeKab);
+        if (!kabupaten) return { isValid: false, error: "Kode Kabupaten/Kota tidak terdaftar", biodata: null, wilayah: null };
+
+        // Cari Kecamatan
+        const kecamatan = kabupaten.kecamatan?.find(kec => kec.code === kodeKec);
+        if (!kecamatan) return { isValid: false, error: "Kode Kecamatan tidak terdaftar", biodata: null, wilayah: null };
+
+        return {
+            isValid: true,
+            error: null,
+            biodata: {
+                jenis_kelamin,
+                tanggal_lahir
+            },
+            wilayah: {
+                provinsi: provinsi.name,
+                kabupaten: kabupaten.name,
+                kecamatan: kecamatan.name
+            }
+        };
+    }
+}

package/src/types.ts

@@ -0,0 +1,28 @@
+// src/types.ts
+
+export interface Biodata {
+    jenis_kelamin: "Pria" | "Wanita";
+    tanggal_lahir: string;
+}
+
+export interface Wilayah {
+    provinsi: string;
+    kabupaten: string;
+    kecamatan: string;
+}
+
+export interface ParseResult {
+    isValid: boolean;
+    error: string | null;
+    biodata: Biodata | null;
+    wilayah: Wilayah | null;
+}
+
+// Interface untuk data JSON internal
+export interface RegionNode {
+    code: string;
+    name: string;
+    kabupaten?: RegionNode[];
+    kecamatan?: RegionNode[];
+    desa?: Array<{ code: string; name: string; type: string }>;
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "lib": ["ES2022"],
+    "declaration": true, // Pembuat file .d.ts untuk suggestion otomatis
+    "outDir": "./dist", // Semua hasil compile masuk ke folder dist
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true // Mengizinkan TS membaca file JSON langsung
+  },
+  "include": ["src/**/*", "index.ts"]
+}

package/index.js

@@ -1,10 +0,0 @@
-// 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),
-};