vortez 5.0.0-dev.18 → 5.0.0-dev.19

package/build/utilities/schema/Validator.js

@@ -0,0 +1,246 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides utilities for validating the structure of a schema, ensuring that property definitions are consistent and valid according to their types and constraints.
+ * @license Apache-2.0
+ */
+import { SchemaError } from './SchemaError.js';
+export class Validator {
+    /**
+     * Validates the structure of a schema, used for validating the structure of a schema and nested objects.
+     * @param schema The schema to validate
+     * @param parentKey The parent key of the schema, used for error messages
+     */
+    static validateStructure(schema, parentKey) {
+        for (const key in schema) {
+            const prop = schema[key];
+            this.validateProperty(prop, parentKey ? `${parentKey}.${key}` : key);
+        }
+    }
+    /**
+     * Validates a property definition, used for validating the structure of a schema and nested objects.
+     * @param prop The property definition to validate
+     * @param key The key of the property, used for error messages
+     */
+    static validateProperty(prop, key) {
+        switch (prop.type) {
+            case 'string':
+                this.validateStringProperty(prop, key);
+                break;
+            case 'number':
+                this.validateNumberProperty(prop, key);
+                break;
+            case 'boolean': break;
+            case 'array':
+                this.validateArrayProperty(prop, key);
+                break;
+            case 'object':
+                this.validateObjectProperty(prop, key);
+                break;
+            default: throw new SchemaError(`Unknown type for property '${key}'`);
+        }
+        if ('default' in prop)
+            this.validateDefaultValue(prop, key);
+    }
+    /**
+     * Validates a default value against a property definition, used for validating default values.
+     * @param prop The property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateDefaultValue(prop, key) {
+        if (prop.default === undefined) {
+            if (!prop.required)
+                return;
+            throw new SchemaError(`Property '${key}' default value cannot be undefined`);
+        }
+        if (prop.default === null) {
+            if (prop.nullable)
+                return;
+            throw new SchemaError(`Property '${key}' default value cannot be null`);
+        }
+        switch (prop.type) {
+            case 'string':
+                this.validateString(prop.default, prop, key);
+                break;
+            case 'number':
+                this.validateNumber(prop.default, prop, key);
+                break;
+            case 'boolean':
+                this.validateBoolean(prop.default, prop, key);
+                break;
+            case 'array':
+                this.validateArray(prop.default, prop, key);
+                break;
+            case 'object':
+                this.validateObject(prop.default, prop, key);
+                break;
+            default: throw new SchemaError(`Unknown type for property '${key}'`);
+        }
+    }
+    /**
+     * Validates a string property definition, used for validating nested objects.
+     * @param prop The string property definition to validate
+     * @param key The key of the property, used for error messages
+     */
+    static validateStringProperty(prop, key) {
+        if (prop.enum !== undefined) {
+            if (!Array.isArray(prop.enum) || prop.enum.length === 0) {
+                throw new SchemaError(`Property '${key}' enum must be a non-empty array`);
+            }
+            if (prop.enum.some((value) => typeof value !== 'string')) {
+                throw new SchemaError(`Property '${key}' enum values must be strings`);
+            }
+        }
+        if (prop.maxLength !== undefined && prop.minLength !== undefined && prop.maxLength < prop.minLength) {
+            throw new SchemaError(`Property '${key}' maxLength must be greater than or equal to minLength`);
+        }
+        if (prop.pattern !== undefined && !(prop.pattern instanceof RegExp)) {
+            throw new SchemaError(`Property '${key}' pattern must be a RegExp`);
+        }
+    }
+    /**
+     * Validates a number property definition, used for validating nested objects.
+     * @param prop The number property definition to validate
+     * @param key The key of the property, used for error messages
+     */
+    static validateNumberProperty(prop, key) {
+        if (prop.maximum !== undefined && prop.minimum !== undefined && prop.maximum < prop.minimum) {
+            throw new SchemaError(`Property '${key}' maximum must be greater than or equal to minimum`);
+        }
+    }
+    /**
+     * Validates an array property definition, used for validating nested arrays.
+     * @param prop The array property definition to validate
+     * @param key The key of the property, used for error messages
+     */
+    static validateArrayProperty(prop, key) {
+        if (prop.maximum !== undefined && prop.minimum !== undefined && prop.maximum < prop.minimum) {
+            throw new SchemaError(`Property '${key}' maximum must be greater than or equal to minimum`);
+        }
+        this.validateProperty(prop.property, `${key}[]`);
+    }
+    /**
+     * Validates an object property definition, used for validating nested objects.
+     * @param prop The object property definition to validate
+     * @param key The key of the property, used for error messages
+     */
+    static validateObjectProperty(prop, key) {
+        this.validateStructure(prop.schema, key);
+    }
+    /**
+     * Validates a string value against a string property definition, used for validating default values and nested objects.
+     * @param value The value to validate
+     * @param prop The string property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateString(value, prop, key) {
+        if (value == null && prop.nullable === true)
+            return;
+        if (typeof value !== 'string')
+            throw new SchemaError(`Property ${key} must be a string`);
+        if (prop.enum !== undefined && !prop.enum.includes(value)) {
+            throw new SchemaError(`Property ${key} must be one of: ${prop.enum.join(', ')}`);
+        }
+        if (prop.minLength !== undefined && value.length < prop.minLength) {
+            throw new SchemaError(`Property ${key} must have a minimum length of ${prop.minLength}`);
+        }
+        if (prop.maxLength !== undefined && value.length > prop.maxLength) {
+            throw new SchemaError(`Property ${key} must have a maximum length of ${prop.maxLength}`);
+        }
+        if (prop.pattern && !prop.pattern.test(value)) {
+            throw new SchemaError(`Property ${key} must match the pattern ${prop.pattern}`);
+        }
+    }
+    /**
+     * Validates a number value against a number property definition, used for validating default values.
+     * @param value The value to validate
+     * @param prop The number property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateNumber(value, prop, key) {
+        if (value == null && prop.nullable === true)
+            return;
+        if (typeof value !== 'number')
+            throw new SchemaError(`Property ${key} must be a number`);
+        if (prop.minimum !== undefined && value < prop.minimum) {
+            throw new SchemaError(`Property ${key} must be greater than or equal to ${prop.minimum}`);
+        }
+        if (prop.maximum !== undefined && value > prop.maximum) {
+            throw new SchemaError(`Property ${key} must be less than or equal to ${prop.maximum}`);
+        }
+    }
+    /**
+     * Validates a boolean value against a boolean property definition, used for validating default values.
+     * @param value The value to validate
+     * @param prop The boolean property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateBoolean(value, prop, key) {
+        if (value == null && prop.nullable === true)
+            return;
+        if (typeof value !== 'boolean')
+            throw new SchemaError(`Property ${key} must be a boolean`);
+    }
+    /**
+     * Validates an object value against an object property definition, used for validating default values and nested objects.
+     * @param value The value to validate
+     * @param prop The object property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateObject(value, prop, key) {
+        if (value == null && prop.nullable === true)
+            return;
+        if (typeof value !== 'object' || Array.isArray(value)) {
+            throw new SchemaError(`Property ${key} must be an object`);
+        }
+        this.validateStructure(prop.schema, key);
+    }
+    /**
+     * Validates an array value against an array property definition, used for validating default values and array items.
+     * @param value The value to validate
+     * @param prop The array property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateArray(value, prop, key) {
+        if (value == null && prop.nullable === true)
+            return;
+        if (!Array.isArray(value))
+            throw new SchemaError(`Property ${key} must be an array`);
+        if (prop.minimum !== undefined && value.length < prop.minimum) {
+            throw new SchemaError(`Property ${key} must have at least ${prop.minimum} items`);
+        }
+        if (prop.maximum !== undefined && value.length > prop.maximum) {
+            throw new SchemaError(`Property ${key} must have at most ${prop.maximum} items`);
+        }
+        value.forEach((item, index) => {
+            this.validateValue(item, prop.property, `${key}[${index}]`);
+        });
+    }
+    /**
+     * Validates a value against a property definition, used for validating default values and array items.
+     * @param value The value to validate
+     * @param prop The property definition to validate against
+     * @param key The key of the property, used for error messages
+     */
+    static validateValue(value, prop, key) {
+        switch (prop.type) {
+            case 'string':
+                this.validateString(value, prop, key);
+                break;
+            case 'number':
+                this.validateNumber(value, prop, key);
+                break;
+            case 'boolean':
+                this.validateBoolean(value, prop, key);
+                break;
+            case 'array':
+                this.validateArray(value, prop, key);
+                break;
+            case 'object':
+                this.validateObject(value, prop, key);
+                break;
+            default: throw new SchemaError(`Unknown type for property '${key}'`);
+        }
+    }
+}
+export default Validator;
+//# sourceMappingURL=Validator.js.map

package/build/utilities/schema/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../../src/utilities/schema/Validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,OAAO,SAAS;IAClB;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,MAAqB,EAAE,SAAkB;QACrE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,gBAAgB,CAAC,IAAqB,EAAE,GAAW;QAC7D,QAAO,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,QAAQ;gBAAE,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC7D,KAAK,QAAQ;gBAAE,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC7D,KAAK,SAAS,CAAC,CAAC,MAAM;YACtB,KAAK,OAAO;gBAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC3D,KAAK,QAAQ;gBAAE,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC7D,OAAO,CAAC,CAAC,MAAM,IAAI,WAAW,CAAC,8BAA8B,GAAG,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,SAAS,IAAI,IAAI;YAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,oBAAoB,CAAC,IAAqB,EAAE,GAAW;QACjE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC3B,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,qCAAqC,CAAC,CAAA;QAChF,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC1B,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,gCAAgC,CAAC,CAAC;QAC5E,CAAC;QACD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YACnE,KAAK,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YACnE,KAAK,SAAS;gBAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YACrE,KAAK,OAAO;gBAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YACjE,KAAK,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YACnE,OAAO,CAAC,CAAC,MAAM,IAAI,WAAW,CAAC,8BAA8B,GAAG,GAAG,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,sBAAsB,CAAC,IAA4B,EAAE,GAAW;QAC1E,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,kCAAkC,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,+BAA+B,CAAC,CAAC;YAC3E,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAClG,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,wDAAwD,CAAC,CAAC;QACpG,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,4BAA4B,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,sBAAsB,CAAC,IAA4B,EAAE,GAAW;QAC1E,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1F,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,oDAAoD,CAAC,CAAC;QAChG,CAAC;IACL,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,qBAAqB,CAAC,IAA2B,EAAE,GAAW;QACxE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1F,MAAM,IAAI,WAAW,CAAC,aAAa,GAAG,oDAAoD,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,sBAAsB,CAAC,IAA4B,EAAE,GAAW;QAC1E,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,KAAa,EAAE,IAA4B,EAAE,GAAW;QACjF,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,mBAAmB,CAAC,CAAC;QACzF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,oBAAoB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChE,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,kCAAkC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChE,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,kCAAkC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,2BAA2B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;IACL,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,KAAa,EAAE,IAA4B,EAAE,GAAW;QACjF,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,mBAAmB,CAAC,CAAC;QACzF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,qCAAqC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,kCAAkC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,eAAe,CAAC,KAAc,EAAE,IAA6B,EAAE,GAAW;QACpF,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO;QACpD,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,oBAAoB,CAAC,CAAC;IAC/F,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,KAAU,EAAE,IAA4B,EAAE,GAAW;QAC9E,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,oBAAoB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,aAAa,CAAC,KAAU,EAAE,IAA2B,EAAE,GAAW;QAC5E,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,mBAAmB,CAAC,CAAC;QACrF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5D,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,uBAAuB,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5D,MAAM,IAAI,WAAW,CAAC,YAAY,GAAG,sBAAsB,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;QACrF,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACP,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,aAAa,CAAC,KAAU,EAAE,IAAqB,EAAE,GAAW;QACtE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC5D,KAAK,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC5D,KAAK,SAAS;gBAAE,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC9D,KAAK,OAAO;gBAAE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC1D,KAAK,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM;YAC5D,OAAO,CAAC,CAAC,MAAM,IAAI,WAAW,CAAC,8BAA8B,GAAG,GAAG,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;CACJ;AAED,eAAe,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vortez",
-  "version": "5.0.0-dev.18",
+  "version": "5.0.0-dev.19",
   "description": "a module for web server creation",
   "type": "module",
   "main": "build/Vortez.js",

package/tests/config/config.js

@@ -0,0 +1,233 @@
+// @ts-check
+import { strict as assert } from 'assert';
+import { promises as FSP } from 'fs';
+
+import { Logger } from '../../build/Vortez.js';
+import { Config } from '../../build/server/config/Config.js';
+import { Loader } from '../../build/server/config/Loader.js';
+import { SchemaError } from '../../build/utilities/schema/SchemaError.js';
+
+const logger = new Logger({ prefix: 'CONFIG' });
+
+let testsPassed = 0;
+let testsFailed = 0;
+
+const TMP_DIR = 'tests/.tmp/config-suite';
+const CONFIG_PATH = `${TMP_DIR}/config.json`;
+const BAD_CONFIG_PATH = `${TMP_DIR}/bad.json`;
+
+/**
+ * Logs test results.
+ * @param { string } testName The test name.
+ * @param { boolean } passed Whether the test passed.
+ * @param { unknown | null } error Optional error object for failures.
+ */
+function logTestResult(testName, passed, error = null) {
+    if (passed) {
+        logger.log(`&C2✓ ${testName}`);
+        testsPassed++;
+    } else {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`&C1✗ ${testName}${error ? ': ' + message : ''}`);
+        testsFailed++;
+    }
+}
+
+async function resetTmpDir() {
+    await FSP.rm(TMP_DIR, { recursive: true, force: true });
+    await FSP.mkdir(TMP_DIR, { recursive: true });
+}
+
+/**
+ * Ensures constructor applies default values for missing config keys.
+ */
+function testDefaultConfigValues() {
+    try {
+        const config = new Config({});
+
+        assert.equal(config.get('host'), 'localhost');
+        assert.equal(config.get('port'), 80);
+        assert.equal(config.get('ssl'), null);
+        assert.equal(config.get('templates.folder'), './global/Template/Folder.vhtml');
+        assert.equal(config.get('templates.error'), './global/Template/Error.vhtml');
+        assert.equal(config.get('routing.algorithm'), 'FIFO');
+        assert.equal(config.get('logger.showAll'), false);
+        assert.equal(config.get('logger.server.show'), true);
+        assert.equal(config.get('logger.server.save'), true);
+
+        logTestResult('constructor - Applies defaults', true);
+    } catch (error) {
+        logTestResult('constructor - Applies defaults', false, error);
+    }
+}
+
+/**
+ * Ensures nested object defaults are filled when object is partially provided.
+ */
+function testNestedSslDefaultPort() {
+    try {
+        const config = new Config({
+            ssl: {
+                cert: 'cert-path',
+                key: 'key-path'
+            }
+        });
+
+        assert.equal(config.get('ssl.cert'), 'cert-path');
+        assert.equal(config.get('ssl.key'), 'key-path');
+        assert.equal(config.get('ssl.port'), 443);
+
+        logTestResult('constructor - Nested defaults inside ssl', true);
+    } catch (error) {
+        logTestResult('constructor - Nested defaults inside ssl', false, error);
+    }
+}
+
+/**
+ * Ensures enum constraints are validated.
+ */
+function testRoutingEnumValidation() {
+    try {
+        assert.throws(
+            // @ts-expect-error Runtime validation test with invalid enum on purpose.
+            () => new Config({ routing: { algorithm: 'BreadthFirst' } }),
+            SchemaError
+        );
+
+        logTestResult('validation - Reject invalid routing algorithm', true);
+    } catch (error) {
+        logTestResult('validation - Reject invalid routing algorithm', false, error);
+    }
+}
+
+/**
+ * Ensures get/set use flattened dot-path keys.
+ */
+function testGetSetFlattenedPaths() {
+    try {
+        const config = new Config({});
+
+        config.set('host', '127.0.0.1');
+        config.set('routing.algorithm', 'Tree');
+        config.set('logger.server.show', false);
+
+        assert.equal(config.get('host'), '127.0.0.1');
+        assert.equal(config.get('routing.algorithm'), 'Tree');
+        assert.equal(config.get('logger.server.show'), false);
+
+        logTestResult('api - Get/Set flattened paths', true);
+    } catch (error) {
+        logTestResult('api - Get/Set flattened paths', false, error);
+    }
+}
+
+/**
+ * Ensures save writes nested JSON and creates missing folders.
+ */
+async function testSaveCreatesFileAndNestedData() {
+    try {
+        await resetTmpDir();
+
+        const config = new Config({});
+        config.set('host', '0.0.0.0');
+        config.set('logger.request.save', false);
+        await config.save(CONFIG_PATH);
+
+        const content = await FSP.readFile(CONFIG_PATH, 'utf8');
+        const data = JSON.parse(content);
+
+        assert.equal(data.host, '0.0.0.0');
+        assert.equal(data.logger.request.save, false);
+
+        logTestResult('save - Writes file and nested json', true);
+    } catch (error) {
+        logTestResult('save - Writes file and nested json', false, error);
+    }
+}
+
+/**
+ * Ensures Loader creates a new file when it does not exist.
+ */
+async function testLoaderCreatesMissingFile() {
+    try {
+        await resetTmpDir();
+
+        const loaded = await Loader.load(CONFIG_PATH);
+
+        assert.ok(loaded instanceof Config);
+        assert.equal(loaded.get('host'), 'localhost');
+
+        const content = await FSP.readFile(CONFIG_PATH, 'utf8');
+        const data = JSON.parse(content);
+        assert.equal(data.port, 80);
+
+        logTestResult('loader - Creates missing file with defaults', true);
+    } catch (error) {
+        logTestResult('loader - Creates missing file with defaults', false, error);
+    }
+}
+
+/**
+ * Ensures Loader reads and validates existing config files.
+ */
+async function testLoaderReadsExistingFile() {
+    try {
+        await resetTmpDir();
+
+        await FSP.writeFile(
+            CONFIG_PATH,
+            JSON.stringify({ host: 'example.com', routing: { algorithm: 'Tree' } }, null, 4),
+            'utf8'
+        );
+
+        const loaded = await Loader.load(CONFIG_PATH);
+
+        assert.equal(loaded.get('host'), 'example.com');
+        assert.equal(loaded.get('routing.algorithm'), 'Tree');
+
+        logTestResult('loader - Loads existing file', true);
+    } catch (error) {
+        logTestResult('loader - Loads existing file', false, error);
+    }
+}
+
+/**
+ * Ensures Loader throws when the file contains invalid JSON.
+ */
+async function testLoaderRejectsInvalidJson() {
+    try {
+        await resetTmpDir();
+        await FSP.writeFile(BAD_CONFIG_PATH, '{ "host": "localhost", ', 'utf8');
+
+        await assert.rejects(() => Loader.load(BAD_CONFIG_PATH));
+
+        logTestResult('loader - Rejects invalid json file', true);
+    } catch (error) {
+        logTestResult('loader - Rejects invalid json file', false, error);
+    }
+}
+
+async function runTests() {
+    logger.log('\n&C6=== Config Test Suite ===\n');
+
+    testDefaultConfigValues();
+    testNestedSslDefaultPort();
+    testRoutingEnumValidation();
+    testGetSetFlattenedPaths();
+
+    await testSaveCreatesFileAndNestedData();
+    await testLoaderCreatesMissingFile();
+    await testLoaderReadsExistingFile();
+    await testLoaderRejectsInvalidJson();
+
+    await FSP.rm(TMP_DIR, { recursive: true, force: true });
+
+    logger.log('\n&C6=== Results ===');
+    logger.log(`&C2✓ Passed: ${testsPassed}`);
+    logger.log(`&C1✗ Failed: ${testsFailed}`);
+    logger.log(`&C3Total: ${testsPassed + testsFailed}\n`);
+
+    process.exit(testsFailed > 0 ? 1 : 0);
+}
+
+runTests();