@adaas/a-concept 0.0.64 → 0.1.1

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

@@ -1,151 +0,0 @@
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-import {
-    A_TYPES__A_ExtendDecorator_ScopeItem,
-    A_TYPES__A_ExtendDecoratorConfig,
-    A_TYPES__A_ExtendDecoratorDescriptor,
-} 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_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
-
-
-
-
-/**
- * A-Extend decorator
- * 
- * This decorator allows to define a custom Extend stage for the Container.
- * These stages are executed in a container-specific order and can be extended by components that are injected into the container.
- * This approach allows to create a flexible and extendable architecture for the application.
- * 
- * The main difference between the A-Extend and A-Extend decorators is that A-Extend methods can be inherited and overridden by child classes.
- * 
- * 
- * @param params 
- * @returns 
- */
-/**
- * Use regexp in case if you need more flexibility and control over the name of the method
- * 
- * @param regexp 
- */
-export function A_Feature_Extend(
-    regexp: RegExp
-)
-/**
- * In this case the name configurations will be used as an input to get scope and name of target function
- * [!] Not that for all SCOPE will be used OR operator
- * 
- * @param config 
- */
-export function A_Feature_Extend(
-    config: Partial<A_TYPES__A_ExtendDecoratorConfig>
-)
-/**
- * In this case the name of function will be used as a name of the Feature.
- * [!] AND it will be applicable for ANY element where the name is the same as the name of the function
- */
-export function A_Feature_Extend()
-export function A_Feature_Extend(
-    param1?: Partial<A_TYPES__A_ExtendDecoratorConfig> | RegExp
-) {
-    return function (
-        target: A_Component,
-        propertyKey: string,
-        descriptor: A_TYPES__A_ExtendDecoratorDescriptor
-    ) {
-
-        let targetRegexp: RegExp;
-        let behavior: 'sync' | 'async' = 'sync';
-        let before: string[] = [];
-        let after: string[] = [];
-        let include: Array<A_TYPES__A_ExtendDecorator_ScopeItem> = [];
-        let exclude: Array<A_TYPES__A_ExtendDecorator_ScopeItem> = [];
-
-        // Check if the config is a RegExp
-        if (param1 instanceof RegExp) {
-            targetRegexp = param1;
-        }
-        else if (!!param1 && typeof param1 === 'object') {
-
-            if (Array.isArray(param1.scope))
-                include = param1.scope;
-            else if (!!param1.scope && typeof param1.scope === 'object') {
-                if (Array.isArray(param1.scope.include))
-                    include = param1.scope.include;
-                if (Array.isArray(param1.scope.exclude))
-                    exclude = param1.scope.exclude;
-            }
-
-
-            targetRegexp = buildTargetRegexp(param1, include, exclude, propertyKey);
-
-            behavior = param1.behavior || behavior;
-            before = param1.before || before;
-            after = param1.after || after;
-        } else {
-            targetRegexp = new RegExp(`^.*\\.${propertyKey}$`);
-        }
-
-        const existedDefinitions = A_Context
-            .meta(target)
-            .get(A_TYPES__ComponentMetaKey.FEATURES);
-
-
-
-        // Get the existed metadata or create a new one
-        const existedMeta = A_Context
-            .meta(target)
-            .get(A_TYPES__ComponentMetaKey.EXTENSIONS)
-            || new A_Meta();
-
-
-        if (existedDefinitions
-            && existedDefinitions.size()
-            && existedDefinitions.has(propertyKey)
-            && existedDefinitions.get(propertyKey)!.invoke
-        ) {
-
-            throw new Error(`A-Feature-Extend cannot be used on the method "${propertyKey}" because it is already defined as a Feature with "invoke" set to true.
-            Please remove the A-Feature-Extend decorator or set "invoke" to false in the A-Feature decorator.`);
-        }
-
-
-        const existedMetaValue = existedMeta.get(targetRegexp.source) || [];
-
-        // Add the new method to the metadata
-        existedMetaValue.push({
-            name: targetRegexp.source,
-            handler: propertyKey,
-            behavior,
-            before,
-            after
-        });
-
-        // Set the metadata of the method to define a custom Feature with name
-        existedMeta.set(targetRegexp.source, existedMetaValue);
-
-        //  Update the metadata of the container with the new Feature definition
-        A_Context
-            .meta(target)
-            .set(A_TYPES__ComponentMetaKey.EXTENSIONS, existedMeta);
-    };
-}
-
-
-
-export function buildTargetRegexp(param1: any, include: any[], exclude: any[], propertyKey: string) {
-    const includePart = include.length
-        ? `(${include.map(el => el.name).join('|')})`
-        : `.*`;
-
-    const excludePart = exclude.length
-        ? `(?!${exclude.map(el => el.name).join('|')})`
-        : ``;
-
-    const pattern = param1.scope
-        ? `^${excludePart}${includePart}\\.${param1.name || propertyKey}$`
-        : `.*\\.${param1.name || propertyKey}$`;
-
-    return new RegExp(pattern);
-}

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

@@ -1,142 +0,0 @@
-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";
-import { A_TYPES__Required } from "@adaas/a-utils";
-
-
-export type A_TYPES__A_Feature_Extend = {
-    (regexp: RegExp): MethodDecorator;
-    (config: Partial<A_TYPES__A_ExtendDecoratorConfig>): MethodDecorator;
-    (): MethodDecorator;
-};
-
-export type A_TYPES__A_FeatureDecoratorDescriptor =
-    TypedPropertyDescriptor<
-        ((...args: any[]) => any)
-        |
-        ((...args: any[]) => Promise<any>)
-        |
-        (() => any)
-        |
-        (() => Promise<any>)
-    >
-
-
-
-
-export type A_TYPES__A_FeatureDecoratorConfig = {
-    name: string,
-    invoke: boolean,
-    channel: Array<typeof A_Channel>
-    template: Array<A_TYPES__A_FeatureTemplateItem>
-}
-
-export type A_TYPES__A_FeatureTemplateItem = A_TYPES__Required<Partial<A_TYPES__A_StageStep>, ['name', 'handler', 'component']>
-
-
-export type A_TYPES__A_DefineDecorator_Meta = {
-    name: string,
-    handler: string,
-    invoke: boolean,
-    channel: Array<typeof A_Channel>
-    template: Array<A_TYPES__A_StageStep>
-}
-
-
-export type A_TYPES__A_ExtendDecoratorDescriptor =
-
-    TypedPropertyDescriptor<() => any>
-    |
-    TypedPropertyDescriptor<(
-        ...args: any[]
-    ) => any>
-    |
-    TypedPropertyDescriptor<(
-        ...args: any[]
-    ) => Promise<any>>
-    |
-    TypedPropertyDescriptor<() => Promise<any>>
-
-
-export type A_TYPES__A_ExtendDecoratorConfig = {
-    /**
-     * Name of the container Lifecycle method to be extended.
-     * 
-     * [!] If not provided will be used the name of the method.
-     * [!!] If name contains "." dot it will be considered as a path to the method.
-     */
-    name: string,
-    /**
-     * Container class or container name uses to identify the proper container in case when the name is not unique.
-     * 
-     * [!] If not provided will be applied to all containers with the same name.
-     * [!!] By default uses OR to join all provided items. If you need more complex Logic, please use Regexp instead
-     * 
-     * [!!!] In case if you need to exclude some containers, entities or components, please use "exclude" property
-     * 
-     * Example:
-     * 
-     * ```ts
-     *  @A_Feature.Extend({
-     *      name: 'load',
-     *      scope: {
-     *          include: [A_Container1, A_Entity1],
-     *          exclude: [A_Component1]
-     *      }
-     *  })
-     * ```
-     */
-    scope: Array<A_TYPES__A_ExtendDecorator_ScopeItem> | Partial<A_TYPES__A_ExtendDecorator_ScopeConfig>,
-} & A_TYPES__A_ExtendDecorator_BehaviorConfig
-
-export type A_TYPES__A_ExtendDecorator_ScopeItem = { new(...args: any[]): A_Container }
-    | { new(...args: any[]): A_Entity }
-    | { new(...args: any[]): A_Component }
-
-
-export type A_TYPES__A_ExtendDecorator_ScopeConfig = {
-    include?: Array<A_TYPES__A_ExtendDecorator_ScopeItem>,
-    exclude?: Array<A_TYPES__A_ExtendDecorator_ScopeItem>
-}
-
-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,119 +0,0 @@
-import {
-    A_TYPES__A_InjectDecorator_EntityInjectionInstructions,
-    A_TYPES__A_InjectDecoratorReturn
-} from "./A-Inject.decorator.types";
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.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 { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-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";
-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_CommonHelper } from "@adaas/a-utils";
-import { A_FeatureCaller } from "@adaas/a-concept/global/A-Feature/A-FeatureCaller.class";
-
-
-
-/**
- * A-Inject decorator
- * 
- * This Decorator allows to inject dependencies into the module like 
- * - Namespaces 
- * - Other Concepts 
- * - or maybe Components
- * 
- * @param params 
- * @returns 
- */
-export function A_Inject(
-    scope: typeof A_Scope
-): A_TYPES__A_InjectDecoratorReturn
-export function A_Inject(
-    feature: typeof A_Feature
-): A_TYPES__A_InjectDecoratorReturn
-export function A_Inject(
-    component: { new(...args: any[]): A_Component }
-): A_TYPES__A_InjectDecoratorReturn
-//  Allows to inject just one A_FeatureCaller
-export function A_Inject(
-    container: typeof A_FeatureCaller
-): A_TYPES__A_InjectDecoratorReturn
-// Allows to inject just one Context Fragment
-export function A_Inject(
-    fragment: { new(...args: any[]): A_Fragment }
-): A_TYPES__A_InjectDecoratorReturn
-
-export function A_Inject<T extends A_Entity>(
-    entity: { new(...args: any[]): T },
-    config: Partial<A_TYPES__A_InjectDecorator_EntityInjectionInstructions<T>>
-): A_TYPES__A_InjectDecoratorReturn
-
-// ====================== BASE FUNCTION ======================
-export function A_Inject(
-    param1: typeof A_Scope
-        | typeof A_Feature
-        | typeof A_FeatureCaller
-        | { new(...args: any[]): A_Component }
-        | { new(...args: any[]): A_Fragment }
-        | { new(...args: any[]): A_Entity },
-    param2?: Partial<A_TYPES__A_InjectDecorator_EntityInjectionInstructions>
-): A_TYPES__A_InjectDecoratorReturn {
-    return function (
-        target: A_Component,
-        methodName: string | symbol | undefined,
-        parameterIndex: number
-    ) {
-
-        const method = methodName ? String(methodName) : 'constructor';
-
-        let metaKey;
-
-        switch (true) {
-
-            case target instanceof A_Component:
-                metaKey = A_TYPES__ComponentMetaKey.INJECTIONS;
-                break;
-
-            case A_CommonHelper.isInheritedFrom(target, A_Component):
-                metaKey = A_TYPES__ComponentMetaKey.INJECTIONS;
-                break;
-
-            case A_CommonHelper.isInheritedFrom(target, A_Container):
-                metaKey = A_TYPES__ContainerMetaKey.INJECTIONS;
-                break;
-
-            case target instanceof A_Container:
-                metaKey = A_TYPES__ContainerMetaKey.INJECTIONS;
-                break;
-
-
-            default:
-                throw new Error(`A-Inject cannot be defined on the ${target} level`);
-        }
-
-        const existedMeta = A_Context
-            .meta(target)
-            .get(metaKey)
-            || new A_Meta();
-
-
-        const paramsArray = existedMeta.get(method) || [];
-
-        paramsArray[parameterIndex] = {
-            target: param1,
-            instructions: param2
-        }
-
-        existedMeta.set(method, paramsArray);
-
-        A_Context
-            .meta(target)
-            .set(
-                metaKey,
-                existedMeta
-            );
-    }
-}

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

@@ -1,85 +0,0 @@
-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_FeatureCaller } from "@adaas/a-concept/global/A-Feature/A-FeatureCaller.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[]
-) => Promise<void>>
-
-
-export type A_TYPES__A_InjectDecoratorReturn<T = any> = (
-    target: T,
-    propertyKey: string | symbol | undefined,
-    parameterIndex: number
-) => void
-
-
-// export type A_TYPES__A_InjectDecoratorStorageInstruction = {
-//     index: number,
-//     type: typeof A_Namespace
-//     | typeof A_Component
-//     | typeof A_Container
-//     | typeof A_ContextFragment
-//     | Array<typeof A_Namespace>
-//     | Array<typeof A_Component>
-//     | Array<typeof A_Container>
-//     | Array<typeof A_ContextFragment>
-//     | { new(...args: any[]): any }
-// }  
-
-export type A_TYPES__A_InjectDecoratorStorageInstruction = Array<
-    // typeof A_Namespace
-    // | typeof A_Component
-    // | typeof A_Container
-    // | typeof A_ContextFragment
-    // | Array<typeof A_Namespace>
-    // | Array<typeof A_Component>
-    // | 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 }
-    | { new(...args: any[]): A_Scope }
-    | { new(...args: any[]): A_Feature }
-    | { new(...args: any[]): A_Entity }
-    | { new(...args: any[]): A_FeatureCaller };
-
-
-export type A_TYPES__A_InjectDecorator_EntityInjectionInstructions<T extends A_Entity = A_Entity> = {
-    query: Partial<A_TYPES__A_InjectDecorator_EntityInjectionQuery<T>>,
-    pagination: Partial<A_TYPES__A_InjectDecorator_EntityInjectionPagination>
-}
-
-
-export type A_TYPES__A_InjectDecorator_EntityInjectionQuery<T extends A_Entity = A_Entity> = {
-    aseid: string,
-} & {
-    [key in keyof T]?: any
-};
-
-
-export type A_TYPES__A_InjectDecorator_EntityInjectionPagination = {
-    count: number,
-    from: 'start' | 'end'
-}
-

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

@@ -1,111 +0,0 @@
-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";
-
-
-/**
- * [!] DEPRECATED - use simply A_Component instead
- * 
- * A_Channel is an abstraction over any Communication Type from event emitters to message queues, HTTP requests, etc.
- * 
- * A_Channel uses to connect Containers between each other. When
- * When One container needs to communicate with another container, it uses A_Channel.
- * 
- */
-export class A_Channel<
-    T extends Array<A_Component | A_Container> = any[],
-    _Constructor extends A_TYPES__A_ChannelConstructor = A_TYPES__A_ChannelConstructor
-> {
-
-    id: string;
-
-    // protected channel: A_TYPES__A_ChannelAggregated<T>;
-
-
-    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>);
-        //             };
-        //         }
-        //     });
-    }
-
-    // // fire and forget
-    // async send(message: T, options?: unknown): void | Promise<void> { }
-
-    // // request/response
-    // async request(message: T, options?: unknown): Promise<R> { }
-
-    // // continuous consumption
-    // async consume(handler: (msg: T) => void | Promise<void>, options?: unknown): void { }
-
-    // // pull-based
-    // async pull(options?: unknown): Promise<T | null> { }
-
-    // // streaming
-    // async stream(): AsyncIterable<T>{
-
-}
-
-
-
-
-
-// const toUsersChannel = new A_Channel('users');
-
-// const toOrdersChannel = new A_Channel('orders');
-
-
-
-
-// class someComponent extends A_Component {
-
-
-//     async someMethod(
-//         @A_Channel('users') usersChannel: A_Channel,
-//     ) {
-//         // await toUsersChannel.call('methodName', { fragments: [], components: [A_Component] });
-//     }
-
-// }
-
-
-
-
-
-// class UsersChannel extends A_Channel {
-//     constructor(
-//         @A_inject(A_Config) config : A_Config
-//     ){
-//         super('users');
-//     }
-// }
-
-
-// class OrdersChannel extends A_Channel { }
-
-
-// class anotherComponent extends A_Component {
-//     async someMethod(
-//         @A_inject(UsersChannel) usersChannel: UsersChannel,
-//         @A_inject(OrdersChannel) ordersChannel: OrdersChannel,
-//     ) {
-//         const command = new A_Command();
-
-//         usersChannel
-//         .use(someSession)
-//         .send(command);
-
-
-//         await ordersChannel.request(command);
-
-
-//         // await toUsersChannel.call('methodName', { fragments: [], components: [A_Component] });
-//     }
-// }