@warlock.js/seal 4.0.48 → 4.0.59

package/cjs/validators/string-validator.js

@@ -0,0 +1,410 @@
+'use strict';require('@mongez/reinforcements'),require('@mongez/supportive-is'),require('dayjs');var stringMutators=require('../mutators/string-mutators.js'),alpha=require('../rules/string/alpha.js'),creditCard=require('../rules/string/credit-card.js'),email=require('../rules/string/email.js'),ip=require('../rules/string/ip.js'),pattern=require('../rules/string/pattern.js'),stringComparison=require('../rules/string/string-comparison.js'),strongPasswordRule=require('../rules/string/strong-password-rule.js'),url=require('../rules/string/url.js'),withoutWhitespace=require('../rules/string/without-whitespace.js'),lengthRules=require('../rules/length/length-rules.js'),colorRules=require('../rules/color/color-rules.js'),typeRules=require('../rules/common/type-rules.js'),baseValidator=require('./base-validator.js'),scalarValidator=require('./scalar-validator.js');/**
+ * String validator class
+ */
+class StringValidator extends baseValidator.BaseValidator {
+    constructor(errorMessage) {
+        super();
+        this.addRule(typeRules.stringRule, errorMessage);
+    }
+    /**
+     * Check if value is a string type
+     */
+    matchesType(value) {
+        return typeof value === "string";
+    }
+    // ==================== Mutators ====================
+    /**
+     * Stringify the value if not a string
+     */
+    toString() {
+        this.addMutator(stringMutators.stringifyMutator);
+        return this;
+    }
+    /** Convert string to uppercase */
+    uppercase() {
+        this.addMutator(stringMutators.uppercaseMutator);
+        return this;
+    }
+    /** Convert string to lowercase */
+    lowercase() {
+        this.addMutator(stringMutators.lowercaseMutator);
+        return this;
+    }
+    /** Capitalize only the first letter of the string */
+    capitalize() {
+        this.addMutator(stringMutators.capitalizeMutator);
+        return this;
+    }
+    /** Capitalize the first letter of each word (Title Case) */
+    titleCase() {
+        this.addMutator(stringMutators.titleCaseMutator);
+        return this;
+    }
+    /** Convert to camelCase */
+    camelCase() {
+        this.addMutator(stringMutators.camelCaseMutator);
+        return this;
+    }
+    /** Convert to PascalCase */
+    pascalCase() {
+        this.addMutator(stringMutators.pascalCaseMutator);
+        return this;
+    }
+    /** Convert to snake_case */
+    snakeCase() {
+        this.addMutator(stringMutators.snakeCaseMutator);
+        return this;
+    }
+    /** Convert to kebab-case */
+    kebabCase() {
+        this.addMutator(stringMutators.kebabCaseMutator);
+        return this;
+    }
+    /**
+     * Trim the given needle from the string
+     * If no needle is provided, the default is a single space
+     */
+    trim(needle) {
+        this.addMutator(stringMutators.trimMutator, { needle });
+        return this;
+    }
+    /** Trim from the left/start */
+    ltrim(needle) {
+        this.addMutator(stringMutators.ltrimMutator, { needle });
+        return this;
+    }
+    /** Trim from the right/end */
+    rtrim(needle) {
+        this.addMutator(stringMutators.rtrimMutator, { needle });
+        return this;
+    }
+    /** Trim multiple whitespace into single space */
+    trimMultipleWhitespace() {
+        this.addMutator(stringMutators.trimMultipleWhitespaceMutator);
+        return this;
+    }
+    /** Pad string from the start to reach target length */
+    padStart(length, char = " ") {
+        this.addMutator(stringMutators.padStartMutator, { length, char });
+        return this;
+    }
+    /** Pad string from the end to reach target length */
+    padEnd(length, char = " ") {
+        this.addMutator(stringMutators.padEndMutator, { length, char });
+        return this;
+    }
+    /** Remove HTML tags (safe HTML) */
+    safeHtml() {
+        this.addMutator(stringMutators.safeHtmlMutator);
+        return this;
+    }
+    /** HTML escape special characters */
+    htmlEscape() {
+        return this.addMutator(stringMutators.htmlEscapeMutator);
+    }
+    /** Unescape HTML entities */
+    unescapeHtml() {
+        this.addMutator(stringMutators.unescapeHtmlMutator);
+        return this;
+    }
+    /**
+     * Remove special characters
+     * This will remove all characters that are not alphanumeric or whitespace
+     */
+    removeSpecialCharacters() {
+        this.addMutator(stringMutators.removeSpecialCharactersMutator);
+        return this;
+    }
+    /** Convert to only alphabetic characters */
+    toAlpha() {
+        this.addMutator(stringMutators.alphaOnlyMutator);
+        return this;
+    }
+    /** Convert to only alphanumeric characters */
+    toAlphanumeric() {
+        this.addMutator(stringMutators.alphanumericOnlyMutator);
+        return this;
+    }
+    /** Remove all numeric characters */
+    removeNumbers() {
+        this.addMutator(stringMutators.removeNumbersMutator);
+        return this;
+    }
+    /** URL decode */
+    urlDecode() {
+        this.addMutator(stringMutators.urlDecodeMutator);
+        return this;
+    }
+    /** URL encode */
+    urlEncode() {
+        this.addMutator(stringMutators.urlEncodeMutator);
+        return this;
+    }
+    /** Convert to URL-friendly slug */
+    slug() {
+        this.addMutator(stringMutators.slugMutator);
+        return this;
+    }
+    /** Base64 encode */
+    base64Encode() {
+        this.addMutator(stringMutators.base64EncodeMutator);
+        return this;
+    }
+    /** Base64 decode */
+    base64Decode() {
+        this.addMutator(stringMutators.base64DecodeMutator);
+        return this;
+    }
+    /** Replace substring or pattern */
+    replace(search, replace) {
+        this.addMutator(stringMutators.replaceMutator, { search, replace });
+        return this;
+    }
+    /** Replace all occurrences of substring or pattern */
+    replaceAll(search, replace) {
+        this.addMutator(stringMutators.replaceAllMutator, { search, replace });
+        return this;
+    }
+    /** Append/suffix text to the end */
+    append(suffix) {
+        this.addMutator(stringMutators.appendMutator, { suffix });
+        return this;
+    }
+    /** Prepend/prefix text to the beginning */
+    prepend(prefix) {
+        this.addMutator(stringMutators.prependMutator, { prefix });
+        return this;
+    }
+    /** Reverse the string */
+    reverse() {
+        this.addMutator(stringMutators.reverseMutator);
+        return this;
+    }
+    /** Truncate to a maximum length */
+    truncate(maxLength, suffix = "...") {
+        this.addMutator(stringMutators.truncateMutator, { maxLength, suffix });
+        return this;
+    }
+    /** Repeat string N times */
+    repeat(count) {
+        this.addMutator(stringMutators.repeatMutator, { count });
+        return this;
+    }
+    /** Mask part of string */
+    mask(start, end, char = "*") {
+        this.addMutator(stringMutators.maskMutator, { start, end, char });
+        return this;
+    }
+    // ==================== Validation Rules ====================
+    /** Value must be a valid email */
+    email(errorMessage) {
+        this.addRule(email.emailRule, errorMessage);
+        return this;
+    }
+    /** Value must be a valid URL */
+    url(errorMessage) {
+        this.addRule(url.urlRule, errorMessage);
+        return this;
+    }
+    /** Value can not have whitespace */
+    withoutWhitespace(errorMessage) {
+        this.addRule(withoutWhitespace.withoutWhitespaceRule, errorMessage);
+        return this;
+    }
+    /** Value must match the given pattern */
+    pattern(pattern$1, errorMessage) {
+        const rule = this.addRule(pattern.patternRule, errorMessage);
+        rule.context.options.pattern = pattern$1;
+        return this;
+    }
+    /**
+     * Value must be a strong password
+     * Requirements:
+     * - At least 8 characters
+     * - At least 1 uppercase letter
+     * - At least 1 lowercase letter
+     * - At least 1 number
+     * - At least 1 special character
+     */
+    strongPassword(minLength, errorMessage) {
+        const rule = this.addRule(strongPasswordRule.strongPasswordRule, errorMessage);
+        rule.context.options.minLength = minLength;
+        return this;
+    }
+    /** Value must be exactly the given number of words */
+    words(words, errorMessage) {
+        const rule = this.addRule(lengthRules.wordsRule, errorMessage);
+        rule.context.options.words = words;
+        return this;
+    }
+    /** Value must be at least the given number of words */
+    minWords(words, errorMessage) {
+        const rule = this.addRule(lengthRules.minWordsRule, errorMessage);
+        rule.context.options.minWords = words;
+        return this;
+    }
+    /** Value must be at most the given number of words */
+    maxWords(words, errorMessage) {
+        const rule = this.addRule(lengthRules.maxWordsRule, errorMessage);
+        rule.context.options.maxWords = words;
+        return this;
+    }
+    /** Value length must be greater than the given length */
+    minLength(length, errorMessage) {
+        const rule = this.addRule(lengthRules.minLengthRule, errorMessage);
+        rule.context.options.minLength = length;
+        return this;
+    }
+    /** @alias minLength */
+    min(min, errorMessage) {
+        return this.minLength(min, errorMessage);
+    }
+    /** Value length must be less than the given length */
+    maxLength(length, errorMessage) {
+        const rule = this.addRule(lengthRules.maxLengthRule, errorMessage);
+        rule.context.options.maxLength = length;
+        return this;
+    }
+    /** @alias maxLength */
+    max(max, errorMessage) {
+        return this.maxLength(max, errorMessage);
+    }
+    /** Value must be of the given length */
+    length(length, errorMessage) {
+        const rule = this.addRule(lengthRules.lengthRule, errorMessage);
+        rule.context.options.length = length;
+        return this;
+    }
+    /**
+     * String length must be between min and max (inclusive)
+     *
+     * @param min - Minimum length (inclusive)
+     * @param max - Maximum length (inclusive)
+     *
+     * @example
+     * ```ts
+     * v.string().between(5, 10)  // Length: 5 to 10 characters
+     * v.string().lengthBetween(8, 20)  // Same using alias
+     * ```
+     *
+     * @category Validation Rule
+     */
+    between(min, max, errorMessage) {
+        const rule = this.addRule(lengthRules.betweenLengthRule, errorMessage);
+        rule.context.options.minLength = min;
+        rule.context.options.maxLength = max;
+        return this;
+    }
+    /**
+     * Alias for between() - string length between min and max
+     */
+    lengthBetween(min, max, errorMessage) {
+        return this.between(min, max, errorMessage);
+    }
+    /** Allow only alphabetic characters */
+    alpha(errorMessage) {
+        this.addRule(alpha.alphaRule, errorMessage);
+        return this;
+    }
+    /** Allow only alphanumeric characters */
+    alphanumeric(errorMessage) {
+        this.addRule(alpha.alphaNumericRule, errorMessage);
+        return this;
+    }
+    /** Allow only numeric characters */
+    numeric(errorMessage) {
+        this.addRule(alpha.isNumericRule, errorMessage);
+        return this;
+    }
+    /** Value must starts with the given string */
+    startsWith(value, errorMessage) {
+        const rule = this.addRule(stringComparison.startsWithRule, errorMessage);
+        rule.context.options.value = value;
+        return this;
+    }
+    /** Value must ends with the given string */
+    endsWith(value, errorMessage) {
+        const rule = this.addRule(stringComparison.endsWithRule, errorMessage);
+        rule.context.options.value = value;
+        return this;
+    }
+    /** Value must contain the given string */
+    contains(value, errorMessage) {
+        const rule = this.addRule(stringComparison.containsRule, errorMessage);
+        rule.context.options.value = value;
+        return this;
+    }
+    /** Value must not contain the given string */
+    notContains(value, errorMessage) {
+        const rule = this.addRule(stringComparison.notContainsRule, errorMessage);
+        rule.context.options.value = value;
+        return this;
+    }
+    /** Value must be a valid IP address */
+    ip(errorMessage) {
+        this.addRule(ip.ipRule, errorMessage);
+        return this;
+    }
+    /** Value must be a valid IPv4 address */
+    ip4(errorMessage) {
+        this.addRule(ip.ip4Rule, errorMessage);
+        return this;
+    }
+    /** Value must be a valid IPv6 address */
+    ip6(errorMessage) {
+        this.addRule(ip.ip6Rule, errorMessage);
+        return this;
+    }
+    /** Check if the string matches a credit card number */
+    creditCard(errorMessage) {
+        this.addRule(creditCard.isCreditCardRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid color */
+    color(errorMessage) {
+        this.addRule(colorRules.colorRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid hex color */
+    hexColor(errorMessage) {
+        this.addRule(colorRules.hexColorRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid HSL color */
+    hslColor(errorMessage) {
+        this.addRule(colorRules.hslColorRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid RGB color */
+    rgbColor(errorMessage) {
+        this.addRule(colorRules.rgbColorRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid RGBA color */
+    rgbaColor(errorMessage) {
+        this.addRule(colorRules.rgbaColorRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid light color */
+    lightColor(errorMessage) {
+        this.addRule(colorRules.lightColorRule, errorMessage);
+        return this;
+    }
+    /** Determine if the value is a valid dark color */
+    darkColor(errorMessage) {
+        this.addRule(colorRules.darkColorRule, errorMessage);
+        return this;
+    }
+    // Enum and value checking methods from ScalarValidator
+    enum = scalarValidator.ScalarValidator.prototype.enum;
+    /** Value must be in one of the given values */
+    in = scalarValidator.ScalarValidator.prototype.in;
+    /** @alias in */
+    oneOf = scalarValidator.ScalarValidator.prototype.in;
+    /** @alias oneOf */
+    allowsOnly = scalarValidator.ScalarValidator.prototype.allowsOnly;
+    /** Forbid the value from being one of the given values */
+    forbids = scalarValidator.ScalarValidator.prototype.forbids;
+    /** @alias forbids */
+    notIn = scalarValidator.ScalarValidator.prototype.forbids;
+}exports.StringValidator=StringValidator;//# sourceMappingURL=string-validator.js.map

package/cjs/validators/string-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-validator.js","sources":["../../src/validators/string-validator.ts"],"sourcesContent":[null],"names":["BaseValidator","stringRule","stringifyMutator","uppercaseMutator","lowercaseMutator","capitalizeMutator","titleCaseMutator","camelCaseMutator","pascalCaseMutator","snakeCaseMutator","kebabCaseMutator","trimMutator","ltrimMutator","rtrimMutator","trimMultipleWhitespaceMutator","padStartMutator","padEndMutator","safeHtmlMutator","htmlEscapeMutator","unescapeHtmlMutator","removeSpecialCharactersMutator","alphaOnlyMutator","alphanumericOnlyMutator","removeNumbersMutator","urlDecodeMutator","urlEncodeMutator","slugMutator","base64EncodeMutator","base64DecodeMutator","replaceMutator","replaceAllMutator","appendMutator","prependMutator","reverseMutator","truncateMutator","repeatMutator","maskMutator","emailRule","urlRule","withoutWhitespaceRule","pattern","patternRule","strongPasswordRule","wordsRule","minWordsRule","maxWordsRule","minLengthRule","maxLengthRule","lengthRule","betweenLengthRule","alphaRule","alphaNumericRule","isNumericRule","startsWithRule","endsWithRule","containsRule","notContainsRule","ipRule","ip4Rule","ip6Rule","isCreditCardRule","colorRule","hexColorRule","hslColorRule","rgbColorRule","rgbaColorRule","lightColorRule","darkColorRule","ScalarValidator"],"mappings":"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"}

package/cjs/validators/tuple-validator.d.ts

@@ -0,0 +1,34 @@
+import type { SchemaContext, ValidationResult } from "../types";
+import { BaseValidator } from "./base-validator";
+/**
+ * Tuple validator class - validates fixed-length arrays with position-specific types
+ *
+ * @example
+ * ```ts
+ * // RGB color tuple
+ * v.tuple([v.number(), v.number(), v.number()])
+ * // Valid: [255, 128, 0]
+ * // Invalid: [255, 128] (too short)
+ *
+ * // Mixed types
+ * v.tuple([v.string(), v.int(), v.boolean()])
+ * // Valid: ["John", 25, true]
+ * ```
+ */
+export declare class TupleValidator extends BaseValidator {
+    validators: BaseValidator[];
+    constructor(validators: BaseValidator[], errorMessage?: string);
+    /**
+     * Check if value is an array type
+     */
+    matchesType(value: any): boolean;
+    /**
+     * Clone the validator
+     */
+    clone(): this;
+    /**
+     * Validate tuple - check length then validate each position
+     */
+    validate(data: any, context: SchemaContext): Promise<ValidationResult>;
+}
+//# sourceMappingURL=tuple-validator.d.ts.map

package/cjs/validators/tuple-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple-validator.d.ts","sourceRoot":"","sources":["../../src/validators/tuple-validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAEtC,UAAU,EAAE,aAAa,EAAE;gBAA3B,UAAU,EAAE,aAAa,EAAE,EAClC,YAAY,CAAC,EAAE,MAAM;IAMvB;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIvC;;OAEG;IACa,KAAK,IAAI,IAAI;IAM7B;;OAEG;IACU,QAAQ,CACnB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,gBAAgB,CAAC;CAkD7B"}

package/cjs/validators/tuple-validator.js

@@ -0,0 +1,79 @@
+'use strict';require('@mongez/reinforcements');var pathHelpers=require('../helpers/path-helpers.js');require('@mongez/supportive-is'),require('net');var typeRules=require('../rules/common/type-rules.js'),baseValidator=require('./base-validator.js');/**
+ * Tuple validator class - validates fixed-length arrays with position-specific types
+ *
+ * @example
+ * ```ts
+ * // RGB color tuple
+ * v.tuple([v.number(), v.number(), v.number()])
+ * // Valid: [255, 128, 0]
+ * // Invalid: [255, 128] (too short)
+ *
+ * // Mixed types
+ * v.tuple([v.string(), v.int(), v.boolean()])
+ * // Valid: ["John", 25, true]
+ * ```
+ */
+class TupleValidator extends baseValidator.BaseValidator {
+    validators;
+    constructor(validators, errorMessage) {
+        super();
+        this.validators = validators;
+        this.addRule(typeRules.arrayRule, errorMessage);
+    }
+    /**
+     * Check if value is an array type
+     */
+    matchesType(value) {
+        return Array.isArray(value);
+    }
+    /**
+     * Clone the validator
+     */
+    clone() {
+        const cloned = super.clone();
+        cloned.validators = this.validators.map(v => v.clone());
+        return cloned;
+    }
+    /**
+     * Validate tuple - check length then validate each position
+     */
+    async validate(data, context) {
+        const mutatedData = (await this.mutate(data, context)) || [];
+        const result = await super.validate(data, context);
+        if (result.isValid === false)
+            return result;
+        const errors = [];
+        // Tuple-specific: length validation
+        if (mutatedData.length !== this.validators.length) {
+            errors.push({
+                type: "tuple",
+                input: context.key || "value",
+                error: `Expected exactly ${this.validators.length} items, but got ${mutatedData.length}`,
+            });
+            return { isValid: false, errors, data: mutatedData };
+        }
+        // Validate each position with its specific validator in parallel
+        const validationPromises = this.validators.map(async (validator, index) => {
+            const childContext = {
+                ...context,
+                parent: mutatedData,
+                value: mutatedData[index],
+                key: index.toString(),
+                path: pathHelpers.setKeyPath(context.path, index.toString()),
+            };
+            const childResult = await validator.validate(mutatedData[index], childContext);
+            // Update mutated data with validated result
+            mutatedData[index] = childResult.data;
+            // Collect errors from this element
+            if (childResult.isValid === false) {
+                errors.push(...childResult.errors);
+            }
+        });
+        await Promise.all(validationPromises);
+        return {
+            isValid: errors.length === 0,
+            errors,
+            data: await this.startTransformationPipeline(mutatedData, context),
+        };
+    }
+}exports.TupleValidator=TupleValidator;//# sourceMappingURL=tuple-validator.js.map

package/cjs/validators/tuple-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple-validator.js","sources":["../../src/validators/tuple-validator.ts"],"sourcesContent":[null],"names":["BaseValidator","arrayRule","setKeyPath"],"mappings":"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"}

package/cjs/validators/union-validator.d.ts

@@ -0,0 +1,42 @@
+import { BaseValidator } from "./base-validator";
+/**
+ * Union validator class - validates value against multiple validator types
+ *
+ * Tries each validator in order until one passes. If a validator's matchesType()
+ * returns false, it's skipped for optimization. First validator that both matches
+ * the type and passes validation wins.
+ *
+ * @example
+ * ```ts
+ * // Accept email or username
+ * const identifier = v.union([
+ *   v.string().email(),
+ *   v.string().alphanumeric().min(3).max(20)
+ * ]);
+ *
+ * // Accept different types
+ * const customValue = v.union([
+ *   v.string().required(),
+ *   v.number().required(),
+ *   v.boolean().required(),
+ *   v.file().required()
+ * ]);
+ * ```
+ */
+export declare class UnionValidator extends BaseValidator {
+    /**
+     * Set the validators to try for union validation
+     *
+     * @param validators - Array of validators to try
+     * @param errorMessage - Optional custom error message if all validators fail
+     * @returns This validator for chaining
+     *
+     * @example
+     * ```ts
+     * new UnionValidator()
+     *   .union([v.string(), v.number()], 'Must be string or number');
+     * ```
+     */
+    union(validators: BaseValidator[], errorMessage?: string): this;
+}
+//# sourceMappingURL=union-validator.d.ts.map

package/cjs/validators/union-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union-validator.d.ts","sourceRoot":"","sources":["../../src/validators/union-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;CAKhE"}

package/cjs/validators/union-validator.js

@@ -0,0 +1,44 @@
+'use strict';require('@mongez/reinforcements'),require('@mongez/supportive-is');var union=require('../rules/core/union.js');require('net');var baseValidator=require('./base-validator.js');/**
+ * Union validator class - validates value against multiple validator types
+ *
+ * Tries each validator in order until one passes. If a validator's matchesType()
+ * returns false, it's skipped for optimization. First validator that both matches
+ * the type and passes validation wins.
+ *
+ * @example
+ * ```ts
+ * // Accept email or username
+ * const identifier = v.union([
+ *   v.string().email(),
+ *   v.string().alphanumeric().min(3).max(20)
+ * ]);
+ *
+ * // Accept different types
+ * const customValue = v.union([
+ *   v.string().required(),
+ *   v.number().required(),
+ *   v.boolean().required(),
+ *   v.file().required()
+ * ]);
+ * ```
+ */
+class UnionValidator extends baseValidator.BaseValidator {
+    /**
+     * Set the validators to try for union validation
+     *
+     * @param validators - Array of validators to try
+     * @param errorMessage - Optional custom error message if all validators fail
+     * @returns This validator for chaining
+     *
+     * @example
+     * ```ts
+     * new UnionValidator()
+     *   .union([v.string(), v.number()], 'Must be string or number');
+     * ```
+     */
+    union(validators, errorMessage) {
+        const rule = this.addRule(union.unionRule, errorMessage);
+        rule.context.options.validators = validators;
+        return this;
+    }
+}exports.UnionValidator=UnionValidator;//# sourceMappingURL=union-validator.js.map

package/cjs/validators/union-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"union-validator.js","sources":["../../src/validators/union-validator.ts"],"sourcesContent":[null],"names":["BaseValidator","unionRule"],"mappings":"4LAGA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,MAAO,cAAe,SAAQA,2BAAa,CAAA;AAC/C;;;;;;;;;;;;AAYG;IACI,KAAK,CAAC,UAA2B,EAAE,YAAqB,EAAA;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAACC,eAAS,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;AAC7C,QAAA,OAAO,IAAI,CAAC;KACb;AACF"}