@adaas/a-concept 0.0.29 → 0.0.30

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

@@ -1,6 +1,9 @@
-import { A_TYPES__ConceptStage } from "../A-Concept/A_Concept.types";
+import { A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator.types";
+import { A_TYPES__ConceptAbstraction, A_TYPES__ConceptAbstractionMeta, A_TYPES__ConceptStage } from "../A-Concept/A_Concept.types";
 import { A_Fragment } from "../A-Fragment/A-Fragment.class";
+import { A_Meta } from "../A-Meta/A-Meta.class";
 import { A_TYPES__ScopeConstructor } from "../A-Scope/A-Scope.types";
+import { A_TYPES__A_ExtendDecorator_BehaviorConfig } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
 
 
 
@@ -18,19 +21,37 @@ export type A_TYPES__ContainerCallParams<T extends string> = {
 
 export type A_TYPES__ContainerMeta = {
     [A_TYPES__ContainerMetaKey.FEATURES]: Map<string, A_TYPES__ContainerMeta_FeatureItem>
-    [A_TYPES__ContainerMetaKey.STAGES]: Map<string, A_TYPES__ContainerMeta_StageExtension>
+    [A_TYPES__ContainerMetaKey.ABSTRACTIONS]: A_Meta<{
+
+        /**
+         * Where Key the regexp for what to apply the extension
+         * A set of container names or a wildcard, or a regexp
+         * 
+         *
+         * Where value is the extension instructions
+         */
+        [Key: string]: A_TYPES__ConceptAbstraction[]
+    }>,
+    [A_TYPES__ContainerMetaKey.INJECTIONS]: A_Meta<{
+        /**
+         * Where Key is the name of the injection
+         * 
+         * Where value is the list of injections
+         */
+        [Key: string]: A_TYPES__A_InjectDecorator_Meta
+    }>
+
 }
 
 
 export enum A_TYPES__ContainerMetaKey {
     FEATURES = 'a-container-features',
-    STAGES = 'a-container-stages',
+    INJECTIONS = 'a-container-injections',
+    ABSTRACTIONS = 'a-container-abstractions',
 }
 
-export type A_TYPES__ContainerMeta_StageExtension = {
-    name: A_TYPES__ConceptStage,
-    handler: string,
-}
+
+
 
 
 export type A_TYPES__ContainerMeta_FeatureItem = {

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

@@ -12,7 +12,8 @@ import { A_Concept } from "../A-Concept/A_Concept.class";
 import { A_TYPES__EntityBaseMethod } from "../A-Entity/A-Entity.types";
 import { A_Entity } from "../A-Entity/A-Entity.class";
 import { A_EntityMeta } from "../A-Entity/A-Entity.meta";
-import { A_TYPES__FeatureConstructor, A_TYPES__FeatureStep } from "../A-Feature/A-Feature.types";
+import { A_TYPES__FeatureConstructor } from "../A-Feature/A-Feature.types";
+import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types";
 
 
 /**
@@ -61,8 +62,6 @@ export class A_Context {
     /**
      * A set of allocated scopes per every element in the program.
      */
-    // protected scopes: WeakMap<A_Container<any> | A_Feature | A_Component | any, A_Scope> = new WeakMap();
-
     protected conceptsMeta: Map<typeof A_Concept.constructor, A_Meta<any>> = new Map();
     protected containersMeta: Map<typeof A_Container.constructor, A_ContainerMeta> = new Map();
     protected componentsMeta: Map<typeof A_Component, A_ComponentMeta> = new Map();
@@ -369,8 +368,6 @@ export class A_Context {
         param2: string | T[number],
         param3?: Partial<A_TYPES__ScopeConstructor>
     ): A_TYPES__Required<Partial<A_TYPES__FeatureConstructor>, ['steps', 'fragments', 'name', 'components']> {
-
-
         const instance = this.getInstance();
 
         const component = param1;
@@ -407,7 +404,7 @@ export class A_Context {
          * While Scope we use just to store the scope where the component registered.
          *  
          */
-        const steps: A_TYPES__FeatureStep[] = [];
+        const steps: A_TYPES__A_StageStep[] = [];
         // const feature: string = new ASEID({
         //     id: `${param2}-${Math.random()}`,
         //     entity: 'a-feature',
@@ -427,12 +424,10 @@ export class A_Context {
                     // Get all extensions for the feature
                     meta
                         .extensions(feature)
-                        .forEach(({ handler, args, name }) => {
+                        .forEach((declaration) => {
                             steps.push({
                                 component: constructor,
-                                name,
-                                handler,
-                                args
+                                ...declaration
                             });
                         });
             });
@@ -513,7 +508,6 @@ export class A_Context {
         scope: A_Scope,
         param1: A_Fragment | A_Container<any> | A_Entity | A_Component
     ) {
-
         const instance = this.getInstance();
 
         if (!instance._root)
@@ -532,49 +526,15 @@ export class A_Context {
                 instance.registry.set(param1, scope);
                 break;
 
-            case param1 instanceof A_Fragment:
+            case param1 instanceof A_Fragment && !instance.registry.has(param1):
                 instance.registry.set(param1, scope);
                 break;
 
             default:
-                instance.registry.set(param1, scope);
+                if (!instance.registry.has(param1))
+                    instance.registry.set(param1, scope);
 
+                break;
         }
-
-
-        // if (param1 instanceof A_Fragment) {
-
-        //     const instance = this.getInstance();
-
-        //     let fragment: A_Fragment;
-        //     let name: string;
-
-        //     if (typeof param2 === 'string') {
-        //         name = param2;
-        //         fragment = param1;
-        //     } else {
-        //         fragment = param1 as A_Fragment;
-        //         name = fragment.name;
-        //     }
-
-        //     /**
-        //      * If the namespace is not provided, then use the root namespace.
-        //      * If the root namespace is not provided, then use the default namespace.
-        //      */
-        //     if (!name)
-        //         name = this.root
-        //             || process.env.ADAAS_NAMESPACE
-        //             || process.env.A_NAMESPACE
-        //             || process.env.ADAAS_APP_NAMESPACE
-        //             || 'a-concept'
-
-
-        //     if (!this.root)
-        //         instance._root = name;
-
-        //     // instance.namedFragments.set(namespace, Namespace);
-
-        //     return name;
-
     }
 }

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

@@ -28,7 +28,6 @@ export class A_Entity<
     _SerializedType extends A_TYPES__Entity_JSON = A_TYPES__Entity_JSON,
     _FeatureNames extends Array<string | A_TYPES__EntityBaseMethod> = A_TYPES__EntityBaseMethods
 >
-    extends A_Fragment
     implements A_TYPES__IEntity {
 
     aseid!: ASEID;
@@ -57,8 +56,8 @@ export class A_Entity<
         newEntity: _ConstructorType
     )
     constructor(props: string | ASEID | _SerializedType | _ConstructorType) {
-        super();
 
+        
         switch (true) {
             case (typeof props === 'string' && ASEID.isASEID(props)):
                 this.aseid = new ASEID(props);
@@ -175,6 +174,9 @@ export class A_Entity<
             ? param2 || {}
             : param1;
 
+
+        console.log('WTF???? ', A_Context.scope(this))
+
         const newFeature = A_Context.feature(A_Context.scope(this), this, feature, params);
 
         return await newFeature.process();
@@ -188,7 +190,7 @@ export class A_Entity<
 
     async load() {
         await this.call(A_TYPES__EntityBaseMethod.DESTROY, {
-            fragments: [
+            entities: [
                 this
             ]
         });
@@ -198,9 +200,9 @@ export class A_Entity<
 
     async destroy() {
         await this.call(A_TYPES__EntityBaseMethod.DESTROY, {
-            fragments: [
+            entities: [
                 this
-            ]
+            ],
         });
     }
 
@@ -208,7 +210,7 @@ export class A_Entity<
 
     async save() {
         await this.call(A_TYPES__EntityBaseMethod.SAVE, {
-            fragments: [
+            entities: [
                 this
             ]
         });

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

@@ -1,11 +1,14 @@
 import { ASEID } from "@adaas/a-utils";
 import { A_Meta } from "../A-Meta/A-Meta.class";
 import { A_Fragment } from "../A-Fragment/A-Fragment.class";
+import { A_TYPES__A_ExtendDecorator_Meta } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
+import { A_Entity } from "./A-Entity.class";
 
 
 export type A_TYPES__EntityCallParams<T extends string> = {
     name: T,
     fragments: Array<A_Fragment>,
+    entities: Array<A_Entity<any, any, any>>,
     components: Array<{ new(...args: any[]): any }>
 }
 
@@ -51,7 +54,7 @@ export type A_TYPES__EntityMeta = {
          *
          * Where value is the extension instructions
          */
-        [Key: string]: A_TYPES__EntityMeta_ExtensionItem[]
+        [Key: string]: A_TYPES__A_ExtendDecorator_Meta[]
 
     }>, case
 
@@ -65,9 +68,5 @@ export enum A_TYPES__EntityMetaKey {
 }
 
 
-export type A_TYPES__EntityMeta_ExtensionItem = {
-    name: string,
-    handler: string,
-}
 
 

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

@@ -1,9 +1,12 @@
 import { A_Feature_Define } from "@adaas/a-concept/decorators/A-Feature/A-Feature-Define.decorator";
 import { A_Feature_Extend } from "@adaas/a-concept/decorators/A-Feature/A-Feature-Extend.decorator";
-import { A_TYPES__FeatureConstructor, A_TYPES__FeatureIteratorReturn, A_TYPES__FeatureState, A_TYPES__FeatureStep } from "./A-Feature.types";
-import { A_CommonHelper, A_Error, A_TYPES__Required } from "@adaas/a-utils";
+import { A_TYPES__FeatureConstructor, A_TYPES__FeatureState, } from "./A-Feature.types";
+import { A_Error, A_TYPES__Required } from "@adaas/a-utils";
 import { A_Context } from "../A-Context/A-Context.class";
 import { A_TYPES__A_Feature_Extend } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
+import { A_Stage } from "../A-Stage/A-Stage.class";
+import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types";
+import { StepsManager } from "@adaas/a-concept/helpers/StepsManager.class";
 
 
 
@@ -34,23 +37,27 @@ export class A_Feature {
     }
 
 
-
-
     // protected scope: A_Scope
-    protected steps: A_TYPES__FeatureStep[] = [];
-    protected _current?: A_TYPES__FeatureStep;
+    protected stages: Array<A_Stage> = [];
+    protected _current?: A_Stage;
     protected _index: number = 0;
+    protected SM: StepsManager;
 
     state: A_TYPES__FeatureState = A_TYPES__FeatureState.INITIALIZED;
 
     result?: any
     error?: A_Error
 
+
     constructor(
         params: A_TYPES__Required<Partial<A_TYPES__FeatureConstructor>, ['steps']>
     ) {
-        // this.scope = params.scope;
-        this.steps = params.steps;
+
+        this.SM = new StepsManager(params.steps);
+
+        this.stages = this.SM.toStages(this);
+
+        this._current = this.stages[0];
 
         A_Context.allocate(this, params);
     }
@@ -61,58 +68,69 @@ export class A_Feature {
      * 
      * @returns 
      */
-    [Symbol.iterator](): Iterator<A_TYPES__FeatureIteratorReturn, any> {
+    [Symbol.iterator](): Iterator<A_Stage, any> {
         return {
             // Custom next method
-            next: (): IteratorResult<A_TYPES__FeatureIteratorReturn, any> => {
-                if (this._index < this.steps.length) {
-                    if (
-                        (this.state as any) === A_TYPES__FeatureState.FAILED
-                        ||
-                        (this.state as any) === A_TYPES__FeatureState.COMPLETED
-                    ) {
-                        throw new Error('FEATURE_PROCESSING_INTERRUPTED');
-                    }
-
-                    this._current = this.steps[this._index];
-
-                    const { component, handler, args } = this._current;
+            next: (): IteratorResult<A_Stage, any> => {
+                if (!this.isDone()) {
 
-                    const instance = A_Context.scope(this).resolve(component);
+                    this._current = this.stages[this._index];
 
                     return {
-                        value: async () => {
-                            if (instance[handler]) {
-                                const callArgs = args.map(arg =>
-                                    // In case if the target is a feature step then pass the current feature
-                                    A_CommonHelper.isInheritedFrom(arg.target, A_Feature)
-                                        ? this
-                                        : A_Context.scope(this).resolve(arg.target)
-                                );
-
-                                await instance[handler](...callArgs);
-                            }
-
-                            this._index++;
-                        },
+                        value: this._current,
                         done: false
                     };
                 } else {
+
                     this._current = undefined; // Reset current on end
-                    return { value: undefined, done: true };
+
+                    return {
+                        value: undefined,
+                        done: true
+                    };
                 }
             }
         };
     }
 
-    // Access the current element
-    get current(): A_TYPES__FeatureStep | undefined {
+
+    /**
+     * Returns the current A-Feature Stage
+     * 
+     */
+    get stage(): A_Stage | undefined {
         return this._current;
     }
 
-    // Custom end strategy or stop condition (could be expanded if needed)
+
+
+    /**
+     * This method checks if the A-Feature is done
+     * 
+     * @returns 
+     */
     isDone(): boolean {
-        return this.current === null;
+        return !this.stage
+            || this._index >= this.stages.length
+            || this.state === A_TYPES__FeatureState.COMPLETED
+            || this.state === A_TYPES__FeatureState.FAILED;
+    }
+
+
+
+    /**
+     * This method moves the feature to the next stage
+     * 
+     * @param stage 
+     */
+    next(stage) {
+        const stageIndex = this.stages.indexOf(stage);
+
+        this._index = stageIndex + 1;
+
+        if (this._index >= this.stages.length) {
+            this.completed();
+        }
     }
 
 
@@ -120,14 +138,15 @@ export class A_Feature {
      * This method marks the feature as completed and returns the result
      * Uses to interrupt or end the feature processing
      * 
+     * The result of the feature is a Scope Fragments
+     * 
      * @param result 
      * @returns 
      */
-    async completed<T extends any>(
-        ...result: T[]
-    ): Promise<T> {
+    async completed<T extends any>(): Promise<T> {
+
+        this.result = A_Context.scope(this).toJSON();
 
-        this.result = result;
         this.state = A_TYPES__FeatureState.COMPLETED;
 
         return this.result;
@@ -146,25 +165,20 @@ export class A_Feature {
         this.error = error as A_Error;
         this.state = A_TYPES__FeatureState.FAILED;
 
+
         await this.errorHandler(error);
     }
 
 
-
+    /**
+     * This method processes the feature by executing all the stages
+     * 
+     */
     async process() {
-        try {
-            this.state = A_TYPES__FeatureState.PROCESSING;
+        this.state = A_TYPES__FeatureState.PROCESSING;
 
-            for (const step of this) {
-                await step();
-            }
-
-            await this.completed();
-
-        } catch (error) {
-            console.log('[!] Feature processing error:', error);
-
-            await this.failed(error);
+        for (const stage of this) {
+            await stage.process();
         }
     }
 
@@ -198,6 +212,4 @@ export class A_Feature {
                 throw error;
         }
     }
-
-
 }

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

@@ -1,13 +1,14 @@
+import { A_TYPES__A_InjectDecorator_Injectable, A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator.types"
 import { A_Component } from "../A-Component/A-Component.class"
-import { A_TYPES__ComponentMeta_InjectionParam, A_TYPES__ComponentMeta_InjectionParams } from "../A-Component/A-Component.types"
 import { A_TYPES__ScopeConfig, A_TYPES__ScopeConstructor } from "../A-Scope/A-Scope.types"
+import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types"
 
 
 export type A_TYPES__FeatureIteratorReturn<T extends any = any> = () => Promise<T>
 
 
 export type A_TYPES__FeatureConstructor = {
-    steps: A_TYPES__FeatureStep[]
+    steps: A_TYPES__A_StageStep[]
 } & A_TYPES__ScopeConstructor & A_TYPES__ScopeConfig
 
 export enum A_TYPES__FeatureState {
@@ -19,24 +20,24 @@ export enum A_TYPES__FeatureState {
 }
 
 
-export type A_TYPES__FeatureStep = {
-    /**
-     * The component to be called
-     */
-    component: typeof A_Component,
-    /**
-     * The method to be called on the component
-     */
-    handler: string,
-    /**
-     * Original Feature Extension name
-     * 
-     * [!] could be string or regex
-     * 
-     */
-    name: string,
-    /**
-     * Arguments to be passed to the method
-     */
-    args: A_TYPES__ComponentMeta_InjectionParams
-}
+// export type A_TYPES__FeatureStep = {
+//     /**
+//      * The component to be called
+//      */
+//     component: typeof A_Component,
+//     /**
+//      * The method to be called on the component
+//      */
+//     handler: string,
+//     /**
+//      * Original Feature Extension name
+//      * 
+//      * [!] could be string or regex
+//      * 
+//      */
+//     name: string,
+//     /**
+//      * Arguments to be passed to the method
+//      */
+//     args: A_TYPES__A_InjectDecorator_Meta
+// }

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

@@ -115,4 +115,19 @@ export class A_Fragment {
         return;
     }
 
+
+
+
+
+    /**
+     * Returns the JSON representation of the Fragment
+     * 
+     * @returns 
+     */
+    toJSON() {
+        return {
+            name: this.name,
+        };
+    }
+
 }