@adaas/a-concept 0.1.18 → 0.1.19

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.19",
   "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
 }
 
 
-
-
-
-
-
-
-