utilitify-core 1.0.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/unified/validateUser.ts","../src/cache/index.ts","../src/middleware/index.ts","../src/errors/index.ts"],"names":["errors","validateName","validateEmail","validatePhone","validateUsername","checkPasswordStrength","calculateAge"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\r\n    UserData,\r\n    UserValidationOptions,\r\n    UserValidationResult,\r\n    IValidationError,\r\n} from '../types';\r\nimport { validateEmail } from '../validators/email';\r\nimport { validateName } from '../validators/name';\r\nimport { validatePhone } from '../validators/phone';\r\nimport { validateUsername } from '../validators/username';\r\nimport { checkPasswordStrength } from '../security/password';\r\nimport { calculateAge } from '../date/age';\r\n\r\n/**\r\n * Default validation options\r\n */\r\nconst DEFAULT_OPTIONS: UserValidationOptions = {\r\n    required: [],\r\n};\r\n\r\n/**\r\n * Validate user data with automatic field detection\r\n *\r\n * This is the unified validation function that validates all provided\r\n * user fields and returns standardized errors.\r\n *\r\n * @param userData - User data to validate\r\n * @param options - Validation options\r\n * @returns Validation result with all errors\r\n *\r\n * @example\r\n * ```typescript\r\n * import { validateUser } from 'utilitify';\r\n *\r\n * const result = validateUser({\r\n *   name: 'John Doe',\r\n *   email: 'john@example.com',\r\n *   phone: '+1 555-123-4567',\r\n *   country: 'US',\r\n *   password: 'MyP@ssw0rd!'\r\n * });\r\n *\r\n * if (!result.isValid) {\r\n *   console.log(result.errors);\r\n * }\r\n * ```\r\n */\r\nexport function validateUser(\r\n    userData: UserData,\r\n    options: UserValidationOptions = {}\r\n): UserValidationResult {\r\n    const opts = { ...DEFAULT_OPTIONS, ...options };\r\n    const errors: IValidationError[] = [];\r\n    const data: UserValidationResult['data'] = {};\r\n    const sanitized: Partial<UserData> = {};\r\n\r\n    // Check required fields\r\n    for (const field of opts.required || []) {\r\n        const value = userData[field];\r\n        if (value === undefined || value === null || value === '') {\r\n            errors.push({\r\n                field,\r\n                code: 'REQUIRED',\r\n                message: `${field} is required`,\r\n            });\r\n        }\r\n    }\r\n\r\n    // Validate name\r\n    if (userData.name !== undefined) {\r\n        const nameResult = validateName(userData.name, opts.name);\r\n        data.name = nameResult;\r\n        sanitized.name = nameResult.sanitized;\r\n\r\n        if (!nameResult.isValid) {\r\n            errors.push(...nameResult.errors);\r\n        }\r\n    }\r\n\r\n    // Validate email\r\n    if (userData.email !== undefined) {\r\n        const emailResult = validateEmail(userData.email, opts.email);\r\n        data.email = emailResult;\r\n        sanitized.email = emailResult.normalized;\r\n\r\n        if (!emailResult.isValid) {\r\n            errors.push(...emailResult.errors);\r\n        }\r\n    }\r\n\r\n    // Validate phone (use country if provided)\r\n    if (userData.phone !== undefined) {\r\n        const phoneOptions = {\r\n            ...opts.phone,\r\n            countryCode: opts.phone?.countryCode || userData.country,\r\n        };\r\n        const phoneResult = validatePhone(userData.phone, phoneOptions);\r\n        data.phone = phoneResult;\r\n        sanitized.phone = phoneResult.formatted.e164 || userData.phone;\r\n\r\n        if (!phoneResult.isValid) {\r\n            errors.push(...phoneResult.errors);\r\n        }\r\n    }\r\n\r\n    // Validate username\r\n    if (userData.username !== undefined) {\r\n        const usernameResult = validateUsername(userData.username, opts.username);\r\n        data.username = usernameResult;\r\n        sanitized.username = usernameResult.sanitized;\r\n\r\n        if (!usernameResult.isValid) {\r\n            errors.push(...usernameResult.errors);\r\n        }\r\n    }\r\n\r\n    // Check password strength (doesn't add to errors, just provides info)\r\n    if (userData.password !== undefined) {\r\n        const passwordResult = checkPasswordStrength(userData.password);\r\n\r\n        // Only add error if password is very weak\r\n        if (passwordResult.score < 2) {\r\n            errors.push({\r\n                field: 'password',\r\n                code: 'WEAK_PASSWORD',\r\n                message: 'Password is too weak. ' + (passwordResult.suggestions[0] || ''),\r\n            });\r\n        }\r\n    }\r\n\r\n    // Validate date of birth / calculate age\r\n    if (userData.dateOfBirth !== undefined) {\r\n        const ageResult = calculateAge(userData.dateOfBirth);\r\n\r\n        if (ageResult.years === 0 && typeof userData.dateOfBirth === 'string') {\r\n            errors.push({\r\n                field: 'dateOfBirth',\r\n                code: 'INVALID_DATE',\r\n                message: 'Invalid date of birth',\r\n            });\r\n        }\r\n    }\r\n\r\n    // Copy unvalidated fields\r\n    if (userData.country !== undefined) {\r\n        sanitized.country = userData.country.toUpperCase();\r\n    }\r\n\r\n    return {\r\n        isValid: errors.length === 0,\r\n        errors,\r\n        data,\r\n        sanitized,\r\n    };\r\n}\r\n\r\n/**\r\n * Quick validate - returns boolean only\r\n *\r\n * @param userData - User data to validate\r\n * @param options - Validation options\r\n * @returns true if all validations pass\r\n */\r\nexport function isValidUser(\r\n    userData: UserData,\r\n    options: UserValidationOptions = {}\r\n): boolean {\r\n    return validateUser(userData, options).isValid;\r\n}\r\n\r\n/**\r\n * Get validation errors as simple object\r\n *\r\n * @param userData - User data to validate\r\n * @param options - Validation options\r\n * @returns Object with field names as keys and array of error messages as values\r\n */\r\nexport function getUserErrors(\r\n    userData: UserData,\r\n    options: UserValidationOptions = {}\r\n): Record<string, string[]> {\r\n    const result = validateUser(userData, options);\r\n    const errorsByField: Record<string, string[]> = {};\r\n\r\n    for (const error of result.errors) {\r\n        if (!errorsByField[error.field]) {\r\n            errorsByField[error.field] = [];\r\n        }\r\n        errorsByField[error.field].push(error.message);\r\n    }\r\n\r\n    return errorsByField;\r\n}\r\n","/**\r\n * Simple LRU (Least Recently Used) Cache implementation\r\n * Used for caching expensive validation results or country data lookups.\r\n *\r\n * @packageDocumentation\r\n * @since 1.2.0\r\n */\r\n\r\nexport interface CacheOptions {\r\n    /** Maximum number of items to store (default: 100) */\r\n    maxSize?: number;\r\n    /** Time to live in milliseconds (default: Infinity) */\r\n    ttl?: number;\r\n}\r\n\r\ninterface CacheEntry<T> {\r\n    value: T;\r\n    expiry: number;\r\n}\r\n\r\n/**\r\n * LRU Cache class\r\n */\r\nexport class Cache<T = any> {\r\n    private items: Map<string, CacheEntry<T>>;\r\n    private maxSize: number;\r\n    private ttl: number;\r\n\r\n    /**\r\n     * Create a new Cache instance\r\n     * @param options - Cache options\r\n     */\r\n    constructor(options: CacheOptions = {}) {\r\n        this.items = new Map();\r\n        this.maxSize = options.maxSize || 100;\r\n        this.ttl = options.ttl || Infinity;\r\n    }\r\n\r\n    /**\r\n     * Get an item from the cache\r\n     * @param key - Cache key\r\n     * @returns Cached value or undefined\r\n     */\r\n    get(key: string): T | undefined {\r\n        const item = this.items.get(key);\r\n\r\n        if (!item) return undefined;\r\n\r\n        // Check expiry\r\n        if (Date.now() > item.expiry) {\r\n            this.items.delete(key);\r\n            return undefined;\r\n        }\r\n\r\n        // Refresh position (LRU) - delete and re-insert makes it the \"newest\"\r\n        this.items.delete(key);\r\n        this.items.set(key, item);\r\n\r\n        return item.value;\r\n    }\r\n\r\n    /**\r\n     * Set an item in the cache\r\n     * @param key - Cache key\r\n     * @param value - Value to cache\r\n     */\r\n    set(key: string, value: T): void {\r\n        // Evict oldest if full\r\n        if (this.items.size >= this.maxSize) {\r\n            const firstKey = this.items.keys().next().value;\r\n            if (firstKey) this.items.delete(firstKey);\r\n        }\r\n\r\n        const expiry = this.ttl === Infinity ? Infinity : Date.now() + this.ttl;\r\n        this.items.set(key, { value, expiry });\r\n    }\r\n\r\n    /**\r\n     * Check if item exists and is valid\r\n     * @param key - Cache key\r\n     */\r\n    has(key: string): boolean {\r\n        const item = this.items.get(key);\r\n        if (!item) return false;\r\n        if (Date.now() > item.expiry) {\r\n            this.items.delete(key);\r\n            return false;\r\n        }\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Clear the cache\r\n     */\r\n    clear(): void {\r\n        this.items.clear();\r\n    }\r\n\r\n    /**\r\n     * Get current size\r\n     */\r\n    get size(): number {\r\n        return this.items.size;\r\n    }\r\n}\r\n\r\n/**\r\n * Global default cache instance\r\n */\r\nexport const defaultCache = new Cache({ maxSize: 1000, ttl: 60 * 60 * 1000 });\r\n","/**\r\n * Middleware Pattern for data processing and validation pipelines\r\n * Allows composition of multiple functions into a single executable pipeline.\r\n *\r\n * @packageDocumentation\r\n * @since 1.2.0\r\n */\r\n\r\n/**\r\n * Middleware function type\r\n * @param context - The context/data being processed\r\n * @param next - Function to call the next middleware\r\n */\r\nexport type Middleware<T = any> = (context: T, next: () => Promise<void> | void) => Promise<void> | void;\r\n\r\n/**\r\n * Pipeline class for managing middleware execution\r\n */\r\nexport class Pipeline<T = any> {\r\n    private middlewares: Middleware<T>[] = [];\r\n\r\n    /**\r\n     * Add a middleware to the pipeline\r\n     * @param middleware - Middleware function\r\n     * @returns The pipeline instance for chaining\r\n     */\r\n    use(middleware: Middleware<T>): this {\r\n        this.middlewares.push(middleware);\r\n        return this;\r\n    }\r\n\r\n    /**\r\n     * Execute the pipeline with the given context\r\n     * @param context - Initial context data\r\n     * @returns The processed context\r\n     */\r\n    async execute(context: T): Promise<T> {\r\n        let index = -1;\r\n\r\n        const dispatch = async (i: number): Promise<void> => {\r\n            if (i <= index) throw new Error('next() called multiple times');\r\n            index = i;\r\n\r\n            const fn = this.middlewares[i];\r\n            if (i === this.middlewares.length) return;\r\n\r\n            if (!fn) return;\r\n\r\n            await fn(context, () => dispatch(i + 1));\r\n        };\r\n\r\n        await dispatch(0);\r\n        return context;\r\n    }\r\n}\r\n\r\n/**\r\n * Compose multiple functions into a single function (L-to-R)\r\n * @param fns - Functions to compose\r\n * @returns Composed function\r\n */\r\nexport function compose<T>(...fns: Array<(arg: T) => T>): (arg: T) => T {\r\n    return (arg: T) => fns.reduce((acc, fn) => fn(acc), arg);\r\n}\r\n\r\n/**\r\n * Async compose for Promise-returning functions\r\n * @param fns - Async functions to compose\r\n * @returns Composed async function\r\n */\r\nexport function composeAsync<T>(...fns: Array<(arg: T) => Promise<T> | T>): (arg: T) => Promise<T> {\r\n    return async (arg: T) => {\r\n        let result = arg;\r\n        for (const fn of fns) {\r\n            result = await fn(result);\r\n        }\r\n        return result;\r\n    };\r\n}\r\n","/**\r\n * Standardized Error Handling Module\r\n * Provides a hierarchy of error classes for consistent error reporting.\r\n *\r\n * @packageDocumentation\r\n * @since 1.2.0\r\n */\r\n\r\n/**\r\n * Base error class for all utility errors\r\n */\r\nexport class UtilitifyError extends Error {\r\n    public code: string;\r\n    public details?: any;\r\n\r\n    constructor(message: string, code: string = 'UNKNOWN_ERROR', details?: any) {\r\n        super(message);\r\n        this.name = 'UtilitifyError';\r\n        this.code = code;\r\n        this.details = details;\r\n        Object.setPrototypeOf(this, new.target.prototype);\r\n    }\r\n}\r\n\r\n/**\r\n * Error thrown when validation fails\r\n */\r\nexport class ValidationError extends UtilitifyError {\r\n    constructor(message: string, details?: any) {\r\n        super(message, 'VALIDATION_ERROR', details);\r\n        this.name = 'ValidationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Error thrown when a security check fails\r\n */\r\nexport class SecurityError extends UtilitifyError {\r\n    constructor(message: string, details?: any) {\r\n        super(message, 'SECURITY_ERROR', details);\r\n        this.name = 'SecurityError';\r\n    }\r\n}\r\n\r\n/**\r\n * Error thrown when configuration is invalid\r\n */\r\nexport class ConfigurationError extends UtilitifyError {\r\n    constructor(message: string, details?: any) {\r\n        super(message, 'CONFIGURATION_ERROR', details);\r\n        this.name = 'ConfigurationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Error thrown when an operation times out\r\n */\r\nexport class TimeoutError extends UtilitifyError {\r\n    constructor(message: string = 'Operation timed out', details?: any) {\r\n        super(message, 'TIMEOUT_ERROR', details);\r\n        this.name = 'TimeoutError';\r\n    }\r\n}\r\n\r\n/**\r\n * Helper to check if an error is a specific Utilitify error\r\n */\r\nexport function isUtilitifyError(error: unknown): error is UtilitifyError {\r\n    return error instanceof UtilitifyError;\r\n}\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,205 @@
+export { B as BaseOptions, D as DeepPartial, I as IValidationError, O as OptionalKeys, a as PlainObject, P as Primitive, R as RequireKeys, V as ValidationResult } from './common-CBDYNJeh.cjs';
+import { U as UserData, a as UserValidationOptions, b as UserValidationResult } from './index-BYsUCP3u.cjs';
+export { Z as CardType, X as CreditCardOptions, Y as CreditCardValidationResult, E as EmailOptions, d as EmailValidationResult, aa as IbanOptions, a6 as IpOptions, a7 as IpValidationResult, N as NameOptions, c as NameValidationResult, P as PhoneOptions, e as PhoneValidationResult, J as UrlOptions, K as UrlValidationResult, f as UsernameOptions, g as UsernameValidationResult, ab as VatOptions, O as detectCardType, m as detectScript, T as formatCardNumber, o as formatName, t as formatPhone, Q as getCardTypeFromPrefix, j as getEmailDomain, a4 as getIpVersion, F as getUrlDomain, I as isDangerousUrl, H as isDataUrl, h as isDisposableEmail, D as isHttpsUrl, a3 as isLoopbackIp, a2 as isPrivateIp, y as isReservedUsername, V as isValidCVV, a5 as isValidCidr, M as isValidCreditCard, i as isValidEmail, W as isValidExpiry, a1 as isValidIP, $ as isValidIPv4, a0 as isValidIPv6, l as isValidName, r as isValidPhone, C as isValidUrl, x as isValidUsername, R as luhnCheck, S as maskCardNumber, n as normalizeEmail, G as normalizeUrl, u as parsePhone, s as sanitizeName, z as sanitizeUsername, p as splitName, A as suggestUsernames, L as validateCreditCard, v as validateEmail, a8 as validateIBAN, _ as validateIp, k as validateName, q as validatePhone, B as validateUrl, w as validateUsername, a9 as validateVAT } from './index-BYsUCP3u.cjs';
+export { I as COUNTRIES, J as CURRENCIES, C as Country, b as CountryCodeFormat, a as CurrencyInfo, K as PHONE_FORMATS, P as PhoneFormat, T as TimezoneInfo, f as convertCountryCode, y as convertCurrency, p as convertTimeBetweenCountries, u as formatCurrency, q as formatTimeForCountry, G as formatWithDialingCode, h as getAllCountries, w as getAllCurrencies, D as getAllFlags, i as getCountriesByContinent, F as getCountriesByDialingCode, j as getCountriesByLanguage, e as getCountry, g as getCountryByAlpha2, c as getCountryByAlpha3, d as getCountryByNumeric, A as getCountryFromEmoji, r as getCurrency, t as getCurrencyByCountry, x as getCurrencySymbol, n as getCurrentTimeInCountry, m as getDefaultTimezone, E as getDialingCode, z as getFlagEmoji, L as getPhoneFormat, M as getSupportedPhoneCountries, o as getTimezoneOffset, l as getTimezonesByCountry, H as hasValidDialingCode, B as isFlagEmoji, k as isValidCountryCode, v as parseCurrency, s as searchCountries } from './index-Cl26FrAZ.cjs';
+export { MaskOptions, PasswordOptions, SlugOptions, TruncateOptions, capitalize, ellipsis, generateBase64String, generateHexString, generateOTP, generatePassphrase, generatePassword, generateRandomString, generateUrlSafeString, isValidSlug, maskCreditCard, maskEmail, maskIP, maskName, maskPhone, maskString, needsTruncation, slugify, swapCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toSentenceCase, toSlug, toSnakeCase, toTitleCase, transliterate, truncate, truncateFilename, truncateHtml, truncateSentences, truncateWords, uncapitalize, uniqueSlug } from './string/index.cjs';
+export { AgeResult, DateFormatOptions, TimeDiff, addTime, calculateAge, diffIn, endOf, formatDate, formatDateByLocale, formatRelativeTime, getAgeBracket, getAgeInYears, getDaysInMonth, getMinAgeDOB, getTimeDiff, isAdult, isAgeInRange, isBetween, isInFuture, isInPast, isLeapYear, isMinor, isToday, isValidDate, isWeekday, isWeekend, parseDate, startOf, subtractTime, toISODate } from './date/index.cjs';
+export { PasswordStrength, PasswordStrengthOptions, checkPasswordStrength, generateBase64Token, generateNanoId, generateSecureToken, generateShortId, generateToken, generateUUID, generateUUIDv7, generateUrlSafeToken, getPasswordFeedback, getUUIDv7Timestamp, hashBcrypt, hashMD5, hashSHA256, hashSHA512, hmacSHA256, isStrongPassword, isValidUUID, meetsRequirements, timingSafeCompare, verifyBcrypt } from './security/index.cjs';
+export { FlattenOptions, MergeOptions, SanitizeOptions, cloneDeep, compact, compactDeep, deepMerge, deepMergeWith, escapeHtml, flattenObject, get, getAllKeys, invert, mapKeys, mapValues, omit, omitBy, pick, pickBy, removeControlChars, sanitizeObject, sanitizeString, sanitizeUrl, set, stripHtml, unescapeHtml, unflattenObject } from './transform/index.cjs';
+export { ConditionalRule, ErrorMessages, createErrorMessages, errors, formatMessage, formatValidationResult, inRange, isEmpty, isPresent, matchesPattern, maxLength, minLength, mustMatch, oneOf, requireAllOrNone, requireOneOf, required, requiredIf, requiredUnless, validateConditional } from './form/index.cjs';
+export { ClientInfo, EnvSchema, EnvValidationResult, detectClient, getEnv, getEnvBoolean, getEnvNumber, getRequiredEnv, getScreenSize, isBrowser, isDevelopment, isMobile, isNode, isProduction, isTest, isTouchDevice, prefersDarkMode, prefersReducedMotion, validateEnv } from './environment/index.cjs';
+export { AsyncValidationOptions, AsyncValidationResult, AsyncValidator, composeValidators, createDebouncedValidator, validateAllAsync, validateAsync } from './async.cjs';
+export { Locale, MessageTemplates, addLocale, getAvailableLocales, getLocale, getMessage, setCustomMessages, setLocale, withLocalization } from './i18n.cjs';
+export { COMMON_PASSWORD_PATTERNS, CORPORATE_EMAIL_DOMAINS, DISPOSABLE_EMAIL_DOMAINS, FREE_EMAIL_DOMAINS, RESERVED_USERNAMES, addDisposableDomains, addFreeEmailDomains, addReservedUsernames } from './constants.cjs';
+export { ParseResult, z } from './schema.cjs';
+
+/**
+ * Validate user data with automatic field detection
+ *
+ * This is the unified validation function that validates all provided
+ * user fields and returns standardized errors.
+ *
+ * @param userData - User data to validate
+ * @param options - Validation options
+ * @returns Validation result with all errors
+ *
+ * @example
+ * ```typescript
+ * import { validateUser } from 'utilitify';
+ *
+ * const result = validateUser({
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ *   phone: '+1 555-123-4567',
+ *   country: 'US',
+ *   password: 'MyP@ssw0rd!'
+ * });
+ *
+ * if (!result.isValid) {
+ *   console.log(result.errors);
+ * }
+ * ```
+ */
+declare function validateUser(userData: UserData, options?: UserValidationOptions): UserValidationResult;
+/**
+ * Quick validate - returns boolean only
+ *
+ * @param userData - User data to validate
+ * @param options - Validation options
+ * @returns true if all validations pass
+ */
+declare function isValidUser(userData: UserData, options?: UserValidationOptions): boolean;
+/**
+ * Get validation errors as simple object
+ *
+ * @param userData - User data to validate
+ * @param options - Validation options
+ * @returns Object with field names as keys and array of error messages as values
+ */
+declare function getUserErrors(userData: UserData, options?: UserValidationOptions): Record<string, string[]>;
+
+/**
+ * Simple LRU (Least Recently Used) Cache implementation
+ * Used for caching expensive validation results or country data lookups.
+ *
+ * @packageDocumentation
+ * @since 1.2.0
+ */
+interface CacheOptions {
+    /** Maximum number of items to store (default: 100) */
+    maxSize?: number;
+    /** Time to live in milliseconds (default: Infinity) */
+    ttl?: number;
+}
+/**
+ * LRU Cache class
+ */
+declare class Cache<T = any> {
+    private items;
+    private maxSize;
+    private ttl;
+    /**
+     * Create a new Cache instance
+     * @param options - Cache options
+     */
+    constructor(options?: CacheOptions);
+    /**
+     * Get an item from the cache
+     * @param key - Cache key
+     * @returns Cached value or undefined
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set an item in the cache
+     * @param key - Cache key
+     * @param value - Value to cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if item exists and is valid
+     * @param key - Cache key
+     */
+    has(key: string): boolean;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get current size
+     */
+    get size(): number;
+}
+/**
+ * Global default cache instance
+ */
+declare const defaultCache: Cache<any>;
+
+/**
+ * Middleware Pattern for data processing and validation pipelines
+ * Allows composition of multiple functions into a single executable pipeline.
+ *
+ * @packageDocumentation
+ * @since 1.2.0
+ */
+/**
+ * Middleware function type
+ * @param context - The context/data being processed
+ * @param next - Function to call the next middleware
+ */
+type Middleware<T = any> = (context: T, next: () => Promise<void> | void) => Promise<void> | void;
+/**
+ * Pipeline class for managing middleware execution
+ */
+declare class Pipeline<T = any> {
+    private middlewares;
+    /**
+     * Add a middleware to the pipeline
+     * @param middleware - Middleware function
+     * @returns The pipeline instance for chaining
+     */
+    use(middleware: Middleware<T>): this;
+    /**
+     * Execute the pipeline with the given context
+     * @param context - Initial context data
+     * @returns The processed context
+     */
+    execute(context: T): Promise<T>;
+}
+/**
+ * Compose multiple functions into a single function (L-to-R)
+ * @param fns - Functions to compose
+ * @returns Composed function
+ */
+declare function compose<T>(...fns: Array<(arg: T) => T>): (arg: T) => T;
+/**
+ * Async compose for Promise-returning functions
+ * @param fns - Async functions to compose
+ * @returns Composed async function
+ */
+declare function composeAsync<T>(...fns: Array<(arg: T) => Promise<T> | T>): (arg: T) => Promise<T>;
+
+/**
+ * Standardized Error Handling Module
+ * Provides a hierarchy of error classes for consistent error reporting.
+ *
+ * @packageDocumentation
+ * @since 1.2.0
+ */
+/**
+ * Base error class for all utility errors
+ */
+declare class UtilitifyError extends Error {
+    code: string;
+    details?: any;
+    constructor(message: string, code?: string, details?: any);
+}
+/**
+ * Error thrown when validation fails
+ */
+declare class ValidationError extends UtilitifyError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Error thrown when a security check fails
+ */
+declare class SecurityError extends UtilitifyError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Error thrown when configuration is invalid
+ */
+declare class ConfigurationError extends UtilitifyError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Error thrown when an operation times out
+ */
+declare class TimeoutError extends UtilitifyError {
+    constructor(message?: string, details?: any);
+}
+/**
+ * Helper to check if an error is a specific Utilitify error
+ */
+declare function isUtilitifyError(error: unknown): error is UtilitifyError;
+
+export { Cache, type CacheOptions, ConfigurationError, type Middleware, Pipeline, SecurityError, TimeoutError, UserData, UserValidationOptions, UserValidationResult, UtilitifyError, ValidationError, compose, composeAsync, defaultCache, getUserErrors, isUtilitifyError, isValidUser, validateUser };

package/dist/index.d.ts

@@ -0,0 +1,205 @@
+export { B as BaseOptions, D as DeepPartial, I as IValidationError, O as OptionalKeys, a as PlainObject, P as Primitive, R as RequireKeys, V as ValidationResult } from './common-CBDYNJeh.js';
+import { U as UserData, a as UserValidationOptions, b as UserValidationResult } from './index-BXBmBHyL.js';
+export { Z as CardType, X as CreditCardOptions, Y as CreditCardValidationResult, E as EmailOptions, d as EmailValidationResult, aa as IbanOptions, a6 as IpOptions, a7 as IpValidationResult, N as NameOptions, c as NameValidationResult, P as PhoneOptions, e as PhoneValidationResult, J as UrlOptions, K as UrlValidationResult, f as UsernameOptions, g as UsernameValidationResult, ab as VatOptions, O as detectCardType, m as detectScript, T as formatCardNumber, o as formatName, t as formatPhone, Q as getCardTypeFromPrefix, j as getEmailDomain, a4 as getIpVersion, F as getUrlDomain, I as isDangerousUrl, H as isDataUrl, h as isDisposableEmail, D as isHttpsUrl, a3 as isLoopbackIp, a2 as isPrivateIp, y as isReservedUsername, V as isValidCVV, a5 as isValidCidr, M as isValidCreditCard, i as isValidEmail, W as isValidExpiry, a1 as isValidIP, $ as isValidIPv4, a0 as isValidIPv6, l as isValidName, r as isValidPhone, C as isValidUrl, x as isValidUsername, R as luhnCheck, S as maskCardNumber, n as normalizeEmail, G as normalizeUrl, u as parsePhone, s as sanitizeName, z as sanitizeUsername, p as splitName, A as suggestUsernames, L as validateCreditCard, v as validateEmail, a8 as validateIBAN, _ as validateIp, k as validateName, q as validatePhone, B as validateUrl, w as validateUsername, a9 as validateVAT } from './index-BXBmBHyL.js';
+export { I as COUNTRIES, J as CURRENCIES, C as Country, b as CountryCodeFormat, a as CurrencyInfo, K as PHONE_FORMATS, P as PhoneFormat, T as TimezoneInfo, f as convertCountryCode, y as convertCurrency, p as convertTimeBetweenCountries, u as formatCurrency, q as formatTimeForCountry, G as formatWithDialingCode, h as getAllCountries, w as getAllCurrencies, D as getAllFlags, i as getCountriesByContinent, F as getCountriesByDialingCode, j as getCountriesByLanguage, e as getCountry, g as getCountryByAlpha2, c as getCountryByAlpha3, d as getCountryByNumeric, A as getCountryFromEmoji, r as getCurrency, t as getCurrencyByCountry, x as getCurrencySymbol, n as getCurrentTimeInCountry, m as getDefaultTimezone, E as getDialingCode, z as getFlagEmoji, L as getPhoneFormat, M as getSupportedPhoneCountries, o as getTimezoneOffset, l as getTimezonesByCountry, H as hasValidDialingCode, B as isFlagEmoji, k as isValidCountryCode, v as parseCurrency, s as searchCountries } from './index-Cl26FrAZ.js';
+export { MaskOptions, PasswordOptions, SlugOptions, TruncateOptions, capitalize, ellipsis, generateBase64String, generateHexString, generateOTP, generatePassphrase, generatePassword, generateRandomString, generateUrlSafeString, isValidSlug, maskCreditCard, maskEmail, maskIP, maskName, maskPhone, maskString, needsTruncation, slugify, swapCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toSentenceCase, toSlug, toSnakeCase, toTitleCase, transliterate, truncate, truncateFilename, truncateHtml, truncateSentences, truncateWords, uncapitalize, uniqueSlug } from './string/index.js';
+export { AgeResult, DateFormatOptions, TimeDiff, addTime, calculateAge, diffIn, endOf, formatDate, formatDateByLocale, formatRelativeTime, getAgeBracket, getAgeInYears, getDaysInMonth, getMinAgeDOB, getTimeDiff, isAdult, isAgeInRange, isBetween, isInFuture, isInPast, isLeapYear, isMinor, isToday, isValidDate, isWeekday, isWeekend, parseDate, startOf, subtractTime, toISODate } from './date/index.js';
+export { PasswordStrength, PasswordStrengthOptions, checkPasswordStrength, generateBase64Token, generateNanoId, generateSecureToken, generateShortId, generateToken, generateUUID, generateUUIDv7, generateUrlSafeToken, getPasswordFeedback, getUUIDv7Timestamp, hashBcrypt, hashMD5, hashSHA256, hashSHA512, hmacSHA256, isStrongPassword, isValidUUID, meetsRequirements, timingSafeCompare, verifyBcrypt } from './security/index.js';
+export { FlattenOptions, MergeOptions, SanitizeOptions, cloneDeep, compact, compactDeep, deepMerge, deepMergeWith, escapeHtml, flattenObject, get, getAllKeys, invert, mapKeys, mapValues, omit, omitBy, pick, pickBy, removeControlChars, sanitizeObject, sanitizeString, sanitizeUrl, set, stripHtml, unescapeHtml, unflattenObject } from './transform/index.js';
+export { ConditionalRule, ErrorMessages, createErrorMessages, errors, formatMessage, formatValidationResult, inRange, isEmpty, isPresent, matchesPattern, maxLength, minLength, mustMatch, oneOf, requireAllOrNone, requireOneOf, required, requiredIf, requiredUnless, validateConditional } from './form/index.js';
+export { ClientInfo, EnvSchema, EnvValidationResult, detectClient, getEnv, getEnvBoolean, getEnvNumber, getRequiredEnv, getScreenSize, isBrowser, isDevelopment, isMobile, isNode, isProduction, isTest, isTouchDevice, prefersDarkMode, prefersReducedMotion, validateEnv } from './environment/index.js';
+export { AsyncValidationOptions, AsyncValidationResult, AsyncValidator, composeValidators, createDebouncedValidator, validateAllAsync, validateAsync } from './async.js';
+export { Locale, MessageTemplates, addLocale, getAvailableLocales, getLocale, getMessage, setCustomMessages, setLocale, withLocalization } from './i18n.js';
+export { COMMON_PASSWORD_PATTERNS, CORPORATE_EMAIL_DOMAINS, DISPOSABLE_EMAIL_DOMAINS, FREE_EMAIL_DOMAINS, RESERVED_USERNAMES, addDisposableDomains, addFreeEmailDomains, addReservedUsernames } from './constants.js';
+export { ParseResult, z } from './schema.js';
+
+/**
+ * Validate user data with automatic field detection
+ *
+ * This is the unified validation function that validates all provided
+ * user fields and returns standardized errors.
+ *
+ * @param userData - User data to validate
+ * @param options - Validation options
+ * @returns Validation result with all errors
+ *
+ * @example
+ * ```typescript
+ * import { validateUser } from 'utilitify';
+ *
+ * const result = validateUser({
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ *   phone: '+1 555-123-4567',
+ *   country: 'US',
+ *   password: 'MyP@ssw0rd!'
+ * });
+ *
+ * if (!result.isValid) {
+ *   console.log(result.errors);
+ * }
+ * ```
+ */
+declare function validateUser(userData: UserData, options?: UserValidationOptions): UserValidationResult;
+/**
+ * Quick validate - returns boolean only
+ *
+ * @param userData - User data to validate
+ * @param options - Validation options
+ * @returns true if all validations pass
+ */
+declare function isValidUser(userData: UserData, options?: UserValidationOptions): boolean;
+/**
+ * Get validation errors as simple object
+ *
+ * @param userData - User data to validate
+ * @param options - Validation options
+ * @returns Object with field names as keys and array of error messages as values
+ */
+declare function getUserErrors(userData: UserData, options?: UserValidationOptions): Record<string, string[]>;
+
+/**
+ * Simple LRU (Least Recently Used) Cache implementation
+ * Used for caching expensive validation results or country data lookups.
+ *
+ * @packageDocumentation
+ * @since 1.2.0
+ */
+interface CacheOptions {
+    /** Maximum number of items to store (default: 100) */
+    maxSize?: number;
+    /** Time to live in milliseconds (default: Infinity) */
+    ttl?: number;
+}
+/**
+ * LRU Cache class
+ */
+declare class Cache<T = any> {
+    private items;
+    private maxSize;
+    private ttl;
+    /**
+     * Create a new Cache instance
+     * @param options - Cache options
+     */
+    constructor(options?: CacheOptions);
+    /**
+     * Get an item from the cache
+     * @param key - Cache key
+     * @returns Cached value or undefined
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set an item in the cache
+     * @param key - Cache key
+     * @param value - Value to cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if item exists and is valid
+     * @param key - Cache key
+     */
+    has(key: string): boolean;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get current size
+     */
+    get size(): number;
+}
+/**
+ * Global default cache instance
+ */
+declare const defaultCache: Cache<any>;
+
+/**
+ * Middleware Pattern for data processing and validation pipelines
+ * Allows composition of multiple functions into a single executable pipeline.
+ *
+ * @packageDocumentation
+ * @since 1.2.0
+ */
+/**
+ * Middleware function type
+ * @param context - The context/data being processed
+ * @param next - Function to call the next middleware
+ */
+type Middleware<T = any> = (context: T, next: () => Promise<void> | void) => Promise<void> | void;
+/**
+ * Pipeline class for managing middleware execution
+ */
+declare class Pipeline<T = any> {
+    private middlewares;
+    /**
+     * Add a middleware to the pipeline
+     * @param middleware - Middleware function
+     * @returns The pipeline instance for chaining
+     */
+    use(middleware: Middleware<T>): this;
+    /**
+     * Execute the pipeline with the given context
+     * @param context - Initial context data
+     * @returns The processed context
+     */
+    execute(context: T): Promise<T>;
+}
+/**
+ * Compose multiple functions into a single function (L-to-R)
+ * @param fns - Functions to compose
+ * @returns Composed function
+ */
+declare function compose<T>(...fns: Array<(arg: T) => T>): (arg: T) => T;
+/**
+ * Async compose for Promise-returning functions
+ * @param fns - Async functions to compose
+ * @returns Composed async function
+ */
+declare function composeAsync<T>(...fns: Array<(arg: T) => Promise<T> | T>): (arg: T) => Promise<T>;
+
+/**
+ * Standardized Error Handling Module
+ * Provides a hierarchy of error classes for consistent error reporting.
+ *
+ * @packageDocumentation
+ * @since 1.2.0
+ */
+/**
+ * Base error class for all utility errors
+ */
+declare class UtilitifyError extends Error {
+    code: string;
+    details?: any;
+    constructor(message: string, code?: string, details?: any);
+}
+/**
+ * Error thrown when validation fails
+ */
+declare class ValidationError extends UtilitifyError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Error thrown when a security check fails
+ */
+declare class SecurityError extends UtilitifyError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Error thrown when configuration is invalid
+ */
+declare class ConfigurationError extends UtilitifyError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Error thrown when an operation times out
+ */
+declare class TimeoutError extends UtilitifyError {
+    constructor(message?: string, details?: any);
+}
+/**
+ * Helper to check if an error is a specific Utilitify error
+ */
+declare function isUtilitifyError(error: unknown): error is UtilitifyError;
+
+export { Cache, type CacheOptions, ConfigurationError, type Middleware, Pipeline, SecurityError, TimeoutError, UserData, UserValidationOptions, UserValidationResult, UtilitifyError, ValidationError, compose, composeAsync, defaultCache, getUserErrors, isUtilitifyError, isValidUser, validateUser };