@adaas/a-concept 0.1.30 → 0.1.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-concept",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "A-Concept is a framework to build new Applications within or outside the ADAAS ecosystem. This framework is designed to be modular structure regardless environment and program goal.",
   "license": "Apache-2.0",
   "main": "./dist/index.cjs",

package/src/global/A-Feature/A-Feature.class.ts

@@ -330,16 +330,30 @@ export class A_Feature<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__
          */
         scope?: A_Scope,
     ) {
-        if (this.isDone)
-            return;
+        try {
+            if (scope && !scope.isInheritedFrom(A_Context.scope(this)))
+                scope.inherit(A_Context.scope(this));
 
-        this._state = A_TYPES__FeatureState.PROCESSING;
 
-        for (const stage of this) {
-            await stage.process(scope);
+            if (this.isDone)
+                return;
+
+            this._state = A_TYPES__FeatureState.PROCESSING;
+
+            for (const stage of this) {
+                await stage.process(scope);
+            }
+
+            return await this.completed();
+        } catch (error) {
+            return await this.failed(new A_FeatureError({
+                title: A_FeatureError.FeatureProcessingError,
+                description: `An error occurred while processing the A-Feature: ${this.name}. Failed at stage: ${this.stage?.name || 'N/A'}.`,
+                stage: this.stage,
+                originalError: error
+            }));
         }
 
-        return await this.completed();
     }
     /**
      * This method moves the feature to the next stage
@@ -368,6 +382,22 @@ export class A_Feature<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__
 
         this.scope.destroy();
     }
+    /**
+     * This method marks the feature as failed and throws an error
+     * Uses to mark the feature as failed
+     * 
+     * @param error 
+     */
+    async failed(error: A_FeatureError) {
+
+        this._state = A_TYPES__FeatureState.FAILED;
+
+        this._error = error;
+
+        this.scope.destroy();
+
+        throw this._error;
+    }
     /**
      * This method marks the feature as failed and throws an error
      * Uses to interrupt or end the feature processing
@@ -390,6 +420,7 @@ export class A_Feature<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__
                     code: A_FeatureError.Interruption,
                     title: reason.title,
                     description: reason.description,
+                    stage: this.stage,
                     originalError: reason
                 });
                 break;

package/src/global/A-Feature/A-Feature.error.ts

@@ -1,8 +1,10 @@
 import { A_Error } from "../A-Error/A_Error.class";
+import { A_Stage } from "../A-Stage/A-Stage.class";
+import { A_TYPES__FeatureError_Init } from "./A-Feature.types";
 
 
 
-export class A_FeatureError extends A_Error {
+export class A_FeatureError extends A_Error<A_TYPES__FeatureError_Init> {
 
     /**
      * Indicates that the Feature has been interrupted
@@ -14,6 +16,12 @@ export class A_FeatureError extends A_Error {
      * Failed during the A-Feature initialization process
      */
     static readonly FeatureInitializationError = 'Unable to initialize A-Feature';
+    /**
+     * Indicates that there was an error processing the Feature
+     * 
+     * Failed during the A-Feature processing
+     */
+    static readonly FeatureProcessingError = 'Error occurred during A-Feature processing';
 
     // =======================================================================
     // ---------------------- Decorator Errors -----------------------------
@@ -30,4 +38,17 @@ export class A_FeatureError extends A_Error {
      * Failed during the @A_Feature.Extend() decorator execution
      */
     static readonly FeatureExtensionError = 'Unable to extend A-Feature';
+
+    
+    /**
+     * Stage where the error occurred
+     */
+    stage?: A_Stage
+
+
+    protected fromConstructor(params: A_TYPES__FeatureError_Init): void {
+        super.fromConstructor(params);
+
+        this.stage = params.stage;
+    }
 }

package/src/global/A-Feature/A-Feature.types.ts

@@ -9,6 +9,8 @@ import { A_TYPES__Entity_Constructor } from "../A-Entity/A-Entity.types"
 import { A_Feature } from "./A-Feature.class"
 import { A_TYPES__Required } from "@adaas/a-concept/types/A_Common.types"
 import { A_Scope } from "../A-Scope/A-Scope.class"
+import { A_Stage } from "../A-Stage/A-Stage.class"
+import { A_TYPES__Error_Init } from "../A-Error/A_Error.types"
 
 
 // ============================================================================
@@ -99,8 +101,26 @@ export enum A_TYPES__FeatureState {
      * The feature has been interrupted
      */
     INTERRUPTED = "INTERRUPTED",
+    /**
+     * The feature has failed
+     */
+    FAILED = "FAILED"
 }
 
+// ===========================================================================
+// --------------------------- Error Types ------------------------------------
+// ===========================================================================
+
+export type A_TYPES__FeatureError_Init = {
+    /**
+     * Stage where the error occurred
+     */
+    stage?: A_Stage
+
+} & A_TYPES__Error_Init
+
+
+
 // ===========================================================================-
 // --------------------------- Available Types -------------------------------
 // ===========================================================================