@indodev/toolkit 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,4 +1,110 @@
-export { NIKInfo, MaskOptions as NIKMaskOptions, formatNIK, maskNIK, parseNIK, validateNIK } from './nik/index.cjs';
-export { PhoneFormat, PhoneInfo, MaskOptions as PhoneMaskOptions, cleanPhoneNumber, formatPhoneNumber, getOperator, isLandlineNumber, isMobileNumber, maskPhoneNumber, parsePhoneNumber, toE164, toInternational, toNational, validatePhoneNumber } from './phone/index.cjs';
-export { R as RupiahOptions, W as WordOptions, a as formatCompact, f as formatRupiah, p as parseRupiah, t as toWords } from './words-Dy8iYkbv.cjs';
-export { C as CompareOptions, E as ExtractOptions, j as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, k as TruncateOptions, c as capitalize, h as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, n as normalizeWhitespace, r as removeAccents, b as sanitize, i as similarity, s as slugify, a as toSentenceCase, t as toTitleCase, f as truncate } from './compare-B1MKSOWV.cjs';
+export { NIKInfo, MaskOptions as NIKMaskOptions, formatBirthDate, formatNIK, getAge, isValidForBirthDate, isValidForGender, maskNIK, parseNIK, validateNIK } from './nik/index.cjs';
+export { PhoneFormat, PhoneInfo, MaskOptions as PhoneMaskOptions, cleanPhoneNumber, formatPhoneNumber, generateSmsLink, generateTelLink, generateWALink, getOperator, isLandlineNumber, isMobileNumber, isProvider, maskPhoneNumber, parsePhoneNumber, toE164, toInternational, toNational, validatePhoneNumber } from './phone/index.cjs';
+export { RupiahOptions, WordOptions, addRupiahSymbol, calculateTax, formatAccounting, formatCompact, formatRupiah, parseRupiah, roundToClean, toWords } from './currency/index.cjs';
+export { C as CompareOptions, E as ExtractOptions, m as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, o as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, j as extractWords, i as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, f as removeStopwords, b as sanitize, l as similarity, s as slugify, g as toFormal, a as toSentenceCase, t as toTitleCase, h as truncate } from './compare-BIodyGn7.cjs';
+
+/**
+ * Validates an Indonesian NPWP (Nomor Pokok Wajib Pajak).
+ *
+ * Supports both 15-digit (standard) and 16-digit (new NIK-based) formats.
+ *
+ * @param npwp - The NPWP string to validate
+ * @returns `true` if valid, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * validateNPWP('01.234.567.8-012.000'); // true
+ * validateNPWP('012345678012000'); // true
+ * ```
+ */
+declare function validateNPWP(npwp: string): boolean;
+
+/**
+ * Information extracted from an NPWP string.
+ */
+interface NPWPInfo {
+    /** The full 15 or 16 digit numeric string */
+    npwp: string;
+    /** Taxpayer type (e.g., 01-03 for individual, etc.) */
+    type: string;
+    /** Serial number */
+    serial: string;
+    /** Checksum digit */
+    checksum: string;
+    /** Tax office code */
+    taxOfficeCode: string;
+    /** Branch code (usually 000 for head office) */
+    branchCode: string;
+    /** Whether the NPWP is a 16-digit (NIK-based) NPWP */
+    isNikBased: boolean;
+}
+/**
+ * Options for NPWP masking.
+ */
+interface MaskOptions {
+    /** Number of characters to keep visible at the start (default: 2) */
+    visibleStart?: number;
+    /** Number of characters to keep visible at the end (default: 3) */
+    visibleEnd?: number;
+    /** Character to use for masking (default: '*') */
+    maskChar?: string;
+}
+
+/**
+ * Formats an NPWP string into standard Indonesian format (99.999.999.9-999.999).
+ *
+ * @param npwp - The NPWP string to format
+ * @returns Formatted NPWP string, or original if invalid
+ *
+ * @example
+ * ```typescript
+ * formatNPWP('012345678012000'); // '01.234.567.8-012.000'
+ * ```
+ */
+declare function formatNPWP(npwp: string): string;
+/**
+ * Parses an NPWP string into its components.
+ *
+ * @param npwp - The NPWP string to parse
+ * @returns NPWPInfo object, or null if invalid
+ */
+declare function parseNPWP(npwp: string): NPWPInfo | null;
+/**
+ * Masks an NPWP string for privacy.
+ *
+ * @param npwp - The NPWP string to mask
+ * @param options - Masking options
+ * @returns Masked NPWP string
+ */
+declare function maskNPWP(npwp: string, options?: MaskOptions): string;
+
+/**
+ * Validates an Indonesian license plate number format.
+ * Format: [1-2 letters] [1-4 digits] [1-3 letters]
+ *
+ * @param plate - The plate number string to validate
+ * @returns `true` if valid, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * validatePlate('B 1234 ABC'); // true
+ * validatePlate('AB 1 CD'); // true
+ * ```
+ */
+declare function validatePlate(plate: string): boolean;
+/**
+ * Gets the region name from a license plate number.
+ *
+ * @param plate - The plate number
+ * @returns Region name or null if not found
+ */
+declare function getRegionFromPlate(plate: string): string | null;
+/**
+ * Formats a license plate number with spaces (e.g., B 1234 ABC).
+ *
+ * @param plate - The plate number
+ * @returns Formatted plate string
+ */
+declare function formatPlate(plate: string): string;
+
+export { type NPWPInfo, type MaskOptions as NPWPMaskOptions, formatNPWP, formatPlate, getRegionFromPlate, maskNPWP, parseNPWP, validateNPWP, validatePlate };

package/dist/index.d.ts

@@ -1,4 +1,110 @@
-export { NIKInfo, MaskOptions as NIKMaskOptions, formatNIK, maskNIK, parseNIK, validateNIK } from './nik/index.js';
-export { PhoneFormat, PhoneInfo, MaskOptions as PhoneMaskOptions, cleanPhoneNumber, formatPhoneNumber, getOperator, isLandlineNumber, isMobileNumber, maskPhoneNumber, parsePhoneNumber, toE164, toInternational, toNational, validatePhoneNumber } from './phone/index.js';
-export { R as RupiahOptions, W as WordOptions, a as formatCompact, f as formatRupiah, p as parseRupiah, t as toWords } from './words-Dy8iYkbv.js';
-export { C as CompareOptions, E as ExtractOptions, j as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, k as TruncateOptions, c as capitalize, h as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, n as normalizeWhitespace, r as removeAccents, b as sanitize, i as similarity, s as slugify, a as toSentenceCase, t as toTitleCase, f as truncate } from './compare-B1MKSOWV.js';
+export { NIKInfo, MaskOptions as NIKMaskOptions, formatBirthDate, formatNIK, getAge, isValidForBirthDate, isValidForGender, maskNIK, parseNIK, validateNIK } from './nik/index.js';
+export { PhoneFormat, PhoneInfo, MaskOptions as PhoneMaskOptions, cleanPhoneNumber, formatPhoneNumber, generateSmsLink, generateTelLink, generateWALink, getOperator, isLandlineNumber, isMobileNumber, isProvider, maskPhoneNumber, parsePhoneNumber, toE164, toInternational, toNational, validatePhoneNumber } from './phone/index.js';
+export { RupiahOptions, WordOptions, addRupiahSymbol, calculateTax, formatAccounting, formatCompact, formatRupiah, parseRupiah, roundToClean, toWords } from './currency/index.js';
+export { C as CompareOptions, E as ExtractOptions, m as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, o as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, j as extractWords, i as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, f as removeStopwords, b as sanitize, l as similarity, s as slugify, g as toFormal, a as toSentenceCase, t as toTitleCase, h as truncate } from './compare-BIodyGn7.js';
+
+/**
+ * Validates an Indonesian NPWP (Nomor Pokok Wajib Pajak).
+ *
+ * Supports both 15-digit (standard) and 16-digit (new NIK-based) formats.
+ *
+ * @param npwp - The NPWP string to validate
+ * @returns `true` if valid, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * validateNPWP('01.234.567.8-012.000'); // true
+ * validateNPWP('012345678012000'); // true
+ * ```
+ */
+declare function validateNPWP(npwp: string): boolean;
+
+/**
+ * Information extracted from an NPWP string.
+ */
+interface NPWPInfo {
+    /** The full 15 or 16 digit numeric string */
+    npwp: string;
+    /** Taxpayer type (e.g., 01-03 for individual, etc.) */
+    type: string;
+    /** Serial number */
+    serial: string;
+    /** Checksum digit */
+    checksum: string;
+    /** Tax office code */
+    taxOfficeCode: string;
+    /** Branch code (usually 000 for head office) */
+    branchCode: string;
+    /** Whether the NPWP is a 16-digit (NIK-based) NPWP */
+    isNikBased: boolean;
+}
+/**
+ * Options for NPWP masking.
+ */
+interface MaskOptions {
+    /** Number of characters to keep visible at the start (default: 2) */
+    visibleStart?: number;
+    /** Number of characters to keep visible at the end (default: 3) */
+    visibleEnd?: number;
+    /** Character to use for masking (default: '*') */
+    maskChar?: string;
+}
+
+/**
+ * Formats an NPWP string into standard Indonesian format (99.999.999.9-999.999).
+ *
+ * @param npwp - The NPWP string to format
+ * @returns Formatted NPWP string, or original if invalid
+ *
+ * @example
+ * ```typescript
+ * formatNPWP('012345678012000'); // '01.234.567.8-012.000'
+ * ```
+ */
+declare function formatNPWP(npwp: string): string;
+/**
+ * Parses an NPWP string into its components.
+ *
+ * @param npwp - The NPWP string to parse
+ * @returns NPWPInfo object, or null if invalid
+ */
+declare function parseNPWP(npwp: string): NPWPInfo | null;
+/**
+ * Masks an NPWP string for privacy.
+ *
+ * @param npwp - The NPWP string to mask
+ * @param options - Masking options
+ * @returns Masked NPWP string
+ */
+declare function maskNPWP(npwp: string, options?: MaskOptions): string;
+
+/**
+ * Validates an Indonesian license plate number format.
+ * Format: [1-2 letters] [1-4 digits] [1-3 letters]
+ *
+ * @param plate - The plate number string to validate
+ * @returns `true` if valid, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * validatePlate('B 1234 ABC'); // true
+ * validatePlate('AB 1 CD'); // true
+ * ```
+ */
+declare function validatePlate(plate: string): boolean;
+/**
+ * Gets the region name from a license plate number.
+ *
+ * @param plate - The plate number
+ * @returns Region name or null if not found
+ */
+declare function getRegionFromPlate(plate: string): string | null;
+/**
+ * Formats a license plate number with spaces (e.g., B 1234 ABC).
+ *
+ * @param plate - The plate number
+ * @returns Formatted plate string
+ */
+declare function formatPlate(plate: string): string;
+
+export { type NPWPInfo, type MaskOptions as NPWPMaskOptions, formatNPWP, formatPlate, getRegionFromPlate, maskNPWP, parseNPWP, validateNPWP, validatePlate };