vortez 5.0.2 → 6.0.0-dev.1

package/build/utilities/Env.d.ts

@@ -1,81 +0,0 @@
-export declare class Env {
-    /**
-     * Gets all current environment variables.
-     * @returns An object containing key-value pairs of environment variables.
-     */
-    static get data(): Env.EnvList;
-    /**
-     * Load the environment variables from the given path.
-     * @param path - The path to the environment variables file.
-     * @param options - Options to load the environment variables.
-     * @returns A promise that resolves with the loaded environment variables as an object.
-     * @throws Error if the environment variables file does not exist and cannot be created.
-     * @throws Error if the environment variables file is not readable.
-     */
-    static load(path: string, options?: Env.LoadOptions): Promise<Env.EnvList>;
-    /**
-     * Load the environment variables from the given path synchronously.
-     * @param path - The path to the environment variables file.
-     * @param options - Options to load the environment variables.
-     * @returns The loaded environment variables as an object.
-     * @throws Error if the environment variables file does not exist and cannot be created.
-     * @throws Error if the environment variables file is not readable.
-     */
-    static loadSync(path: string, options?: Env.LoadOptions): Env.EnvList;
-    /**
-     * Extract the environment variables from the given content.
-     * @param content - The content to extract the environment variables from.
-     * @param defaultEnv - An optional object of default environment variables to include if not present in the content.
-     * @returns An object containing the extracted environment variables merged with defaults.
-     */
-    private static extractEnv;
-    /**
-     * Get the value of an environment variable.
-     * @param key - The key of the environment variable to get.
-     * @param options - Options to get the environment variable.
-     * @param options.default - The default value to return if the environment variable is not set.
-     * @param options.warning - If `true`, a warning will be logged if the environment variable is not set.
-     * @returns The value of the environment variable or undefined if not set.
-     */
-    static get(key: string, options: Env.getOptionsGranted): string;
-    static get(key: string, options: Env.getOptions): string | undefined;
-    /**
-     * Set an environment variable.
-     * @param key - The key of the environment variable to set.
-     * @param value - The value to set for the environment variable.
-     */
-    static set(key: string, value: string): void;
-    /**
-     * Sets multiple environment variables from an object.
-     * @param env - An object containing key-value pairs of environment variables to set.
-     */
-    static setMany(env: Env.EnvList): void;
-    /**
-     * Delete an environment variable.
-     * @param key - The key of the environment variable to delete.
-     */
-    static delete(key: string): void;
-    /**
-     * Convert an EnvList to a .env-formatted string.
-     * @param env - The environment variables object.
-     * @returns A string in .env format.
-     */
-    static toEnv(env: Env.EnvList): string;
-}
-export declare namespace Env {
-    interface EnvList {
-        [key: string]: string | undefined;
-    }
-    interface LoadOptions {
-        setEnv?: boolean;
-        defaultEnv?: EnvList;
-    }
-    interface getOptions {
-        default?: string;
-        warning?: boolean;
-    }
-    type getOptionsGranted = getOptions & {
-        default: string;
-    };
-}
-export default Env;

package/build/utilities/Env.js

@@ -1,140 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Provides utilities for environment variable management, including loading from .env files, getting and setting environment variables, and converting objects to .env format. This is useful for managing configuration in a flexible way that can be easily integrated into different environments.
- * @license Apache-2.0
- */
-import FS, { promises as FSP } from "fs";
-import PATH from "path";
-import Debug from "../logger/Debug.js";
-import File from './File.js';
-export class Env {
-    /**
-     * Gets all current environment variables.
-     * @returns An object containing key-value pairs of environment variables.
-     */
-    static get data() { return process.env; }
-    /**
-     * Load the environment variables from the given path.
-     * @param path - The path to the environment variables file.
-     * @param options - Options to load the environment variables.
-     * @returns A promise that resolves with the loaded environment variables as an object.
-     * @throws Error if the environment variables file does not exist and cannot be created.
-     * @throws Error if the environment variables file is not readable.
-     */
-    static async load(path, options = {}) {
-        Debug.log(`loading environment variables from &C6[${path}]`);
-        const defaultEnv = options.defaultEnv ?? {};
-        const setEnv = options.setEnv ?? true;
-        if (!await File.exists(path)) {
-            try {
-                Debug.log(`environment variables file &C6[${path}]&R does not exist, creating it`);
-                await FSP.mkdir(PATH.dirname(path), { recursive: true });
-                const env = this.toEnv(defaultEnv);
-                await FSP.writeFile(path, env, 'utf-8');
-                Debug.log(`environment variables file &C6[${path}]&R &C2was created successfully`);
-            }
-            catch (error) {
-                Debug.log(`environment variables file &C6[${path}]&R &C1could not be created`);
-                throw error;
-            }
-        }
-        const env = await FSP.readFile(path, 'utf-8');
-        const result = this.extractEnv(env, defaultEnv);
-        if (setEnv)
-            this.setMany(result);
-        Debug.log(`environment variables loaded from &C6[${path}]`);
-        return result;
-    }
-    /**
-     * Load the environment variables from the given path synchronously.
-     * @param path - The path to the environment variables file.
-     * @param options - Options to load the environment variables.
-     * @returns The loaded environment variables as an object.
-     * @throws Error if the environment variables file does not exist and cannot be created.
-     * @throws Error if the environment variables file is not readable.
-     */
-    static loadSync(path, options = {}) {
-        Debug.log(`loading environment variables from &C6[${path}]`);
-        const defaultEnv = options.defaultEnv ?? {};
-        const setEnv = options.setEnv ?? true;
-        if (!FS.existsSync(path)) {
-            FS.mkdirSync(PATH.dirname(path), { recursive: true });
-            const env = this.toEnv(defaultEnv);
-            FS.writeFileSync(path, env, 'utf-8');
-            Debug.log(`environment variables file &C6[${path}]&R does not exist, creating it`);
-        }
-        const env = FS.readFileSync(path, 'utf-8');
-        const result = this.extractEnv(env, defaultEnv);
-        if (setEnv)
-            this.setMany(result);
-        Debug.log(`environment variables loaded from &C6[${path}]`);
-        return result;
-    }
-    /**
-     * Extract the environment variables from the given content.
-     * @param content - The content to extract the environment variables from.
-     * @param defaultEnv - An optional object of default environment variables to include if not present in the content.
-     * @returns An object containing the extracted environment variables merged with defaults.
-     */
-    static extractEnv(content, defaultEnv = {}) {
-        const lines = content.split('\n');
-        const result = { ...defaultEnv };
-        for (const line of lines) {
-            const trimmedLine = line.trim();
-            if (!trimmedLine || trimmedLine.startsWith('#'))
-                continue;
-            const index = trimmedLine.indexOf('=');
-            if (index === -1)
-                continue;
-            const key = trimmedLine.substring(0, index).trim();
-            const value = trimmedLine.substring(index + 1).trim();
-            if (!key)
-                continue;
-            result[key] = value;
-        }
-        return result;
-    }
-    static get(key, options = {}) {
-        const value = process.env[key];
-        if (value)
-            return value;
-        const { default: defaultVal, warning = false } = options;
-        if (warning)
-            Debug.log(`&B3[warn]:&R &C6${key} &C3is not defined${defaultVal ? `, &C2using: &C6${defaultVal}` : ''}`);
-        return defaultVal;
-    }
-    /**
-     * Set an environment variable.
-     * @param key - The key of the environment variable to set.
-     * @param value - The value to set for the environment variable.
-     */
-    static set(key, value) {
-        process.env[key] = value;
-    }
-    /**
-     * Sets multiple environment variables from an object.
-     * @param env - An object containing key-value pairs of environment variables to set.
-     */
-    static setMany(env) {
-        for (const key in env)
-            process.env[key] = env[key] ?? '';
-    }
-    /**
-     * Delete an environment variable.
-     * @param key - The key of the environment variable to delete.
-     */
-    static delete(key) {
-        delete process.env[key];
-    }
-    /**
-     * Convert an EnvList to a .env-formatted string.
-     * @param env - The environment variables object.
-     * @returns A string in .env format.
-     */
-    static toEnv(env) {
-        const filtered = Object.entries(env).filter(([key, value]) => typeof key === 'string' && typeof value === 'string');
-        return filtered.map(([key, value]) => `${key}=${value}`).join('\n');
-    }
-}
-export default Env;
-//# sourceMappingURL=Env.js.map

package/build/utilities/Env.js.map

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

package/build/utilities/File.d.ts

@@ -1,10 +0,0 @@
-export declare class File {
-    /**
-     * 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.
-     */
-    static exists(path: string): Promise<boolean>;
-}
-export declare namespace File { }
-export default File;

package/build/utilities/File.js

@@ -1,19 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Provides utilities for file operations, such as checking if a file exists.
- * This is useful for performing asynchronous file checks in a way that integrates well with modern JavaScript practices.
- * @license Apache-2.0
- */
-import { promises as FSP } from 'fs';
-export class File {
-    /**
-     * 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.
-     */
-    static async exists(path) {
-        return FSP.access(path).then(() => true).catch(() => false);
-    }
-}
-export default File;
-//# sourceMappingURL=File.js.map

package/build/utilities/File.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"File.js","sourceRoot":"","sources":["../../src/utilities/File.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC;AAErC,MAAM,OAAO,IAAI;IACb;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAY;QACnC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;CACJ;AAGD,eAAe,IAAI,CAAC"}

package/build/utilities/Flatten.d.ts

@@ -1,73 +0,0 @@
-/**
- * @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

@@ -1,76 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,16 +0,0 @@
-/**
- * @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

@@ -1,48 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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,44 +0,0 @@
-export declare class Path {
-    /** The directory where the Vortez module is located. */
-    static readonly moduleDir: string;
-    /** The directory where the user is running the server from. */
-    static readonly rootDir: string;
-    /**
-     * 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;
-    /**
-     * Resolves an absolute path from the root of the user project.
-     * @param paths - The path to resolve.
-     * @return The resolved path.
-     */
-    static root(...paths: string[]): string;
-    /**
-     * 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,69 +0,0 @@
-/**
- * @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))));
-    /** The directory where the user is running the server from. */
-    static rootDir = process.cwd();
-    /**
-     * 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(/[\\/]+/g, PATH.sep);
-        return path;
-    }
-    /**
-     * Resolves an absolute path from the root of the user project.
-     * @param paths - The path to resolve.
-     * @return The resolved path.
-     */
-    static root(...paths) {
-        paths = paths.map(path => this.normalize(path));
-        return PATH.join(this.rootDir, ...paths);
-    }
-    /**
-     * 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 +0,0 @@
-{"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

@@ -1,21 +0,0 @@
-/**
- * @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;