@adaas/a-concept 0.0.64 → 0.1.2

package/src/global/A-Command/context/A_Command.context.ts

@@ -1,114 +0,0 @@
-import { A_Fragment } from "@adaas/a-concept/global/A-Fragment/A-Fragment.class";
-import { A_Error } from "@adaas/a-utils";
-
-
-export class A_CommandContext<
-    T extends Record<string, any> = Record<string, any>
-> extends A_Fragment {
-
-
-    /**
-     * Internal storage of all intermediate values
-     */
-    protected _memory: Map<keyof T, T[keyof T]>;
-    /**
-     * Errors encountered during the execution
-     */
-    protected _errors: Set<A_Error>;
-
-
-
-    /**
-     * ExecutionContext for the A-Command
-     * 
-     */
-    constructor(initialValues: T = {} as T) {
-        super();
-        this._memory = new Map(Object.entries(initialValues));
-        this._errors = new Set();
-    }
-
-
-    get Errors(): Set<A_Error> | undefined {
-        return this._errors.size > 0 ? this._errors : undefined;
-    }
-
-
-    /**
-     * Verifies that all required keys are present in the proxy values
-     * 
-     * @param requiredKeys 
-     * @returns 
-     */
-    verifyPrerequisites(
-        requiredKeys: Array<keyof T>
-    ): boolean {
-        return requiredKeys.every(key => this._memory.has(key));
-    }
-
-    /**
-     * Adds an error to the context
-     * 
-     * @param error 
-     */
-    error(error: A_Error): void {
-        this._errors.add(error);
-    }
-
-    /**
-     * Saves a value in the context memory
-     * 
-     * @param key 
-     * @param value 
-     */
-    save<K extends keyof T>(
-        /**
-         * Key to save the value under
-         */
-        key: K,
-        /**
-         * Value to save
-         */
-        value: T[K]
-    ): void {
-        this._memory.set(key, value);
-    }
-
-
-    /**
-     * Removes a value from the context memory by key
-     * 
-     * @param key 
-     */
-    drop(key: keyof T): void {
-        this._memory.delete(key);
-    }
-
-    /**
-     * Clears all stored values in the context memory
-     */
-    clear(): void {
-        this._memory.clear();
-    }
-
-
-    /**
-     * Converts all stored values to a plain object
-     * 
-     * [!] By default uses all saved in memory values 
-     * 
-     * @returns 
-     */
-    toJSON(): Record<string, any> {
-        const obj: Record<string, any> = {};
-
-        this._memory.forEach((value, key) => {
-            obj[key as string] =
-                typeof value === 'object' && value !== null && 'toJSON' in value && typeof value.toJSON === 'function'
-                    ? value.toJSON()
-                    : value;
-        })
-
-        return obj;
-    }
-}

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

@@ -1,298 +0,0 @@
-import { A_TYPES__ConceptStage, A_TYPES__IConceptConstructor } from "./A_Concept.types";
-import { A_Container } from "../A-Container/A-Container.class";
-import { A_Abstraction } from "../A-Abstraction/A-Abstraction.class";
-import { A_ConceptMeta } from "./A_Concept.meta";
-import { A_Abstraction_Extend } from "@adaas/a-concept/decorators/A-Abstraction/A-Abstraction-Extend.decorator";
-import { A_Scope } from "../A-Scope/A-Scope.class";
-import { A_Context } from "../A-Context/A-Context.class";
-
-
-/**
- * A_Concept is a placeholder for the concept of the ani program.
- * 
- * Concept - could be any Program regardless environment and it's goal.
- * It could be mobile, web or simple html page.
- * All depends on Containers and Components installed and provided in the Concept.
- * 
- * 
- * [!] Concept operates ONLY with all Components and Containers provided to achieve the goal.
- * 
- * 
- */
-export class A_Concept<
-    _Imports extends A_Container[] = A_Container[]
-> {
-
-    // ==============================================================================
-    // ====================  STATIC LIFECYCLE DECORATORS  ===========================
-    // ==============================================================================
-    /**
-     * Load the concept. This step runs before any other steps to ensure that all components are loaded.
-     */
-    static Load(): ReturnType<typeof A_Abstraction_Extend> {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Load);
-    }
-
-    /**
-     * Publish the concept to ADAAS platform. (Or any other place defined in the concept)
-     *
-     * [!] To extend the logic just create a custom containers and override the default behavior.
-     */
-    static Publish(): ReturnType<typeof A_Abstraction_Extend> {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Publish);
-    }
-
-    /**
-     * Deploy the concept to the environment.
-     */
-    static Deploy() {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Deploy);
-    }
-
-    /**
-     * Compiles the Concept in case there are some containers that require that. 
-     * 
-     * Can be used for static websites or any other concept that requires a build step.
-     * 
-     */
-    static Build() {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Build);
-    }
-
-    /**
-     *  Main execution of the concept.
-     */
-    static Run() {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Run);
-    }
-
-    /**
-     *  Start the concept. Uses for servers or any other background services.
-     */
-    static Start() {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Start);
-    }
-
-    /**
-     * Stop the concept. Uses for servers or any other background services.
-     */
-    static Stop() {
-        return A_Abstraction.Extend(A_TYPES__ConceptStage.Stop);
-    }
-
-
-    private meta!: A_ConceptMeta
-    private _name!: string;
-
-
-
-    // ==============================================================================
-    // ==========================  MAIN Methods  ======================================
-    // ==============================================================================
-
-    protected containers!: A_Container[];
-
-    constructor(
-        protected props: A_TYPES__IConceptConstructor<_Imports>
-    ) {
-        this._name = props.name || A_Context.root.name;
-
-        if (props.components && props.components.length)
-            props.components.forEach(component => this.Scope.register(component))
-
-        if (props.fragments && props.fragments.length)
-            props.fragments.forEach(fragment => this.Scope.register(fragment))
-
-        if (props.entities && props.entities.length)
-            props.entities.forEach(entity => this.Scope.register(entity))
-
-        if (props.commands && props.commands.length)
-            props.commands.forEach(command => this.Scope.register(command))
-
-        this.containers = props.containers || [];
-    }
-
-
-    get namespace() {
-        return A_Context.root.name;
-    }
-
-    get Scope() {
-        return A_Context.root;
-    }
-
-    /**
-     * Register a class or value in the concept scope.
-     */
-    get register(): A_Scope['register'] {
-        return this.Scope.register.bind(this.Scope);
-    }
-
-    /**
-     * Resolve a class or value from the concept scope.
-     */
-    get resolve(): A_Scope['resolve'] {
-        return this.Scope.resolve.bind(this.Scope);
-    }
-
-
-    // =======================================================================
-    // ==========================  LIFECYCLE  ================================
-    // =======================================================================
-
-
-    /**
-     * Load the concept.
-     */
-    async load(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Load, scope);
-
-        await abstraction.process();
-    }
-
-
-
-    /**
-     * Run the concept.
-     */
-    async run(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Run, scope);
-
-        await abstraction.process();
-    }
-
-
-    /**
-     * Start the concept.
-     * 
-     * @param params 
-     */
-    async start(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Start, scope);
-
-        await abstraction.process();
-    }
-
-
-    /**
-     * Stop the concept.
-     * 
-     * @param params 
-     */
-    async stop(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Stop, scope);
-
-        await abstraction.process();
-    }
-
-
-    /**
-     * Build the concept.
-     */
-    async build(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Build, scope);
-
-        await abstraction.process();
-    }
-
-
-    /**
-     * Deploy the concept.
-     */
-    async deploy(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Deploy, scope);
-
-        await abstraction.process();
-
-    }
-
-
-    /**
-     * Publish the concept.
-     */
-    async publish(
-        scope?: A_Scope,
-    ) {
-        scope = scope ? scope.inherit(this.Scope) : this.Scope;
-
-        const abstraction = this.abstraction(A_TYPES__ConceptStage.Publish, scope);
-
-        await abstraction.process();
-    }
-
-
-    // =======================================================================
-    // ==========================  CALL  =====================================
-    // =======================================================================
-
-
-    /**
-     * Call the specific method of the concept or included modules.
-     */
-    async call<
-        K extends Record<_Imports[number]['name'], string>
-    >(
-        container: K[keyof K],
-    ) {
-        // const definition = this.meta.abstractionDefinition(A_TYPES__ConceptStage.Run, {
-        //     components: params?.components,
-        //     fragments: params?.fragments,
-        // });
-
-        // const feature = new A_Feature(definition);
-
-        // await feature.process();
-    }
-
-
-
-    protected abstraction(
-        method: A_TYPES__ConceptStage,
-        scope: A_Scope
-    ): A_Abstraction {
-
-        const featureDefinitions = this.containers.map(container => {
-            const definition = A_Context.abstractionDefinition(container, method, container.Scope);
-
-            return {
-                ...definition,
-                steps: definition.steps.map(step => ({ ...step, component: step.component ? step.component : container }))
-            }
-        });
-
-        const definition = {
-            name: `${this.namespace}.${method}`,
-            features: featureDefinitions,
-            scope
-        };
-
-        return new A_Abstraction(definition);
-    }
-}
-
-
-

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

@@ -1,32 +0,0 @@
-
-import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
-import { A_Meta } from "../A-Meta/A-Meta.class";
-import { A_TYPES__Required } from "@adaas/a-utils";
-import { A_TYPES__ConceptAbstractionCallParams, A_TYPES__ConceptStage } from "./A_Concept.types";
-import { A_TYPES__FeatureConstructor } from "../A-Feature/A-Feature.types";
-import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types";
-import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
-import { A_TYPES__A_FeatureDecoratorConfig } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
-import { A_TYPES__A_AbstractionConstructor } from "../A-Abstraction/A-Abstraction.types";
-import { A_Abstraction } from "../A-Abstraction/A-Abstraction.class";
-import { A_Scope } from "../A-Scope/A-Scope.class";
-import { A_Concept } from "./A_Concept.class";
-// import { A_TYPES__ComponentMeta } from "./A-Component.types";
-
-
-export class A_ConceptMeta extends A_Meta<any> {
-
-
-    constructor(
-        private containers: Array<A_Container>,
-    ) {
-        super();
-    }
-
-  
-
-
-
-  
-
-}

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

@@ -1,143 +0,0 @@
-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";
-import { A_Command } from "../A-Command/A-Command.class";
-
-
-export enum A_TYPES__ConceptStage {
-    Run = 'run',
-    Build = 'build',
-    Publish = 'publish',
-    Deploy = 'deploy',
-    Load = 'load',
-    Start = 'start',
-    Stop = 'stop',
-}
-
-
-// export type A_TYPES__ConceptMeta = {
-//     [A_TYPES__ConceptMetaKey.EXTENSIONS]: Map<string, A_TYPES__ConceptMeta_ExtensionItem>,
-//     [A_TYPES__ConceptMetaKey.FEATURES]: any[],
-//     // [A_TYPES__ConceptMetaKey.INJECTIONS]: Map<
-//     //     // Where key is method name
-//     //     Symbol | string,
-//     //     // And value is Injection instructions
-//     //     A_TYPES__ConceptMeta_InjectionParams
-//     // >
-
-// }
-
-export enum A_TYPES__ConceptMetaKey {
-    LIFECYCLE = 'a-component-extensions',
-}
-
-
-export interface A_TYPES__IConceptConstructor<
-    T extends Array<A_Container>
-> {
-    name?: string,
-
-    /**
-     * A set of Context Fragments to register globally for the concept.
-     * These fragments will be available in the global context.
-     * 
-     */
-    fragments?: Array<A_Fragment>,
-
-
-    /**
-     * A set of Containers that the concept depends on. 
-     * These containers will create a new Container for the concept.
-     */
-    containers?: T,
-
-
-    /**
-     * A set of Entities that the concept can use. 
-     * These components will be used in the concept.
-     */
-    entities?: Array<A_Entity>
-
-
-    /**
-     * A set of Components available for all containers and fragments in the concept. 
-     * These components will be registered in the root scope of the concept.
-     * 
-     * [!] Note that these components will be available in all containers and fragments in the concept.
-     */
-    components?: Array<{ new(...args: any[]): A_Component }>
-
-
-    /**
-     * A set of Commands available for all containers and fragments in the concept. 
-     * These commands will be registered in the root scope of the concept.
-     * 
-     * [!] Note that these commands will be available in all containers and fragments in the concept.
-     */
-    commands?: Array<{ new(...args: any[]): A_Command }>
-}
-
-
-/**
- * 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
-
-
-
-
-
-// =======================================================================
-// =======================================================================
-// ===================== A CONCEPT LIFE CYCLE ============================
-// =======================================================================
-// =======================================================================
-
-export type A_TYPES__ConceptAbstractionCallParams = {
-    fragments: Array<A_Fragment>,
-    components: Array<{ new(...args: any[]): A_Component }>,
-    entities: Array<A_Entity>
-}
-
-
-export type A_TYPES__ConceptCallParams<T extends string> = {
-    name: T,
-    fragments: Array<A_Fragment>,
-    components: Array<{ new(...args: any[]): A_Component }>,
-    entities: Array<{ new(...args: any[]): A_Entity }>
-}
-
-
-

package/src/global/A-Feature/A-FeatureCaller.class.ts

@@ -1,38 +0,0 @@
-import { A_Command } from "../A-Command/A-Command.class";
-import { A_Component } from "../A-Component/A-Component.class";
-import { A_Container } from "../A-Container/A-Container.class";
-import { A_Feature } from "./A-Feature.class";
-
-
-
-/**
- * This is a common class that uses to return an entity that initiates a feature call
- * 
- * It can be used then in @A_Inject(A_FeatureCaller) to get the entity that initiated the feature call
- * 
- * [!] the class itself may be retrieved, but may require additional processing inside the feature
- * 
- */
-export class A_FeatureCaller {
-
-
-    protected _component: A_Component | A_Feature | A_Container | A_Command;
-
-    constructor(
-        component: A_Component | A_Feature | A_Container | A_Command
-    ) {
-        this._component = component;
-    }
-
-
-    /**
-     * Resolves the component that initiated the feature call
-     * 
-     * @returns 
-     */
-    resolve(): A_Component | A_Feature | A_Container | A_Command {
-        return this._component;
-    }
-
-
-}

package/src/global/A-Scope/A-Scope.constants.ts

@@ -1,9 +0,0 @@
-import { A_TYPES__ScopeConstructor } from "./A-Scope.types";
-
-export const A_CONSTANTS__DEFAULT_SCOPE_CREATION_PARAMS: A_TYPES__ScopeConstructor = {
-    name: '',
-    components: [],
-    fragments: [],
-    entities: [],
-    commands: [],
-};

package/src/types/A_Module.types.ts

@@ -1,23 +0,0 @@
-export enum A_TYPES__ModuleState {
-    INIT = 'INIT',
-    LOADING = 'LOADING',
-    READY = 'READY',
-    FAILED = 'FAILED'
-}
-
-export enum A_TYPES__ModuleTypes {
-    /**
-     * Custom module type allows additional external control over the module
-     */
-    CUSTOM = 'CUSTOM',
-
-    /**
-     * Default module type is a module that is used by default and has no additional control.
-     */
-    DEFAULT = 'DEFAULT'
-}
-
-
-export type A_TYPES__ModuleConstructor = {
-  
-}