@indodev/toolkit

TypeScript utilities for Indonesian data. Handles Rupiah formatting, terbilang, NIK validation, phone normalization, date formatting, and text rules that generic libraries don't cover.

Install

npm install @indodev/toolkit

Highlights

Currency — Smart Rupiah Formatting

import {
  formatRupiah,
  formatCompact,
  toWords,
  formatAccounting,
} from '@indodev/toolkit/currency';

formatRupiah(1500000); // 'Rp 1.500.000'
formatCompact(1500000); // 'Rp 1,5 juta'
formatCompact(1000000); // 'Rp 1 juta'  ← NO "1,0 juta"
toWords(1500000); // 'satu juta lima ratus ribu rupiah'
formatAccounting(-500000); // '(Rp 500.000)'

Text — Indonesian-Specific Rules

import {
  toTitleCase,
  expandAbbreviation,
  toFormal,
  isAlay,
  slugify,
} from '@indodev/toolkit/text';

toTitleCase('pt bank central asia'); // 'PT Bank Central Asia'
expandAbbreviation('Jl. Sudirman'); // 'Jalan Sudirman'
expandAbbreviation('Dr. Joko, S.H.'); // 'Doktor Joko, Sarjana Hukum'
toFormal('gw lg makan deh'); // 'saya sedang makan'
isAlay('aqU sAyAnG kMu'); // true
slugify('Pria & Wanita'); // 'pria-dan-wanita'

DateTime — Indonesian Locale

import {
  formatDate,
  parseDate,
  toRelativeTime,
  getAge,
  isWorkingDay,
} from '@indodev/toolkit/datetime';

formatDate(new Date('2026-01-02'), 'long'); // '2 Januari 2026'
parseDate('02-01-2026'); // Date(2026, 0, 2)
toRelativeTime(Date.now() - 3600000); // '1 jam yang lalu'
getAge('1990-06-15'); // { years: 35, months: 9, ... }
isWorkingDay(new Date('2026-01-01')); // false (Tahun Baru)

More Modules

Validate and parse Indonesian identity documents:

import { validateNIK, parseNIK } from '@indodev/toolkit/nik';
import { validateNPWP, formatNPWP } from '@indodev/toolkit/npwp';
import { formatPhoneNumber, maskPhoneNumber } from '@indodev/toolkit/phone';

validateNIK('3201234567890123'); // true
parseNIK('3201234567890123').province.name; // 'Jawa Barat'

validateNPWP('012345678901234'); // true
formatPhoneNumber('081234567890', 'international'); // '+62 812-3456-7890'
maskPhoneNumber('081234567890'); // '0812****7890'

All Modules

| Module | Description | | --------------------------------------------------------------- | -------------------------------------------------------------- | | Currency | Format Rupiah, terbilang, split amounts, percentages | | Text | Title case, slugs, abbreviations, case conversion, masking | | DateTime | Indonesian date formatting, relative time, age calculation | | NIK | Validate, parse, and mask Indonesian National Identity Numbers | | NPWP | Validate and format Tax Identification Numbers | | Phone | Format, validate, and detect mobile operators | | Email | Validate emails with disposable domain detection | | Plate | Validate license plates with region detection | | VIN | Validate Vehicle Identification Numbers (ISO 3779) |

Full docs, examples, and API reference at toolkit.adamm.cloud

MIT