vortez 4.1.1 → 5.0.0-dev.14

package/build/{Server → server}/Session.js

@@ -10,55 +10,54 @@
 // Note: a public/private key system should be implemented to prevent
 //   users from using someone else's ss_uuid to access their data.
 import CRYPTO from 'crypto';
-import EVENTS from 'events';
-export class Session extends EVENTS {
+export class Session {
     /** Stores session instances. */
-    static sessions = new Map;
-    /** Stores session data. */
-    data;
-    /** Stores the session's SS_UUID. */
-    sessionID;
+    static instances = new Map;
     /**
      * Creates or retrieves the current session instance from cookies.
      * @param cookies - The Cookie instance from the request.
      * @returns The current session instance.
      */
-    static getInstance(cookies) {
-        let sessionID = cookies.get('Session');
-        if (!sessionID) {
-            sessionID = CRYPTO.randomUUID();
-            cookies.set('Session', sessionID, {
-                secure: true,
-                httpOnly: true,
-                path: '/',
-                expires: (() => {
-                    const date = new Date();
-                    date.setFullYear(date.getFullYear() + 1);
-                    return date;
-                })()
-            });
-        }
-        let session = Session.sessions.get(sessionID);
-        if (!session) {
-            session = new Session(sessionID);
-            Session.sessions.set(sessionID, session);
-        }
-        return session;
+    static get(cookies) {
+        const id = this.extractID(cookies);
+        const session = this.instances.get(id);
+        if (session)
+            return session;
+        const newSession = new Session(id);
+        this.instances.set(id, newSession);
+        return newSession;
+    }
+    static extractID(cookies) {
+        let id = cookies.get('Session');
+        if (id)
+            return id;
+        do
+            id = CRYPTO.randomUUID();
+        while (Session.instances.has(id));
+        cookies.set('Session', id, {
+            secure: true, httpOnly: true,
+            path: '/',
+            expires: this.getExpiration()
+        });
+        return id;
+    }
+    static getExpiration() {
+        const date = new Date();
+        date.setFullYear(date.getFullYear() + 1);
+        return date;
     }
+    /** Stores the session's SS_UUID. */
+    id;
+    /** Stores session data. */
+    data;
     /**
      * Constructs a session instance with the given ID.
      * @param sessionID - The session's unique ID.
      */
     constructor(sessionID) {
-        super();
         this.data = new Map();
-        this.sessionID = sessionID;
+        this.id = sessionID;
     }
-    /**
-     * Returns the session's SS_UUID.
-     * @returns The session ID string.
-     */
-    getID() { return this.sessionID; }
     /**
      * Checks whether a given key exists in the session.
      * @param name - The key to check in the session data.

package/build/server/Session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.js","sourceRoot":"","sources":["../../src/server/Session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6DAA6D;AAC7D,mEAAmE;AACnE,uEAAuE;AACvE,0DAA0D;AAC1D,qEAAqE;AACrE,kEAAkE;AAElE,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,OAAO,OAAO;IAChB,gCAAgC;IACxB,MAAM,CAAC,SAAS,GAAyB,IAAI,GAAG,CAAC;IACzD;;;;OAIG;IACI,MAAM,CAAC,GAAG,CAAC,OAAe;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO,UAAU,CAAC;IACtB,CAAC;IACO,MAAM,CAAC,SAAS,CAAC,OAAe;QACpC,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;QAClB;YAAG,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;eACrB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAClC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE;YACvB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI;YAC5B,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE;SAChC,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACd,CAAC;IACO,MAAM,CAAC,aAAa;QACxB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,oCAAoC;IACpB,EAAE,CAAS;IAC3B,2BAA2B;IACnB,IAAI,CAAmB;IAC/B;;;OAGG;IACH,YAAoB,SAAiB;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACxB,CAAC;IACD;;;;OAIG;IACI,GAAG,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjE;;;;OAIG;IACI,GAAG,CAAC,IAAY,IAAqB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzE;;;;OAIG;IACI,MAAM;QACT,MAAM,IAAI,GAA0B,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD;;;;OAIG;IACI,GAAG,CAAC,IAAY,EAAE,KAAU,IAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E;;;OAGG;IACI,MAAM,CAAC,IAAY,IAAU,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;AASjE,eAAe,OAAO,CAAC"}

package/build/{Config.d.ts → server/config/Config.d.ts}

@@ -3,17 +3,30 @@
  * @description add the config manager to the Vortez.
  * @license Apache-2.0
  */
-import LoggerManager from "./LoggerManager/LoggerManager.js";
+import LoggerManager from "../LoggerManager.js";
+import _ConfigLoader from "./ConfigLoader.js";
+import _ConfigValidator from "./ConfigValidator.js";
+export { ConfigLoader } from "./ConfigLoader.js";
+export { ConfigValidator } from "./ConfigValidator.js";
 export declare class Config implements Config.Main {
+    static readonly DEFAULT: Config.Main;
     templates: Config.Templates;
     host: string;
     port: number;
     logger: LoggerManager;
     ssl: Config.SSLOptions | null;
-    static instance: Config;
     constructor(options?: Config.options);
     get showAll(): boolean;
     set showAll(value: boolean);
+    /**
+     * Converts the config to a JSON string.
+     * @returns The JSON string.
+     */
+    toJson(): string;
+    /**
+     * Get the default templates.
+     * @returns The default templates.
+     */
     static defaultTemplates(): Config.Templates;
 }
 export declare namespace Config {
@@ -31,9 +44,12 @@ export declare namespace Config {
         host: string;
         port: number;
         ssl: SSLOptions | null;
-        logger: LoggerManager;
         templates: Templates;
     }
     type options = Partial<Main>;
 }
+export declare namespace Config {
+    export import Loader = _ConfigLoader;
+    export import Validator = _ConfigValidator;
+}
 export default Config;

package/build/server/config/Config.js

@@ -0,0 +1,60 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config manager to the Vortez.
+ * @license Apache-2.0
+ */
+import Debug from "../../logger/Debug.js";
+import LoggerManager from "../LoggerManager.js";
+import Utilities from "../../utilities/Utilities.js";
+import _ConfigLoader from "./ConfigLoader.js";
+import _ConfigValidator from "./ConfigValidator.js";
+export { ConfigLoader } from "./ConfigLoader.js";
+export { ConfigValidator } from "./ConfigValidator.js";
+export class Config {
+    static DEFAULT = {
+        host: 'localhost',
+        port: 80,
+        ssl: null,
+        templates: Config.defaultTemplates()
+    };
+    templates;
+    host;
+    port;
+    logger;
+    ssl;
+    constructor(options = {}) {
+        this.host = options.host ?? Config.DEFAULT.host;
+        this.port = options.port ?? Config.DEFAULT.port;
+        this.ssl = options.ssl ?? Config.DEFAULT.ssl;
+        this.logger = LoggerManager.getInstance();
+        this.templates = options.templates ?? Config.defaultTemplates();
+    }
+    get showAll() { return Debug.showAll; }
+    set showAll(value) { Debug.showAll = value; }
+    /**
+     * Converts the config to a JSON string.
+     * @returns The JSON string.
+     */
+    toJson() {
+        const { host, port, ssl, templates } = this;
+        const config = { host, port, ssl, templates };
+        const content = JSON.stringify(config, null, 4);
+        return content;
+    }
+    /**
+     * Get the default templates.
+     * @returns The default templates.
+     */
+    static defaultTemplates() {
+        return {
+            folder: Utilities.Path.relative('./global/Template/Folder.vhtml'),
+            error: Utilities.Path.relative('./global/Template/Error.vhtml')
+        };
+    }
+}
+(function (Config) {
+    Config.Loader = _ConfigLoader;
+    Config.Validator = _ConfigValidator;
+})(Config || (Config = {}));
+export default Config;
+//# sourceMappingURL=Config.js.map

package/build/server/config/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../../src/server/config/Config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,uBAAuB,CAAC;AAC1C,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,SAAS,MAAM,8BAA8B,CAAC;AACrD,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,gBAAgB,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,MAAM;IACR,MAAM,CAAU,OAAO,GAAgB;QAC1C,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,MAAM,CAAC,gBAAgB,EAAE;KACvC,CAAC;IACK,SAAS,CAAmB;IAC5B,IAAI,CAAS;IACb,IAAI,CAAS;IACb,MAAM,CAAgB;IACtB,GAAG,CAA2B;IACrC,YAAmB,UAA0B,EAAE;QAC3C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACpE,CAAC;IACD,IAAW,OAAO,KAAc,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,IAAW,OAAO,CAAC,KAAc,IAAI,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7D;;;OAGG;IACI,MAAM;QACT,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IACnB,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,gBAAgB;QAC1B,OAAO;YACH,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACjE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC;SAClE,CAAC;IACN,CAAC;;AAsBL,WAAiB,MAAM;IACL,aAAM,GAAG,aAAa,CAAC;IACvB,gBAAS,GAAG,gBAAgB,CAAC;AAC/C,CAAC,EAHgB,MAAM,KAAN,MAAM,QAGtB;AACD,eAAe,MAAM,CAAC"}

package/build/server/config/ConfigLoader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config loader to the Vortez.
+ * @license Apache-2.0
+ */
+import Config from "./Config.js";
+export declare class ConfigLoader {
+    /**
+     * Loads the config from the given path.
+     * @param path - The path to the config file.
+     * @param defaultConfig - The default config to use if the config file does not exist.
+     * @returns A promise that resolves with the loaded config.
+     */
+    static load(path: string, defaultConfig?: Config | Config.options): Promise<Config>;
+    /**
+     * Saves the config to the given path.
+     * @param path - The path to the config file.
+     * @param config - The config to save.
+     * @returns A promise that resolves when the config is saved.
+     */
+    static save(path: string, config: Config): Promise<void>;
+}
+export declare namespace ConfigLoader { }
+export default ConfigLoader;

package/build/server/config/ConfigLoader.js

@@ -0,0 +1,53 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config loader to the Vortez.
+ * @license Apache-2.0
+ */
+import { promises as FSP } from "fs";
+import Logger from "../../logger/Logger.js";
+import Config from "./Config.js";
+import Utilities from "../../utilities/Utilities.js";
+import { ConfigValidator } from "./ConfigValidator.js";
+const logger = new Logger({ prefix: 'Config' });
+export class ConfigLoader {
+    /**
+     * Loads the config from the given path.
+     * @param path - The path to the config file.
+     * @param defaultConfig - The default config to use if the config file does not exist.
+     * @returns A promise that resolves with the loaded config.
+     */
+    static async load(path, defaultConfig = {}) {
+        logger.log(`loading config from &C6[${path}]`);
+        if (!await Utilities.fileExists(path)) {
+            const config = new Config(defaultConfig);
+            logger.log(`config file &C6[${path}]&R does not exist, creating it`);
+            await ConfigLoader.save(path, config);
+            logger.log(`config file &C6[${path}]&R &C2was created successfully`);
+            return config;
+        }
+        try {
+            const content = await FSP.readFile(path, 'utf8');
+            const data = JSON.parse(content);
+            const validatedConfig = ConfigValidator.validate(data);
+            return new Config(validatedConfig);
+        }
+        catch (error) {
+            logger.error(`config file &C6[${path}]&R &C1could not be loaded`);
+            throw error;
+        }
+    }
+    /**
+     * Saves the config to the given path.
+     * @param path - The path to the config file.
+     * @param config - The config to save.
+     * @returns A promise that resolves when the config is saved.
+     */
+    static async save(path, config) {
+        const dir = Utilities.Path.dirname(path);
+        await FSP.mkdir(dir, { recursive: true });
+        const content = config.toJson();
+        await FSP.writeFile(path, content, 'utf8');
+    }
+}
+export default ConfigLoader;
+//# sourceMappingURL=ConfigLoader.js.map

package/build/server/config/ConfigLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigLoader.js","sourceRoot":"","sources":["../../../src/server/config/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,SAAS,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAEhD,MAAM,OAAO,YAAY;IACrB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,gBAAyC,EAAE;QAC9E,MAAM,CAAC,GAAG,CAAC,2BAA2B,IAAI,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,mBAAmB,IAAI,iCAAiC,CAAC,CAAC;YACrE,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,mBAAmB,IAAI,iCAAiC,CAAC,CAAC;YACrE,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvD,OAAO,IAAI,MAAM,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,4BAA4B,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAAc;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;CACJ;AAED,eAAe,YAAY,CAAC"}

package/build/server/config/ConfigValidator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config validator to use in the config loader.
+ * @license Apache-2.0
+ */
+import Config from "./Config.js";
+export declare class ConfigValidator {
+    /**
+     * Validates the config.
+     * @param config - The config to validate.
+     * @returns The validated config.
+     */
+    static validate(config: Config.options): Config.Main;
+    /**
+     * Validates the host.
+     * @param host - The host to validate.
+     * @returns The validated host.
+     */
+    static validateHost(host: unknown): string;
+    /**
+     * Validates the port.
+     * @param port - The port to validate.
+     * @returns The validated port.
+     */
+    static validatePort(port: unknown): number;
+    /**
+     * Validates the templates.
+     * @param templates - The templates to validate.
+     * @returns The validated templates.
+     */
+    static validateTemplates(templates: unknown): Config.Templates;
+    /**
+     * Validates the ssl.
+     * @param ssl - The ssl to validate.
+     * @returns The validated ssl.
+     */
+    static validateSSL(ssl: unknown): Config.SSLOptions | null;
+    /**
+     * Validates a string value.
+     * @param value - The value to validate.
+     * @param defaultValue - The default value to use if the value is not a string.
+     * @param fieldName - The name of the field being validated.
+     * @returns The validated string value.
+     */
+    private static validateString;
+    /**
+     * Validates a number value.
+     * @param value - The value to validate.
+     * @param defaultValue - The default value to use if the value is not a number.
+     * @param fieldName - The name of the field being validated.
+     * @returns The validated number value.
+     */
+    private static validateNumber;
+    /**
+     * Validates a number value within a given range.
+     * @param value - The value to validate.
+     * @param min - The minimum value of the range.
+     * @param max - The maximum value of the range.
+     */
+    private static validateRange;
+    /**
+     * Validates a number value within a given range.
+     * @param value - The value to validate.
+     * @param min - The minimum value of the range.
+     * @param max - The maximum value of the range.
+     * @param defaultValue - The default value to use if the value is not a number or is out of range.
+     */
+    private static validateNumberInRange;
+}
+export declare namespace ConfigValidator { }
+export default ConfigValidator;

package/build/server/config/ConfigValidator.js

@@ -0,0 +1,131 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description add the config validator to use in the config loader.
+ * @license Apache-2.0
+ */
+import Config from "./Config.js";
+import Logger from "../../logger/Logger.js";
+const logger = new Logger({ prefix: 'Config' });
+export class ConfigValidator {
+    /**
+     * Validates the config.
+     * @param config - The config to validate.
+     * @returns The validated config.
+     */
+    static validate(config) {
+        const { host, port, ssl, templates } = config;
+        return {
+            host: this.validateHost(host),
+            port: this.validatePort(port),
+            ssl: this.validateSSL(ssl),
+            templates: this.validateTemplates(templates)
+        };
+    }
+    /**
+     * Validates the host.
+     * @param host - The host to validate.
+     * @returns The validated host.
+     */
+    static validateHost(host) {
+        return this.validateString(host, 'localhost', 'host');
+    }
+    /**
+     * Validates the port.
+     * @param port - The port to validate.
+     * @returns The validated port.
+     */
+    static validatePort(port) {
+        return this.validateNumberInRange(port, 0, 65535, Config.DEFAULT.port, 'port');
+    }
+    /**
+     * Validates the templates.
+     * @param templates - The templates to validate.
+     * @returns The validated templates.
+     */
+    static validateTemplates(templates) {
+        if (!templates || typeof templates !== 'object') {
+            logger.warn('templates must be an object, using defaults');
+            return Config.DEFAULT.templates;
+        }
+        const defTemplates = Config.DEFAULT.templates;
+        const templatesP = templates;
+        const result = {};
+        for (const key in defTemplates) {
+            result[key] = templatesP[key] != null ? templatesP[key] : defTemplates[key];
+        }
+        return result;
+    }
+    /**
+     * Validates the ssl.
+     * @param ssl - The ssl to validate.
+     * @returns The validated ssl.
+     */
+    static validateSSL(ssl) {
+        if (!ssl || typeof ssl !== 'object') {
+            return null;
+        }
+        const sslP = ssl;
+        const { pubKey, privKey, port = 443 } = sslP;
+        if (typeof pubKey !== 'string') {
+            logger.warn('ssl.pubKey must be a string, skipping ssl');
+            return Config.DEFAULT.ssl;
+        }
+        if (typeof privKey !== 'string') {
+            logger.warn('ssl.privKey must be a string, skipping ssl');
+            return Config.DEFAULT.ssl;
+        }
+        const validPort = this.validateNumberInRange(port, 0, 65535, 443, 'ssl.port');
+        return { pubKey, privKey, port: validPort };
+    }
+    /**
+     * Validates a string value.
+     * @param value - The value to validate.
+     * @param defaultValue - The default value to use if the value is not a string.
+     * @param fieldName - The name of the field being validated.
+     * @returns The validated string value.
+     */
+    static validateString(value, defaultValue, fieldName) {
+        if (typeof value === 'string')
+            return value;
+        logger.warn(`${fieldName} must be a string, using default: ${defaultValue}`);
+        return defaultValue;
+    }
+    /**
+     * Validates a number value.
+     * @param value - The value to validate.
+     * @param defaultValue - The default value to use if the value is not a number.
+     * @param fieldName - The name of the field being validated.
+     * @returns The validated number value.
+     */
+    static validateNumber(value, defaultValue, fieldName) {
+        if (typeof value === 'number')
+            return value;
+        logger.warn(`${fieldName} must be a number, using default: ${defaultValue}`);
+        return defaultValue;
+    }
+    /**
+     * Validates a number value within a given range.
+     * @param value - The value to validate.
+     * @param min - The minimum value of the range.
+     * @param max - The maximum value of the range.
+     */
+    static validateRange(value, min, max, defaultValue, fieldName) {
+        if (value >= min && value <= max)
+            return value;
+        logger.warn(`${fieldName} must be between ${min} and ${max}, using default: ${defaultValue}`);
+        return defaultValue;
+    }
+    /**
+     * Validates a number value within a given range.
+     * @param value - The value to validate.
+     * @param min - The minimum value of the range.
+     * @param max - The maximum value of the range.
+     * @param defaultValue - The default value to use if the value is not a number or is out of range.
+     */
+    static validateNumberInRange(value, min, max, defaultValue, fieldName) {
+        const num = this.validateNumber(value, defaultValue, fieldName);
+        return this.validateRange(num, min, max, defaultValue, fieldName);
+    }
+}
+export default ConfigValidator;
+//# sourceMappingURL=ConfigValidator.js.map

package/build/server/config/ConfigValidator.js.map

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

package/build/server/router/HttpRule.d.ts

@@ -0,0 +1,69 @@
+import Request from '../Request.js';
+import Response from '../Response.js';
+import BaseRule from './Rule.js';
+import HttpMiddleware from './middleware/HttpMiddleware.js';
+import Middleware from './middleware/Middleware.js';
+export declare class HttpRule extends BaseRule<HttpRule.action> {
+    method: Request.Method;
+    readonly middleware: HttpMiddleware;
+    /**
+     * Creates a routing rule for Vortez.
+     * @param method - The HTTP method of the rule.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param action - The executable content of the rule.
+     * @param middleware - The middleware to clone.
+     */
+    constructor(method: Request.Method, urlRule: string, action: HttpRule.action, middleware?: HttpMiddleware);
+    exec(request: Request, response: Response, state?: Middleware.State): void;
+    test(request: Request): boolean;
+    /**
+     * Adds a middleware to this specific rule.
+     * @param action The middleware action.
+     */
+    use(action: Middleware.action.http): this;
+    /**
+     * Adds a error middleware to this specific rule.
+     * @param action The middleware action.
+     */
+    useError(action: Middleware.errorAction.http): this;
+    /**
+     * Creates a routing rule to send a folder to the client.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param path - The path of the folder to send.
+     * @param middleware - The middleware to clone.
+     */
+    static folder(urlRule: string, path: string, middleware?: HttpMiddleware): HttpRule;
+    /**
+     * Creates a routing rule to send a file to the client.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param path - The path of the file to send.
+     * @param middleware - The middleware to clone.
+     */
+    static file(urlRule: string, path: string, middleware?: HttpMiddleware): HttpRule;
+    /**
+     * Creates a routing rule.
+     * @param method - The HTTP method of the rule.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param action - The executable content of the rule.
+     * @param middleware - The middleware to clone.
+     */
+    static action(method: Request.Method, urlRule: string, action: HttpRule.action, middleware?: HttpMiddleware): HttpRule;
+    /**
+     * Sends a folder to the client.
+     * @param path - The path of the folder to send.
+     * @param request - The incoming request.
+     * @param client - The client that made the request.
+     */
+    private static sendFolder;
+    /**
+     * Sends a file to the client.
+     * @param path - The path of the file to send.
+     * @param request - The incoming request.
+     * @param client - The client that made the request.
+     */
+    private static sendFile;
+}
+export declare namespace HttpRule {
+    type action = (request: Request, response: Response, state: Middleware.State) => void | Promise<void>;
+}
+export default HttpRule;

package/build/server/router/HttpRule.js

@@ -0,0 +1,96 @@
+import BaseRule from './Rule.js';
+import HttpMiddleware from './middleware/HttpMiddleware.js';
+export class HttpRule extends BaseRule {
+    method;
+    middleware;
+    /**
+     * Creates a routing rule for Vortez.
+     * @param method - The HTTP method of the rule.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param action - The executable content of the rule.
+     * @param middleware - The middleware to clone.
+     */
+    constructor(method, urlRule, action, middleware = new HttpMiddleware()) {
+        super(urlRule, action);
+        this.method = method;
+        this.middleware = middleware;
+    }
+    exec(request, response, state) {
+        request.ruleParams = this.getParams(request.url);
+        this.middleware.run(request, response, this.action, state);
+    }
+    test(request) {
+        return (this.method == request.method || this.method == 'ALL') && super.test(request);
+    }
+    /**
+     * Adds a middleware to this specific rule.
+     * @param action The middleware action.
+     */
+    use(action) {
+        this.middleware.use(action);
+        return this;
+    }
+    /**
+     * Adds a error middleware to this specific rule.
+     * @param action The middleware action.
+     */
+    useError(action) {
+        this.middleware.useError(action);
+        return this;
+    }
+    /**
+     * Creates a routing rule to send a folder to the client.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param path - The path of the folder to send.
+     * @param middleware - The middleware to clone.
+     */
+    static folder(urlRule, path, middleware) {
+        if (urlRule.endsWith('/'))
+            urlRule += '*';
+        if (!urlRule.endsWith('/*'))
+            urlRule += '/*';
+        const action = this.sendFolder.bind(this, path);
+        return new HttpRule('GET', urlRule, action, middleware);
+    }
+    /**
+     * Creates a routing rule to send a file to the client.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param path - The path of the file to send.
+     * @param middleware - The middleware to clone.
+     */
+    static file(urlRule, path, middleware) {
+        const action = this.sendFile.bind(this, path);
+        return new HttpRule('GET', urlRule, action, middleware);
+    }
+    /**
+     * Creates a routing rule.
+     * @param method - The HTTP method of the rule.
+     * @param urlRule - The URL rule adopted by this Rule instance.
+     * @param action - The executable content of the rule.
+     * @param middleware - The middleware to clone.
+     */
+    static action(method, urlRule, action, middleware) {
+        return new HttpRule(method, urlRule, action, middleware);
+    }
+    /**
+     * Sends a folder to the client.
+     * @param path - The path of the folder to send.
+     * @param request - The incoming request.
+     * @param client - The client that made the request.
+     */
+    static async sendFolder(path, request, client) {
+        const { $surplus = '' } = request.ruleParams;
+        await client.sendFolder(path, $surplus);
+    }
+    /**
+     * Sends a file to the client.
+     * @param path - The path of the file to send.
+     * @param request - The incoming request.
+     * @param client - The client that made the request.
+     */
+    static async sendFile(path, request, client) {
+        await client.sendFile(path);
+    }
+}
+export default HttpRule;
+//# sourceMappingURL=HttpRule.js.map