@adaas/a-utils 0.1.22 → 0.1.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-utils",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "A-Utils is a set of utilities that are used across the ADAAS ecosystem. This package is designed to be a collection of utilities that are used across the ADAAS ecosystem.",
   "license": "Apache-2.0",
   "main": "./dist/index.cjs",

package/src/lib/A-Channel/A-Channel.constants.ts

@@ -7,53 +7,53 @@ export enum A_ChannelFeatures {
     /**
      * Allows to extend timeout logic and behavior
      */
-    onTimeout = 'onTimeout',
+    onTimeout = '_A_Channel_onTimeout',
     /**
      * Allows to extend retry logic and behavior
      */
-    onRetry = 'onRetry',
+    onRetry = '_A_Channel_onRetry',
     /**
      * Allows to extend circuit breaker logic and behavior
      */
-    onCircuitBreakerOpen = 'onCircuitBreakerOpen',
+    onCircuitBreakerOpen = '_A_Channel_onCircuitBreakerOpen',
     /**
      * Allows to extend cache logic and behavior
      */
-    onCache = 'onCache',
+    onCache = '_A_Channel_onCache',
     /**
      * Allows to extend connection logic and behavior
      */
-    onConnect = 'onConnect',
+    onConnect = '_A_Channel_onConnect',
     /**
      * Allows to extend disconnection logic and behavior
      */
-    onDisconnect = 'onDisconnect',
+    onDisconnect = '_A_Channel_onDisconnect',
     /**
      * Allows to extend request preparation logic and behavior
      */
-    onBeforeRequest = 'onBeforeRequest',
+    onBeforeRequest = '_A_Channel_onBeforeRequest',
     /**
      * Allows to extend request sending logic and behavior
      */
-    onRequest = 'onRequest',
+    onRequest = '_A_Channel_onRequest',
     /**
      * Allows to extend request post-processing logic and behavior
      */
-    onAfterRequest = 'onAfterRequest',
+    onAfterRequest = '_A_Channel_onAfterRequest',
     /**
      * Allows to extend error handling logic and behavior
      * 
      * [!] The same approach uses for ALL errors within the channel
      */
-    onError = 'onError',
+    onError = '_A_Channel_onError',
     /**
      * Allows to extend send logic and behavior
      */
-    onSend = 'onSend',
+    onSend = '_A_Channel_onSend',
     /**
      * Allows to extend consume logic and behavior
      */
-    onConsume = 'onConsume',
+    onConsume = '_A_Channel_onConsume',
 }
 
 

package/src/lib/A-Command/A-Command.constants.ts

@@ -10,27 +10,27 @@ export enum A_Command_Status {
      * Initial state when command is instantiated but not yet ready for execution
      */
     CREATED = 'CREATED',
-    
+
     /**
      * Command has been initialized with execution scope and dependencies
      */
     INITIALIZED = 'INITIALIZED',
-    
+
     /**
      * Command has been compiled and is ready for execution
      */
     COMPILED = 'COMPILED',
-    
+
     /**
      * Command is currently being executed
      */
     EXECUTING = 'EXECUTING',
-    
+
     /**
      * Command has completed successfully
      */
     COMPLETED = 'COMPLETED',
-    
+
     /**
      * Command execution has failed with errors
      */
@@ -47,13 +47,13 @@ export enum A_Command_Status {
 export enum A_CommandTransitions {
     /** Transition from CREATED to INITIALIZED state */
     CREATED_TO_INITIALIZED = 'created_initialized',
-    
+
     /** Transition from INITIALIZED to EXECUTING state */
     INITIALIZED_TO_EXECUTING = 'initialized_executing',
-    
+
     /** Transition from EXECUTING to COMPLETED state (success path) */
     EXECUTING_TO_COMPLETED = 'executing_completed',
-    
+
     /** Transition from EXECUTING to FAILED state (error path) */
     EXECUTING_TO_FAILED = 'executing_failed',
 }
@@ -68,42 +68,87 @@ export enum A_CommandTransitions {
  * to inject custom logic into command execution.
  */
 export enum A_CommandFeatures {
+    /**
+     * Triggered during command initialization phase
+     * Use to set up execution environment, validate parameters, or prepare resources
+     */
+    onInit = '_A_Command_onInit',
+
+    /**
+     * Triggered before command execution starts
+     * Use for pre-execution validation, logging, or setup tasks
+     */
+    onBeforeExecute = '_A_Command_onBeforeExecute',
+
+    /**
+     * Main command execution logic
+     * Core business logic should be implemented here
+     */
+    onExecute = '_A_Command_onExecute',
+
+    /**
+     * Triggered after command execution completes (success or failure)
+     * Use for cleanup, logging, or post-processing tasks
+     */
+    onAfterExecute = '_A_Command_onAfterExecute',
+
+    /**
+     * Triggered when command completes successfully
+     * Use for success-specific operations like notifications or result processing
+     */
+    onComplete = '_A_Command_onComplete',
+
+    /**
+     * Triggered when command execution fails
+     * Use for error handling, cleanup, or failure notifications
+     */
+    onFail = '_A_Command_onFail',
+
+    /**
+     * Triggered when an error occurs during execution
+     * Use for error logging, transformation, or recovery attempts
+     */
+    onError = '_A_Command_onError',
+}
+
+
+export enum A_CommandEvent {
     /**
      * Triggered during command initialization phase
      * Use to set up execution environment, validate parameters, or prepare resources
      */
     onInit = 'onInit',
-    
+
     /**
      * Triggered before command execution starts
      * Use for pre-execution validation, logging, or setup tasks
      */
     onBeforeExecute = 'onBeforeExecute',
-    
+
     /**
      * Main command execution logic
      * Core business logic should be implemented here
      */
     onExecute = 'onExecute',
-    
+
     /**
      * Triggered after command execution completes (success or failure)
      * Use for cleanup, logging, or post-processing tasks
      */
     onAfterExecute = 'onAfterExecute',
-    
+
     /**
      * Triggered when command completes successfully
      * Use for success-specific operations like notifications or result processing
      */
     onComplete = 'onComplete',
-    
+
     /**
      * Triggered when command execution fails
      * Use for error handling, cleanup, or failure notifications
      */
     onFail = 'onFail',
-    
+
     /**
      * Triggered when an error occurs during execution
      * Use for error logging, transformation, or recovery attempts
@@ -111,14 +156,11 @@ export enum A_CommandFeatures {
     onError = 'onError',
 }
 
-
-
-
 /**
  * Type alias for command lifecycle event names
  * Represents all available events that can be listened to on a command instance
  */
-export type A_Command_Event = keyof typeof A_CommandFeatures;
+export type A_CommandEvents = keyof typeof A_CommandEvent;
 
 
 

package/src/lib/A-Command/A-Command.entity.ts

@@ -6,9 +6,9 @@ import {
 } from "./A-Command.types";
 import {
     A_CommandFeatures,
-    A_Command_Event,
     A_Command_Status,
-    A_CommandTransitions
+    A_CommandTransitions,
+    A_CommandEvent
 } from "./A-Command.constants";
 import {  A_Context, A_Dependency, A_Entity, A_Error, A_Feature, A_Inject, A_Scope } from "@adaas/a-concept";
 import { A_CommandError } from "./A-Command.error";
@@ -80,7 +80,7 @@ import { A_ExecutionContext } from "../A-Execution/A-Execution.context";
 export class A_Command<
     InvokeType extends A_TYPES__Command_Init = A_TYPES__Command_Init,
     ResultType extends Record<string, any> = Record<string, any>,
-    LifecycleEvents extends string | A_Command_Event = A_Command_Event,
+    LifecycleEvents extends string | keyof typeof A_CommandEvent = keyof typeof A_CommandEvent,
 > extends A_Entity<InvokeType, A_TYPES__Command_Serialized<InvokeType, ResultType>> {
 
     // ====================================================================
@@ -119,7 +119,7 @@ export class A_Command<
 
     /** Map of event listeners organized by event name */
     protected _listeners: Map<
-        LifecycleEvents | A_Command_Event,
+        LifecycleEvents | keyof typeof A_CommandEvent,
         Set<A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>>
     > = new Map();
 
@@ -332,7 +332,7 @@ export class A_Command<
         this._createdAt = new Date();
         this._status = A_Command_Status.INITIALIZED;
 
-        this.emit(A_CommandFeatures.onInit);
+        this.emit(A_CommandEvent.onInit);
     }
 
     @A_Feature.Extend()
@@ -349,7 +349,7 @@ export class A_Command<
         this._startTime = new Date();
         this._status = A_Command_Status.EXECUTING;
 
-        this.emit(A_CommandFeatures.onExecute);
+        this.emit(A_CommandEvent.onExecute);
     }
 
     @A_Feature.Extend()
@@ -365,7 +365,7 @@ export class A_Command<
         this._endTime = new Date();
         this._status = A_Command_Status.COMPLETED;
 
-        this.emit(A_CommandFeatures.onComplete);
+        this.emit(A_CommandEvent.onComplete);
     }
 
     @A_Feature.Extend()
@@ -383,7 +383,7 @@ export class A_Command<
 
         this._status = A_Command_Status.FAILED;
 
-        this.emit(A_CommandFeatures.onFail);
+        this.emit(A_CommandEvent.onFail);
     }
 
 
@@ -478,8 +478,6 @@ export class A_Command<
             await new Promise<void>(async (resolve, reject) => {
 
                 try {
-
-
                     const onBeforeExecuteFeature = new A_Feature({
                         name: A_CommandFeatures.onBeforeExecute,
                         component: this,
@@ -500,7 +498,7 @@ export class A_Command<
 
 
 
-                    this.on(A_CommandFeatures.onComplete, () => {
+                    this.on(A_CommandEvent.onComplete, () => {
 
                         onBeforeExecuteFeature.interrupt();
                         onExecuteFeature.interrupt();
@@ -509,6 +507,15 @@ export class A_Command<
                         resolve();
                     });
 
+                    this.on(A_CommandEvent.onFail, () => {
+
+                        onBeforeExecuteFeature.interrupt();
+                        onExecuteFeature.interrupt();
+                        onAfterExecuteFeature.interrupt();
+
+                        reject(this.error);
+                    });
+
 
                     await onBeforeExecuteFeature.process(this.scope);
 
@@ -596,7 +603,7 @@ export class A_Command<
      * @param event 
      * @param listener 
      */
-    on(event: LifecycleEvents | A_Command_Event, listener: A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>) {
+    on(event: LifecycleEvents | A_CommandEvent, listener: A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>) {
         if (!this._listeners.has(event)) {
             this._listeners.set(event, new Set());
         }
@@ -608,7 +615,7 @@ export class A_Command<
      * @param event 
      * @param listener 
      */
-    off(event: LifecycleEvents | A_Command_Event, listener: A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>) {
+    off(event: LifecycleEvents | A_CommandEvent, listener: A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>) {
         this._listeners.get(event)?.delete(listener);
     }
     /**
@@ -616,7 +623,7 @@ export class A_Command<
      * 
      * @param event 
      */
-    emit(event: LifecycleEvents | A_Command_Event) {
+    emit(event: LifecycleEvents | keyof typeof A_CommandEvent) {
         this._listeners.get(event)?.forEach(async listener => {
             listener(this);
         });

package/src/lib/A-Command/A-Command.types.ts

@@ -1,5 +1,5 @@
 import { A_Command } from "./A-Command.entity";
-import { A_Command_Event, A_Command_Status, } from "./A-Command.constants";
+import { A_CommandEvent, A_Command_Status, } from "./A-Command.constants";
 import { A_TYPES__Entity_Serialized, A_TYPES__Error_Serialized } from "@adaas/a-concept";
 
 // ============================================================================
@@ -141,7 +141,7 @@ export type A_TYPES__Command_Serialized<
 export type A_TYPES__Command_Listener<
     InvokeType extends A_TYPES__Command_Init = A_TYPES__Command_Init,
     ResultType extends Record<string, any> = Record<string, any>,
-    LifecycleEvents extends string = A_Command_Event
+    LifecycleEvents extends string = keyof typeof A_CommandEvent
 > = (command?: A_Command<InvokeType, ResultType, LifecycleEvents>) => void;
 
 

package/src/lib/A-Memory/A-Memory.constants.ts

@@ -4,46 +4,46 @@ export enum A_MemoryFeatures {
     /**
      * Allows to extend initialization logic and behavior
      */
-    onInit = 'onInit',
+    onInit = '_A_Memory_onInit',
 
     /**
      * Allows to extend destruction logic and behavior
      */
-    onDestroy = 'onDestroy',
+    onDestroy = '_A_Memory_onDestroy',
 
     /**
      * Allows to extend expiration logic and behavior
      */
-    onExpire = 'onExpire',
+    onExpire = '_A_Memory_onExpire',
 
     /**
      * Allows to extend error handling logic and behavior
      */
-    onError = 'onError',
+    onError = '_A_Memory_onError',
 
     /**
      * Allows to extend serialization logic and behavior
      */
-    onSerialize = 'onSerialize',
+    onSerialize = '_A_Memory_onSerialize',
 
     /**
      * Allows to extend set operation logic and behavior
      */
-    onSet = 'onSet',
+    onSet = '_A_Memory_onSet',
     /**
      * Allows to extend get operation logic and behavior
      */
-    onGet = 'onGet',
+    onGet = '_A_Memory_onGet',
     /**
      * Allows to extend drop operation logic and behavior
      */
-    onDrop = 'onDrop',
+    onDrop = '_A_Memory_onDrop',
     /**
      * Allows to extend clear operation logic and behavior
      */
-    onClear = 'onClear',
+    onClear = '_A_Memory_onClear',
     /**
      * Allows to extend has operation logic and behavior
      */
-    onHas = 'onHas',
+    onHas = '_A_Memory_onHas',
 }

package/src/lib/A-StateMachine/A-StateMachine.constants.ts

@@ -2,17 +2,17 @@ export enum A_StateMachineFeatures {
     /**
      * Allows to extend error handling logic and behavior
      */
-    onError = 'onError',
+    onError = '_A_StateMachine_onError',
     /**
      * Allows to extend initialization logic and behavior
      */
-    onInitialize = 'onInitialize',
+    onInitialize = '_A_StateMachine_onInitialize',
     /**
      * Allows to extend transition validation logic and behavior
      */
-    onBeforeTransition = 'onBeforeTransition',
+    onBeforeTransition = '_A_StateMachine_onBeforeTransition',
     /**
      * Allows to extend post-transition logic and behavior
      */
-    onAfterTransition = 'onAfterTransition',
+    onAfterTransition = '_A_StateMachine_onAfterTransition',
 }

package/tests/A-Command.test.ts

@@ -1,6 +1,6 @@
 import { A_Command } from '@adaas/a-utils/lib/A-Command/A-Command.entity';
 import { A_CommandError } from '@adaas/a-utils/lib/A-Command/A-Command.error';
-import { A_Command_Status, A_CommandFeatures } from '@adaas/a-utils/lib/A-Command/A-Command.constants';
+import { A_Command_Status, A_CommandEvent, A_CommandFeatures } from '@adaas/a-utils/lib/A-Command/A-Command.constants';
 import { A_TYPES__Command_Serialized } from '@adaas/a-utils/lib/A-Command/A-Command.types';
 import { A_StateMachine } from '@adaas/a-utils/lib/A-StateMachine/A-StateMachine.component';
 import { A_Memory } from '@adaas/a-utils/lib/A-Memory/A-Memory.component';
@@ -73,8 +73,8 @@ describe('A-Command tests', () => {
             const command = new TestCommand({ userId: '123', action: 'create' });
             const listener = jest.fn();
 
-            command.on(A_CommandFeatures.onComplete, listener);
-            command.emit(A_CommandFeatures.onComplete);
+            command.on('onComplete', listener);
+            command.emit(A_CommandEvent.onComplete);
 
             expect(listener).toHaveBeenCalledWith(command);
         });
@@ -83,9 +83,9 @@ describe('A-Command tests', () => {
             const command = new TestCommand({ userId: '123', action: 'create' });
             const listener = jest.fn();
 
-            command.on(A_CommandFeatures.onComplete, listener);
-            command.off(A_CommandFeatures.onComplete, listener);
-            command.emit(A_CommandFeatures.onComplete);
+            command.on(A_CommandEvent.onComplete, listener);
+            command.off(A_CommandEvent.onComplete, listener);
+            command.emit(A_CommandEvent.onComplete);
 
             expect(listener).not.toHaveBeenCalled();
         });