@adaas/a-utils 0.2.7 → 0.2.9

package/dist/browser/a-command.mjs

@@ -0,0 +1,567 @@
+import { A_StateMachineTransition, A_StateMachine } from './chunk-NLPSQYIQ.mjs';
+import { A_Logger } from './chunk-TK5UEYMZ.mjs';
+import './chunk-ECSGFDRQ.mjs';
+import './chunk-J6CLHXFQ.mjs';
+import './chunk-72ANHWNG.mjs';
+import { A_ExecutionContext } from './chunk-TQ5UON22.mjs';
+import { __decorateClass, __decorateParam } from './chunk-EQQGB2QZ.mjs';
+import { A_Feature, A_Inject, A_Error, A_Dependency, A_Entity, A_Scope, A_Context } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+
+// src/lib/A-Command/A-Command.constants.ts
+var A_Command_Status = /* @__PURE__ */ ((A_Command_Status2) => {
+  A_Command_Status2["CREATED"] = "CREATED";
+  A_Command_Status2["INITIALIZED"] = "INITIALIZED";
+  A_Command_Status2["COMPILED"] = "COMPILED";
+  A_Command_Status2["EXECUTING"] = "EXECUTING";
+  A_Command_Status2["COMPLETED"] = "COMPLETED";
+  A_Command_Status2["FAILED"] = "FAILED";
+  return A_Command_Status2;
+})(A_Command_Status || {});
+var A_CommandTransitions = /* @__PURE__ */ ((A_CommandTransitions2) => {
+  A_CommandTransitions2["CREATED_TO_INITIALIZED"] = "created_initialized";
+  A_CommandTransitions2["INITIALIZED_TO_EXECUTING"] = "initialized_executing";
+  A_CommandTransitions2["EXECUTING_TO_COMPLETED"] = "executing_completed";
+  A_CommandTransitions2["EXECUTING_TO_FAILED"] = "executing_failed";
+  return A_CommandTransitions2;
+})(A_CommandTransitions || {});
+var A_CommandFeatures = /* @__PURE__ */ ((A_CommandFeatures2) => {
+  A_CommandFeatures2["onInit"] = "_A_Command_onInit";
+  A_CommandFeatures2["onBeforeExecute"] = "_A_Command_onBeforeExecute";
+  A_CommandFeatures2["onExecute"] = "_A_Command_onExecute";
+  A_CommandFeatures2["onAfterExecute"] = "_A_Command_onAfterExecute";
+  A_CommandFeatures2["onComplete"] = "_A_Command_onComplete";
+  A_CommandFeatures2["onFail"] = "_A_Command_onFail";
+  A_CommandFeatures2["onError"] = "_A_Command_onError";
+  return A_CommandFeatures2;
+})(A_CommandFeatures || {});
+var A_CommandEvent = /* @__PURE__ */ ((A_CommandEvent2) => {
+  A_CommandEvent2["onInit"] = "onInit";
+  A_CommandEvent2["onBeforeExecute"] = "onBeforeExecute";
+  A_CommandEvent2["onExecute"] = "onExecute";
+  A_CommandEvent2["onAfterExecute"] = "onAfterExecute";
+  A_CommandEvent2["onComplete"] = "onComplete";
+  A_CommandEvent2["onFail"] = "onFail";
+  A_CommandEvent2["onError"] = "onError";
+  return A_CommandEvent2;
+})(A_CommandEvent || {});
+var A_CommandError = class extends A_Error {
+};
+A_CommandError.CommandScopeBindingError = "A-Command Scope Binding Error";
+A_CommandError.ExecutionError = "A-Command Execution Error";
+A_CommandError.ResultProcessingError = "A-Command Result Processing Error";
+/**
+ * Error indicating that the command was interrupted during execution
+ */
+A_CommandError.CommandInterruptedError = "A-Command Interrupted Error";
+var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+var A_Command = class extends A_Entity {
+  /**
+   * 
+   * A-Command represents an executable command with a specific code and parameters.
+   * It can be executed within a given scope and stores execution results and errors.
+   * 
+   * 
+   * A-Command should be context independent and execution logic should be based on attached components 
+   * 
+   * @param code 
+   * @param params 
+   */
+  constructor(params) {
+    super(params);
+    /** Map of event listeners organized by event name */
+    this._listeners = /* @__PURE__ */ new Map();
+  }
+  // ====================================================================
+  // ================== Static Command Information ======================
+  // ====================================================================
+  /**
+   * Static command identifier derived from the class name
+   * Used for command registration and serialization
+   */
+  static get code() {
+    return super.entity;
+  }
+  // ====================================================================
+  // ================== Public Getter Properties =======================
+  // ====================================================================
+  /**
+   * Total execution duration in milliseconds
+   * 
+   * - If completed/failed: Returns total time from start to end
+   * - If currently executing: Returns elapsed time since start
+   * - If not started: Returns undefined
+   */
+  get duration() {
+    return this._endTime && this._startTime ? this._endTime.getTime() - this._startTime.getTime() : this._startTime ? (/* @__PURE__ */ new Date()).getTime() - this._startTime.getTime() : void 0;
+  }
+  /**
+   * Idle time before execution started in milliseconds
+   * 
+   * Time between command creation and execution start.
+   * Useful for monitoring command queue performance.
+   */
+  get idleTime() {
+    return this._startTime && this._createdAt ? this._startTime.getTime() - this._createdAt.getTime() : void 0;
+  }
+  /**
+   * Command execution scope for dependency injection
+   * 
+   * Provides access to components, services, and shared resources
+   * during command execution. Inherits from the scope where the
+   * command was registered.
+   */
+  get scope() {
+    return this._executionScope;
+  }
+  /**
+   * Execution context associated with the command
+   */
+  get context() {
+    return this.scope.resolve(A_ExecutionContext);
+  }
+  /**
+   * Unique command type identifier
+   * 
+   * Derived from the class name and used for:
+   * - Command registration and resolution
+   * - Serialization and deserialization
+   * - Logging and debugging
+   * 
+   * @example 'create-user-command', 'process-order-command'
+   */
+  get code() {
+    return this.constructor.code;
+  }
+  /**
+   * Current lifecycle status of the command
+   * 
+   * Indicates the current phase in the command execution lifecycle.
+   * Used to track progress and determine available operations.
+   */
+  get status() {
+    return this._status;
+  }
+  /**
+   * Timestamp when the command was created
+   * 
+   * Marks the initial instantiation time, useful for tracking
+   * command age and queue performance metrics.
+   */
+  get createdAt() {
+    return this._createdAt;
+  }
+  /**
+   * Timestamp when command execution started
+   * 
+   * Undefined until execution begins. Used for calculating
+   * execution duration and idle time.
+   */
+  get startedAt() {
+    return this._startTime;
+  }
+  /**
+   * Timestamp when command execution ended
+   * 
+   * Set when command reaches COMPLETED or FAILED status.
+   * Used for calculating total execution duration.
+   */
+  get endedAt() {
+    return this._endTime;
+  }
+  /**
+   * Result data produced by command execution
+   * 
+   * Contains the output data from successful command execution.
+   * Undefined until command completes successfully.
+   */
+  get result() {
+    return this._result;
+  }
+  /**
+   * Array of errors that occurred during execution
+   * 
+   * Automatically wraps native errors in A_Error instances
+   * for consistent error handling. Empty array if no errors occurred.
+   */
+  get error() {
+    return this._error;
+  }
+  /**
+       * Command initialization parameters
+       * 
+       * Contains the input data used to create and configure the command.
+       * These parameters are immutable during command execution.
+                      return new A_Error(err);
+                  }
+              });
+      }
+  
+      /**
+       * Command initialization parameters
+       * 
+       * Contains the input data used to create and configure the command.
+       * These parameters are immutable during command execution.
+       */
+  get params() {
+    return this._params;
+  }
+  /**
+   * Indicates if the command has been processed (completed or failed)
+   * 
+   * Returns true if the command has completed or failed, false otherwise.
+   */
+  get isProcessed() {
+    return this._status === "COMPLETED" /* COMPLETED */ || this._status === "FAILED" /* FAILED */;
+  }
+  async [_k = "_A_StateMachine_onBeforeTransition" /* onBeforeTransition */](transition, logger, ...args) {
+    this.checkScopeInheritance();
+    logger?.debug("yellow", `Command ${this.aseid.toString()} transitioning from ${transition.from} to ${transition.to}`);
+  }
+  async [_j = "created_initialized" /* CREATED_TO_INITIALIZED */](transition, ...args) {
+    if (this._status !== "CREATED" /* CREATED */) {
+      return;
+    }
+    this._createdAt = /* @__PURE__ */ new Date();
+    this._status = "INITIALIZED" /* INITIALIZED */;
+    this.emit("onInit" /* onInit */);
+  }
+  async [_i = "initialized_executing" /* INITIALIZED_TO_EXECUTING */](transition, ...args) {
+    if (this._status !== "INITIALIZED" /* INITIALIZED */ && this._status !== "CREATED" /* CREATED */) {
+      return;
+    }
+    this._startTime = /* @__PURE__ */ new Date();
+    this._status = "EXECUTING" /* EXECUTING */;
+    this.emit("onExecute" /* onExecute */);
+  }
+  /**
+   * Handles command completion after successful execution
+   * 
+   * EXECUTION -> COMPLETED transition
+   */
+  async [_h = "executing_completed" /* EXECUTING_TO_COMPLETED */](transition, ...args) {
+    this._endTime = /* @__PURE__ */ new Date();
+    this._status = "COMPLETED" /* COMPLETED */;
+    this.emit("onComplete" /* onComplete */);
+  }
+  /**
+   * Handles command failure during execution
+   * 
+   * EXECUTION -> FAILED transition
+   */
+  async [_g = "executing_failed" /* EXECUTING_TO_FAILED */](transition, error, ...args) {
+    this._endTime = /* @__PURE__ */ new Date();
+    this._status = "FAILED" /* FAILED */;
+    this.emit("onFail" /* onFail */);
+  }
+  /**
+   * Default behavior for Command Initialization uses StateMachine to transition states
+   */
+  async [_f = "_A_Command_onInit" /* onInit */](stateMachine, ...args) {
+    await stateMachine.transition("CREATED" /* CREATED */, "INITIALIZED" /* INITIALIZED */);
+  }
+  async [_e = "_A_Command_onBeforeExecute" /* onBeforeExecute */](stateMachine, ...args) {
+    await stateMachine.transition("INITIALIZED" /* INITIALIZED */, "EXECUTING" /* EXECUTING */);
+  }
+  async [_d = "_A_Command_onExecute" /* onExecute */](...args) {
+  }
+  /**
+   * By Default on AfterExecute calls the Completion method to mark the command as completed
+   * 
+   * [!] This can be overridden to implement custom behavior using A_Feature overrides
+   */
+  async [_c = "_A_Command_onAfterExecute" /* onAfterExecute */](...args) {
+  }
+  async [_b = "_A_Command_onComplete" /* onComplete */](stateMachine, ...args) {
+    await stateMachine.transition("EXECUTING" /* EXECUTING */, "COMPLETED" /* COMPLETED */);
+  }
+  async [_a = "_A_Command_onFail" /* onFail */](stateMachine, operation, ...args) {
+    await stateMachine.transition("EXECUTING" /* EXECUTING */, "FAILED" /* FAILED */);
+  }
+  // --------------------------------------------------------------------------
+  // A-Command Lifecycle Methods
+  // --------------------------------------------------------------------------
+  /**
+   * Initializes the command before execution.
+   */
+  async init() {
+    await this.call("_A_Command_onInit" /* onInit */, this.scope);
+  }
+  /**
+   * Executes the command logic.
+   */
+  async execute() {
+    if (this.isProcessed) return;
+    try {
+      this.checkScopeInheritance();
+      const context = new A_ExecutionContext("execute-command");
+      this.scope.register(context);
+      await new Promise(async (resolve, reject) => {
+        try {
+          const onBeforeExecuteFeature = new A_Feature({
+            name: "_A_Command_onBeforeExecute" /* onBeforeExecute */,
+            component: this,
+            scope: this.scope
+          });
+          const onExecuteFeature = new A_Feature({
+            name: "_A_Command_onExecute" /* onExecute */,
+            component: this,
+            scope: this.scope
+          });
+          const onAfterExecuteFeature = new A_Feature({
+            name: "_A_Command_onAfterExecute" /* onAfterExecute */,
+            component: this,
+            scope: this.scope
+          });
+          this.on("onComplete" /* onComplete */, () => {
+            onBeforeExecuteFeature.interrupt();
+            onExecuteFeature.interrupt();
+            onAfterExecuteFeature.interrupt();
+            resolve();
+          });
+          this.on("onFail" /* onFail */, () => {
+            onBeforeExecuteFeature.interrupt();
+            onExecuteFeature.interrupt();
+            onAfterExecuteFeature.interrupt();
+            reject(this.error);
+          });
+          await onBeforeExecuteFeature.process(this.scope);
+          await onExecuteFeature.process(this.scope);
+          await onAfterExecuteFeature.process(this.scope);
+          if (this._origin === "invoked") {
+            await this.complete();
+          }
+          resolve();
+        } catch (error) {
+          reject(error);
+        }
+      });
+    } catch (error) {
+      let targetError = error instanceof A_Error ? error : new A_CommandError({
+        title: A_CommandError.ExecutionError,
+        description: `An error occurred while executing command "${this.aseid.toString()}".`,
+        originalError: error
+      });
+      await this.fail(targetError);
+    }
+  }
+  /**
+   * Marks the command as completed
+   * 
+   * 
+   * Calling This method will set the command status to COMPLETED, record the end time,
+   * store the result, emit the onComplete event, and destroy the execution scope.
+   *
+   * [!] After Calling this method, the command is considered fully processed And further processing will be INTERRUPTED. 
+   * [!] If the command is already processed (COMPLETED or FAILED), this method does nothing.
+   * [!] This method can be called with optional result data to store with the command.
+   * 
+   * @param result - Optional result data to store with the command
+   */
+  async complete(result) {
+    if (this.isProcessed) return;
+    this._status = "COMPLETED" /* COMPLETED */;
+    this._result = result;
+    await this.call("_A_Command_onComplete" /* onComplete */, this.scope);
+    this.scope.destroy();
+  }
+  /**
+   * Marks the command as failed
+   */
+  async fail(error) {
+    if (this.isProcessed) return;
+    this._status = "FAILED" /* FAILED */;
+    if (error) {
+      this._error = error;
+      this.scope.register(error);
+    }
+    await this.call("_A_Command_onFail" /* onFail */, this.scope);
+    this.scope.destroy();
+  }
+  // --------------------------------------------------------------------------   
+  // A-Command Event-Emitter methods
+  // --------------------------------------------------------------------------
+  /**
+   * Registers an event listener for a specific event
+   * 
+   * @param event 
+   * @param listener 
+   */
+  on(event, listener) {
+    if (!this._listeners.has(event)) {
+      this._listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this._listeners.get(event).add(listener);
+  }
+  /**
+   * Removes an event listener for a specific event
+   * 
+   * @param event 
+   * @param listener 
+   */
+  off(event, listener) {
+    this._listeners.get(event)?.delete(listener);
+  }
+  /**
+   * Emits an event to all registered listeners
+   * 
+   * @param event 
+   */
+  emit(event) {
+    this._listeners.get(event)?.forEach(async (listener) => {
+      listener(this);
+    });
+  }
+  // --------------------------------------------------------------------------
+  // A-Entity Base Class Overrides
+  // --------------------------------------------------------------------------
+  // Serialization / Deserialization
+  // -------------------------------------------------------------------------
+  /**
+   * Allows to create a Command instance from new data
+   * 
+   * @param newEntity 
+   */
+  fromNew(newEntity) {
+    super.fromNew(newEntity);
+    this._origin = "invoked";
+    this._executionScope = new A_Scope({
+      name: `A-Command-Execution-Scope-${this.aseid.toString()}`,
+      components: [A_StateMachine]
+    });
+    this._createdAt = /* @__PURE__ */ new Date();
+    this._params = newEntity;
+    this._status = "CREATED" /* CREATED */;
+  }
+  /**
+   * Allows to convert serialized data to Command instance
+   * 
+   * [!] By default it omits params as they are not stored in the serialized data
+   * 
+   * @param serialized 
+   */
+  fromJSON(serialized) {
+    super.fromJSON(serialized);
+    this._origin = "serialized";
+    this._executionScope = new A_Scope({
+      name: `A-Command-Execution-Scope-${this.aseid.toString()}`,
+      components: [A_StateMachine]
+    });
+    if (serialized.createdAt) this._createdAt = new Date(serialized.createdAt);
+    if (serialized.startedAt) this._startTime = new Date(serialized.startedAt);
+    if (serialized.endedAt) this._endTime = new Date(serialized.endedAt);
+    this._params = serialized.params;
+    this._status = serialized.status;
+    if (serialized.error)
+      this._error = new A_CommandError(serialized.error);
+    if (serialized.result)
+      this._result = serialized.result;
+  }
+  /**
+   * Converts the Command instance to a plain object
+   * 
+   * @returns 
+   */
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      code: this.code,
+      status: this._status,
+      params: this._params,
+      createdAt: this._createdAt.toISOString(),
+      startedAt: this._startTime ? this._startTime.toISOString() : void 0,
+      endedAt: this._endTime ? this._endTime.toISOString() : void 0,
+      duration: this.duration,
+      idleTime: this.idleTime,
+      result: this.result,
+      error: this.error ? this.error.toJSON() : void 0
+    };
+  }
+  //============================================================================================
+  //                                Helpers Methods
+  //============================================================================================
+  /**
+   * Ensures that the command's execution scope inherits from the context scope
+   * 
+   * Throws an error if the command is not bound to any context scope
+   */
+  checkScopeInheritance() {
+    let attachedScope;
+    try {
+      attachedScope = A_Context.scope(this);
+    } catch (error) {
+      throw new A_CommandError({
+        title: A_CommandError.CommandScopeBindingError,
+        description: `Command ${this.aseid.toString()} is not bound to any context scope. Ensure the command is properly registered within a context before execution.`,
+        originalError: error
+      });
+    }
+    if (!this.scope.isInheritedFrom(A_Context.scope(this))) {
+      this.scope.inherit(A_Context.scope(this));
+    }
+  }
+};
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_StateMachineTransition)),
+  __decorateParam(1, A_Inject(A_Logger))
+], A_Command.prototype, _k, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_StateMachineTransition))
+], A_Command.prototype, _j, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_StateMachineTransition))
+], A_Command.prototype, _i, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_StateMachineTransition))
+], A_Command.prototype, _h, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_StateMachineTransition)),
+  __decorateParam(1, A_Inject(A_Error))
+], A_Command.prototype, _g, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_StateMachine))
+], A_Command.prototype, _f, 1);
+__decorateClass([
+  A_Feature.Extend({
+    after: /.*/
+  }),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_StateMachine))
+], A_Command.prototype, _e, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Command.prototype, _d, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Command.prototype, _c, 1);
+__decorateClass([
+  A_Feature.Extend({
+    after: /.*/
+  }),
+  __decorateParam(0, A_Inject(A_StateMachine))
+], A_Command.prototype, _b, 1);
+__decorateClass([
+  A_Feature.Extend({
+    after: /.*/
+  }),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_StateMachine)),
+  __decorateParam(1, A_Inject(A_ExecutionContext))
+], A_Command.prototype, _a, 1);
+A_Command = __decorateClass([
+  A_Frame.Entity({
+    namespace: "A-Utils",
+    name: "A-Command",
+    description: "Advanced Command Pattern Implementation with full lifecycle management, event handling, and state persistence. This entity allows to execute commands in distributed environment across multiple services."
+  })
+], A_Command);
+
+export { A_Command, A_CommandError, A_CommandEvent, A_CommandFeatures, A_CommandTransitions, A_Command_Status };
+//# sourceMappingURL=a-command.mjs.map
+//# sourceMappingURL=a-command.mjs.map

package/dist/browser/a-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-Command/A-Command.constants.ts","../../src/lib/A-Command/A-Command.error.ts","../../src/lib/A-Command/A-Command.entity.ts"],"names":["A_Command_Status","A_CommandTransitions","A_CommandFeatures","A_CommandEvent","A_Error"],"mappings":"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","file":"a-command.mjs","sourcesContent":["/**\n * A-Command Status Enumeration\n * \n * Defines all possible states a command can be in during its lifecycle.\n * Commands progress through these states in a specific order:\n * CREATED → INITIALIZED → COMPILED → EXECUTING → COMPLETED/FAILED\n */\nexport enum A_Command_Status {\n    /**\n     * Initial state when command is instantiated but not yet ready for execution\n     */\n    CREATED = 'CREATED',\n\n    /**\n     * Command has been initialized with execution scope and dependencies\n     */\n    INITIALIZED = 'INITIALIZED',\n\n    /**\n     * Command has been compiled and is ready for execution\n     */\n    COMPILED = 'COMPILED',\n\n    /**\n     * Command is currently being executed\n     */\n    EXECUTING = 'EXECUTING',\n\n    /**\n     * Command has completed successfully\n     */\n    COMPLETED = 'COMPLETED',\n\n    /**\n     * Command execution has failed with errors\n     */\n    FAILED = 'FAILED',\n}\n\n\n/**\n * A-Command State Transitions\n * \n * Defines valid state transitions for command lifecycle management.\n * These transitions are used by the StateMachine to enforce proper command flow.\n */\nexport enum A_CommandTransitions {\n    /** Transition from CREATED to INITIALIZED state */\n    CREATED_TO_INITIALIZED = 'created_initialized',\n\n    /** Transition from INITIALIZED to EXECUTING state */\n    INITIALIZED_TO_EXECUTING = 'initialized_executing',\n\n    /** Transition from EXECUTING to COMPLETED state (success path) */\n    EXECUTING_TO_COMPLETED = 'executing_completed',\n\n    /** Transition from EXECUTING to FAILED state (error path) */\n    EXECUTING_TO_FAILED = 'executing_failed',\n}\n\n/**\n * A-Command Lifecycle Features\n * \n * Defines feature extension points that components can implement to customize\n * command behavior at different stages of the lifecycle.\n * \n * Components can use @A_Feature.Extend() decorator with these feature names\n * to inject custom logic into command execution.\n */\nexport enum A_CommandFeatures {\n    /**\n     * Triggered during command initialization phase\n     * Use to set up execution environment, validate parameters, or prepare resources\n     */\n    onInit = '_A_Command_onInit',\n\n    /**\n     * Triggered before command execution starts\n     * Use for pre-execution validation, logging, or setup tasks\n     */\n    onBeforeExecute = '_A_Command_onBeforeExecute',\n\n    /**\n     * Main command execution logic\n     * Core business logic should be implemented here\n     */\n    onExecute = '_A_Command_onExecute',\n\n    /**\n     * Triggered after command execution completes (success or failure)\n     * Use for cleanup, logging, or post-processing tasks\n     */\n    onAfterExecute = '_A_Command_onAfterExecute',\n\n    /**\n     * Triggered when command completes successfully\n     * Use for success-specific operations like notifications or result processing\n     */\n    onComplete = '_A_Command_onComplete',\n\n    /**\n     * Triggered when command execution fails\n     * Use for error handling, cleanup, or failure notifications\n     */\n    onFail = '_A_Command_onFail',\n\n    /**\n     * Triggered when an error occurs during execution\n     * Use for error logging, transformation, or recovery attempts\n     */\n    onError = '_A_Command_onError',\n}\n\n\nexport enum A_CommandEvent {\n    /**\n     * Triggered during command initialization phase\n     * Use to set up execution environment, validate parameters, or prepare resources\n     */\n    onInit = 'onInit',\n\n    /**\n     * Triggered before command execution starts\n     * Use for pre-execution validation, logging, or setup tasks\n     */\n    onBeforeExecute = 'onBeforeExecute',\n\n    /**\n     * Main command execution logic\n     * Core business logic should be implemented here\n     */\n    onExecute = 'onExecute',\n\n    /**\n     * Triggered after command execution completes (success or failure)\n     * Use for cleanup, logging, or post-processing tasks\n     */\n    onAfterExecute = 'onAfterExecute',\n\n    /**\n     * Triggered when command completes successfully\n     * Use for success-specific operations like notifications or result processing\n     */\n    onComplete = 'onComplete',\n\n    /**\n     * Triggered when command execution fails\n     * Use for error handling, cleanup, or failure notifications\n     */\n    onFail = 'onFail',\n\n    /**\n     * Triggered when an error occurs during execution\n     * Use for error logging, transformation, or recovery attempts\n     */\n    onError = 'onError',\n}\n\n/**\n * Type alias for command lifecycle event names\n * Represents all available events that can be listened to on a command instance\n */\nexport type A_CommandEvents = keyof typeof A_CommandEvent;\n\n\n\n\n\n","import { A_Error } from \"@adaas/a-concept\";\n\n\nexport class A_CommandError extends A_Error {\n\n\n    static readonly CommandScopeBindingError = 'A-Command Scope Binding Error';\n\n    static readonly ExecutionError = 'A-Command Execution Error';\n\n    static readonly ResultProcessingError = 'A-Command Result Processing Error';\n\n\n    /**\n     * Error indicating that the command was interrupted during execution\n     */\n    static readonly CommandInterruptedError = 'A-Command Interrupted Error';\n}","import {\n    A_Command_ExecutionContext,\n    A_TYPES__Command_Init,\n    A_TYPES__Command_Listener,\n    A_TYPES__Command_Serialized\n} from \"./A-Command.types\";\nimport {\n    A_CommandFeatures,\n    A_Command_Status,\n    A_CommandTransitions,\n    A_CommandEvent\n} from \"./A-Command.constants\";\nimport { A_Context, A_Dependency, A_Entity, A_Error, A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_CommandError } from \"./A-Command.error\";\nimport { A_StateMachine, A_StateMachineFeatures, A_StateMachineTransition } from \"@adaas/a-utils/a-state-machine\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_ExecutionContext } from \"@adaas/a-utils/a-execution\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n/**\n * A_Command - Advanced Command Pattern Implementation\n * \n * A comprehensive command pattern implementation that encapsulates business logic\n * as executable commands with full lifecycle management, event handling, and \n * state persistence capabilities.\n * \n * ## Key Features\n * - **Structured Lifecycle**: Automatic progression through init → compile → execute → complete/fail\n * - **Event-Driven**: Subscribe to lifecycle events and emit custom events\n * - **State Persistence**: Full serialization/deserialization for cross-service communication\n * - **Type Safety**: Generic types for parameters, results, and custom events\n * - **Dependency Injection**: Integrated with A-Concept's DI system\n * - **Error Management**: Comprehensive error capture and handling\n * - **Execution Tracking**: Built-in timing and performance metrics\n * \n * ## Lifecycle Phases\n * 1. **CREATED** - Command instantiated but not initialized\n * 2. **INITIALIZED** - Execution scope and dependencies set up\n * 3. **COMPILED** - Ready for execution with all resources prepared\n * 4. **EXECUTING** - Currently running business logic\n * 5. **COMPLETED** - Successfully finished execution\n * 6. **FAILED** - Execution failed with errors captured\n * \n * @template InvokeType - Type definition for command parameters\n * @template ResultType - Type definition for command execution result\n * @template LifecycleEvents - Union type of custom lifecycle event names\n * \n * @example\n * ```typescript\n * // Define parameter and result types\n * interface UserCreateParams {\n *   name: string;\n *   email: string;\n *   role: 'admin' | 'user';\n * }\n * \n * interface UserCreateResult {\n *   userId: string;\n *   success: boolean;\n * }\n * \n * // Create custom command\n * class CreateUserCommand extends A_Command<UserCreateParams, UserCreateResult> {}\n * \n * // Execute command\n * const command = new CreateUserCommand({\n *   name: 'John Doe',\n *   email: 'john@example.com',\n *   role: 'user'\n * });\n * \n * scope.register(command);\n * await command.execute();\n * \n * console.log('Result:', command.result);\n * console.log('Status:', command.status);\n * ```\n */\n@A_Frame.Entity({\n    namespace: 'A-Utils',\n    name: 'A-Command',\n    description: 'Advanced Command Pattern Implementation with full lifecycle management, event handling, and state persistence. This entity allows to execute commands in distributed environment across multiple services.'\n})\nexport class A_Command<\n    InvokeType extends A_TYPES__Command_Init = A_TYPES__Command_Init,\n    ResultType extends Record<string, any> = Record<string, any>,\n    LifecycleEvents extends string | keyof typeof A_CommandEvent = keyof typeof A_CommandEvent,\n> extends A_Entity<InvokeType, A_TYPES__Command_Serialized<InvokeType, ResultType>> {\n\n    // ====================================================================\n    // ================== Static Command Information ======================\n    // ====================================================================\n\n    /**\n     * Static command identifier derived from the class name\n     * Used for command registration and serialization\n     */\n    static get code(): string {\n        return super.entity;\n    }\n\n    // ====================================================================\n    // ================== Instance Properties =============================\n    // ====================================================================\n\n    /** The origin of the command, used to know has it been created from serialization or invoked */\n    protected _origin!: 'invoked' | 'serialized';\n\n    /** Command execution scope for dependency injection and feature resolution */\n    protected _executionScope!: A_Scope;\n\n    /** Result data produced by successful command execution */\n    protected _result?: ResultType;\n\n    /** Set of errors that occurred during command execution */\n    protected _error!: A_Error;\n\n    /** Command initialization parameters */\n    protected _params!: InvokeType;\n\n    /** Current lifecycle status of the command */\n    protected _status!: A_Command_Status\n\n    /** Map of event listeners organized by event name */\n    protected _listeners: Map<\n        LifecycleEvents | keyof typeof A_CommandEvent,\n        Set<A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>>\n    > = new Map();\n\n    /** Timestamp when command execution started */\n    protected _startTime?: Date;\n\n    /** Timestamp when command execution ended */\n    protected _endTime?: Date;\n\n    /** Timestamp when command was created */\n    protected _createdAt!: Date;\n\n\n    // ====================================================================\n    // ================== Public Getter Properties =======================\n    // ====================================================================\n\n    /**\n     * Total execution duration in milliseconds\n     * \n     * - If completed/failed: Returns total time from start to end\n     * - If currently executing: Returns elapsed time since start\n     * - If not started: Returns undefined\n     */\n    get duration(): number | undefined {\n        return this._endTime && this._startTime\n            ? this._endTime.getTime() - this._startTime.getTime()\n            : this._startTime\n                ? new Date().getTime() - this._startTime.getTime()\n                : undefined;\n    }\n\n    /**\n     * Idle time before execution started in milliseconds\n     * \n     * Time between command creation and execution start.\n     * Useful for monitoring command queue performance.\n     */\n    get idleTime(): number | undefined {\n        return this._startTime && this._createdAt\n            ? this._startTime.getTime() - this._createdAt.getTime()\n            : undefined;\n    }\n\n    /**\n     * Command execution scope for dependency injection\n     * \n     * Provides access to components, services, and shared resources\n     * during command execution. Inherits from the scope where the\n     * command was registered.\n     */\n    get scope(): A_Scope {\n        return this._executionScope;\n    }\n    /**\n     * Execution context associated with the command\n     */\n    get context(): A_ExecutionContext<A_Command_ExecutionContext<InvokeType, ResultType>> {\n        return this.scope.resolve(A_ExecutionContext<A_Command_ExecutionContext<InvokeType, ResultType>>)!;\n    }\n\n    /**\n     * Unique command type identifier\n     * \n     * Derived from the class name and used for:\n     * - Command registration and resolution\n     * - Serialization and deserialization\n     * - Logging and debugging\n     * \n     * @example 'create-user-command', 'process-order-command'\n     */\n    get code(): string {\n        return (this.constructor as typeof A_Command).code;\n    }\n    /**\n     * Current lifecycle status of the command\n     * \n     * Indicates the current phase in the command execution lifecycle.\n     * Used to track progress and determine available operations.\n     */\n    get status(): A_Command_Status {\n        return this._status;\n    }\n\n    /**\n     * Timestamp when the command was created\n     * \n     * Marks the initial instantiation time, useful for tracking\n     * command age and queue performance metrics.\n     */\n    get createdAt(): Date {\n        return this._createdAt!;\n    }\n\n    /**\n     * Timestamp when command execution started\n     * \n     * Undefined until execution begins. Used for calculating\n     * execution duration and idle time.\n     */\n    get startedAt(): Date | undefined {\n        return this._startTime;\n    }\n\n    /**\n     * Timestamp when command execution ended\n     * \n     * Set when command reaches COMPLETED or FAILED status.\n     * Used for calculating total execution duration.\n     */\n    get endedAt(): Date | undefined {\n        return this._endTime;\n    }\n\n    /**\n     * Result data produced by command execution\n     * \n     * Contains the output data from successful command execution.\n     * Undefined until command completes successfully.\n     */\n    get result(): ResultType | undefined {\n        return this._result;\n    }\n\n    /**\n     * Array of errors that occurred during execution\n     * \n     * Automatically wraps native errors in A_Error instances\n     * for consistent error handling. Empty array if no errors occurred.\n     */\n    get error(): A_Error | undefined {\n        return this._error;\n    }\n\n    /**\n     * Command initialization parameters\n     * \n     * Contains the input data used to create and configure the command.\n     * These parameters are immutable during command execution.\n                    return new A_Error(err);\n                }\n            });\n    }\n\n    /**\n     * Command initialization parameters\n     * \n     * Contains the input data used to create and configure the command.\n     * These parameters are immutable during command execution.\n     */\n    get params(): InvokeType {\n        return this._params;\n    }\n\n    /**\n     * Indicates if the command has been processed (completed or failed)\n     * \n     * Returns true if the command has completed or failed, false otherwise.\n     */\n    get isProcessed(): boolean {\n        return this._status === A_Command_Status.COMPLETED\n            || this._status === A_Command_Status.FAILED;\n    }\n\n    /**\n     * \n     * A-Command represents an executable command with a specific code and parameters.\n     * It can be executed within a given scope and stores execution results and errors.\n     * \n     * \n     * A-Command should be context independent and execution logic should be based on attached components \n     * \n     * @param code \n     * @param params \n     */\n    constructor(\n        /**\n         * Command invocation parameters\n         */\n        params: InvokeType | A_TYPES__Command_Serialized<InvokeType, ResultType> | string,\n    ) {\n        super(params as any);\n    }\n\n    // --------------------------------------------------------------------------\n    // A-StateMachine Feature Extensions\n    // --------------------------------------------------------------------------\n    @A_Feature.Extend()\n    protected async [A_StateMachineFeatures.onBeforeTransition](\n        @A_Inject(A_StateMachineTransition) transition: A_StateMachineTransition,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        this.checkScopeInheritance();\n\n        //  and register all allowed status transitions\n        //  switch across allowed transitions, if not allowed throw an error\n        logger?.debug('yellow', `Command ${this.aseid.toString()} transitioning from ${transition.from} to ${transition.to}`);\n    }\n\n    @A_Feature.Extend()\n    protected async [A_CommandTransitions.CREATED_TO_INITIALIZED](\n        @A_Inject(A_StateMachineTransition) transition: A_StateMachineTransition,\n        ...args: any[]\n    ): Promise<void> {\n        if (this._status !== A_Command_Status.CREATED) {\n            return;\n        }\n\n        this._createdAt = new Date();\n        this._status = A_Command_Status.INITIALIZED;\n\n        this.emit(A_CommandEvent.onInit);\n    }\n\n    @A_Feature.Extend()\n    protected async [A_CommandTransitions.INITIALIZED_TO_EXECUTING](\n        @A_Inject(A_StateMachineTransition) transition: A_StateMachineTransition,\n        ...args: any[]\n    ): Promise<void> {\n        if (this._status !== A_Command_Status.INITIALIZED\n            && this._status !== A_Command_Status.CREATED\n        ) {\n            return;\n        }\n\n        this._startTime = new Date();\n        this._status = A_Command_Status.EXECUTING;\n\n        this.emit(A_CommandEvent.onExecute);\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles command completion after successful execution\n     * \n     * EXECUTION -> COMPLETED transition\n     */\n    protected async [A_CommandTransitions.EXECUTING_TO_COMPLETED](\n        @A_Inject(A_StateMachineTransition) transition: A_StateMachineTransition,\n        ...args: any[]\n    ): Promise<void> {\n        this._endTime = new Date();\n        this._status = A_Command_Status.COMPLETED;\n\n        this.emit(A_CommandEvent.onComplete);\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles command failure during execution\n     * \n     * EXECUTION -> FAILED transition\n     */\n    protected async [A_CommandTransitions.EXECUTING_TO_FAILED](\n        @A_Inject(A_StateMachineTransition) transition: A_StateMachineTransition,\n        @A_Inject(A_Error) error: A_Error,\n        ...args: any[]\n    ): Promise<void> {\n        this._endTime = new Date();\n\n        this._status = A_Command_Status.FAILED;\n\n        this.emit(A_CommandEvent.onFail);\n    }\n\n\n    // --------------------------------------------------------------------------\n    // A-Command Lifecycle Feature Extensions\n    // --------------------------------------------------------------------------\n    @A_Feature.Extend()\n    /**\n     * Default behavior for Command Initialization uses StateMachine to transition states\n     */\n    protected async [A_CommandFeatures.onInit](\n        @A_Inject(A_StateMachine) stateMachine: A_StateMachine,\n        ...args: any[]\n    ): Promise<void> {\n        await stateMachine.transition(A_Command_Status.CREATED, A_Command_Status.INITIALIZED);\n    }\n\n    @A_Feature.Extend({\n        after: /.*/\n    })\n    protected async [A_CommandFeatures.onBeforeExecute](\n        @A_Dependency.Required()\n        @A_Inject(A_StateMachine) stateMachine: A_StateMachine,\n        ...args: any[]\n    ): Promise<void> {\n        await stateMachine.transition(A_Command_Status.INITIALIZED, A_Command_Status.EXECUTING);\n    }\n\n    @A_Feature.Extend()\n    protected async [A_CommandFeatures.onExecute](\n        ...args: any[]\n    ): Promise<void> {\n    }\n\n    @A_Feature.Extend()\n    /**\n     * By Default on AfterExecute calls the Completion method to mark the command as completed\n     * \n     * [!] This can be overridden to implement custom behavior using A_Feature overrides\n     */\n    protected async [A_CommandFeatures.onAfterExecute](\n        ...args: any[]\n    ): Promise<void> {\n    }\n\n    @A_Feature.Extend({\n        after: /.*/\n    })\n    protected async [A_CommandFeatures.onComplete](\n        @A_Inject(A_StateMachine) stateMachine: A_StateMachine,\n        ...args: any[]\n    ): Promise<void> {\n        await stateMachine.transition(A_Command_Status.EXECUTING, A_Command_Status.COMPLETED);\n    }\n\n    @A_Feature.Extend({\n        after: /.*/\n    })\n    protected async [A_CommandFeatures.onFail](\n        @A_Dependency.Required()\n        @A_Inject(A_StateMachine) stateMachine: A_StateMachine,\n        @A_Inject(A_ExecutionContext) operation: A_ExecutionContext<A_Command_ExecutionContext<InvokeType, ResultType>>,\n        ...args: any[]\n    ): Promise<void> {\n        await stateMachine.transition(A_Command_Status.EXECUTING, A_Command_Status.FAILED);\n    }\n\n    // --------------------------------------------------------------------------\n    // A-Command Lifecycle Methods\n    // --------------------------------------------------------------------------\n    /**\n     * Initializes the command before execution.\n     */\n    async init(): Promise<void> {\n        await this.call(A_CommandFeatures.onInit, this.scope);\n    }\n\n    /**\n     * Executes the command logic.\n     */\n    async execute(): Promise<any> {\n\n        if (this.isProcessed) return;\n\n        try {\n            this.checkScopeInheritance();\n\n            const context = new A_ExecutionContext<A_Command_ExecutionContext<InvokeType, ResultType>>('execute-command');\n\n            this.scope.register(context);\n\n            await new Promise<void>(async (resolve, reject) => {\n\n                try {\n                    const onBeforeExecuteFeature = new A_Feature({\n                        name: A_CommandFeatures.onBeforeExecute,\n                        component: this,\n                        scope: this.scope\n                    })\n\n                    const onExecuteFeature = new A_Feature({\n                        name: A_CommandFeatures.onExecute,\n                        component: this,\n                        scope: this.scope\n                    })\n\n                    const onAfterExecuteFeature = new A_Feature({\n                        name: A_CommandFeatures.onAfterExecute,\n                        component: this,\n                        scope: this.scope\n                    })\n\n\n\n                    this.on(A_CommandEvent.onComplete, () => {\n\n                        onBeforeExecuteFeature.interrupt();\n                        onExecuteFeature.interrupt();\n                        onAfterExecuteFeature.interrupt();\n\n                        resolve();\n                    });\n\n                    this.on(A_CommandEvent.onFail, () => {\n\n                        onBeforeExecuteFeature.interrupt();\n                        onExecuteFeature.interrupt();\n                        onAfterExecuteFeature.interrupt();\n\n                        reject(this.error);\n                    });\n\n\n                    await onBeforeExecuteFeature.process(this.scope);\n\n                    await onExecuteFeature.process(this.scope);\n\n                    await onAfterExecuteFeature.process(this.scope);\n\n                    /** only in case it was really invoked we automatically transit it to COMPLETED state */\n                    if (this._origin === 'invoked') {\n                        await this.complete();\n                    }\n\n                    resolve();\n\n                } catch (error) {\n                    reject(error);\n                }\n            });\n\n        } catch (error) {\n            let targetError = error instanceof A_Error\n                ? error\n                : new A_CommandError({\n                    title: A_CommandError.ExecutionError,\n                    description: `An error occurred while executing command \"${this.aseid.toString()}\".`,\n                    originalError: error\n                });\n\n            await this.fail(targetError);\n        }\n    }\n\n    /**\n     * Marks the command as completed\n     * \n     * \n     * Calling This method will set the command status to COMPLETED, record the end time,\n     * store the result, emit the onComplete event, and destroy the execution scope.\n     *\n     * [!] After Calling this method, the command is considered fully processed And further processing will be INTERRUPTED. \n     * [!] If the command is already processed (COMPLETED or FAILED), this method does nothing.\n     * [!] This method can be called with optional result data to store with the command.\n     * \n     * @param result - Optional result data to store with the command\n     */\n    async complete(result?: ResultType) {\n        if (this.isProcessed) return;\n\n        this._status = A_Command_Status.COMPLETED;\n\n        this._result = result;\n\n        await this.call(A_CommandFeatures.onComplete, this.scope);\n\n        this.scope.destroy();\n    }\n\n\n\n    /**\n     * Marks the command as failed\n     */\n    async fail(error?: A_Error) {\n        if (this.isProcessed) return;\n\n        this._status = A_Command_Status.FAILED;\n        if (error) {\n            this._error = error;\n            this.scope.register(error);\n        }\n\n        await this.call(A_CommandFeatures.onFail, this.scope);\n\n        this.scope.destroy();\n    }\n\n\n    // --------------------------------------------------------------------------   \n    // A-Command Event-Emitter methods\n    // --------------------------------------------------------------------------\n\n    /**\n     * Registers an event listener for a specific event\n     * \n     * @param event \n     * @param listener \n     */\n    on(event: LifecycleEvents | A_CommandEvent, listener: A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>) {\n        if (!this._listeners.has(event)) {\n            this._listeners.set(event, new Set());\n        }\n        this._listeners.get(event)!.add(listener);\n    }\n    /**\n     * Removes an event listener for a specific event\n     * \n     * @param event \n     * @param listener \n     */\n    off(event: LifecycleEvents | A_CommandEvent, listener: A_TYPES__Command_Listener<InvokeType, ResultType, LifecycleEvents>) {\n        this._listeners.get(event)?.delete(listener);\n    }\n    /**\n     * Emits an event to all registered listeners\n     * \n     * @param event \n     */\n    emit(event: LifecycleEvents | keyof typeof A_CommandEvent) {\n        this._listeners.get(event)?.forEach(async listener => {\n            listener(this);\n        });\n    }\n\n\n    // --------------------------------------------------------------------------\n    // A-Entity Base Class Overrides\n    // --------------------------------------------------------------------------\n    // Serialization / Deserialization\n    // -------------------------------------------------------------------------\n\n\n    /**\n     * Allows to create a Command instance from new data\n     * \n     * @param newEntity \n     */\n    fromNew(newEntity: InvokeType): void {\n        super.fromNew(newEntity);\n\n        this._origin = 'invoked';\n\n        this._executionScope = new A_Scope({\n            name: `A-Command-Execution-Scope-${this.aseid.toString()}`,\n            components: [A_StateMachine],\n        });\n\n        this._createdAt = new Date();\n\n        this._params = newEntity;\n\n        this._status = A_Command_Status.CREATED;\n    }\n\n\n\n    /**\n     * Allows to convert serialized data to Command instance\n     * \n     * [!] By default it omits params as they are not stored in the serialized data\n     * \n     * @param serialized \n     */\n    fromJSON(serialized: A_TYPES__Command_Serialized<InvokeType, ResultType>): void {\n        super.fromJSON(serialized);\n\n        this._origin = 'serialized';\n\n        this._executionScope = new A_Scope({\n            name: `A-Command-Execution-Scope-${this.aseid.toString()}`,\n            components: [A_StateMachine],\n        });\n\n        if (serialized.createdAt) this._createdAt = new Date(serialized.createdAt);\n        if (serialized.startedAt) this._startTime = new Date(serialized.startedAt);\n        if (serialized.endedAt) this._endTime = new Date(serialized.endedAt);\n\n        this._params = serialized.params\n        this._status = serialized.status;\n\n        if (serialized.error)\n            this._error = new A_CommandError(serialized.error)\n\n        if (serialized.result)\n            this._result = serialized.result;\n    }\n\n\n    /**\n     * Converts the Command instance to a plain object\n     * \n     * @returns \n     */\n    toJSON(): A_TYPES__Command_Serialized<InvokeType, ResultType> {\n        return {\n            ...super.toJSON(),\n            code: this.code,\n            status: this._status,\n            params: this._params,\n            createdAt: this._createdAt.toISOString(),\n            startedAt: this._startTime ? this._startTime.toISOString() : undefined,\n            endedAt: this._endTime ? this._endTime.toISOString() : undefined,\n            duration: this.duration,\n            idleTime: this.idleTime,\n            result: this.result,\n            error: this.error ? this.error.toJSON() : undefined,\n        }\n    };\n\n\n    //============================================================================================\n    //                                Helpers Methods\n    //============================================================================================\n    /**\n     * Ensures that the command's execution scope inherits from the context scope\n     * \n     * Throws an error if the command is not bound to any context scope\n     */\n    protected checkScopeInheritance(): void {\n        let attachedScope: A_Scope;\n\n        try {\n            attachedScope = A_Context.scope(this);\n        } catch (error) {\n            throw new A_CommandError({\n                title: A_CommandError.CommandScopeBindingError,\n                description: `Command ${this.aseid.toString()} is not bound to any context scope. Ensure the command is properly registered within a context before execution.`,\n                originalError: error\n            });\n        }\n\n        if (!this.scope.isInheritedFrom(A_Context.scope(this))) {\n            this.scope.inherit(A_Context.scope(this));\n        }\n    }\n}\n\n"]}