vortez 5.0.0-dev.18 → 5.0.0

package/build/utilities/Flatten.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @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.
+     * @param object - The object to flatten.
+     * @param depth - The maximum depth to flatten (default is 10).
+     * @returns A new object with flattened keys.
+     */
+    static object<T extends Flatten.Document, D extends number = 10>(object: T, depth?: D): Flatten.Object<T, D>;
+    /**
+     * Unflattens a flattened object back into its original nested structure.
+     * @param obj - The flattened object to unflatten.
+     * @returns A new object with the original nested structure.
+     */
+    static unObject<Result extends any = any>(obj: Flatten.Document): Result;
+    /**
+     * Core recursive function to flatten an object. It handles the actual flattening logic, while the public `object` method provides type safety and a cleaner interface.
+     * @param object - The object to flatten.
+     * @param depth - The remaining depth to flatten.
+     * @param prefix - The current key prefix for nested keys.
+     * @returns A flattened object with dot-notation keys.
+     */
+    private static flattenCore;
+    /**
+     * Checks if a value is a plain object (i.e., an object created by the Object constructor or with a null prototype). This is used to determine whether to flatten a value or treat it as a leaf.
+     * @param value - The value to check.
+     * @returns True if the value is a plain object, false otherwise.
+     */
+    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,76 @@
+/**
+ * @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.
+     * @param object - The object to flatten.
+     * @param depth - The maximum depth to flatten (default is 10).
+     * @returns A new object with flattened keys.
+     */
+    static object(object, depth = 10) {
+        return this.flattenCore(object, depth);
+    }
+    /**
+     * Unflattens a flattened object back into its original nested structure.
+     * @param obj - The flattened object to unflatten.
+     * @returns A new object with the original nested structure.
+     */
+    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;
+    }
+    /**
+     * Core recursive function to flatten an object. It handles the actual flattening logic, while the public `object` method provides type safety and a cleaner interface.
+     * @param object - The object to flatten.
+     * @param depth - The remaining depth to flatten.
+     * @param prefix - The current key prefix for nested keys.
+     * @returns A flattened object with dot-notation keys.
+     */
+    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;
+    }
+    /**
+     * Checks if a value is a plain object (i.e., an object created by the Object constructor or with a null prototype). This is used to determine whether to flatten a value or treat it as a leaf.
+     * @param value - The value to check.
+     * @returns True if the value is a plain object, false otherwise.
+     */
+    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;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAChB,MAAS,EACT,QAAW,EAAO;QAElB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAyB,CAAC;IACnE,CAAC;IAED;;;;OAIG;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;IACD;;;;;;OAMG;IACK,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;IACD;;;;OAIG;IACK,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/Object.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides utilities for deep object comparison and manipulation, such as checking for deep equality between objects. This is useful for comparing complex data structures in a way that goes beyond simple reference checks.
+ * @license Apache-2.0
+ */
+export declare class Object {
+    /**
+     * Compares two objects recursively for deep equality.
+     * @param obj1 - The first object to compare.
+     * @param obj2 - The second object to compare.
+     * @returns true if the objects are deeply equal, false otherwise.
+     */
+    static deepEqual(obj1: any, obj2: any): boolean;
+}
+export declare namespace Object { }
+export default Object;

package/build/utilities/Object.js

@@ -0,0 +1,48 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides utilities for deep object comparison and manipulation, such as checking for deep equality between objects. This is useful for comparing complex data structures in a way that goes beyond simple reference checks.
+ * @license Apache-2.0
+ */
+export class Object {
+    /**
+     * Compares two objects recursively for deep equality.
+     * @param obj1 - The first object to compare.
+     * @param obj2 - The second object to compare.
+     * @returns true if the objects are deeply equal, false otherwise.
+     */
+    static deepEqual(obj1, obj2) {
+        if (obj1 === obj2)
+            return true;
+        if (typeof obj1 !== typeof obj2 ||
+            obj1 === null || obj2 === null)
+            return false;
+        const isArray1 = Array.isArray(obj1);
+        const isArray2 = Array.isArray(obj2);
+        if (isArray1 || isArray2) {
+            if (!isArray1 || !isArray2)
+                return false;
+            if (obj1.length !== obj2.length)
+                return false;
+            for (let i = 0; i < obj1.length; i++) {
+                const hasIndex1 = i in obj1;
+                const hasIndex2 = i in obj2;
+                if (hasIndex1 !== hasIndex2)
+                    return false;
+                if (hasIndex1 && !this.deepEqual(obj1[i], obj2[i]))
+                    return false;
+            }
+            return true;
+        }
+        const keys1 = globalThis.Object.keys(obj1);
+        const keys2 = globalThis.Object.keys(obj2);
+        if (keys1.length !== keys2.length)
+            return false;
+        for (const key of keys1)
+            if (!keys2.includes(key) ||
+                !this.deepEqual(obj1[key], obj2[key]))
+                return false;
+        return true;
+    }
+}
+export default Object;
+//# sourceMappingURL=Object.js.map

package/build/utilities/Object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Object.js","sourceRoot":"","sources":["../../src/utilities/Object.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,MAAM;IACf;;;;;OAKG;IACI,MAAM,CAAC,SAAS,CAAC,IAAS,EAAE,IAAS;QACxC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,IACI,OAAO,IAAI,KAAK,OAAO,IAAI;YAC3B,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAChC,OAAO,KAAK,CAAC;QAEf,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACzC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC;gBAC5B,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC;gBAE5B,IAAI,SAAS,KAAK,SAAS;oBAAE,OAAO,KAAK,CAAC;gBAC1C,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;YACrE,CAAC;YAED,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,KAAK;YAAE,IACrB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACpB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvC,OAAO,KAAK,CAAC;QACf,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAGD,eAAe,MAAM,CAAC"}

package/build/utilities/Path.d.ts

@@ -1,24 +1,44 @@
 export declare class Path {
+    /** The directory where the Vortez module is located. */
     static readonly moduleDir: string;
-    static readonly moduleMain: string;
+    /** The directory where the user is running the server from. */
+    static readonly rootDir: string;
     /**
-     * Normalizes a path by replacing all backslashes with the system-specific separator.
-     * @param path - The path to clean.
-     * @returns The normalized path.
+     * Normalizes a file path by replacing multiple slashes with a single separator and ensuring consistent use of separators.
+     * @param path - The file path to normalize.
+     * @return The normalized file path.
      */
     static normalize(path: string): string;
     /**
-     * Converts a relative path to an absolute one, relative to the module root directory.
-     * @param path - The relative path.
-     * @returns The absolute path.
+     * Resolves an absolute path from the root of the user project.
+     * @param paths - The path to resolve.
+     * @return The resolved path.
      */
-    static relative(path: string): string;
+    static root(...paths: string[]): string;
     /**
-     * Gets the directory name of a path.
-     * @param path - The path to get the directory name from.
-     * @returns The directory name.
+     * Resolves an absolute path from the root of Vortez (internal).
+     * @param paths - The path to resolve.
+     * @return The resolved path.
+     */
+    static module(...paths: string[]): string;
+    /**
+     * Returns the directory name of a path, similar to `PATH.dirname`, but ensures the path is normalized first.
+     * @param path - The path to get the directory name of.
+     * @return The directory name of the path.
      */
     static dirname(path: string): string;
+    /**
+     * Joins multiple path segments into a single path, ensuring that the result is normalized.
+     * @param paths - The path segments to join.
+     * @return The joined path.
+     */
+    static join(...paths: string[]): string;
+    /**
+     * Resolves an absolute path from the root of the user project.
+     * @param paths - The path to resolve.
+     * @return The resolved path.
+     */
+    static resolve(...paths: string[]): string;
 }
 export declare namespace Path { }
 export default Path;

package/build/utilities/Path.js

@@ -1,36 +1,69 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides utilities for handling file paths, including normalization and resolution of paths relative to the module and user project.
+ * @license Apache-2.0
+ */
 import PATH from 'path';
 import URL from 'url';
 export class Path {
+    /** The directory where the Vortez module is located. */
     static moduleDir = PATH.dirname(PATH.dirname(PATH.dirname(URL.fileURLToPath(import.meta.url))));
-    static moduleMain = PATH.join(this.moduleDir, 'build/Vortez.js');
+    /** The directory where the user is running the server from. */
+    static rootDir = process.cwd();
     /**
-     * Normalizes a path by replacing all backslashes with the system-specific separator.
-     * @param path - The path to clean.
-     * @returns The normalized path.
+     * Normalizes a file path by replacing multiple slashes with a single separator and ensuring consistent use of separators.
+     * @param path - The file path to normalize.
+     * @return The normalized file path.
      */
     static normalize(path) {
-        path = path.replace(/[\\/]/gi, PATH.sep);
+        path = path.replace(/[\\/]+/g, PATH.sep);
         return path;
     }
     /**
-     * Converts a relative path to an absolute one, relative to the module root directory.
-     * @param path - The relative path.
-     * @returns The absolute path.
+     * Resolves an absolute path from the root of the user project.
+     * @param paths - The path to resolve.
+     * @return The resolved path.
      */
-    static relative(path) {
-        path = this.normalize(path);
-        path = PATH.join(this.moduleDir, path);
-        return PATH.normalize(path);
+    static root(...paths) {
+        paths = paths.map(path => this.normalize(path));
+        return PATH.join(this.rootDir, ...paths);
     }
     /**
-     * Gets the directory name of a path.
-     * @param path - The path to get the directory name from.
-     * @returns The directory name.
+     * Resolves an absolute path from the root of Vortez (internal).
+     * @param paths - The path to resolve.
+     * @return The resolved path.
+     */
+    static module(...paths) {
+        paths = paths.map(path => this.normalize(path));
+        return PATH.join(this.moduleDir, ...paths);
+    }
+    /**
+     * Returns the directory name of a path, similar to `PATH.dirname`, but ensures the path is normalized first.
+     * @param path - The path to get the directory name of.
+     * @return The directory name of the path.
      */
     static dirname(path) {
         path = this.normalize(path);
         return PATH.dirname(path);
     }
+    /**
+     * Joins multiple path segments into a single path, ensuring that the result is normalized.
+     * @param paths - The path segments to join.
+     * @return The joined path.
+     */
+    static join(...paths) {
+        paths = paths.map(path => this.normalize(path));
+        return PATH.join(...paths);
+    }
+    /**
+     * Resolves an absolute path from the root of the user project.
+     * @param paths - The path to resolve.
+     * @return The resolved path.
+     */
+    static resolve(...paths) {
+        paths = paths.map(path => this.normalize(path));
+        return PATH.resolve(...paths);
+    }
 }
 export default Path;
 //# sourceMappingURL=Path.js.map

package/build/utilities/Path.js.map

@@ -1 +1 @@
-{"version":3,"file":"Path.js","sourceRoot":"","sources":["../../src/utilities/Path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,OAAO,IAAI;IACN,MAAM,CAAU,SAAS,GAAW,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjH,MAAM,CAAU,UAAU,GAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACzF;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,IAAY;QAChC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC/B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,OAAO,CAAC,IAAY;QAC9B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;;AAGL,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Path.js","sourceRoot":"","sources":["../../src/utilities/Path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,OAAO,IAAI;IACb,wDAAwD;IACjD,MAAM,CAAU,SAAS,GAAW,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxH,+DAA+D;IACxD,MAAM,CAAU,OAAO,GAAW,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvD;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,IAAY;QAChC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAe;QACjC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,GAAG,KAAe;QACnC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,OAAO,CAAC,IAAY;QAC9B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAe;QACjC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,OAAO,CAAC,GAAG,KAAe;QACpC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAClC,CAAC;;AAGL,eAAe,IAAI,CAAC"}

package/build/utilities/Time.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides time-related utilities, such as sleep functions for delaying execution.
+ * @license Apache-2.0
+ */
+export declare class Time {
+    /**
+     * Converts a timestamp in milliseconds to seconds.
+     * @param timestamp - The timestamp in milliseconds to convert.
+     * @returns The equivalent timestamp in seconds.
+     */
+    static timestampToSecond(timestamp: number): number;
+    /**
+     * Pauses execution for a specified duration.
+     * @param ms - The number of milliseconds to sleep.
+     * @returns A promise that resolves after the given time.
+     */
+    static sleep(ms: number): Promise<void>;
+}
+export declare namespace Time { }
+export default Time;

package/build/utilities/Time.js

@@ -0,0 +1,25 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @description Provides time-related utilities, such as sleep functions for delaying execution.
+ * @license Apache-2.0
+ */
+export class Time {
+    /**
+     * Converts a timestamp in milliseconds to seconds.
+     * @param timestamp - The timestamp in milliseconds to convert.
+     * @returns The equivalent timestamp in seconds.
+     */
+    static timestampToSecond(timestamp) {
+        return Math.floor(timestamp / 1000);
+    }
+    /**
+     * Pauses execution for a specified duration.
+     * @param ms - The number of milliseconds to sleep.
+     * @returns A promise that resolves after the given time.
+     */
+    static sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+export default Time;
+//# sourceMappingURL=Time.js.map

package/build/utilities/Time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.js","sourceRoot":"","sources":["../../src/utilities/Time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,IAAI;IACb;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,SAAiB;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,EAAU;QAC1B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACJ;AAGD,eAAe,IAAI,CAAC"}

package/build/utilities/Utilities.d.ts

@@ -1,61 +1,84 @@
 /**
  * @author NetFeez <netfeez.dev@gmail.com>
- * @description add useful functions to the Vortez.
+ * @description Exports all utility classes and functions, providing a centralized access point for various helper methods used throughout the project.
+ * This includes:
+ * - file operations: `Utilities.File`.
+ * - object manipulation: `Utilities.Object`.
+ * - encoding: `Utilities.Encoding`.
+ * - time utilities: `Utilities.Time`.
+ * and more utilities.
  * @license Apache-2.0
  */
 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';
+import _File from './File.js';
+import _Object from './Object.js';
+import _Encoding from './Encoding.js';
+import _Time from './Time.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 { File } from './File.js';
+export { Object } from './Object.js';
+export { Encoding } from './Encoding.js';
+export { Time } from './Time.js';
 export declare class Utilities {
     /**
-     * Checks if a file exists asynchronously.
-     * @param path - The path to the file.
-     * @returns A promise that resolves to `true` if the file exists, `false` otherwise.
+     * Checks if a file exists at the given path.
+     * @param path - The file path to check.
+     * @returns A promise that resolves to true if the file exists, false otherwise.
+     * @deprecated Use Utilities.File.exists instead.
      */
     static fileExists(path: string): Promise<boolean>;
     /**
-     * Compares two objects recursively for deep equality.
-     * @param obj1 - The first object to compare.
-     * @param obj2 - The second object to compare.
-     * @returns A boolean indicating whether the objects are deeply equal or not.
+     * Checks if two values are deeply equal.
+     * @param obj1 - The first value to compare.
+     * @param obj2 - The second value to compare.
+     * @returns A boolean indicating if the values are deeply equal.
+     * @deprecated Use Utilities.Object.deepEqual instead.
      */
     static deepEqual(obj1: any, obj2: any): boolean;
     /**
-     * Flattens a nested object into a single-level object with dot notation keys.
+     * Flattens a nested object into a single-level object with dot-separated keys.
      * @param object - The object to flatten.
-     * @param depth - The maximum depth to which the object should be flattened.
-     * @returns The flattened object.
+     * @param depth - The maximum depth to flatten (default is 10).
+     * @returns A new object with flattened keys.
+     * @deprecated Use Utilities.Flatten.object instead.
      */
     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.
-     * @param obj - The flattened object to un flatten.
-     * @returns The unflattened object.
+     * Unflattens a flattened object back into its original nested structure.
+     * @param obj - The flattened object to unflatten.
+     * @returns A new object with the original nested structure.
+     * @deprecated Use Utilities.Flatten.unObject instead.
      */
     static unFlattenObject<Result extends any = any>(obj: any): Result;
     /**
-     * Pauses the execution of the program for a specified duration.
+     * Pauses execution for a specified duration.
      * @param ms - The number of milliseconds to sleep.
      * @returns A promise that resolves after the given time.
+     * @deprecated Use Utilities.Time.sleep instead.
      */
     static sleep(ms: number): Promise<void>;
     /**
      * Encodes a string to base64url format.
-     * @param data - The string that needs to be encoded.
+     * @param data - The string to encode.
      * @returns The base64url-encoded string.
+     * @deprecated Use Utilities.Encoding.base64UrlEncode instead.
      */
     static base64UrlEncode(data: string): string;
     /**
      * Decodes a base64url-encoded string.
-     * @param data - The base64url-encoded string that needs to be decoded.
-     * @returns The decoded string.
+     * @param data - The base64url-encoded string to decode.
+     * @returns The decoded UTF-8 string.
+     * @deprecated Use Utilities.Encoding.base64UrlDecode instead.
      */
     static base64UrlDecode(data: string): string;
 }
@@ -64,28 +87,19 @@ export declare namespace Utilities {
     export import Env = _Env;
     export import ConsoleUI = _ConsoleUI;
     export import DebugUI = _DebugUI;
+    export import Schema = _Schema;
+    export import Flatten = _Flatten;
+    export import File = _File;
+    export import Object = _Object;
+    export import Encoding = _Encoding;
+    export import Time = _Time;
     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;
-        /**
-         * Adds one to a number type.
-         * @template Number the number to add one to.
-         * @returns The number incremented by one.
-         */
         export type Inc<Number extends number | string> = (`${Number}` extends `${infer surPlus}${NumListAdd[number]}` ? `${Number}` extends `${surPlus}${infer unit extends number}` ? unit extends Exclude<NumListAdd[number], 9> ? strToNum<`${surPlus}${NumListAdd[unit]}`> : strToNum<`${surPlus extends `${infer Num extends number}` ? '' : '1'}${surPlus extends '' ? '' : Inc<surPlus>}${NumListAdd[unit]}`> : number : number);
-        /**
-         * Converts a union of object types into an intersection type.
-         * @template U the union to convert.
-         * @returns The intersection type of the given union.
-        */
         export 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);
-        /**
-         * Converts properties with `undefined` in an object type to optional properties.
-         * @template T the object to convert.
-         * @returns The object type with properties containing `undefined` marked as optional.
-         */
         export type undefinedToPartial<T extends object> = {
             [K in keyof T as undefined extends T[K] ? never : K]: T[K];
         } & {
@@ -96,63 +110,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;
     }