fiberx-backend-toolkit 0.1.6 → 0.1.7

package/dist/types/util_type.d.ts

@@ -74,3 +74,14 @@ export interface CachedContentInterface {
     app?: Record<string, any>;
     email?: Record<string, any>;
 }
+export type RSAKeySizeType = 2048 | 3072 | 4096;
+export type HashAlgorithmType = "sha256" | "sha384" | "sha512";
+export type EncodingType = "base64" | "hex";
+export interface RSAKeyPairResultInterface {
+    public_key: string;
+    private_key: string;
+}
+export interface ECKeyPairResultInterface {
+    public_key: string;
+    private_key: string;
+}

package/dist/utils/crypto_key_util.d.ts

@@ -0,0 +1,14 @@
+import { RSAKeySizeType, HashAlgorithmType, EncodingType, RSAKeyPairResultInterface, ECKeyPairResultInterface } from "../types/util_type";
+declare class CryptoKeyUtil {
+    private constructor();
+    static generateRSAKeyPair(modulus_length?: RSAKeySizeType): RSAKeyPairResultInterface;
+    static generateECKeyPair(named_curve?: "prime256v1" | "secp384r1" | "secp521r1"): ECKeyPairResultInterface;
+    static sign(payload: string, private_key: string, algorithm?: HashAlgorithmType, output_encoding?: EncodingType): string;
+    static verify(payload: string, signature: string, public_key: string, algorithm?: HashAlgorithmType, input_encoding?: EncodingType): boolean;
+    static encryptWithPublicKey(payload: string, public_key: string, output_encoding?: EncodingType): string;
+    static decryptWithPrivateKey(encrypted_payload: string, private_key: string, input_encoding?: EncodingType): string;
+    static hash(value: string, algorithm?: HashAlgorithmType, encoding?: EncodingType): string;
+    static generateRandomSecret(length?: number, encoding?: EncodingType): string;
+    static isValidPEM(key: string): boolean;
+}
+export default CryptoKeyUtil;

package/dist/utils/crypto_key_util.js

@@ -0,0 +1,127 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto_1 = __importStar(require("crypto"));
+class CryptoKeyUtil {
+    constructor() { }
+    /* ============================================================
+        RSA KEY GENERATION
+    ============================================================ */
+    static generateRSAKeyPair(modulus_length = 2048) {
+        const { publicKey: public_key, privateKey: private_key } = (0, crypto_1.generateKeyPairSync)("rsa", {
+            modulusLength: modulus_length,
+            publicKeyEncoding: {
+                type: "spki",
+                format: "pem"
+            },
+            privateKeyEncoding: {
+                type: "pkcs8",
+                format: "pem"
+            }
+        });
+        return { public_key, private_key };
+    }
+    /* ============================================================
+        EC KEY GENERATION (ES256 / ES384 etc)
+    ============================================================ */
+    static generateECKeyPair(named_curve = "prime256v1") {
+        const { publicKey: public_key, privateKey: private_key } = (0, crypto_1.generateKeyPairSync)("ec", {
+            namedCurve: named_curve,
+            publicKeyEncoding: {
+                type: "spki",
+                format: "pem"
+            },
+            privateKeyEncoding: {
+                type: "pkcs8",
+                format: "pem"
+            }
+        });
+        return { public_key, private_key };
+    }
+    /* ============================================================
+        SIGNING
+    ============================================================ */
+    static sign(payload, private_key, algorithm = "sha256", output_encoding = "base64") {
+        const signer = (0, crypto_1.createSign)(algorithm);
+        signer.update(payload);
+        signer.end();
+        return signer.sign(private_key, output_encoding);
+    }
+    static verify(payload, signature, public_key, algorithm = "sha256", input_encoding = "base64") {
+        const verifier = (0, crypto_1.createVerify)(algorithm);
+        verifier.update(payload);
+        verifier.end();
+        return verifier.verify(public_key, signature, input_encoding);
+    }
+    /* ============================================================
+        RSA ENCRYPTION / DECRYPTION
+    ============================================================ */
+    static encryptWithPublicKey(payload, public_key, output_encoding = "base64") {
+        const buffer = Buffer.from(payload, "utf8");
+        const encrypted = (0, crypto_1.publicEncrypt)({
+            key: public_key,
+            padding: crypto_1.default.constants.RSA_PKCS1_OAEP_PADDING
+        }, buffer);
+        return encrypted.toString(output_encoding);
+    }
+    static decryptWithPrivateKey(encrypted_payload, private_key, input_encoding = "base64") {
+        const buffer = Buffer.from(encrypted_payload, input_encoding);
+        const decrypted = (0, crypto_1.privateDecrypt)({
+            key: private_key,
+            padding: crypto_1.default.constants.RSA_PKCS1_OAEP_PADDING
+        }, buffer);
+        return decrypted.toString("utf8");
+    }
+    /* ============================================================
+        HASHING
+    ============================================================ */
+    static hash(value, algorithm = "sha256", encoding = "hex") {
+        return (0, crypto_1.createHash)(algorithm).update(value).digest(encoding);
+    }
+    /* ============================================================
+        RANDOM SECRET GENERATION
+    ============================================================ */
+    static generateRandomSecret(length = 32, encoding = "hex") {
+        return (0, crypto_1.randomBytes)(length).toString(encoding);
+    }
+    /* ============================================================
+        HELPER: PEM VALIDATION
+    ============================================================ */
+    static isValidPEM(key) {
+        return (key.includes("-----BEGIN") &&
+            key.includes("-----END"));
+    }
+}
+exports.default = CryptoKeyUtil;

package/dist/utils/main.d.ts

@@ -13,4 +13,5 @@ import ContentManagerUtil from "./content_manager_util";
 import FsActionsUtil from "./fs_actions_util";
 import EJSRenderUtil from "./ejs_render_util";
 import PLimitUtil from "./p_limit_util";
-export { LoggerUtil, InputTransformerUtil, InputValidatorUtil, EnvManagerUtil, SqlFormatterUtil, ServerUtil, SafeExecuteUtil, InMemoryCacheUtil, UUIDGeneratorUtil, EncryptorDecryptorUtil, TOTPServiceUtil, ContentManagerUtil, FsActionsUtil, EJSRenderUtil, PLimitUtil };
+import CryptoKeyUtil from "./crypto_key_util";
+export { LoggerUtil, InputTransformerUtil, InputValidatorUtil, EnvManagerUtil, SqlFormatterUtil, ServerUtil, SafeExecuteUtil, InMemoryCacheUtil, UUIDGeneratorUtil, EncryptorDecryptorUtil, TOTPServiceUtil, ContentManagerUtil, FsActionsUtil, EJSRenderUtil, PLimitUtil, CryptoKeyUtil };

package/dist/utils/main.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLimitUtil = exports.EJSRenderUtil = exports.FsActionsUtil = exports.ContentManagerUtil = exports.TOTPServiceUtil = exports.EncryptorDecryptorUtil = exports.UUIDGeneratorUtil = exports.InMemoryCacheUtil = exports.SafeExecuteUtil = exports.ServerUtil = exports.SqlFormatterUtil = exports.EnvManagerUtil = exports.InputValidatorUtil = exports.InputTransformerUtil = exports.LoggerUtil = void 0;
+exports.CryptoKeyUtil = exports.PLimitUtil = exports.EJSRenderUtil = exports.FsActionsUtil = exports.ContentManagerUtil = exports.TOTPServiceUtil = exports.EncryptorDecryptorUtil = exports.UUIDGeneratorUtil = exports.InMemoryCacheUtil = exports.SafeExecuteUtil = exports.ServerUtil = exports.SqlFormatterUtil = exports.EnvManagerUtil = exports.InputValidatorUtil = exports.InputTransformerUtil = exports.LoggerUtil = void 0;
 const logger_util_1 = __importDefault(require("./logger_util"));
 exports.LoggerUtil = logger_util_1.default;
 const input_transformer_util_1 = __importDefault(require("./input_transformer_util"));
@@ -34,3 +34,5 @@ const ejs_render_util_1 = __importDefault(require("./ejs_render_util"));
 exports.EJSRenderUtil = ejs_render_util_1.default;
 const p_limit_util_1 = __importDefault(require("./p_limit_util"));
 exports.PLimitUtil = p_limit_util_1.default;
+const crypto_key_util_1 = __importDefault(require("./crypto_key_util"));
+exports.CryptoKeyUtil = crypto_key_util_1.default;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fiberx-backend-toolkit",
-    "version": "0.1.6",
+    "version": "0.1.7",
     "description": "A TypeScript backend toolkit providing shared domain logic, infrastructure helpers, and utilities for FiberX server-side applications and services.",
     "type": "commonjs",
     "main": "./dist/index.js",