@futdevpro/fsm-dynamo 1.10.31 → 1.10.33

package/build/_modules/crypto/_collections/crypto.util.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Error codes for crypto operations
+ */
+export declare enum CryptoErrorCode {
+    INVALID_INPUT = "DyFM-CRY-EA0",
+    DECRYPTION_FAILED = "DyFM-CRY-DRY",
+    ENCRYPTION_FAILED = "DyFM-CRY-ENF",
+    INVALID_KEY = "DyFM-CRY-IKY",
+    INVALID_DATA = "DyFM-CRY-IDT"
+}
+/**
+ * Configuration options for encryption/decryption
+ */
+export interface CryptoConfig {
+    ivLength?: number;
+    saltLength?: number;
+    keyIterations?: number;
+    keySize?: number;
+}
+/**
+ * A utility class for secure encryption and decryption of data
+ * Uses AES-256-CBC with PBKDF2 key derivation
+ */
+export declare class DyFM_Crypto {
+    private static readonly DEFAULT_CONFIG;
+    /**
+     * Validates the input data and key
+     * @throws {DyFM_Error} if validation fails
+     */
+    private static validateInput;
+    /**
+     * Generates a secure random padding
+     * @param length Length of the padding in bytes
+     */
+    private static generatePadding;
+    /**
+     * Derives a key using PBKDF2
+     * @param key The input key
+     * @param salt The salt to use
+     * @param config Configuration options
+     */
+    private static deriveKey;
+    /**
+     * Safely serializes data to JSON
+     * @param data The data to serialize
+     * @returns Serialized data as string
+     */
+    private static safeSerialize;
+    /**
+     * Safely deserializes JSON data
+     * @param data The JSON string to deserialize
+     * @returns Deserialized data
+     */
+    private static safeDeserialize;
+    /**
+     * Encrypts data using AES-256-CBC
+     * @param data The data to encrypt
+     * @param key The encryption key
+     * @param config Optional configuration
+     * @returns URL-safe encrypted string
+     * @throws {DyFM_Error} if encryption fails
+     */
+    static encrypt<T>(data: T, key: string, config?: CryptoConfig): string;
+    /**
+     * Decrypts data that was encrypted using encrypt()
+     * @param encryptedData The encrypted data
+     * @param key The decryption key
+     * @param config Optional configuration
+     * @returns The decrypted data
+     * @throws {DyFM_Error} if decryption fails
+     */
+    static decrypt<T>(encryptedData: string, key: string, config?: CryptoConfig): T;
+    /**
+     * Generates a secure random key
+     * @param length Length of the key in bytes (default: 32)
+     * @returns A secure random key
+     */
+    static generateKey(length?: number): string;
+    /**
+     * Validates if a string is a valid encrypted data
+     * @param encryptedData The data to validate
+     * @returns true if the data appears to be valid encrypted data
+     */
+    static isValidEncryptedData(encryptedData: string): boolean;
+}
+//# sourceMappingURL=crypto.util.d.ts.map

package/build/_modules/crypto/_collections/crypto.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/crypto/_collections/crypto.util.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,oBAAY,eAAe;IACzB,aAAa,iBAAiB;IAC9B,iBAAiB,iBAAiB;IAClC,iBAAiB,iBAAiB;IAClC,WAAW,iBAAiB;IAC5B,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAKpC;IAMF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAkB5B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAOxB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAyCtE;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,CAAC;IAoD/E;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAI/C;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;CAM5D"}

package/build/_modules/crypto/_collections/crypto.util.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_Crypto = exports.CryptoErrorCode = void 0;
+const tslib_1 = require("tslib");
+const CryptoJS = tslib_1.__importStar(require("crypto-js"));
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * Error codes for crypto operations
+ */
+var CryptoErrorCode;
+(function (CryptoErrorCode) {
+    CryptoErrorCode["INVALID_INPUT"] = "DyFM-CRY-EA0";
+    CryptoErrorCode["DECRYPTION_FAILED"] = "DyFM-CRY-DRY";
+    CryptoErrorCode["ENCRYPTION_FAILED"] = "DyFM-CRY-ENF";
+    CryptoErrorCode["INVALID_KEY"] = "DyFM-CRY-IKY";
+    CryptoErrorCode["INVALID_DATA"] = "DyFM-CRY-IDT";
+})(CryptoErrorCode || (exports.CryptoErrorCode = CryptoErrorCode = {}));
+/**
+ * A utility class for secure encryption and decryption of data
+ * Uses AES-256-CBC with PBKDF2 key derivation
+ */
+class DyFM_Crypto {
+    static DEFAULT_CONFIG = {
+        ivLength: 16,
+        saltLength: 16,
+        keyIterations: 10000,
+        keySize: 256 / 32
+    };
+    // Tömör: kb. 60–80 karakteres token, nem 200+
+    // Nem szabványos: nehéz visszafejteni
+    // Használható cookie, header, URL-ben
+    /**
+     * Validates the input data and key
+     * @throws {DyFM_Error} if validation fails
+     */
+    static validateInput(data, key) {
+        if (data === undefined || data === null) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'Data is required',
+                error: new Error('Data is required'),
+                errorCode: CryptoErrorCode.INVALID_DATA
+            });
+        }
+        if (!key || typeof key !== 'string' || key.trim().length === 0) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'Valid key is required',
+                error: new Error('Key must be a non-empty string'),
+                errorCode: CryptoErrorCode.INVALID_KEY
+            });
+        }
+    }
+    /**
+     * Generates a secure random padding
+     * @param length Length of the padding in bytes
+     */
+    static generatePadding(length) {
+        return CryptoJS.lib.WordArray.random(length).toString();
+    }
+    /**
+     * Derives a key using PBKDF2
+     * @param key The input key
+     * @param salt The salt to use
+     * @param config Configuration options
+     */
+    static deriveKey(key, salt, config) {
+        return CryptoJS.PBKDF2(key, salt, {
+            keySize: config.keySize,
+            iterations: config.keyIterations
+        });
+    }
+    /**
+     * Safely serializes data to JSON
+     * @param data The data to serialize
+     * @returns Serialized data as string
+     */
+    static safeSerialize(data) {
+        try {
+            return JSON.stringify(data);
+        }
+        catch (error) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'Failed to serialize data',
+                error: error instanceof Error ? error : new Error(String(error)),
+                errorCode: CryptoErrorCode.INVALID_DATA
+            });
+        }
+    }
+    /**
+     * Safely deserializes JSON data
+     * @param data The JSON string to deserialize
+     * @returns Deserialized data
+     */
+    static safeDeserialize(data) {
+        try {
+            return JSON.parse(data);
+        }
+        catch (error) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'Failed to deserialize data',
+                error: error instanceof Error ? error : new Error(String(error)),
+                errorCode: CryptoErrorCode.DECRYPTION_FAILED
+            });
+        }
+    }
+    /**
+     * Encrypts data using AES-256-CBC
+     * @param data The data to encrypt
+     * @param key The encryption key
+     * @param config Optional configuration
+     * @returns URL-safe encrypted string
+     * @throws {DyFM_Error} if encryption fails
+     */
+    static encrypt(data, key, config) {
+        try {
+            this.validateInput(data, key);
+            const finalConfig = { ...this.DEFAULT_CONFIG, ...config };
+            // Generate random IV and salt
+            const iv = CryptoJS.lib.WordArray.random(finalConfig.ivLength);
+            const salt = CryptoJS.lib.WordArray.random(finalConfig.saltLength);
+            // Derive key using PBKDF2
+            const derivedKey = this.deriveKey(key, salt, finalConfig);
+            // Convert data to string and add random padding
+            const dataStr = this.safeSerialize(data);
+            const padding = this.generatePadding(16);
+            const paddedData = padding + dataStr;
+            // Encrypt the data
+            const encrypted = CryptoJS.AES.encrypt(paddedData, derivedKey, {
+                iv: iv,
+                mode: CryptoJS.mode.CBC,
+                padding: CryptoJS.pad.Pkcs7
+            });
+            // Combine IV + Salt + Ciphertext
+            const combined = iv.concat(salt).concat(encrypted.ciphertext);
+            // Convert to URL-safe base64
+            return CryptoJS.enc.Base64.stringify(combined)
+                .replace(/\+/g, '-')
+                .replace(/\//g, '_')
+                .replace(/=+$/, '');
+        }
+        catch (error) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'Error encrypting data',
+                error: error instanceof Error ? error : new Error(String(error)),
+                errorCode: CryptoErrorCode.ENCRYPTION_FAILED
+            });
+        }
+    }
+    /**
+     * Decrypts data that was encrypted using encrypt()
+     * @param encryptedData The encrypted data
+     * @param key The decryption key
+     * @param config Optional configuration
+     * @returns The decrypted data
+     * @throws {DyFM_Error} if decryption fails
+     */
+    static decrypt(encryptedData, key, config) {
+        try {
+            this.validateInput(encryptedData, key);
+            const finalConfig = { ...this.DEFAULT_CONFIG, ...config };
+            // Convert from URL-safe base64
+            const base64 = encryptedData
+                .replace(/-/g, '+')
+                .replace(/_/g, '/');
+            // Parse the combined data
+            const combined = CryptoJS.enc.Base64.parse(base64);
+            // Extract IV, salt, and ciphertext
+            const iv = CryptoJS.lib.WordArray.create(combined.words.slice(0, finalConfig.ivLength / 4));
+            const salt = CryptoJS.lib.WordArray.create(combined.words.slice(finalConfig.ivLength / 4, (finalConfig.ivLength + finalConfig.saltLength) / 4));
+            const ciphertext = CryptoJS.lib.WordArray.create(combined.words.slice((finalConfig.ivLength + finalConfig.saltLength) / 4));
+            // Derive key using PBKDF2
+            const derivedKey = this.deriveKey(key, salt, finalConfig);
+            // Decrypt the data
+            const decrypted = CryptoJS.AES.decrypt({ ciphertext: ciphertext }, derivedKey, {
+                iv: iv,
+                mode: CryptoJS.mode.CBC,
+                padding: CryptoJS.pad.Pkcs7
+            });
+            // Remove padding and parse JSON
+            const decryptedStr = decrypted.toString(CryptoJS.enc.Utf8);
+            const jsonStr = decryptedStr.slice(32); // Remove 16-byte padding
+            return this.safeDeserialize(jsonStr);
+        }
+        catch (error) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'Error decrypting data',
+                error: error instanceof Error ? error : new Error(String(error)),
+                errorCode: CryptoErrorCode.DECRYPTION_FAILED
+            });
+        }
+    }
+    /**
+     * Generates a secure random key
+     * @param length Length of the key in bytes (default: 32)
+     * @returns A secure random key
+     */
+    static generateKey(length = 32) {
+        return CryptoJS.lib.WordArray.random(length).toString();
+    }
+    /**
+     * Validates if a string is a valid encrypted data
+     * @param encryptedData The data to validate
+     * @returns true if the data appears to be valid encrypted data
+     */
+    static isValidEncryptedData(encryptedData) {
+        if (!encryptedData || typeof encryptedData !== 'string') {
+            return false;
+        }
+        return /^[A-Za-z0-9\-_]+$/.test(encryptedData);
+    }
+}
+exports.DyFM_Crypto = DyFM_Crypto;
+//# sourceMappingURL=crypto.util.js.map

package/build/_modules/crypto/_collections/crypto.util.js.map

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

package/build/_modules/crypto/_collections/crypto.util.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=crypto.util.spec.d.ts.map

package/build/_modules/crypto/_collections/crypto.util.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.util.spec.d.ts","sourceRoot":"","sources":["../../../../src/_modules/crypto/_collections/crypto.util.spec.ts"],"names":[],"mappings":""}

package/build/_modules/crypto/_collections/crypto.util.spec.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto_util_1 = require("./crypto.util");
+describe('DyFM_Crypto', () => {
+    const testKey = 'test-secret-key-123';
+    const testData = { id: 1, name: 'test' };
+    describe('encrypt', () => {
+        it('should successfully encrypt data', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            expect(encrypted).toBeDefined();
+            expect(typeof encrypted).toBe('string');
+            expect(encrypted).toMatch(/^[A-Za-z0-9\-_]+$/);
+        });
+        it('should encrypt different data with different results', () => {
+            const data1 = { id: 1 };
+            const data2 = { id: 2 };
+            const encrypted1 = crypto_util_1.DyFM_Crypto.encrypt(data1, testKey);
+            const encrypted2 = crypto_util_1.DyFM_Crypto.encrypt(data2, testKey);
+            expect(encrypted1).not.toEqual(encrypted2);
+        });
+        it('should throw DyFM_Error when encryption fails', () => {
+            // @ts-ignore - Testing invalid input
+            expect(() => crypto_util_1.DyFM_Crypto.encrypt(undefined, testKey)).toThrow();
+        });
+        it('should handle complex objects', () => {
+            const complexData = {
+                id: 1,
+                name: 'test',
+                nested: {
+                    value: 'nested-value',
+                    array: [1, 2, 3]
+                }
+            };
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(complexData, testKey);
+            const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+            expect(decrypted).toEqual(complexData);
+        });
+        it('should handle arrays', () => {
+            const arrayData = [1, 'test', { nested: true }];
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(arrayData, testKey);
+            const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+            expect(decrypted).toEqual(arrayData);
+        });
+        it('should handle primitive values', () => {
+            const stringData = 'test string';
+            const numberData = 42;
+            const booleanData = true;
+            const encryptedString = crypto_util_1.DyFM_Crypto.encrypt(stringData, testKey);
+            const encryptedNumber = crypto_util_1.DyFM_Crypto.encrypt(numberData, testKey);
+            const encryptedBoolean = crypto_util_1.DyFM_Crypto.encrypt(booleanData, testKey);
+            expect(crypto_util_1.DyFM_Crypto.decrypt(encryptedString, testKey)).toBe(stringData);
+            expect(crypto_util_1.DyFM_Crypto.decrypt(encryptedNumber, testKey)).toBe(numberData);
+            expect(crypto_util_1.DyFM_Crypto.decrypt(encryptedBoolean, testKey)).toBe(booleanData);
+        });
+    });
+    describe('decrypt', () => {
+        it('should successfully decrypt encrypted data', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+            expect(decrypted).toEqual(testData);
+        });
+        it('should throw DyFM_Error when decryption fails', () => {
+            expect(() => crypto_util_1.DyFM_Crypto.decrypt('invalid-encrypted-data', testKey)).toThrow();
+        });
+        it('should throw DyFM_Error when using wrong key', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            expect(() => crypto_util_1.DyFM_Crypto.decrypt(encrypted, 'wrong-key')).toThrow();
+        });
+        it('should throw DyFM_Error when encrypted data is modified', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            const modified = encrypted.slice(0, -1) + 'A';
+            expect(() => crypto_util_1.DyFM_Crypto.decrypt(modified, testKey)).toThrow();
+        });
+    });
+    describe('URL-safe encryption', () => {
+        it('should produce URL-safe strings', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            expect(encrypted).toMatch(/^[A-Za-z0-9\-_]+$/);
+        });
+        it('should work in HTTP headers', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            const header = `Bearer ${encrypted}`;
+            const extracted = header.split(' ')[1];
+            const decrypted = crypto_util_1.DyFM_Crypto.decrypt(extracted, testKey);
+            expect(decrypted).toEqual(testData);
+        });
+        it('should work in URLs', () => {
+            const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+            const url = `https://example.com/api?token=${encrypted}`;
+            const params = new URLSearchParams(url.split('?')[1]);
+            const extracted = params.get('token');
+            const decrypted = crypto_util_1.DyFM_Crypto.decrypt(extracted, testKey);
+            expect(decrypted).toEqual(testData);
+        });
+    });
+    describe('edge cases', () => {
+        describe('empty and null values', () => {
+            it('should handle empty objects', () => {
+                const emptyObj = {};
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(emptyObj, testKey);
+                const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+                expect(decrypted).toEqual(emptyObj);
+            });
+            it('should handle empty arrays', () => {
+                const emptyArr = [];
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(emptyArr, testKey);
+                const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+                expect(decrypted).toEqual(emptyArr);
+            });
+            it('should handle null values in objects', () => {
+                const dataWithNull = {
+                    id: 1,
+                    name: null,
+                    nested: { value: null }
+                };
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(dataWithNull, testKey);
+                const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+                expect(decrypted).toEqual(dataWithNull);
+            });
+            it('should handle undefined values in objects', () => {
+                const dataWithUndefined = {
+                    id: 1,
+                    name: undefined,
+                    nested: { value: undefined }
+                };
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(dataWithUndefined, testKey);
+                const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, testKey);
+                expect(decrypted).toEqual({ id: 1, nested: {} });
+            });
+        });
+        describe('key edge cases', () => {
+            it('should handle very long keys', () => {
+                const longKey = 'a'.repeat(1000);
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, longKey);
+                const decrypted = crypto_util_1.DyFM_Crypto.decrypt(encrypted, longKey);
+                expect(decrypted).toEqual(testData);
+            });
+            it('should handle empty key', () => {
+                expect(() => crypto_util_1.DyFM_Crypto.encrypt(testData, '')).toThrow();
+            });
+            it('should handle whitespace-only keys', () => {
+                expect(() => crypto_util_1.DyFM_Crypto.encrypt(testData, '   ')).toThrow();
+            });
+        });
+        describe('encrypted data manipulation', () => {
+            it('should detect when encrypted data is truncated', () => {
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+                const truncated = encrypted.slice(0, -10);
+                expect(() => crypto_util_1.DyFM_Crypto.decrypt(truncated, testKey)).toThrow();
+            });
+            it('should detect when encrypted data is extended', () => {
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+                const extended = encrypted + 'A'.repeat(10);
+                expect(() => crypto_util_1.DyFM_Crypto.decrypt(extended, testKey)).toThrow();
+            });
+            it('should detect when encrypted data is modified in the middle', () => {
+                const encrypted = crypto_util_1.DyFM_Crypto.encrypt(testData, testKey);
+                const midPoint = Math.floor(encrypted.length / 2);
+                const modified = encrypted.slice(0, midPoint) + 'X' + encrypted.slice(midPoint + 1);
+                expect(() => crypto_util_1.DyFM_Crypto.decrypt(modified, testKey)).toThrow();
+            });
+        });
+    });
+});
+//# sourceMappingURL=crypto.util.spec.js.map

package/build/_modules/crypto/_collections/crypto.util.spec.js.map

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

package/build/_modules/crypto/index.d.ts

@@ -0,0 +1,2 @@
+export * from './_collections/crypto.util';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/crypto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/crypto/index.ts"],"names":[],"mappings":"AAEA,cAAc,4BAA4B,CAAC"}

package/build/_modules/crypto/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./_collections/crypto.util"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/crypto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/crypto/index.ts"],"names":[],"mappings":";;;AAEA,qEAA2C"}

package/nodemon.json

@@ -1,5 +1,5 @@
 {
-  "exec": "title Test Build of Dynamo-FSM && npm run build-tgz",
+  "exec": "title Test Build of Dynamo-FSM && npm run nodemon-run",
   "restartable": "rs",
   "delay": "3000",
   "ext": ".ts,json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.10.31",
+  "version": "01.10.33",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "scripts": {
     "prep": "npm i pnpm -g && npm i rimraf nodemon -g",
@@ -15,6 +15,9 @@
     "build-base": "pnpm i && rimraf ./build && npx tsc",
     "build-clean": "pnpm run clean && pnpm run build-base",
     "build-simple": "pnpm i && npx tsc && jasmine",
+    "build-n-test": "npm run build-tgz",
+
+    "nodemon-run": "npm run build-tgz",
 
     "clean": "pnpm run prep && rimraf ./build && rimraf package-lock.json && rimraf pnpm-lock.yaml && rimraf ./node_modules",
     "test": "pnpm run build-base && jasmine",
@@ -72,6 +75,12 @@
       "module": "./build/_modules/usage/index.js",
       "types": "./build/_modules/usage/index.d.ts",
       "typings": "./build/_modules/usage/index.d.ts"
+    },
+    "./crypto": {
+      "default": "./build/_modules/crypto/index.js",
+      "module": "./build/_modules/crypto/index.js",
+      "types": "./build/_modules/crypto/index.d.ts",
+      "typings": "./build/_modules/crypto/index.d.ts"
     }
   },
   "typesVersions": {
@@ -82,7 +91,8 @@
       "pipe": [ "build/_modules/pipe/index.d.ts" ],
       "socket": [ "build/_modules/socket/index.d.ts" ],
       "test": [ "build/_modules/test/index.d.ts" ],
-      "usage": [ "build/_modules/usage/index.d.ts" ]
+      "usage": [ "build/_modules/usage/index.d.ts" ],
+      "crypto": [ "build/_modules/crypto/index.d.ts" ]
     }
   },
   "keywords": [],
@@ -110,6 +120,7 @@
     "eslint-plugin-unused-imports": "^4.1.4",
     "jasmine": "~5.1.0",
     "jasmine-spec-reporter": "^7.0.0",
+    "crypto-js": "~4.2.0",
     "openai": "^4.93.0"
   }
 }

package/src/_modules/crypto/_collections/crypto.util.spec.ts

@@ -0,0 +1,195 @@
+import { DyFM_Crypto } from './crypto.util';
+
+describe('DyFM_Crypto', () => {
+  const testKey = 'test-secret-key-123';
+  const testData = { id: 1, name: 'test' };
+
+  describe('encrypt', () => {
+    it('should successfully encrypt data', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      
+      expect(encrypted).toBeDefined();
+      expect(typeof encrypted).toBe('string');
+      expect(encrypted).toMatch(/^[A-Za-z0-9\-_]+$/);
+    });
+
+    it('should encrypt different data with different results', () => {
+      const data1 = { id: 1 };
+      const data2 = { id: 2 };
+
+      const encrypted1 = DyFM_Crypto.encrypt(data1, testKey);
+      const encrypted2 = DyFM_Crypto.encrypt(data2, testKey);
+
+      expect(encrypted1).not.toEqual(encrypted2);
+    });
+
+    it('should throw DyFM_Error when encryption fails', () => {
+      // @ts-ignore - Testing invalid input
+      expect(() => DyFM_Crypto.encrypt(undefined, testKey)).toThrow();
+    });
+
+    it('should handle complex objects', () => {
+      const complexData = {
+        id: 1,
+        name: 'test',
+        nested: {
+          value: 'nested-value',
+          array: [1, 2, 3]
+        }
+      };
+
+      const encrypted = DyFM_Crypto.encrypt(complexData, testKey);
+      const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+
+      expect(decrypted).toEqual(complexData);
+    });
+
+    it('should handle arrays', () => {
+      const arrayData = [1, 'test', { nested: true }];
+      const encrypted = DyFM_Crypto.encrypt(arrayData, testKey);
+      const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+
+      expect(decrypted).toEqual(arrayData);
+    });
+
+    it('should handle primitive values', () => {
+      const stringData = 'test string';
+      const numberData = 42;
+      const booleanData = true;
+
+      const encryptedString = DyFM_Crypto.encrypt(stringData, testKey);
+      const encryptedNumber = DyFM_Crypto.encrypt(numberData, testKey);
+      const encryptedBoolean = DyFM_Crypto.encrypt(booleanData, testKey);
+
+      expect(DyFM_Crypto.decrypt(encryptedString, testKey)).toBe(stringData);
+      expect(DyFM_Crypto.decrypt(encryptedNumber, testKey)).toBe(numberData);
+      expect(DyFM_Crypto.decrypt(encryptedBoolean, testKey)).toBe(booleanData);
+    });
+  });
+
+  describe('decrypt', () => {
+    it('should successfully decrypt encrypted data', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+
+      expect(decrypted).toEqual(testData);
+    });
+
+    it('should throw DyFM_Error when decryption fails', () => {
+      expect(() => DyFM_Crypto.decrypt('invalid-encrypted-data', testKey)).toThrow();
+    });
+
+    it('should throw DyFM_Error when using wrong key', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      expect(() => DyFM_Crypto.decrypt(encrypted, 'wrong-key')).toThrow();
+    });
+
+    it('should throw DyFM_Error when encrypted data is modified', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      const modified = encrypted.slice(0, -1) + 'A';
+      expect(() => DyFM_Crypto.decrypt(modified, testKey)).toThrow();
+    });
+  });
+
+  describe('URL-safe encryption', () => {
+    it('should produce URL-safe strings', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      expect(encrypted).toMatch(/^[A-Za-z0-9\-_]+$/);
+    });
+
+    it('should work in HTTP headers', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      const header = `Bearer ${encrypted}`;
+      const extracted = header.split(' ')[1];
+      const decrypted = DyFM_Crypto.decrypt(extracted, testKey);
+      expect(decrypted).toEqual(testData);
+    });
+
+    it('should work in URLs', () => {
+      const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+      const url = `https://example.com/api?token=${encrypted}`;
+      const params = new URLSearchParams(url.split('?')[1]);
+      const extracted = params.get('token');
+      const decrypted = DyFM_Crypto.decrypt(extracted!, testKey);
+      expect(decrypted).toEqual(testData);
+    });
+  });
+
+  describe('edge cases', () => {
+    describe('empty and null values', () => {
+      it('should handle empty objects', () => {
+        const emptyObj = {};
+        const encrypted = DyFM_Crypto.encrypt(emptyObj, testKey);
+        const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+        expect(decrypted).toEqual(emptyObj);
+      });
+
+      it('should handle empty arrays', () => {
+        const emptyArr: any[] = [];
+        const encrypted = DyFM_Crypto.encrypt(emptyArr, testKey);
+        const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+        expect(decrypted).toEqual(emptyArr);
+      });
+
+      it('should handle null values in objects', () => {
+        const dataWithNull = {
+          id: 1,
+          name: null,
+          nested: { value: null }
+        };
+        const encrypted = DyFM_Crypto.encrypt(dataWithNull, testKey);
+        const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+        expect(decrypted).toEqual(dataWithNull);
+      });
+
+      it('should handle undefined values in objects', () => {
+        const dataWithUndefined = {
+          id: 1,
+          name: undefined,
+          nested: { value: undefined }
+        };
+        const encrypted = DyFM_Crypto.encrypt(dataWithUndefined, testKey);
+        const decrypted = DyFM_Crypto.decrypt(encrypted, testKey);
+        expect(decrypted).toEqual({ id: 1, nested: {} });
+      });
+    });
+
+    describe('key edge cases', () => {
+      it('should handle very long keys', () => {
+        const longKey = 'a'.repeat(1000);
+        const encrypted = DyFM_Crypto.encrypt(testData, longKey);
+        const decrypted = DyFM_Crypto.decrypt(encrypted, longKey);
+        expect(decrypted).toEqual(testData);
+      });
+
+      it('should handle empty key', () => {
+        expect(() => DyFM_Crypto.encrypt(testData, '')).toThrow();
+      });
+
+      it('should handle whitespace-only keys', () => {
+        expect(() => DyFM_Crypto.encrypt(testData, '   ')).toThrow();
+      });
+    });
+
+    describe('encrypted data manipulation', () => {
+      it('should detect when encrypted data is truncated', () => {
+        const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+        const truncated = encrypted.slice(0, -10);
+        expect(() => DyFM_Crypto.decrypt(truncated, testKey)).toThrow();
+      });
+
+      it('should detect when encrypted data is extended', () => {
+        const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+        const extended = encrypted + 'A'.repeat(10);
+        expect(() => DyFM_Crypto.decrypt(extended, testKey)).toThrow();
+      });
+
+      it('should detect when encrypted data is modified in the middle', () => {
+        const encrypted = DyFM_Crypto.encrypt(testData, testKey);
+        const midPoint = Math.floor(encrypted.length / 2);
+        const modified = encrypted.slice(0, midPoint) + 'X' + encrypted.slice(midPoint + 1);
+        expect(() => DyFM_Crypto.decrypt(modified, testKey)).toThrow();
+      });
+    });
+  });
+}); 

package/src/_modules/crypto/_collections/crypto.util.ts

@@ -0,0 +1,248 @@
+import * as CryptoJS from 'crypto-js';
+
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+
+/**
+ * Error codes for crypto operations
+ */
+export enum CryptoErrorCode {
+  INVALID_INPUT = 'DyFM-CRY-EA0',
+  DECRYPTION_FAILED = 'DyFM-CRY-DRY',
+  ENCRYPTION_FAILED = 'DyFM-CRY-ENF',
+  INVALID_KEY = 'DyFM-CRY-IKY',
+  INVALID_DATA = 'DyFM-CRY-IDT'
+}
+
+/**
+ * Configuration options for encryption/decryption
+ */
+export interface CryptoConfig {
+  ivLength?: number;
+  saltLength?: number;
+  keyIterations?: number;
+  keySize?: number;
+}
+
+/**
+ * A utility class for secure encryption and decryption of data
+ * Uses AES-256-CBC with PBKDF2 key derivation
+ */
+export class DyFM_Crypto {
+  private static readonly DEFAULT_CONFIG: Required<CryptoConfig> = {
+    ivLength: 16,
+    saltLength: 16,
+    keyIterations: 10000,
+    keySize: 256 / 32
+  };
+
+  // Tömör: kb. 60–80 karakteres token, nem 200+
+  // Nem szabványos: nehéz visszafejteni
+  // Használható cookie, header, URL-ben
+  
+  /**
+   * Validates the input data and key
+   * @throws {DyFM_Error} if validation fails
+   */
+  private static validateInput<T>(data: T, key: string): void {
+    if (data === undefined || data === null) {
+      throw new DyFM_Error({
+        message: 'Data is required',
+        error: new Error('Data is required'),
+        errorCode: CryptoErrorCode.INVALID_DATA
+      });
+    }
+
+    if (!key || typeof key !== 'string' || key.trim().length === 0) {
+      throw new DyFM_Error({
+        message: 'Valid key is required',
+        error: new Error('Key must be a non-empty string'),
+        errorCode: CryptoErrorCode.INVALID_KEY
+      });
+    }
+  }
+
+  /**
+   * Generates a secure random padding
+   * @param length Length of the padding in bytes
+   */
+  private static generatePadding(length: number): string {
+    return CryptoJS.lib.WordArray.random(length).toString();
+  }
+
+  /**
+   * Derives a key using PBKDF2
+   * @param key The input key
+   * @param salt The salt to use
+   * @param config Configuration options
+   */
+  private static deriveKey(key: string, salt: CryptoJS.lib.WordArray, config: Required<CryptoConfig>): CryptoJS.lib.WordArray {
+    return CryptoJS.PBKDF2(key, salt, {
+      keySize: config.keySize,
+      iterations: config.keyIterations
+    });
+  }
+
+  /**
+   * Safely serializes data to JSON
+   * @param data The data to serialize
+   * @returns Serialized data as string
+   */
+  private static safeSerialize<T>(data: T): string {
+    try {
+      return JSON.stringify(data);
+    } catch (error) {
+      throw new DyFM_Error({
+        message: 'Failed to serialize data',
+        error: error instanceof Error ? error : new Error(String(error)),
+        errorCode: CryptoErrorCode.INVALID_DATA
+      });
+    }
+  }
+
+  /**
+   * Safely deserializes JSON data
+   * @param data The JSON string to deserialize
+   * @returns Deserialized data
+   */
+  private static safeDeserialize<T>(data: string): T {
+    try {
+      return JSON.parse(data);
+    } catch (error) {
+      throw new DyFM_Error({
+        message: 'Failed to deserialize data',
+        error: error instanceof Error ? error : new Error(String(error)),
+        errorCode: CryptoErrorCode.DECRYPTION_FAILED
+      });
+    }
+  }
+
+  /**
+   * Encrypts data using AES-256-CBC
+   * @param data The data to encrypt
+   * @param key The encryption key
+   * @param config Optional configuration
+   * @returns URL-safe encrypted string
+   * @throws {DyFM_Error} if encryption fails
+   */
+  static encrypt<T>(data: T, key: string, config?: CryptoConfig): string {
+    try {
+      this.validateInput(data, key);
+      const finalConfig = { ...this.DEFAULT_CONFIG, ...config };
+
+      // Generate random IV and salt
+      const iv = CryptoJS.lib.WordArray.random(finalConfig.ivLength);
+      const salt = CryptoJS.lib.WordArray.random(finalConfig.saltLength);
+
+      // Derive key using PBKDF2
+      const derivedKey = this.deriveKey(key, salt, finalConfig);
+
+      // Convert data to string and add random padding
+      const dataStr = this.safeSerialize(data);
+      const padding = this.generatePadding(16);
+      const paddedData = padding + dataStr;
+
+      // Encrypt the data
+      const encrypted = CryptoJS.AES.encrypt(paddedData, derivedKey, {
+        iv: iv,
+        mode: CryptoJS.mode.CBC,
+        padding: CryptoJS.pad.Pkcs7
+      });
+
+      // Combine IV + Salt + Ciphertext
+      const combined = iv.concat(salt).concat(encrypted.ciphertext);
+
+      // Convert to URL-safe base64
+      return CryptoJS.enc.Base64.stringify(combined)
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+    } catch (error) {
+      throw new DyFM_Error({
+        message: 'Error encrypting data',
+        error: error instanceof Error ? error : new Error(String(error)),
+        errorCode: CryptoErrorCode.ENCRYPTION_FAILED
+      });
+    }
+  }
+
+  /**
+   * Decrypts data that was encrypted using encrypt()
+   * @param encryptedData The encrypted data
+   * @param key The decryption key
+   * @param config Optional configuration
+   * @returns The decrypted data
+   * @throws {DyFM_Error} if decryption fails
+   */
+  static decrypt<T>(encryptedData: string, key: string, config?: CryptoConfig): T {
+    try {
+      this.validateInput(encryptedData, key);
+      const finalConfig = { ...this.DEFAULT_CONFIG, ...config };
+
+      // Convert from URL-safe base64
+      const base64 = encryptedData
+        .replace(/-/g, '+')
+        .replace(/_/g, '/');
+
+      // Parse the combined data
+      const combined = CryptoJS.enc.Base64.parse(base64);
+
+      // Extract IV, salt, and ciphertext
+      const iv = CryptoJS.lib.WordArray.create(combined.words.slice(0, finalConfig.ivLength / 4));
+      const salt = CryptoJS.lib.WordArray.create(
+        combined.words.slice(
+          finalConfig.ivLength / 4,
+          (finalConfig.ivLength + finalConfig.saltLength) / 4
+        )
+      );
+      const ciphertext = CryptoJS.lib.WordArray.create(
+        combined.words.slice((finalConfig.ivLength + finalConfig.saltLength) / 4)
+      );
+
+      // Derive key using PBKDF2
+      const derivedKey = this.deriveKey(key, salt, finalConfig);
+
+      // Decrypt the data
+      const decrypted = CryptoJS.AES.decrypt(
+        { ciphertext: ciphertext },
+        derivedKey,
+        {
+          iv: iv,
+          mode: CryptoJS.mode.CBC,
+          padding: CryptoJS.pad.Pkcs7
+        }
+      );
+
+      // Remove padding and parse JSON
+      const decryptedStr = decrypted.toString(CryptoJS.enc.Utf8);
+      const jsonStr = decryptedStr.slice(32); // Remove 16-byte padding
+      return this.safeDeserialize<T>(jsonStr);
+    } catch (error) {
+      throw new DyFM_Error({
+        message: 'Error decrypting data',
+        error: error instanceof Error ? error : new Error(String(error)),
+        errorCode: CryptoErrorCode.DECRYPTION_FAILED
+      });
+    }
+  }
+
+  /**
+   * Generates a secure random key
+   * @param length Length of the key in bytes (default: 32)
+   * @returns A secure random key
+   */
+  static generateKey(length: number = 32): string {
+    return CryptoJS.lib.WordArray.random(length).toString();
+  }
+
+  /**
+   * Validates if a string is a valid encrypted data
+   * @param encryptedData The data to validate
+   * @returns true if the data appears to be valid encrypted data
+   */
+  static isValidEncryptedData(encryptedData: string): boolean {
+    if (!encryptedData || typeof encryptedData !== 'string') {
+      return false;
+    }
+    return /^[A-Za-z0-9\-_]+$/.test(encryptedData);
+  }
+}

package/src/_modules/crypto/index.ts

@@ -0,0 +1,3 @@
+
+
+export * from './_collections/crypto.util';