@adaas/a-concept 0.1.18 → 0.1.20

package/dist/src/{helpers/A_StepsManager.class.js → global/A-StepManager/A-StepManager.class.js}

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_TmpStage = exports.A_StepsManager = void 0;
-const A_Error_class_1 = require("../global/A-Error/A_Error.class");
-const A_Stage_class_1 = require("../global/A-Stage/A-Stage.class");
+exports.A_StepsManager = void 0;
+const A_Stage_class_1 = require("../A-Stage/A-Stage.class");
+const A_StepManager_error_1 = require("./A-StepManager.error");
 class A_StepsManager {
     constructor(entities) {
+        this._isBuilt = false;
         this.entities = this.prepareSteps(entities);
         this.graph = new Map();
         this.visited = new Set();
@@ -13,13 +14,16 @@ class A_StepsManager {
     }
     prepareSteps(entities) {
         return entities.map(step => {
-            return Object.assign(Object.assign({}, step), { behavior: step.behavior || 'sync', before: step.before || [], after: step.after || [] });
+            return Object.assign(Object.assign({}, step), { behavior: step.behavior || 'sync', before: step.before || [], after: step.after || [], throwOnError: false });
         });
     }
     ID(step) {
         return `${typeof step.component === 'string' ? step.component : step.component.name}.${step.handler}`;
     }
     buildGraph() {
+        if (this._isBuilt)
+            return;
+        this._isBuilt = true;
         // Initialize graph nodes
         this.entities.forEach(entity => this.graph.set(this.ID(entity), new Set()));
         // Add directed edges based on 'before' and 'after'
@@ -30,7 +34,7 @@ class A_StepsManager {
             // If entity should execute before targets, then targets depend on entity
             // So we add edges: target -> entity (target depends on entity)
             before.forEach(dep => {
-                const targets = this.matchEntities(dep);
+                const targets = this.matchEntities(entityId, dep);
                 targets.forEach(target => {
                     if (!this.graph.has(target))
                         this.graph.set(target, new Set());
@@ -41,7 +45,7 @@ class A_StepsManager {
             // If entity should execute after sources, then entity depends on sources
             // So we add edges: entity -> source (entity depends on source)
             after.forEach(dep => {
-                const sources = this.matchEntities(dep);
+                const sources = this.matchEntities(entityId, dep);
                 sources.forEach(source => {
                     if (!this.graph.has(entityId))
                         this.graph.set(entityId, new Set());
@@ -51,87 +55,57 @@ class A_StepsManager {
         });
     }
     // Match entities by name or regex
-    matchEntities(pattern) {
-        const regex = new RegExp(`^${pattern}$`);
+    matchEntities(entityId, pattern) {
+        const regex = new RegExp(pattern);
         return this.entities
-            .filter(entity => regex.test(this.ID(entity)))
+            .filter(entity => regex.test(this.ID(entity)) && this.ID(entity) !== entityId)
             .map(entity => this.ID(entity));
     }
     // Topological sort with cycle detection
     visit(node) {
-        if (this.tempMark.has(node))
-            throw new A_Error_class_1.A_Error("Circular dependency detected");
+        if (this.tempMark.has(node)) {
+            return;
+            // TODO: maybe we have to keep this error but only for partial cases
+            throw new A_StepManager_error_1.A_StepManagerError(A_StepManager_error_1.A_StepManagerError.CircularDependencyError, `Circular dependency detected involving step: ${node}. Make sure that your 'before' and 'after' dependencies do not create cycles.`);
+        }
         if (!this.visited.has(node)) {
             this.tempMark.add(node);
             (this.graph.get(node) || []).forEach(neighbor => this.visit(neighbor));
             this.tempMark.delete(node);
             this.visited.add(node);
             this.sortedEntities.push(node);
+            // // Visit neighbors in stable order (preserving original order)
+            // const neighbors = Array.from(this.graph.get(node) || []);
+            // // neighbors.sort((a, b) => {
+            // //     const orderA = this.originalOrder.get(a) || 0;
+            // //     const orderB = this.originalOrder.get(b) || 0;
+            // //     return orderA - orderB;
+            // // });
+            // neighbors.forEach(neighbor => this.visit(neighbor));
+            // this.tempMark.delete(node);
+            // this.visited.add(node);
+            // this.sortedEntities.push(node);
         }
     }
-    // Sort the entities based on dependencies
-    toStages(feature) {
+    toSortedArray() {
         this.buildGraph();
         // Start topological sort
         this.entities.forEach(entity => {
             if (!this.visited.has(this.ID(entity)))
                 this.visit(this.ID(entity));
         });
-        const stages = [];
+        return this.sortedEntities;
+    }
+    // Sort the entities based on dependencies
+    toStages(feature) {
+        const sortedNames = this.toSortedArray();
         // Map sorted names back to entity objects
-        this.sortedEntities
+        return sortedNames
             .map(id => {
             const step = this.entities.find(entity => this.ID(entity) === id);
-            let stage = stages.find(stage => {
-                return stage.after.every(after => step.after.includes(after))
-                    && step.before.every(before => stage.after.includes(before));
-            });
-            if (!stage) {
-                stage = new A_TmpStage();
-                stages.push(stage);
-            }
-            stage.add(step);
+            return new A_Stage_class_1.A_Stage(feature, step);
         });
-        return stages.map(stage => new A_Stage_class_1.A_Stage(feature, stage.steps));
     }
 }
 exports.A_StepsManager = A_StepsManager;
-class A_TmpStage {
-    constructor(_steps = []) {
-        this.name = 'A_TmpStage';
-        this._steps = _steps;
-    }
-    get before() {
-        return this._steps.reduce((acc, step) => ([
-            ...acc,
-            ...step.before
-        ]), []);
-    }
-    get after() {
-        return this._steps.reduce((acc, step) => ([
-            ...acc,
-            ...step.after
-        ]), []);
-    }
-    get steps() {
-        return this._steps;
-    }
-    get asyncSteps() {
-        return this._steps.filter(step => step.behavior === 'async');
-    }
-    get syncSteps() {
-        return this._steps.filter(step => step.behavior === 'sync');
-    }
-    /**
-     * Adds a step to the stage
-     *
-     * @param step
-     * @returns
-     */
-    add(step) {
-        this._steps.push(step);
-        return this;
-    }
-}
-exports.A_TmpStage = A_TmpStage;
-//# sourceMappingURL=A_StepsManager.class.js.map
+//# sourceMappingURL=A-StepManager.class.js.map

package/dist/src/global/A-StepManager/A-StepManager.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A-StepManager.class.js","sourceRoot":"","sources":["../../../../src/global/A-StepManager/A-StepManager.class.ts"],"names":[],"mappings":";;;AAEA,4DAAmD;AAEnD,+DAA2D;AAE3D,MAAa,cAAc;IAWvB,YAAY,QAA4D;QAFhE,aAAQ,GAAY,KAAK,CAAC;QAG9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAE7B,CAAC;IAEO,YAAY,CAChB,QAA4D;QAE5D,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACvB,uCACO,IAAI,KAEP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM,EACjC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EACvB,YAAY,EAAE,KAAK,IACrB;QACN,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,EAAE,CAAC,IAA0B;QACjC,OAAO,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1G,CAAC;IAEO,UAAU;QACd,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,yBAAyB;QACzB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QAE5E,mDAAmD;QACnD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;YAE3C,sCAAsC;YACtC,yEAAyE;YACzE,+DAA+D;YAC/D,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBACjB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAClD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;oBACrB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;wBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,2BAA2B;gBACtE,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;YAEH,uCAAuC;YACvC,yEAAyE;YACzE,+DAA+D;YAC/D,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAChB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAElD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;oBACrB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;wBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBACnE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B;gBACtE,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED,kCAAkC;IAC1B,aAAa,CAAC,QAAgB,EAAE,OAAe;QACnD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QAElC,OAAO,IAAI,CAAC,QAAQ;aACf,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;aAC7E,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,wCAAwC;IAChC,KAAK,CAAC,IAAY;QACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO;YACP,oEAAoE;YACpE,MAAM,IAAI,wCAAkB,CACxB,wCAAkB,CAAC,uBAAuB,EAC1C,gDAAgD,IAAI,+EAA+E,CACtI,CAAC;QACN,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAGxB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE/B,iEAAiE;YACjE,4DAA4D;YAC5D,gCAAgC;YAChC,wDAAwD;YACxD,wDAAwD;YACxD,iCAAiC;YACjC,SAAS;YAET,uDAAuD;YACvD,8BAA8B;YAC9B,0BAA0B;YAC1B,kCAAkC;QACtC,CAAC;IACL,CAAC;IAGD,aAAa;QACT,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,yBAAyB;QACzB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,0CAA0C;IAC1C,QAAQ,CAAC,OAAkB;QAGvB,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAGzC,0CAA0C;QAC1C,OAAO,WAAW;aACb,GAAG,CAAC,EAAE,CAAC,EAAE;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAE,CAAC;YAGnE,OAAO,IAAI,uBAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACX,CAAC;CACJ;AApJD,wCAoJC"}

package/dist/src/global/A-StepManager/A-StepManager.error.d.ts

@@ -0,0 +1,4 @@
+import { A_Error } from "../A-Error/A_Error.class";
+export declare class A_StepManagerError extends A_Error {
+    static readonly CircularDependencyError = "A-StepManager Circular Dependency Error";
+}

package/dist/src/global/A-StepManager/A-StepManager.error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_StepManagerError = void 0;
+const A_Error_class_1 = require("../A-Error/A_Error.class");
+class A_StepManagerError extends A_Error_class_1.A_Error {
+}
+exports.A_StepManagerError = A_StepManagerError;
+A_StepManagerError.CircularDependencyError = 'A-StepManager Circular Dependency Error';
+//# sourceMappingURL=A-StepManager.error.js.map

package/dist/src/global/A-StepManager/A-StepManager.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A-StepManager.error.js","sourceRoot":"","sources":["../../../../src/global/A-StepManager/A-StepManager.error.ts"],"names":[],"mappings":";;;AAAA,4DAAmD;AAInD,MAAa,kBAAmB,SAAQ,uBAAO;;AAA/C,gDAKC;AAFmB,0CAAuB,GAAG,yCAAyC,CAAC"}

package/index.ts

@@ -75,6 +75,7 @@ export { A_Abstraction_Extend } from './src/global/A-Abstraction/A-Abstraction-E
 export { A_CommonHelper } from './src/helpers/A_Common.helper';
 export { A_FormatterHelper } from './src/helpers/A_Formatter.helper';
 export { A_IdentityHelper, A_ID_TYPES__TimeId_Parts } from './src/helpers/A_Identity.helper';
-// export { A_StepsManager } from './src/helpers/A_StepsManager.class';
+export { A_StepsManager } from './src/global/A-StepManager/A-StepManager.class';
+export { A_StepManagerError } from './src/global/A-StepManager/A-StepManager.error';
 export { A_TypeGuards } from './src/helpers/A_TypeGuards.helper';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-concept",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "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.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -20,8 +20,8 @@
     "ext": "ts, js"
   },
   "scripts": {
-    "test": "jest",
-    "start": "nodemon ./tests/log.ts",
+    "test": "jest ",
+    "start": "nodemon ./tests/example-usage.ts",
     "example:simple": "nodemon ./examples/simple/concept.ts",
     "example:simple:trace": "node -r tsconfig-paths/register -r ts-node/register -r ./trace-require.js ./examples/simple/concept.ts",
     "example:http": "nodemon ./examples/simple-http-server/concept.ts",

package/src/global/A-Abstraction/A-Abstraction-Extend.decorator.ts

@@ -81,18 +81,30 @@ export function A_Abstraction_Extend(
 
         const existedIndex = existedMetaValue.findIndex(item => item.handler === propertyKey);
 
-        const abstraction =  {
+        const abstraction = {
             name: setName,
             handler: propertyKey,
-            before: config.before || [],
-            after: config.after || [],
-            behavior: config.behavior || 'sync'
+            behavior: config.behavior || 'sync',
+            throwOnError: config.throwOnError !== undefined ? config.throwOnError : true,
+
+            before: (config.before
+                ?.map(b =>
+                    b instanceof RegExp
+                        ? b.source
+                        : new RegExp(`^.*${b.replace(/\./g, '\\.')}$`).source)
+                || []),
+            after: (config.after
+                ?.map(a =>
+                    a instanceof RegExp
+                        ? a.source
+                        : new RegExp(`^.*${a.replace(/\./g, '\\.')}$`).source)
+                || []),
         }
 
-        if(existedIndex !== -1) {
+        if (existedIndex !== -1) {
             // Update the existing method in the metadata
             existedMetaValue[existedIndex] = abstraction;
-        }else{
+        } else {
             // Add the new method to the metadata
             existedMetaValue.push(abstraction);
         }

package/src/global/A-Component/A-Component.meta.ts

@@ -48,7 +48,8 @@ export class A_ComponentMeta extends A_Meta<A_TYPES__ComponentMeta> {
                         handler: extension.handler,
                         behavior: extension.behavior,
                         before: extension.before || [],
-                        after: extension.after || []
+                        after: extension.after || [],
+                        throwOnError: extension.throwOnError || true,
                     });
 
                 });

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

@@ -3,7 +3,7 @@ import { A_Meta } from "../A-Meta/A-Meta.class"
 import { A_TYPES__ConceptAbstraction } from "../A-Concept/A-Concept.types"
 import { A_Component } from "./A-Component.class"
 import { A_TYPES__ComponentMetaKey } from "./A-Component.constants"
-import { A_TYPES__FeatureDefineDecoratorMeta, A_TYPES__FeatureExtendDecoratorBehaviorConfig, A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types"
+import { A_TYPES__FeatureDefineDecoratorMeta,  A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types"
 
 
 
@@ -91,15 +91,6 @@ export type A_TYPES__ComponentMeta = {
 
 
 
-export type A_TYPES__ComponentMetaExtension = {
-    /**
-     * The name of original Extension Definition
-     */
-    name: string,
-    /**
-     * The name of the handler that will be used to apply the extension
-     */
-    handler: string,
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig
+export type A_TYPES__ComponentMetaExtension = A_TYPES__FeatureExtendDecoratorMeta
 
 

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

@@ -1,10 +1,10 @@
-import { A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/global/A-Inject/A-Inject.types";
 import { A_Container } from "../A-Container/A-Container.class";
 import { A_Concept } from "./A-Concept.class";
-import { A_TYPES__FeatureExtendDecoratorBehaviorConfig } from "../A-Feature/A-Feature.types";
+import { A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types";
 import { A_TYPES__Component_Constructor } from "../A-Component/A-Component.types";
 import { A_TYPES__Fragment_Constructor } from "../A-Fragment/A-Fragment.types";
 import { A_TYPES__Entity_Constructor } from "../A-Entity/A-Entity.types";
+import { A_TYPES__A_InjectDecorator_Meta } from "../A-Inject/A-Inject.types";
 
 
 // ============================================================================
@@ -69,32 +69,15 @@ export type A_TYPES__Concept_Serialized = {
  * Uses as a transfer object to pass configurations to Feature constructor
  */
 export type A_TYPES__ConceptAbstractionMeta = {
-    /**
-     * The name of original Extension Definition
-     */
-    name: string,
-    /**
-     * The name of the handler that will be used to apply the extension
-     */
-    handler: string,
     /**
      * The arguments that will be passed to the handler
      */
     args: A_TYPES__A_InjectDecorator_Meta
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig
+} & A_TYPES__FeatureExtendDecoratorMeta
 
 
 
 /**
  * Uses to define the extension that will be applied to the Concept
  */
-export type A_TYPES__ConceptAbstraction = {
-    /**
-     * The name of original Extension Definition
-     */
-    name: string,
-    /**
-     * The name of the handler that will be used to apply the extension
-     */
-    handler: string,
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig
+export type A_TYPES__ConceptAbstraction = A_TYPES__FeatureExtendDecoratorMeta

package/src/global/A-Container/A-Container.meta.ts

@@ -69,7 +69,8 @@ export class A_ContainerMeta extends A_Meta<A_TYPES__ContainerMeta> {
                         args,
                         before: extension.before,
                         behavior: extension.behavior,
-                        after: extension.after
+                        after: extension.after,
+                        throwOnError: extension.throwOnError,
                     });
 
                 });
@@ -104,7 +105,8 @@ export class A_ContainerMeta extends A_Meta<A_TYPES__ContainerMeta> {
                         handler: extension.handler,
                         behavior: extension.behavior,
                         before: extension.before || [],
-                        after: extension.after || []
+                        after: extension.after || [],
+                        throwOnError: extension.throwOnError || true,
                     });
 
                 });

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

@@ -4,7 +4,7 @@ import { A_Meta } from "../A-Meta/A-Meta.class";
 import { A_TYPES__Scope_Init } from "../A-Scope/A-Scope.types";
 import { A_TYPES__ContainerMetaKey } from "./A-Container.constants";
 import { A_Container } from "./A-Container.class";
-import { A_TYPES__FeatureDefineDecoratorMeta, A_TYPES__FeatureExtendDecoratorBehaviorConfig, A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types";
+import { A_TYPES__FeatureDefineDecoratorMeta,  A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types";
 
 
 // ============================================================================
@@ -85,13 +85,4 @@ export type A_TYPES__ContainerMeta = {
 }
 
 
-export type A_TYPES__ContainerMetaExtension = {
-    /**
-     * The name of original Extension Definition
-     */
-    name: string,
-    /**
-     * The name of the handler that will be used to apply the extension
-     */
-    handler: string,
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig
+export type A_TYPES__ContainerMetaExtension = A_TYPES__FeatureExtendDecoratorMeta

package/src/global/A-Feature/A-Feature-Define.decorator.ts

@@ -90,6 +90,7 @@ export function A_Feature_Define(
                     before: item.before || [],
                     after: item.after || [],
                     behavior: item.behavior || 'sync',
+                    throwOnError: true
                 })
             ) : [],
         });

package/src/global/A-Feature/A-Feature-Extend.decorator.ts

@@ -1,4 +1,3 @@
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
 import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
 import { A_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
 import { A_TYPES__FeatureExtendDecoratorConfig, A_TYPES__FeatureExtendDecoratorDescriptor, A_TYPES__FeatureExtendDecoratorScopeItem, A_TYPES__FeatureExtendDecoratorTarget } from "./A-Feature.types";
@@ -79,6 +78,7 @@ export function A_Feature_Extend(
         let after: string[] = [];
         let include: Array<A_TYPES__FeatureExtendDecoratorScopeItem> = [];
         let exclude: Array<A_TYPES__FeatureExtendDecoratorScopeItem> = [];
+        let throwOnError: boolean = true;
 
 
 
@@ -102,12 +102,25 @@ export function A_Feature_Extend(
                 targetRegexp = buildTargetRegexp(param1, include, exclude, propertyKey);
 
                 behavior = param1.behavior || behavior;
-                before = param1.before || before;
-                after = param1.after || after;
+                throwOnError = param1.throwOnError !== undefined ? param1.throwOnError : throwOnError;
+
+                before = param1.before
+                    ?.map(e =>
+                        e instanceof RegExp
+                            ? e.source
+                            : new RegExp(`^.*${e.replace(/\./g, '\\.')}$`).source)
+                    || before;
+                after = param1.after
+                    ?.map(e =>
+                        e instanceof RegExp
+                            ? e.source
+                            : new RegExp(`^.*${e.replace(/\./g, '\\.')}$`).source)
+                    || after;
+
                 break;
 
             default:
-                targetRegexp = new RegExp(`^.*\\.${propertyKey}$`);
+                targetRegexp = new RegExp(`^.*${propertyKey.replace(/\./g, '\\.')}$`);
                 break;
         }
 
@@ -143,13 +156,14 @@ export function A_Feature_Extend(
             handler: propertyKey,
             behavior,
             before,
-            after
+            after,
+            throwOnError
         }
 
-        if (existedIndex !== -1){
+        if (existedIndex !== -1) {
             // Update the existing method in the metadata
             existedMetaValue[existedIndex] = extension;
-        }else{
+        } else {
             // Add the new method to the metadata
             existedMetaValue.push(extension);
         }

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

@@ -8,7 +8,7 @@ import {
 import { A_Feature_Define } from "@adaas/a-concept/global/A-Feature/A-Feature-Define.decorator";
 import { A_Feature_Extend } from "@adaas/a-concept/global/A-Feature/A-Feature-Extend.decorator";
 import { A_Stage } from "../A-Stage/A-Stage.class";
-import { A_StepsManager } from "@adaas/a-concept/helpers/A_StepsManager.class";
+import { A_StepsManager } from "@adaas/a-concept/global/A-StepManager/A-StepManager.class";
 import { A_StageError } from "../A-Stage/A-Stage.error";
 import { A_TypeGuards } from "@adaas/a-concept/helpers/A_TypeGuards.helper";
 import { A_FeatureError } from "./A-Feature.error";
@@ -391,4 +391,11 @@ export class A_Feature<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__
 
         this._state = A_TYPES__FeatureState.INTERRUPTED;
     }
+
+
+
+
+    toString(): string {
+        return `A-Feature(${this.caller.component?.constructor?.name || 'Unknown'}::${this.name})`;
+    }
 }

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

@@ -1,4 +1,4 @@
-import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types"
+import { A_TYPES__A_StageStep, A_TYPES_StageExecutionBehavior } from "../A-Stage/A-Stage.types"
 import { A_Fragment } from "../A-Fragment/A-Fragment.class"
 import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class"
 import { A_Container } from "../A-Container/A-Container.class"
@@ -206,23 +206,11 @@ export type A_TYPES__FeatureExtendDecoratorDescriptor =
  * [!] Can be applied only on A-Components
  */
 export type A_TYPES__FeatureExtendDecoratorTarget = A_Component
-/**
- * Meta type for A_Extend decorator
- */
-export type A_TYPES__FeatureExtendDecoratorMeta = {
-    /**
-     * Original Feature Extension name
-     * 
-     * [!] could be string or regex
-     */
-    name: string,
-    /**
-     * Actual method name in the class
-     */
-    handler: string
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig
+
 /**
  * Configuration type for A_Extend decorator
+ * 
+ * This is an INPUT parameter provided by the user
  */
 export type A_TYPES__FeatureExtendDecoratorConfig = {
     /**
@@ -253,7 +241,54 @@ export type A_TYPES__FeatureExtendDecoratorConfig = {
      * ```
      */
     scope: Array<A_TYPES__FeatureExtendDecoratorScopeItem> | Partial<A_TYPES__FeatureExtendDecoratorScopeConfig>,
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig
+    /**
+     * The behavior of the method. 
+     * In case its async it will be executed independently from the main thread.
+     * 
+     * [!] However, in case of sync, it will be executed in the main thread.in the order of the declaration.
+     * 
+     */
+    behavior: A_TYPES_StageExecutionBehavior
+    /**
+     * Allows to define the order of the execution of the method.
+     * 
+     * [!] It applies for the following structure :'Component.methodName'
+     * [!] In case the method has circular dependencies it will Throw an error.
+     * 
+     * Example:
+     * ```ts
+     *  @A_Feature.Extend({
+     *      name: 'load',
+     *      before: ['Component1.methodName', /Component2\..+/]
+     *  })
+     * ```
+     */
+    before: Array<string | RegExp>
+
+    /**
+     * Allows to define the order of the execution of the method.
+     * 
+     * [!] It applies for the following structure :'Component.methodName'
+     * [!] In case the method has circular dependencies it will Throw an error.
+     * 
+     * Example:
+     * ```ts
+     *  @A_Feature.Extend({
+     *      name: 'load',
+     *      before: ['Component1.methodName', /Component2\..+/]
+     *  })
+     * ```
+     * 
+     */
+    after: Array<string | RegExp>
+
+    /**
+     * Indicates whether to throw an error if the step fails.
+     * 
+     * [!] By default is true
+     */
+    throwOnError: boolean
+}
 /**
  * Scope item that can be used in A_Extend decorator configuration
  */
@@ -270,13 +305,29 @@ export type A_TYPES__FeatureExtendDecoratorScopeConfig = {
 /**
  * A single item that can be used in scope configuration
  */
-export type A_TYPES__FeatureExtendDecoratorScopeItem = { new(...args: any[]): A_Container }
-    | { new(...args: any[]): A_Entity }
-    | { new(...args: any[]): A_Component }
+export type A_TYPES__FeatureExtendDecoratorScopeItem = A_TYPES__Container_Constructor
+    | A_TYPES__Entity_Constructor
+    | A_TYPES__Component_Constructor
+
+
+
+// =======================================================================
+// --------------------------META TYPES-----------------------------------
+// =======================================================================
 /**
- * Behavior configuration for A_Extend decorator
+ * Meta type for A_Extend decorator
  */
-export type A_TYPES__FeatureExtendDecoratorBehaviorConfig = {
+export type A_TYPES__FeatureExtendDecoratorMeta = {
+    /**
+     * Original Feature Extension name
+     * 
+     * [!] could be string or regex
+     */
+    name: string,
+    /**
+     * Actual method name in the class
+     */
+    handler: string
     /**
      * The behavior of the method. 
      * In case its async it will be executed independently from the main thread.
@@ -284,9 +335,7 @@ export type A_TYPES__FeatureExtendDecoratorBehaviorConfig = {
      * [!] However, in case of sync, it will be executed in the main thread.in the order of the declaration.
      * 
      */
-    behavior: 'async' | 'sync'
-
-
+    behavior: A_TYPES_StageExecutionBehavior
     /**
      * Allows to define the order of the execution of the method.
      * 
@@ -294,7 +343,6 @@ export type A_TYPES__FeatureExtendDecoratorBehaviorConfig = {
      * 
      */
     before: string[]
-
     /**
      * Allows to define the order of the execution of the method.
      * 
@@ -302,13 +350,12 @@ export type A_TYPES__FeatureExtendDecoratorBehaviorConfig = {
      * 
      */
     after: string[]
+    /**
+     * Indicates whether to throw an error if the step fails.
+     * 
+     * [!] By default is true
+     */
+    throwOnError: boolean
 }
 
 
-
-
-
-
-
-
-