@adaas/a-concept 0.0.29 → 0.0.31

package/src/decorators/A-Connect/A-Connect.decorator.ts

@@ -0,0 +1,71 @@
+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_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
+import { A_ContainerMeta } from "@adaas/a-concept/global/A-Container/A-Container.meta";
+import { A_ComponentMeta } from "@adaas/a-concept/global/A-Component/A-Component.meta";
+import { A_Channel } from "@adaas/a-concept/global/A-Channel/A-Channel.class";
+
+
+/**
+ * A_Connect decorators allows to establish a connection between the Containers.
+ * 
+ * Depending on the A-Channel implementation the connection could be established in different ways like:
+ * - Direct connection (Async Module import)
+ * - Remote connection (HTTP, WebSockets)
+ * - Local connection (Shared Memory, IPC)
+ * - Event-based connection (EventEmitter, PubSub)
+ * 
+ * 
+ * @param params 
+ * @returns 
+ */
+export function A_Connect(
+    channel: typeof A_Channel,
+    /**
+     * Connection name
+     */
+    id: string
+)
+export function A_Connect(
+    channel: typeof A_Channel,
+    config?: any | string
+) {
+    return function (
+        target: A_Container<any> | A_Component,
+        methodName: string | symbol | undefined,
+        parameterIndex: number
+    ) {
+
+        const meta: A_ContainerMeta | A_ComponentMeta = A_Context.meta(target as any);
+
+        let metaKey;
+
+
+        // // Get the existed metadata or create a new one
+        // const existedMeta: A_Meta<{
+        //     [Key: string]: A_TYPES__ContainerMeta_StageExtension[];
+        // }> = meta.get(metaKey) || new A_Meta();
+
+        // // Set the metadata of the method to define a custom Stage with name
+        // const existedMetaValue = existedMeta.get(StageKey) || [];
+
+        // // Add the new method to the metadata
+        // existedMetaValue.push({
+        //     name: method,
+        //     handler: propertyKey,
+        // });
+
+        // // Set the metadata of the method to define a custom Feature with name
+        // existedMeta.set(StageKey, existedMetaValue);
+
+
+        // //  Update the metadata of the container with the new Stage definition
+        // A_Context
+        //     .meta(target as any)
+        //     .set(
+        //         metaKey,
+        //         existedMeta
+        //     );
+
+    };
+}

package/src/decorators/A-Connect/A-Connect.decorator.types.ts

@@ -0,0 +1,6 @@
+
+export type A_TYPES__A_ConnectDecoratorConfig = {
+}
+
+
+

package/src/decorators/A-Entity/A-Entity-List.decorator.ts

@@ -0,0 +1,12 @@
+
+
+export function A_EntityListDecorator(...args: any[]): any {
+
+    return function (
+        target: any,
+        propertyKey: string,
+        descriptor: PropertyDescriptor
+    ) {
+
+    }
+}

package/src/decorators/A-Entity/A-Entity.decorator.types.ts

@@ -0,0 +1,18 @@
+import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class"
+import { ASEID } from "@adaas/a-utils"
+
+
+
+export type A_TYPES__EntityListDecoratorQuery = {
+    aseid: string | ASEID,
+    id: string,
+    type: { new(...args: any[]): A_Entity<any, any, any> },
+    entity: string
+}
+
+
+
+export type A_TYPES__EntityListDecoratorPagination = {
+    limit: number,
+    offset: number
+}

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

@@ -1,10 +1,11 @@
 import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
 import {
+    A_TYPES__A_DefineDecorator_Meta,
     A_TYPES__A_FeatureDecoratorConfig,
     A_TYPES__A_FeatureDecoratorDescriptor,
 } from "./A-Feature.decorator.types";
 import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
-import { A_TYPES__ContainerMetaKey } from "@adaas/a-concept/global/A-Container/A-Container.types";
+import { A_TYPES__ContainerMeta_FeatureItem, A_TYPES__ContainerMetaKey } from "@adaas/a-concept/global/A-Container/A-Container.types";
 import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
 import { A_EntityMeta } from "@adaas/a-concept/global/A-Entity/A-Entity.meta";
 import { A_ContainerMeta } from "@adaas/a-concept/global/A-Container/A-Container.meta";
@@ -12,6 +13,7 @@ import { A_ComponentMeta } from "@adaas/a-concept/global/A-Component/A-Component
 import { A_TYPES__EntityMetaKey } from "@adaas/a-concept/global/A-Entity/A-Entity.types";
 import { A_TYPES__ComponentMetaKey } from "@adaas/a-concept/global/A-Component/A-Component.types";
 import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class";
+import { A_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
 
 
 /**
@@ -36,7 +38,7 @@ export function A_Feature_Define(
         descriptor: A_TYPES__A_FeatureDecoratorDescriptor
     ) {
 
-        const meta: A_EntityMeta | A_ContainerMeta | A_ComponentMeta = A_Context.meta(target as any);
+        const meta: A_EntityMeta | A_ContainerMeta | A_ComponentMeta = A_Context.meta(target.constructor);
 
         let metaKey;
 
@@ -57,22 +59,27 @@ export function A_Feature_Define(
 
 
         // Get the existed metadata or create a new one
-        const existedMeta = meta.get(metaKey)
-            || new Map();
+        const existedMeta: A_Meta<{
+            /**
+             * Where Key is the name of the feature
+             * 
+             * Where value is the list of features
+             */
+            [Key: string]: A_TYPES__A_DefineDecorator_Meta
+        }> = meta.get(metaKey) || new A_Meta();
 
 
         // Set the metadata of the method to define a custom Feature with name 
         existedMeta.set(propertyKey, {
             handler: propertyKey,
-            config: {
-                ...config,
-                name: `${target.constructor.name}.${propertyKey || config.name}`,
-            }
+            name: `${target.constructor.name}.${propertyKey || config.name}`,
+            template: config.template || [],
+            channel: config.channel || []
         });
 
         //  Update the metadata of the container with the new Feature definition
         A_Context
-            .meta(target as any)
+            .meta(target.constructor)
             .set(
                 metaKey,
                 existedMeta

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

@@ -5,8 +5,6 @@ import {
 } from "./A-Feature.decorator.types";
 import { A_TYPES__ComponentMetaKey } from "@adaas/a-concept/global/A-Component/A-Component.types";
 import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
-import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class";
 import { A_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
 
 
@@ -57,6 +55,9 @@ export function A_Feature_Extend(
     ) {
 
         let targetRegexp: RegExp;
+        let behavior: 'sync' | 'async' = 'sync';
+        let before: string[] = [];
+        let after: string[] = [];
 
 
         // Check if the config is a RegExp
@@ -70,6 +71,10 @@ export function A_Feature_Extend(
                     .join('|')})`
                 : '.*'
                 }\\.${param1.name || propertyKey}$`);
+
+            behavior = param1.behavior || behavior;
+            before = param1.before || before;
+            after = param1.after || after;
         }
         else {
             targetRegexp = new RegExp(`^.*\\.${propertyKey}$`);
@@ -88,6 +93,9 @@ export function A_Feature_Extend(
         existedMetaValue.push({
             name: targetRegexp.source,
             handler: propertyKey,
+            behavior,
+            before,
+            after
         });
 
         // Set the metadata of the method to define a custom Feature with name

package/src/decorators/A-Feature/A-Feature.decorator.types.ts

@@ -1,6 +1,8 @@
+import { A_Channel } from "@adaas/a-concept/global/A-Channel/A-Channel.class";
 import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class"
 import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class"
 import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class"
+import { A_TYPES__A_StageStep } from "@adaas/a-concept/global/A-Stage/A-Stage.types";
 
 
 export type A_TYPES__A_Feature_Extend = {
@@ -26,8 +28,16 @@ export type A_TYPES__A_FeatureDecoratorDescriptor =
 
 export type A_TYPES__A_FeatureDecoratorConfig = {
     name: string,
+    channel: Array<typeof A_Channel>
+    template: Array<A_TYPES__A_StageStep>
 }
 
+export type A_TYPES__A_FeatureTemplateItem = A_TYPES__A_StageStep
+
+
+export type A_TYPES__A_DefineDecorator_Meta = {
+    handler: string
+} & A_TYPES__A_FeatureDecoratorConfig
 
 
 export type A_TYPES__A_ExtendDecoratorDescriptor =
@@ -64,9 +74,45 @@ export type A_TYPES__A_ExtendDecoratorConfig = {
         | { new(...args: any[]): A_Entity }
         | { new(...args: any[]): A_Component }
     >
+} & A_TYPES__A_ExtendDecorator_BehaviorConfig
+
+
+export type A_TYPES__A_ExtendDecorator_BehaviorConfig = {
+    /**
+     * 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: 'async' | 'sync'
+
+
+    /**
+     * 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[]
 }
 
 
 
+export type A_TYPES__A_ExtendDecorator_Meta = {
+    name: string,
+    handler: string
+} & A_TYPES__A_ExtendDecorator_BehaviorConfig
+
+
+
 
 

package/src/decorators/A-Inject/A-Inject.decorator.ts

@@ -1,9 +1,12 @@
 import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-import { A_TYPES__A_InjectDecoratorReturn } from "./A-Inject.decorator.types";
+import {
+    A_TYPES__A_InjectDecorator_EntityInjectionInstructions,
+    A_TYPES__A_InjectDecoratorReturn
+} from "./A-Inject.decorator.types";
 import { A_Fragment } from "@adaas/a-concept/global/A-Fragment/A-Fragment.class";
 import { A_Scope } from "@adaas/a-concept/global/A-Scope/A-Scope.class";
 import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-import { A_TYPES__ComponentMeta_EntityInjectionInstructions, A_TYPES__ComponentMetaKey } from "@adaas/a-concept/global/A-Component/A-Component.types";
+import { A_TYPES__ComponentMetaKey } from "@adaas/a-concept/global/A-Component/A-Component.types";
 import { A_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
 import { A_Feature } from "@adaas/a-concept/global/A-Feature/A-Feature.class";
 import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class";
@@ -42,7 +45,7 @@ export function A_Inject(
 
 export function A_Inject(
     entity: { new(...args: any[]): A_Entity },
-    config: Partial<A_TYPES__ComponentMeta_EntityInjectionInstructions>
+    config: Partial<A_TYPES__A_InjectDecorator_EntityInjectionInstructions>
 ): A_TYPES__A_InjectDecoratorReturn
 
 // ====================== BASE FUNCTION ======================
@@ -52,10 +55,7 @@ export function A_Inject(
         | { new(...args: any[]): A_Component }
         | { new(...args: any[]): A_Fragment }
         | { new(...args: any[]): A_Entity },
-    param2?: {
-        aseid?: string,
-        id?: string,
-    }
+    param2?: Partial<A_TYPES__A_InjectDecorator_EntityInjectionInstructions>
 ): A_TYPES__A_InjectDecoratorReturn {
     return function (
         target: A_Component,

package/src/decorators/A-Inject/A-Inject.decorator.types.ts

@@ -1,3 +1,10 @@
+import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
+import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
+import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class";
+import { A_Feature } from "@adaas/a-concept/global/A-Feature/A-Feature.class";
+import { A_Fragment } from "@adaas/a-concept/global/A-Fragment/A-Fragment.class";
+import { A_Scope } from "@adaas/a-concept/global/A-Scope/A-Scope.class";
+import { ASEID } from "@adaas/a-utils";
 
 export type A_TYPES__A_InjectDecoratorDescriptor = TypedPropertyDescriptor<(
     ...args: any[]
@@ -34,4 +41,43 @@ export type A_TYPES__A_InjectDecoratorStorageInstruction = Array<
     // | Array<typeof A_Container>
     // | Array<typeof A_ContextFragment>
     | { new(...args: any[]): any }
-> 
+>
+
+
+
+export type A_TYPES__A_InjectDecorator_Meta = Array<{
+    target: A_TYPES__A_InjectDecorator_Injectable
+} | {
+    target: { new(...args: any[]): A_Entity },
+    instructions: Partial<A_TYPES__A_InjectDecorator_EntityInjectionInstructions>
+}>;
+
+
+export type A_TYPES__A_InjectDecorator_Injectable =
+    { new(...args: any[]): A_Fragment }
+    | { new(...args: any[]): A_Component }
+    | { new(...args: any[]): A_Container<any> }
+    | { new(...args: any[]): A_Scope }
+    | { new(...args: any[]): A_Feature }
+    | { new(...args: any[]): A_Entity<any, any, any> };
+
+
+export type A_TYPES__A_InjectDecorator_EntityInjectionInstructions = {
+    query: Partial<A_TYPES__A_InjectDecorator_EntityInjectionQuery>,
+    pagination: Partial<A_TYPES__A_InjectDecorator_EntityInjectionPagination>
+}
+
+
+export type A_TYPES__A_InjectDecorator_EntityInjectionQuery = {
+    aseid: string | ASEID,
+    id: string,
+    type: { new(...args: any[]): A_Entity<any, any, any> },
+    entity: string
+}
+
+
+export type A_TYPES__A_InjectDecorator_EntityInjectionPagination = {
+    count: number,
+    from: 'start' | 'end'
+}
+

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

@@ -1,3 +1,6 @@
+import { A_Component } from "../A-Component/A-Component.class";
+import { A_Container } from "../A-Container/A-Container.class";
+import { A_TYPES__A_ChannelAggregated, A_TYPES__A_ChannelAggregateMethods, A_TYPES__A_ChannelCallParams, A_TYPES__A_ChannelConstructor } from "./A-Channel.types";
 
 
 /**
@@ -7,42 +10,36 @@
  * When One container needs to communicate with another container, it uses A_Channel.
  * 
  */
-export class A_Channel<T> {
-    private proxyInstance: T | null = null;
-    private realInstance: T | null = null;
+export class A_Channel<
+    T extends Array<A_Component | A_Container> = any[],
+    _Constructor extends A_TYPES__A_ChannelConstructor = A_TYPES__A_ChannelConstructor
+> {
 
-    constructor(
-        private realClass: { new(...args: any[]): T },
-        private args: any[]
-    ) {
+    id: string;
 
-    }
+    protected channel: A_TYPES__A_ChannelAggregated<T>;
 
-    protected async loadInstance(): Promise<T> {
-        if (!this.realInstance)
-            this.realInstance = new this.realClass(...this.args);
 
-        return this.realInstance;
-    }
+    constructor(params: A_TYPES__A_ChannelConstructor) {
+        this.id = params.id;
 
+        this.channel = new Proxy(
+            {} as A_TYPES__A_ChannelAggregated<T>,
+            {
+                get: (target, prop) => {
+                    return async (...args: any[]) => {
+                        this.call(prop as A_TYPES__A_ChannelAggregateMethods<T>);
+                    };
+                }
+            });
+    }
 
-    public async resolve(): Promise<T> {
-        if (!this.proxyInstance) {
-            const realInstance = await this.loadInstance();
 
-            this.proxyInstance = new Proxy({}, {
-                get: (target, prop) => {
-                    const value = (realInstance as any)[prop];
+    async call<_Resp extends any>(prop: A_TYPES__A_ChannelAggregateMethods<T>, params?: Partial<A_TYPES__A_ChannelCallParams>): Promise<_Resp> {
+        // do HTTP Call or just inject class or whatever you want
 
-                    // If the property is a method, return a bound function
-                    if (typeof value === 'function') {
-                        return value.bind(realInstance);
-                    }
-                    return value;
-                }
-            }) as T;
-        }
+        console.log('Calling method', prop);
 
-        return this.proxyInstance;
+        return {} as _Resp;
     }
 }

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

@@ -1,3 +1,6 @@
+import { A_Component } from "../A-Component/A-Component.class"
+import { A_TYPES__ContainerCallParams } from "../A-Container/A-Container.types"
+import { A_Fragment } from "../A-Fragment/A-Fragment.class"
 
 
 export type A_TYPES__A_DependencyReferenceConstructor = {
@@ -58,3 +61,53 @@ export type A_TYPES__A_DependencyReferenceConstructorConfig = {
         timeout: number
     }
 }
+
+
+export type A_TYPES__A_ChannelCallParams = {
+    fragments: Array<A_Fragment>,
+    components: Array<typeof A_Component>
+}
+
+
+/**
+ * Returns a string set of possible methods that could be called on a provided A-Component
+ */
+export type A_TYPES__A_ExecutableMethods<T> = {
+    [K in keyof T]: T[K] extends (...arg: Partial<A_TYPES__A_ChannelCallParams>[]) => Promise<any> ? K : never
+}[keyof T];
+
+
+/**
+ * Returns a string set of possible methods that could be called on a set of provided set of A-Components
+ */
+export type A_TYPES__A_ChannelAggregateMethods<TClasses extends A_Component[]> = {
+    [K in keyof TClasses]: TClasses[K] extends infer Instance
+    ? A_TYPES__A_ExecutableMethods<Instance>
+    : never;
+}[number];
+
+
+/**
+ * Describes a type of proxy object and consists of all callable methods from a set opf provided components 
+ */
+export type A_TYPES__A_ChannelAggregated<TClasses extends any[]> = {
+    [Method in A_TYPES__A_ChannelAggregateMethods<TClasses>]: {
+        [Class in keyof TClasses]: TClasses[Class] extends infer Instance
+        ? Method extends keyof Instance
+        // Just put it here for possible cases with detailed params
+        // ? Instance[Method]
+        ? (params: Partial<A_TYPES__A_ChannelCallParams>) => Promise<any>
+        : never
+        : never;
+    }[number]; // Select the method signature from any matching class
+};
+
+
+
+
+/**
+ * A set of parameters are required to construct a new A-Channel
+ */
+export type A_TYPES__A_ChannelConstructor = {
+    id: string,
+}

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

@@ -1,8 +1,10 @@
 import { A_TYPES__Required } from "@adaas/a-utils";
 import { A_Context } from "../A-Context/A-Context.class";
-import { A_TYPES__ComponentCallParams } from "./A-Component.types";
+import { A_TYPES__ComponentCallParams, A_TYPES__ComponentConstructor } from "./A-Component.types";
 import { A_Scope } from "../A-Scope/A-Scope.class";
 
+
+
 /**
  * This element only contains the specific code
  * 
@@ -10,6 +12,9 @@ import { A_Scope } from "../A-Scope/A-Scope.class";
 export class A_Component<
     _FeatureNames extends Array<string> = any,
 > {
+    constructor(
+        params?: Partial<A_TYPES__ComponentConstructor<_FeatureNames>>
+    ) { }
 
 
     /**
@@ -62,4 +67,7 @@ export class A_Component<
 
         return await newFeature.process();
     }
-}
+}
+
+
+

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

@@ -1,3 +1,5 @@
+import { A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator.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_TYPES__ComponentMeta, A_TYPES__ComponentMetaExtension, A_TYPES__ComponentMetaKey } from "./A-Component.types";
 
@@ -6,6 +8,23 @@ export class A_ComponentMeta extends A_Meta<A_TYPES__ComponentMeta> {
 
 
 
+    /**
+     * Allows to get all the injections for a given handler
+     * 
+     * @param handler 
+     * @returns 
+     */
+    injections(
+        handler: string
+    ): A_TYPES__A_InjectDecorator_Meta {
+        const injections = this.get(A_TYPES__ComponentMetaKey.INJECTIONS);
+
+        const args = injections?.get(handler) || [];
+
+        return args;
+    }
+
+
 
     /**
      * Allows to get all the extensions for a given feature
@@ -21,21 +40,18 @@ export class A_ComponentMeta extends A_Meta<A_TYPES__ComponentMeta> {
         const extensions = this.get(A_TYPES__ComponentMetaKey.EXTENSIONS);
         const injections = this.get(A_TYPES__ComponentMetaKey.INJECTIONS);
 
-        // const constructor = A_Context.component(this);
-
-
         extensions
             // returns all extensions that match the feature
             ?.find(feature)
             .forEach(([handler, extensions]) => {
                 extensions.forEach(extension => {
-                    const args = injections?.get(extension.handler) || [];
-
                     steps.push({
                         // component: constructor,
                         name: extension.name,
                         handler: extension.handler,
-                        args
+                        behavior: extension.behavior,
+                        before: extension.before || [],
+                        after: extension.after || []
                     });
 
                 });
@@ -45,4 +61,41 @@ export class A_ComponentMeta extends A_Meta<A_TYPES__ComponentMeta> {
         return steps;
     }
 
+
+    /**
+     * Returns a set of instructions to run proper methods in Component 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__ComponentMetaKey.ABSTRACTIONS);
+        const injections = this.get(A_TYPES__ComponentMetaKey.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({
+                        ...extension,
+                        // component: constructor,
+                        args,
+                    });
+
+                });
+            });
+
+
+        return steps;
+    }
 }