@decaf-ts/decorator-validation 1.5.8 → 1.5.9

package/lib/esm/validation/Validators/RequiredValidator.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validator";
-import { ValidatorOptions } from "./types";
+import { ValidatorOptions } from "../types";
 /**
  * @summary Required Validator
  *

package/lib/esm/validation/Validators/StepValidator.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validator";
-import { StepValidatorOptions } from "./types";
+import { StepValidatorOptions } from "../types";
 /**
  * @summary Step Validator
  *

package/lib/esm/validation/Validators/TypeValidator.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validator";
-import { TypeValidatorOptions } from "./types";
+import { TypeValidatorOptions } from "../types";
 /**
  * @summary Required Validator
  *

package/lib/esm/validation/Validators/URLValidator.d.ts

@@ -1,5 +1,5 @@
 import { PatternValidator } from "./PatternValidator";
-import { PatternValidatorOptions } from "./types";
+import { PatternValidatorOptions } from "../types";
 /**
  * @summary URL Validator
  * @description Pattern from {@link https://gist.github.com/dperini/729294}

package/lib/esm/validation/Validators/Validator.d.ts

@@ -1,4 +1,4 @@
-import { ValidatorOptions } from "./types";
+import { ValidatorOptions } from "../types";
 /**
  * @summary Base Implementation for Validators
  * @description Provides the underlying functionality for {@link Validator}s

package/lib/esm/validation/Validators/ValidatorRegistry.d.ts

@@ -1,5 +1,5 @@
-import { ValidatorDefinition } from "./types";
-import { IValidatorRegistry } from "./types";
+import { ValidatorDefinition } from "../types";
+import { IValidatorRegistry } from "../types";
 import type { Validator } from "./Validator";
 /**
  * @summary Duck typing for Validators

package/lib/esm/validation/Validators/index.d.ts

@@ -24,7 +24,6 @@ export * from "./PasswordValidator";
 export * from "./PatternValidator";
 export * from "./RequiredValidator";
 export * from "./StepValidator";
-export * from "./types";
 export * from "./TypeValidator";
 export * from "./URLValidator";
 export * from "./Validator";

package/lib/esm/validation/Validators/index.js

@@ -24,7 +24,6 @@ export * from "./PasswordValidator";
 export * from "./PatternValidator";
 export * from "./RequiredValidator";
 export * from "./StepValidator";
-export * from "./types";
 export * from "./TypeValidator";
 export * from "./URLValidator";
 export * from "./Validator";

package/lib/esm/validation/types.d.ts

@@ -1,4 +1,7 @@
 import { DecoratorMetadata } from "@decaf-ts/reflection";
+import { Constructor } from "../model";
+import { Validator } from "./Validators";
+import { IRegistry } from "../utils";
 /**
  * @summary Type for validation decorator metadata
  * @memberOf module:decorator-validation.Reflection
@@ -44,3 +47,88 @@ export type ValidationElementDefinition = {
  * @category Validation
  */
 export type ModelErrors = Record<string, Record<string, string | undefined>>;
+/**
+ * @summary Util type for {@link Validator} configuration
+ * @memberOf module:decorator-validation.Validation
+ * @category Validation
+ */
+export type ValidatorDefinition = {
+    validator: Constructor<Validator>;
+    validationKey: string;
+    save: boolean;
+};
+/**
+ * @summary Base API for a {@link Validator} registry
+ *
+ * @interface ValidatorRegistry
+ * @extends IRegistry
+ *
+ * @category Validation
+ */
+export interface IValidatorRegistry<T extends Validator> extends IRegistry<T> {
+    /**
+     * @summary retrieves the custom keys
+     * @method
+     */
+    getCustomKeys(): Record<string, string>;
+    /**
+     * @summary Retrieves the Registered validator keys
+     * @return {string[]} the registered validators keys
+     * @method
+     */
+    getKeys(): string[];
+    /**
+     * @summary Registers the provided validators onto the registry
+     *
+     * @typedef T extends Validator
+     * @param {T[] | ValidatorDefinition[]} validator
+     * @method
+     */
+    register<T extends Validator>(...validator: (T | ValidatorDefinition)[]): void;
+    /**
+     * @summary Retrieves the Validator constructor if registered
+     *
+     * @typedef T extends Validator
+     * @param {string} key one of the {@link ValidationKeys}
+     * @return {Validator | undefined} the registered Validator or undefined if there is nono matching the provided key
+     * @method
+     */
+    get<T extends Validator>(key: string): T | undefined;
+}
+export type ValidatorOptions = {
+    message?: string;
+};
+export interface URLValidatorOptions extends ValidatorOptions {
+    types: string | string[] | {
+        name: string;
+    };
+}
+export interface TypeValidatorOptions extends ValidatorOptions {
+    types: string | string[] | {
+        name: string;
+    };
+}
+export interface StepValidatorOptions extends ValidatorOptions {
+    step: number | string;
+}
+export interface PatternValidatorOptions extends ValidatorOptions {
+    pattern?: RegExp | string;
+}
+export interface MinValidatorOptions extends ValidatorOptions {
+    min: number | Date | string;
+}
+export interface MinLengthValidatorOptions extends ValidatorOptions {
+    minLength: number;
+}
+export interface MaxValidatorOptions extends ValidatorOptions {
+    max: number | Date | string;
+}
+export interface MaxLengthValidatorOptions extends ValidatorOptions {
+    maxLength: number;
+}
+export interface ListValidatorOptions extends ValidatorOptions {
+    clazz: string[];
+}
+export interface DateValidatorOptions extends ValidatorOptions {
+    format?: string;
+}

package/lib/{index.js → index.cjs}

@@ -53,7 +53,7 @@ exports.VERSION = void 0;
  * @namespace Format
  * @memberOf module:decorator-validation
  */
-__exportStar(require("./utils"), exports);
-__exportStar(require("./validation"), exports);
-__exportStar(require("./model"), exports);
-exports.VERSION = "1.5.7";
+__exportStar(require("./utils/index.cjs"), exports);
+__exportStar(require("./validation/index.cjs"), exports);
+__exportStar(require("./model/index.cjs"), exports);
+exports.VERSION = "1.5.8";

package/lib/index.d.ts

@@ -39,4 +39,4 @@
 export * from "./utils";
 export * from "./validation";
 export * from "./model";
-export declare const VERSION = "1.5.7";
+export declare const VERSION = "1.5.8";

package/lib/model/{Model.js → Model.cjs}

@@ -1,19 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Model = exports.ModelRegistryManager = void 0;
+exports.isPropertyModel = isPropertyModel;
 exports.isModel = isModel;
 exports.bulkModelRegister = bulkModelRegister;
-const serialization_1 = require("../utils/serialization");
+const serialization_1 = require("../utils/serialization.cjs");
 const reflection_1 = require("@decaf-ts/reflection");
-const validation_1 = require("./validation");
-const hashing_1 = require("../utils/hashing");
-const utils_1 = require("./utils");
-const constants_1 = require("../utils/constants");
-const constants_2 = require("../validation/Validators/constants");
-const strings_1 = require("../utils/strings");
-const constants_3 = require("./constants");
+const validation_1 = require("./validation.cjs");
+const hashing_1 = require("../utils/hashing.cjs");
+const constants_1 = require("../utils/constants.cjs");
+const constants_2 = require("../validation/Validators/constants.cjs");
+const strings_1 = require("../utils/strings.cjs");
+const constants_3 = require("./constants.cjs");
 let modelBuilderFunction;
 let actingModelRegistry;
+function isPropertyModel(target, attribute) {
+    if (isModel(target[attribute]))
+        return true;
+    const metadata = Reflect.getMetadata(constants_1.ModelKeys.TYPE, target, attribute);
+    return Model.get(metadata.name) ? metadata.name : undefined;
+}
 /**
  * @summary For Serialization/deserialization purposes.
  * @description Reads the {@link ModelKeys.ANCHOR} property of a {@link Model} to discover the class to instantiate
@@ -211,7 +217,7 @@ class Model {
                 obj[prop] || undefined;
             if (typeof self[prop] !== "object")
                 continue;
-            const propM = (0, utils_1.isPropertyModel)(self, prop);
+            const propM = isPropertyModel(self, prop);
             if (propM) {
                 try {
                     self[prop] = Model.build(self[prop], typeof propM === "string" ? propM : undefined);

package/lib/model/Model.d.ts

@@ -1,6 +1,7 @@
 import { BuilderRegistry } from "../utils/registry";
 import { ModelErrorDefinition } from "./ModelErrorDefinition";
 import { Comparable, Constructor, Hashable, ModelArg, ModelBuilderFunction, ModelConstructor, Serializable, Validatable } from "./types";
+export declare function isPropertyModel<M extends Model>(target: M, attribute: string): boolean | string | undefined;
 /**
  * @summary For Serialization/deserialization purposes.
  * @description Reads the {@link ModelKeys.ANCHOR} property of a {@link Model} to discover the class to instantiate

package/lib/model/{construction.js → construction.cjs}

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.construct = construct;
 exports.findLastProtoBeforeObject = findLastProtoBeforeObject;
 exports.bindModelPrototype = bindModelPrototype;
-const Model_1 = require("./Model");
+const Model_1 = require("./Model.cjs");
 /**
  * @summary Helper Function to override constructors
  *

package/lib/model/{decorators.js → decorators.cjs}

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.model = model;
 exports.hashedBy = hashedBy;
 exports.serializedBy = serializedBy;
-const construction_1 = require("./construction");
-const constants_1 = require("../utils/constants");
-const Model_1 = require("./Model");
+const construction_1 = require("./construction.cjs");
+const constants_1 = require("../utils/constants.cjs");
+const Model_1 = require("./Model.cjs");
 const reflection_1 = require("@decaf-ts/reflection");
 /**
  * @summary Defines a class as a Model class

package/lib/{utils/index.js → model/index.cjs}

@@ -14,10 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./constants"), exports);
-__exportStar(require("./dates"), exports);
-__exportStar(require("./decorators"), exports);
-__exportStar(require("./hashing"), exports);
-__exportStar(require("./registry"), exports);
-__exportStar(require("./serialization"), exports);
-__exportStar(require("./strings"), exports);
+__exportStar(require("./constants.cjs"), exports);
+__exportStar(require("./construction.cjs"), exports);
+__exportStar(require("./decorators.cjs"), exports);
+__exportStar(require("./Model.cjs"), exports);
+__exportStar(require("./ModelErrorDefinition.cjs"), exports);
+__exportStar(require("./types.cjs"), exports);
+__exportStar(require("./validation.cjs"), exports);

package/lib/model/index.d.ts

@@ -4,5 +4,4 @@ export * from "./decorators";
 export * from "./Model";
 export * from "./ModelErrorDefinition";
 export * from "./types";
-export * from "./utils";
 export * from "./validation";

package/lib/model/{validation.js → validation.cjs}

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validate = validate;
-const ModelErrorDefinition_1 = require("./ModelErrorDefinition");
+const ModelErrorDefinition_1 = require("./ModelErrorDefinition.cjs");
 const reflection_1 = require("@decaf-ts/reflection");
-const constants_1 = require("../utils/constants");
-const strings_1 = require("../utils/strings");
-const constants_2 = require("./constants");
-const Model_1 = require("./Model");
-const Validation_1 = require("../validation/Validation");
-const constants_3 = require("../validation/Validators/constants");
+const constants_1 = require("../utils/constants.cjs");
+const strings_1 = require("../utils/strings.cjs");
+const constants_2 = require("./constants.cjs");
+const Model_1 = require("./Model.cjs");
+const Validation_1 = require("../validation/Validation.cjs");
+const constants_3 = require("../validation/Validators/constants.cjs");
 /**
  * @summary Analyses the decorations of the properties and validates the obj according to them
  *

package/lib/utils/{dates.js → dates.cjs}

@@ -7,8 +7,8 @@ exports.twoDigitPad = twoDigitPad;
 exports.formatDate = formatDate;
 exports.parseDate = parseDate;
 require("reflect-metadata");
-const constants_1 = require("../validation/Validators/constants");
-const strings_1 = require("./strings");
+const constants_1 = require("../validation/Validators/constants.cjs");
+const strings_1 = require("./strings.cjs");
 /**
  * @summary Reverses the process from {@link formatDate}
  *

package/lib/utils/{decorators.js → decorators.cjs}

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.prop = prop;
 exports.propMetadata = propMetadata;
 const reflection_1 = require("@decaf-ts/reflection");
-const constants_1 = require("./constants");
+const constants_1 = require("./constants.cjs");
 function prop(key = constants_1.ModelKeys.ATTRIBUTE) {
     return (model, propertyKey) => {
         let props;

package/lib/utils/{hashing.js → hashing.cjs}

@@ -2,9 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Hashing = exports.DefaultHashingMethod = void 0;
 exports.hashCode = hashCode;
-exports.hashSerialization = hashSerialization;
 exports.hashObj = hashObj;
-const serialization_1 = require("./serialization");
 /**
  * @summary Mimics Java's String's Hash implementation
  *
@@ -25,22 +23,6 @@ function hashCode(obj) {
     }
     return hash.toString();
 }
-/**
- * @summary Hashes an object serializing it and then hashing the string
- * @description The Serialization algorithm used by default (JSON.stringify)
- * is not deterministic and should not be used for hashing
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashSerialization
- * @memberOf module:decorator-validation.Utils.Hashing
- *
- * @category Hashing
- */
-function hashSerialization(obj) {
-    return hashCode(serialization_1.Serialization.serialize(obj));
-}
 /**
  * @summary Hashes an object by combining the hash of all its properties
  *

package/lib/utils/hashing.d.ts

@@ -15,20 +15,6 @@ export declare function hashCode(obj: string | number | symbol | Date): string;
  * @category Hashing
  */
 export type HashingFunction = (value: any, ...args: any[]) => string;
-/**
- * @summary Hashes an object serializing it and then hashing the string
- * @description The Serialization algorithm used by default (JSON.stringify)
- * is not deterministic and should not be used for hashing
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashSerialization
- * @memberOf module:decorator-validation.Utils.Hashing
- *
- * @category Hashing
- */
-export declare function hashSerialization(obj: Record<string, any> | any[]): string;
 /**
  * @summary Hashes an object by combining the hash of all its properties
  *

package/lib/{model/index.js → utils/index.cjs}

@@ -14,11 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./constants"), exports);
-__exportStar(require("./construction"), exports);
-__exportStar(require("./decorators"), exports);
-__exportStar(require("./Model"), exports);
-__exportStar(require("./ModelErrorDefinition"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./utils"), exports);
-__exportStar(require("./validation"), exports);
+__exportStar(require("./constants.cjs"), exports);
+__exportStar(require("./dates.cjs"), exports);
+__exportStar(require("./decorators.cjs"), exports);
+__exportStar(require("./hashing.cjs"), exports);
+__exportStar(require("./registry.cjs"), exports);
+__exportStar(require("./serialization.cjs"), exports);
+__exportStar(require("./strings.cjs"), exports);
+__exportStar(require("./types.cjs"), exports);

package/lib/utils/index.d.ts

@@ -5,3 +5,4 @@ export * from "./hashing";
 export * from "./registry";
 export * from "./serialization";
 export * from "./strings";
+export * from "./types";

package/lib/utils/{serialization.js → serialization.cjs}

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Serialization = exports.DefaultSerializationMethod = exports.JSONSerializer = void 0;
-const Model_1 = require("../model/Model");
-const constants_1 = require("./constants");
+exports.Serialization = exports.JSONSerializer = exports.DefaultSerializationMethod = void 0;
+const Model_1 = require("../model/Model.cjs");
+const constants_1 = require("./constants.cjs");
+exports.DefaultSerializationMethod = "json";
 /**
  * @summary Concrete implementation of a {@link Serializer} in JSON format
  * @description JS's native JSON.stringify (used here) is not deterministic
@@ -17,6 +18,7 @@ const constants_1 = require("./constants");
  * @category Serialization
  */
 class JSONSerializer {
+    constructor() { }
     /**
      * @summary prepares the model for serialization
      * @description returns a shallow copy of the object, containing an enumerable {@link ModelKeys#ANCHOR} property
@@ -57,7 +59,6 @@ class JSONSerializer {
     }
 }
 exports.JSONSerializer = JSONSerializer;
-exports.DefaultSerializationMethod = "json";
 class Serialization {
     static { this.current = exports.DefaultSerializationMethod; }
     static { this.cache = {

package/lib/utils/serialization.d.ts

@@ -1,33 +1,7 @@
-import { Model } from "../model/Model";
 import { Constructor } from "../model/types";
-/**
- * @summary Helper in serialization
- *
- * @interface Serializer
- * @category Serialization
- */
-export interface Serializer<T extends Model> {
-    /**
-     * @summary Serializes a model
-     * @param {T} model
-     *
-     * @param args
-     * @method
-     *
-     * @throws {Error}
-     */
-    serialize(model: T, ...args: any[]): string;
-    /**
-     * @summary Rebuilds a model from serialization
-     * @param {string} str
-     *
-     * @param args
-     * @method
-     *
-     * @throws {Error}
-     */
-    deserialize(str: string, ...args: any[]): T;
-}
+import { Serializer } from "./types";
+import { Model } from "../model/Model";
+export declare const DefaultSerializationMethod = "json";
 /**
  * @summary Concrete implementation of a {@link Serializer} in JSON format
  * @description JS's native JSON.stringify (used here) is not deterministic
@@ -42,6 +16,7 @@ export interface Serializer<T extends Model> {
  * @category Serialization
  */
 export declare class JSONSerializer<T extends Model> implements Serializer<T> {
+    constructor();
     /**
      * @summary prepares the model for serialization
      * @description returns a shallow copy of the object, containing an enumerable {@link ModelKeys#ANCHOR} property
@@ -66,7 +41,6 @@ export declare class JSONSerializer<T extends Model> implements Serializer<T> {
      */
     serialize(model: T): string;
 }
-export declare const DefaultSerializationMethod = "json";
 export declare class Serialization {
     private static current;
     private static cache;

package/lib/utils/types.d.ts

@@ -0,0 +1,29 @@
+import { Model } from "../model";
+/**
+ * @summary Helper in serialization
+ *
+ * @interface Serializer
+ * @category Serialization
+ */
+export interface Serializer<T extends Model> {
+    /**
+     * @summary Serializes a model
+     * @param {T} model
+     *
+     * @param args
+     * @method
+     *
+     * @throws {Error}
+     */
+    serialize(model: T, ...args: any[]): string;
+    /**
+     * @summary Rebuilds a model from serialization
+     * @param {string} str
+     *
+     * @param args
+     * @method
+     *
+     * @throws {Error}
+     */
+    deserialize(str: string, ...args: any[]): T;
+}

package/lib/validation/{Validation.js → Validation.cjs}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Validation = void 0;
-const ValidatorRegistry_1 = require("./Validators/ValidatorRegistry");
-const constants_1 = require("./Validators/constants");
+const ValidatorRegistry_1 = require("./Validators/ValidatorRegistry.cjs");
+const constants_1 = require("./Validators/constants.cjs");
 /**
  * @summary Static class acting as a namespace for the Validation
  *

package/lib/validation/Validation.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validators/Validator";
-import { IValidatorRegistry, ValidatorDefinition } from "./Validators/types";
+import { IValidatorRegistry, ValidatorDefinition } from "./types";
 /**
  * @summary Static class acting as a namespace for the Validation
  *

package/lib/validation/Validators/{DateValidator.js → DateValidator.cjs}

@@ -10,9 +10,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DateValidator = void 0;
-const Validator_1 = require("./Validator");
-const constants_1 = require("./constants");
-const decorators_1 = require("./decorators");
+const Validator_1 = require("./Validator.cjs");
+const constants_1 = require("./constants.cjs");
+const decorators_1 = require("./decorators.cjs");
 /**
  * @summary Date Validator
  *

package/lib/validation/Validators/DateValidator.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validator";
-import { DateValidatorOptions } from "./types";
+import { DateValidatorOptions } from "../types";
 /**
  * @summary Date Validator
  *

package/lib/validation/Validators/{EmailValidator.js → EmailValidator.cjs}

@@ -10,9 +10,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmailValidator = void 0;
-const constants_1 = require("./constants");
-const PatternValidator_1 = require("./PatternValidator");
-const decorators_1 = require("./decorators");
+const constants_1 = require("./constants.cjs");
+const PatternValidator_1 = require("./PatternValidator.cjs");
+const decorators_1 = require("./decorators.cjs");
 /**
  * @summary Email Validator
  *

package/lib/validation/Validators/EmailValidator.d.ts

@@ -1,5 +1,5 @@
 import { PatternValidator } from "./PatternValidator";
-import { PatternValidatorOptions } from "./types";
+import { PatternValidatorOptions } from "../types";
 /**
  * @summary Email Validator
  *

package/lib/validation/Validators/{ListValidator.js → ListValidator.cjs}

@@ -10,9 +10,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListValidator = void 0;
-const Validator_1 = require("./Validator");
-const constants_1 = require("./constants");
-const decorators_1 = require("./decorators");
+const Validator_1 = require("./Validator.cjs");
+const constants_1 = require("./constants.cjs");
+const decorators_1 = require("./decorators.cjs");
 /**
  * @summary List Validator
  *

package/lib/validation/Validators/ListValidator.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validator";
-import { ListValidatorOptions } from "./types";
+import { ListValidatorOptions } from "../types";
 /**
  * @summary List Validator
  *

package/lib/validation/Validators/{MaxLengthValidator.js → MaxLengthValidator.cjs}

@@ -10,9 +10,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MaxLengthValidator = void 0;
-const Validator_1 = require("./Validator");
-const constants_1 = require("./constants");
-const decorators_1 = require("./decorators");
+const Validator_1 = require("./Validator.cjs");
+const constants_1 = require("./constants.cjs");
+const decorators_1 = require("./decorators.cjs");
 /**
  * @summary Maximum Length Validator
  * @description Validates strings and Arrays on their maximum length

package/lib/validation/Validators/MaxLengthValidator.d.ts

@@ -1,5 +1,5 @@
 import { Validator } from "./Validator";
-import { MaxLengthValidatorOptions } from "./types";
+import { MaxLengthValidatorOptions } from "../types";
 /**
  * @summary Maximum Length Validator
  * @description Validates strings and Arrays on their maximum length