@adaas/a-concept 0.0.63 → 0.1.1

package/examples/simple-http-server/test.ts

@@ -1,290 +0,0 @@
-
-function Inject() {
-    return function (target: any, key: string, index: number) {
-        console.log('Inject', target, key, index);
-    }
-}
-
-
-/**
- * Allows to define a new lifecycle method
- */
-function Define(
-    ...args: any[]
-)
-function Define(
-    name: string,
-    ...args: any[]
-) {
-    return function (target: any, key: string, descriptor: PropertyDescriptor) {
-        Architecture
-            .register(target.constructor, {
-                name
-            });
-    }
-
-}
-
-
-class User {
-
-}
-
-
-class CRUDController {
-
-
-    constructor(
-        // Context Injection to adjust behavior
-        // @Inject(User) user
-    ) {
-    }
-
-
-    post(
-        // Runtime injection to get the request object or any other
-        @Inject() request: ControllerRequest,
-    ) {
-        request.user;
-    }
-}
-
-class StatsController {
-
-
-    // This method is context independent and "extends" the behavior of the parent Class (without inheritance)
-    // Here you can define what to expect from the previous step
-    // Basically here we can extend the behavior of the parent class
-    @App.Lifecycle.onRequest()
-    onRequest(
-
-    ) {
-
-    }
-
-
-
-    //  This method is context dependent
-    count(
-        @Inject() request: ControllerRequest,
-    ) {
-        request.user;
-    }
-}
-
-class ControllerRequest {
-
-    constructor(
-        public user: User
-    ) {
-
-
-    }
-}
-
-
-class DependencyResolver {
-    resolve<T extends { new(...args: any[]): any }>(
-        target: any,
-
-    ): T {
-        return new target();
-    }
-
-}
-
-
-class Architecture {
-
-    private static instance: Architecture;
-
-    private definitions: Map<{ new(...args: any[]): any }, {
-        lifecycle: Map<string, Function>
-    }> = new Map();
-
-
-    private constructor() {
-
-    }
-
-
-    static getInstance() {
-        if (!this.instance) {
-            this.instance = new Architecture();
-        }
-        return this.instance;
-    }
-
-
-    static register(
-        constructor: { new(...args: any[]): any },
-        config: {
-            name: string
-        }
-    ) {
-        const instance = this.getInstance();
-
-        instance.definitions.set(constructor, {
-            lifecycle: new Map()
-        });
-    }
-
-
-    static getLifecycle(
-        constructor: { new(...args: any[]): any }
-    ) {
-        const instance = this.getInstance();
-
-        return instance.definitions.get(constructor)?.lifecycle;
-    }
-
-}
-
-
-class Container {
-
-}
-
-
-
-// Concept 
-// - run
-// - build
-
-// Container #1
-// - start
-// - stop
-
-// Container #2
-// - build
-// - request
-// - response
-// - error 
-
-// Container #3
-// - start
-// - stop
-
-
-
-interface Feature<
-    _LifecycleMethodName extends string,
-    _RuntimeContext extends any,
-> {
-    name: _LifecycleMethodName;
-    context: new (...args: any[]) => _RuntimeContext; // The class constructor for the context
-}
-
-
-
-
-class Concept<
-    _LifecycleMethodNames extends string,
-    _RuntimeContext extends any,
-
-    // _FeaturesDefinition extends Feature<_LifecycleMethodNames, _RuntimeContext>[],
-    _FeaturesDefinition2 extends Record<_LifecycleMethodNames, new (...args: any[]) => _RuntimeContext>
-> {
-
-
-    // private steps!: _FeaturesDefinition
-
-    constructor(props: {
-        // features: _FeaturesDefinition,
-        exports: _FeaturesDefinition2
-        context: [],
-        import: any[]
-    }) {
-
-    }
-
-    // async resolve(): Promise<{
-    //     [K in _FeaturesDefinition[number]['name']]: (
-    //         context: InstanceType<
-    //             Extract<_FeaturesDefinition[number], { name: K }>['context']
-    //         >
-    //     ) => void;
-    // }> {
-    //     return {} as any
-    // }
-
-
-    async resolve2(): Promise<{
-        [K in keyof _FeaturesDefinition2]: (
-            context: InstanceType<
-                _FeaturesDefinition2[K]
-            >
-        ) => void;
-    }> {
-        return {} as any
-    }
-
-}
-
-
-class App extends Container {
-
-    server: any;
-    components: any[] = [];
-
-
-    constructor(components: any[]) {
-        super();
-        // this.server = new Server();
-
-        this.components = components;
-    }
-
-    static get Lifecycle() {
-        return {
-            onRequest: (...args: any[]) => Define('onRequest', ...args)
-        }
-    }
-
-    //  The container has a set of lifecycle methods that can be used to extend the behavior by adding new methods
-    // Define Decorator allows to create a custom lifecycle attached to the class. 
-    // So any other classes injected here will be able to use the lifecycle methods
-    @Define()
-    onRequest(request: any) {
-
-    }
-
-}
-
-class startContext {
-
-}
-
-
-
-const myConcept = new Concept(
-    {
-        exports: {
-            start: startContext
-        },
-        context: [],
-        import: [
-            // We say that concept has User Entity
-            User,
-
-            // We say that concept has an APP with CRUDController
-            new App([
-                // 
-                CRUDController,
-                // new CRUDController(),
-            ])
-        ]
-    }
-);
-
-(async () => {
-    // const target2 = await myConcept
-    //     .resolve2();
-
-
-    // target2.start()
-
-})()
-
-
-

package/src/base/A-Config/A-Config.container.ts

@@ -1,68 +0,0 @@
-import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
-import { ConfigReader } from "./components/ConfigReader.component";
-import { A_Inject } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator";
-import { A_Polyfills } from "@adaas/a-utils";
-import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-import { FileConfigReader } from "./components/FileConfigReader.component";
-import { ENVConfigReader } from "./components/ENVConfigReader.component";
-import { A_Scope } from "@adaas/a-concept/global/A-Scope/A-Scope.class";
-import { A_Concept } from "@adaas/a-concept/global/A-Concept/A_Concept.class";
-import { A_Config } from "./A-Config.context";
-import { A_TYPES__ContainerConstructor } from "@adaas/a-concept/global/A-Container/A-Container.types";
-
-
-export class A_ConfigLoader extends A_Container {
-
-    private reader!: ConfigReader
-
-
-    constructor(params:Partial<A_TYPES__ContainerConstructor<['load', 'read']>>) {
-        super({
-            ...params,
-            name:params.name || 'a-config-loader'
-        });
-    }
-
-
-    @A_Concept.Load()
-    async prepare(
-        @A_Inject(A_Config) config: A_Config,
-    ) {
-        const fs = await A_Polyfills.fs();
-
-        switch (true) {
-
-            case A_Context.environment === 'server' && !!fs.existsSync(`${A_Context.root.name}.conf.json`):
-                this.reader = this.Scope.resolve(FileConfigReader);
-                break;
-
-            case A_Context.environment === 'server': !fs.existsSync(`${A_Context.root.name}.conf.json`)
-                this.reader = this.Scope.resolve(ENVConfigReader);
-                break;
-
-            case A_Context.environment === 'browser':
-                this.reader = this.Scope.resolve(ENVConfigReader);
-                break;
-
-            default:
-                throw new Error(`Environment ${A_Context.environment} is not supported`);
-        }
-
-    }
-
-
-
-    @A_Concept.Load()
-    async readVariables(
-        @A_Inject(A_Config) config: A_Config,
-    ) {
-        await this.reader.inject(config);
-    }
-
-}
-
-
-
-
-
-const foo = new A_ConfigLoader({});

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

@@ -1,114 +0,0 @@
-import { A_CommonHelper, A_TYPES__Required } from "@adaas/a-utils";
-import { A_TYPES__ConfigContainerConstructor } from "./A-Config.types";
-import { A_Fragment } from "@adaas/a-concept/global/A-Fragment/A-Fragment.class";
-import { A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY, A_TYPES__ConceptENVVariables } from "@adaas/a-concept/constants/env.constants";
-
-
-export class A_Config<
-    T extends Array<string | A_TYPES__ConceptENVVariables[number]> = any[]
-> extends A_Fragment {
-
-    config: A_TYPES__ConfigContainerConstructor<T>;
-
-
-    private VARIABLES: Map<T[number], any> = new Map<T[number], any>();
-
-    CONFIG_PROPERTIES!: T;
-
-    protected DEFAULT_ALLOWED_TO_READ_PROPERTIES = A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY;
-
-
-    constructor(
-        config: Partial<A_TYPES__ConfigContainerConstructor<T>>
-    ) {
-        super(config);
-
-        this.config = A_CommonHelper.deepCloneAndMerge<A_TYPES__ConfigContainerConstructor<T>>(config as any, {
-            name: this.name,
-            strict: false,
-            defaults: {},
-            variables: A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY as any as T
-        });
-
-        this.CONFIG_PROPERTIES = this.config.variables ? this.config.variables : [] as any as T;
-
-        this.config.variables.forEach((variable) => {
-            this.VARIABLES.set(
-                A_CommonHelper.toUpperSnakeCase(variable),
-                this.config.defaults[variable]
-            );
-        });
-    }
-
-
-    /** 
-     * This method is used to get the configuration property by name
-     * 
-     * @param property 
-     * @returns 
-     */
-    get<_OutType = any>(
-        property: T[number] | typeof this.DEFAULT_ALLOWED_TO_READ_PROPERTIES[number]
-    ): _OutType {
-        if (this.CONFIG_PROPERTIES.includes(property as any)
-            || this.DEFAULT_ALLOWED_TO_READ_PROPERTIES.includes(property as any)
-            || !(this.config.strict)
-        )
-            return this.VARIABLES.get(A_CommonHelper.toUpperSnakeCase(property)) as _OutType;
-
-        throw new Error('Property not exists or not allowed to read') as never;
-        // return this.concept.Errors.throw(A_SDK_CONSTANTS__ERROR_CODES.CONFIGURATION_PROPERTY_NOT_EXISTS_OR_NOT_ALLOWED_TO_READ) as never;
-    }
-
-
-
-    /**
-     * 
-     * This method is used to set the configuration property by name
-     * OR set multiple properties at once by passing an array of objects
-     * 
-     * @param variables 
-     */
-    set(
-        variables: Array<{
-            property: T[number] | A_TYPES__ConceptENVVariables[number],
-            value: any
-        }>
-    )
-    set(
-        variables: Partial<Record<T[number] | A_TYPES__ConceptENVVariables[number], any>>
-    )
-    set(
-        property: T[number] | A_TYPES__ConceptENVVariables[number],
-        value: any
-    )
-    set(
-        property: T[number] | A_TYPES__ConceptENVVariables[number] | Array<{
-            property: T[number] | A_TYPES__ConceptENVVariables[number],
-            value: any
-        }> | Partial<Record<T[number] | A_TYPES__ConceptENVVariables[number], any>>,
-        value?: any
-    ) {
-        const array = Array.isArray(property)
-            ? property
-            : typeof property === 'string'
-                ? [{ property, value }]
-                : Object
-                    .keys(property)
-                    .map((key) => ({
-                        property: key,
-                        value: property[key]
-                    }));
-
-        for (const { property, value } of array) {
-
-            let targetValue = value
-                ? value
-                : this.config?.defaults
-                    ? this.config.defaults[property as T[number]]
-                    : undefined;
-
-            this.VARIABLES.set(A_CommonHelper.toUpperSnakeCase(property), targetValue);
-        }
-    }
-}

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

@@ -1,28 +0,0 @@
-import { A_TYPES__ConceptENVVariables } from "@adaas/a-concept/constants/env.constants";
-import { A_TYPES__FragmentConstructor } from "@adaas/a-concept/global/A-Fragment/A-Fragment.types";
-
-
-export enum A_TYPES__ConfigFeature {
-
-}
-
-
-export type A_TYPES__ConfigContainerConstructor<T extends  Array<string | A_TYPES__ConceptENVVariables[number]>> = {
-
-    /**
-     * If set to true, the SDK will throw an error if the variable is not defined OR not presented in the defaults
-     */
-    strict: boolean
-
-    /**
-     * Allows to define the names of variable to be loaded
-     */
-    variables: T
-
-    /**
-     * Allows to set the default values for the variables
-     */
-    defaults: {
-        [key in T[number]]?: any
-    }
-} & A_TYPES__FragmentConstructor;

package/src/base/A-Config/components/ConfigReader.component.ts

@@ -1,68 +0,0 @@
-import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-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_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
-import { A_Config } from "../A-Config.context";
-import { A_Concept } from "@adaas/a-concept/global/A-Concept/A_Concept.class";
-import { A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY } from "@adaas/a-concept/constants/env.constants";
-
-/**
- * Config Reader
- */
-export class ConfigReader extends A_Component {
-
-    constructor(
-        @A_Inject(A_Scope) protected scope: A_Scope
-    ) {
-        super();
-    }
-
-
-    @A_Concept.Load()
-    async inject(
-        @A_Inject(A_Config) config: A_Config,
-    ) {
-
-        const data = await this.read([
-            ...config.CONFIG_PROPERTIES,
-            ...A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY
-        ]);
-
-        config.set(data);
-
-        const rootDir = await this.getProjectRoot();
-
-        config.set('A_CONCEPT_ROOT_FOLDER', rootDir);
-    }
-
-
-    /**
-     * Get the configuration property by Name
-     * @param property 
-     */
-    resolve<_ReturnType = any>(property: string): _ReturnType {
-        return property as _ReturnType;
-    }
-
-    /**
-     * This method reads the configuration and sets the values to the context
-     * 
-     * @returns 
-     */
-    async read<T extends string>(
-        variables: Array<T> = []
-    ): Promise<Record<T, any>> {
-        return {} as Record<T, any>;
-    }
-
-
-    /**
-     * Finds the root directory of the project by locating the folder containing package.json
-     * 
-     * @param {string} startPath - The initial directory to start searching from (default is __dirname)
-     * @returns {string|null} - The path to the root directory or null if package.json is not found
-     */
-    protected async getProjectRoot(startPath = __dirname) {
-        return process.cwd();
-    }
-}

package/src/base/A-Config/components/ENVConfigReader.component.ts

@@ -1,31 +0,0 @@
-import { A_CommonHelper } from "@adaas/a-utils";
-import { ConfigReader } from "./ConfigReader.component";
-
-
-export class ENVConfigReader extends ConfigReader {
-
-
-    /**
-     * Get the configuration property Name 
-     * @param property 
-     */
-    getConfigurationProperty_ENV_Alias(property: string): string {
-        return A_CommonHelper.toUpperSnakeCase(property);
-    }
-
-
-    resolve<_ReturnType = any>(property: string): _ReturnType {
-        return process.env[this.getConfigurationProperty_ENV_Alias(property)] as _ReturnType;
-    }
-
-
-    async read<T extends string>(variables: Array<T> = []): Promise<Record<T, any>> {
-        const config: Record<T, any> = {} as Record<T, any>;
-
-        variables.forEach(variable => {
-            config[variable] = this.resolve(variable);
-        });
-
-        return config;
-    }
-} 

package/src/base/A-Config/components/FileConfigReader.component.ts

@@ -1,41 +0,0 @@
-import { A_CommonHelper, A_Polyfills } from "@adaas/a-utils";
-import { ConfigReader } from "./ConfigReader.component";
-import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-
-export class FileConfigReader extends ConfigReader {
-
-    private FileData: Map<string, any> = new Map<string, any>();
-
-    /**
-     * Get the configuration property Name
-     * @param property 
-     */
-    getConfigurationProperty_File_Alias(property: string): string {
-        return A_CommonHelper.toCamelCase(property);
-    }
-
-
-    resolve<_ReturnType = any>(property: string): _ReturnType {
-        return this.FileData.get(this.getConfigurationProperty_File_Alias(property)) as _ReturnType;
-    }
-
-
-    async read<T extends string>(
-        variables?: Array<T>
-    ): Promise<Record<T, any>> {
-        const fs = await A_Polyfills.fs();
-        try {
-            const data = fs.readFileSync(`${A_Context.root.name}.conf.json`, 'utf8');
-
-            const config: Record<T, any> = JSON.parse(data);
-
-            this.FileData = new Map(Object.entries(config));
-
-            return config;
-
-        } catch (error) {
-            // this.context.Logger.error(error);
-            return {} as Record<T, any>;
-        }
-    }
-}

package/src/base/A-Errors/A-Error.entity.ts

@@ -1,10 +0,0 @@
-import { A_Entity } from "@adaas/a-concept/global/A-Entity/A-Entity.class";
-
-
-
-export class A_Error extends A_Entity {
-
-
-
-
-}