superjs-core 0.4.0 → 0.4.2

package/README.md

@@ -1,179 +1,167 @@
 # superjs-core
 
-> **All-in-one JavaScript toolkit — Standard Library + Dependency Scanner + 🇮🇩 Indonesia Validation + Logger + Typed Errors**
+> **JavaScript toolkit all-in-one buat developer Indonesia — Standard Library + Dependency Scanner + 🇮🇩 Validasi NIK/NPWP/Phone + Logger + Typed Errors**
 
 ```bash
 npm install superjs-core
 ```
 
-One package for all your JavaScript needs: utility functions, async helpers, crypto, path manipulation, typed errors, structured logging, **plus** dependency health scanner and Indonesia-specific data validation (NIK, NPWP, Phone).
+Satu package buat semua kebutuhan JavaScript lo: utility functions, async helpers, crypto, path manipulation, typed errors, structured logging, **plus** dependency health scanner dan validasi data Indonesia (NIK, NPWP, Phone).
+
+**100% buat programmer Indonesia. Zero dependency runtime.**
 
 ---
 
-## Features
+## Fitur Unggulan 🇮🇩
 
-- ✅ **90+ functions** — 16 modules covering everything from `deepClone` to `terbilang`
-- ✅ **Tree-shakeable** — import only what you need via subpath exports
-- ✅ **TypeScript strict** — full type safety, zero `any`
-- ✅ **Zero runtime dependencies** — commander + picocolors are CLI-only
-- ✅ **ESM-first** — target ES2022, optimized for Node 18+ and modern browsers
-- ✅ **Biome linted** — consistent code style enforced
+| Fitur | Fungsi |
+|-------|--------|
+| **Validasi NIK** | `isNIK('3201010203940001')` — validasi 16 digit + tanggal lahir |
+| **Validasi NPWP** | `isNPWP('12.345.678.9-012.344')` — dengan checksum otomatis |
+| **Validasi Nomor HP** | `isPhone('08123456789')` — support semua prefix Indonesia |
+| **Terbilang** | `terbilang(1500000)` → "satu juta lima ratus ribu" |
+| **Format Rupiah** | `formatRupiah(1500000)` → "Rp1.500.000" |
+| **Format Waktu** | `timeAgo(new Date(...))` → "5 detik yang lalu" |
+| **Timezone WIB/WITA/WIT** | `formatInTimezone(date, 'HH', TIMEZONE_WIB)` → "07" |
+| **Dependency Scanner** | `npx dep-exray .` — scan project lo |
 
 ---
 
-## Modules
+## 16 Modules
 
-| Module | Key Functions |
-|--------|---------------|
-| **core** | deepClone, deepMerge, debounce, throttle, memoize, retry, once |
-| **math** | add/sub/mul/div (safe float), median, stddev, percentile, correlation, formatCurrency |
-| **date** | formatDate, parseDate, timeAgo, Duration, timezone helpers (WIB/WITA/WIT) |
-| **collection** | sortBy, groupBy, shuffle, topoSort, slidingWindows, chunk |
-| **string** | camelCase, uuid, nanoid, slugify, levenshtein, fuzzyMatch, maskString |
+| Module | Fungsi Unggulan |
+|--------|----------------|
+| **core** | deepClone, deepMerge, debounce, deepEqual, pipe, throttle, memoize |
+| **math** | add/sub/mul/div (safe float), median, stddev, percentile, formatCurrency |
+| **date** | formatDate, timeAgo, Duration, timezone helpers (WIB/WITA/WIT) |
+| **collection** | sortBy, groupBy, shuffle, topoSort, slidingWindows, deepGet, deepSet |
+| **string** | camelCase, uuid, nanoid, slugify, **terbilang**, **formatRupiah**, maskString, formatBytes |
 | **async** | sleep, parallelMap, Queue, Semaphore, memoizeAsync, retryAsync |
-| **io** | parseCsv, stringifyCsv, safeJsonParse, env, envInt, envBool |
+| **io** | parseCsv, stringifyCsv, safeJsonParse, env |
 | **type** | 20+ type guards (isString, isNil, assertDefined, getType) |
 | **crypto** | hash, base64, generateToken, generateOTP, constantTimeEqual |
 | **path** | join, resolve, basename, dirname, extname, normalize |
-| **validation** | isNIK, isNPWP, isPhone("id"), isEmail, isURL |
+| **color** | hexToRgb, rgbToHex, lighten, darken, contrastRatio, meetsWCAG |
+| **validation** | **isNIK**, **isNPWP**, **isPhone("id")**, isEmail, isURL |
 | **error** | createError (typed + HTTP status), TypedError, MultiError |
 | **logger** | Logger class, child loggers, console/JSON/file transports |
 | **dep-exray** | scanProject, generateReport, analyzeUsage, CLI: `npx dep-exray .` |
 
-### 🇮🇩 Indonesian Locale
-
-| Function | Description |
-|----------|-------------|
-| `terbilang(value)` | Convert numbers to Indonesian words ("satu juta lima ratus ribu") |
-| `formatRupiah(value)` | Format as Rupiah ("Rp1.500.000") |
-| `isNIK(value)` | Validate Indonesian NIK (16-digit ID number) |
-| `isNPWP(value)` | Validate Indonesian NPWP (tax ID with checksum) |
-| `isPhone(value)` | Validate Indonesian phone numbers |
-
 ---
 
-## Quick Examples
+## Contoh Kode
 
 ```typescript
-import { deepClone, debounce } from "superjs-core"
-import { formatDate, timeAgo } from "superjs-core/date"
-import { groupBy, topoSort } from "superjs-core/collection"
+import { deepClone } from "superjs-core"
+import { formatDate, timeAgo, TIMEZONE_WIB } from "superjs-core/date"
 import { Queue } from "superjs-core/async"
-import { uuid, maskString, terbilang, formatRupiah } from "superjs-core/string"
-import { generateToken } from "superjs-core/crypto"
+import { uuid, maskString, terbilang, formatRupiah, formatBytes } from "superjs-core/string"
 import { isNIK, isNPWP, isPhone } from "superjs-core/validation"
 import { createError } from "superjs-core/error"
 import { Logger } from "superjs-core/logger"
-import { median, stddev, formatCurrency } from "superjs-core/math"
-import { scanProject } from "superjs-core/dep-exray"
+import { hexToRgb, contrastRatio } from "superjs-core/color"
 
-// Deep clone with circular reference support
-const cloned = deepClone({ a: 1, b: { c: new Date() } })
-
-// Safe math (0.1 + 0.2 = 0.3 ✅)
-import { add } from "superjs-core/math"
-console.log(add(0.1, 0.2)) // 0.3
+// Validasi data Indonesia
+isNIK("3201010203940001")     // true
+isNPWP("12.345.678.9-012.344") // true
+isPhone("08123456789")        // true
 
-// Date formatting without moment
-console.log(formatDate(new Date(), "DD/MM/YYYY")) // "28/06/2026"
-console.log(timeAgo(new Date(Date.now() - 5000))) // "5 seconds ago"
+// Konversi angka ke kata
+terbilang(1500000)  // "satu juta lima ratus ribu"
+formatRupiah(1500000)  // "Rp1.500.000"
 
-// Priority task queue
-const queue = new Queue({ concurrency: 2 })
-await queue.add(() => fetch("/api/data"))
+// Relative time
+timeAgo(new Date(Date.now() - 5000)) // "5 detik yang lalu"
 
-// Indonesia validation
-isNIK("3201010203940001") // true
-isNPWP("12.345.678.9-012.344") // true
-isPhone("08123456789") // true
+// Mask data sensitif (PDPA compliance)
+maskString("08123456789") // "081*****789"
 
-// Indonesian locale
-terbilang(1500000) // "satu juta lima ratus ribu"
-formatRupiah(1500000) // "Rp1.500.000"
+// Format file size
+formatBytes(1048576) // "1 MB"
 
-// Statistics
-median([1, 2, 3, 4, 5]) // 3
-percentile([1, 2, 3, 4, 5], 90) // 4.6
-formatCurrency(1500000, { locale: "en-US", currency: "USD" }) // "$1,500,000"
+// Color utilities
+hexToRgb("#ff0000") // { r: 255, g: 0, b: 0 }
+contrastRatio("#000000", "#ffffff") // 21
 
 // Typed errors
-throw createError("VALIDATION_ERROR", "Email required", { details: { field: "email" } })
+throw createError("VALIDATION_ERROR", "Email wajib diisi")
 
 // Structured logger
 const log = new Logger({ level: "info", name: "app" })
 log.info("Server started", { port: 3000 })
-
-// Dependency scanning
-const report = await scanProject({ path: "./my-project" })
-console.log(report.totalEstimatedSize) // "2.3 MB"
 ```
 
 ---
 
-## dep-exray — Dependency Health Scanner (built-in)
+## dep-exray — Dependency Health Scanner
 
-**Scan your project to find bloated, unused, or vulnerable dependencies.**
+**Scan project lo buat nemuin dependency yang gak kepake, bloated, atau punya CVE.**
 
 ```bash
 npx dep-exray .
 npx dep-exray /path/to/project --json --verbose
 ```
 
-### Features
-- Detect replacements: lodash → superjs-core, moment → superjs-core/date, uuid → native crypto.randomUUID()
-- Estimate dependency size in MB/KB
-- CVE detection from known vulnerability database
-- JSON output for CI/CD integration
-- Usage analyzer — detects whether dependencies are actually imported
+### Fitur
+- Deteksi replacement: lodash → superjs-core, moment → superjs-core/date, uuid → native crypto.randomUUID()
+- Estimasi ukuran dependency
+- CVE detection
+- JSON output untuk CI/CD
+- Usage analyzer
+
+---
+
+## Quick Start
+
+```bash
+git clone https://github.com/superdevids/superjs.git
+cd superjs/packages/core
+npm install
+npx tsup              # Build
+npx vitest run        # Test (810 tests)
+npx dep-exray .       # Scan project sendiri
+```
+
+---
+
+## Statistik Test
+
+| File Tes | Jumlah |
+|----------|--------|
+| 18 file | **810** passing ✅ |
 
 ---
 
-## Project Structure
+## Struktur Project
 
 ```
 packages/core/
 ├── src/
-│   ├── core/          # deepClone, debounce, retry, once
+│   ├── core/          # deepClone, debounce, deepEqual, pipe
 │   ├── math/          # add, median, stddev, formatCurrency
-│   ├── date/          # formatDate, timeAgo, Duration, timezone
-│   ├── collection/    # groupBy, topoSort, slidingWindows
+│   ├── date/          # formatDate, timeAgo, Duration, WIB/WITA/WIT
+│   ├── collection/    # groupBy, topoSort, deepGet, deepSet
 │   ├── string/        # camelCase, terbilang, formatRupiah
 │   ├── async/         # sleep, Queue, Semaphore, memoizeAsync
 │   ├── io/            # parseCsv, safeJsonParse, env
 │   ├── type/          # 20+ type guards
 │   ├── crypto/        # hash, generateToken, base64
 │   ├── path/          # join, resolve, basename
+│   ├── color/         # hexToRgb, lighten, darken, contrastRatio
 │   ├── validation/    # isNIK, isNPWP, isPhone, isEmail, isURL
 │   ├── error/         # createError, TypedError, MultiError
 │   ├── logger/        # Logger, transports
 │   └── dep-exray/     # Dependency scanner
-├── tests/             # 757 tests
-├── dist/              # Built output
-├── tsup.config.ts
-├── vitest.config.ts
-├── biome.json
+├── tests/             # 810 tests
+├── dist/              # Hasil build
 └── package.json
 ```
 
 ---
 
-## Test Stats
-
-| Test Files | Tests |
-|-----------|-------|
-| 17 | **757** passing |
-
----
-
 ## Roadmap
 
-See [ROADMAP.md](./ROADMAP.md) for full details.
-
-### Priority
-- **P0 ✅** validation, error, logger modules
-- **P1 ✅** async (Queue, Semaphore), math (stats), string (terbilang), collection (topoSort), date (timeAgo)
-- **P2** core (pipe/compose, Result type), signal module, crypto (AES-GCM)
-- **P3** ml, color modules
+Lihat [ROADMAP.md](./ROADMAP.md) untuk detail lengkap.
 
 ---
 

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { generateReport } from './dep-exray/reporter/index.js';
 export { analyzeUsage } from './dep-exray/analyzer/index.js';
 export { DependencyInfo, ReplacementSuggestion, ScanResult, ScannerConfig, SecurityIssue } from './dep-exray/types.js';
 export { KNOWN_CVES, KNOWN_MAPPINGS } from './dep-exray/known-mappings.js';
-export { isEmail, isNIK, isNPWP, isPhone, isURL } from './validation/index.js';
+export { NIKInfo, isEmail, isKodepos, isNIK, isNPWP, isNoRekening, isPhone, isPlatNomor, isURL, parseNIK } from './validation/index.js';
 export { ErrorCode, MultiError, TypedError, collectErrors, createError, isTypedError } from './error/index.js';
 export { L as LogLevel, a as Logger, T as Transport, c as consoleTransport, b as createBufferedTransport, d as createConsoleTransport, e as createFileTransport, f as createJsonTransport, l as logger } from './index-BgG21uJC.js';
 export { contrastRatio, darken, hexToRgb, lighten, meetsWCAG, rgbToHex } from './color/index.js';

package/dist/index.js

@@ -1980,6 +1980,194 @@ function isURL(value) {
   }
 }
 
+// src/validation/parseNIK.ts
+function parseNIK(value) {
+  const digits = value.replace(/\D/g, "");
+  const info = {
+    nik: value,
+    valid: false,
+    gender: null,
+    birthDate: null,
+    province: null,
+    provinceCode: null,
+    city: null,
+    cityCode: null,
+    district: null,
+    districtCode: null,
+    uniqueCode: null
+  };
+  if (digits.length !== 16) return info;
+  const provinceCode = digits.slice(0, 2);
+  const cityCode = digits.slice(2, 4);
+  const districtCode = digits.slice(4, 6);
+  const rawDay = Number.parseInt(digits.slice(6, 8), 10);
+  const month = Number.parseInt(digits.slice(8, 10), 10);
+  const year = Number.parseInt(digits.slice(10, 12), 10);
+  const uniqueCode = digits.slice(12, 16);
+  if (rawDay < 1 || rawDay > 71 || month < 1 || month > 12) return info;
+  const gender = rawDay >= 41 ? "PEREMPUAN" : "LAKI-LAKI";
+  let day = rawDay;
+  if (day >= 41) day -= 40;
+  const fullYear = year < 70 ? 2e3 + year : 1900 + year;
+  const birthDate = new Date(fullYear, month - 1, day);
+  if (birthDate.getFullYear() !== fullYear || birthDate.getMonth() !== month - 1 || birthDate.getDate() !== day) {
+    return info;
+  }
+  return {
+    nik: value,
+    valid: true,
+    gender,
+    birthDate,
+    province: PROVINCE_CODES[provinceCode] ?? null,
+    provinceCode,
+    city: null,
+    cityCode,
+    district: null,
+    districtCode,
+    uniqueCode
+  };
+}
+var PROVINCE_CODES = {
+  "11": "ACEH",
+  "12": "SUMATERA UTARA",
+  "13": "SUMATERA BARAT",
+  "14": "RIAU",
+  "15": "JAMBI",
+  "16": "SUMATERA SELATAN",
+  "17": "BENGKULU",
+  "18": "LAMPUNG",
+  "19": "KEPULAUAN BANGKA BELITUNG",
+  "21": "KEPULAUAN RIAU",
+  "31": "DKI JAKARTA",
+  "32": "JAWA BARAT",
+  "33": "JAWA TENGAH",
+  "34": "DI YOGYAKARTA",
+  "35": "JAWA TIMUR",
+  "36": "BANTEN",
+  "51": "BALI",
+  "52": "NUSA TENGGARA BARAT",
+  "53": "NUSA TENGGARA TIMUR",
+  "61": "KALIMANTAN BARAT",
+  "62": "KALIMANTAN TENGAH",
+  "63": "KALIMANTAN SELATAN",
+  "64": "KALIMANTAN TIMUR",
+  "65": "KALIMANTAN UTARA",
+  "71": "SULAWESI UTARA",
+  "72": "SULAWESI TENGAH",
+  "73": "SULAWESI SELATAN",
+  "74": "SULAWESI TENGGARA",
+  "75": "GORONTALO",
+  "76": "SULAWESI BARAT",
+  "81": "MALUKU",
+  "82": "MALUKU UTARA",
+  "91": "PAPUA",
+  "92": "PAPUA BARAT",
+  "93": "PAPUA SELATAN",
+  "94": "PAPUA TENGAH",
+  "95": "PAPUA PEGUNUNGAN"
+};
+
+// src/validation/isPlatNomor.ts
+function isPlatNomor(value) {
+  const trimmed = value.trim().toUpperCase();
+  const regex = /^([A-Z]{1,2})\s*(\d{1,4})\s*([A-Z]{0,3})$/;
+  const match = trimmed.match(regex);
+  if (!match) return false;
+  const kodeDepan = match[1];
+  const angka = parseInt(match[2], 10);
+  const kodeBelakang = match[3] || "";
+  if (!KODE_DAERAH.includes(kodeDepan)) return false;
+  if (angka < 1 || angka > 9999) return false;
+  if (kodeBelakang.length > 3) return false;
+  return true;
+}
+var KODE_DAERAH = [
+  "A",
+  "AA",
+  "AB",
+  "AD",
+  "AE",
+  "AG",
+  "B",
+  "BA",
+  "BB",
+  "BD",
+  "BE",
+  "BG",
+  "BH",
+  "BK",
+  "BL",
+  "BM",
+  "BN",
+  "BP",
+  "BR",
+  "BT",
+  "BU",
+  "BV",
+  "BW",
+  "D",
+  "DA",
+  "DB",
+  "DC",
+  "DD",
+  "DE",
+  "DF",
+  "DG",
+  "DH",
+  "DK",
+  "DL",
+  "DM",
+  "DN",
+  "DP",
+  "DR",
+  "DT",
+  "DU",
+  "DW",
+  "E",
+  "EA",
+  "EB",
+  "ED",
+  "EE",
+  "F",
+  "G",
+  "H",
+  "K",
+  "KB",
+  "KH",
+  "KI",
+  "KU",
+  "KT",
+  "L",
+  "M",
+  "N",
+  "NB",
+  "NG",
+  "NK",
+  "NM",
+  "P",
+  "PA",
+  "PB",
+  "R",
+  "S",
+  "ST",
+  "T",
+  "W",
+  "Z"
+];
+
+// src/validation/isKodepos.ts
+function isKodepos(value) {
+  if (value.length !== 5) return false;
+  return /^\d{5}$/.test(value);
+}
+
+// src/validation/isNoRekening.ts
+function isNoRekening(value) {
+  const digits = value.replace(/\D/g, "");
+  if (digits.length < 8 || digits.length > 16) return false;
+  return true;
+}
+
 // src/error/createError.ts
 var defaultStatus = {
   "BAD_REQUEST": 400,
@@ -2425,15 +2613,18 @@ export {
   isEmail,
   isEmpty,
   isFunction,
+  isKodepos,
   isLeapYear,
   isMap,
   isNIK,
   isNPWP,
   isNil,
+  isNoRekening,
   isNull,
   isNumber,
   isObject,
   isPhone,
+  isPlatNomor,
   isPromise,
   isRegExp,
   isSet,
@@ -2464,6 +2655,7 @@ export {
   parse,
   parseCsv,
   parseDate,
+  parseNIK,
   pascalCase,
   pick,
   pipeline,