@warlock.js/seal 4.0.48 → 4.0.59

package/esm/validators/record-validator.js

@@ -0,0 +1,70 @@
+import {isPlainObject}from'@mongez/supportive-is';import'@mongez/reinforcements';import {setKeyPath}from'../helpers/path-helpers.js';import'net';import {objectRule}from'../rules/common/type-rules.js';import {BaseValidator}from'./base-validator.js';/**
+ * Record validator class - validates objects with dynamic keys and consistent value types
+ *
+ * @example
+ * ```ts
+ * // Translations object
+ * v.record(v.string())
+ * // Valid: { en: "Hello", ar: "مرحبا", fr: "Bonjour" }
+ *
+ * // User preferences
+ * v.record(v.union([v.string(), v.number(), v.boolean()]))
+ * // Valid: { theme: "dark", fontSize: 16, notifications: true }
+ * ```
+ */
+class RecordValidator extends BaseValidator {
+    valueValidator;
+    constructor(valueValidator, errorMessage) {
+        super();
+        this.valueValidator = valueValidator;
+        this.addRule(objectRule, errorMessage);
+    }
+    /**
+     * Check if value is a plain object type
+     */
+    matchesType(value) {
+        return isPlainObject(value);
+    }
+    /**
+     * Clone the validator
+     */
+    clone() {
+        const cloned = super.clone();
+        cloned.valueValidator = this.valueValidator.clone();
+        return cloned;
+    }
+    /**
+     * Validate record - iterate all keys and validate each value
+     */
+    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 = [];
+        const keys = Object.keys(mutatedData);
+        // Validate all values in parallel
+        const validationPromises = keys.map(async (key) => {
+            const childContext = {
+                ...context,
+                parent: mutatedData,
+                value: mutatedData[key],
+                key,
+                path: setKeyPath(context.path, key),
+            };
+            const childResult = await this.valueValidator.validate(mutatedData[key], childContext);
+            // Update mutated data with validated result
+            mutatedData[key] = childResult.data;
+            // Collect errors from this value
+            if (childResult.isValid === false) {
+                errors.push(...childResult.errors);
+            }
+        });
+        await Promise.all(validationPromises);
+        return {
+            isValid: errors.length === 0,
+            errors,
+            data: await this.startTransformationPipeline(mutatedData, context),
+        };
+    }
+}export{RecordValidator};//# sourceMappingURL=record-validator.js.map

package/esm/validators/record-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-validator.js","sources":["../../src/validators/record-validator.ts"],"sourcesContent":[null],"names":[],"mappings":"wPAMA;;;;;;;;;;;;;AAaG;AACG,MAAO,eAAgB,SAAQ,aAAa,CAAA;AAEvC,IAAA,cAAA,CAAA;IADT,WACS,CAAA,cAA6B,EACpC,YAAqB,EAAA;AAErB,QAAA,KAAK,EAAE,CAAC;QAHD,IAAc,CAAA,cAAA,GAAd,cAAc,CAAe;AAIpC,QAAA,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;KACxC;AAED;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;AAC3B,QAAA,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;KAC7B;AAED;;AAEG;IACa,KAAK,GAAA;AACnB,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;AACpD,QAAA,OAAO,MAAM,CAAC;KACf;AAED;;AAEG;AACI,IAAA,MAAM,QAAQ,CACnB,IAAS,EACT,OAAsB,EAAA;AAEtB,QAAA,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAEnD,QAAA,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,OAAO,MAAM,CAAC;QAE5C,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;;QAGtC,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAM,GAAG,KAAG;AAC9C,YAAA,MAAM,YAAY,GAAkB;AAClC,gBAAA,GAAG,OAAO;AACV,gBAAA,MAAM,EAAE,WAAW;AACnB,gBAAA,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;gBACvB,GAAG;gBACH,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;aACpC,CAAC;AAEF,YAAA,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CACpD,WAAW,CAAC,GAAG,CAAC,EAChB,YAAY,CACb,CAAC;;AAGF,YAAA,WAAW,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;;AAGpC,YAAA,IAAI,WAAW,CAAC,OAAO,KAAK,KAAK,EAAE;gBACjC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,aAAA;AACH,SAAC,CAAC,CAAC;AAEH,QAAA,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAEtC,OAAO;AACL,YAAA,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,IAAI,EAAE,MAAM,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,OAAO,CAAC;SACnE,CAAC;KACH;AACF"}

package/esm/validators/scalar-validator.d.ts

@@ -0,0 +1,82 @@
+import { BaseValidator } from "./base-validator";
+/**
+ * Scalar validator class
+ *
+ * Core validator for scalar values (string, number, boolean)
+ *
+ * Database methods (unique, exists, etc.) are injected by the framework
+ */
+export declare class ScalarValidator extends BaseValidator {
+    constructor(errorMessage?: string);
+    /**
+     * Add matches type
+     */
+    matchesType(value: any): boolean;
+    /**
+     * Mutate the scalar value to be number
+     */
+    asNumber(): this;
+    /**
+     * Accepted value
+     * The value will be valid if it equals 1 | "1" | true | "true" | "yes" | "y" | "on"
+     */
+    accepted(errorMessage?: string): this;
+    /**
+     * Accepted value if another field's value equals to a specific value
+     */
+    acceptedIf(field: string, value: any, errorMessage?: string): this;
+    /**
+     * Accepted value if another field's value is not equal to the given value
+     */
+    acceptedUnless(field: string, value: any, errorMessage?: string): this;
+    /**
+     * Accepted value if another field is required
+     */
+    acceptedIfRequired(field: string, errorMessage?: string): this;
+    /**
+     * Accepted value if another field is present
+     */
+    acceptedIfPresent(field: string, errorMessage?: string): this;
+    /**
+     * Accepted value if another field is missing
+     */
+    acceptedWithout(field: string, errorMessage?: string): this;
+    /**
+     * Declined value
+     * The value will be valid if it equals 0 | "0" | false | "false" | "no" | "n" | "off"
+     */
+    declined(errorMessage?: string): this;
+    /**
+     * Declined value if another field's value equals to a specific value
+     */
+    declinedIf(field: string, value: any, errorMessage?: string): this;
+    /**
+     * Declined value if another field's value is not equal to the given value
+     */
+    declinedUnless(field: string, value: any, errorMessage?: string): this;
+    /**
+     * Declined value if another field is required
+     */
+    declinedIfRequired(field: string, errorMessage?: string): this;
+    /**
+     * Declined value if another field is present
+     */
+    declinedIfPresent(field: string, errorMessage?: string): this;
+    /**
+     * Declined value if another field is missing
+     */
+    declinedWithout(field: string, errorMessage?: string): this;
+    /** Value must be one of the given values */
+    enum(values: any, errorMessage?: string): this;
+    /** Value must be one of the given values */
+    in(values: any[], errorMessage?: string): this;
+    /** @alias in */
+    oneOf(values: any[], errorMessage?: string): this;
+    /** Add rule to check if the value is one of the allowed values */
+    allowsOnly(values: any[], errorMessage?: string): this;
+    /** Forbid the value from being one of the given values */
+    forbids(values: any[], errorMessage?: string): this;
+    /** @alias forbids */
+    notIn(values: any[], errorMessage?: string): this;
+}
+//# sourceMappingURL=scalar-validator.d.ts.map

package/esm/validators/scalar-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-validator.d.ts","sourceRoot":"","sources":["../../src/validators/scalar-validator.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAC7B,YAAY,CAAC,EAAE,MAAM;IAKxC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG;IAQ7B;;OAEG;IACI,QAAQ;IAMf;;;OAGG;IACI,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAKrC;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;IAOlE;;OAEG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;IAOtE;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM9D;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM7D;;OAEG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM3D;;;OAGG;IACI,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAKrC;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;IAOlE;;OAEG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;IAOtE;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM9D;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM7D;;OAEG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM3D,4CAA4C;IACrC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;IAM9C,4CAA4C;IACrC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAM9C,gBAAgB;IACT,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAIjD,kEAAkE;IAC3D,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAMtD,0DAA0D;IACnD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAMnD,qBAAqB;IACd,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;CAGlD"}

package/esm/validators/scalar-validator.js

@@ -0,0 +1,160 @@
+import'@mongez/reinforcements';import'@mongez/supportive-is';import'dayjs';import {numberMutator}from'../mutators/number-mutators.js';import'net';import {enumRule,inRule,allowedValuesRule,notAllowedValuesRule}from'../rules/common/enum.js';import {scalarRule}from'../rules/common/type-rules.js';import {acceptedRule,acceptedIfRule,acceptedUnlessRule,acceptedIfRequiredRule,acceptedIfPresentRule,acceptedWithoutRule}from'../rules/scalar/accepted-rule.js';import {declinedRule,declinedIfRule,declinedUnlessRule,declinedIfRequiredRule,declinedIfPresentRule,declinedWithoutRule}from'../rules/scalar/declined-rule.js';import {BaseValidator}from'./base-validator.js';/**
+ * Scalar validator class
+ *
+ * Core validator for scalar values (string, number, boolean)
+ *
+ * Database methods (unique, exists, etc.) are injected by the framework
+ */
+class ScalarValidator extends BaseValidator {
+    constructor(errorMessage) {
+        super();
+        this.addRule(scalarRule, errorMessage);
+    }
+    /**
+     * Add matches type
+     */
+    matchesType(value) {
+        return (typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean");
+    }
+    /**
+     * Mutate the scalar value to be number
+     */
+    asNumber() {
+        this.addMutator(numberMutator);
+        return this;
+    }
+    /**
+     * Accepted value
+     * The value will be valid if it equals 1 | "1" | true | "true" | "yes" | "y" | "on"
+     */
+    accepted(errorMessage) {
+        this.addRule(acceptedRule, errorMessage);
+        return this;
+    }
+    /**
+     * Accepted value if another field's value equals to a specific value
+     */
+    acceptedIf(field, value, errorMessage) {
+        const rule = this.addRule(acceptedIfRule, errorMessage);
+        rule.context.options.field = field;
+        rule.context.options.value = value;
+        return this;
+    }
+    /**
+     * Accepted value if another field's value is not equal to the given value
+     */
+    acceptedUnless(field, value, errorMessage) {
+        const rule = this.addRule(acceptedUnlessRule, errorMessage);
+        rule.context.options.field = field;
+        rule.context.options.value = value;
+        return this;
+    }
+    /**
+     * Accepted value if another field is required
+     */
+    acceptedIfRequired(field, errorMessage) {
+        const rule = this.addRule(acceptedIfRequiredRule, errorMessage);
+        rule.context.options.field = field;
+        return this;
+    }
+    /**
+     * Accepted value if another field is present
+     */
+    acceptedIfPresent(field, errorMessage) {
+        const rule = this.addRule(acceptedIfPresentRule, errorMessage);
+        rule.context.options.field = field;
+        return this;
+    }
+    /**
+     * Accepted value if another field is missing
+     */
+    acceptedWithout(field, errorMessage) {
+        const rule = this.addRule(acceptedWithoutRule, errorMessage);
+        rule.context.options.field = field;
+        return this;
+    }
+    /**
+     * Declined value
+     * The value will be valid if it equals 0 | "0" | false | "false" | "no" | "n" | "off"
+     */
+    declined(errorMessage) {
+        this.addRule(declinedRule, errorMessage);
+        return this;
+    }
+    /**
+     * Declined value if another field's value equals to a specific value
+     */
+    declinedIf(field, value, errorMessage) {
+        const rule = this.addRule(declinedIfRule, errorMessage);
+        rule.context.options.field = field;
+        rule.context.options.value = value;
+        return this;
+    }
+    /**
+     * Declined value if another field's value is not equal to the given value
+     */
+    declinedUnless(field, value, errorMessage) {
+        const rule = this.addRule(declinedUnlessRule, errorMessage);
+        rule.context.options.field = field;
+        rule.context.options.value = value;
+        return this;
+    }
+    /**
+     * Declined value if another field is required
+     */
+    declinedIfRequired(field, errorMessage) {
+        const rule = this.addRule(declinedIfRequiredRule, errorMessage);
+        rule.context.options.field = field;
+        return this;
+    }
+    /**
+     * Declined value if another field is present
+     */
+    declinedIfPresent(field, errorMessage) {
+        const rule = this.addRule(declinedIfPresentRule, errorMessage);
+        rule.context.options.field = field;
+        return this;
+    }
+    /**
+     * Declined value if another field is missing
+     */
+    declinedWithout(field, errorMessage) {
+        const rule = this.addRule(declinedWithoutRule, errorMessage);
+        rule.context.options.field = field;
+        return this;
+    }
+    /** Value must be one of the given values */
+    enum(values, errorMessage) {
+        const rule = this.addRule(enumRule, errorMessage);
+        rule.context.options.enum = Object.values(values);
+        return this;
+    }
+    /** Value must be one of the given values */
+    in(values, errorMessage) {
+        const rule = this.addRule(inRule, errorMessage);
+        rule.context.options.values = values;
+        return this;
+    }
+    /** @alias in */
+    oneOf(values, errorMessage) {
+        return this.in(values, errorMessage);
+    }
+    /** Add rule to check if the value is one of the allowed values */
+    allowsOnly(values, errorMessage) {
+        const rule = this.addRule(allowedValuesRule, errorMessage);
+        rule.context.options.allowedValues = values;
+        return this;
+    }
+    /** Forbid the value from being one of the given values */
+    forbids(values, errorMessage) {
+        const rule = this.addRule(notAllowedValuesRule, errorMessage);
+        rule.context.options.notAllowedValues = values;
+        return this;
+    }
+    /** @alias forbids */
+    notIn(values, errorMessage) {
+        return this.forbids(values, errorMessage);
+    }
+}export{ScalarValidator};//# sourceMappingURL=scalar-validator.js.map

package/esm/validators/scalar-validator.js.map

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

package/esm/validators/string-validator.d.ts

@@ -0,0 +1,191 @@
+import { BaseValidator } from "./base-validator";
+import { ScalarValidator } from "./scalar-validator";
+/**
+ * String validator class
+ */
+export declare class StringValidator extends BaseValidator {
+    constructor(errorMessage?: string);
+    /**
+     * Check if value is a string type
+     */
+    matchesType(value: any): boolean;
+    /**
+     * Stringify the value if not a string
+     */
+    toString(): this;
+    /** Convert string to uppercase */
+    uppercase(): this;
+    /** Convert string to lowercase */
+    lowercase(): this;
+    /** Capitalize only the first letter of the string */
+    capitalize(): this;
+    /** Capitalize the first letter of each word (Title Case) */
+    titleCase(): this;
+    /** Convert to camelCase */
+    camelCase(): this;
+    /** Convert to PascalCase */
+    pascalCase(): this;
+    /** Convert to snake_case */
+    snakeCase(): this;
+    /** Convert to kebab-case */
+    kebabCase(): this;
+    /**
+     * Trim the given needle from the string
+     * If no needle is provided, the default is a single space
+     */
+    trim(needle?: string): this;
+    /** Trim from the left/start */
+    ltrim(needle?: string): this;
+    /** Trim from the right/end */
+    rtrim(needle?: string): this;
+    /** Trim multiple whitespace into single space */
+    trimMultipleWhitespace(): this;
+    /** Pad string from the start to reach target length */
+    padStart(length: number, char?: string): this;
+    /** Pad string from the end to reach target length */
+    padEnd(length: number, char?: string): this;
+    /** Remove HTML tags (safe HTML) */
+    safeHtml(): this;
+    /** HTML escape special characters */
+    htmlEscape(): this;
+    /** Unescape HTML entities */
+    unescapeHtml(): this;
+    /**
+     * Remove special characters
+     * This will remove all characters that are not alphanumeric or whitespace
+     */
+    removeSpecialCharacters(): this;
+    /** Convert to only alphabetic characters */
+    toAlpha(): this;
+    /** Convert to only alphanumeric characters */
+    toAlphanumeric(): this;
+    /** Remove all numeric characters */
+    removeNumbers(): this;
+    /** URL decode */
+    urlDecode(): this;
+    /** URL encode */
+    urlEncode(): this;
+    /** Convert to URL-friendly slug */
+    slug(): this;
+    /** Base64 encode */
+    base64Encode(): this;
+    /** Base64 decode */
+    base64Decode(): this;
+    /** Replace substring or pattern */
+    replace(search: string | RegExp, replace: string): this;
+    /** Replace all occurrences of substring or pattern */
+    replaceAll(search: string | RegExp, replace: string): this;
+    /** Append/suffix text to the end */
+    append(suffix: string): this;
+    /** Prepend/prefix text to the beginning */
+    prepend(prefix: string): this;
+    /** Reverse the string */
+    reverse(): this;
+    /** Truncate to a maximum length */
+    truncate(maxLength: number, suffix?: string): this;
+    /** Repeat string N times */
+    repeat(count: number): this;
+    /** Mask part of string */
+    mask(start: number, end?: number, char?: string): this;
+    /** Value must be a valid email */
+    email(errorMessage?: string): this;
+    /** Value must be a valid URL */
+    url(errorMessage?: string): this;
+    /** Value can not have whitespace */
+    withoutWhitespace(errorMessage?: string): this;
+    /** Value must match the given pattern */
+    pattern(pattern: RegExp, errorMessage?: string): 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?: number, errorMessage?: string): this;
+    /** Value must be exactly the given number of words */
+    words(words: number, errorMessage?: string): this;
+    /** Value must be at least the given number of words */
+    minWords(words: number, errorMessage?: string): this;
+    /** Value must be at most the given number of words */
+    maxWords(words: number, errorMessage?: string): this;
+    /** Value length must be greater than the given length */
+    minLength(length: number, errorMessage?: string): this;
+    /** @alias minLength */
+    min(min: number, errorMessage?: string): this;
+    /** Value length must be less than the given length */
+    maxLength(length: number, errorMessage?: string): this;
+    /** @alias maxLength */
+    max(max: number, errorMessage?: string): this;
+    /** Value must be of the given length */
+    length(length: number, errorMessage?: string): 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: number, max: number, errorMessage?: string): this;
+    /**
+     * Alias for between() - string length between min and max
+     */
+    lengthBetween(min: number, max: number, errorMessage?: string): this;
+    /** Allow only alphabetic characters */
+    alpha(errorMessage?: string): this;
+    /** Allow only alphanumeric characters */
+    alphanumeric(errorMessage?: string): this;
+    /** Allow only numeric characters */
+    numeric(errorMessage?: string): this;
+    /** Value must starts with the given string */
+    startsWith(value: string, errorMessage?: string): this;
+    /** Value must ends with the given string */
+    endsWith(value: string, errorMessage?: string): this;
+    /** Value must contain the given string */
+    contains(value: string, errorMessage?: string): this;
+    /** Value must not contain the given string */
+    notContains(value: string, errorMessage?: string): this;
+    /** Value must be a valid IP address */
+    ip(errorMessage?: string): this;
+    /** Value must be a valid IPv4 address */
+    ip4(errorMessage?: string): this;
+    /** Value must be a valid IPv6 address */
+    ip6(errorMessage?: string): this;
+    /** Check if the string matches a credit card number */
+    creditCard(errorMessage?: string): this;
+    /** Determine if the value is a valid color */
+    color(errorMessage?: string): this;
+    /** Determine if the value is a valid hex color */
+    hexColor(errorMessage?: string): this;
+    /** Determine if the value is a valid HSL color */
+    hslColor(errorMessage?: string): this;
+    /** Determine if the value is a valid RGB color */
+    rgbColor(errorMessage?: string): this;
+    /** Determine if the value is a valid RGBA color */
+    rgbaColor(errorMessage?: string): this;
+    /** Determine if the value is a valid light color */
+    lightColor(errorMessage?: string): this;
+    /** Determine if the value is a valid dark color */
+    darkColor(errorMessage?: string): this;
+    enum: (values: any, errorMessage?: string) => ScalarValidator;
+    /** Value must be in one of the given values */
+    in: (values: any[], errorMessage?: string) => ScalarValidator;
+    /** @alias in */
+    oneOf: (values: any[], errorMessage?: string) => ScalarValidator;
+    /** @alias oneOf */
+    allowsOnly: (values: any[], errorMessage?: string) => ScalarValidator;
+    /** Forbid the value from being one of the given values */
+    forbids: (values: any[], errorMessage?: string) => ScalarValidator;
+    /** @alias forbids */
+    notIn: (values: any[], errorMessage?: string) => ScalarValidator;
+}
+//# sourceMappingURL=string-validator.d.ts.map

package/esm/validators/string-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-validator.d.ts","sourceRoot":"","sources":["../../src/validators/string-validator.ts"],"names":[],"mappings":"AAsEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAC7B,YAAY,CAAC,EAAE,MAAM;IAKxC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAMvC;;OAEG;IACI,QAAQ;IAKf,kCAAkC;IAC3B,SAAS;IAKhB,kCAAkC;IAC3B,SAAS;IAKhB,qDAAqD;IAC9C,UAAU;IAKjB,4DAA4D;IACrD,SAAS;IAKhB,2BAA2B;IACpB,SAAS;IAKhB,4BAA4B;IACrB,UAAU;IAKjB,4BAA4B;IACrB,SAAS;IAKhB,4BAA4B;IACrB,SAAS;IAKhB;;;OAGG;IACI,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM;IAK3B,+BAA+B;IACxB,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM;IAK5B,8BAA8B;IACvB,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM;IAK5B,iDAAiD;IAC1C,sBAAsB;IAK7B,uDAAuD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM;IAK1C,qDAAqD;IAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM;IAKxC,mCAAmC;IAC5B,QAAQ;IAKf,qCAAqC;IAC9B,UAAU;IAIjB,6BAA6B;IACtB,YAAY;IAKnB;;;OAGG;IACI,uBAAuB;IAK9B,4CAA4C;IACrC,OAAO;IAKd,8CAA8C;IACvC,cAAc;IAKrB,oCAAoC;IAC7B,aAAa;IAKpB,iBAAiB;IACV,SAAS;IAKhB,iBAAiB;IACV,SAAS;IAKhB,mCAAmC;IAC5B,IAAI;IAKX,oBAAoB;IACb,YAAY;IAKnB,oBAAoB;IACb,YAAY;IAKnB,mCAAmC;IAC5B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM;IAKvD,sDAAsD;IAC/C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM;IAK1D,oCAAoC;IAC7B,MAAM,CAAC,MAAM,EAAE,MAAM;IAK5B,2CAA2C;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM;IAK7B,yBAAyB;IAClB,OAAO;IAKd,mCAAmC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ;IAKjD,4BAA4B;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM;IAK3B,0BAA0B;IACnB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,SAAM;IAOnD,kCAAkC;IAC3B,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM;IAKlC,gCAAgC;IACzB,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM;IAKhC,oCAAoC;IAC7B,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM;IAK9C,yCAAyC;IAClC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMrD;;;;;;;;OAQG;IACI,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM/D,sDAAsD;IAC/C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMjD,uDAAuD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMpD,sDAAsD;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMpD,yDAAyD;IAClD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMtD,uBAAuB;IAChB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAI7C,sDAAsD;IAC/C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMtD,uBAAuB;IAChB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAI7C,wCAAwC;IACjC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMnD;;;;;;;;;;;;;OAaG;IACI,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAO9D;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAIpE,uCAAuC;IAChC,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM;IAKlC,yCAAyC;IAClC,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM;IAKzC,oCAAoC;IAC7B,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM;IAKpC,8CAA8C;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMtD,4CAA4C;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMpD,0CAA0C;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMpD,8CAA8C;IACvC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAMvD,uCAAuC;IAChC,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM;IAK/B,yCAAyC;IAClC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM;IAKhC,yCAAyC;IAClC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM;IAKhC,uDAAuD;IAChD,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM;IAKvC,8CAA8C;IACvC,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM;IAKlC,kDAAkD;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAKrC,kDAAkD;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAKrC,kDAAkD;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAKrC,mDAAmD;IAC5C,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM;IAKtC,oDAAoD;IAC7C,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM;IAKvC,mDAAmD;IAC5C,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM;IAM/B,IAAI,0DAAkC;IAC7C,+CAA+C;IACxC,EAAE,4DAAgC;IACzC,gBAAgB;IACT,KAAK,4DAAgC;IAC5C,mBAAmB;IACZ,UAAU,4DAAwC;IACzD,0DAA0D;IACnD,OAAO,4DAAqC;IACnD,qBAAqB;IACd,KAAK,4DAAqC;CAClD"}