vortez 4.1.1

package/build/Utilities/Env.js

@@ -0,0 +1,123 @@
+import FS, { promises as FSPromises } from "fs";
+import PATH from "path";
+import Debug from "../Debug.js";
+export class Env {
+    static get variables() { return process.env; }
+    /**
+     * Check if a file exists
+     * @param path - The path to the file
+     * @returns A promise that resolves to true if the file exists, false otherwise
+     */
+    static async fileExists(path) {
+        return FSPromises.access(path).then(() => true).catch(() => false);
+    }
+    /**
+     * 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 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 this.fileExists(path)) {
+            await FSPromises.mkdir(PATH.dirname(path), { recursive: true });
+            const env = this.toEnv(defaultEnv);
+            await FSPromises.writeFile(path, env, 'utf-8');
+            Debug.log(`environment variables file &C6[${path}]&R does not exist, creating it`);
+        }
+        const env = await FSPromises.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;
+    }
+    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 - The default environment variables to use if none are found
+     * @returns The extracted environment variables as an object
+     */
+    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 environment variable key
+     * @param value - The value to set
+     */
+    static set(key, value) {
+        process.env[key] = value;
+    }
+    /**
+     * Set multiple environment variables at once
+     * @param env - An object containing key-value pairs of environment variables
+     */
+    static setMany(env) {
+        for (const key in env)
+            process.env[key] = env[key] ?? '';
+    }
+    /**
+     * Delete an environment variable
+     * @param key - The environment variable key 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

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

package/build/Utilities/Path.d.ts

@@ -0,0 +1,18 @@
+export declare class Path {
+    static readonly moduleDir: string;
+    static readonly moduleMain: string;
+    /**
+     * Clean a path by replacing all backslashes with the system-specific separator.
+     * @param path - The path to clean
+     * @returns The cleaned path
+     */
+    static normalize(path: string): string;
+    /**
+     * Convert a relative path to an absolute one, relative to the module root.
+     * @param path - The relative path
+     * @returns The absolute path
+     */
+    static relative(path: string): string;
+}
+export declare namespace Path { }
+export default Path;

package/build/Utilities/Path.js

@@ -0,0 +1,27 @@
+import PATH from 'path';
+import URL from 'url';
+export class Path {
+    static moduleDir = PATH.dirname(PATH.dirname(PATH.dirname(URL.fileURLToPath(import.meta.url))));
+    static moduleMain = PATH.join(this.moduleDir, 'build/Vortez.js');
+    /**
+     * Clean a path by replacing all backslashes with the system-specific separator.
+     * @param path - The path to clean
+     * @returns The cleaned path
+     */
+    static normalize(path) {
+        path = path.replace(/[\\/]/gi, PATH.sep);
+        return path;
+    }
+    /**
+     * Convert a relative path to an absolute one, relative to the module root.
+     * @param path - The relative path
+     * @returns The absolute path
+     */
+    static relative(path) {
+        path = this.normalize(path);
+        path = PATH.join(this.moduleDir, path);
+        return PATH.normalize(path);
+    }
+}
+export default Path;
+//# sourceMappingURL=Path.js.map

package/build/Utilities/Path.js.map

@@ -0,0 +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;;AAGL,eAAe,IAAI,CAAC"}

package/build/Utilities/Utilities.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add useful functions to the Vortez.
+ * @license Apache-2.0
+ */
+import _Path from './Path.js';
+import _Env from './Env.js';
+export declare class Utilities {
+    /**
+     * Deeply compares two objects.
+     * @param obj1 - The first object to compare
+     * @param obj2 - The second object to compare
+     * @returns True if the objects are equal, false otherwise
+     */
+    static deepEqual(obj1: any, obj2: any): boolean;
+    /**
+     * Flattens an object into a single-level object.
+     * @param object - The object to flatten
+     * @param depth - Maximum depth to flatten (default: 10)
+     * @returns The flattened object
+     */
+    static flattenObject<T extends object, D extends number = 10>(object: T, depth?: D): Utilities.Flatten.Object<T, D>;
+    protected static flattenCore(object: any, depth?: number, prefix?: string): any;
+    /**
+     * Reconstructs a nested object from a flattened one.
+     * @template Result - The type of the unflattened object
+     * @param obj - The object to unflatten
+     * @returns The unflattened object
+     */
+    static unFlattenObject<Result extends any = any>(obj: any): Result;
+    /**
+     * Delays execution for the specified number of milliseconds.
+     * @param ms - The number of milliseconds to wait
+     * @returns A promise that resolves after the given time
+     */
+    static sleep(ms: number): Promise<void>;
+    /**
+     * Encodes a string to base64url format.
+     * @param data - The string to encode
+     * @returns The base64url-encoded string
+     */
+    static base64UrlEncode(data: string): string;
+    /**
+     * Decodes a base64url-encoded string.
+     * @param data - The base64url-encoded string to decode
+     * @returns The decoded string
+     */
+    static base64UrlDecode(data: string): string;
+}
+export declare namespace Utilities {
+    export import Path = _Path;
+    export import Env = _Env;
+    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;
+        /**
+         * add one to a number
+         * @template Number the number to add one to
+         * @returns the number added 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);
+        /**
+         * union to intersection
+         * @template U the union to convert
+         * @returns the intersection of the 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);
+        /**
+         * convert the object property with undefined to optional
+         * @template T the object to convert
+         * @returns the converted object
+         */
+        export 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>;
+        };
+        export type Document = {
+            [key: string]: any;
+        };
+        export {};
+    }
+    namespace Flatten {
+        /**
+         * flatten an object into a single level and return an union of all the keys
+         * @template T the object to flatten
+         * @template depth the depth to flatten
+         * @template index the current index
+         * @returns the flattened object keys as a union
+         */
+        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];
+        /**
+         * flatten an object into a single level and return an union of all the keys
+         * @template T the object to flatten
+         * @template depth the depth to flatten
+         * @template index the current index
+         * @returns the flattened object keys as a union
+         */
+        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);
+        /**
+         * flatten an object into a single level
+         * @template T the object to flatten
+         * @template depth the depth to flatten
+         * @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 {
+        /**
+         * split a string by 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]);
+        /**
+         * build a nested object from a string
+         * @template Path the path to build
+         * @template Value the value to build
+         * @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);
+        /**
+         * unFlatten an object into a single level
+         * @template T the object to unFlatten
+         * @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 {};
+    }
+    interface env {
+        [key: string]: string;
+    }
+}
+export default Utilities;

package/build/Utilities/Utilities.js

@@ -0,0 +1,110 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add useful functions to the Vortez.
+ * @license Apache-2.0
+ */
+import _Path from './Path.js';
+import _Env from './Env.js';
+export class Utilities {
+    /**
+     * Deeply compares two objects.
+     * @param obj1 - The first object to compare
+     * @param obj2 - The second object to compare
+     * @returns True if the objects are equal, false otherwise
+     */
+    static deepEqual(obj1, obj2) {
+        if (obj1 === obj2)
+            return true;
+        if (typeof obj1 !== typeof obj2 ||
+            obj1 === null || obj2 === null)
+            return false;
+        const keys1 = Object.keys(obj1);
+        const keys2 = 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;
+    }
+    /**
+     * Flattens an object into a single-level object.
+     * @param object - The object to flatten
+     * @param depth - Maximum depth to flatten (default: 10)
+     * @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;
+    }
+    /**
+     * Reconstructs a nested object from a flattened one.
+     * @template Result - The type of the unflattened object
+     * @param obj - The object to unflatten
+     * @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;
+    }
+    /**
+     * Delays execution for the specified number of milliseconds.
+     * @param ms - The number of milliseconds to wait
+     * @returns A promise that resolves after the given time
+     */
+    static sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Encodes a string to base64url format.
+     * @param data - The string to encode
+     * @returns The base64url-encoded string
+     */
+    static base64UrlEncode(data) {
+        return Buffer.from(data).toString('base64url');
+    }
+    /**
+     * Decodes a base64url-encoded string.
+     * @param data - The base64url-encoded string to decode
+     * @returns The decoded string
+     */
+    static base64UrlDecode(data) {
+        return Buffer.from(data, 'base64url').toString('utf8');
+    }
+}
+(function (Utilities) {
+    Utilities.Path = _Path;
+    Utilities.Env = _Env;
+})(Utilities || (Utilities = {}));
+export default Utilities;
+//# sourceMappingURL=Utilities.js.map

package/build/Utilities/Utilities.js.map

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

package/build/Vortez.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Exports the main utilities of the Vortez module.
+ * @module NetFeez-Labs.Vortez
+ * @license Apache-2.0
+ */
+import Config from "./Config.js";
+import Debug from "./Debug.js";
+import Logger from "./LoggerManager/Logger.js";
+import Template from "./Template.js";
+import Vortez from "./Server/Server.js";
+import Utilities from "./Utilities/Utilities.js";
+import JwtManager from "./Beta/JwtManager.js";
+import Mail from "./Beta/Mail.js";
+export declare const Beta: {
+    JwtManager: typeof JwtManager;
+    Mail: typeof Mail;
+};
+export { Debug, Logger, Utilities, Template, Config, };
+export default Vortez;

package/build/Vortez.js

@@ -0,0 +1,22 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Exports the main utilities of the Vortez module.
+ * @module NetFeez-Labs.Vortez
+ * @license Apache-2.0
+ */
+// Imports the main utilities of the Vortez module.
+import Config from "./Config.js";
+import Debug from "./Debug.js";
+import Logger from "./LoggerManager/Logger.js";
+import Template from "./Template.js";
+import Vortez from "./Server/Server.js";
+import Utilities from "./Utilities/Utilities.js";
+// Imports the beta utilities of the Vortez module.
+import JwtManager from "./Beta/JwtManager.js";
+import Mail from "./Beta/Mail.js";
+// Exports the beta utilities of the Vortez module.
+export const Beta = { JwtManager, Mail };
+// Exports the main utilities of the Vortez module.
+export { Debug, Logger, Utilities, Template, Config, };
+export default Vortez;
+//# sourceMappingURL=Vortez.js.map

package/build/Vortez.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vortez.js","sourceRoot":"","sources":["../src/Vortez.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mDAAmD;AACnD,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAC/C,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,SAAS,MAAM,0BAA0B,CAAC;AAEjD,mDAAmD;AACnD,OAAO,UAAU,MAAM,sBAAsB,CAAC;AAC9C,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAElC,mDAAmD;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAEzC,mDAAmD;AACnD,OAAO,EACN,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,QAAQ,EACnB,MAAM,GACN,CAAC;AACF,eAAe,MAAM,CAAC"}

package/changes.md

@@ -0,0 +1,89 @@
+
+# version (4.1.0)
+## ➕ Added
+  - **(Logger)**: added to help in log with prefix.
+    - this was exported from `Vortez`
+      ```ts
+      import { Logger } from `vortez`
+      ```
+  - **(LoggerManager)**: added to manager the Vortez logs.
+    - this was exported from namespace `Vortez`
+      ```ts
+      import Vortez from `vortez`
+      Vortez.LoggerManager
+      ```
+## 🐞 Fixes
+  - The default templates now use absolute path to prevent errors
+    - Note: the user can use relative path`s
+## ✏️ Changes
+  - **(Debug)**: Debugging tools were added.
+    - Added methods to help in debug time: log, warn, info and error.
+    - The default value to show was changed to true.
+  - **(Server)**: The server startup was changed.
+    - Added methods: start, stop, restart
+    - Now the user should use the method start
+      ```ts
+      import Vortez from 'vortez';
+      const server = new Vortez();
+      server.start();
+      ```
+    - The server config can be provided in constructor or changed after start.
+      ```ts
+      // example 1;
+  		const server = new Vortez({
+        port: 80, host: 'localhost', ssl: {
+          pubKey: 'public.pem',
+          privKey: 'private.pem'
+          port: 443
+        }
+      });
+      // example 2
+      const server = new Vortez();
+      server.config.port = 80;
+      server.config.host = 'localhost';
+      server.config.ssl = {
+        pubKey: 'public.pem',
+        privKey: 'private.pem'
+        port: 443
+      }
+      ```
+
+# version (4.0.0)
+## 📒 Notes
+  - The project was migrated to TypeScript.
+  - Properties and methods now start with a camelcase.
+  - Skipped version 3.7.0 to make way for 4.0.0.
+## ✏️ Changes
+  - **(Template)**: The `load` method now works with async/await instead of directly returning a promise.
+  - **(Template)**: syntax of array changed.
+    ```text
+    // from
+    $(name) { the key is $key with value $value }
+    $(name, customKeyName, customValueName) { the key is $customKeyName with value $customValueName }
+    // to
+    $(name) { the key is %key% with value %value% }
+    $(name, customKeyName, customValueName) { the key is %customKeyName% with value %customValueName% }
+    ```
+  - **(Utilities)**: Added the functions `loadEnv`, `flattenObject`, and `sleep`.
+  - **(Utilities)**: Modified the `flattenObject` function to retain null and undefined values and provide better typing.
+  - **(Debug)**: Can now only be used from the `getInstance` method (subject to possible changes).
+  - **(Config)**: Converted to a singleton.
+  - **(Response)**: The `send` method is now limited to receiving `string|buffer`.
+  - **(Response)**: The `sendFile`, `sendFolder`, and `sendTemplate` methods now work with async/await.
+  - **(Response)**: The `POST.content` object will no longer be a `Map` when appropriate, but a `Request.POST.VarList` object.
+  - **(Response)**: The `POST.files` object will always have the type `Request.POST.FileList`.
+  - **(Request)**: The `GET` attribute is now `searchParams`.
+  - **(Request)**: Request body processing has been delegated to `BodyParser.ts`.
+  - **(Request)**: The type of search param is no longer a `Map`, but an object `{ [key: string]: string | undefined }`.
+  - **(WebSocket)**: The logic behind WebSocket reception was separated into `Chunk.ts`.
+  - **(WebSocket)**: `Chunk.ts` was optimized.
+  - **(Beta)**: `JsonWT` was converted to `JwtManager`.
+
+  
+
+# version (x.x.x)
+## 📒 Notes
+## ➕ Added
+## ❌ Removed
+## 🐞 Fixes
+## ✏️ Changes