@adaas/a-utils 0.1.11 → 0.1.13

package/dist/index.mjs

@@ -90,7 +90,11 @@ var A_TYPES__CommandMetaKey = /* @__PURE__ */ ((A_TYPES__CommandMetaKey2) => {
   return A_TYPES__CommandMetaKey2;
 })(A_TYPES__CommandMetaKey || {});
 var A_CONSTANTS__A_Command_Status = /* @__PURE__ */ ((A_CONSTANTS__A_Command_Status2) => {
+  A_CONSTANTS__A_Command_Status2["CREATED"] = "CREATED";
+  A_CONSTANTS__A_Command_Status2["INITIALIZATION"] = "INITIALIZATION";
   A_CONSTANTS__A_Command_Status2["INITIALIZED"] = "INITIALIZED";
+  A_CONSTANTS__A_Command_Status2["COMPILATION"] = "COMPILATION";
+  A_CONSTANTS__A_Command_Status2["COMPILED"] = "COMPILED";
   A_CONSTANTS__A_Command_Status2["IN_PROGRESS"] = "IN_PROGRESS";
   A_CONSTANTS__A_Command_Status2["COMPLETED"] = "COMPLETED";
   A_CONSTANTS__A_Command_Status2["FAILED"] = "FAILED";
@@ -135,6 +139,15 @@ var A_Memory = class extends A_Fragment {
   async error(error) {
     this._errors.add(error);
   }
+  /**
+   * Retrieves a value from the context memory
+   * 
+   * @param key 
+   * @returns 
+   */
+  get(key) {
+    return this._memory.get(key);
+  }
   /**
    * Saves a value in the context memory
    * 
@@ -173,6 +186,9 @@ var A_Memory = class extends A_Fragment {
     return obj;
   }
 };
+var A_CommandError = class extends A_Error {
+};
+A_CommandError.CommandScopeBindingError = "A-Command Scope Binding Error";
 
 // src/lib/A-Command/A-Command.entity.ts
 var A_Command = class extends A_Entity {
@@ -273,28 +289,49 @@ var A_Command = class extends A_Entity {
   // --------------------------------------------------------------------------
   // should create a new Task in DB  with basic records
   async init() {
-    this._status = "IN_PROGRESS" /* IN_PROGRESS */;
-    this._startTime = /* @__PURE__ */ new Date();
-    if (!this.scope.isInheritedFrom(A_Context.scope(this))) {
-      this.scope.inherit(A_Context.scope(this));
+    if (this._status !== "CREATED" /* CREATED */) {
+      return;
     }
+    this._status = "INITIALIZATION" /* INITIALIZATION */;
+    this._startTime = /* @__PURE__ */ new Date();
+    this.checkScopeInheritance();
     this.emit("init");
-    return await this.call("init", this.scope);
+    await this.call("init", this.scope);
+    this._status = "INITIALIZED" /* INITIALIZED */;
   }
   // Should compile everything before execution
   async compile() {
+    if (this._status !== "INITIALIZED" /* INITIALIZED */) {
+      return;
+    }
+    this.checkScopeInheritance();
+    this._status = "COMPILATION" /* COMPILATION */;
     this.emit("compile");
-    return await this.call("compile", this.scope);
+    await this.call("compile", this.scope);
+    this._status = "COMPILED" /* COMPILED */;
+  }
+  /**
+   * Processes the command execution
+   * 
+   * @returns 
+   */
+  async process() {
+    if (this._status !== "COMPILED" /* COMPILED */)
+      return;
+    this._status = "IN_PROGRESS" /* IN_PROGRESS */;
+    this.checkScopeInheritance();
+    this.emit("execute");
+    await this.call("execute", this.scope);
   }
   /**
    * Executes the command logic.
    */
   async execute() {
+    this.checkScopeInheritance();
     try {
       await this.init();
       await this.compile();
-      this.emit("execute");
-      await this.call("execute", this.scope);
+      await this.process();
       await this.complete();
     } catch (error) {
       await this.fail();
@@ -304,6 +341,7 @@ var A_Command = class extends A_Entity {
    * Marks the command as completed
    */
   async complete() {
+    this.checkScopeInheritance();
     this._status = "COMPLETED" /* COMPLETED */;
     this._endTime = /* @__PURE__ */ new Date();
     this._result = this.scope.resolve(A_Memory).toJSON();
@@ -314,6 +352,7 @@ var A_Command = class extends A_Entity {
    * Marks the command as failed
    */
   async fail() {
+    this.checkScopeInheritance();
     this._status = "FAILED" /* FAILED */;
     this._endTime = /* @__PURE__ */ new Date();
     this._errors = this.scope.resolve(A_Memory).Errors;
@@ -369,7 +408,7 @@ var A_Command = class extends A_Entity {
     this._executionScope = new A_Scope();
     this._executionScope.register(new A_Memory());
     this._params = newEntity;
-    this._status = "INITIALIZED" /* INITIALIZED */;
+    this._status = "CREATED" /* CREATED */;
   }
   /**
    * Allows to convert serialized data to Command instance
@@ -395,7 +434,8 @@ var A_Command = class extends A_Entity {
         memory.error(new A_Error(err));
       });
     }
-    this._status = serialized.status || "INITIALIZED" /* INITIALIZED */;
+    this._params = serialized.params;
+    this._status = serialized.status || "CREATED" /* CREATED */;
   }
   /**
    * Converts the Command instance to a plain object
@@ -407,6 +447,7 @@ var A_Command = class extends A_Entity {
       ...super.toJSON(),
       code: this.code,
       status: this._status,
+      params: this._params,
       startedAt: this._startTime ? this._startTime.toISOString() : void 0,
       endedAt: this._endTime ? this._endTime.toISOString() : void 0,
       duration: this.duration,
@@ -414,8 +455,21 @@ var A_Command = class extends A_Entity {
       errors: this.errors ? Array.from(this.errors).map((err) => err.toJSON()) : void 0
     };
   }
-};
-var A_CommandError = class extends A_Error {
+  checkScopeInheritance() {
+    let attachedScope;
+    try {
+      attachedScope = A_Context.scope(this);
+    } catch (error) {
+      throw new A_CommandError({
+        title: A_CommandError.CommandScopeBindingError,
+        description: `Command ${this.code} 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));
+    }
+  }
 };
 
 // src/lib/A-Config/A-Config.constants.ts