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

package/build/utilities/schema/JSONSchema.js

@@ -0,0 +1,13 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides type definitions for JSON Schema, a powerful tool for validating and describing the structure of JSON data.
+ * @license Apache-2.0
+ */
+/**
+ * provide the type definition of a json schema
+ * @param schema the json schema to validate
+ */
+export function schema(schema) { return schema; }
+export const JSONSchema = { schema };
+export default JSONSchema;
+//# sourceMappingURL=JSONSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JSONSchema.js","sourceRoot":"","sources":["../../../src/utilities/schema/JSONSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoEH;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,MAAyB,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,CAAC;AACrC,eAAe,UAAU,CAAC"}

package/build/utilities/schema/Schema.d.ts

@@ -0,0 +1,253 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides a comprehensive schema validation and processing system, allowing developers to define complex data structures.
+ * @license Apache-2.0
+ */
+import type Utilities from '../Utilities.js';
+import _SchemaError from './SchemaError.js';
+import _JSONSchema from './JSONSchema.js';
+import _Introspection from './Introspection.js';
+import _Validator from './Validator.js';
+export { SchemaError } from './SchemaError.js';
+export { JSONSchema } from './JSONSchema.js';
+export { Introspection } from './Introspection.js';
+export { Validator } from './Validator.js';
+export declare class Schema<const S extends Schema.Schema> {
+    readonly schema: S;
+    constructor(schema: S);
+    /**
+     * Get the inferred type of the schema.
+     *
+     * ⚠️ IMPORTANT: This getter returns an EMPTY object. It is designed ONLY for type inference.
+     *
+     * Usage: Use with `typeof` to extract the inferred type:
+     * ```typescript
+     * type infered = typeof schemaInstance.infer;
+     * ```
+     *
+     * DO NOT use the returned value at runtime - it's always an empty object.
+     * This is purely a TypeScript type utility.
+     *
+     * @returns An empty object with the inferred type
+     */
+    get infer(): Schema.Infer<this['schema']>;
+    /**
+     * Get the inferred type of the schema for processing (i.e., before applying defaults and handling optional properties).
+     *
+     * ⚠️ IMPORTANT: This getter returns an EMPTY object. It is designed ONLY for type inference.
+     *
+     * Usage: Use with `typeof` to extract the inferred type for processing:
+     * ```typescript
+     * type inferedToProcess = typeof schemaInstance.inferToProcess;
+     * ```
+     *
+     * DO NOT use the returned value at runtime - it's always an empty object.
+     * This is purely a TypeScript type utility.
+     */
+    get inferToProcess(): Schema.InferToProcess<this['schema']>;
+    /**
+     * get the json schema as an object
+     * @returns the json schema
+     */
+    get jsonSchema(): Schema.JSONSchema.schema;
+    /**
+     * get the json schema as a JSON string
+     * @returns the json schema as a string
+     */
+    get jsonSchemaJSON(): string;
+    /**
+     * get the list of unique keys
+     * @returns the list of unique keys
+     */
+    get uniques(): string[];
+    /**
+     * process the provided data
+     * @param data the data to process
+     * @param partial if the data is partial
+     * @returns the processed data
+     * @throws schemaError if the data is not valid
+     */
+    processData(data: Schema.Infer<this['schema']>, partial?: boolean): Schema.Infer<this['schema']>;
+    processData(data: Schema.InferToProcess<this['schema']>, partial?: boolean): Schema.Infer<this['schema']>;
+    /**
+     * process the provided data as partial, meaning that it will only validate the provided properties and ignore the rest.
+     * this is useful for validating data that is only meant to update a document, where only a subset of the properties are provided.
+     * @param data the data to process
+     * @returns the processed data
+     * @throws schemaError if the data is not valid
+     */
+    processPartialData(data: Partial<Schema.FlattenToProcess<this['schema']>> & Partial<Schema.InferToProcess<this['schema']>> & Schema.Document): Partial<Schema.Flatten<this['schema']>> & Partial<Schema.Infer<this['schema']>> & Schema.Document;
+    processPartialData(data: Partial<Schema.Flatten<this['schema']>> & Partial<Schema.Infer<this['schema']>> & Schema.Document): Partial<Schema.Flatten<this['schema']>> & Partial<Schema.Infer<this['schema']>> & Schema.Document;
+    /**
+     * process a property
+     * @param data the data to process
+     * @param prop the property to process
+     * @param key the key of the property
+     * @param partial if the data is partial
+     * @returns the processed data
+     * @throws schemaError if the data is not valid
+     */
+    protected processProperty(data: any, prop: Schema.property, key: string, partial?: boolean): any;
+    /**
+     * validate a array
+     * @param value the value to validate
+     * @param prop the property to validate
+     * @param key the key of the property
+     * @returns the data
+     * @throws schemaError if the data is not valid
+     */
+    protected processArray(value: any[], prop: Schema.Property.Array, key: string): any;
+    /**
+     * validate a object
+     * @param value the value to validate
+     * @param prop the property to validate
+     * @param key the key of the property
+     * @returns the data
+     * @throws schemaError if the data is not valid
+     */
+    protected processObject(value: any, prop: Schema.Property.Object, key: string, partial?: boolean): any;
+    /**
+     * validate a array
+     * @param value the value to validate
+     * @param prop the property to validate
+     * @param key the key of the property
+     * @throws schemaError if the data is not valid
+     */
+    protected validateArray(value: any, prop: Schema.Property.Array, key: string): void;
+    /**
+     * generate a list of unique keys
+     * @param doc the schema to validate
+     * @param parentKey the parent key of the schema
+     * @returns a list of unique keys
+    */
+    protected listUniques(doc?: Schema.Schema, parentKey?: string): string[];
+    /**
+     * convert a schema to a JSON schema
+     * @param schema the schema to convert
+     * @returns the JSON schema
+    */
+    protected toJsonSchema(schema?: Schema.Schema): Schema.JSONSchema.schema;
+    /**
+     * -- TYPE GUARD --
+     * verify if the key is in the schema
+     * @param doc the object to verify
+     * @param key the key to verify
+     * @returns true if the key is in the schema
+     */
+    private isKeyOf;
+}
+export declare namespace Schema {
+    export import SchemaError = _SchemaError;
+    export import JSONSchema = _JSONSchema;
+    export import Introspection = _Introspection;
+    export import Validator = _Validator;
+    type Infer<S extends Schema> = Schema.Infer.schema<S>;
+    type InferToProcess<S extends Schema> = Schema.Infer.schemaToProcess<S>;
+    type Flatten<S extends Schema.Schema> = (Utilities.Flatten.Object<Infer.schema<S>, 10>);
+    type FlattenToProcess<S extends Schema.Schema> = (Utilities.Flatten.Object<Infer.schemaToProcess<S>, 10>);
+    interface Document {
+        [Key: string]: any;
+    }
+    interface TypeMap {
+        string: string;
+        number: number;
+        boolean: boolean;
+        object: any;
+        array: any[];
+    }
+    namespace Helper {
+        type HasDefault<T> = T extends {
+            default: any;
+        } ? true : false;
+        type IsRequired<T> = T extends {
+            required: true;
+        } ? true : false;
+        type IsNullable<T> = T extends {
+            nullable: true;
+        } ? true : false;
+        type DefaultValue<T> = T extends {
+            default: infer D;
+        } ? D : never;
+        type Prettify<T> = {
+            [K in keyof T]: T[K];
+        } & {};
+    }
+    namespace Property {
+        interface Base<T extends keyof TypeMap> {
+            type: T;
+            required?: boolean;
+            nullable?: boolean;
+            unique?: boolean;
+            default?: TypeMap[T] | null;
+        }
+        export interface String extends Base<'string'> {
+            enum?: readonly string[];
+            pattern?: RegExp;
+            minLength?: number;
+            maxLength?: number;
+        }
+        export interface Number extends Base<'number'> {
+            minimum?: number;
+            maximum?: number;
+        }
+        export interface Boolean extends Base<'boolean'> {
+        }
+        export interface Object extends Base<'object'> {
+            schema: Schema;
+        }
+        export interface Array extends Base<'array'> {
+            property: property;
+            minimum?: number;
+            maximum?: number;
+        }
+        export interface Map {
+            string: String;
+            number: Number;
+            boolean: Boolean;
+            object: Object;
+            array: Array;
+        }
+        export {};
+    }
+    type property = Property.Map[keyof Property.Map];
+    interface Schema {
+        [Key: string]: property;
+    }
+    namespace Infer {
+        export type Mode = 'partial' | 'process' | 'complete';
+        type ObjectByMode<S extends Schema.Schema, M extends Mode> = (M extends 'process' ? schemaToProcess<S> : M extends 'partial' ? schemaPartial<S> : schema<S>);
+        export type propertyType<P extends Schema.property, M extends Mode = 'complete'> = (P extends Property.String ? P extends {
+            enum: readonly (infer E extends string)[];
+        } ? E : string : P extends Property.Number ? number : P extends Property.Boolean ? boolean : P extends Property.Object ? (ObjectByMode<P['schema'], M>) : P extends Property.Array ? propertyType<P['property'], M>[] : never);
+        type OptionalPropertyValue<P extends Schema.property, M extends Mode> = (Helper.IsNullable<P> extends true ? propertyType<P, M> | null : propertyType<P, M> | undefined);
+        type DefaultedPropertyValue<P extends Schema.property, M extends Mode> = (Helper.DefaultValue<P> extends null ? propertyType<P, M> | null : propertyType<P, M>);
+        type RequiredPropertyValue<P extends Schema.property, M extends Mode> = (Helper.IsNullable<P> extends true ? propertyType<P, M> | null : propertyType<P, M>);
+        export type property<P extends Schema.property, M extends Mode = 'complete'> = (Helper.HasDefault<P> extends true ? DefaultedPropertyValue<P, M> : Helper.IsRequired<P> extends true ? RequiredPropertyValue<P, M> : OptionalPropertyValue<P, M>);
+        type RequiredKeys<S extends Schema> = {
+            [K in keyof S]: Helper.IsRequired<S[K]> extends true ? K : Helper.HasDefault<S[K]> extends true ? K : never;
+        }[keyof S];
+        type OptionalKeys<S extends Schema> = Exclude<keyof S, RequiredKeys<S>>;
+        type RequiredToProcessKeys<S extends Schema> = {
+            [K in keyof S]: Helper.IsRequired<S[K]> extends true ? Helper.HasDefault<S[K]> extends false ? K : never : never;
+        }[keyof S];
+        type OptionalToProcessKeys<S extends Schema> = Exclude<keyof S, RequiredToProcessKeys<S>>;
+        export type schema<S extends Schema> = Helper.Prettify<{
+            [K in RequiredKeys<S>]: property<S[K]>;
+        } & {
+            [K in OptionalKeys<S>]?: property<S[K]>;
+        }>;
+        export type schemaToProcess<S extends Schema> = Helper.Prettify<{
+            [K in RequiredToProcessKeys<S>]: property<S[K], 'process'>;
+        } & {
+            [K in OptionalToProcessKeys<S>]?: property<S[K], 'process'>;
+        }>;
+        export type schemaPartial<S extends Schema> = Helper.Prettify<{
+            [K in keyof S]?: property<S[K], 'partial'>;
+        }>;
+        export type schemaBase<S extends Schema> = {
+            [K in keyof S]: property<S[K]>;
+        };
+        export {};
+    }
+}
+export default Schema;

package/build/utilities/schema/Schema.js

@@ -0,0 +1,241 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides a comprehensive schema validation and processing system, allowing developers to define complex data structures.
+ * @license Apache-2.0
+ */
+import _SchemaError from './SchemaError.js';
+import _JSONSchema from './JSONSchema.js';
+import _Introspection from './Introspection.js';
+import _Validator from './Validator.js';
+export { SchemaError } from './SchemaError.js';
+export { JSONSchema } from './JSONSchema.js';
+export { Introspection } from './Introspection.js';
+export { Validator } from './Validator.js';
+export class Schema {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+        Schema.Validator.validateStructure(schema);
+    }
+    /**
+     * Get the inferred type of the schema.
+     *
+     * ⚠️ IMPORTANT: This getter returns an EMPTY object. It is designed ONLY for type inference.
+     *
+     * Usage: Use with `typeof` to extract the inferred type:
+     * ```typescript
+     * type infered = typeof schemaInstance.infer;
+     * ```
+     *
+     * DO NOT use the returned value at runtime - it's always an empty object.
+     * This is purely a TypeScript type utility.
+     *
+     * @returns An empty object with the inferred type
+     */
+    get infer() {
+        return {};
+    }
+    /**
+     * Get the inferred type of the schema for processing (i.e., before applying defaults and handling optional properties).
+     *
+     * ⚠️ IMPORTANT: This getter returns an EMPTY object. It is designed ONLY for type inference.
+     *
+     * Usage: Use with `typeof` to extract the inferred type for processing:
+     * ```typescript
+     * type inferedToProcess = typeof schemaInstance.inferToProcess;
+     * ```
+     *
+     * DO NOT use the returned value at runtime - it's always an empty object.
+     * This is purely a TypeScript type utility.
+     */
+    get inferToProcess() {
+        return {};
+    }
+    /**
+     * get the json schema as an object
+     * @returns the json schema
+     */
+    get jsonSchema() { return this.toJsonSchema(); }
+    /**
+     * get the json schema as a JSON string
+     * @returns the json schema as a string
+     */
+    get jsonSchemaJSON() { return JSON.stringify(this.jsonSchema); }
+    /**
+     * get the list of unique keys
+     * @returns the list of unique keys
+     */
+    get uniques() { return this.listUniques(); }
+    processData(data, partial = false) {
+        const result = {};
+        const iterable = partial ? data : this.schema;
+        for (const key in iterable) {
+            if (!this.isKeyOf(this.schema, key))
+                throw new Schema.SchemaError(`Unknown property ${String(key)}`);
+            const prop = this.schema[key];
+            const value = this.isKeyOf(data, key) ? data[key] : undefined;
+            result[key] = this.processProperty(value, prop, key, partial);
+            if (result[key] === undefined)
+                delete result[key];
+        }
+        return result;
+    }
+    processPartialData(data) {
+        const result = {};
+        let currentProp;
+        for (const key in data) {
+            const value = this.isKeyOf(data, key) ? data[key] : undefined;
+            const subKeys = key.split('.');
+            const firstKey = subKeys.shift();
+            if (!firstKey || !(firstKey in this.schema))
+                throw new Schema.SchemaError(`Unknown property ${firstKey}`);
+            currentProp = this.schema[firstKey];
+            if (subKeys.length === 0)
+                result[key] = this.processProperty(value, currentProp, key);
+            else {
+                if (currentProp.type !== 'object')
+                    throw new Schema.SchemaError(`Property ${key} is not an object`);
+                let objectProp = currentProp;
+                let usedKeys = [];
+                for (const subKey of subKeys) {
+                    usedKeys.push(subKey);
+                    if (!(subKey in objectProp.schema))
+                        throw new Schema.SchemaError(`Unknown property ${firstKey}.${usedKeys.join('.')}`);
+                    currentProp = objectProp.schema[subKey];
+                    if (currentProp.type === 'object')
+                        objectProp = currentProp;
+                }
+                result[key] = this.processProperty(value, currentProp, key);
+            }
+            if (result[key] === undefined)
+                delete result[key];
+        }
+        return result;
+    }
+    /**
+     * process a property
+     * @param data the data to process
+     * @param prop the property to process
+     * @param key the key of the property
+     * @param partial if the data is partial
+     * @returns the processed data
+     * @throws schemaError if the data is not valid
+     */
+    processProperty(data, prop, key, partial = false) {
+        if (data === undefined || data === null) {
+            if ('default' in prop)
+                return prop.default;
+            if (prop.nullable && prop.nullable === true)
+                return null;
+            if (prop.required && prop.required === true)
+                throw new Schema.SchemaError(`Property ${key} is required but not provided`);
+            else
+                return undefined;
+        }
+        switch (prop.type) {
+            case 'string':
+                Schema.Validator.validateString(data, prop, key);
+                return data;
+            case 'number':
+                Schema.Validator.validateNumber(data, prop, key);
+                return data;
+            case 'boolean':
+                Schema.Validator.validateBoolean(data, prop, key);
+                return data;
+            case 'array':
+                Schema.Validator.validateArray(data, prop, key);
+                return this.processArray(data, prop, key);
+            case 'object':
+                Schema.Validator.validateObject(data, prop, key);
+                return this.processObject(data, prop, key, partial);
+            default: throw new Schema.SchemaError(`Unknown type in property ${key}`);
+        }
+    }
+    /**
+     * validate a array
+     * @param value the value to validate
+     * @param prop the property to validate
+     * @param key the key of the property
+     * @returns the data
+     * @throws schemaError if the data is not valid
+     */
+    processArray(value, prop, key) {
+        try {
+            return value.map((item, index) => this.processProperty(item, prop.property, `${key}[${index}]`));
+        }
+        catch (error) {
+            throw new Schema.SchemaError(`Property ${key} is not valid: ${error}`);
+        }
+    }
+    /**
+     * validate a object
+     * @param value the value to validate
+     * @param prop the property to validate
+     * @param key the key of the property
+     * @returns the data
+     * @throws schemaError if the data is not valid
+     */
+    processObject(value, prop, key, partial = false) {
+        const handler = new Schema(prop.schema);
+        try {
+            return handler.processData(value, partial);
+        }
+        catch (error) {
+            throw new Schema.SchemaError(`Property ${key} is not valid: ${error}`);
+        }
+    }
+    /**
+     * validate a array
+     * @param value the value to validate
+     * @param prop the property to validate
+     * @param key the key of the property
+     * @throws schemaError if the data is not valid
+     */
+    validateArray(value, prop, key) {
+        if (value == null && prop.nullable === true)
+            return;
+        if (!Array.isArray(value))
+            throw new Schema.SchemaError(`Property ${key} must be an array`);
+        if (prop.minimum !== undefined && value.length < prop.minimum) {
+            throw new Schema.SchemaError(`Property ${key} must have at least ${prop.minimum} items`);
+        }
+        if (prop.maximum !== undefined && value.length > prop.maximum) {
+            throw new Schema.SchemaError(`Property ${key} must have at most ${prop.maximum} items`);
+        }
+    }
+    /**
+     * generate a list of unique keys
+     * @param doc the schema to validate
+     * @param parentKey the parent key of the schema
+     * @returns a list of unique keys
+    */
+    listUniques(doc, parentKey) {
+        const useDoc = doc ?? this.schema;
+        return Schema.Introspection.listUniques(useDoc, parentKey);
+    }
+    /**
+     * convert a schema to a JSON schema
+     * @param schema the schema to convert
+     * @returns the JSON schema
+    */
+    toJsonSchema(schema) {
+        const useSchema = schema ?? this.schema;
+        return Schema.Introspection.toJsonSchema(useSchema);
+    }
+    /**
+     * -- TYPE GUARD --
+     * verify if the key is in the schema
+     * @param doc the object to verify
+     * @param key the key to verify
+     * @returns true if the key is in the schema
+     */
+    isKeyOf(doc, key) { return key in doc; }
+}
+(function (Schema) {
+    Schema.SchemaError = _SchemaError;
+    Schema.JSONSchema = _JSONSchema;
+    Schema.Introspection = _Introspection;
+    Schema.Validator = _Validator;
+})(Schema || (Schema = {}));
+export default Schema;
+//# sourceMappingURL=Schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.js","sourceRoot":"","sources":["../../../src/utilities/schema/Schema.ts"],"names":[],"mappings":"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"}

package/build/utilities/schema/SchemaError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Defines a custom error class for handling schema-related errors in the schema validation and processing system.
+ * @license Apache-2.0
+ */
+export declare class SchemaError extends Error {
+    constructor(message: string);
+}
+export declare namespace SchemaError { }
+export default SchemaError;

package/build/utilities/schema/SchemaError.js

@@ -0,0 +1,13 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Defines a custom error class for handling schema-related errors in the schema validation and processing system.
+ * @license Apache-2.0
+ */
+export class SchemaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'schemaError';
+    }
+}
+export default SchemaError;
+//# sourceMappingURL=SchemaError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaError.js","sourceRoot":"","sources":["../../../src/utilities/schema/SchemaError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AAED,eAAe,WAAW,CAAC"}

package/build/utilities/schema/Validator.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @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 type { Schema } from './Schema.js';
+export declare 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: Schema.Schema, parentKey?: string): void;
+    /**
+     * 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: Schema.property, key: string): void;
+    /**
+     * 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: Schema.property, key: string): void;
+    /**
+     * 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: Schema.Property.String, key: string): void;
+    /**
+     * 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: Schema.Property.Number, key: string): void;
+    /**
+     * 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: Schema.Property.Array, key: string): void;
+    /**
+     * 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: Schema.Property.Object, key: string): void;
+    /**
+     * 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: string, prop: Schema.Property.String, key: string): void;
+    /**
+     * 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: number, prop: Schema.Property.Number, key: string): void;
+    /**
+     * 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: boolean, prop: Schema.Property.Boolean, key: string): void;
+    /**
+     * 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: any, prop: Schema.Property.Object, key: string): void;
+    /**
+     * 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: any, prop: Schema.Property.Array, key: string): void;
+    /**
+     * 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: any, prop: Schema.property, key: string): void;
+}
+export declare namespace Validator { }
+export default Validator;