vortez 5.0.3 → 6.0.0-dev.1

package/build/server/websocket/messageAssembler/MessageAssembler.d.ts

@@ -0,0 +1,25 @@
+import { Events } from '@netfeez/common';
+import Frame from '../frame/Frame.js';
+import Message from './Message.js';
+export declare class MessageAssembler extends Events<MessageAssembler.EventMap> {
+    private frames;
+    /**
+     * Pushes a frame into the assembler and attempts to assemble a complete message if the frame indicates the end of a message (FIN flag is set).
+     * Control frames are processed immediately, while data frames are accumulated until a complete message can be formed.
+     *
+     * @param frame - The frame to be pushed into the assembler for processing.
+     */
+    push(frame: Frame): void;
+    /**
+     * Resets the assembler by clearing any stored frames.
+     * This is typically used to discard incomplete message data after an error is encountered, ensuring that subsequent messages are processed cleanly without interference from previous state.
+     */
+    reset(): void;
+}
+export declare namespace MessageAssembler {
+    type EventMap = {
+        message: [message: Message];
+        error: [error: Error];
+    };
+}
+export default MessageAssembler;

package/build/server/websocket/messageAssembler/MessageAssembler.js

@@ -0,0 +1,47 @@
+import { Events } from '@netfeez/common';
+import Message from './Message.js';
+export class MessageAssembler extends Events {
+    frames = [];
+    /**
+     * Pushes a frame into the assembler and attempts to assemble a complete message if the frame indicates the end of a message (FIN flag is set).
+     * Control frames are processed immediately, while data frames are accumulated until a complete message can be formed.
+     *
+     * @param frame - The frame to be pushed into the assembler for processing.
+     */
+    push(frame) {
+        if (frame.isControl) {
+            if (!frame.header.fin)
+                return this.emit('error', new Error('Control frames must not be fragmented'));
+            const message = new Message([frame]);
+            return this.emit('message', message);
+        }
+        if (this.frames.length > 0 && !frame.isContinuation) {
+            this.reset();
+            this.emit('error', new Error('Protocol Error: Expected continuation frame (0x0).'));
+            return;
+        }
+        if (this.frames.length === 0 && frame.isContinuation) {
+            this.emit('error', new Error('Protocol Error: Unexpected continuation frame.'));
+            return;
+        }
+        this.frames.push(frame);
+        if (frame.header.fin) {
+            try {
+                const message = new Message(this.frames);
+                this.frames = [];
+                this.emit('message', message);
+            }
+            catch (error) {
+                this.reset();
+                this.emit('error', error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    /**
+     * Resets the assembler by clearing any stored frames.
+     * This is typically used to discard incomplete message data after an error is encountered, ensuring that subsequent messages are processed cleanly without interference from previous state.
+     */
+    reset() { this.frames = []; }
+}
+export default MessageAssembler;
+//# sourceMappingURL=MessageAssembler.js.map

package/build/server/websocket/messageAssembler/MessageAssembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageAssembler.js","sourceRoot":"","sources":["../../../../src/server/websocket/messageAssembler/MessageAssembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,OAAO,gBAAiB,SAAQ,MAAiC;IAC3D,MAAM,GAAY,EAAE,CAAC;IAC7B;;;;;OAKG;IACI,IAAI,CAAC,KAAY;QACpB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;YACrG,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC,CAAC;YACpF,OAAO;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC;YAChF,OAAO;QACX,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACzC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClF,CAAC;QACL,CAAC;IACL,CAAC;IACD;;;OAGG;IACI,KAAK,KAAW,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;CAC7C;AAOD,eAAe,gBAAgB,CAAC"}

package/changes.md

@@ -1,3 +1,25 @@
+# version (6.0.0)
+## ⚠️ Breaking Changes
+### (Server/Cookie)
+- The `getSetters()` method has been removed from the `Cookie` class. Use the `setters` getter property instead.
+- This change breaks compatibility with any code or tests that relied on `getSetters()`. Update your code to use `cookie.setters`.
+
+## ➕ Added
+- **(WebSocket/Orchestrator)**: Introduced `Websocket` orchestrator as the main entry point for WebSocket management.
+- **(WebSocket/Handshake)**: Added `SSHandshaker` and `CSHandshaker` for RFC-6455 negotiation.
+- **(WebSocket/Base)**: Implemented `WebsocketBase` as the core functional socket class.
+- **(WebSocket/Init)**: Added `WebsocketSSInit` and `WebsocketCSInit` for specialized handshake flows.
+- **(WebSocket/Protocol)**: Added binary `Frame` and `Header` parsing/decoding, and `Codec` for client/server data masking and payload management.
+- **(WebSocket/Events)**: Added `Events` utility class for event-driven architecture.
+- **(WebSocket/Assembler)**: Added `MessageAssembler` to handle fragmented WebSocket messages.
+
+## ✏️ Changes
+- **(Router/WsMiddleware)**: Updated `Router` and `WsMiddleware` to support the new WebSocket API routing and middleware with new pipeline.
+- **(Server/Cookie & Response)**: Refactored for handshake compatibility.
+
+## ❌ Removed
+- **(WebSocket/Chunk.ts)**: Removed deprecated `Chunk.ts` in favor of the new `Frame` system.
+
 # version (5.0.0)
 ## 📒 Notes
 - **Breaking Change**: The server's debugging interface has been refactored. Users interacting with the old `DebugUI` will need to adapt to the new `ServerDebug` module.
@@ -12,6 +34,12 @@
 - **(Server/DebugUI)**: Deleted the old `DebugUI.ts` which was tightly coupled with the `Server` class.
 ## 🐞 Fixes
 ## ✏️ Changes
+
+# version (6.0.0)
+## ⚠️ Breaking Changes
+### (Server/Cookie)
+- The `getSetters()` method has been removed from the `Cookie` class. Use the `setters` getter property instead.
+- This change breaks compatibility with any code or tests that relied on `getSetters()`. Update your code to use `cookie.setters`.
 - **(Vortez/DebugUI)**: The entire debugging system has been refactored for modularity. **This is a breaking change.**
   - The `DebugUI` is no longer part of the `Server` class but is now composed of a generic `DebugUI` from utilities and a specific `ServerDebug` module.
   - This decoupling allows other packages to leverage the `DebugUI` from `vortez`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vortez",
-  "version": "5.0.3",
+  "version": "6.0.0-dev.1",
   "description": "a module for web server creation",
   "type": "module",
   "main": "build/Vortez.js",
@@ -44,5 +44,10 @@
   "devDependencies": {
     "@types/node": "^25.5.0",
     "typescript": "^6.0.2"
+  },
+  "dependencies": {
+    "@netfeez/common": "^1.0.3",
+    "@netfeez/common-node": "^1.0.1",
+    "@netfeez/vterm": "^1.0.0"
   }
 }

package/build/logger/Debug.d.ts

@@ -1,174 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Add the debug system to the Vortez.
- * @license Apache-2.0
- */
-export declare class Debug {
-    private static readonly debugs;
-    static readonly defaultID: string;
-    static readonly default: Debug;
-    private static timestampFormat;
-    static showAll: boolean;
-    private id;
-    show: boolean;
-    private _save;
-    private filePath;
-    private rootPath;
-    private startDate;
-    private stream;
-    /**
-     * Retrieves an existing debug instance by its ID or creates a new one if it doesn't exist.
-     * @param id - The unique identifier for the debug instance. Defaults to `'_debug'`.
-     * @param options - Debug instance options.
-     * @returns The debug instance.
-     */
-    static getInstance(id?: string, options?: Debug.options): Debug;
-    /**
-     * Constructs a new Debug instance. This constructor is private and should not be called directly. Use `Debug.getInstance()` instead.
-     * @param id - The unique identifier for the debug instance. Defaults to `'_default'`.
-     * @param options - Debug instance options.
-     */
-    private constructor();
-    get save(): boolean;
-    set save(value: boolean);
-    /**
-     * Retrieves or creates the write stream to the debug file associated with this instance.
-     * @returns The stream to the debug file.
-     */
-    private getStream;
-    /**
-     * Logs data with a '[LOG]' prefix to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    log(...data: any[]): void;
-    /**
-     * Logs data with an '[INF]' prefix (for informational messages) to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    info(...data: any[]): void;
-    /**
-     * Logs data with a '[WRN]' prefix (for warnings) to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    warn(...data: any[]): void;
-    /**
-     * Logs data with an '[ERR]' prefix (for errors) to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    error(...data: any[]): void;
-    /**
-     * Logs data with a custom prefix to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - Data to log
-     * @param options - Log options
-     */
-    customLog(data: any[], options: Debug.LogOptions): void;
-    /**
-     * Displays the log entry on the console.
-     * @param timestamp - The timestamp of the log entry.
-     * @param prefix - The prefix for the log entry.
-     * @param data - The data to be displayed.
-     */
-    private showLog;
-    private formatMultiline;
-    /**
-     * Saves the log entry to the debug file.
-     * @param timestamp - The timestamp of the log entry.
-     * @param prefix - The prefix for the log entry.
-     * @param data - The data to be saved.
-     */
-    private saveLog;
-    /**
-     * Logs data with a '[LOG]' prefix using the default debug instance.
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    static log(...data: any[]): void;
-    /**
-     * Logs data with an '[INF]' prefix using the default debug instance.
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    static info(...data: any[]): void;
-    /**
-     * Logs data with a '[WRN]' prefix using the default debug instance.
-     * @param data - Data to log.
-     */
-    static warn(...data: any): void;
-    /**
-     * Logs data with an '[ERR]' prefix using the default debug instance.
-     * @param data - Data to log.
-     */
-    static error(...data: any): void;
-    /**
-     * Clean a path.
-     * @param path - Path to clean.
-     * @returns Cleaned path.
-     */
-    private static cleanPath;
-    /**
-     * Get the path to the debug file.
-     * @param id - Debug instance ID.
-     * @param folderPath - Path to the debug folder.
-     * @param date - Date of the debug instance.
-     * @returns The path to the debug file.
-     */
-    private static getFilePath;
-    /**
-     * Generate a stream to the debug file.
-     * @param id - Debug instance ID.
-     * @param filePath - Path to the debug file.
-     * @param date - Date of the debug instance.
-     * @returns The stream to the debug file.
-     */
-    private static generateStream;
-    /**
-     * Generate a datetime timestamp.
-     * @param format - Timestamp format.
-     * @returns Formatted datetime timestamp.
-     * @example `[DD-MM-YYYY] [hh:mm:ss:ms]`
-     *
-     * | variable | value  |
-     * | -------- | ------ |
-     * | DD       | day    |
-     * | MM       | month  |
-     * | YYYY     | year   |
-     * | hh       | hour   |
-     * | mm       | minute |
-     * | ss       | second |
-     */
-    private static getTimestamp;
-    /**
-     * Get the current date and time in formatted parts.
-     * @returns Object containing date parts and full formats.
-     */
-    private static getDate;
-}
-export declare namespace Debug {
-    type debugMap = Map<string, Debug>;
-    interface LogOptions {
-        /** The prefix to use for the log entry. */
-        prefix?: string;
-        /** The separator to use between the prefix and the data. */
-        separator?: string;
-        /** Whether to show the log entry on the console. */
-        show?: boolean;
-        /** Whether to save the log entry to the debug file. */
-        save?: boolean;
-    }
-    interface options {
-        path?: string;
-        show?: boolean;
-        save?: boolean;
-    }
-    interface Date {
-        day: string;
-        month: string;
-        year: string;
-        hour: string;
-        minute: string;
-        second: string;
-        millisecond: string;
-        DateFormat: string;
-        TimeFormat: string;
-        now: globalThis.Date;
-    }
-}
-export default Debug;

package/build/logger/Debug.js

@@ -1,295 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Add the debug system to the Vortez.
- * @license Apache-2.0
- */
-import fs from 'fs';
-import Utilities, { ConsoleUI } from '../utilities/Utilities.js';
-export class Debug {
-    static debugs = new Map();
-    static defaultID = 'Debug';
-    static default = Debug.getInstance(this.defaultID);
-    static timestampFormat = '&C(255,255,255)[DD-MM-YYYY] [hh:mm:ss:ms]&R';
-    static showAll = false;
-    id;
-    show;
-    _save;
-    filePath;
-    rootPath;
-    startDate;
-    stream;
-    /**
-     * Retrieves an existing debug instance by its ID or creates a new one if it doesn't exist.
-     * @param id - The unique identifier for the debug instance. Defaults to `'_debug'`.
-     * @param options - Debug instance options.
-     * @returns The debug instance.
-     */
-    static getInstance(id = this.defaultID, options = {}) {
-        if (id === this.defaultID)
-            return this.default || new Debug(id, options);
-        const debug = Debug.debugs.get(id);
-        if (!debug)
-            return new Debug(id, options);
-        if (Object.keys(options).length > 0) {
-            const called_in = new Error().stack?.split('\n')[2].trim();
-            this.warn(`The options of the debug instance with ID &C6${id}&R were overwritten &C6${called_in}`);
-            debug.save = options.save ?? debug.save;
-            debug.show = options.show ?? debug.show;
-            if (options.path)
-                this.warn(`The path of the debug instance with ID &C6${id}&R cant be overwritten before the initialization, the option will be ignored &C6${called_in}`);
-        }
-        return debug;
-    }
-    /**
-     * Constructs a new Debug instance. This constructor is private and should not be called directly. Use `Debug.getInstance()` instead.
-     * @param id - The unique identifier for the debug instance. Defaults to `'_default'`.
-     * @param options - Debug instance options.
-     */
-    constructor(id = '_default', options = {}) {
-        const { path = '.debug', show = true, save = true } = options;
-        const now = Debug.getDate();
-        const rootPath = Debug.cleanPath(path);
-        const filePath = Debug.getFilePath(id, rootPath, now);
-        this.id = id;
-        this.show = show;
-        this._save = save;
-        this.rootPath = rootPath;
-        this.filePath = filePath;
-        this.startDate = now;
-        this.stream = null;
-        Debug.debugs.set(id, this);
-    }
-    get save() { return this._save; }
-    set save(value) {
-        this._save = value;
-        if (value)
-            this.stream = this.getStream();
-        else if (this.stream) {
-            this.stream.destroy();
-            this.stream = null;
-        }
-    }
-    /**
-     * Retrieves or creates the write stream to the debug file associated with this instance.
-     * @returns The stream to the debug file.
-     */
-    getStream() {
-        if (!this.stream) {
-            const id = this.id;
-            const date = this.startDate;
-            const stream = Debug.generateStream(this.filePath);
-            stream.write([
-                '/* +----------------------------+* /',
-                '/* | NetFeez-Labs/Debug by NetFeez |* /',
-                '/* |     Use NetFeez-Labs ReadDebug     |* /',
-                '/* +----------------------------+* /',
-                `/* the name of the DebugFile is the DateTime of initialize Debug with ID ${id} */`,
-                `/* the initialize stream DateTime is ${date.DateFormat} << ${date.TimeFormat} */`,
-                '', ''
-            ].join('\n'));
-            this.stream = stream;
-            this.log(`&C2&PStream created to the debug file: &C6&S${this.filePath}`);
-        }
-        return this.stream;
-    }
-    /**
-     * Logs data with a '[LOG]' prefix to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    log(...data) { this.customLog(data, { prefix: `&C2[LOG] [${this.id}]` }); }
-    /**
-     * Logs data with an '[INF]' prefix (for informational messages) to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    info(...data) { this.customLog(data, { prefix: `&C6[INF] [${this.id}]` }); }
-    /**
-     * Logs data with a '[WRN]' prefix (for warnings) to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    warn(...data) { this.customLog(data, { prefix: `&C3[WRN] [${this.id}]` }); }
-    /**
-     * Logs data with an '[ERR]' prefix (for errors) to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    error(...data) { this.customLog(data, { prefix: `&C1[ERR] [${this.id}]` }); }
-    /**
-     * Logs data with a custom prefix to the console (if enabled) and/or the debug file (if enabled).
-     * @param data - Data to log
-     * @param options - Log options
-     */
-    customLog(data, options) {
-        const { prefix = ` &C2[LOG] [${this.id}&C2]`, show = this.show, save = this.save } = options;
-        const timestamp = Debug.getTimestamp();
-        if (save)
-            this.saveLog(timestamp, prefix, ...data);
-        if (show || Debug.showAll)
-            this.showLog(timestamp, prefix, ...data);
-    }
-    /**
-     * Displays the log entry on the console.
-     * @param timestamp - The timestamp of the log entry.
-     * @param prefix - The prefix for the log entry.
-     * @param data - The data to be displayed.
-     */
-    showLog(timestamp, prefix, ...data) {
-        timestamp = ConsoleUI.formatText(timestamp);
-        prefix = ConsoleUI.formatText(prefix);
-        const toShow = data.map((datum) => {
-            if (typeof datum === 'string') {
-                if (!datum.includes('\n'))
-                    return ConsoleUI.formatText(datum);
-                else
-                    return this.formatMultiline(timestamp, prefix, datum);
-            }
-            else if (datum instanceof Error)
-                return this.formatMultiline(timestamp, prefix, datum.stack ?? datum.message);
-            else
-                return datum;
-        });
-        console.log(`${timestamp} ${prefix} ->`, ...toShow);
-    }
-    formatMultiline(timestamp, prefix, data) {
-        timestamp = ConsoleUI.cleanFormat(timestamp);
-        prefix = ConsoleUI.cleanFormat(prefix);
-        const lines = data.split('\n');
-        const first = lines.shift();
-        const result = lines.map((line) => `${timestamp} ${prefix} -> ${line}`);
-        return ConsoleUI.formatText([first, ...result].join('\n'));
-    }
-    /**
-     * Saves the log entry to the debug file.
-     * @param timestamp - The timestamp of the log entry.
-     * @param prefix - The prefix for the log entry.
-     * @param data - The data to be saved.
-     */
-    saveLog(timestamp, prefix, ...data) {
-        timestamp = ConsoleUI.cleanFormat(timestamp);
-        prefix = ConsoleUI.cleanFormat(prefix);
-        const stream = this.getStream();
-        const toSave = data.map((datum) => typeof datum === 'string' ?
-            ConsoleUI.cleanFormat(datum) : datum);
-        stream.write(`${timestamp} ${prefix} -> ${JSON.stringify(toSave)}\n`);
-    }
-    /**
-     * Logs data with a '[LOG]' prefix using the default debug instance.
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    static log(...data) {
-        const debug = this.getInstance();
-        debug.log(...data);
-    }
-    /**
-     * Logs data with an '[INF]' prefix using the default debug instance.
-     * @param data - The data to be logged. Can be multiple arguments of any type.
-     */
-    static info(...data) {
-        const debug = this.getInstance();
-        debug.info(...data);
-    }
-    /**
-     * Logs data with a '[WRN]' prefix using the default debug instance.
-     * @param data - Data to log.
-     */
-    static warn(...data) {
-        const debug = this.getInstance();
-        debug.warn(...data);
-    }
-    /**
-     * Logs data with an '[ERR]' prefix using the default debug instance.
-     * @param data - Data to log.
-     */
-    static error(...data) {
-        const debug = this.getInstance();
-        debug.error(...data);
-    }
-    /**
-     * Clean a path.
-     * @param path - Path to clean.
-     * @returns Cleaned path.
-     */
-    static cleanPath(path) {
-        path = Utilities.Path.normalize(path);
-        path = path.startsWith('/') ? path.slice(1) : path;
-        path = path.endsWith('/') ? path.slice(0, -1) : path;
-        return path;
-    }
-    /**
-     * Get the path to the debug file.
-     * @param id - Debug instance ID.
-     * @param folderPath - Path to the debug folder.
-     * @param date - Date of the debug instance.
-     * @returns The path to the debug file.
-     */
-    static getFilePath(id, folderPath, date) {
-        const file = `[${id}] - ${date.hour}.${date.minute}.${date.second}.${date.millisecond}.vlog`;
-        const folder = `${folderPath}/[${date.day}.${date.month}.${date.year}]`;
-        const path = `${folder}/${file}`;
-        return path;
-    }
-    /**
-     * Generate a stream to the debug file.
-     * @param id - Debug instance ID.
-     * @param filePath - Path to the debug file.
-     * @param date - Date of the debug instance.
-     * @returns The stream to the debug file.
-     */
-    static generateStream(filePath) {
-        const folder = filePath.slice(0, filePath.lastIndexOf('/'));
-        if (!fs.existsSync(folder))
-            fs.mkdirSync(folder, { recursive: true });
-        const stream = fs.createWriteStream(filePath, 'utf8');
-        return stream;
-    }
-    /**
-     * Generate a datetime timestamp.
-     * @param format - Timestamp format.
-     * @returns Formatted datetime timestamp.
-     * @example `[DD-MM-YYYY] [hh:mm:ss:ms]`
-     *
-     * | variable | value  |
-     * | -------- | ------ |
-     * | DD       | day    |
-     * | MM       | month  |
-     * | YYYY     | year   |
-     * | hh       | hour   |
-     * | mm       | minute |
-     * | ss       | second |
-     */
-    static getTimestamp(format = this.timestampFormat, date = this.getDate()) {
-        const now = Debug.getDate();
-        // const timestamp = `[${now.hour}:${now.minute}:${now.second}:${now.millisecond}]`;
-        const timestamp = format
-            .replace(/DD/g, now.day)
-            .replace(/MM/g, now.month)
-            .replace(/YYYY/g, now.year)
-            .replace(/hh/g, now.hour)
-            .replace(/mm/g, now.minute)
-            .replace(/ss/g, now.second)
-            .replace(/ms/g, now.millisecond);
-        return timestamp;
-    }
-    /**
-     * Get the current date and time in formatted parts.
-     * @returns Object containing date parts and full formats.
-     */
-    static getDate() {
-        const now = new Date();
-        const day = now.getDate().toString().padStart(2, '0');
-        const month = (now.getMonth() + 1).toString().padStart(2, '0');
-        const year = now.getFullYear().toString().padStart(4, '0');
-        const hour = now.getHours().toString().padStart(2, '0');
-        const minute = now.getMinutes().toString().padStart(2, '0');
-        const second = now.getSeconds().toString().padStart(2, '0');
-        const millisecond = now.getMilliseconds().toString().padStart(3, '0');
-        const DateFormat = `${day}-${month}-${year}`;
-        const TimeFormat = `${hour}.${minute}.${second}.${millisecond}`;
-        const result = {
-            day, month, year,
-            hour, minute, second, millisecond,
-            DateFormat, TimeFormat, now
-        };
-        return result;
-    }
-}
-export default Debug;
-//# sourceMappingURL=Debug.js.map

package/build/logger/Debug.js.map

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

package/build/logger/Logger.d.ts

@@ -1,38 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>
- * @description Adds a logger class to have organized logs.
- * @license Apache-2.0
-*/
-import _Debug from "./Debug.js";
-export { Debug } from "./Debug.js";
-export declare class Logger {
-    private static readonly LEVEL_MAP;
-    private prefix;
-    private format;
-    private debug;
-    show: boolean;
-    save: boolean;
-    constructor(options?: Logger.Options);
-    log(...data: any[]): void;
-    warn(...data: any[]): void;
-    info(...data: any[]): void;
-    error(...data: any[]): void;
-    private getLogOptions;
-}
-export declare namespace Logger {
-    export import Debug = _Debug;
-    type level = 'log' | 'warn' | 'info' | 'error';
-    type LevelMap = Record<level, string>;
-    interface NewDebugOptions {
-        id: string;
-        path?: string;
-        show?: boolean;
-        save?: boolean;
-    }
-    interface Options {
-        prefix?: string;
-        format?: string;
-        debug?: string | Logger.Debug | NewDebugOptions;
-    }
-}
-export default Logger;