@indodev/toolkit 0.3.1 → 0.3.3

package/dist/{compare-CZadJMGl.d.cts → compare-Ku_8OhuU.d.cts}

@@ -131,6 +131,30 @@ interface TruncateOptions {
      */
     wordBoundary?: boolean;
 }
+/**
+ * Options for text masking
+ */
+interface MaskOptions {
+    /**
+     * Masking pattern to apply
+     * - `all`: Mask all characters (preserves spaces)
+     * - `middle`: Keep start and end visible, mask middle
+     * - `email`: Keep first 2 chars of local part and full domain
+     */
+    pattern?: 'all' | 'middle' | 'email';
+    /**
+     * Character to use for masking (default: '*')
+     */
+    maskChar?: string;
+    /**
+     * Number of characters to keep visible at start (for 'middle' pattern, default: 2)
+     */
+    visibleStart?: number;
+    /**
+     * Number of characters to keep visible at end (for 'middle' pattern, default: 2)
+     */
+    visibleEnd?: number;
+}
 
 /**
  * Capitalize the first letter of a string and lowercase the rest
@@ -988,4 +1012,4 @@ declare function compareStrings(str1: string, str2: string, options?: CompareOpt
  */
 declare function similarity(str1: string, str2: string): number;
 
-export { type CompareOptions as C, type ExtractOptions as E, type SlugifyOptions as S, type TitleCaseOptions as T, toSentenceCase as a, sanitize as b, capitalize as c, contractAbbreviation as d, expandAbbreviation as e, truncate as f, extractWords as g, removeStopwords as h, toFormal as i, isAlay as j, compareStrings as k, similarity as l, type SanitizeOptions as m, normalizeWhitespace as n, type TruncateOptions as o, profanityFilter as p, removeAccents as r, slugify as s, toTitleCase as t };
+export { type CompareOptions as C, type ExtractOptions as E, type MaskOptions as M, type SlugifyOptions as S, type TitleCaseOptions as T, toSentenceCase as a, sanitize as b, capitalize as c, contractAbbreviation as d, expandAbbreviation as e, truncate as f, extractWords as g, removeStopwords as h, toFormal as i, isAlay as j, compareStrings as k, similarity as l, type SanitizeOptions as m, normalizeWhitespace as n, type TruncateOptions as o, profanityFilter as p, removeAccents as r, slugify as s, toTitleCase as t };

package/dist/{compare-CZadJMGl.d.ts → compare-Ku_8OhuU.d.ts}

@@ -131,6 +131,30 @@ interface TruncateOptions {
      */
     wordBoundary?: boolean;
 }
+/**
+ * Options for text masking
+ */
+interface MaskOptions {
+    /**
+     * Masking pattern to apply
+     * - `all`: Mask all characters (preserves spaces)
+     * - `middle`: Keep start and end visible, mask middle
+     * - `email`: Keep first 2 chars of local part and full domain
+     */
+    pattern?: 'all' | 'middle' | 'email';
+    /**
+     * Character to use for masking (default: '*')
+     */
+    maskChar?: string;
+    /**
+     * Number of characters to keep visible at start (for 'middle' pattern, default: 2)
+     */
+    visibleStart?: number;
+    /**
+     * Number of characters to keep visible at end (for 'middle' pattern, default: 2)
+     */
+    visibleEnd?: number;
+}
 
 /**
  * Capitalize the first letter of a string and lowercase the rest
@@ -988,4 +1012,4 @@ declare function compareStrings(str1: string, str2: string, options?: CompareOpt
  */
 declare function similarity(str1: string, str2: string): number;
 
-export { type CompareOptions as C, type ExtractOptions as E, type SlugifyOptions as S, type TitleCaseOptions as T, toSentenceCase as a, sanitize as b, capitalize as c, contractAbbreviation as d, expandAbbreviation as e, truncate as f, extractWords as g, removeStopwords as h, toFormal as i, isAlay as j, compareStrings as k, similarity as l, type SanitizeOptions as m, normalizeWhitespace as n, type TruncateOptions as o, profanityFilter as p, removeAccents as r, slugify as s, toTitleCase as t };
+export { type CompareOptions as C, type ExtractOptions as E, type MaskOptions as M, type SlugifyOptions as S, type TitleCaseOptions as T, toSentenceCase as a, sanitize as b, capitalize as c, contractAbbreviation as d, expandAbbreviation as e, truncate as f, extractWords as g, removeStopwords as h, toFormal as i, isAlay as j, compareStrings as k, similarity as l, type SanitizeOptions as m, normalizeWhitespace as n, type TruncateOptions as o, profanityFilter as p, removeAccents as r, slugify as s, toTitleCase as t };

package/dist/email-validator/index.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/email-validator/constants.ts
+var EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$/;
+var DISPOSABLE_DOMAINS = [
+  "mailinator.com",
+  "10minutemail.com",
+  "temp-mail.org",
+  "guerrillamail.com"
+];
+
+// src/email-validator/email-validator.ts
+var COMMON_PROVIDERS = ["gmail.com", "yahoo.com", "outlook.com", "hotmail.com", "icloud.com"];
+var MAX_EMAIL_LENGTH = 254;
+function validateEmail(email, options) {
+  if (!email || typeof email !== "string") {
+    return false;
+  }
+  const trimmedEmail = email.trim().toLowerCase();
+  if (trimmedEmail.length > MAX_EMAIL_LENGTH) {
+    return false;
+  }
+  const parts = trimmedEmail.split("@");
+  if (parts.length !== 2) {
+    return false;
+  }
+  const [username, domain] = parts;
+  if (!username || !domain) {
+    return false;
+  }
+  if (username.length > 64) {
+    return false;
+  }
+  if (username.includes("..") || username.startsWith(".") || username.endsWith(".") || domain.startsWith(".") || domain.endsWith(".") || domain.includes("..")) {
+    return false;
+  }
+  if (!EMAIL_REGEX.test(trimmedEmail)) {
+    return false;
+  }
+  if (options?.blockDisposable) {
+    if (DISPOSABLE_DOMAINS.includes(domain)) {
+      return false;
+    }
+  }
+  return true;
+}
+function getEmailInfo(email) {
+  if (!validateEmail(email)) return null;
+  const [username, domain] = email.trim().toLowerCase().split("@");
+  return {
+    username,
+    domain,
+    isCommonProvider: COMMON_PROVIDERS.includes(domain),
+    isDisposable: DISPOSABLE_DOMAINS.includes(domain)
+  };
+}
+function maskEmail(email, options) {
+  if (!validateEmail(email)) return email;
+  const { visibleStart = 1, visibleEnd = 1, maskChar = "*" } = options || {};
+  const [username, domain] = email.split("@");
+  if (username.length <= 3) {
+    return `${username[0]}${maskChar.repeat(3)}@${domain}`;
+  }
+  const maskedLength = username.length - (visibleStart + visibleEnd);
+  if (maskedLength <= 0) {
+    return `${username[0]}${maskChar.repeat(3)}@${domain}`;
+  }
+  const start = username.slice(0, visibleStart);
+  const end = username.slice(username.length - visibleEnd);
+  return `${start}${maskChar.repeat(maskedLength)}${end}@${domain}`;
+}
+function normalizeEmail(email) {
+  return email.trim().toLowerCase();
+}
+
+exports.DISPOSABLE_DOMAINS = DISPOSABLE_DOMAINS;
+exports.EMAIL_REGEX = EMAIL_REGEX;
+exports.getEmailInfo = getEmailInfo;
+exports.maskEmail = maskEmail;
+exports.normalizeEmail = normalizeEmail;
+exports.validateEmail = validateEmail;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/email-validator/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/email-validator/constants.ts","../../src/email-validator/email-validator.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Regular expression for standard email validation.\n * Optimized for RFC 5322 compliance.\n */\nexport const EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$/;\n\n/**\n * Common disposable email domains to block if needed.\n */\nexport const DISPOSABLE_DOMAINS = [\n  'mailinator.com',\n  '10minutemail.com',\n  'temp-mail.org',\n  'guerrillamail.com',\n];\n","import { EMAIL_REGEX, DISPOSABLE_DOMAINS } from './constants';\nimport type { EmailValidationOptions, EmailMaskOptions, EmailInfo } from './types';\n\n/**\n * List of common global email providers.\n */\nconst COMMON_PROVIDERS = ['gmail.com', 'yahoo.com', 'outlook.com', 'hotmail.com', 'icloud.com'];\n\n/**\n * The maximum length of an email address according to RFC 5321.\n */\nconst MAX_EMAIL_LENGTH = 254;\n\n/**\n * Validates if a string is a properly formatted email address based on RFC 5322.\n * \n * Performs checks for:\n * - Proper email format (regex).\n * - RFC specific rules (no double dots, username length < 64).\n * - Maximum total length (254 characters).\n * - Optional: disposable email detection.\n * \n * @param email - The email string to validate.\n * @param options - Optional validation configuration.\n * @returns `true` if valid, `false` otherwise.\n * \n * @example\n * ```typescript\n * import { validateEmail } from '@indodev/toolkit/email-validator';\n * \n * validateEmail('user@example.com'); // true\n * validateEmail('invalid-email'); // false\n * validateEmail('spam@mailinator.com', { blockDisposable: true }); // false\n * ```\n */\nexport function validateEmail(email: string, options?: EmailValidationOptions): boolean {\n  if (!email || typeof email !== 'string') {\n    return false;\n  }\n\n  const trimmedEmail = email.trim().toLowerCase();\n\n  if (trimmedEmail.length > MAX_EMAIL_LENGTH) {\n    return false;\n  }\n\n  const parts = trimmedEmail.split('@');\n  if (parts.length !== 2) {\n    return false;\n  }\n\n  const [username, domain] = parts;\n\n  if (!username || !domain) {\n    return false;\n  }\n\n  if (username.length > 64) {\n    return false;\n  }\n\n  if (\n    username.includes('..') ||\n    username.startsWith('.') ||\n    username.endsWith('.') ||\n    domain.startsWith('.') ||\n    domain.endsWith('.') ||\n    domain.includes('..')\n  ) {\n    return false;\n  }\n\n  if (!EMAIL_REGEX.test(trimmedEmail)) {\n    return false;\n  }\n\n  if (options?.blockDisposable) {\n    if (DISPOSABLE_DOMAINS.includes(domain)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Parses an email address to extract useful metadata.\n * \n * @param email - The email address to parse.\n * @returns `EmailInfo` object containing details or `null` if the email is invalid.\n * \n * @example\n * ```typescript\n * import { getEmailInfo } from '@indodev/toolkit/email-validator';\n * \n * const info = getEmailInfo('adam@gmail.com');\n * // { username: 'adam', domain: 'gmail.com', isCommonProvider: true, isDisposable: false }\n * ```\n */\nexport function getEmailInfo(email: string): EmailInfo | null {\n  if (!validateEmail(email)) return null;\n\n  const [username, domain] = email.trim().toLowerCase().split('@');\n\n  return {\n    username,\n    domain,\n    isCommonProvider: COMMON_PROVIDERS.includes(domain),\n    isDisposable: DISPOSABLE_DOMAINS.includes(domain),\n  };\n}\n\n/**\n * Masks the username portion of an email for privacy protection.\n * \n * Falls back to a standard mask if the username is too short to respect visibleStart/visibleEnd.\n * \n * @param email - The email address to mask.\n * @param options - Optional masking configuration.\n * @returns Masked email string or original if invalid.\n * \n * @example\n * ```typescript\n * import { maskEmail } from '@indodev/toolkit/email-validator';\n * \n * maskEmail('user@example.com'); // 'u**r@example.com'\n * maskEmail('user@example.com', { maskChar: '#' }); // 'u##r@example.com'\n * ```\n */\nexport function maskEmail(email: string, options?: EmailMaskOptions): string {\n  if (!validateEmail(email)) return email;\n\n  const { visibleStart = 1, visibleEnd = 1, maskChar = '*' } = options || {};\n  const [username, domain] = email.split('@');\n\n  // Fallback for very short usernames\n  if (username.length <= 3) {\n    return `${username[0]}${maskChar.repeat(3)}@${domain}`;\n  }\n\n  // Calculate masked length\n  const maskedLength = username.length - (visibleStart + visibleEnd);\n\n  // If the result of masking would be empty or negative, use fallback\n  if (maskedLength <= 0) {\n    return `${username[0]}${maskChar.repeat(3)}@${domain}`;\n  }\n\n  const start = username.slice(0, visibleStart);\n  const end = username.slice(username.length - visibleEnd);\n\n  return `${start}${maskChar.repeat(maskedLength)}${end}@${domain}`;\n}\n\n/**\n * Normalizes an email address by trimming whitespace and converting to lowercase.\n * \n * @param email - The email to normalize.\n * @returns Normalized email string.\n * \n * @example\n * ```typescript\n * import { normalizeEmail } from '@indodev/toolkit/email-validator';\n * \n * normalizeEmail('  USER@Example.COM  '); // 'user@example.com'\n * ```\n */\nexport function normalizeEmail(email: string): string {\n  return email.trim().toLowerCase();\n}\n"]}

package/dist/email-validator/index.d.cts

@@ -0,0 +1,13 @@
+export { c as EmailInfo, b as EmailMaskOptions, E as EmailValidationOptions, a as EmailValidationResult, g as getEmailInfo, m as maskEmail, n as normalizeEmail, v as validateEmail } from '../email-validator-R9L5unIw.cjs';
+
+/**
+ * Regular expression for standard email validation.
+ * Optimized for RFC 5322 compliance.
+ */
+declare const EMAIL_REGEX: RegExp;
+/**
+ * Common disposable email domains to block if needed.
+ */
+declare const DISPOSABLE_DOMAINS: string[];
+
+export { DISPOSABLE_DOMAINS, EMAIL_REGEX };

package/dist/email-validator/index.d.ts

@@ -0,0 +1,13 @@
+export { c as EmailInfo, b as EmailMaskOptions, E as EmailValidationOptions, a as EmailValidationResult, g as getEmailInfo, m as maskEmail, n as normalizeEmail, v as validateEmail } from '../email-validator-R9L5unIw.js';
+
+/**
+ * Regular expression for standard email validation.
+ * Optimized for RFC 5322 compliance.
+ */
+declare const EMAIL_REGEX: RegExp;
+/**
+ * Common disposable email domains to block if needed.
+ */
+declare const DISPOSABLE_DOMAINS: string[];
+
+export { DISPOSABLE_DOMAINS, EMAIL_REGEX };

package/dist/email-validator/index.js

@@ -0,0 +1,76 @@
+// src/email-validator/constants.ts
+var EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$/;
+var DISPOSABLE_DOMAINS = [
+  "mailinator.com",
+  "10minutemail.com",
+  "temp-mail.org",
+  "guerrillamail.com"
+];
+
+// src/email-validator/email-validator.ts
+var COMMON_PROVIDERS = ["gmail.com", "yahoo.com", "outlook.com", "hotmail.com", "icloud.com"];
+var MAX_EMAIL_LENGTH = 254;
+function validateEmail(email, options) {
+  if (!email || typeof email !== "string") {
+    return false;
+  }
+  const trimmedEmail = email.trim().toLowerCase();
+  if (trimmedEmail.length > MAX_EMAIL_LENGTH) {
+    return false;
+  }
+  const parts = trimmedEmail.split("@");
+  if (parts.length !== 2) {
+    return false;
+  }
+  const [username, domain] = parts;
+  if (!username || !domain) {
+    return false;
+  }
+  if (username.length > 64) {
+    return false;
+  }
+  if (username.includes("..") || username.startsWith(".") || username.endsWith(".") || domain.startsWith(".") || domain.endsWith(".") || domain.includes("..")) {
+    return false;
+  }
+  if (!EMAIL_REGEX.test(trimmedEmail)) {
+    return false;
+  }
+  if (options?.blockDisposable) {
+    if (DISPOSABLE_DOMAINS.includes(domain)) {
+      return false;
+    }
+  }
+  return true;
+}
+function getEmailInfo(email) {
+  if (!validateEmail(email)) return null;
+  const [username, domain] = email.trim().toLowerCase().split("@");
+  return {
+    username,
+    domain,
+    isCommonProvider: COMMON_PROVIDERS.includes(domain),
+    isDisposable: DISPOSABLE_DOMAINS.includes(domain)
+  };
+}
+function maskEmail(email, options) {
+  if (!validateEmail(email)) return email;
+  const { visibleStart = 1, visibleEnd = 1, maskChar = "*" } = options || {};
+  const [username, domain] = email.split("@");
+  if (username.length <= 3) {
+    return `${username[0]}${maskChar.repeat(3)}@${domain}`;
+  }
+  const maskedLength = username.length - (visibleStart + visibleEnd);
+  if (maskedLength <= 0) {
+    return `${username[0]}${maskChar.repeat(3)}@${domain}`;
+  }
+  const start = username.slice(0, visibleStart);
+  const end = username.slice(username.length - visibleEnd);
+  return `${start}${maskChar.repeat(maskedLength)}${end}@${domain}`;
+}
+function normalizeEmail(email) {
+  return email.trim().toLowerCase();
+}
+
+export { DISPOSABLE_DOMAINS, EMAIL_REGEX, getEmailInfo, maskEmail, normalizeEmail, validateEmail };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/email-validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/email-validator/constants.ts","../../src/email-validator/email-validator.ts"],"names":[],"mappings":";AAIO,IAAM,WAAA,GAAc;AAKpB,IAAM,kBAAA,GAAqB;AAAA,EAChC,gBAAA;AAAA,EACA,kBAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF;;;ACRA,IAAM,mBAAmB,CAAC,WAAA,EAAa,WAAA,EAAa,aAAA,EAAe,eAAe,YAAY,CAAA;AAK9F,IAAM,gBAAA,GAAmB,GAAA;AAwBlB,SAAS,aAAA,CAAc,OAAe,OAAA,EAA2C;AACtF,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,EAAU;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,YAAA,GAAe,KAAA,CAAM,IAAA,EAAK,CAAE,WAAA,EAAY;AAE9C,EAAA,IAAI,YAAA,CAAa,SAAS,gBAAA,EAAkB;AAC1C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,KAAA,CAAM,GAAG,CAAA;AACpC,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAC,QAAA,EAAU,MAAM,CAAA,GAAI,KAAA;AAE3B,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ;AACxB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,QAAA,CAAS,SAAS,EAAA,EAAI;AACxB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IACE,QAAA,CAAS,SAAS,IAAI,CAAA,IACtB,SAAS,UAAA,CAAW,GAAG,CAAA,IACvB,QAAA,CAAS,QAAA,CAAS,GAAG,KACrB,MAAA,CAAO,UAAA,CAAW,GAAG,CAAA,IACrB,MAAA,CAAO,QAAA,CAAS,GAAG,CAAA,IACnB,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA,EACpB;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,CAAC,WAAA,CAAY,IAAA,CAAK,YAAY,CAAA,EAAG;AACnC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,SAAS,eAAA,EAAiB;AAC5B,IAAA,IAAI,kBAAA,CAAmB,QAAA,CAAS,MAAM,CAAA,EAAG;AACvC,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAgBO,SAAS,aAAa,KAAA,EAAiC;AAC5D,EAAA,IAAI,CAAC,aAAA,CAAc,KAAK,CAAA,EAAG,OAAO,IAAA;AAElC,EAAA,MAAM,CAAC,QAAA,EAAU,MAAM,CAAA,GAAI,KAAA,CAAM,MAAK,CAAE,WAAA,EAAY,CAAE,KAAA,CAAM,GAAG,CAAA;AAE/D,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,MAAA;AAAA,IACA,gBAAA,EAAkB,gBAAA,CAAiB,QAAA,CAAS,MAAM,CAAA;AAAA,IAClD,YAAA,EAAc,kBAAA,CAAmB,QAAA,CAAS,MAAM;AAAA,GAClD;AACF;AAmBO,SAAS,SAAA,CAAU,OAAe,OAAA,EAAoC;AAC3E,EAAA,IAAI,CAAC,aAAA,CAAc,KAAK,CAAA,EAAG,OAAO,KAAA;AAElC,EAAA,MAAM,EAAE,eAAe,CAAA,EAAG,UAAA,GAAa,GAAG,QAAA,GAAW,GAAA,EAAI,GAAI,OAAA,IAAW,EAAC;AACzE,EAAA,MAAM,CAAC,QAAA,EAAU,MAAM,CAAA,GAAI,KAAA,CAAM,MAAM,GAAG,CAAA;AAG1C,EAAA,IAAI,QAAA,CAAS,UAAU,CAAA,EAAG;AACxB,IAAA,OAAO,CAAA,EAAG,QAAA,CAAS,CAAC,CAAC,CAAA,EAAG,SAAS,MAAA,CAAO,CAAC,CAAC,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA;AAAA,EACtD;AAGA,EAAA,MAAM,YAAA,GAAe,QAAA,CAAS,MAAA,IAAU,YAAA,GAAe,UAAA,CAAA;AAGvD,EAAA,IAAI,gBAAgB,CAAA,EAAG;AACrB,IAAA,OAAO,CAAA,EAAG,QAAA,CAAS,CAAC,CAAC,CAAA,EAAG,SAAS,MAAA,CAAO,CAAC,CAAC,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA;AAAA,EACtD;AAEA,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,YAAY,CAAA;AAC5C,EAAA,MAAM,GAAA,GAAM,QAAA,CAAS,KAAA,CAAM,QAAA,CAAS,SAAS,UAAU,CAAA;AAEvD,EAAA,OAAO,CAAA,EAAG,KAAK,CAAA,EAAG,QAAA,CAAS,MAAA,CAAO,YAAY,CAAC,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA;AACjE;AAeO,SAAS,eAAe,KAAA,EAAuB;AACpD,EAAA,OAAO,KAAA,CAAM,IAAA,EAAK,CAAE,WAAA,EAAY;AAClC","file":"index.js","sourcesContent":["/**\n * Regular expression for standard email validation.\n * Optimized for RFC 5322 compliance.\n */\nexport const EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$/;\n\n/**\n * Common disposable email domains to block if needed.\n */\nexport const DISPOSABLE_DOMAINS = [\n  'mailinator.com',\n  '10minutemail.com',\n  'temp-mail.org',\n  'guerrillamail.com',\n];\n","import { EMAIL_REGEX, DISPOSABLE_DOMAINS } from './constants';\nimport type { EmailValidationOptions, EmailMaskOptions, EmailInfo } from './types';\n\n/**\n * List of common global email providers.\n */\nconst COMMON_PROVIDERS = ['gmail.com', 'yahoo.com', 'outlook.com', 'hotmail.com', 'icloud.com'];\n\n/**\n * The maximum length of an email address according to RFC 5321.\n */\nconst MAX_EMAIL_LENGTH = 254;\n\n/**\n * Validates if a string is a properly formatted email address based on RFC 5322.\n * \n * Performs checks for:\n * - Proper email format (regex).\n * - RFC specific rules (no double dots, username length < 64).\n * - Maximum total length (254 characters).\n * - Optional: disposable email detection.\n * \n * @param email - The email string to validate.\n * @param options - Optional validation configuration.\n * @returns `true` if valid, `false` otherwise.\n * \n * @example\n * ```typescript\n * import { validateEmail } from '@indodev/toolkit/email-validator';\n * \n * validateEmail('user@example.com'); // true\n * validateEmail('invalid-email'); // false\n * validateEmail('spam@mailinator.com', { blockDisposable: true }); // false\n * ```\n */\nexport function validateEmail(email: string, options?: EmailValidationOptions): boolean {\n  if (!email || typeof email !== 'string') {\n    return false;\n  }\n\n  const trimmedEmail = email.trim().toLowerCase();\n\n  if (trimmedEmail.length > MAX_EMAIL_LENGTH) {\n    return false;\n  }\n\n  const parts = trimmedEmail.split('@');\n  if (parts.length !== 2) {\n    return false;\n  }\n\n  const [username, domain] = parts;\n\n  if (!username || !domain) {\n    return false;\n  }\n\n  if (username.length > 64) {\n    return false;\n  }\n\n  if (\n    username.includes('..') ||\n    username.startsWith('.') ||\n    username.endsWith('.') ||\n    domain.startsWith('.') ||\n    domain.endsWith('.') ||\n    domain.includes('..')\n  ) {\n    return false;\n  }\n\n  if (!EMAIL_REGEX.test(trimmedEmail)) {\n    return false;\n  }\n\n  if (options?.blockDisposable) {\n    if (DISPOSABLE_DOMAINS.includes(domain)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Parses an email address to extract useful metadata.\n * \n * @param email - The email address to parse.\n * @returns `EmailInfo` object containing details or `null` if the email is invalid.\n * \n * @example\n * ```typescript\n * import { getEmailInfo } from '@indodev/toolkit/email-validator';\n * \n * const info = getEmailInfo('adam@gmail.com');\n * // { username: 'adam', domain: 'gmail.com', isCommonProvider: true, isDisposable: false }\n * ```\n */\nexport function getEmailInfo(email: string): EmailInfo | null {\n  if (!validateEmail(email)) return null;\n\n  const [username, domain] = email.trim().toLowerCase().split('@');\n\n  return {\n    username,\n    domain,\n    isCommonProvider: COMMON_PROVIDERS.includes(domain),\n    isDisposable: DISPOSABLE_DOMAINS.includes(domain),\n  };\n}\n\n/**\n * Masks the username portion of an email for privacy protection.\n * \n * Falls back to a standard mask if the username is too short to respect visibleStart/visibleEnd.\n * \n * @param email - The email address to mask.\n * @param options - Optional masking configuration.\n * @returns Masked email string or original if invalid.\n * \n * @example\n * ```typescript\n * import { maskEmail } from '@indodev/toolkit/email-validator';\n * \n * maskEmail('user@example.com'); // 'u**r@example.com'\n * maskEmail('user@example.com', { maskChar: '#' }); // 'u##r@example.com'\n * ```\n */\nexport function maskEmail(email: string, options?: EmailMaskOptions): string {\n  if (!validateEmail(email)) return email;\n\n  const { visibleStart = 1, visibleEnd = 1, maskChar = '*' } = options || {};\n  const [username, domain] = email.split('@');\n\n  // Fallback for very short usernames\n  if (username.length <= 3) {\n    return `${username[0]}${maskChar.repeat(3)}@${domain}`;\n  }\n\n  // Calculate masked length\n  const maskedLength = username.length - (visibleStart + visibleEnd);\n\n  // If the result of masking would be empty or negative, use fallback\n  if (maskedLength <= 0) {\n    return `${username[0]}${maskChar.repeat(3)}@${domain}`;\n  }\n\n  const start = username.slice(0, visibleStart);\n  const end = username.slice(username.length - visibleEnd);\n\n  return `${start}${maskChar.repeat(maskedLength)}${end}@${domain}`;\n}\n\n/**\n * Normalizes an email address by trimming whitespace and converting to lowercase.\n * \n * @param email - The email to normalize.\n * @returns Normalized email string.\n * \n * @example\n * ```typescript\n * import { normalizeEmail } from '@indodev/toolkit/email-validator';\n * \n * normalizeEmail('  USER@Example.COM  '); // 'user@example.com'\n * ```\n */\nexport function normalizeEmail(email: string): string {\n  return email.trim().toLowerCase();\n}\n"]}

package/dist/email-validator-R9L5unIw.d.cts

@@ -0,0 +1,120 @@
+/**
+ * Email validation options.
+ */
+interface EmailValidationOptions {
+    /**
+     * Whether to block known disposable email domains.
+     * @default false
+     */
+    blockDisposable?: boolean;
+}
+/**
+ * Detailed email validation result.
+ */
+interface EmailValidationResult {
+    isValid: boolean;
+    domain?: string;
+    isDisposable?: boolean;
+}
+/**
+ * Options for email masking.
+ */
+interface EmailMaskOptions {
+    /**
+     * Number of characters to keep visible at the start of the username.
+     * @default 1
+     */
+    visibleStart?: number;
+    /**
+     * Number of characters to keep visible at the end of the username.
+     * @default 1
+     */
+    visibleEnd?: number;
+    /**
+     * Character used for masking.
+     * @default '*'
+     */
+    maskChar?: string;
+}
+/**
+ * Detailed email information.
+ */
+interface EmailInfo {
+    username: string;
+    domain: string;
+    isCommonProvider: boolean;
+    isDisposable: boolean;
+}
+
+/**
+ * Validates if a string is a properly formatted email address based on RFC 5322.
+ *
+ * Performs checks for:
+ * - Proper email format (regex).
+ * - RFC specific rules (no double dots, username length < 64).
+ * - Maximum total length (254 characters).
+ * - Optional: disposable email detection.
+ *
+ * @param email - The email string to validate.
+ * @param options - Optional validation configuration.
+ * @returns `true` if valid, `false` otherwise.
+ *
+ * @example
+ * ```typescript
+ * import { validateEmail } from '@indodev/toolkit/email-validator';
+ *
+ * validateEmail('user@example.com'); // true
+ * validateEmail('invalid-email'); // false
+ * validateEmail('spam@mailinator.com', { blockDisposable: true }); // false
+ * ```
+ */
+declare function validateEmail(email: string, options?: EmailValidationOptions): boolean;
+/**
+ * Parses an email address to extract useful metadata.
+ *
+ * @param email - The email address to parse.
+ * @returns `EmailInfo` object containing details or `null` if the email is invalid.
+ *
+ * @example
+ * ```typescript
+ * import { getEmailInfo } from '@indodev/toolkit/email-validator';
+ *
+ * const info = getEmailInfo('adam@gmail.com');
+ * // { username: 'adam', domain: 'gmail.com', isCommonProvider: true, isDisposable: false }
+ * ```
+ */
+declare function getEmailInfo(email: string): EmailInfo | null;
+/**
+ * Masks the username portion of an email for privacy protection.
+ *
+ * Falls back to a standard mask if the username is too short to respect visibleStart/visibleEnd.
+ *
+ * @param email - The email address to mask.
+ * @param options - Optional masking configuration.
+ * @returns Masked email string or original if invalid.
+ *
+ * @example
+ * ```typescript
+ * import { maskEmail } from '@indodev/toolkit/email-validator';
+ *
+ * maskEmail('user@example.com'); // 'u**r@example.com'
+ * maskEmail('user@example.com', { maskChar: '#' }); // 'u##r@example.com'
+ * ```
+ */
+declare function maskEmail(email: string, options?: EmailMaskOptions): string;
+/**
+ * Normalizes an email address by trimming whitespace and converting to lowercase.
+ *
+ * @param email - The email to normalize.
+ * @returns Normalized email string.
+ *
+ * @example
+ * ```typescript
+ * import { normalizeEmail } from '@indodev/toolkit/email-validator';
+ *
+ * normalizeEmail('  USER@Example.COM  '); // 'user@example.com'
+ * ```
+ */
+declare function normalizeEmail(email: string): string;
+
+export { type EmailValidationOptions as E, type EmailValidationResult as a, type EmailMaskOptions as b, type EmailInfo as c, getEmailInfo as g, maskEmail as m, normalizeEmail as n, validateEmail as v };

package/dist/email-validator-R9L5unIw.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Email validation options.
+ */
+interface EmailValidationOptions {
+    /**
+     * Whether to block known disposable email domains.
+     * @default false
+     */
+    blockDisposable?: boolean;
+}
+/**
+ * Detailed email validation result.
+ */
+interface EmailValidationResult {
+    isValid: boolean;
+    domain?: string;
+    isDisposable?: boolean;
+}
+/**
+ * Options for email masking.
+ */
+interface EmailMaskOptions {
+    /**
+     * Number of characters to keep visible at the start of the username.
+     * @default 1
+     */
+    visibleStart?: number;
+    /**
+     * Number of characters to keep visible at the end of the username.
+     * @default 1
+     */
+    visibleEnd?: number;
+    /**
+     * Character used for masking.
+     * @default '*'
+     */
+    maskChar?: string;
+}
+/**
+ * Detailed email information.
+ */
+interface EmailInfo {
+    username: string;
+    domain: string;
+    isCommonProvider: boolean;
+    isDisposable: boolean;
+}
+
+/**
+ * Validates if a string is a properly formatted email address based on RFC 5322.
+ *
+ * Performs checks for:
+ * - Proper email format (regex).
+ * - RFC specific rules (no double dots, username length < 64).
+ * - Maximum total length (254 characters).
+ * - Optional: disposable email detection.
+ *
+ * @param email - The email string to validate.
+ * @param options - Optional validation configuration.
+ * @returns `true` if valid, `false` otherwise.
+ *
+ * @example
+ * ```typescript
+ * import { validateEmail } from '@indodev/toolkit/email-validator';
+ *
+ * validateEmail('user@example.com'); // true
+ * validateEmail('invalid-email'); // false
+ * validateEmail('spam@mailinator.com', { blockDisposable: true }); // false
+ * ```
+ */
+declare function validateEmail(email: string, options?: EmailValidationOptions): boolean;
+/**
+ * Parses an email address to extract useful metadata.
+ *
+ * @param email - The email address to parse.
+ * @returns `EmailInfo` object containing details or `null` if the email is invalid.
+ *
+ * @example
+ * ```typescript
+ * import { getEmailInfo } from '@indodev/toolkit/email-validator';
+ *
+ * const info = getEmailInfo('adam@gmail.com');
+ * // { username: 'adam', domain: 'gmail.com', isCommonProvider: true, isDisposable: false }
+ * ```
+ */
+declare function getEmailInfo(email: string): EmailInfo | null;
+/**
+ * Masks the username portion of an email for privacy protection.
+ *
+ * Falls back to a standard mask if the username is too short to respect visibleStart/visibleEnd.
+ *
+ * @param email - The email address to mask.
+ * @param options - Optional masking configuration.
+ * @returns Masked email string or original if invalid.
+ *
+ * @example
+ * ```typescript
+ * import { maskEmail } from '@indodev/toolkit/email-validator';
+ *
+ * maskEmail('user@example.com'); // 'u**r@example.com'
+ * maskEmail('user@example.com', { maskChar: '#' }); // 'u##r@example.com'
+ * ```
+ */
+declare function maskEmail(email: string, options?: EmailMaskOptions): string;
+/**
+ * Normalizes an email address by trimming whitespace and converting to lowercase.
+ *
+ * @param email - The email to normalize.
+ * @returns Normalized email string.
+ *
+ * @example
+ * ```typescript
+ * import { normalizeEmail } from '@indodev/toolkit/email-validator';
+ *
+ * normalizeEmail('  USER@Example.COM  '); // 'user@example.com'
+ * ```
+ */
+declare function normalizeEmail(email: string): string;
+
+export { type EmailValidationOptions as E, type EmailValidationResult as a, type EmailMaskOptions as b, type EmailInfo as c, getEmailInfo as g, maskEmail as m, normalizeEmail as n, validateEmail as v };

package/dist/index.cjs

@@ -1251,6 +1251,79 @@ function validateVIN(vin) {
   return actualCheckDigit === expectedCheckDigit;
 }
 
+// src/email-validator/constants.ts
+var EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$/;
+var DISPOSABLE_DOMAINS = [
+  "mailinator.com",
+  "10minutemail.com",
+  "temp-mail.org",
+  "guerrillamail.com"
+];
+
+// src/email-validator/email-validator.ts
+var COMMON_PROVIDERS = ["gmail.com", "yahoo.com", "outlook.com", "hotmail.com", "icloud.com"];
+var MAX_EMAIL_LENGTH = 254;
+function validateEmail(email, options) {
+  if (!email || typeof email !== "string") {
+    return false;
+  }
+  const trimmedEmail = email.trim().toLowerCase();
+  if (trimmedEmail.length > MAX_EMAIL_LENGTH) {
+    return false;
+  }
+  const parts = trimmedEmail.split("@");
+  if (parts.length !== 2) {
+    return false;
+  }
+  const [username, domain] = parts;
+  if (!username || !domain) {
+    return false;
+  }
+  if (username.length > 64) {
+    return false;
+  }
+  if (username.includes("..") || username.startsWith(".") || username.endsWith(".") || domain.startsWith(".") || domain.endsWith(".") || domain.includes("..")) {
+    return false;
+  }
+  if (!EMAIL_REGEX.test(trimmedEmail)) {
+    return false;
+  }
+  if (options?.blockDisposable) {
+    if (DISPOSABLE_DOMAINS.includes(domain)) {
+      return false;
+    }
+  }
+  return true;
+}
+function getEmailInfo(email) {
+  if (!validateEmail(email)) return null;
+  const [username, domain] = email.trim().toLowerCase().split("@");
+  return {
+    username,
+    domain,
+    isCommonProvider: COMMON_PROVIDERS.includes(domain),
+    isDisposable: DISPOSABLE_DOMAINS.includes(domain)
+  };
+}
+function maskEmail(email, options) {
+  if (!validateEmail(email)) return email;
+  const { visibleStart = 1, visibleEnd = 1, maskChar = "*" } = options || {};
+  const [username, domain] = email.split("@");
+  if (username.length <= 3) {
+    return `${username[0]}${maskChar.repeat(3)}@${domain}`;
+  }
+  const maskedLength = username.length - (visibleStart + visibleEnd);
+  if (maskedLength <= 0) {
+    return `${username[0]}${maskChar.repeat(3)}@${domain}`;
+  }
+  const start = username.slice(0, visibleStart);
+  const end = username.slice(username.length - visibleEnd);
+  return `${start}${maskChar.repeat(maskedLength)}${end}@${domain}`;
+}
+function normalizeEmail(email) {
+  return email.trim().toLowerCase();
+}
+
 // src/currency/format.ts
 function formatRupiah(amount, options) {
   const {
@@ -3229,6 +3302,7 @@ exports.generateSmsLink = generateSmsLink;
 exports.generateTelLink = generateTelLink;
 exports.generateWALink = generateWALink;
 exports.getAge = getAge;
+exports.getEmailInfo = getEmailInfo;
 exports.getOperator = getOperator;
 exports.getRegionFromPlate = getRegionFromPlate;
 exports.isAlay = isAlay;
@@ -3237,9 +3311,11 @@ exports.isMobileNumber = isMobileNumber;
 exports.isProvider = isProvider;
 exports.isValidForBirthDate = isValidForBirthDate;
 exports.isValidForGender = isValidForGender;
+exports.maskEmail = maskEmail;
 exports.maskNIK = maskNIK;
 exports.maskNPWP = maskNPWP;
 exports.maskPhoneNumber = maskPhoneNumber;
+exports.normalizeEmail = normalizeEmail;
 exports.normalizeWhitespace = normalizeWhitespace;
 exports.parseNIK = parseNIK;
 exports.parseNPWP = parseNPWP;
@@ -3260,6 +3336,7 @@ exports.toSentenceCase = toSentenceCase;
 exports.toTitleCase = toTitleCase;
 exports.toWords = toWords;
 exports.truncate = truncate;
+exports.validateEmail = validateEmail;
 exports.validateNIK = validateNIK;
 exports.validateNPWP = validateNPWP;
 exports.validatePhoneNumber = validatePhoneNumber;