nusaindex

README

NusaIndex

Validate, parse, and format Indonesian data, with reference data that stays current. For Go, TypeScript, and AI agents.

NIK, NPWP (including the 16-digit format and NITKU), phone numbers, vehicle plates, NIP, NISN, bank accounts, regions down to village level, national holidays and collective leave, working days, and Rupiah.

Unofficial. Not affiliated with Dukcapil, DJP, Komdigi, Polri, Bank Indonesia, or any Indonesian government agency.

Features

• Native Go and TypeScript libraries with the same API and identical behavior, checked by shared test vectors
• Zero runtime dependencies and fully offline: your users' data never leaves your process
• Parse what a number encodes: region, birth date and sex from a NIK, brand and operator from a phone number
• Region data from the latest Ministry of Home Affairs decree, with old codes mapped to their current regions
• Holidays, collective leave, and working-day arithmetic for payroll, SLAs, and due dates
• Rupiah formatting and spelling in words, PII masking for logs, and realistic test data
• Zod and Valibot schemas, a CLI, and an MCP server for AI agents

What it does not do

It checks that a number is well-formed. It cannot tell you whether a NIK, NPWP, plate, or phone number is real, or who it belongs to. Use the official verification services for that.

Status

In active development. Not ready for general use yet.

Requirements

• Go 1.25 or later, or
• Node.js 22.18 or later, a modern browser, Bun, or Deno