@adaas/a-utils 0.2.7 → 0.2.9

package/dist/node/lib/A-Command/A-Command.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Command/A-Command.constants.ts"],"names":["A_Command_Status","A_CommandTransitions","A_CommandFeatures","A_CommandEvent"],"mappings":";;AAOO,IAAK,gBAAA,qBAAAA,iBAAAA,KAAL;AAIH,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAKV,EAAAA,kBAAA,aAAA,CAAA,GAAc,aAAA;AAKd,EAAAA,kBAAA,UAAA,CAAA,GAAW,UAAA;AAKX,EAAAA,kBAAA,WAAA,CAAA,GAAY,WAAA;AAKZ,EAAAA,kBAAA,WAAA,CAAA,GAAY,WAAA;AAKZ,EAAAA,kBAAA,QAAA,CAAA,GAAS,QAAA;AA7BD,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;AAuCL,IAAK,oBAAA,qBAAAC,qBAAAA,KAAL;AAEH,EAAAA,sBAAA,wBAAA,CAAA,GAAyB,qBAAA;AAGzB,EAAAA,sBAAA,0BAAA,CAAA,GAA2B,uBAAA;AAG3B,EAAAA,sBAAA,wBAAA,CAAA,GAAyB,qBAAA;AAGzB,EAAAA,sBAAA,qBAAA,CAAA,GAAsB,kBAAA;AAXd,EAAA,OAAAA,qBAAAA;AAAA,CAAA,EAAA,oBAAA,IAAA,EAAA;AAuBL,IAAK,iBAAA,qBAAAC,kBAAAA,KAAL;AAKH,EAAAA,mBAAA,QAAA,CAAA,GAAS,mBAAA;AAMT,EAAAA,mBAAA,iBAAA,CAAA,GAAkB,4BAAA;AAMlB,EAAAA,mBAAA,WAAA,CAAA,GAAY,sBAAA;AAMZ,EAAAA,mBAAA,gBAAA,CAAA,GAAiB,2BAAA;AAMjB,EAAAA,mBAAA,YAAA,CAAA,GAAa,uBAAA;AAMb,EAAAA,mBAAA,QAAA,CAAA,GAAS,mBAAA;AAMT,EAAAA,mBAAA,SAAA,CAAA,GAAU,oBAAA;AAzCF,EAAA,OAAAA,kBAAAA;AAAA,CAAA,EAAA,iBAAA,IAAA,EAAA;AA6CL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AAKH,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AAMT,EAAAA,gBAAA,iBAAA,CAAA,GAAkB,iBAAA;AAMlB,EAAAA,gBAAA,WAAA,CAAA,GAAY,WAAA;AAMZ,EAAAA,gBAAA,gBAAA,CAAA,GAAiB,gBAAA;AAMjB,EAAAA,gBAAA,YAAA,CAAA,GAAa,YAAA;AAMb,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AAMT,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AAzCF,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA","file":"A-Command.constants.js","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"]}

package/dist/node/lib/A-Command/A-Command.constants.mjs

@@ -0,0 +1,42 @@
+import '../../chunk-EQQGB2QZ.mjs';
+
+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 || {});
+
+export { A_CommandEvent, A_CommandFeatures, A_CommandTransitions, A_Command_Status };
+//# sourceMappingURL=A-Command.constants.mjs.map
+//# sourceMappingURL=A-Command.constants.mjs.map

package/dist/node/lib/A-Command/A-Command.constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Command/A-Command.constants.ts"],"names":["A_Command_Status","A_CommandTransitions","A_CommandFeatures","A_CommandEvent"],"mappings":";;AAOO,IAAK,gBAAA,qBAAAA,iBAAAA,KAAL;AAIH,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAKV,EAAAA,kBAAA,aAAA,CAAA,GAAc,aAAA;AAKd,EAAAA,kBAAA,UAAA,CAAA,GAAW,UAAA;AAKX,EAAAA,kBAAA,WAAA,CAAA,GAAY,WAAA;AAKZ,EAAAA,kBAAA,WAAA,CAAA,GAAY,WAAA;AAKZ,EAAAA,kBAAA,QAAA,CAAA,GAAS,QAAA;AA7BD,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;AAuCL,IAAK,oBAAA,qBAAAC,qBAAAA,KAAL;AAEH,EAAAA,sBAAA,wBAAA,CAAA,GAAyB,qBAAA;AAGzB,EAAAA,sBAAA,0BAAA,CAAA,GAA2B,uBAAA;AAG3B,EAAAA,sBAAA,wBAAA,CAAA,GAAyB,qBAAA;AAGzB,EAAAA,sBAAA,qBAAA,CAAA,GAAsB,kBAAA;AAXd,EAAA,OAAAA,qBAAAA;AAAA,CAAA,EAAA,oBAAA,IAAA,EAAA;AAuBL,IAAK,iBAAA,qBAAAC,kBAAAA,KAAL;AAKH,EAAAA,mBAAA,QAAA,CAAA,GAAS,mBAAA;AAMT,EAAAA,mBAAA,iBAAA,CAAA,GAAkB,4BAAA;AAMlB,EAAAA,mBAAA,WAAA,CAAA,GAAY,sBAAA;AAMZ,EAAAA,mBAAA,gBAAA,CAAA,GAAiB,2BAAA;AAMjB,EAAAA,mBAAA,YAAA,CAAA,GAAa,uBAAA;AAMb,EAAAA,mBAAA,QAAA,CAAA,GAAS,mBAAA;AAMT,EAAAA,mBAAA,SAAA,CAAA,GAAU,oBAAA;AAzCF,EAAA,OAAAA,kBAAAA;AAAA,CAAA,EAAA,iBAAA,IAAA,EAAA;AA6CL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AAKH,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AAMT,EAAAA,gBAAA,iBAAA,CAAA,GAAkB,iBAAA;AAMlB,EAAAA,gBAAA,WAAA,CAAA,GAAY,WAAA;AAMZ,EAAAA,gBAAA,gBAAA,CAAA,GAAiB,gBAAA;AAMjB,EAAAA,gBAAA,YAAA,CAAA,GAAa,YAAA;AAMb,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AAMT,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AAzCF,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA","file":"A-Command.constants.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"]}

package/dist/node/lib/A-Command/A-Command.entity.d.mts

@@ -0,0 +1,16 @@
+export { A as A_Command } from '../../A-Command.entity-24rvXQLC.mjs';
+import './A-Command.constants.mjs';
+import '@adaas/a-concept';
+import '../A-StateMachine/A-StateMachine.component.mjs';
+import '../A-StateMachine/A-StateMachineTransition.context.mjs';
+import '../A-Execution/A-Execution.context.mjs';
+import '../A-StateMachine/A-StateMachine.constants.mjs';
+import '../A-Logger/A-Logger.component.mjs';
+import '../A-Operation/A-Operation.context.mjs';
+import '../A-Operation/A-Operation.types.mjs';
+import '../A-StateMachine/A-StateMachine.types.mjs';
+import '../A-Logger/A-Logger.types.mjs';
+import '../A-Logger/A-Logger.env.mjs';
+import '../A-Config/A-Config.context.mjs';
+import '../A-Config/A-Config.types.mjs';
+import '../A-Config/A-Config.constants.mjs';

package/dist/node/lib/A-Command/A-Command.entity.d.ts

@@ -0,0 +1,16 @@
+export { A as A_Command } from '../../A-Command.entity-ISgSk8wB.js';
+import './A-Command.constants.js';
+import '@adaas/a-concept';
+import '../A-StateMachine/A-StateMachine.component.js';
+import '../A-StateMachine/A-StateMachineTransition.context.js';
+import '../A-Execution/A-Execution.context.js';
+import '../A-StateMachine/A-StateMachine.constants.js';
+import '../A-Logger/A-Logger.component.js';
+import '../A-Operation/A-Operation.context.js';
+import '../A-Operation/A-Operation.types.js';
+import '../A-StateMachine/A-StateMachine.types.js';
+import '../A-Logger/A-Logger.types.js';
+import '../A-Logger/A-Logger.env.js';
+import '../A-Config/A-Config.context.js';
+import '../A-Config/A-Config.types.js';
+import '../A-Config/A-Config.constants.js';

package/dist/node/lib/A-Command/A-Command.entity.js

@@ -0,0 +1,530 @@
+'use strict';
+
+var ACommand_constants = require('./A-Command.constants');
+var aConcept = require('@adaas/a-concept');
+var ACommand_error = require('./A-Command.error');
+var aStateMachine = require('@adaas/a-utils/a-state-machine');
+var aLogger = require('@adaas/a-utils/a-logger');
+var aExecution = require('@adaas/a-utils/a-execution');
+var aFrame = require('@adaas/a-frame');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+exports.A_Command = class A_Command extends aConcept.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(aExecution.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 === ACommand_constants.A_Command_Status.COMPLETED || this._status === ACommand_constants.A_Command_Status.FAILED;
+  }
+  async [_k = aStateMachine.A_StateMachineFeatures.onBeforeTransition](transition, logger, ...args) {
+    this.checkScopeInheritance();
+    logger?.debug("yellow", `Command ${this.aseid.toString()} transitioning from ${transition.from} to ${transition.to}`);
+  }
+  async [_j = ACommand_constants.A_CommandTransitions.CREATED_TO_INITIALIZED](transition, ...args) {
+    if (this._status !== ACommand_constants.A_Command_Status.CREATED) {
+      return;
+    }
+    this._createdAt = /* @__PURE__ */ new Date();
+    this._status = ACommand_constants.A_Command_Status.INITIALIZED;
+    this.emit(ACommand_constants.A_CommandEvent.onInit);
+  }
+  async [_i = ACommand_constants.A_CommandTransitions.INITIALIZED_TO_EXECUTING](transition, ...args) {
+    if (this._status !== ACommand_constants.A_Command_Status.INITIALIZED && this._status !== ACommand_constants.A_Command_Status.CREATED) {
+      return;
+    }
+    this._startTime = /* @__PURE__ */ new Date();
+    this._status = ACommand_constants.A_Command_Status.EXECUTING;
+    this.emit(ACommand_constants.A_CommandEvent.onExecute);
+  }
+  /**
+   * Handles command completion after successful execution
+   * 
+   * EXECUTION -> COMPLETED transition
+   */
+  async [_h = ACommand_constants.A_CommandTransitions.EXECUTING_TO_COMPLETED](transition, ...args) {
+    this._endTime = /* @__PURE__ */ new Date();
+    this._status = ACommand_constants.A_Command_Status.COMPLETED;
+    this.emit(ACommand_constants.A_CommandEvent.onComplete);
+  }
+  /**
+   * Handles command failure during execution
+   * 
+   * EXECUTION -> FAILED transition
+   */
+  async [_g = ACommand_constants.A_CommandTransitions.EXECUTING_TO_FAILED](transition, error, ...args) {
+    this._endTime = /* @__PURE__ */ new Date();
+    this._status = ACommand_constants.A_Command_Status.FAILED;
+    this.emit(ACommand_constants.A_CommandEvent.onFail);
+  }
+  /**
+   * Default behavior for Command Initialization uses StateMachine to transition states
+   */
+  async [_f = ACommand_constants.A_CommandFeatures.onInit](stateMachine, ...args) {
+    await stateMachine.transition(ACommand_constants.A_Command_Status.CREATED, ACommand_constants.A_Command_Status.INITIALIZED);
+  }
+  async [_e = ACommand_constants.A_CommandFeatures.onBeforeExecute](stateMachine, ...args) {
+    await stateMachine.transition(ACommand_constants.A_Command_Status.INITIALIZED, ACommand_constants.A_Command_Status.EXECUTING);
+  }
+  async [_d = ACommand_constants.A_CommandFeatures.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 = ACommand_constants.A_CommandFeatures.onAfterExecute](...args) {
+  }
+  async [_b = ACommand_constants.A_CommandFeatures.onComplete](stateMachine, ...args) {
+    await stateMachine.transition(ACommand_constants.A_Command_Status.EXECUTING, ACommand_constants.A_Command_Status.COMPLETED);
+  }
+  async [_a = ACommand_constants.A_CommandFeatures.onFail](stateMachine, operation, ...args) {
+    await stateMachine.transition(ACommand_constants.A_Command_Status.EXECUTING, ACommand_constants.A_Command_Status.FAILED);
+  }
+  // --------------------------------------------------------------------------
+  // A-Command Lifecycle Methods
+  // --------------------------------------------------------------------------
+  /**
+   * Initializes the command before execution.
+   */
+  async init() {
+    await this.call(ACommand_constants.A_CommandFeatures.onInit, this.scope);
+  }
+  /**
+   * Executes the command logic.
+   */
+  async execute() {
+    if (this.isProcessed) return;
+    try {
+      this.checkScopeInheritance();
+      const context = new aExecution.A_ExecutionContext("execute-command");
+      this.scope.register(context);
+      await new Promise(async (resolve, reject) => {
+        try {
+          const onBeforeExecuteFeature = new aConcept.A_Feature({
+            name: ACommand_constants.A_CommandFeatures.onBeforeExecute,
+            component: this,
+            scope: this.scope
+          });
+          const onExecuteFeature = new aConcept.A_Feature({
+            name: ACommand_constants.A_CommandFeatures.onExecute,
+            component: this,
+            scope: this.scope
+          });
+          const onAfterExecuteFeature = new aConcept.A_Feature({
+            name: ACommand_constants.A_CommandFeatures.onAfterExecute,
+            component: this,
+            scope: this.scope
+          });
+          this.on(ACommand_constants.A_CommandEvent.onComplete, () => {
+            onBeforeExecuteFeature.interrupt();
+            onExecuteFeature.interrupt();
+            onAfterExecuteFeature.interrupt();
+            resolve();
+          });
+          this.on(ACommand_constants.A_CommandEvent.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 aConcept.A_Error ? error : new ACommand_error.A_CommandError({
+        title: ACommand_error.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 = ACommand_constants.A_Command_Status.COMPLETED;
+    this._result = result;
+    await this.call(ACommand_constants.A_CommandFeatures.onComplete, this.scope);
+    this.scope.destroy();
+  }
+  /**
+   * Marks the command as failed
+   */
+  async fail(error) {
+    if (this.isProcessed) return;
+    this._status = ACommand_constants.A_Command_Status.FAILED;
+    if (error) {
+      this._error = error;
+      this.scope.register(error);
+    }
+    await this.call(ACommand_constants.A_CommandFeatures.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 aConcept.A_Scope({
+      name: `A-Command-Execution-Scope-${this.aseid.toString()}`,
+      components: [aStateMachine.A_StateMachine]
+    });
+    this._createdAt = /* @__PURE__ */ new Date();
+    this._params = newEntity;
+    this._status = ACommand_constants.A_Command_Status.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 aConcept.A_Scope({
+      name: `A-Command-Execution-Scope-${this.aseid.toString()}`,
+      components: [aStateMachine.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 ACommand_error.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 = aConcept.A_Context.scope(this);
+    } catch (error) {
+      throw new ACommand_error.A_CommandError({
+        title: ACommand_error.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(aConcept.A_Context.scope(this))) {
+      this.scope.inherit(aConcept.A_Context.scope(this));
+    }
+  }
+};
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachineTransition)),
+  __decorateParam(1, aConcept.A_Inject(aLogger.A_Logger))
+], exports.A_Command.prototype, _k, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachineTransition))
+], exports.A_Command.prototype, _j, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachineTransition))
+], exports.A_Command.prototype, _i, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachineTransition))
+], exports.A_Command.prototype, _h, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachineTransition)),
+  __decorateParam(1, aConcept.A_Inject(aConcept.A_Error))
+], exports.A_Command.prototype, _g, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachine))
+], exports.A_Command.prototype, _f, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend({
+    after: /.*/
+  }),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachine))
+], exports.A_Command.prototype, _e, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend()
+], exports.A_Command.prototype, _d, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend()
+], exports.A_Command.prototype, _c, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend({
+    after: /.*/
+  }),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachine))
+], exports.A_Command.prototype, _b, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend({
+    after: /.*/
+  }),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aStateMachine.A_StateMachine)),
+  __decorateParam(1, aConcept.A_Inject(aExecution.A_ExecutionContext))
+], exports.A_Command.prototype, _a, 1);
+exports.A_Command = __decorateClass([
+  aFrame.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."
+  })
+], exports.A_Command);
+//# sourceMappingURL=A-Command.entity.js.map
+//# sourceMappingURL=A-Command.entity.js.map