@futdevpro/fsm-dynamo 1.14.11 → 1.14.13

package/build/_modules/data-handler/_models/list-collector-data-handler.control-model.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_ListCollectorDataHandler = void 0;
+const rxjs_1 = require("rxjs");
+const data_handler_control_model_1 = require("./data-handler.control-model");
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * A specialized data handler for managing list collections within a parent data object.
+ * Extends DyFM_DataHandler to provide functionality for handling lists within a collector object.
+ *
+ * @template T_ListCollectorData - The type of the parent collector data object
+ * @template T_DataItem - The type of individual items in the list (must extend DyFM_Metadata)
+ * @template T_DependencyData - The type of dependency data (defaults to any)
+ * @template T_DataLoadBy - The type used to identify how data should be loaded (defaults to string)
+ *
+ * @example
+ * ```typescript
+ * // Create a list collector handler for user's projects
+ * const userProjectsHandler = new DyFM_ListCollectorDataHandler<User, Project>({
+ *   listKey: 'projects',
+ *   get: async (userId: string): Promise<User> => {
+ *     return await userService.getUserWithProjects(userId);
+ *   }
+ * });
+ *
+ * // Access the data list
+ * const projects = userProjectsHandler.dataList;
+ *
+ * // Add a new project
+ * userProjectsHandler.addItem(newProject);
+ *
+ * // Update an existing project
+ * userProjectsHandler.updateItem(updatedProject);
+ *
+ * // Subscribe to changes
+ * userProjectsHandler.dataList$.subscribe(projects => {
+ *   console.log('Projects updated:', projects);
+ * });
+ * ```
+ */
+class DyFM_ListCollectorDataHandler extends data_handler_control_model_1.DyFM_DataHandler {
+    /** this is only for data list handlers,
+     * while creating arrow function for this, dont forget to use async n await! */
+    setItem;
+    /** this is only for data list handlers,
+     * while creating arrow function for this, dont forget to use async n await! */
+    deleteItem;
+    listKey;
+    /**
+     * BehaviorSubject that holds the current data list.
+     * Computed from the base data_BS BehaviorSubject, ensuring it always returns an array.
+     */
+    dataList_BS;
+    /**
+     * Observable that holds the current data list.
+     * Computed from the base data$ Observable, ensuring it always returns an array.
+     */
+    dataList$;
+    /**
+     * BehaviorSubject that holds the currently active item.
+     */
+    activeItem_BS;
+    /**
+     * Observable that holds the currently active item.
+     */
+    activeItem$;
+    /**
+     * Gets the current data value.
+     * @returns The current data value
+     */
+    get data() {
+        return this.data_BS.value;
+    }
+    /**
+     * Gets the current data list.
+     * Alias for data getter.
+     * @returns The current array of data items
+     */
+    get dataList() {
+        return this.dataList_BS.value;
+    }
+    /**
+     * Creates a new instance of DyFM_ListCollectorDataHandler.
+     *
+     * @param set - Configuration settings for the data handler
+     * @param skipDependencyConnections - Optional flag to skip dependency connections during construction
+     */
+    constructor(set, 
+    /** is in construct?
+     * so the dependent data handlers are not added here, but in the extended class */
+    skipDependencyConnections) {
+        super(set, skipDependencyConnections);
+        this.listKey = set.listKey;
+        // Initialize dataList BehaviorSubject and Observable
+        this.dataList_BS = new rxjs_1.BehaviorSubject([]);
+        this.dataList$ = this.dataList_BS.asObservable();
+        // Initialize activeItem BehaviorSubject and Observable
+        this.activeItem_BS = new rxjs_1.BehaviorSubject(null);
+        this.activeItem$ = this.activeItem_BS.asObservable();
+        // Subscribe to data changes to update dataList
+        this.data$.subscribe(data => {
+            const dataList = Array.isArray(data?.[this.listKey]) ? data[this.listKey] : [];
+            this.dataList_BS.next(dataList);
+        });
+        if (set.setItem) {
+            this.setItem = set.setItem;
+        }
+        if (set.deleteItem) {
+            this.deleteItem = set.deleteItem;
+        }
+        this.getPostProcesses.push((data) => {
+            // check if data is an array
+            if (!Array.isArray(data)) {
+                console.error(`DYNAMO DynamoDataHandler (${this.name}) ERROR: ` +
+                    `\nData is not an array!:` +
+                    '\n\n', data);
+                throw new Error(`Data is not an array! (${this.name})`);
+            }
+            return data;
+        });
+        if (!skipDependencyConnections) {
+            if (set.dependencyDataHandler) {
+                this.addDependencyDataHandler(set.dependencyDataHandler);
+            }
+            if (set.dependentDataHandlers) {
+                this.addDependentDataHandlers(set.dependentDataHandlers, true);
+            }
+        }
+    }
+    clear(dontClearDependents) {
+        super.clear(dontClearDependents);
+        this.activeItem_BS.next(null);
+    }
+    /**
+     * Adds a new item to the data list.
+     *
+     * @param item - The item to add to the list
+     * @param collectorId - Optional collector ID for tracking
+     * @param dontSendUpdate - Optional flag to prevent sending update notification
+     */
+    async addItem(item, collectorId, dontSendUpdate) {
+        if (!this.data) {
+            throw new error_control_model_1.DyFM_Error({
+                error: new Error(`Data not found! (${this.name})`),
+                errorCode: 'DyFM-LCDH-AI1',
+                additionalContent: {
+                    listKey: this.listKey,
+                },
+            });
+        }
+        this.data[this.listKey] ??= [];
+        this.data[this.listKey].push(item);
+        if (this.setItem && !dontSendUpdate) {
+            await this.setItem(item, collectorId);
+            // dont send update because we already sent it to the setItem function
+            await this.updateData(this.data_BS.value, true);
+        }
+        else {
+            await this.updateData(this.data_BS.value, dontSendUpdate);
+        }
+        this.activeItem_BS.next(item);
+    }
+    /**
+     * Removes an item from the data list.
+     * The item is identified by its _id property.
+     *
+     * @param id - The id of the item to remove from the list
+     * @param collectorId - Optional collector ID for tracking
+     * @param dontSendUpdate - Optional flag to prevent sending update notification
+     */
+    async removeItem(id, collectorId, dontSendUpdate) {
+        if (!this.data?.[this.listKey]?.length) {
+            throw new error_control_model_1.DyFM_Error({
+                error: new Error(`List not found! (${this.name})`),
+                errorCode: 'DyFM-LCDH-RI1',
+                additionalContent: {
+                    listKey: this.listKey,
+                },
+            });
+        }
+        const index = this.data[this.listKey].findIndex(i => i._id === id);
+        if (index !== -1) {
+            this.data[this.listKey].splice(index, 1);
+            if (this.deleteItem) {
+                await this.deleteItem(id, collectorId);
+                await this.updateData(this.data_BS.value, true);
+            }
+            else {
+                await this.updateData(this.data_BS.value, dontSendUpdate);
+            }
+        }
+        if (this.activeItem_BS.value?._id === id) {
+            this.activeItem_BS.next(null);
+        }
+    }
+    /**
+     * Updates an existing item in the data list.
+     * The item is identified by its _id property.
+     *
+     * @param item - The updated item
+     * @param collectorId - Optional collector ID for tracking
+     * @param dontSendUpdate - Optional flag to prevent sending update notification
+     * @throws Error if the item is not found in the list
+     */
+    async updateItem(item, collectorId, dontSendUpdate) {
+        if (!this.data?.[this.listKey]?.length) {
+            throw new error_control_model_1.DyFM_Error({
+                error: new Error(`List not found! (${this.name})`),
+                errorCode: 'DyFM-LCDH-UI0',
+                additionalContent: {
+                    listKey: this.listKey,
+                },
+            });
+        }
+        // check if item is in the list
+        const index = this.data[this.listKey].findIndex(i => i._id === item._id);
+        if (index !== -1) {
+            // update the item
+            this.data[this.listKey][index] = item;
+            if (this.setItem) {
+                // send update to API
+                await this.setItem(item, collectorId);
+                await this.updateData(this.data_BS.value, true);
+            }
+            else {
+                // send update to API
+                await this.updateData(this.data_BS.value, dontSendUpdate);
+            }
+        }
+        else {
+            throw new error_control_model_1.DyFM_Error({
+                error: new Error(`Item not found! (${this.name})`),
+                errorCode: 'DyFM-LCDH-UI1',
+                additionalContent: {
+                    item: item,
+                },
+            });
+        }
+    }
+    setActiveItem(item) {
+        this.activeItem_BS.next(item);
+    }
+}
+exports.DyFM_ListCollectorDataHandler = DyFM_ListCollectorDataHandler;
+//# sourceMappingURL=list-collector-data-handler.control-model.js.map

package/build/_modules/data-handler/_models/list-collector-data-handler.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-collector-data-handler.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/data-handler/_models/list-collector-data-handler.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/data-handler/index.d.ts

@@ -0,0 +1,6 @@
+export * from './_models/data-handler.control-model';
+export * from './_models/data-handler-settings.control-model';
+export * from './_models/data-list-handler.control-model';
+export * from './_models/data-search-handler.control-model';
+export * from './_models/list-collector-data-handler.control-model';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/data-handler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/data-handler/index.ts"],"names":[],"mappings":"AACA,cAAc,sCAAsC,CAAC;AACrD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,qDAAqD,CAAC"}

package/build/_modules/data-handler/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// MODELS
+tslib_1.__exportStar(require("./_models/data-handler.control-model"), exports);
+tslib_1.__exportStar(require("./_models/data-handler-settings.control-model"), exports);
+tslib_1.__exportStar(require("./_models/data-list-handler.control-model"), exports);
+tslib_1.__exportStar(require("./_models/data-search-handler.control-model"), exports);
+tslib_1.__exportStar(require("./_models/list-collector-data-handler.control-model"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/data-handler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/data-handler/index.ts"],"names":[],"mappings":";;;AAAA,SAAS;AACT,+EAAqD;AACrD,wFAA8D;AAC9D,oFAA0D;AAC1D,sFAA4D;AAC5D,8FAAoE"}

package/eslint.config.js

@@ -0,0 +1,4 @@
+const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
+
+module.exports = ntsPackageConfig;
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.14.11",
+  "version": "01.14.13",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",
@@ -29,7 +29,14 @@
     "test": "pnpm run build-base && jasmine",
     "test-clean": "pnpm run build-clean && jasmine",
     "crypto-test": "node ./scripts/crypto/stress-test-crypto.js",
-    "crypto-test-clean": "pnpm run build-clean && node ./scripts/crypto/stress-test-crypto.js"
+    "crypto-test-clean": "pnpm run build-clean && node ./scripts/crypto/stress-test-crypto.js",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "validate:imports": "dynamo-validate-imports",
+    "validate:naming": "dynamo-validate-naming",
+    "audit:eslintrc": "dynamo-eslintrc-audit",
+    "fix": "dynamo-fix",
+    "fix:return-types": "dynamo-fix-return-types"
   },
   "main": "./build/index.js",
   "module": "./build/index.js",
@@ -140,6 +147,12 @@
       "module": "./build/_modules/usage/index.js",
       "types": "./build/_modules/usage/index.d.ts",
       "typings": "./build/_modules/usage/index.d.ts"
+    },
+    "./data-handler": {
+      "default": "./build/_modules/data-handler/index.js",
+      "module": "./build/_modules/data-handler/index.js",
+      "types": "./build/_modules/data-handler/index.d.ts",
+      "typings": "./build/_modules/data-handler/index.d.ts"
     }
   },
   "typesVersions": {
@@ -163,7 +176,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" ],
+      "data-handler": [ "build/_modules/data-handler/index.d.ts" ]
     }
   },
   "keywords": [],
@@ -183,14 +197,19 @@
     "uuid": "12.0.0"
   },
   "devDependencies": {
+    "@futdevpro/dynamo-eslint": "1.14.9",
     "@types/jasmine": "~4.3.5",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",
     "eslint": "^9.34.0",
+    "eslint-plugin-import": "^2.29.0",
+    "eslint-plugin-jsdoc": "^48.0.0",
     "eslint-plugin-max-params-no-constructor": "^0.0.4",
+    "eslint-plugin-prettier": "^5.1.3",
     "eslint-plugin-unused-imports": "^4.1.4",
     "jasmine": "5.10.0",
     "jasmine-spec-reporter": "^7.0.0",
+    "prettier": "^3.3.0",
     "crypto-js": "~4.2.0",
     "openai": "^4.93.0"
   }

package/src/_collections/utils/json-error-helper.util.ts

@@ -254,6 +254,7 @@ export class DyFM_JsonErrorHelper {
       
       if (lineInfo) {
         const formattedError = this.formatJsonErrorForLogging(lineInfo, errorMessage);
+        
         throw new Error(`JSON parsing failed:\n${formattedError.join('\n')}`);
       } else {
         // Fallback to simple error if we can't extract line info
@@ -286,14 +287,15 @@ export class DyFM_JsonErrorHelper {
       .replace(/\[/g, '[\n  ')
       .replace(/\]/g, '\n]')
       .replace(/\n\s*\n/g, '\n') // Remove double newlines
-      .replace(/^\s+|\s+$/gm, function(match, offset, string) {
+      .replace(/^\s+|\s+$/gm, function(match: string, offset: number, string: string): string {
         // Trim but preserve indentation structure
         if (!string || typeof string !== 'string') {
           return match;
         }
-        const lines = string.slice(0, offset).split('\n');
-        const depth = (string.slice(0, offset).match(/{|\[/g) || []).length - 
+        const lines: string[] = string.slice(0, offset).split('\n');
+        const depth: number = (string.slice(0, offset).match(/{|\[/g) || []).length - 
                      (string.slice(0, offset).match(/}|\]/g) || []).length;
+
         return '  '.repeat(Math.max(0, depth));
       });
   }

package/src/_collections/utils/stack.util.ts

@@ -13,7 +13,7 @@ import { DyFM_Log } from './log.util';
  * ```
  */
 export function DyFM_getConstructionStackLocation(level: number = 0): string {
-  let stack: string = new Error().stack;
+  const stack: string = new Error().stack;
 
   // Split the stack into lines and remove the first line (Error:)
   let stackLines = stack?.split('\n')?.slice(2);
@@ -134,9 +134,13 @@ export function DyFM_getLocalStackLocation(level: number = 0): string {
 
     if (!locationLine) {
       DyFM_Log.warn(
-        `No location line found outside of node_modules or node: (0)\n${typeof stack}\n${stack?.slice(0, 300)?.split('\n') + '...'}`, {
-        stack,
-      });
+        `No location line found outside of node_modules or node: (0)` +
+        `\n${typeof stack}\n${stack?.slice(0, 300)?.split('\n') + '...'}`, 
+        {
+          stack,
+        }
+      );
+
       return '';
     }
   }

package/src/_models/control-models/service-endpoint-settings-base.control-model.ts

@@ -17,7 +17,8 @@ class SomethingElse {
 
 export interface DyFM_EndpointTypesContainer<
   T_Result,
-  T_Inputs extends Array<any> = [],
+  //T_Inputs extends DyFM_API_Input<any>[] = [],
+  T_Inputs extends any[] = [],
   T_Body = undefined
 > {
   resultType: T_Result;
@@ -74,9 +75,45 @@ export class DyFM_Endpoint_SettingsBase<T_Result, I_Inputs, T_Body> {
   }
 }
 export type DyFM_ServiceEndpoint_SettingsBase<T extends DyFM_ServiceEndpointTypesSettings> = {
-  [K in keyof T]: DyFM_Endpoint_SettingsBase<
-    T[K]['resultType'], T[K]['inputTypes'], T[K]['bodyType']
-  >;
+  [K in keyof T]: DyFM_Endpoint_SettingsBase<T[K]['resultType'], T[K]['inputTypes'], T[K]['bodyType']>;
+}
+
+
+
+export class DyFM_ServerRoute_SettingsBase<
+  T_Result,
+  T_Inputs extends DyFM_API_Input<any>[] = [],
+  T_Body = undefined
+> extends DyFM_Endpoint_SettingsBase<T_Result, T_Inputs, T_Body> {
+
+  preProcesses: ((req: Request, res: Response) => Promise<void>)[];
+  /** this is the old way of setting up tasks, it will be deprecated in future (we want)
+   * @deprecated use simpleTask instead */
+  tasks?: ((req: Request, res: Response, issuer?: string, ...inputs: T_Inputs) => Promise<void>)[];
+  /**
+   * a simple task that is executed after the preProcesses
+   * this will automatically handle the API setup and this will be the TASK that will be executed 
+   * (result will be sent to the client, error will be caught and sent to the client)
+   */
+  simpleTask?: (...inputs: T_Inputs) => Promise<T_Result>;
+
+  constructor(
+    set: DyFM_ServerRoute_SettingsBase<T_Result, T_Inputs, T_Body>
+  ) {
+    super(set);
+
+    Object.assign(this, set);
+  }
+}
+
+export interface DyFM_API_Input<T_Input> {
+  type: DyFM_API_Input_Type;
+  value: T_Input;
+}
+
+export enum DyFM_API_Input_Type {
+  body = 'body',
+  queryParams = 'queryParams',
 }
 
 /* asdasd

package/src/_modules/ai/_modules/open-ai/index.ts

@@ -1,13 +1,14 @@
 
 
 
-/* try {
-  require.resolve('open-ai');
+try {
+  /* require.resolve('open-ai'); */
+  import('open-ai' as any);
 } catch {
   console.log(
     '❌ OpenAI package not found, please install it with: pnpm add open-ai'
   );
-} */
+}
 
 // COLLECTIONS
 export * from './_collections/oai-embedding-model-dimensions.const';

package/src/_modules/crypto/_collections/{crypto-old.util.ts → crypto-v2.util.ts}

@@ -1,4 +1,5 @@
 import * as CryptoJS from 'crypto-js';
+
 import { 
   DyFM_Error, 
   DyFM_Error_Settings 
@@ -39,7 +40,7 @@ export class DyFM_Crypto {
     ivLength: 16, // 128 bits
     saltLength: 16, // 128 bits
     keyIterations: 1000, // Reduced for better performance and stability
-    keySize: 8 // 256 bits (8 * 32)
+    keySize: 8, // 256 bits (8 * 32)
   };
   private static readonly defaultErrorUserMsg = 
     `We encountered an unhandled Authentication Error, ` +
@@ -54,7 +55,7 @@ export class DyFM_Crypto {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('validateInput'),
         errorCode: 'DyFM-CRY-IKY',
-        message: 'Invalid encryption key'
+        message: 'Invalid encryption key',
       });
     }
 
@@ -63,7 +64,7 @@ export class DyFM_Crypto {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('validateInput'),
         errorCode: 'DyFM-CRY-IDT',
-        message: `Invalid data to encrypt/decrypt (is "${data}")`
+        message: `Invalid data to encrypt/decrypt (is "${data}")`,
       });
     }
   }
@@ -79,6 +80,7 @@ export class DyFM_Crypto {
     // Use MD5 for better stability - simpler hash algorithm, more consistent across versions
     const combined = data + key;
     const hash = CryptoJS.MD5(combined);
+
     // Use slice(0, 4) for 16 bytes - more stable than division operations
     return CryptoJS.lib.WordArray.create(hash.words.slice(0, 4));
   }
@@ -94,6 +96,7 @@ export class DyFM_Crypto {
     // Use MD5 for better stability - simpler hash algorithm, more consistent across versions
     const combined = key + data;
     const hash = CryptoJS.MD5(combined);
+
     // Use slice(0, 4) for 16 bytes - more stable than division operations
     return CryptoJS.lib.WordArray.create(hash.words.slice(0, 4));
   }
@@ -104,7 +107,7 @@ export class DyFM_Crypto {
   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
+      iterations: config.keyIterations,
     });
   }
 
@@ -119,7 +122,7 @@ export class DyFM_Crypto {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('safeSerialize', error),
         errorCode: 'DyFM-CRY-SER',
-        message: 'Failed to serialize data'
+        message: 'Failed to serialize data',
       });
     }
   }
@@ -134,10 +137,12 @@ export class DyFM_Crypto {
       
       // Handle double-stringified JSON (or more levels of stringification)
       let maxAttempts = 3; // Prevent infinite loops
+
       while (typeof parsed === 'string' && maxAttempts > 0) {
         try {
           //const nextParsed = JSON.parse(parsed);
           const nextParsed = DyFM_Object.failableSafeParseJSON(parsed);
+
           // Only continue if parsing actually changed the result
           if (nextParsed !== parsed) {
             parsed = nextParsed;
@@ -161,7 +166,7 @@ export class DyFM_Crypto {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('safeDeserialize', error),
         errorCode: 'DyFM-CRY-DES',
-        message: 'Failed to deserialize data'
+        message: 'Failed to deserialize data',
       });
     }
   }
@@ -205,7 +210,7 @@ export class DyFM_Crypto {
       const encrypted = CryptoJS.AES.encrypt(dataStr, derivedKey, {
         iv: iv,
         mode: CryptoJS.mode.CBC,
-        padding: CryptoJS.pad.Pkcs7
+        padding: CryptoJS.pad.Pkcs7,
       });
 
       // Combine IV + Salt + Ciphertext
@@ -247,6 +252,7 @@ export class DyFM_Crypto {
 
       // Validate minimum length (IV + Salt + minimum ciphertext)
       const minLength = (finalConfig.ivLength + finalConfig.saltLength + 16) / 4; // 16 bytes minimum for ciphertext
+
       if (combined.words.length < minLength) {
         throw new Error('Invalid encrypted data length');
       }
@@ -273,12 +279,13 @@ export class DyFM_Crypto {
         {
           iv: iv,
           mode: CryptoJS.mode.CBC,
-          padding: CryptoJS.pad.Pkcs7
+          padding: CryptoJS.pad.Pkcs7,
         }
       );
 
       // Parse JSON
       const decryptedStr = decrypted.toString(CryptoJS.enc.Utf8);
+
       return this.safeDeserialize<T>(decryptedStr);
     } catch (error) {
       throw new DyFM_Error({
@@ -306,6 +313,7 @@ export class DyFM_Crypto {
     if (!encryptedData || typeof encryptedData !== 'string') {
       return false;
     }
+
     return /^[A-Za-z0-9\-_]+$/.test(encryptedData);
   }
 
@@ -317,7 +325,7 @@ export class DyFM_Crypto {
       status: (error as DyFM_Error)?.___status ?? (error as any)?.status ?? 401,
       message: `Crypto operation "${operation}" failed`,
       error: error,
-      errorCode: 'DyFM-CRY-ERR'
+      errorCode: 'DyFM-CRY-ERR',
     };
   }
 }