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

package/build/server/router/algorithm/Tree.js

@@ -0,0 +1,126 @@
+import Algorithm from './Algorithm.js';
+import FIFO from './FIFO.js';
+class RouteNode {
+    statics;
+    params;
+    wildcard;
+    rules;
+    constructor() {
+        this.statics = new Map();
+        this.rules = new FIFO();
+    }
+    get allRules() {
+        const rules = [...this.rules.allRules];
+        if (this.wildcard)
+            rules.push(...this.wildcard.allRules);
+        if (this.params)
+            rules.push(...this.params.node.allRules);
+        for (const node of this.statics.values())
+            rules.push(...node.allRules);
+        return rules;
+    }
+}
+export class Tree extends Algorithm {
+    root;
+    constructor() {
+        super();
+        this.root = new RouteNode();
+    }
+    get allRules() { return this.root.allRules; }
+    add(...rules) {
+        for (const rule of rules) {
+            const segments = this.splitPath(rule.urlRule);
+            let currentNode = this.root;
+            for (let index = 0; index < segments.length; index++) {
+                const segment = segments[index];
+                if (segment === '*') {
+                    currentNode.wildcard ??= new RouteNode();
+                    currentNode = currentNode.wildcard;
+                }
+                else if (segment.startsWith('$')) {
+                    const isOptional = segment.startsWith('$?');
+                    const paramName = segment.replace(/^\$\??/, '');
+                    if (isOptional && index === segments.length - 1) {
+                        currentNode.rules.add(rule);
+                        break;
+                    }
+                    currentNode.params ??= { name: paramName, isOptional, node: new RouteNode() };
+                    currentNode = currentNode.params.node;
+                }
+                else {
+                    if (!currentNode.statics.has(segment)) {
+                        currentNode.statics.set(segment, new RouteNode());
+                    }
+                    currentNode = currentNode.statics.get(segment);
+                }
+            }
+            currentNode.rules.add(rule);
+        }
+    }
+    /**
+     * Route a request to a rule.
+     * @param request - The request to route.
+     * @param client - The client to route the request to.
+     * @returns True if the request was routed, false otherwise.
+     */
+    routeHttp(request, client) {
+        request.ruleParams = {};
+        const node = this.navigate(request);
+        if (!node)
+            return false;
+        return node.rules.route(request, client);
+    }
+    /**
+     * Route a websocket to a rule.
+     * @param request - The request to route.
+     * @param client - The client to route the request to.
+     * @returns True if the request was routed, false otherwise.
+     */
+    routeWebsocket(request, client) {
+        request.ruleParams = {};
+        const node = this.navigate(request);
+        if (!node)
+            return false;
+        return node.rules.route(request, client);
+    }
+    /**
+     * Navigate to a route node.
+     * @param request - The request to navigate to.
+     * @returns The route node or null if not found.
+     */
+    navigate(request) {
+        const segments = this.splitPath(request.url);
+        let currentNode = this.root;
+        for (const segment of segments) {
+            if (currentNode.statics.has(segment)) {
+                currentNode = currentNode.statics.get(segment);
+            }
+            else if (currentNode.params) {
+                const { name, node } = currentNode.params;
+                request.ruleParams[name] = segment;
+                currentNode = node;
+            }
+            else if (currentNode.wildcard) {
+                currentNode = currentNode.wildcard;
+                break;
+            }
+            else if (currentNode.rules.allRules.some((rule) => rule.test(request))) {
+                return currentNode;
+            }
+            else
+                return null;
+        }
+        return currentNode;
+    }
+    /**
+     * Split a path into segments.
+     * @param path - The path to split.
+     * @returns An array of segments.
+     */
+    splitPath(path) {
+        return path.split('/').filter(p => p.length > 0);
+    }
+}
+;
+export default Tree;
+//# sourceMappingURL=Tree.js.map

package/build/server/router/algorithm/Tree.js.map

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

package/build/server/router/middleware/WsMiddleware.js

@@ -8,7 +8,7 @@ import LoggerManager from '../../LoggerManager.js';
 import Middleware from './Middleware.js';
 const logger = LoggerManager.getInstance();
 export class WsMiddleware extends Middleware {
-    clone() { return new WsMiddleware(this.pipeline); }
+    clone() { return new WsMiddleware(this.pipeline, this.errorPipeline); }
     /**
      * Runs the middleware pipeline.
      * @param request The request received by the server.

package/build/server/router/middleware/WsMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"WsMiddleware.js","sourceRoot":"","sources":["../../../../src/server/router/middleware/WsMiddleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WsMiddleware.js","sourceRoot":"","sources":["../../../../src/server/router/middleware/WsMiddleware.ts"],"names":[],"mappings":"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"}

package/build/utilities/Flatten.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides flatten/unflatten helpers with strong TypeScript typing.
+ * @license Apache-2.0
+ */
+export declare class Flatten {
+    /**
+     * Flattens a nested plain-object into dot-notation keys.
+     * Non-plain objects (Date, RegExp, Map, Set, etc.) are treated as leaf values.
+     */
+    static object<T extends Flatten.Document, D extends number = 10>(object: T, depth?: D): Flatten.Object<T, D>;
+    /**
+     * Reconstructs a nested object from dot-notation keys.
+     */
+    static unObject<Result extends any = any>(obj: Flatten.Document): Result;
+    private static flattenCore;
+    private static isPlainObject;
+}
+export declare namespace Flatten {
+    export type Document = {
+        [key: string]: any;
+    };
+    type Prettify<T> = {
+        [K in keyof T]: T[K];
+    } & {};
+    type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+    type Builtin = Primitive | Date | RegExp | Function | Error | Promise<any> | Map<any, any> | Set<any> | WeakMap<any, any> | WeakSet<any>;
+    type IsLeaf<T> = T extends Builtin ? true : T extends readonly any[] ? true : false;
+    type UndefinedToPartial<T extends object> = {
+        [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+    } & {
+        [K in keyof T as undefined extends T[K] ? K : never]?: Exclude<T[K], undefined>;
+    };
+    type UnionToIntersection<U extends object> = ((U extends any ? (arg: U) => void : never) extends (arg: infer I) => void ? I extends object ? {
+        [K in keyof I]: I[K] extends object ? UnionToIntersection<I[K]> : I[K];
+    } : I : never);
+    type DepthTuple<Depth extends number, Current extends 1[] = []> = (number extends Depth ? [1, 1, 1, 1, 1] : Current['length'] extends Depth ? Current : DepthTuple<Depth, [1, ...Current]>);
+    type NextDepth<D extends 1[]> = D extends [1, ...infer R extends 1[]] ? R : [];
+    type Join<Prefix extends string, Key extends string> = Prefix extends '' ? Key : `${Prefix}.${Key}`;
+    type ResourceKeys<T extends Document, D extends 1[] = DepthTuple<5>, Prefix extends string = ''> = {
+        [K in Extract<keyof T, string>]-?: (Exclude<T[K], undefined> extends infer U ? IsLeaf<U> extends true ? Join<Prefix, K> : U extends Document ? D extends [] ? Join<Prefix, K> : ResourceKeys<U, NextDepth<D>, Join<Prefix, K>> : Join<Prefix, K> : never);
+    }[Extract<keyof T, string>];
+    type RecurseObject<T extends Document, Keys extends string> = (Keys extends `${infer K}.${infer Rest}` ? K extends keyof T ? Extract<Exclude<T[K], undefined>, Document> extends infer Nested ? [Nested] extends [never] ? never : (RecurseObject<Nested & Document, Rest> | (undefined extends T[K] ? undefined : never) | (null extends T[K] ? undefined : never)) : never : never : undefined extends T ? Keys extends keyof Exclude<T, undefined> ? Exclude<T, undefined>[Keys] | undefined : never : Keys extends keyof T ? T[Keys] : never);
+    export type Object<T extends Document, depth extends number = 5> = Prettify<UndefinedToPartial<{
+        [P in ResourceKeys<T, DepthTuple<depth>>]: RecurseObject<T, P>;
+    }>>;
+    type Split<S extends string, Delimiter extends string> = (S extends `${infer T}${Delimiter}${infer U}` ? [T, ...Split<U, Delimiter>] : [S]);
+    type BuildNestedObject<Path extends string[], Value> = (Path extends [infer Head extends string, ...infer Tail extends string[]] ? UndefinedToPartial<{
+        [K in Head]: BuildNestedObject<Tail, Value>;
+    }> : Value);
+    export type UnObject<T extends Document> = Prettify<UnionToIntersection<UndefinedToPartial<({
+        [K in keyof T]-?: BuildNestedObject<Split<Extract<K, string>, '.'>, T[K]>;
+    }[keyof T])>>>;
+    export {};
+}
+export default Flatten;

package/build/utilities/Flatten.js

@@ -0,0 +1,59 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides flatten/unflatten helpers with strong TypeScript typing.
+ * @license Apache-2.0
+ */
+export class Flatten {
+    /**
+     * Flattens a nested plain-object into dot-notation keys.
+     * Non-plain objects (Date, RegExp, Map, Set, etc.) are treated as leaf values.
+     */
+    static object(object, depth = 10) {
+        return this.flattenCore(object, depth);
+    }
+    /**
+     * Reconstructs a nested object from dot-notation keys.
+     */
+    static unObject(obj) {
+        const result = {};
+        for (const key in obj) {
+            const value = obj[key];
+            const [first, ...rest] = key.split('.');
+            if (rest.length === 0)
+                result[first] = value;
+            else {
+                const last = rest.pop();
+                const subObj = result[first] ?? {};
+                let current = subObj;
+                rest.forEach((k) => {
+                    current = current[k] ?? (current[k] = {});
+                });
+                current[last] = value;
+                result[first] = subObj;
+            }
+        }
+        return result;
+    }
+    static flattenCore(object, depth = 10, prefix = '') {
+        const result = {};
+        for (const key in object) {
+            const newKey = prefix ? `${prefix}.${key}` : key;
+            const value = object[key];
+            if (depth > 0 && this.isPlainObject(value)) {
+                Object.assign(result, this.flattenCore(value, depth - 1, newKey));
+            }
+            else {
+                result[newKey] = value;
+            }
+        }
+        return result;
+    }
+    static isPlainObject(value) {
+        if (value == null || typeof value !== 'object' || Array.isArray(value))
+            return false;
+        const proto = Object.getPrototypeOf(value);
+        return proto === Object.prototype || proto === null;
+    }
+}
+export default Flatten;
+//# sourceMappingURL=Flatten.js.map

package/build/utilities/Flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flatten.js","sourceRoot":"","sources":["../../src/utilities/Flatten.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,OAAO;IAChB;;;OAGG;IACI,MAAM,CAAC,MAAM,CAChB,MAAS,EACT,QAAW,EAAO;QAElB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAyB,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,CAA2B,GAAqB;QAClE,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;iBACxC,CAAC;gBACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAY,CAAC;gBAClC,MAAM,MAAM,GAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,OAAO,GAAQ,MAAM,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;oBACf,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACtB,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;YAC3B,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,MAAwB,EAAE,QAAgB,EAAE,EAAE,SAAiB,EAAE;QACxF,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACtE,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,KAAc;QACvC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACrF,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;IACxD,CAAC;CACJ;AAsGD,eAAe,OAAO,CAAC"}

package/build/utilities/Utilities.d.ts

@@ -7,10 +7,14 @@ import _Path from './Path.js';
 import _Env from './Env.js';
 import _ConsoleUI from './ConsoleUI.js';
 import _DebugUI from './DebugUI.js';
+import _Schema from './schema/Schema.js';
+import _Flatten from './Flatten.js';
 export { Path } from './Path.js';
 export { Env } from './Env.js';
 export { ConsoleUI } from './ConsoleUI.js';
 export { DebugUI } from './DebugUI.js';
+export { Schema } from './schema/Schema.js';
+export { Flatten } from './Flatten.js';
 export declare class Utilities {
     /**
      * Checks if a file exists asynchronously.
@@ -32,7 +36,6 @@ export declare class Utilities {
      * @returns The flattened object.
      */
     static flattenObject<T extends object, D extends number = 10>(object: T, depth?: D): Utilities.Flatten.Object<T, D>;
-    private static flattenCore;
     /**
      * Reconstructs a nested object from a flattened object with dot notation keys.
      * @template Result - The type of the unflattened object.
@@ -64,6 +67,8 @@ export declare namespace Utilities {
     export import Env = _Env;
     export import ConsoleUI = _ConsoleUI;
     export import DebugUI = _DebugUI;
+    export import Schema = _Schema;
+    export import Flatten = _Flatten;
     namespace Types {
         type NumListAdd = [1, 2, 3, 4, 5, 6, 7, 8, 9, 0];
         type strToNum<str extends string> = str extends `${infer num extends number}` ? num : never;
@@ -96,63 +101,7 @@ export declare namespace Utilities {
         };
         export {};
     }
-    namespace Flatten {
-        /**
-         * Generates a union of all possible flattened keys for a given object type and depth.
-         * @template T the object to flatten.
-         * @template depth - The maximum depth to flatten.
-         * @template index - The current recursion index (internal use).
-         * @returns A union type of the flattened keys.
-         */
-        type ResourceKeys<T extends Types.Document, depth extends number = 5, index extends number = 1> = {
-            [K in keyof T]-?: depth extends index ? K & string : Exclude<T[K], undefined> extends infer U ? U extends any[] ? K & string : U extends object ? `${K & string}.${ResourceKeys<U, depth, Types.Inc<index>>}` : K & string : "fail_in_flatten_inference";
-        }[keyof T];
-        /**
-         * Recursively retrieves the type of a value based on a flattened key path.
-         * @template T the object to flatten.
-         * @template Keys - The flattened key path string.
-         * @returns The type of the value at the specified key path, or `never` if the path is invalid.
-         */
-        type RecurseObject<T extends Types.Document, Keys extends string> = (Keys extends `${infer K}.${infer Rest}` ? K extends keyof T ? undefined extends T[K] ? RecurseObject<Exclude<T[K], undefined>, Rest> | undefined : RecurseObject<T[K], Rest> : never : undefined extends T ? Keys extends keyof Exclude<T, undefined> ? Exclude<T, undefined>[Keys] | undefined : never : Keys extends keyof T ? T[Keys] : never);
-        /**
-         * Represents the type of a flattened object up to a specified depth.
-         * @template T the object to flatten.
-         * @template depth - The maximum depth of flattening.
-         * @template index the current index.
-         * @returns the flattened object.
-         */
-        export type Object<T extends Types.Document, depth extends number = 5, index extends number = 1> = Types.undefinedToPartial<{
-            [P in ResourceKeys<T, depth, index>]: RecurseObject<T, P>;
-        }>;
-        export {};
-    }
-    namespace UnFlatten {
-        /**
-         * Splits a string into a tuple of strings based on a delimiter.
-         * @template S - The string to split.
-         * @template Delimiter - The delimiter to split by.
-         * @returns the split string.
-         */
-        type Split<S extends string, Delimiter extends string> = (S extends `${infer T}${Delimiter}${infer U}` ? [T, ...Split<U, Delimiter>] : [S]);
-        /**
-         * Builds a nested object type from a string path and a value type.
-         * @template Path - The path of keys as a string array.
-         * @template Value - The type of the value at the end of the path.
-         * @returns the nested object.
-         */
-        type BuildNestedObject<Path extends string[], Value> = (Path extends [infer Head extends string, ...infer Tail extends string[]] ? Types.undefinedToPartial<{
-            [K in Head]: BuildNestedObject<Tail, Value>;
-        }> : Value);
-        /**
-         * Represents the type of a nested object reconstructed from a flattened object.
-         * @template T - The type of the flattened object.
-         * @returns the unFlattened object.
-         */
-        export type Object<T extends Types.Document> = Types.UnionToIntersection<Types.undefinedToPartial<({
-            [K in keyof T]-?: BuildNestedObject<Split<Extract<K, string>, ".">, T[K]>;
-        }[keyof T])>>;
-        export {};
-    }
+    type FlattenObject<T extends Types.Document, depth extends number = 5> = Flatten.Object<T, depth>;
     interface env {
         [key: string]: string;
     }

package/build/utilities/Utilities.js

@@ -8,10 +8,14 @@ import _Path from './Path.js';
 import _Env from './Env.js';
 import _ConsoleUI from './ConsoleUI.js';
 import _DebugUI from './DebugUI.js';
+import _Schema from './schema/Schema.js';
+import _Flatten from './Flatten.js';
 export { Path } from './Path.js';
 export { Env } from './Env.js';
 export { ConsoleUI } from './ConsoleUI.js';
 export { DebugUI } from './DebugUI.js';
+export { Schema } from './schema/Schema.js';
+export { Flatten } from './Flatten.js';
 export class Utilities {
     /**
      * Checks if a file exists asynchronously.
@@ -50,21 +54,7 @@ export class Utilities {
      * @returns The flattened object.
      */
     static flattenObject(object, depth = 10) {
-        return this.flattenCore(object, depth);
-    }
-    static flattenCore(object, depth = 10, prefix = '') {
-        const result = {};
-        for (const key in object) {
-            const newKey = prefix ? `${prefix}.${key}` : key;
-            const value = object[key];
-            if (typeof value === 'object' && !Array.isArray(value) && value !== null && depth > 0) {
-                Object.assign(result, Utilities.flattenCore(value, depth - 1, newKey));
-            }
-            else {
-                result[newKey] = value;
-            }
-        }
-        return result;
+        return Utilities.Flatten.object(object, depth);
     }
     /**
      * Reconstructs a nested object from a flattened object with dot notation keys.
@@ -73,24 +63,7 @@ export class Utilities {
      * @returns The unflattened object.
      */
     static unFlattenObject(obj) {
-        const result = {};
-        for (const key in obj) {
-            const value = obj[key];
-            const [first, ...rest] = key.split('.');
-            if (rest.length === 0)
-                result[first] = value;
-            else {
-                const last = rest.pop();
-                const subObj = result[first] ?? {};
-                let current = subObj;
-                rest.forEach((k) => {
-                    current = current[k] ?? (current[k] = {});
-                });
-                current[last] = value;
-                result[first] = subObj;
-            }
-        }
-        return result;
+        return Utilities.Flatten.unObject(obj);
     }
     /**
      * Pauses the execution of the program for a specified duration.
@@ -122,6 +95,8 @@ export class Utilities {
     Utilities.Env = _Env;
     Utilities.ConsoleUI = _ConsoleUI;
     Utilities.DebugUI = _DebugUI;
+    Utilities.Schema = _Schema;
+    Utilities.Flatten = _Flatten;
 })(Utilities || (Utilities = {}));
 export default Utilities;
 //# sourceMappingURL=Utilities.js.map

package/build/utilities/Utilities.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides utilities for schema introspection, including listing unique properties and converting custom schemas to JSON Schema format.
+ * @license Apache-2.0
+ */
+import type { JSONSchema } from './JSONSchema.js';
+import type { Schema } from './Schema.js';
+export declare class Introspection {
+    /**
+     * Lists all unique properties in a schema, including nested unique properties, and returns their full paths.
+     * @param doc The schema to list unique properties from
+     * @param parentKey The parent key of the current schema, used for building full paths of nested properties
+     * @returns An array of full paths to unique properties in the schema
+     */
+    static listUniques(doc: Schema.Schema, parentKey?: string): string[];
+    /**
+     * Converts a schema to a JSON Schema, used for validating data against the schema and generating documentation.
+     * @param schema The schema to convert to JSON Schema
+     * @returns The JSON Schema representation of the input schema
+     */
+    static toJsonSchema(schema: Schema.Schema): JSONSchema.schema;
+}
+export declare namespace Introspection { }
+export default Introspection;

package/build/utilities/schema/Introspection.js

@@ -0,0 +1,87 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides utilities for schema introspection, including listing unique properties and converting custom schemas to JSON Schema format.
+ * @license Apache-2.0
+ */
+export class Introspection {
+    /**
+     * Lists all unique properties in a schema, including nested unique properties, and returns their full paths.
+     * @param doc The schema to list unique properties from
+     * @param parentKey The parent key of the current schema, used for building full paths of nested properties
+     * @returns An array of full paths to unique properties in the schema
+     */
+    static listUniques(doc, parentKey) {
+        const uniques = [];
+        for (const key in doc) {
+            const prop = doc[key];
+            if (key !== '_id' && prop.unique)
+                uniques.push(parentKey ? `${parentKey}.${key}` : key);
+            if (prop.type === 'object') {
+                uniques.push(...this.listUniques(prop.schema, parentKey ? `${parentKey}.${key}` : key));
+            }
+        }
+        return uniques;
+    }
+    /**
+     * Converts a schema to a JSON Schema, used for validating data against the schema and generating documentation.
+     * @param schema The schema to convert to JSON Schema
+     * @returns The JSON Schema representation of the input schema
+     */
+    static toJsonSchema(schema) {
+        const sch = {};
+        sch.type = 'object';
+        sch.properties = {};
+        for (const key in schema) {
+            const prop = schema[key];
+            let subSch = {};
+            subSch.type = prop.nullable ? [prop.type, 'null'] : prop.type;
+            if (prop.required) {
+                if (sch.required == null)
+                    sch.required = [];
+                sch.required.push(key);
+            }
+            switch (prop.type) {
+                case 'string': {
+                    if (prop.enum !== undefined)
+                        subSch.enum = [...prop.enum];
+                    if (prop.minLength !== undefined)
+                        subSch.minLength = prop.minLength;
+                    if (prop.maxLength !== undefined)
+                        subSch.maxLength = prop.maxLength;
+                    if (prop.pattern !== undefined)
+                        subSch.pattern = prop.pattern.source;
+                    break;
+                }
+                case 'boolean': break;
+                case 'number': {
+                    if (prop.minimum !== undefined)
+                        subSch.minimum = prop.minimum;
+                    if (prop.maximum !== undefined)
+                        subSch.maximum = prop.maximum;
+                    break;
+                }
+                case 'array': {
+                    if (prop.minimum !== undefined)
+                        subSch.minItems = prop.minimum;
+                    if (prop.maximum !== undefined)
+                        subSch.maxItems = prop.maximum;
+                    const itemContainer = this.toJsonSchema({ item: prop.property });
+                    const itemSchema = itemContainer.properties?.item;
+                    if (itemSchema)
+                        subSch.items = itemSchema;
+                    break;
+                }
+                case 'object': {
+                    subSch = this.toJsonSchema(prop.schema);
+                    if (prop.nullable)
+                        subSch.type = ['object', 'null'];
+                    break;
+                }
+            }
+            sch.properties[key] = subSch;
+        }
+        return sch;
+    }
+}
+export default Introspection;
+//# sourceMappingURL=Introspection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Introspection.js","sourceRoot":"","sources":["../../../src/utilities/schema/Introspection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,OAAO,aAAa;IACtB;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,GAAkB,EAAE,SAAkB;QAC5D,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,GAAG,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxF,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5F,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,YAAY,CAAC,MAAqB;QAC5C,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;QACpB,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,MAAM,GAAsB,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI;oBAAE,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC;gBAC5C,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YACD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACZ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;wBAAE,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;wBAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;oBACpE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;wBAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;oBACpE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;wBAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;oBACrE,MAAM;gBACV,CAAC;gBACD,KAAK,SAAS,CAAC,CAAC,MAAM;gBACtB,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACZ,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;wBAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;oBAC9D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;wBAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;oBAC9D,MAAM;gBACV,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACX,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;wBAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;oBAC/D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;wBAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;oBAE/D,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACjE,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC;oBAClD,IAAI,UAAU;wBAAE,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC;oBAC1C,MAAM;gBACV,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACZ,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACxC,IAAI,IAAI,CAAC,QAAQ;wBAAE,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBACpD,MAAM;gBACV,CAAC;YACL,CAAC;YACD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ;AAED,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,68 @@
+/**
+ * @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
+ */
+export declare namespace JSONSchema {
+    type schemeArray = schemeTypes[];
+    type schemaObject = {
+        [key: string]: schemeTypes;
+    };
+    interface SchemaTypeMap {
+        string: string;
+        number: number;
+        boolean: boolean;
+        object: schemaObject;
+        array: schemeArray;
+        null: null;
+    }
+    type schemaNames = keyof SchemaTypeMap;
+    type schemeTypes = SchemaTypeMap[schemaNames];
+    type schemaVersion = string;
+    type schema = {
+        title?: string;
+        description?: string;
+        multipleOf?: number;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        additionalItems?: schema;
+        items?: schema | schema[];
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+        maxProperties?: number;
+        minProperties?: number;
+        required?: string[];
+        properties?: {
+            [key: string]: schema;
+        };
+        additionalProperties?: boolean | schema;
+        patternProperties?: {
+            [key: string]: schema;
+        };
+        dependencies?: {
+            [key: string]: string[] | schema;
+        };
+        enum?: schemeTypes[];
+        type?: schemaNames | schemaNames[];
+        allOf?: schema[];
+        anyOf?: schema[];
+        oneOf?: schema[];
+        not?: schema;
+        extends?: string | string[];
+    };
+}
+/**
+ * provide the type definition of a json schema
+ * @param schema the json schema to validate
+ */
+export declare function schema(schema: JSONSchema.schema): JSONSchema.schema;
+export declare const JSONSchema: {
+    schema: typeof schema;
+};
+export default JSONSchema;