@adaas/a-concept 0.1.17 → 0.1.19

package/dist/src/global/A-Feature/A-Feature.types.d.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_Entity } from "../A-Entity/A-Entity.class";
 import { A_Container } from "../A-Container/A-Container.class";
 import { A_Component } from "../A-Component/A-Component.class";
@@ -168,23 +168,10 @@ export type A_TYPES__FeatureExtendDecoratorDescriptor = TypedPropertyDescriptor<
  * [!] 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 = {
     /**
@@ -215,7 +202,52 @@ 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
  */
@@ -232,17 +264,21 @@ 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;
 /**
- * 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.
@@ -250,7 +286,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.
      *
@@ -265,4 +301,10 @@ export type A_TYPES__FeatureExtendDecoratorBehaviorConfig = {
      *
      */
     after: string[];
+    /**
+     * Indicates whether to throw an error if the step fails.
+     *
+     * [!] By default is true
+     */
+    throwOnError: boolean;
 };

package/dist/src/global/A-Stage/A-Stage.class.d.ts

@@ -1,53 +1,67 @@
-import { A_TYPES__A_Stage_JSON, A_TYPES__A_Stage_Status, A_TYPES__A_StageStep, A_TYPES__A_StageStepProcessingExtraParams } from "./A-Stage.types";
+import { A_TYPES__A_Stage_Status, A_TYPES__A_StageStep, A_TYPES__Stage_Serialized } from "./A-Stage.types";
 import { A_Feature } from "../A-Feature/A-Feature.class";
 import { A_Scope } from "../A-Scope/A-Scope.class";
 import { A_Error } from "../A-Error/A_Error.class";
 import { A_TYPES__ScopeResolvableComponents } from "../A-Scope/A-Scope.types";
 import { A_TYPES__Component_Constructor } from "../A-Component/A-Component.types";
 export declare class A_Stage {
+    /**
+     * The feature that owns this stage
+     */
     private readonly _feature;
-    private readonly _steps;
+    /**
+     * Initial Instructions to process the stage
+     */
+    private readonly _definition;
+    /**
+     * Possible errors during stage processing
+     */
     private _error?;
     /**
-     * A_Stage is a set of A_Functions within A_Feature that should be run in a specific order.
-     * Each stage may contain one or more functions.
-     * [!] That always run in parallel (in NodeJS asynchronously), independently of each other.
+     * Indicates the current status of the stage
+     */
+    private _status;
+    /**
+     * Promise that will be resolved when the stage is Processed
+     */
+    private _processed;
+    /**
+     * A_Stage is a callable A_Function within A_Feature that should be run with specific parameters.
+     * [!] Depending on the Stage Definition type sync/async function can be executed correspondingly.
      *
      * A-Stage is a common object that uses to simplify logic and re-use of A-Feature internals for better composition.
      */
-    constructor(feature: A_Feature, steps?: A_TYPES__A_StageStep[]);
-    status: A_TYPES__A_Stage_Status;
+    constructor(
     /**
-     * Promise that will be resolved when the stage is Processed
+     * The feature that owns this stage
+     */
+    feature: A_Feature, 
+    /**
+     * The step definitions of the stage
+     */
+    step: A_TYPES__A_StageStep);
+    /**
+     * Returns the name of the stage
      */
-    processed: Promise<void> | undefined;
     get name(): string;
-    get before(): string[];
-    get after(): string[];
-    get steps(): A_TYPES__A_StageStep[];
-    get asyncSteps(): A_TYPES__A_StageStep[];
-    get syncSteps(): A_TYPES__A_StageStep[];
     /**
-     * Resolves the arguments of the step
-     *
-     * @param step
-     * @returns
+     * Returns the current status of the stage
      */
-    protected getStepArgs(scope: A_Scope, step: A_TYPES__A_StageStep): Promise<(import("../A-Component/A-Component.class").A_Component | import("../A-Container/A-Container.class").A_Container | import("../A-Entity/A-Entity.class").A_Entity<any, import("../A-Entity/A-Entity.types").A_TYPES__Entity_Serialized> | A_Scope<A_TYPES__Component_Constructor[], import("../A-Error/A_Error.types").A_TYPES__Error_Constructor[], import("../A-Entity/A-Entity.types").A_TYPES__Entity_Constructor[], import("../A-Fragment/A-Fragment.class").A_Fragment<any>[]> | import("../A-Fragment/A-Fragment.class").A_Fragment<any> | A_Feature<import("../A-Feature/A-Feature.types").A_TYPES__FeatureAvailableComponents> | A_TYPES__ScopeResolvableComponents[])[]>;
+    get status(): A_TYPES__A_Stage_Status;
     /**
-     * Adds a step to the stage
+     * Resolves the arguments of the step
      *
      * @param step
      * @returns
      */
-    add(step: A_TYPES__A_StageStep): this;
+    protected getStepArgs(scope: A_Scope, step: A_TYPES__A_StageStep): Promise<(import("../A-Component/A-Component.class").A_Component | import("../A-Container/A-Container.class").A_Container | import("../A-Entity/A-Entity.class").A_Entity<any, import("../A-Entity/A-Entity.types").A_TYPES__Entity_Serialized> | A_Scope<A_TYPES__Component_Constructor[], import("../A-Error/A_Error.types").A_TYPES__Error_Constructor[], import("../A-Entity/A-Entity.types").A_TYPES__Entity_Constructor[], import("../A-Fragment/A-Fragment.class").A_Fragment<any>[]> | import("../A-Fragment/A-Fragment.class").A_Fragment<any> | A_Feature<import("../A-Feature/A-Feature.types").A_TYPES__FeatureAvailableComponents> | A_TYPES__ScopeResolvableComponents[])[]>;
     /**
      * Resolves the component of the step
      *
      * @param step
      * @returns
      */
-    protected getStepInstance(scope: A_Scope, step: A_TYPES__A_StageStep): A_TYPES__ScopeResolvableComponents;
+    protected getStepComponent(scope: A_Scope, step: A_TYPES__A_StageStep): A_TYPES__ScopeResolvableComponents;
     /**
      * Calls the handler of the step
      *
@@ -66,18 +80,13 @@ export declare class A_Stage {
      * Scope to be used to resolve the steps dependencies
      */
     scope?: A_Scope): Promise<void>;
-    process(
-    /**
-     * Extra parameters to control the steps processing
-     */
-    params?: Partial<A_TYPES__A_StageStepProcessingExtraParams>): Promise<void>;
     protected completed(): void;
     protected failed(error: Error | A_Error | any): void;
     /**
      * Serializes the stage to JSON
      *
      */
-    toJSON(): A_TYPES__A_Stage_JSON;
+    toJSON(): A_TYPES__Stage_Serialized;
     /**
      * Returns a string representation of the stage
      *

package/dist/src/global/A-Stage/A-Stage.class.js

@@ -13,43 +13,42 @@ exports.A_Stage = void 0;
 const A_Stage_types_1 = require("./A-Stage.types");
 const A_Context_class_1 = require("../A-Context/A-Context.class");
 const A_Stage_error_1 = require("./A-Stage.error");
+const A_Error_class_1 = require("../A-Error/A_Error.class");
 const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
 class A_Stage {
     /**
-     * A_Stage is a set of A_Functions within A_Feature that should be run in a specific order.
-     * Each stage may contain one or more functions.
-     * [!] That always run in parallel (in NodeJS asynchronously), independently of each other.
+     * A_Stage is a callable A_Function within A_Feature that should be run with specific parameters.
+     * [!] Depending on the Stage Definition type sync/async function can be executed correspondingly.
      *
      * A-Stage is a common object that uses to simplify logic and re-use of A-Feature internals for better composition.
      */
-    constructor(feature, steps = []) {
-        this.status = A_Stage_types_1.A_TYPES__A_Stage_Status.INITIALIZED;
+    constructor(
+    /**
+     * The feature that owns this stage
+     */
+    feature, 
+    /**
+     * The step definitions of the stage
+     */
+    step) {
+        /**
+         * Indicates the current status of the stage
+         */
+        this._status = A_Stage_types_1.A_TYPES__A_Stage_Status.INITIALIZED;
         this._feature = feature;
-        this._steps = steps;
+        this._definition = step;
     }
+    /**
+     * Returns the name of the stage
+     */
     get name() {
         return this.toString();
     }
-    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');
+    /**
+     * Returns the current status of the stage
+     */
+    get status() {
+        return this._status;
     }
     /**
      * Resolves the arguments of the step
@@ -91,23 +90,13 @@ class A_Stage {
             })));
         });
     }
-    /**
-     * Adds a step to the stage
-     *
-     * @param step
-     * @returns
-     */
-    add(step) {
-        this._steps.push(step);
-        return this;
-    }
     /**
      * Resolves the component of the step
      *
      * @param step
      * @returns
      */
-    getStepInstance(scope, step) {
+    getStepComponent(scope, step) {
         const { component, handler } = step;
         let instance;
         switch (true) {
@@ -135,79 +124,69 @@ class A_Stage {
      */
     callStepHandler(step, scope) {
         return __awaiter(this, void 0, void 0, function* () {
-            const instance = yield this.getStepInstance(scope, step);
+            // 1) Resolve component
+            const component = yield this.getStepComponent(scope, step);
+            // 2) Resolve arguments
             const callArgs = yield this.getStepArgs(scope, step);
-            return yield instance[step.handler](...callArgs);
+            // 3) Call handler
+            return yield component[step.handler](...callArgs);
         });
     }
     skip() {
-        this.status = A_Stage_types_1.A_TYPES__A_Stage_Status.SKIPPED;
+        this._status = A_Stage_types_1.A_TYPES__A_Stage_Status.SKIPPED;
     }
-    process(
     /**
-     * Scope to be used to resolve the steps dependencies
+     * This method processes the stage by executing all the steps
+     *
+     * @param scope - Scope to be used to resolve the steps dependencies
      */
-    param1, 
+    process(
     /**
-     * Extra parameters to control the steps processing
+     * Scope to be used to resolve the steps dependencies
      */
-    param2) {
+    scope) {
         return __awaiter(this, void 0, void 0, function* () {
-            const scope = A_TypeGuards_helper_1.A_TypeGuards.isScopeInstance(param1)
-                ? param1
+            const targetScope = A_TypeGuards_helper_1.A_TypeGuards.isScopeInstance(scope)
+                ? scope
                 : A_Context_class_1.A_Context.scope(this._feature);
-            const params = A_TypeGuards_helper_1.A_TypeGuards.isScopeInstance(param1)
-                ? param2
-                : param1;
-            if (!this.processed)
-                this.processed = new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+            if (!this._processed)
+                this._processed = new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
                     try {
-                        this.status = A_Stage_types_1.A_TYPES__A_Stage_Status.PROCESSING;
-                        if ((params === null || params === void 0 ? void 0 : params.steps) && params.steps.length) {
-                            params.steps.forEach(step => this.add(step));
+                        this._status = A_Stage_types_1.A_TYPES__A_Stage_Status.PROCESSING;
+                        if (this._definition.behavior === 'sync') {
+                            // in case we have to wait for the result
+                            yield this.callStepHandler(this._definition, targetScope);
+                        }
+                        else {
+                            // in case we don't have to wait for the result
+                            this.callStepHandler(this._definition, targetScope);
                         }
-                        const syncSteps = this.syncSteps.filter((params === null || params === void 0 ? void 0 : params.filter) || (() => true));
-                        const asyncSteps = this.asyncSteps.filter((params === null || params === void 0 ? void 0 : params.filter) || (() => true));
-                        // Run sync _steps
-                        yield Promise
-                            .all([
-                            // Run async _steps that are independent of each other
-                            ...asyncSteps.map(step => this.callStepHandler(step, scope)),
-                            // Run sync _steps that are dependent on each other
-                            new Promise((r, j) => __awaiter(this, void 0, void 0, function* () {
-                                try {
-                                    for (const step of syncSteps) {
-                                        // console.log(' - -> Processing stage step:', step.handler, ' with Regexp: ', step.name);
-                                        yield this.callStepHandler(step, scope);
-                                        // console.log(' - -> Finished processing stage step:', step.handler);
-                                    }
-                                    return r();
-                                }
-                                catch (error) {
-                                    return j(error);
-                                }
-                            }))
-                        ]);
                         this.completed();
                         return resolve();
                     }
                     catch (error) {
-                        this.failed(error);
-                        return reject(error);
+                        const wrappedError = new A_Error_class_1.A_Error(error);
+                        this.failed(wrappedError);
+                        if (this._definition.throwOnError) {
+                            return resolve();
+                        }
+                        else {
+                            return reject(wrappedError);
+                        }
                     }
                 }));
-            return this.processed;
+            return this._processed;
         });
     }
     // ==========================================
     // ============ Status methods =============
     // ==========================================
     completed() {
-        this.status = A_Stage_types_1.A_TYPES__A_Stage_Status.COMPLETED;
+        this._status = A_Stage_types_1.A_TYPES__A_Stage_Status.COMPLETED;
     }
     failed(error) {
         this._error = error;
-        this.status = A_Stage_types_1.A_TYPES__A_Stage_Status.FAILED;
+        this._status = A_Stage_types_1.A_TYPES__A_Stage_Status.FAILED;
     }
     // ==========================================
     // ============ Serialization ===============
@@ -228,22 +207,7 @@ class A_Stage {
      * @returns
      */
     toString() {
-        return [
-            this._feature.name,
-            '::a-stage:',
-            '[sync:',
-            this
-                .syncSteps
-                .map(s => typeof s.component === 'string' ? s.component : s.component.name + '.' + s.handler)
-                .join(' -> '),
-            ']',
-            '[async:',
-            this
-                .asyncSteps
-                .map(s => typeof s.component === 'string' ? s.component : s.component.name + '.' + s.handler)
-                .join(' -> '),
-            ']'
-        ].join('');
+        return `A-Stage(${this._feature.name}::${this._definition.behavior}@${this._definition.handler})`;
     }
 }
 exports.A_Stage = A_Stage;

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

@@ -1 +1 @@
-{"version":3,"file":"A-Stage.class.js","sourceRoot":"","sources":["../../../../src/global/A-Stage/A-Stage.class.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"A-Stage.class.js","sourceRoot":"","sources":["../../../../src/global/A-Stage/A-Stage.class.ts"],"names":[],"mappings":"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"}

package/dist/src/global/A-Stage/A-Stage.types.d.ts

@@ -1,6 +1,5 @@
 import { A_Container } from "../A-Container/A-Container.class";
 import { A_TYPES__Component_Constructor } from "../A-Component/A-Component.types";
-import { A_TYPES__FeatureExtendDecoratorBehaviorConfig } from "../A-Feature/A-Feature.types";
 export declare enum A_TYPES__A_Stage_Status {
     /**
      * The stage is currently being processed
@@ -36,6 +35,7 @@ export declare enum A_TYPES__A_Stage_Status {
      */
     ABORTED = "ABORTED"
 }
+export type A_TYPES_StageExecutionBehavior = 'async' | 'sync';
 export type A_TYPES__A_StageStep = {
     /**
      * The component to be called
@@ -52,8 +52,35 @@ export type A_TYPES__A_StageStep = {
      *
      */
     name: string;
-} & A_TYPES__FeatureExtendDecoratorBehaviorConfig;
-export type A_TYPES__A_Stage_JSON = {
+    /**
+     * 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.
+     *
+     * [!] In case the method has circular dependencies it will Throw an error.
+     *
+     */
+    before: string[];
+    /**
+     * Allows to define the order of the execution of the method.
+     *
+     * [!] In case the method has circular dependencies it will Throw an error.
+     *
+     */
+    after: string[];
+    /**
+     * Indicates whether to throw an error if the step fails.
+     *
+     * [!] By default is true
+     */
+    throwOnError: boolean;
+};
+export type A_TYPES__Stage_Serialized = {
     /**
      * The name of the stage
      */

package/dist/src/global/A-Stage/A-Stage.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"A-Stage.types.js","sourceRoot":"","sources":["../../../../src/global/A-Stage/A-Stage.types.ts"],"names":[],"mappings":";;;AAMA,IAAY,uBAqCX;AArCD,WAAY,uBAAuB;IAC/B;;OAEG;IACH,oDAAyB,CAAA;IACzB;;OAEG;IACH,kDAAuB,CAAA;IACvB;;OAEG;IACH,4CAAiB,CAAA;IACjB;;OAEG;IACH,8CAAmB,CAAA;IACnB;;OAEG;IACH,qBAAqB;IACrB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,sDAA2B,CAAA;IAC3B;;OAEG;IACH,8CAAmB,CAAA;AACvB,CAAC,EArCW,uBAAuB,uCAAvB,uBAAuB,QAqClC"}
+{"version":3,"file":"A-Stage.types.js","sourceRoot":"","sources":["../../../../src/global/A-Stage/A-Stage.types.ts"],"names":[],"mappings":";;;AAKA,IAAY,uBAqCX;AArCD,WAAY,uBAAuB;IAC/B;;OAEG;IACH,oDAAyB,CAAA;IACzB;;OAEG;IACH,kDAAuB,CAAA;IACvB;;OAEG;IACH,4CAAiB,CAAA;IACjB;;OAEG;IACH,8CAAmB,CAAA;IACnB;;OAEG;IACH,qBAAqB;IACrB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,sDAA2B,CAAA;IAC3B;;OAEG;IACH,8CAAmB,CAAA;AACvB,CAAC,EArCW,uBAAuB,uCAAvB,uBAAuB,QAqClC"}

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

@@ -0,0 +1,20 @@
+import { A_Feature } from "../A-Feature/A-Feature.class";
+import { A_TYPES__FeatureDefineDecoratorTemplateItem } from "../A-Feature/A-Feature.types";
+import { A_Stage } from "../A-Stage/A-Stage.class";
+import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types";
+export declare class A_StepsManager {
+    entities: A_TYPES__A_StageStep[];
+    graph: Map<string, Set<string>>;
+    visited: Set<string>;
+    tempMark: Set<string>;
+    sortedEntities: string[];
+    private _isBuilt;
+    constructor(entities: Array<A_TYPES__FeatureDefineDecoratorTemplateItem>);
+    private prepareSteps;
+    private ID;
+    private buildGraph;
+    private matchEntities;
+    private visit;
+    toSortedArray(): Array<string>;
+    toStages(feature: A_Feature): Array<A_Stage>;
+}