@indodev/toolkit 0.3.1 → 0.3.2

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":"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","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;