@indodev/toolkit 0.6.0 → 0.7.0

package/dist/text/index.d.cts

@@ -1,65 +1,4 @@
-import { M as MaskOptions } from '../compare-Ku_8OhuU.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, g as extractWords, j as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../compare-Ku_8OhuU.cjs';
-
-/**
- * Mask sensitive text based on predefined patterns or custom configuration
- *
- * This function provides privacy-compliant data display by masking portions
- * of text while keeping certain parts visible. Supports multiple masking
- * patterns for different use cases.
- *
- * **Available Patterns:**
- * - `all`: Masks all characters (preserves spaces)
- * - `middle`: Keeps start and end characters visible, masks the middle
- * - `email`: Keeps first 2 chars of local part and full domain visible
- *
- * @param text - The text to mask
- * @param options - Masking configuration options
- * @returns The masked text
- *
- * @example
- * Mask all characters:
- * ```typescript
- * maskText('Budi Santoso', { pattern: 'all' })
- * // → '**** *******'
- *
- * maskText('123456789', { pattern: 'all', maskChar: '#' })
- * // → '#########'
- * ```
- *
- * @example
- * Mask middle portion:
- * ```typescript
- * maskText('08123456789', { pattern: 'middle', visibleStart: 4, visibleEnd: 3 })
- * // → '0812****789'
- *
- * maskText('ABCDEF', { pattern: 'middle' })
- * // → 'AB**EF' (defaults: visibleStart=2, visibleEnd=2)
- * ```
- *
- * @example
- * Mask email:
- * ```typescript
- * maskText('user@example.com', { pattern: 'email' })
- * // → 'us**@example.com'
- *
- * maskText('a@test.com', { pattern: 'email' })
- * // → 'a*@test.com'
- * ```
- *
- * @example
- * Edge cases:
- * ```typescript
- * maskText('')
- * // → ''
- *
- * maskText('AB', { pattern: 'middle', visibleStart: 2, visibleEnd: 2 })
- * // → '**' (string too short, mask all)
- * ```
- *
- * @public
- */
-declare function maskText(text: string, options?: MaskOptions): string;
+export { C as CompareOptions, E as ExtractOptions, M as MaskOptions, o as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, q as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, j as isAlay, m as maskText, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../mask-CToJqmrd.cjs';
 
 /**
  * Convert text to camelCase
@@ -479,4 +418,4 @@ declare const ACRONYMS: readonly ["DKI", "DIY", "TNI", "POLRI", "ABRI", "MPR", "
  */
 declare const ABBREVIATIONS: Record<string, string>;
 
-export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, MaskOptions, countSyllables, maskText, toCamelCase, toPascalCase, toSnakeCase };
+export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, countSyllables, toCamelCase, toPascalCase, toSnakeCase };

package/dist/text/index.d.ts

@@ -1,65 +1,4 @@
-import { M as MaskOptions } from '../compare-Ku_8OhuU.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, g as extractWords, j as isAlay, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../compare-Ku_8OhuU.js';
-
-/**
- * Mask sensitive text based on predefined patterns or custom configuration
- *
- * This function provides privacy-compliant data display by masking portions
- * of text while keeping certain parts visible. Supports multiple masking
- * patterns for different use cases.
- *
- * **Available Patterns:**
- * - `all`: Masks all characters (preserves spaces)
- * - `middle`: Keeps start and end characters visible, masks the middle
- * - `email`: Keeps first 2 chars of local part and full domain visible
- *
- * @param text - The text to mask
- * @param options - Masking configuration options
- * @returns The masked text
- *
- * @example
- * Mask all characters:
- * ```typescript
- * maskText('Budi Santoso', { pattern: 'all' })
- * // → '**** *******'
- *
- * maskText('123456789', { pattern: 'all', maskChar: '#' })
- * // → '#########'
- * ```
- *
- * @example
- * Mask middle portion:
- * ```typescript
- * maskText('08123456789', { pattern: 'middle', visibleStart: 4, visibleEnd: 3 })
- * // → '0812****789'
- *
- * maskText('ABCDEF', { pattern: 'middle' })
- * // → 'AB**EF' (defaults: visibleStart=2, visibleEnd=2)
- * ```
- *
- * @example
- * Mask email:
- * ```typescript
- * maskText('user@example.com', { pattern: 'email' })
- * // → 'us**@example.com'
- *
- * maskText('a@test.com', { pattern: 'email' })
- * // → 'a*@test.com'
- * ```
- *
- * @example
- * Edge cases:
- * ```typescript
- * maskText('')
- * // → ''
- *
- * maskText('AB', { pattern: 'middle', visibleStart: 2, visibleEnd: 2 })
- * // → '**' (string too short, mask all)
- * ```
- *
- * @public
- */
-declare function maskText(text: string, options?: MaskOptions): string;
+export { C as CompareOptions, E as ExtractOptions, M as MaskOptions, o as SanitizeOptions, S as SlugifyOptions, T as TitleCaseOptions, q as TruncateOptions, c as capitalize, k as compareStrings, d as contractAbbreviation, e as expandAbbreviation, g as extractWords, j as isAlay, m as maskText, n as normalizeWhitespace, p as profanityFilter, r as removeAccents, h as removeStopwords, b as sanitize, l as similarity, s as slugify, i as toFormal, a as toSentenceCase, t as toTitleCase, f as truncate } from '../mask-CToJqmrd.js';
 
 /**
  * Convert text to camelCase
@@ -479,4 +418,4 @@ declare const ACRONYMS: readonly ["DKI", "DIY", "TNI", "POLRI", "ABRI", "MPR", "
  */
 declare const ABBREVIATIONS: Record<string, string>;
 
-export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, MaskOptions, countSyllables, maskText, toCamelCase, toPascalCase, toSnakeCase };
+export { ABBREVIATIONS, ACRONYMS, LOWERCASE_WORDS, countSyllables, toCamelCase, toPascalCase, toSnakeCase };

package/dist/text/index.js

@@ -1705,24 +1705,44 @@ function maskText(text, options) {
   if (!text) return text;
   const {
     pattern = "middle",
-    maskChar = "*",
-    visibleStart = 2,
-    visibleEnd = 2
+    maskChar,
+    visibleStart,
+    visibleEnd,
+    separator,
+    start,
+    end,
+    char
   } = options || {};
-  switch (pattern) {
+  const hasLegacyOptions = start !== void 0 || end !== void 0 || char !== void 0;
+  if (hasLegacyOptions) {
+    console.warn(
+      "[DEPRECATED] Mask options start/end/char are deprecated. Use visibleStart/visibleEnd/maskChar instead. These old names will be removed in v1.0.0."
+    );
+  }
+  const effectivePattern = pattern || "middle";
+  const effectiveStart = visibleStart !== void 0 ? visibleStart : start !== void 0 ? start : 2;
+  const effectiveEnd = visibleEnd !== void 0 ? visibleEnd : end !== void 0 ? end : 2;
+  const effectiveChar = maskChar !== void 0 ? maskChar : char !== void 0 ? char : "*";
+  switch (effectivePattern) {
     case "all":
-      return maskAll(text, maskChar);
+      return maskAll(text, effectiveChar);
     case "email":
-      return maskEmail(text, maskChar);
+      return maskEmail(text, effectiveChar);
     case "middle":
     default:
-      return maskMiddle(text, maskChar, visibleStart, visibleEnd);
+      return maskMiddle(
+        text,
+        effectiveChar,
+        effectiveStart,
+        effectiveEnd,
+        separator
+      );
   }
 }
 function maskAll(text, maskChar) {
   return text.split("").map((char) => char === " " ? " " : maskChar).join("");
 }
-function maskMiddle(text, maskChar, visibleStart, visibleEnd) {
+function maskMiddle(text, maskChar, visibleStart, visibleEnd, separator) {
   const length = text.length;
   const totalVisible = visibleStart + visibleEnd;
   if (length < totalVisible) {
@@ -1731,6 +1751,9 @@ function maskMiddle(text, maskChar, visibleStart, visibleEnd) {
   const start = text.slice(0, visibleStart);
   const middle = maskChar.repeat(length - totalVisible);
   const end = text.slice(length - visibleEnd);
+  if (separator) {
+    return `${start}${separator}${middle}${separator}${end}`;
+  }
   return start + middle + end;
 }
 function maskEmail(text, maskChar) {