nik-id 1.0.0

package/dist/validate.d.cts

@@ -0,0 +1,81 @@
+import { ValidationResult } from './types.cjs';
+
+/**
+ * Modul validasi NIK (Nomor Induk Kependudukan).
+ *
+ * Menyediakan fungsi {@link validateNIK} untuk mengecek apakah sebuah string
+ * merupakan NIK yang valid secara format. Validasi dilakukan secara bertahap:
+ * tipe data → panjang → isi digit → kode provinsi → tanggal lahir → nomor urut.
+ *
+ * Modul ini **tidak** memvalidasi apakah kode wilayah benar-benar terdaftar
+ * di database Kemendagri — hanya format dan range yang dicek. Untuk resolve
+ * nama wilayah dari kode, gunakan package `kode-wilayah-id`.
+ *
+ * @module validate
+ *
+ * @example
+ * ```typescript
+ * import { validateNIK } from 'nik-id/validate';
+ *
+ * const result = validateNIK("3204076508850001");
+ * if (result.valid) {
+ *   console.log("NIK valid!");
+ * } else {
+ *   console.log(result.error);
+ * }
+ * ```
+ */
+
+/**
+ * Validasi format NIK (Nomor Induk Kependudukan).
+ *
+ * Melakukan pengecekan bertahap terhadap string NIK:
+ *
+ * 1. **Tipe data** — input harus berupa `string`
+ * 2. **Panjang** — harus tepat 16 karakter
+ * 3. **Format** — harus semua digit angka (0-9)
+ * 4. **Kode provinsi** — 2 digit pertama harus dalam range 11-97
+ * 5. **Tanggal lahir** — digit 7-12 harus membentuk tanggal yang valid
+ *    (DD 01-31 untuk laki-laki, 41-71 untuk perempuan; MM 01-12; YY 00-99)
+ * 6. **Nomor urut** — digit 13-16 tidak boleh `0000`
+ *
+ * Validasi berhenti di error pertama yang ditemukan (fail-fast).
+ *
+ * @param nik - String yang akan divalidasi sebagai NIK
+ * @returns {@link ValidationResult} — `{ valid: true }` kalau valid,
+ *          `{ valid: false, error: "..." }` kalau tidak
+ *
+ * @example
+ * ```typescript
+ * // NIK valid
+ * validateNIK("3204076508850001");
+ * // { valid: true }
+ *
+ * // Input bukan string
+ * validateNIK(12345 as any);
+ * // { valid: false, error: "NIK harus berupa string" }
+ *
+ * // Panjang salah
+ * validateNIK("123");
+ * // { valid: false, error: "NIK harus 16 digit" }
+ *
+ * // Mengandung huruf
+ * validateNIK("320407650885000A");
+ * // { valid: false, error: "NIK hanya boleh berisi angka" }
+ *
+ * // Kode provinsi di luar range
+ * validateNIK("0004076508850001");
+ * // { valid: false, error: "Kode provinsi tidak valid" }
+ *
+ * // Tanggal tidak ada di kalender
+ * validateNIK("3204073102850001");  // 31 Februari
+ * // { valid: false, error: "Tanggal lahir tidak valid" }
+ *
+ * // Nomor urut 0000
+ * validateNIK("3204076508850000");
+ * // { valid: false, error: "Nomor urut tidak valid" }
+ * ```
+ */
+declare function validateNIK(nik: string): ValidationResult;
+
+export { validateNIK };

package/dist/validate.d.ts

@@ -0,0 +1,81 @@
+import { ValidationResult } from './types.js';
+
+/**
+ * Modul validasi NIK (Nomor Induk Kependudukan).
+ *
+ * Menyediakan fungsi {@link validateNIK} untuk mengecek apakah sebuah string
+ * merupakan NIK yang valid secara format. Validasi dilakukan secara bertahap:
+ * tipe data → panjang → isi digit → kode provinsi → tanggal lahir → nomor urut.
+ *
+ * Modul ini **tidak** memvalidasi apakah kode wilayah benar-benar terdaftar
+ * di database Kemendagri — hanya format dan range yang dicek. Untuk resolve
+ * nama wilayah dari kode, gunakan package `kode-wilayah-id`.
+ *
+ * @module validate
+ *
+ * @example
+ * ```typescript
+ * import { validateNIK } from 'nik-id/validate';
+ *
+ * const result = validateNIK("3204076508850001");
+ * if (result.valid) {
+ *   console.log("NIK valid!");
+ * } else {
+ *   console.log(result.error);
+ * }
+ * ```
+ */
+
+/**
+ * Validasi format NIK (Nomor Induk Kependudukan).
+ *
+ * Melakukan pengecekan bertahap terhadap string NIK:
+ *
+ * 1. **Tipe data** — input harus berupa `string`
+ * 2. **Panjang** — harus tepat 16 karakter
+ * 3. **Format** — harus semua digit angka (0-9)
+ * 4. **Kode provinsi** — 2 digit pertama harus dalam range 11-97
+ * 5. **Tanggal lahir** — digit 7-12 harus membentuk tanggal yang valid
+ *    (DD 01-31 untuk laki-laki, 41-71 untuk perempuan; MM 01-12; YY 00-99)
+ * 6. **Nomor urut** — digit 13-16 tidak boleh `0000`
+ *
+ * Validasi berhenti di error pertama yang ditemukan (fail-fast).
+ *
+ * @param nik - String yang akan divalidasi sebagai NIK
+ * @returns {@link ValidationResult} — `{ valid: true }` kalau valid,
+ *          `{ valid: false, error: "..." }` kalau tidak
+ *
+ * @example
+ * ```typescript
+ * // NIK valid
+ * validateNIK("3204076508850001");
+ * // { valid: true }
+ *
+ * // Input bukan string
+ * validateNIK(12345 as any);
+ * // { valid: false, error: "NIK harus berupa string" }
+ *
+ * // Panjang salah
+ * validateNIK("123");
+ * // { valid: false, error: "NIK harus 16 digit" }
+ *
+ * // Mengandung huruf
+ * validateNIK("320407650885000A");
+ * // { valid: false, error: "NIK hanya boleh berisi angka" }
+ *
+ * // Kode provinsi di luar range
+ * validateNIK("0004076508850001");
+ * // { valid: false, error: "Kode provinsi tidak valid" }
+ *
+ * // Tanggal tidak ada di kalender
+ * validateNIK("3204073102850001");  // 31 Februari
+ * // { valid: false, error: "Tanggal lahir tidak valid" }
+ *
+ * // Nomor urut 0000
+ * validateNIK("3204076508850000");
+ * // { valid: false, error: "Nomor urut tidak valid" }
+ * ```
+ */
+declare function validateNIK(nik: string): ValidationResult;
+
+export { validateNIK };

package/dist/validate.js

@@ -0,0 +1,54 @@
+// 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 };
+}
+export {
+  validateNIK
+};

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "nik-id",
+  "version": "1.0.0",
+  "description": "Parser, validator, dan generator NIK (Nomor Induk Kependudukan) Indonesia — TypeScript, zero dependencies",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./validate": {
+      "import": {
+        "types": "./dist/validate.d.ts",
+        "default": "./dist/validate.js"
+      },
+      "require": {
+        "types": "./dist/validate.d.cts",
+        "default": "./dist/validate.cjs"
+      }
+    },
+    "./parse": {
+      "import": {
+        "types": "./dist/parse.d.ts",
+        "default": "./dist/parse.js"
+      },
+      "require": {
+        "types": "./dist/parse.d.cts",
+        "default": "./dist/parse.cjs"
+      }
+    },
+    "./generate": {
+      "import": {
+        "types": "./dist/generate.d.ts",
+        "default": "./dist/generate.js"
+      },
+      "require": {
+        "types": "./dist/generate.d.cts",
+        "default": "./dist/generate.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types.d.ts"
+      },
+      "require": {
+        "types": "./dist/types.d.cts"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check src/ tests/",
+    "lint:fix": "biome check --write src/ tests/",
+    "format": "biome format --write src/ tests/",
+    "format:check": "biome format src/ tests/",
+    "typecheck": "tsc --noEmit",
+    "audit": "npm audit --audit-level=moderate",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run test:coverage && npm run build"
+  },
+  "keywords": [
+    "nik",
+    "ktp",
+    "indonesia",
+    "validator",
+    "parser",
+    "kependudukan",
+    "identitas",
+    "kemendagri",
+    "dukcapil"
+  ],
+  "author": "Sumitro Aji Prabowo",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sumitroajiprabowo/nik-id.git"
+  },
+  "homepage": "https://github.com/sumitroajiprabowo/nik-id#readme",
+  "bugs": {
+    "url": "https://github.com/sumitroajiprabowo/nik-id/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@vitest/coverage-v8": "^4.1.6",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  }
+}