vortez 5.0.0-dev.15 → 5.0.0-dev.16

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

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add the config loader to the Vortez.
  * @license Apache-2.0
  */

package/build/server/config/ConfigLoader.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add the config loader to the Vortez.
  * @license Apache-2.0
  */

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

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add the config validator to use in the config loader.
  * @license Apache-2.0
  */

package/build/server/config/ConfigValidator.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add the config validator to use in the config loader.
  * @license Apache-2.0
  */

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

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the routing of the requests and WebSocket connections.
  * @license Apache-2.0
 */

package/build/server/router/Router.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the routing of the requests and WebSocket connections.
  * @license Apache-2.0
 */

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

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Contains routing rule logic for Vortez.
  * @license Apache-2.0
  */

package/build/server/router/Rule.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Contains routing rule logic for Vortez.
  * @license Apache-2.0
  */

package/build/server/router/middleware/HttpMiddleware.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the middleware pipeline for HttpRules.
  * @license Apache-2.0
  */

package/build/server/router/middleware/HttpMiddleware.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the middleware pipeline for HttpRules.
  * @license Apache-2.0
  */

package/build/server/router/middleware/Middleware.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the middleware pipeline.
  * @license Apache-2.0
  */

package/build/server/router/middleware/Middleware.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the middleware pipeline.
  * @license Apache-2.0
  */

package/build/server/router/middleware/WsMiddleware.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the middleware pipeline for WsRules.
  * @license Apache-2.0
  */

package/build/server/router/middleware/WsMiddleware.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Manages the middleware pipeline for WsRules.
  * @license Apache-2.0
  */

package/build/server/websocket/Chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Añade la forma de WebSockets a `Vortez`.
  * @license Apache-2.0
  */

package/build/server/websocket/Chunk.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Añade la forma de WebSockets a `Vortez`.
  * @license Apache-2.0
  */

package/build/server/websocket/Websocket.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description adds websocket functionality to Vortez
  * @license Apache-2.0
  */

package/build/server/websocket/Websocket.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description adds websocket functionality to Vortez
  * @license Apache-2.0
  */

package/build/utilities/ConsoleUI.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Provides utilities for console interaction, including text formatting and coloring.
  * @license Apache-2.0
  */

package/build/utilities/ConsoleUI.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Provides utilities for console interaction, including text formatting and coloring.
  * @license Apache-2.0
  */

package/build/utilities/DebugUI.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Utility to help with debugging tasks and server development.
  * @license Apache-2.0
  */

package/build/utilities/DebugUI.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Utility to help with debugging tasks and server development.
  * @license Apache-2.0
  */

package/build/utilities/Utilities.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add useful functions to the Vortez.
  * @license Apache-2.0
  */

package/build/utilities/Utilities.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add useful functions to the Vortez.
  * @license Apache-2.0
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vortez",
-  "version": "5.0.0-dev.15",
+  "version": "5.0.0-dev.16",
   "description": "a module for web server creation",
   "type": "module",
   "main": "build/Vortez.js",
@@ -9,11 +9,11 @@
     "test": "bash scripts/test.sh",
     "publish": "bash scripts/publish.sh",
     "dev": "bash scripts/dev.sh",
-    "dev.publish": "bash scripts/publish.sh"
+    "dev.publish": "bash scripts/publish.sh --dev"
   },
   "author": {
     "name": "NetFeez",
-    "email": "codefeez.dev@gmail.com",
+    "email": "netfeez.dev@gmail.com",
     "url": "https://NetFeez.github.io"
   },
   "license": "Apache-2.0",
@@ -33,12 +33,16 @@
     "README.md"
   ],
   "keywords": [
-    "web", "server",
-    "http", "https",
-    "ws", "wss", "websocket"
+    "web",
+    "server",
+    "http",
+    "https",
+    "ws",
+    "wss",
+    "websocket"
   ],
   "devDependencies": {
-    "@types/node": "^20.14.12",
-    "typescript": "^5.5.4"
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
   }
-}
+}

package/tests/jwtManager/jwtManager.js

@@ -1,108 +1,76 @@
-import { JwtManager } from "../../build/Beta/JwtManager/JwtManager.js";
-import CRYPTO from 'crypto';
-import Utilities from "../../build/Utilities.js";
+// @ts-check
+import JwtManager from "../../build/beta/JwtManager/JwtManager.js";
 import { strict as assert } from 'assert';
 
+/** @type { JwtManager.Algorithm.HashLength[] } */
 const MASKS = ['256', '384', '512'];
-const SECRET = 'secret';
 
-const { publicKey: RSA_PUB_KEY, privateKey: RSA_PRIV_KEY } = CRYPTO.generateKeyPairSync('rsa', {
-    modulusLength: 2048,
-    publicKeyEncoding: {
-        type: 'spki',
-        format: 'pem'
-    },
-    privateKeyEncoding: {
-        type: 'pkcs8',
-        format: 'pem'
-    }
-});
-
-const { publicKey: PSS_PUB_KEY, privateKey: PSS_PRIV_KEY } = CRYPTO.generateKeyPairSync('rsa-pss', {
-    modulusLength: 2048,
-    publicKeyEncoding: {
-        type: 'spki',
-        format: 'pem'
-    },
-    privateKeyEncoding: {
-        type: 'pkcs8',
-        format: 'pem'
-    }
-});
-
-const { publicKey: EC_PUB_KEY, privateKey: EC_PRIV_KEY } = CRYPTO.generateKeyPairSync('ec', {
-    namedCurve: 'secp256k1',
-    publicKeyEncoding: {
-        type: 'spki',
-        format: 'pem'
-    },
-    privateKeyEncoding: {
-        type: 'pkcs8',
-        format: 'pem'
-    }
-});
-
-const body = {
-    test: 'test',
-    XD: "xd"
-};
+const { pub: HMAC_PUB_KEY, key: SECRET }      = JwtManager.KeyGenerator.generate('secret');
+const { pub: RSA_PUB_KEY, key: RSA_PRIV_KEY } = JwtManager.KeyGenerator.generate('rsa');
+const { pub: PSS_PUB_KEY, key: PSS_PRIV_KEY } = JwtManager.KeyGenerator.generate('rsa-pss');
+const { pub: EC_PUB_KEY,  key: EC_PRIV_KEY }  = JwtManager.KeyGenerator.generate('ec');
 
-const options = {
-    expire: new Date(Date.now() + 10000)
+const payload = {
+    uuid: '00000000-0000-0000-0000-000000000000',
+    name: 'NetFeez',
+    email: 'netfeez.dev@gmail.com'
 };
 
-const testBase64UrlEncode = () => {
-    assert.equal(Utilities.base64UrlEncode('hello world'), 'aGVsbG8gd29ybGQ');
-    console.log('Utilities.base64UrlEncode passed');
+const header = {
+    exp: Math.floor((Date.now() + 10000) / 1000)
 };
-
-const testBase64UrlDecode = () => {
-    assert.equal(Utilities.base64UrlDecode('aGVsbG8gd29ybGQ'), 'hello world');
-    console.log('Utilities.base64UrlDecode passed');
-};
-
-const testJwtManagerSignVerify = (algorithm, key, pubKey) => {
-    const jwt = new JwtManager(algorithm, key);
+/**
+ * Tests the signing and verification of JWTs using the specified algorithm and key.
+ * @param { JwtManager.AlgorithmName } algorithm The name of the algorithm to be tested (e.g., 'HS256', 'RS256', etc.).
+ * @param {  string } key The secret key or private key to be used for signing and verifying JWTs.
+ * @param {  string | null } pubKey The public key to be used for verifying JWTs (required for asymmetric algorithms).
+ */
+const testJwtManagerSignVerify = (algorithm, key, pubKey = null) => {
+    const jwt = new JwtManager(algorithm, {
+        key: key,
+        pub: pubKey || null
+    });
     console.log('--------------------------')
-    const JWTObject = jwt.sign(body, options);
-    console.log('jwt:', JWTObject);
-    if (algorithm.startsWith('HS')) {
-        console.log('secret:', key);
-    } else {
+    const token = jwt.sign(payload, header);
+    console.log('jwt:', token);
+    /* if (algorithm.startsWith('HS')) console.log('secret:', key);
+    else {
         console.log('Private Key:', key);
-        if (pubKey) {
-            console.log('Public Key:', pubKey);
-        }
+        if (pubKey) console.log('Public Key:', pubKey);
+    } */
+    try {
+        const parsed = jwt.parse(token);
+        console.log(parsed, '\n');
+        assert.deepEqual(parsed.payload, payload);
+        console.log(`${algorithm} test passed`);
+    } catch (error) {
+        console.error(`${algorithm} test failed:`, error);
     }
-    const verificationResult = jwt.verify(JWTObject);
-    console.log(verificationResult, '\n');
-    assert.equal(verificationResult.verify, true);
-    assert.deepEqual(verificationResult.body, body);
-    console.log(`${algorithm} test passed`);
 };
 
 const runTests = () => {
     try {
-        testBase64UrlEncode();
-        testBase64UrlDecode();
-
         for (let index = 0; index < MASKS.length; index++) {
-            const algorithm = 'HS' + MASKS[index];
+            /** @type { JwtManager.AlgorithmName } */
+            const algorithm = `HS${MASKS[index]}`;
             testJwtManagerSignVerify(algorithm, SECRET);
 
-            const algorithmRS = 'RS' + MASKS[index];
+            /** @type { JwtManager.AlgorithmName } */
+            const algorithmRS = `RS${MASKS[index]}`;
             testJwtManagerSignVerify(algorithmRS, RSA_PRIV_KEY, RSA_PUB_KEY);
 
-            const algorithmPS = 'PS' + MASKS[index];
+            /** @type { JwtManager.AlgorithmName } */
+            const algorithmPS = `PS${MASKS[index]}`;
             testJwtManagerSignVerify(algorithmPS, PSS_PRIV_KEY, PSS_PUB_KEY);
 
-            const algorithmES = 'ES' + MASKS[index];
+            /** @type { JwtManager.AlgorithmName } */
+            const algorithmES = `ES${MASKS[index]}`;
             testJwtManagerSignVerify(algorithmES, EC_PRIV_KEY, EC_PUB_KEY);
         }
 
         console.log('All tests passed');
     } catch (error) {
-        console.error('Test failed:', error.message);
+        console.error('Test failed:', error);
     }
 };
 

package/build/beta/JwtManager.d.ts

@@ -1,114 +0,0 @@
-/**
- * @author NetFeez <codefeez.dev@gmail.com>
- * @description add the json web token manager to the Vortez.
- * @license Apache-2.0
- */
-export declare class JwtManager {
-    private static validSignMethods;
-    private static validMaskMethods;
-    private static signMethodMap;
-    private static maskMethodMap;
-    private algorithm;
-    private signMethod;
-    private maskMethod;
-    private privKey;
-    private pubKey;
-    /**
-     * create a new jwt manager
-     * @param algorithm the algorithm to use
-     * @param key the private key or secret to use
-     * @throws an error if the algorithm is not valid
-     * @throws an error if the key/secret is not valid
-     */
-    constructor(algorithm: JwtManager.jwtAlgorithms, key: string);
-    /**
-     * sign a jwt
-     * @param body the body of the jwt
-     * @param options the options to sign the jwt
-     * @returns the signed jwt
-     */
-    sign(body: JwtManager.body, options?: JwtManager.signOptions): string;
-    /**
-     * verify a jwt
-     * @param jwt the jwt to verify
-     * @param options the options to verify the jwt
-     * @returns the verified jwt
-     */
-    parse(jwt: string, options?: JwtManager.verifyOptions): JwtManager.jwtObject;
-    /**
-     * sign a jwt
-     * @param body the body of the jwt
-     * @param options the options to sign the jwt
-     * @returns the signed jwt
-     * @throws an error if the algorithm is not valid
-     * @throws an error if the key/secret is not valid
-     */
-    static sign(body: JwtManager.body, algorithm: JwtManager.jwtAlgorithms, privKey: string, options: JwtManager.signOptions): string;
-    /**
-     * verify a jwt
-     * @param jwt the jwt to verify
-     * @param options the options to verify the jwt
-     * @returns the verified jwt
-     * @throws an error if the algorithm is not valid
-     * @throws an error if the key/secret is not valid
-     */
-    static parse(jwt: string, pubKey: string, options?: JwtManager.verifyOptions): JwtManager.jwtObject;
-    /**
-     * validate an private key
-     * @param signMethod the sign method
-     * @param key the private key
-     * @param sendThrows whether to throw an error if the private key is invalid
-     * @returns true if the private key is valid
-     * @throws an error if the private key is invalid
-     */
-    private static validateKey;
-    private static getPubKey;
-    private static getAlgorithmInfo;
-}
-export declare namespace JwtManager {
-    type signMethods = 'HMAC' | 'RSA' | 'ECDSA' | 'RSA-PSS';
-    type maskMethods = 'SHA256' | 'SHA384' | 'SHA512';
-    type jwtSignMethods = 'HS' | 'RS' | 'PS' | 'ES';
-    type jwtMaskMethods = '256' | '384' | '512';
-    type jwtAlgorithms = `${jwtSignMethods}${jwtMaskMethods}`;
-    interface signMethodMap {
-        HS: 'HMAC';
-        RS: 'RSA';
-        PS: 'RSA-PSS';
-        ES: 'ECDSA';
-    }
-    interface maskMethodMap {
-        '256': 'SHA256';
-        '384': 'SHA384';
-        '512': 'SHA512';
-    }
-    interface algorithmInfo {
-        signMethod?: signMethods;
-        maskMethod?: maskMethods;
-    }
-    interface headers {
-        exp?: number;
-        [key: string]: any | undefined;
-    }
-    interface head extends headers {
-        alg: jwtAlgorithms;
-        typ: 'JWT';
-    }
-    interface body {
-        [key: string]: any | undefined;
-    }
-    interface jwtObject {
-        body: body;
-        head: head;
-        signature: string;
-        verify: boolean;
-    }
-    interface verifyOptions {
-        expire?: boolean;
-    }
-    interface signOptions {
-        expire?: Date;
-        [key: string]: any | undefined;
-    }
-}
-export default JwtManager;