cakkatrok-indonesia-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rintis Pameling
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,368 @@
+# @rintisid/indonesia-utils
+
+Utility functions for Indonesian JavaScript/Node.js projects.
+
+This package is intentionally dependency-free and focused on common local use cases: Rupiah formatting, Indonesian phone numbers, Indonesian dates, slugs, unique payment amounts, and simple validation.
+
+## Install
+
+```bash
+npm install @rintisid/indonesia-utils
+```
+
+## Usage
+
+```js
+const {
+  formatRupiah,
+  parseRupiah,
+  normalizePhoneID,
+  isValidPhoneID,
+  formatPhoneID,
+  getProviderID,
+  slugifyID,
+  formatTanggalID,
+  relativeTimeID,
+  createUniqueAmount,
+  isValidEmail,
+  cleanText,
+  titleCaseID,
+  maskEmail,
+  maskPhoneID
+} = require('@rintisid/indonesia-utils');
+
+console.log(formatRupiah(15000));
+// Rp15.000
+
+console.log(parseRupiah('Rp15.000'));
+// 15000
+
+console.log(normalizePhoneID('0812-3456-7890'));
+// 6281234567890
+
+console.log(isValidPhoneID('0812-3456-7890'));
+// true
+
+console.log(formatPhoneID('081234567890'));
+// +62 812 3456 7890
+
+console.log(getProviderID('081234567890'));
+// Telkomsel
+
+console.log(slugifyID('Produk Lokal Indonesia & UMKM!'));
+// produk-lokal-indonesia-dan-umkm
+
+console.log(formatTanggalID('2026-07-08T10:30:00', { includeTime: true }));
+// Rabu Legi, 8 Juli 2026 10.30
+
+console.log(formatTanggalID('07 01 2007'));
+// Minggu Wage, 7 Januari 2007
+
+console.log(relativeTimeID('2026-07-07T10:30:00', '2026-07-08T10:30:00'));
+// 1 hari yang lalu
+
+console.log(relativeTimeID('07 01 2007', '08 01 2007'));
+// 1 hari yang lalu
+
+console.log(relativeTimeID('07 01 2007', '08 03 2026'));
+// 19 tahun lebih 2 bulan 1 hari yang lalu
+
+console.log(relativeTimeID('07 01 2007', '09 03 2026'));
+// 19 tahun lebih 2 bulan 2 hari yang lalu
+
+console.log(createUniqueAmount({ amount: 50000, activeAmounts: [50001, 50002] }));
+// { baseAmount: 50000, uniqueCode: 3, finalAmount: 50003, formatted: 'Rp50.003' }
+
+console.log(isValidEmail('user@example.com'));
+// true
+
+console.log(cleanText(' halo\n\t dunia '));
+// halo dunia
+
+console.log(titleCaseID('cara membuat nasi goreng yang enak'));
+// Cara Membuat Nasi Goreng yang Enak
+
+console.log(maskEmail('rintis@example.com'));
+// r****s@example.com
+
+console.log(maskPhoneID('081234567890'));
+// +6281*****7890
+```
+
+## CLI
+
+After installing globally or running with `npx`, you can use:
+
+```bash
+npx indonesia-utils rupiah 15000
+npx indonesia-utils parse-rupiah "Rp15.000"
+npx indonesia-utils phone 081234567890
+npx indonesia-utils provider 081234567890
+npx indonesia-utils slug "Produk Lokal Indonesia & UMKM!"
+npx indonesia-utils date 2026-07-08
+npx indonesia-utils date "07 01 2007"
+```
+
+## API
+
+### `formatRupiah(value, options?)`
+
+Formats a number into Indonesian Rupiah format.
+
+```js
+formatRupiah(15000); // Rp15.000
+formatRupiah(15000, { space: true }); // Rp 15.000
+formatRupiah(15000, { withSymbol: false }); // 15.000
+```
+
+Options:
+
+```js
+{
+  symbol: 'Rp',
+  withSymbol: true,
+  decimal: 0,
+  space: false
+}
+```
+
+### `parseRupiah(value)`
+
+Parses Rupiah text into a number.
+
+```js
+parseRupiah('Rp15.000'); // 15000
+parseRupiah('Rp15.000,50'); // 15000.5
+```
+
+### `normalizePhoneID(value, options?)`
+
+Normalizes Indonesian phone numbers into `62` format.
+
+```js
+normalizePhoneID('0812-3456-7890'); // 6281234567890
+normalizePhoneID('+62 812 3456 7890'); // 6281234567890
+normalizePhoneID('81234567890'); // 6281234567890
+normalizePhoneID('081234567890', { keepPlus: true }); // +6281234567890
+```
+
+### `isValidPhoneID(value)`
+
+Validates Indonesian mobile phone number format.
+
+```js
+isValidPhoneID('081234567890'); // true
+```
+
+### `formatPhoneID(value, options?)`
+
+Formats a normalized Indonesian phone number for display.
+
+```js
+formatPhoneID('081234567890'); // +62 812 3456 7890
+formatPhoneID('081234567890', { international: false }); // 0 812 3456 7890
+formatPhoneID('081234567890', { separator: '-' }); // +62-812-3456-7890
+```
+
+### `getProviderID(value)`
+
+Detects common Indonesian mobile provider from phone prefix.
+
+```js
+getProviderID('081234567890'); // Telkomsel
+```
+
+Supported common providers:
+
+- Telkomsel
+- Indosat
+- XL
+- Axis
+- Tri
+- Smartfren
+
+Unknown prefixes return `Unknown`.
+
+### `slugifyID(value, options?)`
+
+Creates clean slugs.
+
+```js
+slugifyID('Produk Lokal Indonesia & UMKM!');
+// produk-lokal-indonesia-dan-umkm
+```
+
+Options:
+
+```js
+{
+  separator: '-',
+  lower: true,
+  maxLength: 0,
+  replacement: {
+    '&': ' dan ',
+    '+': ' plus ',
+    '@': ' at '
+  }
+}
+```
+
+### `formatTanggalID(value?, options?)`
+
+Formats a date in Indonesian.
+
+Supported string input formats are ISO date strings and Indonesian date strings like `DD MM YYYY`.
+
+```js
+formatTanggalID('2026-07-08');
+// Rabu Legi, 8 Juli 2026
+
+formatTanggalID('07 01 2007');
+// Minggu Wage, 7 Januari 2007
+
+formatTanggalID('2026-07-08T10:30:00', { includeTime: true });
+// Rabu Legi, 8 Juli 2026 10.30
+
+formatTanggalID('2026-07-08', { dateStyle: 'numeric' });
+// Rabu Legi, 08/07/2026
+
+formatTanggalID('2026-07-08', { includeWeton: false });
+// Rabu, 8 Juli 2026
+```
+
+Options:
+
+```js
+{
+  includeDay: true,
+  shortMonth: false,
+  includeTime: false,
+  timeSeparator: '.',
+  dateStyle: 'long',
+  includeWeton: true
+}
+```
+
+### `relativeTimeID(value, baseValue?)`
+
+Returns Indonesian relative time.
+
+`value` and `baseValue` support the same two date input formats as `formatTanggalID`.
+
+```js
+relativeTimeID('2026-07-07T10:30:00', '2026-07-08T10:30:00');
+// 1 hari yang lalu
+
+relativeTimeID('07 01 2007', '08 01 2007');
+// 1 hari yang lalu
+
+relativeTimeID('07 01 2007', '08 03 2026');
+// 19 tahun lebih 2 bulan 1 hari yang lalu
+
+relativeTimeID('07 01 2007', '09 03 2026');
+// 19 tahun lebih 2 bulan 2 hari yang lalu
+```
+
+### `createUniqueAmount(options)`
+
+Creates unique payment amount for manual transfer or QRIS mutation matching.
+
+```js
+createUniqueAmount({
+  amount: 50000,
+  activeAmounts: [50001, 50002]
+});
+
+// {
+//   baseAmount: 50000,
+//   uniqueCode: 3,
+//   finalAmount: 50003,
+//   formatted: 'Rp50.003'
+// }
+```
+
+Options:
+
+```js
+{
+  amount: 50000,
+  min: 1,
+  max: 999,
+  activeAmounts: [],
+  mode: 'add' // or 'subtract'
+}
+```
+
+### `isValidEmail(value)`
+
+Simple email validation.
+
+```js
+isValidEmail('user@example.com'); // true
+```
+
+### `cleanText(value)`
+
+Trims and normalizes whitespace.
+
+```js
+cleanText(' halo\n dunia '); // halo dunia
+```
+
+### `titleCaseID(value)`
+
+Converts text into Indonesian-style title case.
+
+```js
+titleCaseID('cara membuat nasi goreng yang enak');
+// Cara Membuat Nasi Goreng yang Enak
+```
+
+### `maskEmail(value)`
+
+Masks email username.
+
+```js
+maskEmail('rintis@example.com'); // r****s@example.com
+```
+
+### `maskPhoneID(value)`
+
+Masks Indonesian phone number.
+
+```js
+maskPhoneID('081234567890'); // +6281*****7890
+```
+
+## Test
+
+```bash
+npm test
+```
+
+## Publish
+
+Before publishing, make sure the package name is available or use your own npm scope.
+
+```bash
+npm login
+npm publish --access public
+```
+
+If you want to publish without scope, change this in `package.json`:
+
+```json
+{
+  "name": "indonesia-utils"
+}
+```
+
+Then publish:
+
+```bash
+npm publish
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "cakkatrok-indonesia-utils",
+  "version": "1.0.0",
+  "description": "Utility functions for Indonesian projects: Rupiah, phone number, date, slug, unique payment amount, and validation.",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "bin": {
+    "indonesia-utils": "src/cli.js"
+  },
+  "scripts": {
+    "test": "node --test",
+    "example": "node examples/basic.js"
+  },
+  "keywords": [
+    "indonesia",
+    "rupiah",
+    "idr",
+    "phone",
+    "validator",
+    "slugify",
+    "tanggal",
+    "utility",
+    "utils"
+  ],
+  "author": "RintisW.P",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+'use strict';
+
+const utils = require('./index');
+
+const [, , command, ...args] = process.argv;
+
+function help() {
+  console.log(`indonesia-utils
+
+Usage:
+  indonesia-utils rupiah <number>
+  indonesia-utils parse-rupiah <text>
+  indonesia-utils phone <number>
+  indonesia-utils provider <number>
+  indonesia-utils slug <text>
+  indonesia-utils date [date]
+
+Examples:
+  indonesia-utils rupiah 15000
+  indonesia-utils phone 081234567890
+  indonesia-utils slug "Halo Dunia Indonesia"
+`);
+}
+
+try {
+  switch (command) {
+    case 'rupiah':
+      console.log(utils.formatRupiah(args[0]));
+      break;
+    case 'parse-rupiah':
+      console.log(utils.parseRupiah(args.join(' ')));
+      break;
+    case 'phone':
+      console.log(utils.normalizePhoneID(args[0]));
+      break;
+    case 'provider':
+      console.log(utils.getProviderID(args[0]));
+      break;
+    case 'slug':
+      console.log(utils.slugifyID(args.join(' ')));
+      break;
+    case 'date':
+      console.log(utils.formatTanggalID(args[0] ? args.join(' ') : new Date()));
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+    case undefined:
+      help();
+      break;
+    default:
+      console.error(`Unknown command: ${command}`);
+      help();
+      process.exitCode = 1;
+  }
+} catch (error) {
+  console.error(error.message);
+  process.exitCode = 1;
+}

package/src/index.d.ts

@@ -0,0 +1,63 @@
+export interface RupiahOptions {
+  symbol?: string;
+  withSymbol?: boolean;
+  decimal?: number;
+  space?: boolean;
+}
+
+export interface PhoneOptions {
+  countryCode?: string;
+  keepPlus?: boolean;
+}
+
+export interface FormatPhoneOptions {
+  separator?: string;
+  international?: boolean;
+}
+
+export interface SlugifyOptions {
+  separator?: string;
+  lower?: boolean;
+  maxLength?: number;
+  replacement?: Record<string, string>;
+}
+
+export interface FormatTanggalOptions {
+  includeDay?: boolean;
+  shortMonth?: boolean;
+  includeTime?: boolean;
+  timeSeparator?: string;
+  dateStyle?: 'long' | 'numeric';
+  includeWeton?: boolean;
+}
+
+export interface UniqueAmountOptions {
+  amount: number;
+  min?: number;
+  max?: number;
+  activeAmounts?: number[];
+  mode?: 'add' | 'subtract';
+}
+
+export interface UniqueAmountResult {
+  baseAmount: number;
+  uniqueCode: number;
+  finalAmount: number;
+  formatted: string;
+}
+
+export function formatRupiah(value: number | string, options?: RupiahOptions): string;
+export function parseRupiah(value: number | string): number;
+export function normalizePhoneID(value: string | number, options?: PhoneOptions): string;
+export function isValidPhoneID(value: string | number): boolean;
+export function formatPhoneID(value: string | number, options?: FormatPhoneOptions): string;
+export function getProviderID(value: string | number): string;
+export function slugifyID(value: string, options?: SlugifyOptions): string;
+export function formatTanggalID(value?: Date | string | number, options?: FormatTanggalOptions): string;
+export function relativeTimeID(value: Date | string | number, baseValue?: Date | string | number): string;
+export function createUniqueAmount(options: UniqueAmountOptions): UniqueAmountResult;
+export function isValidEmail(value: string): boolean;
+export function cleanText(value: string): string;
+export function titleCaseID(value: string): string;
+export function maskEmail(value: string): string;
+export function maskPhoneID(value: string | number): string;

package/src/index.js

@@ -0,0 +1,455 @@
+'use strict';
+
+const MONTHS_LONG = [
+  'Januari', 'Februari', 'Maret', 'April', 'Mei', 'Juni',
+  'Juli', 'Agustus', 'September', 'Oktober', 'November', 'Desember'
+];
+
+const MONTHS_SHORT = [
+  'Jan', 'Feb', 'Mar', 'Apr', 'Mei', 'Jun',
+  'Jul', 'Agu', 'Sep', 'Okt', 'Nov', 'Des'
+];
+
+const DAYS_LONG = [
+  'Minggu', 'Senin', 'Selasa', 'Rabu', 'Kamis', 'Jumat', 'Sabtu'
+];
+
+const PASARAN = ['Legi', 'Pahing', 'Pon', 'Wage', 'Kliwon'];
+const PASARAN_ANCHOR = Date.UTC(1945, 7, 17);
+
+const PROVIDER_PREFIXES = [
+  { name: 'Telkomsel', prefixes: ['811', '812', '813', '821', '822', '823', '851', '852', '853'] },
+  { name: 'Indosat', prefixes: ['814', '815', '816', '855', '856', '857', '858'] },
+  { name: 'XL', prefixes: ['817', '818', '819', '859', '877', '878'] },
+  { name: 'Axis', prefixes: ['831', '832', '833', '838'] },
+  { name: 'Tri', prefixes: ['895', '896', '897', '898', '899'] },
+  { name: 'Smartfren', prefixes: ['881', '882', '883', '884', '885', '886', '887', '888', '889'] }
+];
+
+function assertNumber(value, name) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) {
+    throw new TypeError(`${name} must be a finite number`);
+  }
+  return number;
+}
+
+function onlyDigits(value) {
+  return String(value ?? '').replace(/\D+/g, '');
+}
+
+function formatRupiah(value, options = {}) {
+  const {
+    symbol = 'Rp',
+    withSymbol = true,
+    decimal = 0,
+    space = false
+  } = options;
+
+  const number = assertNumber(value, 'value');
+  const formatted = new Intl.NumberFormat('id-ID', {
+    minimumFractionDigits: decimal,
+    maximumFractionDigits: decimal
+  }).format(number);
+
+  if (!withSymbol) return formatted;
+  return `${symbol}${space ? ' ' : ''}${formatted}`;
+}
+
+function parseRupiah(value) {
+  if (typeof value === 'number') return value;
+  if (value === null || value === undefined) return 0;
+
+  let text = String(value)
+    .trim()
+    .replace(/rp/gi, '')
+    .replace(/\s+/g, '');
+
+  const hasCommaDecimal = /,\d{1,2}$/.test(text);
+
+  if (hasCommaDecimal) {
+    text = text.replace(/\./g, '').replace(',', '.');
+  } else {
+    text = text.replace(/[.,]/g, '');
+  }
+
+  const number = Number(text.replace(/[^0-9.-]/g, ''));
+  return Number.isFinite(number) ? number : 0;
+}
+
+function normalizePhoneID(value, options = {}) {
+  const { countryCode = '62', keepPlus = false } = options;
+  let digits = onlyDigits(value);
+
+  if (!digits) return '';
+
+  if (digits.startsWith('00' + countryCode)) {
+    digits = digits.slice(2);
+  }
+
+  if (digits.startsWith('0')) {
+    digits = countryCode + digits.slice(1);
+  }
+
+  if (!digits.startsWith(countryCode) && digits.startsWith('8')) {
+    digits = countryCode + digits;
+  }
+
+  return keepPlus ? `+${digits}` : digits;
+}
+
+function isValidPhoneID(value) {
+  const phone = normalizePhoneID(value);
+  return /^628[1-9]\d{7,11}$/.test(phone);
+}
+
+function formatPhoneID(value, options = {}) {
+  const { separator = ' ', international = true } = options;
+  const phone = normalizePhoneID(value);
+
+  if (!phone) return '';
+  if (!phone.startsWith('62')) return phone;
+
+  const national = phone.slice(2);
+  const chunks = [];
+
+  chunks.push(national.slice(0, 3));
+  if (national.length > 3) chunks.push(national.slice(3, 7));
+  if (national.length > 7) chunks.push(national.slice(7, 11));
+  if (national.length > 11) chunks.push(national.slice(11));
+
+  const prefix = international ? '+62' : '0';
+  return `${prefix}${separator}${chunks.filter(Boolean).join(separator)}`;
+}
+
+function getProviderID(value) {
+  const phone = normalizePhoneID(value);
+  if (!phone.startsWith('62') || phone.length < 5) return 'Unknown';
+
+  const prefix = phone.slice(2, 5);
+  const found = PROVIDER_PREFIXES.find(provider => provider.prefixes.includes(prefix));
+  return found ? found.name : 'Unknown';
+}
+
+function slugifyID(value, options = {}) {
+  const {
+    separator = '-',
+    lower = true,
+    maxLength = 0,
+    replacement = {
+      '&': ' dan ',
+      '+': ' plus ',
+      '@': ' at '
+    }
+  } = options;
+
+  let text = String(value ?? '');
+
+  for (const [from, to] of Object.entries(replacement)) {
+    text = text.split(from).join(to);
+  }
+
+  text = text
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .replace(/[^\w\s-]/g, ' ')
+    .replace(/_/g, ' ')
+    .trim()
+    .replace(/\s+/g, separator)
+    .replace(new RegExp(`${escapeRegExp(separator)}+`, 'g'), separator);
+
+  if (lower) text = text.toLowerCase();
+  if (maxLength > 0) {
+    text = text.slice(0, maxLength).replace(new RegExp(`${escapeRegExp(separator)}$`), '');
+  }
+
+  return text;
+}
+
+function escapeRegExp(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function toDate(value) {
+  if (value instanceof Date) {
+    const date = new Date(value.getTime());
+    if (Number.isNaN(date.getTime())) {
+      throw new TypeError('Invalid date');
+    }
+    return date;
+  }
+
+  if (typeof value === 'string') {
+    const text = value.trim();
+    const idDateMatch = text.match(/^(\d{1,2})[ /\-.](\d{1,2})[ /\-.](\d{4})(?:\s+(\d{1,2})[:.](\d{1,2}))?$/);
+
+    if (idDateMatch) {
+      const [, dayText, monthText, yearText, hourText = '0', minuteText = '0'] = idDateMatch;
+      const day = Number(dayText);
+      const month = Number(monthText);
+      const year = Number(yearText);
+      const hour = Number(hourText);
+      const minute = Number(minuteText);
+      const date = new Date(year, month - 1, day, hour, minute);
+
+      if (
+        date.getFullYear() !== year ||
+        date.getMonth() !== month - 1 ||
+        date.getDate() !== day ||
+        date.getHours() !== hour ||
+        date.getMinutes() !== minute
+      ) {
+        throw new TypeError('Invalid date');
+      }
+
+      return date;
+    }
+  }
+
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    throw new TypeError('Invalid date');
+  }
+  return date;
+}
+
+function pad2(value) {
+  return String(value).padStart(2, '0');
+}
+
+function getPasaranID(value) {
+  const date = toDate(value);
+  const utcDate = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate());
+  const diffDays = Math.round((utcDate - PASARAN_ANCHOR) / (24 * 60 * 60 * 1000));
+  const index = ((diffDays % PASARAN.length) + PASARAN.length) % PASARAN.length;
+  return PASARAN[index];
+}
+
+function getWetonID(value) {
+  const date = toDate(value);
+  return `${DAYS_LONG[date.getDay()]} ${getPasaranID(date)}`;
+}
+
+function daysInMonth(year, month) {
+  return new Date(year, month + 1, 0).getDate();
+}
+
+function addCalendarMonths(value, months) {
+  const date = new Date(value.getTime());
+  const targetMonth = date.getMonth() + months;
+  const targetYear = date.getFullYear() + Math.floor(targetMonth / 12);
+  const normalizedMonth = ((targetMonth % 12) + 12) % 12;
+  const day = Math.min(date.getDate(), daysInMonth(targetYear, normalizedMonth));
+
+  return new Date(
+    targetYear,
+    normalizedMonth,
+    day,
+    date.getHours(),
+    date.getMinutes(),
+    date.getSeconds(),
+    date.getMilliseconds()
+  );
+}
+
+function getCalendarMonthDiff(from, to) {
+  let months = (to.getFullYear() - from.getFullYear()) * 12;
+  months += to.getMonth() - from.getMonth();
+
+  if (addCalendarMonths(from, months) > to) {
+    months -= 1;
+  }
+
+  return months;
+}
+
+function getRelativeDateParts(from, to) {
+  const totalMonths = getCalendarMonthDiff(from, to);
+  const afterMonths = addCalendarMonths(from, totalMonths);
+  const days = Math.floor((to.getTime() - afterMonths.getTime()) / (24 * 60 * 60 * 1000));
+
+  return {
+    years: Math.floor(totalMonths / 12),
+    months: totalMonths % 12,
+    totalMonths,
+    days
+  };
+}
+
+function formatRelativeDateParts(parts) {
+  const segments = [];
+
+  if (parts.years > 0) segments.push(`${parts.years} tahun`);
+  if (parts.months > 0) segments.push(`${parts.months} bulan`);
+  if (parts.days > 0) segments.push(`${parts.days} hari`);
+
+  if (segments.length <= 1) return segments[0] ?? '';
+  return `${segments[0]} lebih ${segments.slice(1).join(' ')}`;
+}
+
+function formatTanggalID(value = new Date(), options = {}) {
+  const {
+    includeDay = true,
+    shortMonth = false,
+    includeTime = false,
+    timeSeparator = '.',
+    dateStyle = 'long',
+    includeWeton = true
+  } = options;
+
+  const date = toDate(value);
+  const day = includeWeton ? getWetonID(date) : DAYS_LONG[date.getDay()];
+  const monthName = (shortMonth ? MONTHS_SHORT : MONTHS_LONG)[date.getMonth()];
+
+  let result;
+
+  if (dateStyle === 'numeric') {
+    result = `${pad2(date.getDate())}/${pad2(date.getMonth() + 1)}/${date.getFullYear()}`;
+  } else {
+    result = `${date.getDate()} ${monthName} ${date.getFullYear()}`;
+  }
+
+  if (includeDay) result = `${day}, ${result}`;
+
+  if (includeTime) {
+    result += ` ${pad2(date.getHours())}${timeSeparator}${pad2(date.getMinutes())}`;
+  }
+
+  return result;
+}
+
+function relativeTimeID(value, baseValue = new Date()) {
+  const date = toDate(value);
+  const base = toDate(baseValue);
+  const diffMs = date.getTime() - base.getTime();
+  const absMs = Math.abs(diffMs);
+  const earlier = diffMs < 0 ? date : base;
+  const later = diffMs < 0 ? base : date;
+  const dateParts = getRelativeDateParts(earlier, later);
+
+  const units = [
+    { name: 'minggu', ms: 7 * 24 * 60 * 60 * 1000 },
+    { name: 'hari', ms: 24 * 60 * 60 * 1000 },
+    { name: 'jam', ms: 60 * 60 * 1000 },
+    { name: 'menit', ms: 60 * 1000 },
+    { name: 'detik', ms: 1000 }
+  ];
+
+  if (absMs < 1000) return 'baru saja';
+
+  if (dateParts.totalMonths >= 12) {
+    const text = formatRelativeDateParts(dateParts);
+    if (diffMs < 0) return `${text} yang lalu`;
+    return `dalam ${text}`;
+  }
+
+  if (dateParts.totalMonths >= 1) {
+    const text = formatRelativeDateParts(dateParts);
+    if (diffMs < 0) return `${text} yang lalu`;
+    return `dalam ${text}`;
+  }
+
+  const unit = units.find(item => absMs >= item.ms) || units[units.length - 1];
+  const count = Math.floor(absMs / unit.ms);
+
+  if (diffMs < 0) return `${count} ${unit.name} yang lalu`;
+  return `dalam ${count} ${unit.name}`;
+}
+
+function createUniqueAmount(options = {}) {
+  const {
+    amount,
+    min = 1,
+    max = 999,
+    activeAmounts = [],
+    mode = 'add'
+  } = options;
+
+  const baseAmount = assertNumber(amount, 'amount');
+  const minCode = Math.max(0, Math.floor(assertNumber(min, 'min')));
+  const maxCode = Math.max(minCode, Math.floor(assertNumber(max, 'max')));
+  const active = new Set(activeAmounts.map(Number));
+
+  for (let code = minCode; code <= maxCode; code += 1) {
+    const finalAmount = mode === 'subtract' ? baseAmount - code : baseAmount + code;
+    if (finalAmount <= 0) continue;
+
+    if (!active.has(finalAmount)) {
+      return {
+        baseAmount,
+        uniqueCode: code,
+        finalAmount,
+        formatted: formatRupiah(finalAmount)
+      };
+    }
+  }
+
+  throw new Error('No available unique amount in the selected range');
+}
+
+function isValidEmail(value) {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(String(value ?? '').trim());
+}
+
+function cleanText(value) {
+  return String(value ?? '')
+    .replace(/[\t\n\r]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function titleCaseID(value) {
+  const smallWords = new Set(['dan', 'di', 'ke', 'dari', 'yang', 'atau', 'untuk', 'dengan']);
+
+  return cleanText(value)
+    .toLowerCase()
+    .split(' ')
+    .map((word, index) => {
+      if (index > 0 && smallWords.has(word)) return word;
+      return word.charAt(0).toUpperCase() + word.slice(1);
+    })
+    .join(' ');
+}
+
+function maskEmail(value) {
+  const email = String(value ?? '').trim();
+  if (!isValidEmail(email)) return email;
+
+  const [name, domain] = email.split('@');
+  const maskedName = name.length <= 2
+    ? `${name[0] ?? ''}*`
+    : `${name[0]}${'*'.repeat(Math.min(name.length - 2, 5))}${name[name.length - 1]}`;
+
+  return `${maskedName}@${domain}`;
+}
+
+function maskPhoneID(value) {
+  const phone = normalizePhoneID(value, { keepPlus: true });
+  if (phone.length <= 8) return phone;
+  return `${phone.slice(0, 5)}${'*'.repeat(Math.max(phone.length - 9, 3))}${phone.slice(-4)}`;
+}
+
+module.exports = {
+  formatRupiah,
+  parseRupiah,
+  normalizePhoneID,
+  isValidPhoneID,
+  formatPhoneID,
+  getProviderID,
+  slugifyID,
+  formatTanggalID,
+  relativeTimeID,
+  createUniqueAmount,
+  isValidEmail,
+  cleanText,
+  titleCaseID,
+  maskEmail,
+  maskPhoneID,
+  constants: {
+    MONTHS_LONG,
+    MONTHS_SHORT,
+    DAYS_LONG,
+    PASARAN,
+    PROVIDER_PREFIXES
+  }
+};