@adaas/a-concept 0.0.63 → 0.1.1

package/src/base/A-Errors/A-Errors.component.ts

@@ -1,103 +0,0 @@
-import { A_Scope } from "@adaas/a-concept/global/A-Scope/A-Scope.class";
-import { A_Inject } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator";
-import { A_Errors } from "./A-Errors.context";
-import { A_CONSTANTS__ERROR_CODES, A_Error, A_ServerError, ASEID } from "@adaas/a-utils";
-import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-
-export class A_ErrorsManager extends A_Component {
-
-    constructor(
-        @A_Inject(A_Scope) protected scope: A_Scope,
-        @A_Inject(A_Errors) protected errors: A_Errors
-    ) {
-        super();
-    }
-
-
-
-
-    throw(
-        error: Error | unknown | any
-    ): never
-    throw(
-        code: A_CONSTANTS__ERROR_CODES | string
-    ): never
-    throw(
-        error: A_Error | A_ServerError
-    ): never
-    throw(
-        param: A_CONSTANTS__ERROR_CODES | string | A_Error | A_ServerError
-    ): never {
-        switch (true) {
-            // In case of error code
-            case typeof param === 'string':
-                const template = this.errors.get(param);
-                const namedCode = `${A_Context.root.name}@${this.scope.name}:error:${template.code}`
-
-                if ('serverCode' in template)
-                    throw new A_ServerError({
-                        ...template,
-                        code: namedCode
-                    });
-                else
-                    throw new A_Error({
-                        ...template,
-                        code: namedCode
-                    })
-
-            // In case of error object
-            case param instanceof A_Error:
-                throw param;
-
-            // Otherwise wrap the error
-            default:
-                throw this.wrap(param);
-        }
-    }
-
-
-    /**
-     *  This method wraps an error into the SDK error object.
-     * 
-     * @param error 
-     * @returns 
-     */
-    wrap(error: Error | A_Error | unknown | any): A_ServerError | A_Error {
-
-        switch (true) {
-            case error instanceof A_Error:
-                let newCode = `${A_Context.root.name}@${this.scope.name}:error:${error.code}`;
-
-                if (ASEID.isASEID(error.code)) {
-                    const aseid = new ASEID(error.code);
-
-                    if (aseid.scope !== this.scope.name)
-                        newCode = `${A_Context.root.name}@${this.scope.name}:error:${aseid.id}`;
-                }
-
-                if ('serverCode' in error)
-                    return new A_ServerError({
-                        originalError: error,
-                        code: newCode,
-                        serverCode: error.serverCode,
-                        name: error.name,
-                        message: error.message,
-                        link: error.link,
-                        description: error.description
-                    });
-                else
-                    return new A_Error({
-                        originalError: error,
-                        code: newCode,
-                        name: error.name,
-                        message: error.message,
-                        link: error.link,
-                        description: error.description
-                    });
-
-            default:
-                return new A_Error(error);
-        }
-    }
-}

package/src/base/A-Errors/A-Errors.context.ts

@@ -1,90 +0,0 @@
-import { A_CONSTANTS__ERROR_CODES, A_Error, A_ServerError, A_TYPES__Dictionary, A_TYPES__Error, A_TYPES__ServerError } from "@adaas/a-utils";
-import { A_TYPES__A_ErrorsConstructor } from "./A-Errors.types";
-import { A_CONSTANTS__DEFAULT_ERRORS } from "@adaas/a-utils/dist/src/constants/errors.constants";
-import { A_Fragment } from "@adaas/a-concept/global/A-Fragment/A-Fragment.class";
-
-
-export class A_Errors extends A_Fragment {
-
-    protected registeredErrors: Map<string, A_TYPES__Error | A_TYPES__ServerError> = new Map();
-
-
-    
-    constructor(
-        params: Partial<A_TYPES__A_ErrorsConstructor>
-    ) {
-
-        super({
-            ...params,
-            name: params.name || 'a-errors'
-        });
-
-        this.addRegistry(A_CONSTANTS__DEFAULT_ERRORS);
-
-        if (params.errors) {
-            this.addRegistry(params.errors);
-        }
-    }
-
-
-    /**
-     * This method adds a dictionary of errors to the registry.
-     * 
-     * @param registry 
-     */
-    addRegistry(
-        registry: A_TYPES__Dictionary<A_TYPES__Error> | A_TYPES__Error[]
-    ): A_Errors {
-        const errors = Array.isArray(registry) ? registry : Object.values(registry);
-
-        errors.forEach(err => this.registerError(err));
-
-        return this;
-    }
-
-
-    /**
-     * 
-     * Adds an error to the registry
-     * 
-     * @param error 
-     */
-    registerError(error: A_TYPES__Error): A_Errors {
-        this.registeredErrors.set(error.code, error);
-
-        return this;
-    }
-
-
-    /**
-     * This method returns an error object by its code.
-     * 
-     * @param code 
-     * @returns 
-     */
-    get(code: A_CONSTANTS__ERROR_CODES | string): A_TYPES__Error | A_TYPES__ServerError {
-        let template = this.registeredErrors.get(code);
-
-        if (!template)
-            template = this.registeredErrors.get(A_CONSTANTS__ERROR_CODES.UNEXPECTED_ERROR)!;
-
-        return template;
-    }
-
-
-    /**
-     * Allows to throw an error by its code. 
-     * [!] BUT WITHOUT Connection to particular Scope
-     * 
-     * This method throws an error by its code.
-     * 
-     */
-    // throw(code: A_CONSTANTS__ERROR_CODES | string): never {
-    //     const template = this.get(code);
-
-    //     if ('serverCode' in template)
-    //         throw new A_ServerError(template);
-    //     else
-    //         throw new A_Error(template)
-    // }
-} 

package/src/base/A-Errors/A-Errors.types.ts

@@ -1,6 +0,0 @@
-import { A_TYPES__FragmentConstructor } from "@adaas/a-concept/global/A-Fragment/A-Fragment.types"
-import { A_TYPES__Dictionary, A_TYPES__Error } from "@adaas/a-utils"
-
-export type A_TYPES__A_ErrorsConstructor = {
-    errors: A_TYPES__Dictionary<A_TYPES__Error> | A_TYPES__Error[]
-} & A_TYPES__FragmentConstructor

package/src/base/A-Logger/A-Logger.component.ts

@@ -1,192 +0,0 @@
-import { A_Inject } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator";
-import { A_Error } from "@adaas/a-utils";
-import { A_Config } from "../A-Config/A-Config.context";
-import { A_Scope } from "@adaas/a-concept/global/A-Scope/A-Scope.class";
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-
-
-export class A_Logger extends A_Component {
-
-    constructor(
-        @A_Inject(A_Scope) protected scope: A_Scope,
-        @A_Inject(A_Config) protected config: A_Config
-    ) {
-        super();
-    }
-
-    readonly colors = {
-        green: '32',
-        blue: '34',
-        red: '31',
-        yellow: '33',
-        gray: '90',
-        magenta: '35',
-        cyan: '36',
-        white: '37',
-        pink: '95',
-    } as const
-
-
-    get scopeLength() {
-        return this.scope.name.length;
-    }
-
-
-    compile(
-        color: keyof typeof this.colors,
-        ...args: any[]
-    ): Array<string> {
-
-        return [
-            `\x1b[${this.colors[color]}m[${this.scope.name}] |${this.getTime()}|`,
-            (
-                args.length > 1
-                    ? '\n' + `${' '.repeat(this.scopeLength + 3)}|-------------------------------`
-                    : ''
-
-            ),
-            ...(args
-                .map((arg, i) => {
-
-
-                    switch (true) {
-                        case arg instanceof A_Error:
-                            return this.compile_A_Error(arg);
-
-                        case arg instanceof Error:
-                            return this.compile_Error(arg);
-
-                        case typeof arg === 'object':
-                            return JSON.stringify(arg, null, 2)
-                                .replace(/\n/g, '\n' + `${' '.repeat(this.scopeLength + 3)}| `);
-
-                        default:
-                            return String(
-                                ((i > 0 || args.length > 1) ? '\n' : '')
-                                + arg)
-                                .replace(/\n/g, '\n' + `${' '.repeat(this.scopeLength + 3)}| `)
-                    }
-                })),
-            (
-                args.length > 1
-                    ? '\n' + `${' '.repeat(this.scopeLength + 3)}|-------------------------------\x1b[0m`
-                    : '\x1b[0m'
-            )
-        ]
-    }
-
-    protected get allowedToLog() {
-        return this.config.get('CONFIG_VERBOSE') !== undefined
-            && this.config.get('CONFIG_VERBOSE') !== 'false'
-            && this.config.get('CONFIG_VERBOSE') !== false
-    }
-
-
-    log(
-        color: keyof typeof this.colors,
-        ...args: any[]
-    )
-    log(
-        ...args: any[]
-    )
-    log(
-        param1: any,
-        ...args: any[]
-    ) {
-        if (!this.allowedToLog)
-            return;
-
-        if (typeof param1 === 'string' && this.colors[param1]) {
-            console.log(...this.compile(param1 as keyof typeof this.colors, ...args));
-            return;
-        }
-        else {
-            console.log(...this.compile('blue', param1, ...args));
-        }
-    }
-
-    warning(...args) {
-        if (!this.allowedToLog)
-            return;
-
-        console.log(...this.compile('yellow', ...args));
-    }
-
-    error(...args) {
-        if (this.config.get('CONFIG_IGNORE_ERRORS'))
-            return;
-
-        return console.log(...this.compile('red', ...args));
-    }
-
-
-    protected log_A_Error(error: A_Error) {
-        const time = this.getTime();
-
-        console.log(`\x1b[31m[${this.scope.name}] |${time}| ERROR ${error.code}
-${' '.repeat(this.scopeLength + 3)}| ${error.message}
-${' '.repeat(this.scopeLength + 3)}| ${error.description} 
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-${' '.repeat(this.scopeLength + 3)}| ${error.stack?.split('\n').map((line, index) => index === 0 ? line : `${' '.repeat(this.scopeLength + 3)}| ${line}`).join('\n') || 'No stack trace'}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-\x1b[0m`
-            + (error.originalError ? `\x1b[31m${' '.repeat(this.scopeLength + 3)}| Wrapped From  ${error.originalError.message}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-${' '.repeat(this.scopeLength + 3)}| ${error.originalError.stack?.split('\n').map((line, index) => index === 0 ? line : `${' '.repeat(this.scopeLength + 3)}| ${line}`).join('\n') || 'No stack trace'}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-\x1b[0m`: '')
-            + (error.link ? `\x1b[31m${' '.repeat(this.scopeLength + 3)}| Read in docs: ${error.link}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-\x1b[0m`: ''));
-
-    }
-
-    protected compile_A_Error(error: A_Error): string {
-        const time = this.getTime();
-
-        return '\n' +
-
-            `${' '.repeat(this.scopeLength + 3)}|-------------------------------` +
-            '\n' +
-            `${' '.repeat(this.scopeLength + 3)}|  Error:  | ${error.code}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-${' '.repeat(this.scopeLength + 3)}|${' '.repeat(10)}| ${error.message}
-${' '.repeat(this.scopeLength + 3)}|${' '.repeat(10)}| ${error.description} 
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-${' '.repeat(this.scopeLength + 3)}| ${error.stack?.split('\n').map((line, index) => index === 0 ? line : `${' '.repeat(this.scopeLength + 3)}| ${line}`).join('\n') || 'No stack trace'}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------`
-            +
-            (error.originalError ? `${' '.repeat(this.scopeLength + 3)}| Wrapped From  ${error.originalError.message}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------
-${' '.repeat(this.scopeLength + 3)}| ${error.originalError.stack?.split('\n').map((line, index) => index === 0 ? line : `${' '.repeat(this.scopeLength + 3)}| ${line}`).join('\n') || 'No stack trace'}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------` : '')
-            +
-            (error.link ? `${' '.repeat(this.scopeLength + 3)}| Read in docs: ${error.link}
-${' '.repeat(this.scopeLength + 3)}|-------------------------------` : '');
-
-    }
-
-
-    protected compile_Error(error: Error): string {
-        return JSON.stringify({
-            name: error.name,
-            message: error.message,
-            stack: error.stack?.split('\n')
-                .map((line, index) => index === 0 ? line : `${' '.repeat(this.scopeLength + 3)}| ${line}`)
-                .join('\n')
-
-        }, null, 2)
-            .replace(/\n/g, '\n' + `${' '.repeat(this.scopeLength + 3)}| `)
-            .replace(/\\n/g, '\n')
-    }
-
-
-
-    protected getTime() {
-        const now = new Date();
-        const minutes = String(now.getMinutes()).padStart(2, '0');
-        const seconds = String(now.getSeconds()).padStart(2, '0');
-        const milliseconds = String(now.getMilliseconds()).padStart(4, '0');
-        return `${minutes}:${seconds}:${milliseconds}`;
-    }
-}

package/src/base/A-Polyfill/A-Polyfill.component.ts

@@ -1,18 +0,0 @@
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-import { A_Concept } from "@adaas/a-concept/global/A-Concept/A_Concept.class";
-import { A_Polyfills } from "@adaas/a-utils";
-
-
-
-export class A_Polyfill extends A_Component {
-
-    private fs!: any;
-
-
-    @A_Concept.Load()
-    async load() {
-        const fs = await A_Polyfills.fs();
-
-        this.fs = fs;
-    }
-}

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

@@ -1,81 +0,0 @@
-import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-import {
-    A_TYPES__A_AbstractionDecoratorDescriptor,
-} from "./A-Abstraction.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_TYPES__ContainerMetaKey } from "@adaas/a-concept/global/A-Container/A-Container.types";
-import { A_TYPES__ConceptAbstraction, A_TYPES__ConceptStage } from "@adaas/a-concept/global/A-Concept/A_Concept.types";
-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_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
-import { A_TYPES__A_ExtendDecoratorConfig } from "../A-Feature/A-Feature.decorator.types";
-
-/**
- * A_Stage Decorator uses to extend basic A-Concept Stage methods inside Containers.
- * 
- * Using this decorator you can define extend a logic and sequence of the Container Stage methods execution.  
- * 
- * @param params 
- * @returns 
- */
-export function A_Abstraction_Extend(
-    method: A_TYPES__ConceptStage,
-    config: Partial<A_TYPES__A_ExtendDecoratorConfig> = {}
-) {
-    return function (
-        target: A_Container | A_Component,
-        propertyKey: string,
-        descriptor: A_TYPES__A_AbstractionDecoratorDescriptor
-    ) {
-
-        const meta: A_ContainerMeta | A_ComponentMeta = A_Context.meta(target as any);
-
-        let metaKey;
-
-        const abstractionKey = `${method}`;
-
-        switch (true) {
-            case target instanceof A_Container:
-                metaKey = A_TYPES__ContainerMetaKey.ABSTRACTIONS
-                break;
-            case target instanceof A_Component:
-                metaKey = A_TYPES__ComponentMetaKey.ABSTRACTIONS
-                break;
-            default:
-                throw new Error(`Concept Stage cannot be defined on the ${target} level`);
-        }
-
-        // Get the existed metadata or create a new one
-        const existedMeta: A_Meta<{
-            [Key: string]: A_TYPES__ConceptAbstraction[];
-        }> = meta.get(metaKey) || new A_Meta();
-
-        // Set the metadata of the method to define a custom Stage with name
-        const existedMetaValue = existedMeta.get(abstractionKey) || [];
-
-
-        // Add the new method to the metadata
-        existedMetaValue.push({
-            name: method,
-            handler: propertyKey,
-            before: config.before || [],
-            after: config.after || [],
-            behavior: config.behavior || 'sync'
-        });
-
-        // Set the metadata of the method to define a custom Feature with name
-        existedMeta.set(abstractionKey, 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-Abstraction/A-Abstraction.decorator.types.ts

@@ -1,21 +0,0 @@
-
-export type A_TYPES__A_AbstractionDecoratorDescriptor =
-
-    TypedPropertyDescriptor<() => any>
-    |
-    TypedPropertyDescriptor<(
-        ...args: any[]
-    ) => any>
-    |
-    TypedPropertyDescriptor<(
-        ...args: any[]
-    ) => Promise<any>>
-    |
-    TypedPropertyDescriptor<() => Promise<any>>
-
-
-export type A_TYPES__A_AbstractionDecoratorConfig = {
-}
-
-
-

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

@@ -1,71 +0,0 @@
-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 | 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

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

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

@@ -1,12 +0,0 @@
-
-
-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

@@ -1,18 +0,0 @@
-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 },
-    entity: string
-}
-
-
-
-export type A_TYPES__EntityListDecoratorPagination = {
-    limit: number,
-    offset: number
-}