@digitaldefiance/node-express-suite 3.7.4 → 3.7.6

package/src/validation/validation-builder.js

@@ -1,17 +1,38 @@
 "use strict";
+/**
+ * @fileoverview Validation builder for fluent validation chain construction.
+ * Provides builder pattern for express-validator chains.
+ * @module validation/validation-builder
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidationBuilder = exports.FieldValidator = void 0;
 const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
 const express_validator_1 = require("express-validator");
+/**
+ * Field validator for building validation chains.
+ * @template TLanguage - Language code type
+ * @template TConstants - Constants type (defaults to IConstants)
+ */
 class FieldValidator {
     chain;
     language;
     constants;
+    /**
+     * Creates a new field validator.
+     * @param {string} field - Field name to validate
+     * @param {TLanguage} [language] - Language for error messages
+     * @param {TConstants} [constants] - Constants for validation
+     */
     constructor(field, language, constants) {
         this.chain = (0, express_validator_1.body)(field);
         this.language = language;
         this.constants = constants;
     }
+    /**
+     * Adds regex matching validation.
+     * @param {RegExp | Function} regex - Regex or function returning regex
+     * @returns {this} This validator for chaining
+     */
     matches(regex) {
         const actualRegex = typeof regex === 'function' && this.constants
             ? regex(this.constants)
@@ -19,60 +40,78 @@ class FieldValidator {
         this.chain = this.chain.matches(actualRegex);
         return this;
     }
+    /** Validates email format. @returns {this} This validator for chaining */
     isEmail() {
         this.chain = this.chain.isEmail();
         return this;
     }
+    /** Validates string type. @returns {this} This validator for chaining */
     isString() {
         this.chain = this.chain.isString();
         return this;
     }
+    /** Validates non-empty value. @returns {this} This validator for chaining */
     notEmpty() {
         this.chain = this.chain.notEmpty();
         return this;
     }
+    /** Makes field optional. @returns {this} This validator for chaining */
     optional() {
         this.chain = this.chain.optional();
         return this;
     }
+    /** Adds custom validator. @param {Function} validator - Custom validation function @returns {this} This validator for chaining */
     custom(validator) {
         this.chain = this.chain.custom(validator);
         return this;
     }
+    /** Validates string length. @param {object} options - Length options @returns {this} This validator for chaining */
     isLength(options) {
         this.chain = this.chain.isLength(options);
         return this;
     }
+    /** Validates value is in array. @param {unknown[]} values - Allowed values @returns {this} This validator for chaining */
     isIn(values) {
         this.chain = this.chain.isIn(values);
         return this;
     }
+    /** Sets error message. @param {SuiteCoreStringKey} key - Translation key @param {Record<string, string>} [params] - Message parameters @returns {this} This validator for chaining */
     withMessage(key, params) {
         const message = (0, suite_core_lib_1.getSuiteCoreTranslation)(key, params, this.language);
         this.chain = this.chain.withMessage(message);
         return this;
     }
+    /** Builds the validation chain. @returns {ValidationChain} Complete validation chain */
     build() {
         return this.chain;
     }
 }
 exports.FieldValidator = FieldValidator;
+/**
+ * Validation builder for constructing multiple field validators.
+ * @template TLanguage - Language code type
+ * @template TConstants - Constants type (defaults to IConstants)
+ */
 class ValidationBuilder {
     validators = [];
     language;
     constants;
+    /** Creates a new validation builder. @param {TLanguage} [language] - Language for messages @param {TConstants} [constants] - Constants @returns {ValidationBuilder} New builder instance */
     static create(language, constants) {
         return new ValidationBuilder(language, constants);
     }
+    /** Creates a new validation builder. @param {TLanguage} [language] - Language for messages @param {TConstants} [constants] - Constants */
     constructor(language, constants) {
         this.language = language;
         this.constants = constants;
     }
+    /** Creates a field validator. @param {string} field - Field name @returns {FieldValidator} Field validator instance */
     for(field) {
         const validator = new FieldValidator(field, this.language, this.constants);
         this.validators.push(validator);
         return validator;
     }
+    /** Builds all validation chains. @returns {ValidationChain[]} Array of validation chains */
     build() {
         return this.validators.map((v) => v.build());
     }

package/src/validation/validation-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/validation/validation-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/validation/validation-builder.ts"],"names":[],"mappings":"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"}