vortez 5.0.0-dev.14 → 5.0.0-dev.16

package/build/beta/JwtManager/algorithm/Algorithm.js

@@ -0,0 +1,82 @@
+import { createPublicKey } from 'crypto';
+export class Algorithm {
+    hashLength;
+    /** The private key used for signing and verification. */
+    key;
+    /** The public key used for verification. */
+    pub;
+    role;
+    constructor(hashLength, secret) {
+        this.hashLength = hashLength;
+        const { key, pub } = this.normalizeKey(secret);
+        if (!pub && !key)
+            throw new Error('At least one of "key" or "pub" must be provided.');
+        this.role = pub && !key ? 'verifier' : 'signer';
+        this.key = key;
+        this.pub = pub;
+        Object.defineProperty(this, 'key', { enumerable: false });
+        Object.defineProperty(this, 'pub', { enumerable: false });
+    }
+    normalizeKey(key) {
+        return Algorithm.normalizeKey(key);
+    }
+    /** Gets the name of the hash algorithm based on the specified hash length. */
+    get hashName() { return `SHA-${this.hashLength}`; }
+    toJSON() { return {}; }
+    toString() { return `Algorithm hash with "${this.hashName}" with role "${this.role}"`; }
+    /**
+     * Normalizes the provided key input into a consistent format, ensuring that both the private and public keys are available as Buffers.
+     * @param key The key input, which can be either a string, a Buffer, or an object containing "key" and/or "pub" properties.
+     * @returns An object containing the normalized private key ("key") and public key ("pub") as Buffers. If only one key is provided, it will be used for both.
+     */
+    static normalizeKey(key) {
+        if (typeof key === 'string')
+            return { key, pub: null };
+        const priv = key.key || null;
+        const pub = key.pub || null;
+        if (!pub && !priv)
+            throw new Error('At least one of "key" or "pub" must be provided.');
+        return { key: priv, pub };
+    }
+    /**
+     * Converts a key, which can be either a string or a Buffer, into a Buffer format.
+     * @param key The key to be converted, which can be a string or a Buffer.
+     * @returns The key in Buffer format.
+     */
+    static keyToBuffer(key) {
+        return Buffer.isBuffer(key) ? key : Buffer.from(key);
+    }
+    /**
+     * Asserts that the provided key is a valid Buffer. If the key is not valid, an error is thrown with the specified message.
+     * @param key The key to be validated, which can be of any type.
+     * @param message The error message to be thrown if the key is not a valid Buffer.
+     * @throws Will throw an error if the key is not provided or if it is not a Buffer.
+     */
+    static assertKey(key, message) {
+        if (!key)
+            throw new Error(message);
+        if (typeof key !== 'string')
+            throw new Error(message);
+    }
+    /**
+     * Asserts that the provided key is of the expected asymmetric key type (e.g., "rsa", "ec").
+     * If the key is not of the expected type, an error is thrown with the specified message.
+     * @param key The key to be validated, which should be a Buffer containing the key data.
+     * @param expected The expected asymmetric key type (e.g., "rsa", "ec").
+     * @param message The error message to be thrown if the key is not of the expected type.
+     * @throws Will throw an error if the key is not a valid asymmetric key of the expected type.
+     */
+    static assertKeyType(key, expected, message) {
+        try {
+            const KeyObject = createPublicKey(key);
+            if (KeyObject.asymmetricKeyType !== expected)
+                throw new Error();
+            return KeyObject;
+        }
+        catch {
+            throw new Error(message);
+        }
+    }
+}
+export default Algorithm;
+//# sourceMappingURL=Algorithm.js.map

package/build/beta/JwtManager/algorithm/Algorithm.js.map

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

package/build/beta/JwtManager/algorithm/ECDSA.d.ts

@@ -0,0 +1,18 @@
+import Algorithm from './Algorithm.js';
+export declare class ECDSA extends Algorithm {
+    normalizeKey(key: Algorithm.Key | Algorithm.KeyOptions): Algorithm.KeyObject;
+    /**
+     * Signs the given payload using the ECDSA algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The ECDSA signature of the payload, encoded in base64.
+     */
+    sign(payload: string): string;
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload: string, signature: string): boolean;
+}
+export default ECDSA;

package/build/beta/JwtManager/algorithm/ECDSA.js

@@ -0,0 +1,46 @@
+import { sign, verify } from 'crypto';
+import Algorithm from './Algorithm.js';
+export class ECDSA extends Algorithm {
+    normalizeKey(key) {
+        let { key: priv, pub } = super.normalizeKey(key);
+        if (pub)
+            Algorithm.assertKeyType(pub, 'ec', 'Provided public key is not an EC key.');
+        if (priv) {
+            const keyObject = Algorithm.assertKeyType(priv, 'ec', 'Provided private key is not an EC key.');
+            if (!pub)
+                pub = keyObject.export({ type: 'spki', format: 'pem' });
+        }
+        return { key: priv, pub };
+    }
+    /**
+     * Signs the given payload using the ECDSA algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The ECDSA signature of the payload, encoded in base64.
+     */
+    sign(payload) {
+        Algorithm.assertKey(this.key, 'No key provided for ECDSA signing');
+        const plBuffer = Buffer.from(payload, 'utf-8');
+        const signature = sign(this.hashName, plBuffer, {
+            key: this.key,
+            dsaEncoding: 'ieee-p1363'
+        });
+        return signature.toString('base64url');
+    }
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload, signature) {
+        Algorithm.assertKey(this.pub, 'No public key provided for ECDSA verification');
+        const plBuffer = Buffer.from(payload, 'utf-8');
+        const sigBuffer = Buffer.from(signature, 'base64url');
+        return verify(this.hashName, plBuffer, {
+            key: this.pub,
+            dsaEncoding: 'ieee-p1363'
+        }, sigBuffer);
+    }
+}
+export default ECDSA;
+//# sourceMappingURL=ECDSA.js.map

package/build/beta/JwtManager/algorithm/ECDSA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECDSA.js","sourceRoot":"","sources":["../../../../src/beta/JwtManager/algorithm/ECDSA.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AACjD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,OAAO,KAAM,SAAQ,SAAS;IACzB,YAAY,CAAC,GAAyC;QACzD,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,uCAAuC,CAAC,CAAC;QACrF,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,wCAAwC,CAAC,CAAC;YAChG,IAAI,CAAC,GAAG;gBAAE,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC9B,CAAC;IACD;;;;OAIG;IACI,IAAI,CAAC,OAAe;QACvB,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,mCAAmC,CAAC,CAAC;QAEnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YAC5C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,WAAW,EAAE,YAAY;SAC5B,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,OAAe,EAAE,SAAiB;QAC5C,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,+CAA+C,CAAC,CAAC;QAE/E,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACnC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,WAAW,EAAE,YAAY;SAC5B,EAAE,SAAS,CAAC,CAAC;IAClB,CAAC;CACJ;AACD,eAAe,KAAK,CAAC"}

package/build/beta/JwtManager/algorithm/HMAC.d.ts

@@ -0,0 +1,24 @@
+import Algorithm from './Algorithm.js';
+export declare class HMAC extends Algorithm {
+    /**
+     * Normalizes the provided key for HMAC operations.
+     * Since HMAC uses a single secret key for both signing and verification, this method ensures that the same key is used for both operations.
+     * @param key The key to be normalized, which can be either a secret key or an object containing key options.
+     * @returns An object containing the normalized key for both signing and verification.
+     */
+    protected normalizeKey(key: Algorithm.Key | Algorithm.KeyOptions): Algorithm.KeyObject;
+    /**
+     * Signs the given payload using the HMAC algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The HMAC signature of the payload, encoded in base64.
+     */
+    sign(payload: string): string;
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload: string, signature: string): boolean;
+}
+export default HMAC;

package/build/beta/JwtManager/algorithm/HMAC.js

@@ -0,0 +1,38 @@
+import { createHmac } from 'crypto';
+import Algorithm from './Algorithm.js';
+export class HMAC extends Algorithm {
+    /**
+     * Normalizes the provided key for HMAC operations.
+     * Since HMAC uses a single secret key for both signing and verification, this method ensures that the same key is used for both operations.
+     * @param key The key to be normalized, which can be either a secret key or an object containing key options.
+     * @returns An object containing the normalized key for both signing and verification.
+     */
+    normalizeKey(key) {
+        const { key: priv, pub } = super.normalizeKey(key);
+        const secret = priv || pub;
+        return { key: secret, pub: secret };
+    }
+    /**
+     * Signs the given payload using the HMAC algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The HMAC signature of the payload, encoded in base64.
+     */
+    sign(payload) {
+        Algorithm.assertKey(this.key, 'No key provided for HMAC signing');
+        const hmac = createHmac(this.hashName, this.key);
+        hmac.update(payload);
+        return hmac.digest('base64url');
+    }
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload, signature) {
+        const expectedSignature = this.sign(payload);
+        return expectedSignature === signature;
+    }
+}
+export default HMAC;
+//# sourceMappingURL=HMAC.js.map

package/build/beta/JwtManager/algorithm/HMAC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HMAC.js","sourceRoot":"","sources":["../../../../src/beta/JwtManager/algorithm/HMAC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,OAAO,IAAK,SAAQ,SAAS;IAC/B;;;;;OAKG;IACO,YAAY,CAAC,GAAyC;QAC5D,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC;QAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACxC,CAAC;IACD;;;;OAIG;IACI,IAAI,CAAC,OAAe;QACvB,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC;QAElE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,OAAe,EAAE,SAAiB;QAC5C,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,iBAAiB,KAAK,SAAS,CAAC;IAC3C,CAAC;CACJ;AACD,eAAe,IAAI,CAAC"}

package/build/beta/JwtManager/algorithm/RSA.d.ts

@@ -0,0 +1,24 @@
+import Algorithm from './Algorithm.js';
+export declare class RSA extends Algorithm {
+    /**
+     * Normalizes the provided key for RSA operations.
+     * This method ensures that the provided keys are valid RSA keys and extracts the public key from the private key if only the private key is provided.
+     * @param key The key to be normalized, which can be either a private key, a public key, or an object containing both.
+     * @returns An object containing the normalized private key ("key") and public key ("pub") as Buffers. If only the private key is provided, the corresponding public key will be extracted and included in the result.
+     */
+    protected normalizeKey(key: Algorithm.Key | Algorithm.KeyOptions): Algorithm.KeyObject;
+    /**
+     * Signs the given payload using the RSA algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The RSA signature of the payload, encoded in base64.
+     */
+    sign(payload: string): string;
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload: string, signature: string): boolean;
+}
+export default RSA;

package/build/beta/JwtManager/algorithm/RSA.js

@@ -0,0 +1,52 @@
+import { sign, verify, constants } from 'crypto';
+import Algorithm from './Algorithm.js';
+export class RSA extends Algorithm {
+    /**
+     * Normalizes the provided key for RSA operations.
+     * This method ensures that the provided keys are valid RSA keys and extracts the public key from the private key if only the private key is provided.
+     * @param key The key to be normalized, which can be either a private key, a public key, or an object containing both.
+     * @returns An object containing the normalized private key ("key") and public key ("pub") as Buffers. If only the private key is provided, the corresponding public key will be extracted and included in the result.
+     */
+    normalizeKey(key) {
+        let { key: priv, pub } = super.normalizeKey(key);
+        if (pub)
+            Algorithm.assertKeyType(pub, 'rsa', 'Provided public key is not an RSA key.');
+        if (priv) {
+            const keyObject = Algorithm.assertKeyType(priv, 'rsa', 'Provided private key is not an RSA key.');
+            if (!pub)
+                pub = keyObject.export({ type: 'spki', format: 'pem' });
+        }
+        return { key: priv, pub };
+    }
+    /**
+     * Signs the given payload using the RSA algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The RSA signature of the payload, encoded in base64.
+     */
+    sign(payload) {
+        Algorithm.assertKey(this.key, 'No key provided for RSA signing');
+        const plBuffer = Buffer.from(payload, 'utf-8');
+        const signature = sign(this.hashName, plBuffer, {
+            key: this.key,
+            padding: constants.RSA_PKCS1_PADDING
+        });
+        return signature.toString('base64url');
+    }
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload, signature) {
+        Algorithm.assertKey(this.pub, 'No public key provided for RSA verification');
+        const plBuffer = Buffer.from(payload, 'utf-8');
+        const sigBuffer = Buffer.from(signature, 'base64url');
+        return verify(this.hashName, plBuffer, {
+            key: this.pub,
+            padding: constants.RSA_PKCS1_PADDING
+        }, sigBuffer);
+    }
+}
+export default RSA;
+//# sourceMappingURL=RSA.js.map

package/build/beta/JwtManager/algorithm/RSA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RSA.js","sourceRoot":"","sources":["../../../../src/beta/JwtManager/algorithm/RSA.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,OAAO,GAAI,SAAQ,SAAS;IAC9B;;;;;OAKG;IACO,YAAY,CAAC,GAAyC;QAC5D,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,wCAAwC,CAAC,CAAC;QACvF,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,yCAAyC,CAAC,CAAC;YAClG,IAAI,CAAC,GAAG;gBAAE,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC9B,CAAC;IACD;;;;OAIG;IACI,IAAI,CAAC,OAAe;QACvB,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YAC5C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,SAAS,CAAC,iBAAiB;SACvC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,OAAe,EAAE,SAAiB;QAC5C,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC;QAE7E,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACnC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,SAAS,CAAC,iBAAiB;SACvC,EAAE,SAAS,CAAC,CAAC;IAClB,CAAC;CACJ;AACD,eAAe,GAAG,CAAC"}

package/build/beta/JwtManager/algorithm/RSAPSS.d.ts

@@ -0,0 +1,24 @@
+import Algorithm from './Algorithm.js';
+export declare class RSAPSS extends Algorithm {
+    /**
+     * Normalizes the provided key for RSA-PSS operations.
+     * This method ensures that the provided keys are valid RSA-PSS keys and extracts the public key from the private key if only the private key is provided.
+     * @param key The key to be normalized, which can be either a private key, a public key, or an object containing both.
+     * @returns An object containing the normalized private key ("key") and public key ("pub") as Buffers. If only the private key is provided, the corresponding public key will be extracted and included in the result.
+     */
+    protected normalizeKey(key: Algorithm.Key | Algorithm.KeyOptions): Algorithm.KeyObject;
+    /**
+     * Signs the given payload using the RSA-PSS algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The RSA-PSS signature of the payload, encoded in base64.
+     */
+    sign(payload: string): string;
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload: string, signature: string): boolean;
+}
+export default RSAPSS;

package/build/beta/JwtManager/algorithm/RSAPSS.js

@@ -0,0 +1,55 @@
+import { sign, verify, constants } from 'crypto';
+import Algorithm from './Algorithm.js';
+export class RSAPSS extends Algorithm {
+    /**
+     * Normalizes the provided key for RSA-PSS operations.
+     * This method ensures that the provided keys are valid RSA-PSS keys and extracts the public key from the private key if only the private key is provided.
+     * @param key The key to be normalized, which can be either a private key, a public key, or an object containing both.
+     * @returns An object containing the normalized private key ("key") and public key ("pub") as Buffers. If only the private key is provided, the corresponding public key will be extracted and included in the result.
+     */
+    normalizeKey(key) {
+        // For RSA-PSS, the same key pair is used as for RSA, so we can reuse the normalization logic from the RSA algorithm. more info in file KeyGenerator.ts (method RSAPSS)
+        let { key: priv, pub } = super.normalizeKey(key);
+        if (pub)
+            Algorithm.assertKeyType(pub, /* 'rsa-pss' */ 'rsa', 'Provided public key is not an RSA-PSS key.');
+        if (priv) {
+            const keyObject = Algorithm.assertKeyType(priv, /* 'rsa-pss' */ 'rsa', 'Provided private key is not an RSA-PSS key.');
+            if (!pub)
+                pub = keyObject.export({ type: 'spki', format: 'pem' });
+        }
+        return { key: priv, pub };
+    }
+    /**
+     * Signs the given payload using the RSA-PSS algorithm and the provided key.
+     * @param payload The payload to be signed.
+     * @returns The RSA-PSS signature of the payload, encoded in base64.
+     */
+    sign(payload) {
+        Algorithm.assertKey(this.key, 'No key provided for RSA-PSS signing');
+        const plBuffer = Buffer.from(payload, 'utf-8');
+        const signature = sign(this.hashName, plBuffer, {
+            key: this.key,
+            padding: constants.RSA_PKCS1_PSS_PADDING,
+            saltLength: constants.RSA_PSS_SALTLEN_DIGEST
+        });
+        return signature.toString('base64url');
+    }
+    /**
+     * Verifies that the provided signature matches the expected signature for the given payload.
+     * @param payload The payload whose signature is to be verified.
+     * @param signature The signature to be verified, encoded in base64.
+     * @returns `true` if the signature is valid; otherwise, `false`.
+     */
+    verify(payload, signature) {
+        Algorithm.assertKey(this.pub, 'No public key provided for RSA-PSS verification');
+        const plBuffer = Buffer.from(payload, 'utf-8');
+        const sigBuffer = Buffer.from(signature, 'base64url');
+        return verify(this.hashName, plBuffer, {
+            key: this.pub,
+            padding: constants.RSA_PKCS1_PSS_PADDING,
+            saltLength: constants.RSA_PSS_SALTLEN_DIGEST
+        }, sigBuffer);
+    }
+}
+export default RSAPSS;
+//# sourceMappingURL=RSAPSS.js.map

package/build/beta/JwtManager/algorithm/RSAPSS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RSAPSS.js","sourceRoot":"","sources":["../../../../src/beta/JwtManager/algorithm/RSAPSS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,OAAO,MAAO,SAAQ,SAAS;IACjC;;;;;OAKG;IACO,YAAY,CAAC,GAAyC;QAC5D,uKAAuK;QACvK,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,EAAE,4CAA4C,CAAC,CAAC;QAC3G,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,EAAE,6CAA6C,CAAC,CAAC;YACtH,IAAI,CAAC,GAAG;gBAAE,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC9B,CAAC;IACD;;;;OAIG;IACI,IAAI,CAAC,OAAe;QACvB,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,qCAAqC,CAAC,CAAC;QAErE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YAC5C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,SAAS,CAAC,qBAAqB;YACxC,UAAU,EAAE,SAAS,CAAC,sBAAsB;SAC/C,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,OAAe,EAAE,SAAiB;QAC5C,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,iDAAiD,CAAC,CAAC;QAEjF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACnC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,SAAS,CAAC,qBAAqB;YACxC,UAAU,EAAE,SAAS,CAAC,sBAAsB;SAC/C,EAAE,SAAS,CAAC,CAAC;IAClB,CAAC;CACJ;AACD,eAAe,MAAM,CAAC"}

package/build/beta/Mail.d.ts

@@ -1,6 +1,6 @@
 /**
  * @file
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add the mail sender to the Vortez.
  * @license Apache-2.0
  */

package/build/beta/Mail.js

@@ -1,6 +1,6 @@
 /**
  * @file
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description add the mail sender to the Vortez.
  * @license Apache-2.0
  */

package/build/logger/Debug.d.ts

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

package/build/logger/Debug.js

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

package/build/logger/Logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a logger class to have organized logs.
  * @license Apache-2.0
 */

package/build/logger/Logger.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a logger class to have organized logs.
  * @license Apache-2.0
 */

package/build/server/BodyParser.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds the POST parser form of `Vortez`.
  * @license Apache-2.0
  */

package/build/server/BodyParser.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds the POST parser form of `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Cookie.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a cookie system to `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Cookie.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a cookie system to `Vortez`.
  * @license Apache-2.0
  */

package/build/server/LoggerManager.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a logger manager to have an instance of the Vortez loggers.
  * @license Apache-2.0
  */

package/build/server/LoggerManager.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a logger manager to have an instance of the Vortez loggers.
  * @license Apache-2.0
  */

package/build/server/Request.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds the Request form of `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Request.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds the Request form of `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Response.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds the response format to `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Response.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds the response format to `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Server.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a simple way to create HTTP/S and WS/S servers.
  * @license Apache-2.0
  */

package/build/server/Server.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a simple way to create HTTP/S and WS/S servers.
  * @license Apache-2.0
  */

package/build/server/ServerDebug.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/server/ServerDebug.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/server/Session.d.ts

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a session system to `Vortez`.
  * @license Apache-2.0
  */

package/build/server/Session.js

@@ -1,5 +1,5 @@
 /**
- * @author NetFeez <codefeez.dev@gmail.com>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @description Adds a session system to `Vortez`.
  * @license Apache-2.0
  */

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

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

package/build/server/config/Config.js

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

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
  */