@adaas/a-concept 0.0.29 → 0.0.31

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

@@ -1,10 +1,13 @@
-import { A_Entity } from "../A-Entity/A-Entity.class"
-import { A_Feature } from "../A-Feature/A-Feature.class"
+import { A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator.types"
 import { A_Fragment } from "../A-Fragment/A-Fragment.class"
 import { A_Meta } from "../A-Meta/A-Meta.class"
-import { A_Scope } from "../A-Scope/A-Scope.class"
-import { A_Component } from "./A-Component.class"
+import { A_TYPES__A_DefineDecorator_Meta, A_TYPES__A_ExtendDecorator_BehaviorConfig, A_TYPES__A_ExtendDecorator_Meta } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types"
+import { A_TYPES__ConceptAbstraction, A_TYPES__ConceptAbstractionMeta } from "../A-Concept/A_Concept.types"
+import { A_TYPES__ContainerMeta_FeatureItem } from "../A-Container/A-Container.types"
 
+export type A_TYPES__ComponentConstructor<_Exports extends Array<String> = any> = {
+    exports: _Exports,
+}
 
 export type A_TYPES__ComponentCallParams<T extends string> = {
     name: T,
@@ -23,11 +26,18 @@ export type A_TYPES__ComponentMeta = {
          *
          * Where value is the extension instructions
          */
-        [Key: string]: A_TYPES__ComponentMeta_ExtensionItem[]
+        [Key: string]: A_TYPES__A_ExtendDecorator_Meta[]
     }>,
 
 
-    [A_TYPES__ComponentMetaKey.FEATURES]: any[],
+    [A_TYPES__ComponentMetaKey.FEATURES]: A_Meta<{
+        /**
+         * Where Key is the name of the feature
+         * 
+         * Where value is the list of features
+         */
+        [Key: string]: A_TYPES__A_DefineDecorator_Meta
+    }>
 
 
     [A_TYPES__ComponentMetaKey.INJECTIONS]: A_Meta<{
@@ -36,7 +46,16 @@ export type A_TYPES__ComponentMeta = {
          * 
          * Where value is the list of injections
          */
-        [Key: string]: A_TYPES__ComponentMeta_InjectionParams
+        [Key: string]: A_TYPES__A_InjectDecorator_Meta
+    }>
+
+    [A_TYPES__ComponentMetaKey.ABSTRACTIONS]: A_Meta<{
+        /**
+         * Where Key is the name of the stage
+         * 
+         * Where value is the list of injections
+         */
+        [Key: string]: A_TYPES__ConceptAbstraction[]
     }>
 }
 
@@ -44,7 +63,7 @@ export enum A_TYPES__ComponentMetaKey {
     EXTENSIONS = 'a-component-extensions',
     FEATURES = 'a-component-features',
     INJECTIONS = 'a-component-injections',
-    STAGES = 'a-component-stages',
+    ABSTRACTIONS = 'a-component-abstractions',
 }
 
 export type A_TYPES__ComponentMetaExtension = {
@@ -56,42 +75,6 @@ export type A_TYPES__ComponentMetaExtension = {
      * 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__ComponentMeta_InjectionParams
-}
-
-
-export type A_TYPES__ComponentMeta_ExtensionItem = {
-    name: string,
-    handler: string,
-}
-
-export type A_TYPES__ComponentMeta_InjectionParams = Array<{
-    target: A_TYPES__ComponentMeta_InjectionParam
-} | {
-    target: { new(...args: any[]): A_Entity },
-    instructions: Partial<A_TYPES__ComponentMeta_EntityInjectionInstructions>
-}>;
-
-
-export type A_TYPES__ComponentMeta_EntityInjectionInstructions = {
-    aseid: string,
-    id: string,
-}
-
+} & A_TYPES__A_ExtendDecorator_BehaviorConfig
 
-export type A_TYPES__ComponentMeta_InjectionParam =
-    { new(...args: any[]): A_Fragment }
-    | { new(...args: any[]): A_Component }
-    // | { new(...args: any[]): any }
-    | { new(...args: any[]): A_Scope }
-    | { new(...args: any[]): A_Feature };
-// | 
-// typeof A_Fragment
-// | typeof A_Component
-// // | { new(...args: any[]): any }
-// | typeof A_Scope
-// | typeof A_Feature;
 

package/src/global/A-Concept/A_Concept.class.ts

@@ -4,7 +4,9 @@ import { A_Container } from "../A-Container/A-Container.class";
 // import { A_Logger } from "@adaas/a-concept/base/A-Logger/A-Logger.component";
 import { A_Fragment } from "../A-Fragment/A-Fragment.class";
 import { A_TYPES__ContainerMetaKey } from "../A-Container/A-Container.types";
-import { A_Stage } from "@adaas/a-concept/decorators/A-Stage/A-Stage.decorator";
+import { A_Abstraction } from "@adaas/a-concept/decorators/A-Abstraction/A-Abstraction.decorator";
+import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types";
+import { A_Channel } from "../A-Channel/A-Channel.class";
 
 
 
@@ -35,8 +37,8 @@ export class A_Concept<
     /**
      * Load the concept. This step runs before any other steps to ensure that all components are loaded.
      */
-    static get Load() {
-        return A_Stage(A_TYPES__ConceptStage.Load);
+    static Load() {
+        return A_Abstraction(A_TYPES__ConceptStage.Load);
     }
 
     /**
@@ -44,15 +46,15 @@ export class A_Concept<
      *
      * [!] To extend the logic just create a custom containers and override the default behavior.
      */
-    static get Publish() {
-        return A_Stage(A_TYPES__ConceptStage.Publish);
+    static Publish() {
+        return A_Abstraction(A_TYPES__ConceptStage.Publish);
     }
 
     /**
      * Deploy the concept to the environment.
      */
-    static get Deploy() {
-        return A_Stage(A_TYPES__ConceptStage.Deploy);
+    static Deploy() {
+        return A_Abstraction(A_TYPES__ConceptStage.Deploy);
     }
 
     /**
@@ -61,29 +63,29 @@ export class A_Concept<
      * Can be used for static websites or any other concept that requires a build step.
      * 
      */
-    static get Build() {
-        return A_Stage(A_TYPES__ConceptStage.Build);
+    static Build() {
+        return A_Abstraction(A_TYPES__ConceptStage.Build);
     }
 
     /**
      *  Main execution of the concept.
      */
-    static get Run() {
-        return A_Stage(A_TYPES__ConceptStage.Run);
+    static Run() {
+        return A_Abstraction(A_TYPES__ConceptStage.Run);
     }
 
     /**
      *  Start the concept. Uses for servers or any other background services.
      */
-    static get Start() {
-        return A_Stage(A_TYPES__ConceptStage.Start);
+    static Start() {
+        return A_Abstraction(A_TYPES__ConceptStage.Start);
     }
 
     /**
      * Stop the concept. Uses for servers or any other background services.
      */
-    static get Stop() {
-        return A_Stage(A_TYPES__ConceptStage.Stop);
+    static Stop() {
+        return A_Abstraction(A_TYPES__ConceptStage.Stop);
     }
 
 
@@ -182,26 +184,46 @@ export class A_Concept<
         params: Partial<A_TYPES__ConceptStageParams>
     ) {
 
-        const stages: any[] = [];
+        const abstractions: {
+            container: A_Container<any>,
+            runners: Array<A_TYPES__A_StageStep>
+        }[] = [];
+
 
         this.containers.map(container => {
             const meta = A_Context.meta(container);
 
-            const containerStages = meta.get(A_TYPES__ContainerMetaKey.STAGES)
+            const containerAbstractions: Array<A_TYPES__A_StageStep> = meta
+                .abstractions(method)
+                .map(step => ({
+                    component: container,
+                    ...step
+                }));
+
+            const containerScope = A_Context.scope(container);
+
+            const componentsAbstractions = containerScope.components
+                .map(component => A_Context.meta(component).abstractions(method).map(step => ({
+                    component,
+                    ...step
+                })))
+                .flat();
+
+            abstractions.push({
+                container,
+                runners: [
+                    ...containerAbstractions.map(step => ({
+                        ...step,
+                        component: container,
+                    })),
+
+                    ...componentsAbstractions
+                ]
+            });
+        });
 
 
-            if (containerStages) {
-                for (const [name, stage] of containerStages) {
-                    if (stage.name === method) {
-                        stages.push({
-                            name,
-                            container,
-                        });
-                    }
-                }
 
-            }
-        });
 
         const scope = A_Context.allocate(this, {
             components: params.components,
@@ -209,9 +231,6 @@ export class A_Concept<
             parent: A_Context.scope(this)
         });
 
-        for (const stage of stages) {
-            await stage.container[stage.name](params);
-        }
 
     }
 
@@ -235,3 +254,5 @@ export class A_Concept<
 
 }
 
+
+

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

@@ -1,5 +1,9 @@
+import { A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator.types";
 import { A_Container } from "../A-Container/A-Container.class";
 import { A_Fragment } from "../A-Fragment/A-Fragment.class";
+import { A_Entity } from "../A-Entity/A-Entity.class";
+import { A_Component } from "../A-Component/A-Component.class";
+import { A_TYPES__A_ExtendDecorator_BehaviorConfig } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
 
 
 export enum A_TYPES__ConceptStage {
@@ -58,6 +62,42 @@ export interface A_TYPES__IConceptConstructor<
 }
 
 
+/**
+ * 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__A_ExtendDecorator_BehaviorConfig
+
+
+
+/**
+ * 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__A_ExtendDecorator_BehaviorConfig
+
+
+
 
 
 // =======================================================================
@@ -68,12 +108,17 @@ export interface A_TYPES__IConceptConstructor<
 
 export type A_TYPES__ConceptStageParams = {
     fragments: Array<A_Fragment>,
-    components: Array<{ new(...args: any[]): any }>
+    components: Array<{ new(...args: any[]): A_Component }>,
+    entities: Array<{ new(...args: any[]): A_Entity }>
 }
 
 
 export type A_TYPES__ConceptCallParams<T extends string> = {
     name: T,
     fragments: Array<A_Fragment>,
-    components: Array<{ new(...args: any[]): any }>
-}
+    components: Array<{ new(...args: any[]): A_Component }>,
+    entities: Array<{ new(...args: any[]): A_Entity<any, any, any> }>
+}
+
+
+

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

@@ -18,7 +18,7 @@ import { A_TYPES__FeatureConstructor } from "../A-Feature/A-Feature.types";
  * - etc.
  */
 export class A_Container<
-    _FeatureNames extends Array<string>
+    _FeatureNames extends Array<string> = any
 > {
     // scope!: A_Scope
 
@@ -55,46 +55,10 @@ export class A_Container<
 
         A_Context.allocate(this, config);
 
-        /**
-         * Run Async Initialization
-         */
-        this.init();
-    }
-
-
-    protected hasInherited(cl: { new(...args: any[]) }): boolean {
-        return this.constructor === cl
-            ? false
-            : true
-    }
-
-
-    /**
-     * Initializes the Namespace or can be used to reinitialize the Namespace
-     */
-    private async init() {
-        if (!this.ready)
-            this.ready = new Promise(async (resolve, reject) => {
-                try {
-                    await this.onBeforeInit();
-
-                    await this.onInit();
-
-                    await this.onAfterInit();
 
-
-                    return resolve();
-                } catch (error) {
-                    return reject(error);
-                }
-            });
-        else
-            await this.ready;
     }
 
-
-
-
+    
 
     /**
      * This method allows to call the lifecycle method of the container as well as any other Feature defined for it
@@ -138,7 +102,7 @@ export class A_Container<
             ? param2 || {}
             : param1;
 
-        const newFeature = A_Context.feature(this.Scope, this, feature, params);
+        const newFeature = A_Context.feature(A_Context.scope(this), this, feature, params);
 
         return await newFeature.process();
     }

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

@@ -1,8 +1,5 @@
-import { A_TYPES__ComponentMetaKey } from "../A-Component/A-Component.types";
-import { A_Context } from "../A-Context/A-Context.class";
-import { A_TYPES__FeatureStep } from "../A-Feature/A-Feature.types";
+import { A_TYPES__ConceptAbstractionMeta, A_TYPES__ConceptStage } from "../A-Concept/A_Concept.types";
 import { A_Meta } from "../A-Meta/A-Meta.class";
-import { A_Container } from "./A-Container.class";
 import {
     A_TYPES__ContainerMeta,
     A_TYPES__ContainerMetaKey
@@ -13,4 +10,44 @@ import {
 export class A_ContainerMeta extends A_Meta<A_TYPES__ContainerMeta> {
 
 
+    /**
+     * Returns a set of instructions to run proper methods in Container during A-Concept Stage
+     * 
+     * @param stage 
+     * @returns 
+     */
+    abstractions(
+        abstraction: A_TYPES__ConceptStage
+    ): A_TYPES__ConceptAbstractionMeta[] {
+        const steps: A_TYPES__ConceptAbstractionMeta[] = [];
+
+        const abstractions = this.get(A_TYPES__ContainerMetaKey.ABSTRACTIONS);
+        const injections = this.get(A_TYPES__ContainerMetaKey.INJECTIONS);
+
+        // const constructor = A_Context.component(this);
+
+
+        abstractions
+            // returns all extensions that match the feature
+            ?.find(`CONCEPT_ABSTRACTION::${abstraction}`)
+            .forEach(([handler, extensions]) => {
+                extensions.forEach(extension => {
+                    const args = injections?.get(extension.handler) || [];
+
+                    steps.push({
+                        name: extension.name,
+                        handler: extension.handler,
+                        args,
+                        before: extension.before,
+                        behavior: extension.behavior,
+                        after: extension.after
+                    });
+
+                });
+            });
+
+
+        return steps;
+    }
+
 }

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_DefineDecorator_Meta, A_TYPES__A_ExtendDecorator_BehaviorConfig } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
 
 
 
@@ -17,20 +20,45 @@ 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.FEATURES]: A_Meta<{
+        /**
+         * Where Key is the name of the feature
+         * 
+         * Where value is the list of features
+         */
+        [Key: string]: A_TYPES__A_DefineDecorator_Meta
+    }>
+    [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

@@ -9,10 +9,14 @@ import { A_Meta } from "../A-Meta/A-Meta.class";
 import { A_ComponentMeta } from "../A-Component/A-Component.meta";
 import { A_ContainerMeta } from "../A-Container/A-Container.meta";
 import { A_Concept } from "../A-Concept/A_Concept.class";
-import { A_TYPES__EntityBaseMethod } from "../A-Entity/A-Entity.types";
+import { A_TYPES__EntityBaseMethod, A_TYPES__EntityMetaKey } 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";
+import { A_TYPES__A_FeatureDecoratorConfig } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
+import { A_TYPES__ContainerMetaKey } from "../A-Container/A-Container.types";
+import { A_TYPES__ComponentMetaKey } from "../A-Component/A-Component.types";
 
 
 /**
@@ -61,8 +65,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 +371,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 +407,31 @@ export class A_Context {
          * While Scope we use just to store the scope where the component registered.
          *  
          */
-        const steps: A_TYPES__FeatureStep[] = [];
+        let metaKey;
+
+        switch (true) {
+            case component instanceof A_Entity:
+                metaKey = A_TYPES__EntityMetaKey.FEATURES;
+                break;
+            case component instanceof A_Container:
+                metaKey = A_TYPES__ContainerMetaKey.FEATURES
+                break;
+            case component instanceof A_Component:
+                metaKey = A_TYPES__ComponentMetaKey.FEATURES
+                break;
+            default:
+                throw new Error(`A-Feature cannot be defined on the ${component} level`);
+        }
+
+        const featureDefinition: A_TYPES__A_FeatureDecoratorConfig = this.meta(component).get(metaKey);
+
+        if (!featureDefinition)
+            throw new Error(`[!] A-Concept Context: Feature not found.`);
+
+
+        const steps: A_TYPES__A_StageStep[] = [
+            ...featureDefinition.template
+        ];
         // const feature: string = new ASEID({
         //     id: `${param2}-${Math.random()}`,
         //     entity: 'a-feature',
@@ -427,12 +451,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 +535,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 +553,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;
-
     }
 }