quantique-field-validator 1.0.9 → 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * quantique-field-validator
+ *
+ * Enterprise-grade dynamic field validator for Indian and international form fields.
+ * Supports tree-shakeable named exports (individual validators) and a single
+ * dynamicValidator entry point that dispatches by type string.
+ *
+ * @module @quantique-field-validator
+ */
+import defaultErrorMessages from './messages/defaultErrorMessages';
+import validateString from './validators/validateString';
+import validateAlphanumeric from './validators/validateAlphanumeric';
+import validateNumber from './validators/validateNumber';
+import validateFloatNumber from './validators/validateFloatNumber';
+import validateDate from './validators/validateDate';
+import validateName from './validators/validateName';
+import validateFirstMiddleLastName from './validators/validateFirstMiddleLastName';
+import validateEmail from './validators/validateEmail';
+import validateMobile from './validators/validateMobile';
+import validateAddress from './validators/validateAddress';
+import validatePassword from './validators/validatePassword';
+import validateURL from './validators/validateURL';
+import validateCustom from './validators/validateCustom';
+import validateAadhaar from './validators/validateAadhaar';
+import validatePanCard from './validators/validatePanCard';
+import validateGST from './validators/validateGST';
+import validateChassisNumber from './validators/validateChassisNumber';
+import validateEngineNumber from './validators/validateEngineNumber';
+import validateIPAddress from './validators/validateIPAddress';
+import validateRTO from './validators/validateRTO';
+import validateBankIFSC from './validators/validateBankIFSC';
+import validatePincode from './validators/validatePincode';
+export type { ValidationResult, ValidationRules, ErrorMessages, ValidatorFn, ValidatorType, CustomValidatorFn, DefaultErrorMessagesFn, } from './types';
+export { defaultErrorMessages, validateString, validateAlphanumeric, validateNumber, validateFloatNumber, validateDate, validateName, validateFirstMiddleLastName, validateEmail, validateMobile, validateAddress, validatePassword, validateURL, validateCustom, validateAadhaar, validatePanCard, validateGST, validateChassisNumber, validateEngineNumber, validateIPAddress, validateRTO, validateBankIFSC, validatePincode, };
+import type { ValidationResult, ValidationRules, ValidatorType, CustomValidatorFn } from './types';
+/**
+ * Dynamic field validator — dispatches validation based on the `type` string.
+ *
+ * @param value           - Raw input value (string or any type for number validators)
+ * @param type            - Validator type key (e.g. 'email', 'mobile', 'aadhaar')
+ * @param rules           - Optional validation rules (minLength, regex, required, etc.)
+ * @param customValidator - Optional external custom validator; runs before type dispatch
+ * @returns               ValidationResult { isValid: boolean, error: string }
+ *
+ * @example
+ * dynamicValidator('test@example.com', 'email') // { isValid: true, error: '' }
+ * dynamicValidator('', 'email', { required: true }) // { isValid: false, error: '...' }
+ */
+declare const dynamicValidator: (value: unknown, type: ValidatorType, rules?: ValidationRules, customValidator?: CustomValidatorFn | null) => ValidationResult;
+export default dynamicValidator;
+export { dynamicValidator };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,oBAAoB,MAAM,iCAAiC,CAAC;AACnE,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,oBAAoB,MAAM,mCAAmC,CAAC;AACrE,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,mBAAmB,MAAM,kCAAkC,CAAC;AACnE,OAAO,YAAY,MAAM,2BAA2B,CAAC;AACrD,OAAO,YAAY,MAAM,2BAA2B,CAAC;AACrD,OAAO,2BAA2B,MAAM,0CAA0C,CAAC;AACnF,OAAO,aAAa,MAAM,4BAA4B,CAAC;AACvD,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,eAAe,MAAM,8BAA8B,CAAC;AAC3D,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,eAAe,MAAM,8BAA8B,CAAC;AAC3D,OAAO,eAAe,MAAM,8BAA8B,CAAC;AAC3D,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,qBAAqB,MAAM,oCAAoC,CAAC;AACvE,OAAO,oBAAoB,MAAM,mCAAmC,CAAC;AACrE,OAAO,iBAAiB,MAAM,gCAAgC,CAAC;AAC/D,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,eAAe,MAAM,8BAA8B,CAAC;AAG3D,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,2BAA2B,EAC3B,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,CAAC;AAEF,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,gBAAgB,GACpB,OAAO,OAAO,EACd,MAAM,aAAa,EACnB,QAAO,eAAoB,EAC3B,kBAAiB,iBAAiB,GAAG,IAAW,KAC/C,gBAoIF,CAAC;AAEF,eAAe,gBAAgB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * quantique-field-validator
+ *
+ * Enterprise-grade dynamic field validator for Indian and international form fields.
+ * Supports tree-shakeable named exports (individual validators) and a single
+ * dynamicValidator entry point that dispatches by type string.
+ *
+ * @module @quantique-field-validator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dynamicValidator = exports.validatePincode = exports.validateBankIFSC = exports.validateRTO = exports.validateIPAddress = exports.validateEngineNumber = exports.validateChassisNumber = exports.validateGST = exports.validatePanCard = exports.validateAadhaar = exports.validateCustom = exports.validateURL = exports.validatePassword = exports.validateAddress = exports.validateMobile = exports.validateEmail = exports.validateFirstMiddleLastName = exports.validateName = exports.validateDate = exports.validateFloatNumber = exports.validateNumber = exports.validateAlphanumeric = exports.validateString = exports.defaultErrorMessages = void 0;
+const defaultErrorMessages_1 = require("./messages/defaultErrorMessages");
+exports.defaultErrorMessages = defaultErrorMessages_1.default;
+const validateString_1 = require("./validators/validateString");
+exports.validateString = validateString_1.default;
+const validateAlphanumeric_1 = require("./validators/validateAlphanumeric");
+exports.validateAlphanumeric = validateAlphanumeric_1.default;
+const validateNumber_1 = require("./validators/validateNumber");
+exports.validateNumber = validateNumber_1.default;
+const validateFloatNumber_1 = require("./validators/validateFloatNumber");
+exports.validateFloatNumber = validateFloatNumber_1.default;
+const validateDate_1 = require("./validators/validateDate");
+exports.validateDate = validateDate_1.default;
+const validateName_1 = require("./validators/validateName");
+exports.validateName = validateName_1.default;
+const validateFirstMiddleLastName_1 = require("./validators/validateFirstMiddleLastName");
+exports.validateFirstMiddleLastName = validateFirstMiddleLastName_1.default;
+const validateEmail_1 = require("./validators/validateEmail");
+exports.validateEmail = validateEmail_1.default;
+const validateMobile_1 = require("./validators/validateMobile");
+exports.validateMobile = validateMobile_1.default;
+const validateAddress_1 = require("./validators/validateAddress");
+exports.validateAddress = validateAddress_1.default;
+const validatePassword_1 = require("./validators/validatePassword");
+exports.validatePassword = validatePassword_1.default;
+const validateURL_1 = require("./validators/validateURL");
+exports.validateURL = validateURL_1.default;
+const validateCustom_1 = require("./validators/validateCustom");
+exports.validateCustom = validateCustom_1.default;
+const validateAadhaar_1 = require("./validators/validateAadhaar");
+exports.validateAadhaar = validateAadhaar_1.default;
+const validatePanCard_1 = require("./validators/validatePanCard");
+exports.validatePanCard = validatePanCard_1.default;
+const validateGST_1 = require("./validators/validateGST");
+exports.validateGST = validateGST_1.default;
+const validateChassisNumber_1 = require("./validators/validateChassisNumber");
+exports.validateChassisNumber = validateChassisNumber_1.default;
+const validateEngineNumber_1 = require("./validators/validateEngineNumber");
+exports.validateEngineNumber = validateEngineNumber_1.default;
+const validateIPAddress_1 = require("./validators/validateIPAddress");
+exports.validateIPAddress = validateIPAddress_1.default;
+const validateRTO_1 = require("./validators/validateRTO");
+exports.validateRTO = validateRTO_1.default;
+const validateBankIFSC_1 = require("./validators/validateBankIFSC");
+exports.validateBankIFSC = validateBankIFSC_1.default;
+const validatePincode_1 = require("./validators/validatePincode");
+exports.validatePincode = validatePincode_1.default;
+const safeRegex_1 = require("./utils/safeRegex");
+/**
+ * Dynamic field validator — dispatches validation based on the `type` string.
+ *
+ * @param value           - Raw input value (string or any type for number validators)
+ * @param type            - Validator type key (e.g. 'email', 'mobile', 'aadhaar')
+ * @param rules           - Optional validation rules (minLength, regex, required, etc.)
+ * @param customValidator - Optional external custom validator; runs before type dispatch
+ * @returns               ValidationResult { isValid: boolean, error: string }
+ *
+ * @example
+ * dynamicValidator('test@example.com', 'email') // { isValid: true, error: '' }
+ * dynamicValidator('', 'email', { required: true }) // { isValid: false, error: '...' }
+ */
+const dynamicValidator = (value, type, rules = {}, customValidator = null) => {
+    var _a, _b, _c, _d, _e;
+    const selectedValue = value;
+    if (typeof selectedValue === 'string' && safeRegex_1.EMOJI_REGEX.test(selectedValue)) {
+        return {
+            isValid: false,
+            error: (_c = (_b = (_a = rules.errorMessages) === null || _a === void 0 ? void 0 : _a.emoji) !== null && _b !== void 0 ? _b : (0, defaultErrorMessages_1.default)(rules, type).emoji) !== null && _c !== void 0 ? _c : 'Value contains emoji characters which are not allowed',
+        };
+    }
+    if (rules.required && (!selectedValue || selectedValue === '')) {
+        return {
+            isValid: false,
+            error: (_e = (_d = rules.errorMessages) === null || _d === void 0 ? void 0 : _d.required) !== null && _e !== void 0 ? _e : (0, defaultErrorMessages_1.default)(rules, type).required,
+        };
+    }
+    if (!rules.required && (!selectedValue || selectedValue === '')) {
+        return { isValid: true, error: '' };
+    }
+    if (customValidator !== null && typeof customValidator === 'function') {
+        const result = customValidator(selectedValue);
+        if (typeof result === 'object' && result.isValid === false) {
+            return {
+                isValid: false,
+                error: result.error || (0, defaultErrorMessages_1.default)(rules, type).customValidation,
+            };
+        }
+        if (result === false) {
+            return {
+                isValid: false,
+                error: (0, defaultErrorMessages_1.default)(rules, type).customValidation,
+            };
+        }
+    }
+    if (rules.customValidator !== undefined && typeof rules.customValidator === 'function') {
+        const result = rules.customValidator(selectedValue);
+        if (typeof result === 'object' && result.isValid === false) {
+            return {
+                isValid: false,
+                error: result.error || (0, defaultErrorMessages_1.default)(rules, type).custom,
+            };
+        }
+        if (result === false) {
+            return {
+                isValid: false,
+                error: (0, defaultErrorMessages_1.default)(rules, type).custom,
+            };
+        }
+    }
+    switch (type) {
+        case 'string':
+            return (0, validateString_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'alphanumeric':
+            return (0, validateAlphanumeric_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'number':
+            return (0, validateNumber_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'float':
+            return (0, validateFloatNumber_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'date':
+            return (0, validateDate_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'name':
+            return (0, validateName_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'firstName':
+        case 'middleName':
+        case 'lastName':
+            return (0, validateFirstMiddleLastName_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'email':
+            return (0, validateEmail_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'mobile':
+            return (0, validateMobile_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'address':
+            return (0, validateAddress_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'password':
+            return (0, validatePassword_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'url':
+            return (0, validateURL_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'pincode':
+            return (0, validatePincode_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'chassis':
+            return (0, validateChassisNumber_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'engine':
+            return (0, validateEngineNumber_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'aadhaar':
+            return (0, validateAadhaar_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'pan':
+            return (0, validatePanCard_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'gst':
+            return (0, validateGST_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'rto':
+            return (0, validateRTO_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'ifsc':
+            return (0, validateBankIFSC_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'ip':
+            return (0, validateIPAddress_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        case 'custom':
+            return (0, validateCustom_1.default)(selectedValue, rules, defaultErrorMessages_1.default, type);
+        default:
+            return {
+                isValid: false,
+                error: (0, defaultErrorMessages_1.default)(rules, type).noValidation,
+            };
+    }
+};
+exports.dynamicValidator = dynamicValidator;
+exports.default = dynamicValidator;

package/dist/messages/defaultErrorMessages.d.ts

@@ -0,0 +1,8 @@
+import type { DefaultErrorMessagesFn } from '../types';
+/**
+ * Returns a strongly-typed map of default error messages for all validation scenarios.
+ * All messages can be overridden via rules.errorMessages.
+ */
+declare const defaultErrorMessages: DefaultErrorMessagesFn;
+export default defaultErrorMessages;
+//# sourceMappingURL=defaultErrorMessages.d.ts.map

package/dist/messages/defaultErrorMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultErrorMessages.d.ts","sourceRoot":"","sources":["../../src/messages/defaultErrorMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;;GAGG;AACH,QAAA,MAAM,oBAAoB,EAAE,sBA2B1B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/messages/defaultErrorMessages.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Returns a strongly-typed map of default error messages for all validation scenarios.
+ * All messages can be overridden via rules.errorMessages.
+ */
+const defaultErrorMessages = (rules, type) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    return ({
+        noSpace: 'Value should not contain spaces',
+        minAge: `User must be at least ${(_a = rules.minAge) !== null && _a !== void 0 ? _a : ''} years old`,
+        maxAge: `User must be at most ${(_b = rules.maxAge) !== null && _b !== void 0 ? _b : ''} years old`,
+        minMinus: 'Date is too far in the past',
+        maxMinus: 'Date must be further in the past',
+        minPlus: 'Date must be further in the future',
+        maxPlus: 'Date is too far in the future',
+        required: 'This field is required',
+        minLength: `Minimum length should be ${(_c = rules.minLength) !== null && _c !== void 0 ? _c : ''}`,
+        maxLength: `Maximum length should be ${(_d = rules.maxLength) !== null && _d !== void 0 ? _d : ''}`,
+        minValue: `Minimum value should be ${(_e = rules.minValue) !== null && _e !== void 0 ? _e : ''}`,
+        maxValue: `Maximum value should be ${(_f = rules.maxValue) !== null && _f !== void 0 ? _f : ''}`,
+        invalid: `Please enter a valid ${type}`,
+        noValidation: `No validation exists for type "${type}"`,
+        custom: 'Validation failed',
+        Alphanumeric: 'Value must be alphanumeric',
+        chassisNumber: 'Invalid chassis number',
+        engineNumber: 'Invalid engine number',
+        ipAddress: 'Invalid IP address',
+        name: 'Invalid name',
+        rto: 'Invalid RTO code',
+        ifsc: 'Invalid bank IFSC code',
+        url: 'Please enter a valid URL',
+        pincode: 'Please enter a valid 6-digit PIN code',
+        customValidation: (_h = (_g = rules.errorMessages) === null || _g === void 0 ? void 0 : _g.customValidation) !== null && _h !== void 0 ? _h : 'Custom validation failed',
+        emoji: 'Emoji characters are not allowed',
+    });
+};
+exports.default = defaultErrorMessages;

package/dist/types/index.d.ts

@@ -0,0 +1,97 @@
+export interface ValidationResult {
+    isValid: boolean;
+    error: string;
+}
+export interface ErrorMessages {
+    required?: string;
+    minLength?: string;
+    maxLength?: string;
+    minValue?: string;
+    maxValue?: string;
+    invalid?: string;
+    regex?: string;
+    empty?: string;
+    minAge?: string;
+    maxAge?: string;
+    minPlus?: string;
+    maxPlus?: string;
+    minMinus?: string;
+    maxMinus?: string;
+    decimalPrecision?: string;
+    maxWholeDigits?: string;
+    noSpace?: string;
+    emoji?: string;
+    customValidation?: string;
+}
+export interface ValidationRules {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    minValue?: number;
+    maxValue?: number;
+    /** Raw regex string — compiled safely at runtime; invalid patterns silently fail validation */
+    regex?: string;
+    /** Date format string, e.g. "DD/MM/YYYY" */
+    format?: string;
+    /** Minimum age in years (for date validators) */
+    minAge?: number;
+    /** Maximum age in years (for date validators) */
+    maxAge?: number;
+    /** Minimum days/months/years the date must be in the future */
+    minPlus?: number;
+    /** Maximum days/months/years the date may be in the future */
+    maxPlus?: number;
+    /** Minimum days/months/years the date must be in the past */
+    minMinus?: number;
+    /** Maximum days/months/years the date may be in the past */
+    maxMinus?: number;
+    /** Time unit for relative date rules */
+    unit?: 'day' | 'days' | 'month' | 'months' | 'year' | 'years';
+    /** Allowed decimal digits after the decimal point */
+    decimalPrecision?: number;
+    /** Maximum digits before the decimal point */
+    maxWholeDigits?: number;
+    /** IP version filter: 'v4' | 'v6' | undefined (both) */
+    version?: string;
+    /** Name sub-type: 'user' | 'corporate' */
+    type?: string;
+    /** Password strength: 'basic' | 'medium' | 'strong' (default: 'basic') */
+    strength?: 'basic' | 'medium' | 'strong';
+    errorMessages?: ErrorMessages;
+    /** Inline custom validator attached to rules — runs after type-based validation */
+    customValidator?: CustomValidatorFn;
+}
+export type CustomValidatorFn = (value: string) => ValidationResult | boolean;
+/** Strongly-typed map returned by defaultErrorMessages — all keys are guaranteed strings */
+export interface DefaultMessages {
+    noSpace: string;
+    minAge: string;
+    maxAge: string;
+    minMinus: string;
+    maxMinus: string;
+    minPlus: string;
+    maxPlus: string;
+    required: string;
+    minLength: string;
+    maxLength: string;
+    minValue: string;
+    maxValue: string;
+    invalid: string;
+    noValidation: string;
+    custom: string;
+    Alphanumeric: string;
+    chassisNumber: string;
+    engineNumber: string;
+    ipAddress: string;
+    name: string;
+    rto: string;
+    ifsc: string;
+    url: string;
+    pincode: string;
+    customValidation: string;
+    emoji: string;
+}
+export type DefaultErrorMessagesFn = (rules: ValidationRules, type: string) => DefaultMessages;
+export type ValidatorFn = (value: string, rules: ValidationRules, defaultMessages: DefaultErrorMessagesFn, type: string) => ValidationResult;
+export type ValidatorType = 'string' | 'alphanumeric' | 'number' | 'float' | 'date' | 'name' | 'firstName' | 'middleName' | 'lastName' | 'email' | 'mobile' | 'address' | 'password' | 'url' | 'pincode' | 'chassis' | 'engine' | 'aadhaar' | 'pan' | 'gst' | 'rto' | 'ifsc' | 'ip' | 'custom' | (string & Record<never, never>);
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/safeRegex.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Safely compiles a regex pattern string into a RegExp.
+ *
+ * Security: Wrapping new RegExp() in try/catch prevents crashes from
+ * malformed user-supplied patterns and avoids potential ReDoS escalation
+ * through invalid back-references or catastrophic alternation.
+ *
+ * If the pattern is invalid, returns a never-matching regex /(?!)/ so that
+ * validation naturally fails with the configured invalid-field error message.
+ *
+ * @param pattern - Raw regex pattern string from rules.regex
+ * @param flags   - Optional regex flags (default: none)
+ * @returns       A compiled RegExp, or /(?!)/ if the pattern is malformed
+ */
+export declare function buildRegex(pattern: string, flags?: string): RegExp;
+/**
+ * Unicode property escape covering all Extended Pictographic code points.
+ * More comprehensive and future-proof than manually listing Unicode ranges.
+ * Requires the 'u' flag.
+ */
+export declare const EMOJI_REGEX: RegExp;
+//# sourceMappingURL=safeRegex.d.ts.map

package/dist/utils/safeRegex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeRegex.d.ts","sourceRoot":"","sources":["../../src/utils/safeRegex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAA+B,CAAC"}

package/dist/utils/safeRegex.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMOJI_REGEX = void 0;
+exports.buildRegex = buildRegex;
+/**
+ * Safely compiles a regex pattern string into a RegExp.
+ *
+ * Security: Wrapping new RegExp() in try/catch prevents crashes from
+ * malformed user-supplied patterns and avoids potential ReDoS escalation
+ * through invalid back-references or catastrophic alternation.
+ *
+ * If the pattern is invalid, returns a never-matching regex /(?!)/ so that
+ * validation naturally fails with the configured invalid-field error message.
+ *
+ * @param pattern - Raw regex pattern string from rules.regex
+ * @param flags   - Optional regex flags (default: none)
+ * @returns       A compiled RegExp, or /(?!)/ if the pattern is malformed
+ */
+function buildRegex(pattern, flags = '') {
+    try {
+        return new RegExp(pattern, flags);
+    }
+    catch {
+        return /(?!)/;
+    }
+}
+/**
+ * Unicode property escape covering all Extended Pictographic code points.
+ * More comprehensive and future-proof than manually listing Unicode ranges.
+ * Requires the 'u' flag.
+ */
+exports.EMOJI_REGEX = /\p{Extended_Pictographic}/u;

package/dist/validators/validateAadhaar.d.ts

@@ -0,0 +1,8 @@
+import type { ValidationResult, ValidationRules, DefaultErrorMessagesFn } from '../types';
+/**
+ * Validates Indian Aadhaar numbers.
+ * Default: 12-digit number starting with 2-9.
+ */
+declare const validateAadhaar: (value: string, rules: ValidationRules, defaultErrorMessages: DefaultErrorMessagesFn, type: string) => ValidationResult;
+export default validateAadhaar;
+//# sourceMappingURL=validateAadhaar.d.ts.map

package/dist/validators/validateAadhaar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAadhaar.d.ts","sourceRoot":"","sources":["../../src/validators/validateAadhaar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE1F;;;GAGG;AACH,QAAA,MAAM,eAAe,GACnB,OAAO,MAAM,EACb,OAAO,eAAe,EACtB,sBAAsB,sBAAsB,EAC5C,MAAM,MAAM,KACX,gBAeF,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/validators/validateAadhaar.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const safeRegex_1 = require("../utils/safeRegex");
+/**
+ * Validates Indian Aadhaar numbers.
+ * Default: 12-digit number starting with 2-9.
+ */
+const validateAadhaar = (value, rules, defaultErrorMessages, type) => {
+    var _a, _b, _c, _d;
+    const defaultRegex = /^[2-9]{1}[0-9]{11}$/;
+    const regexToUse = rules.regex ? (0, safeRegex_1.buildRegex)(rules.regex) : defaultRegex;
+    if (!regexToUse.test(value)) {
+        return {
+            isValid: false,
+            error: (_d = (_b = (_a = rules.errorMessages) === null || _a === void 0 ? void 0 : _a.regex) !== null && _b !== void 0 ? _b : (_c = rules.errorMessages) === null || _c === void 0 ? void 0 : _c.invalid) !== null && _d !== void 0 ? _d : defaultErrorMessages(rules, type).invalid,
+        };
+    }
+    return { isValid: true, error: '' };
+};
+exports.default = validateAadhaar;

package/dist/validators/validateAddress.d.ts

@@ -0,0 +1,8 @@
+import type { ValidationResult, ValidationRules, DefaultErrorMessagesFn } from '../types';
+/**
+ * Validates postal/street addresses.
+ * Allows letters, digits, spaces, and common address punctuation: , . / - # & :
+ */
+declare const validateAddress: (value: string, rules: ValidationRules, defaultErrorMessages: DefaultErrorMessagesFn, type: string) => ValidationResult;
+export default validateAddress;
+//# sourceMappingURL=validateAddress.d.ts.map

package/dist/validators/validateAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAddress.d.ts","sourceRoot":"","sources":["../../src/validators/validateAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE1F;;;GAGG;AACH,QAAA,MAAM,eAAe,GACnB,OAAO,MAAM,EACb,OAAO,eAAe,EACtB,sBAAsB,sBAAsB,EAC5C,MAAM,MAAM,KACX,gBAiCF,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/validators/validateAddress.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const safeRegex_1 = require("../utils/safeRegex");
+/**
+ * Validates postal/street addresses.
+ * Allows letters, digits, spaces, and common address punctuation: , . / - # & :
+ */
+const validateAddress = (value, rules, defaultErrorMessages, type) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (rules.minLength !== undefined && value.length < rules.minLength) {
+        return {
+            isValid: false,
+            error: (_b = (_a = rules.errorMessages) === null || _a === void 0 ? void 0 : _a.minLength) !== null && _b !== void 0 ? _b : defaultErrorMessages(rules, type).minLength,
+        };
+    }
+    if (rules.maxLength !== undefined && value.length > rules.maxLength) {
+        return {
+            isValid: false,
+            error: (_d = (_c = rules.errorMessages) === null || _c === void 0 ? void 0 : _c.maxLength) !== null && _d !== void 0 ? _d : defaultErrorMessages(rules, type).maxLength,
+        };
+    }
+    if (!value.trim()) {
+        return {
+            isValid: false,
+            error: (_f = (_e = rules.errorMessages) === null || _e === void 0 ? void 0 : _e.invalid) !== null && _f !== void 0 ? _f : defaultErrorMessages(rules, type).invalid,
+        };
+    }
+    const defaultRegex = /^[a-zA-Z0-9\s,./\-#&:]+$/;
+    const regexToUse = rules.regex ? (0, safeRegex_1.buildRegex)(rules.regex) : defaultRegex;
+    if (!regexToUse.test(value)) {
+        return {
+            isValid: false,
+            error: (_h = (_g = rules.errorMessages) === null || _g === void 0 ? void 0 : _g.invalid) !== null && _h !== void 0 ? _h : defaultErrorMessages(rules, type).invalid,
+        };
+    }
+    return { isValid: true, error: '' };
+};
+exports.default = validateAddress;

package/dist/validators/validateAlphanumeric.d.ts

@@ -0,0 +1,8 @@
+import type { ValidationResult, ValidationRules, DefaultErrorMessagesFn } from '../types';
+/**
+ * Validates alphanumeric strings (lowercase letters and digits by default).
+ * Accepts minLength, maxLength, and a custom regex override.
+ */
+declare const validateAlphanumeric: (value: string, rules: ValidationRules, defaultErrorMessages: DefaultErrorMessagesFn, type: string) => ValidationResult;
+export default validateAlphanumeric;
+//# sourceMappingURL=validateAlphanumeric.d.ts.map

package/dist/validators/validateAlphanumeric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAlphanumeric.d.ts","sourceRoot":"","sources":["../../src/validators/validateAlphanumeric.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE1F;;;GAGG;AACH,QAAA,MAAM,oBAAoB,GACxB,OAAO,MAAM,EACb,OAAO,eAAe,EACtB,sBAAsB,sBAAsB,EAC5C,MAAM,MAAM,KACX,gBAuCF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/validators/validateAlphanumeric.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const safeRegex_1 = require("../utils/safeRegex");
+/**
+ * Validates alphanumeric strings (lowercase letters and digits by default).
+ * Accepts minLength, maxLength, and a custom regex override.
+ */
+const validateAlphanumeric = (value, rules, defaultErrorMessages, type) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    if (typeof value !== 'string') {
+        return {
+            isValid: false,
+            error: (_c = (_b = (_a = rules.errorMessages) === null || _a === void 0 ? void 0 : _a.invalid) !== null && _b !== void 0 ? _b : defaultErrorMessages(rules, type).Alphanumeric) !== null && _c !== void 0 ? _c : defaultErrorMessages(rules, type).invalid,
+        };
+    }
+    if (rules.minLength !== undefined && value.length < rules.minLength) {
+        return {
+            isValid: false,
+            error: (_e = (_d = rules.errorMessages) === null || _d === void 0 ? void 0 : _d.minLength) !== null && _e !== void 0 ? _e : defaultErrorMessages(rules, type).minLength,
+        };
+    }
+    if (rules.maxLength !== undefined && value.length > rules.maxLength) {
+        return {
+            isValid: false,
+            error: (_g = (_f = rules.errorMessages) === null || _f === void 0 ? void 0 : _f.maxLength) !== null && _g !== void 0 ? _g : defaultErrorMessages(rules, type).maxLength,
+        };
+    }
+    const defaultRegex = /^[a-z0-9]+$/;
+    const regexToUse = rules.regex ? (0, safeRegex_1.buildRegex)(rules.regex) : defaultRegex;
+    if (!regexToUse.test(value)) {
+        return {
+            isValid: false,
+            error: (_k = (_j = (_h = rules.errorMessages) === null || _h === void 0 ? void 0 : _h.invalid) !== null && _j !== void 0 ? _j : defaultErrorMessages(rules, type).Alphanumeric) !== null && _k !== void 0 ? _k : defaultErrorMessages(rules, type).invalid,
+        };
+    }
+    return { isValid: true, error: '' };
+};
+exports.default = validateAlphanumeric;

package/dist/validators/validateBankIFSC.d.ts

@@ -0,0 +1,9 @@
+import type { ValidationResult, ValidationRules, DefaultErrorMessagesFn } from '../types';
+/**
+ * Validates Indian bank IFSC codes.
+ * Format: 4 uppercase letters + '0' + 6 alphanumeric chars (total 11 chars).
+ * Default min/max length is 11.
+ */
+declare const validateBankIFSC: (value: string, rules: ValidationRules | undefined, defaultErrorMessages: DefaultErrorMessagesFn, type: string) => ValidationResult;
+export default validateBankIFSC;
+//# sourceMappingURL=validateBankIFSC.d.ts.map

package/dist/validators/validateBankIFSC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateBankIFSC.d.ts","sourceRoot":"","sources":["../../src/validators/validateBankIFSC.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE1F;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,GACpB,OAAO,MAAM,EACb,OAAO,eAAe,YAAmC,EACzD,sBAAsB,sBAAsB,EAC5C,MAAM,MAAM,KACX,gBA6BF,CAAC;AAEF,eAAe,gBAAgB,CAAC"}