@quadnix/octo 0.0.21 → 0.0.23

package/dist/modules/module.container.js

@@ -5,124 +5,177 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { Factory } from '../decorators/factory.decorator.js';
-import { ModuleEvent } from '../events/module.event.js';
+import { InputRegistrationError, ModuleError } from '../errors/index.js';
+import { ModuleEvent } from '../events/index.js';
+import { Container } from '../functions/container/container.js';
 import { CommitHook } from '../functions/hook/commit.hook.js';
 import { ModelActionHook } from '../functions/hook/model-action.hook.js';
 import { ResourceActionHook } from '../functions/hook/resource-action.hook.js';
+import { getSchemaInstance, getSchemaKeys } from '../functions/schema/schema.js';
+import { OverlayDataRepository } from '../overlays/overlay-data.repository.js';
+import { AOverlay } from '../overlays/overlay.abstract.js';
 import { EventService } from '../services/event/event.service.js';
+import { InputService } from '../services/input/input.service.js';
 export class ModuleContainer {
-    constructor(commitHook, modelActionHook, resourceActionHook) {
-        this.commitHook = commitHook;
-        this.modelActionHook = modelActionHook;
-        this.resourceActionHook = resourceActionHook;
+    constructor(eventService, inputService, overlayDataRepository) {
+        this.eventService = eventService;
+        this.inputService = inputService;
+        this.overlayDataRepository = overlayDataRepository;
         this.modules = [];
-        this.outputs = {};
     }
     async apply() {
+        const result = {};
         for (const moduleMetadata of this.modules) {
-            this.setApplyOrder(moduleMetadata);
-        }
-        this.modules.sort((a, b) => a.applyOrder - b.applyOrder);
-        for (const moduleMetadata of this.modules) {
-            if (moduleMetadata.applied || moduleMetadata.hidden) {
+            if (moduleMetadata.hidden) {
                 continue;
             }
-            const { module, properties } = moduleMetadata;
-            this.commitHook.collectHooks([moduleMetadata]);
-            this.modelActionHook.collectHooks([moduleMetadata]);
-            this.resourceActionHook.collectHooks([moduleMetadata]);
-            const args = (properties.imports || []).reduce((accumulator, importedModule) => {
-                const name = typeof importedModule === 'string' ? importedModule : importedModule.name;
-                if (name in this.outputs) {
-                    accumulator.push(this.outputs[name]);
+            const { instances, module } = moduleMetadata;
+            for (const i of instances) {
+                if (i.applied) {
+                    continue;
                 }
-                return accumulator;
-            }, []);
-            for (const [i, { isArg, name }] of (properties.args || []).entries()) {
-                if (!isArg(args[i])) {
-                    // eslint-disable-next-line max-len
-                    const message = `Module "${module.name}" requires an argument at position [${i}] of type "${name}", but received "${typeof args[i]}"!`;
-                    throw new Error(message);
+                // Given a list of keys to the module, resolve the inputs with actual values.
+                const resolvedModuleInputs = i.inputKeys.reduce((accumulator, current) => {
+                    accumulator[current] = this.inputService.resolve(`${i.moduleId}.input.${current}`);
+                    return accumulator;
+                }, {});
+                // Create an instance of module schema based on the resolved input values.
+                // An error will be thrown if the resolved input does not match the module schema.
+                const resolvedModuleSchema = getSchemaInstance(module.MODULE_SCHEMA, resolvedModuleInputs);
+                // Re-register module inputs. This now includes all the optional properties that were not provided in inputs.
+                for (const [key, value] of Object.entries(resolvedModuleSchema)) {
+                    try {
+                        this.inputService.registerInput(i.moduleId, key, value);
+                    }
+                    catch (error) {
+                        if (!(error instanceof InputRegistrationError)) {
+                            throw error;
+                        }
+                    }
                 }
+                // Create new module instance.
+                const instance = new module(i.moduleId);
+                // Register module hooks.
+                this.registerHooks(instance.registerHooks());
+                // Register module metadata.
+                const metadata = await instance.registerMetadata(resolvedModuleSchema);
+                for (const [key, value] of Object.entries(metadata)) {
+                    this.inputService.registerMetadata(i.moduleId, key, value);
+                }
+                // Run module. Register module output, and return the module output.
+                let models = (await instance.onInit(resolvedModuleSchema));
+                if (!Array.isArray(models)) {
+                    models = [models];
+                }
+                // Register module outputs.
+                for (const model of models) {
+                    if (model instanceof AOverlay) {
+                        this.overlayDataRepository.add(model);
+                        this.inputService.registerOverlay(i.moduleId, model);
+                        result[`${i.moduleId}.overlay.${model.overlayId}`] = model;
+                    }
+                    else {
+                        this.inputService.registerModel(i.moduleId, model);
+                        result[`${i.moduleId}.model.${model.constructor.NODE_NAME}`] = model;
+                    }
+                }
+                // Register module.
+                this.inputService.registerModule(i.moduleId, instance);
+                i.applied = true;
             }
-            const instance = new module(...args);
-            const output = await instance.onInit();
-            if (output) {
-                this.outputs[module.name] = output;
-            }
-            moduleMetadata.applied = true;
-            EventService.getInstance().emit(new ModuleEvent(module.name));
+            this.eventService.emit(new ModuleEvent(module.name));
         }
+        return result;
     }
-    getModuleMetadata(module) {
-        const index = this.getModuleMetadataIndex(module);
+    getMetadata(module) {
+        const index = this.getMetadataIndex(module);
         return index === -1 ? undefined : this.modules[index];
     }
-    getModuleMetadataIndex(module) {
-        const name = typeof module === 'string' ? module : module.name;
-        return this.modules.findIndex((m) => m.module.name === name);
+    getMetadataIndex(module) {
+        const moduleName = typeof module === 'string' ? module : `${module.MODULE_PACKAGE}/${module.name}`;
+        return this.modules.findIndex((m) => `${m.properties.packageName}/${m.module.name}` === moduleName);
     }
-    getOutput(module) {
-        const name = typeof module === 'string' ? module : module.name;
-        return name in this.outputs ? this.outputs[name] : undefined;
+    getModuleInstanceInputKeys(moduleId) {
+        const moduleIndex = this.modules.findIndex((m) => m.instances.findIndex((i) => i.moduleId === moduleId) !== -1);
+        if (moduleIndex === -1) {
+            throw new ModuleError(`Module "${moduleId}" not yet loaded!`, moduleId);
+        }
+        return this.modules[moduleIndex].instances.find((i) => i.moduleId === moduleId).inputKeys;
     }
-    load(module) {
-        const m = this.getModuleMetadata(module);
-        if (m) {
-            m.hidden = false;
+    load(module, moduleId, inputs) {
+        const moduleName = typeof module === 'string' ? module : `${module.MODULE_PACKAGE}/${module.name}`;
+        const m = this.getMetadata(module);
+        if (!m) {
+            throw new ModuleError(`Module "${moduleName}" not yet registered!`, moduleName);
+        }
+        m.hidden = false;
+        if (m.instances.findIndex((i) => i.moduleId === moduleId) !== -1) {
+            return;
+        }
+        m.instances.push({
+            applied: false,
+            inputKeys: getSchemaKeys(module.MODULE_SCHEMA),
+            moduleId,
+        });
+        for (const [key, value] of Object.entries(inputs)) {
+            this.inputService.registerInput(moduleId, key, JSON.parse(JSON.stringify(value)));
         }
     }
+    order(modules) {
+        this.modules.sort((a, b) => {
+            const aIndex = modules.findIndex((m) => {
+                const moduleName = typeof m === 'string' ? m : `${m.MODULE_PACKAGE}/${m.name}`;
+                return `${a.properties.packageName}/${a.module.name}` === moduleName;
+            });
+            const bIndex = modules.findIndex((m) => {
+                const moduleName = typeof m === 'string' ? m : `${m.MODULE_PACKAGE}/${m.name}`;
+                return `${b.properties.packageName}/${b.module.name}` === moduleName;
+            });
+            return aIndex - bIndex;
+        });
+    }
     register(module, properties) {
-        if (!this.modules.some((m) => m.module.name === module.name)) {
-            this.modules.push({ applied: false, applyOrder: -1, hidden: true, module, properties });
+        const moduleName = `${module.MODULE_PACKAGE}/${module.name}`;
+        if (!this.modules.some((m) => `${m.properties.packageName}/${m.module.name}` === moduleName)) {
+            this.modules.push({ hidden: true, instances: [], module, properties });
         }
     }
-    reset() {
-        this.commitHook.reset();
-        this.modelActionHook.reset();
-        this.resourceActionHook.reset();
-        for (const name in this.outputs) {
-            delete this.outputs[name];
-        }
-        this.modules.map((m) => {
-            m.applied = false;
-            m.applyOrder = -1;
-            m.hidden = true;
+    registerHooks({ postCommitHooks, postModelActionHooks, postResourceActionHooks, preCommitHooks, preModelActionHooks, preResourceActionHooks, } = {}) {
+        CommitHook.getInstance().collectHooks({ postHooks: postCommitHooks, preHooks: preCommitHooks });
+        ModelActionHook.getInstance().collectHooks({
+            postHooks: postModelActionHooks,
+            preHooks: preModelActionHooks,
+        });
+        ResourceActionHook.getInstance().collectHooks({
+            postHooks: postResourceActionHooks,
+            preHooks: preResourceActionHooks,
         });
     }
-    setApplyOrder(moduleMetadata, seen = []) {
-        if (moduleMetadata.applyOrder >= 0) {
-            return;
-        }
-        if (seen.find((m) => m.name === moduleMetadata.module.name)) {
-            throw new Error('Found circular dependencies in modules!');
-        }
-        const parentModuleApplyOrders = [-1];
-        for (const parent of moduleMetadata.properties.imports || []) {
-            const name = typeof parent === 'string' ? parent : parent.name;
-            const parentModuleMetadata = this.modules.find((m) => m.module.name === name);
-            if (!parentModuleMetadata) {
-                throw new Error(`Found unregistered module "${name}" while processing modules!`);
-            }
-            this.setApplyOrder(parentModuleMetadata, [...seen, parentModuleMetadata.module]);
-            parentModuleApplyOrders.push(parentModuleMetadata.applyOrder);
+    reset() {
+        for (const m of this.modules) {
+            m.hidden = true;
+            m.instances = [];
         }
-        moduleMetadata.applyOrder = Math.max(...parentModuleApplyOrders) + 1;
     }
     unload(module) {
-        const m = this.getModuleMetadata(module);
+        const m = this.getMetadata(module);
         if (m) {
             m.hidden = true;
         }
     }
 }
 let ModuleContainerFactory = class ModuleContainerFactory {
-    static async create() {
+    static async create(forceNew = false) {
+        const [eventService, inputService, overlayDataRepository] = await Promise.all([
+            Container.getInstance().get(EventService),
+            Container.getInstance().get(InputService),
+            Container.getInstance().get(OverlayDataRepository),
+        ]);
         if (!this.instance) {
-            const commitHook = CommitHook.getInstance();
-            const modelActionHook = ModelActionHook.getInstance();
-            const resourceActionHook = ResourceActionHook.getInstance();
-            this.instance = new ModuleContainer(commitHook, modelActionHook, resourceActionHook);
+            this.instance = new ModuleContainer(eventService, inputService, overlayDataRepository);
+        }
+        if (forceNew) {
+            this.instance.reset();
         }
         return this.instance;
     }

package/dist/modules/module.container.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.container.js","sourceRoot":"","sources":["../../src/modules/module.container.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"module.container.js","sourceRoot":"","sources":["../../src/modules/module.container.ts"],"names":[],"mappings":"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"}

package/dist/modules/module.interface.d.ts

@@ -1,3 +1,16 @@
-export interface IModule<T> {
-    onInit(): Promise<T>;
+import type { UnknownModel } from '../app.type.js';
+import type { CommitHook } from '../functions/hook/commit.hook.js';
+import type { ModelActionHook } from '../functions/hook/model-action.hook.js';
+import type { ResourceActionHook } from '../functions/hook/resource-action.hook.js';
+export interface IModule<S, T extends UnknownModel> {
+    onInit(inputs: S): Promise<T | UnknownModel[]>;
+    registerHooks(): {
+        postCommitHooks?: Parameters<CommitHook['collectHooks']>[0]['postHooks'];
+        postModelActionHooks?: Parameters<ModelActionHook['collectHooks']>[0]['postHooks'];
+        postResourceActionHooks?: Parameters<ResourceActionHook['collectHooks']>[0]['postHooks'];
+        preCommitHooks?: Parameters<CommitHook['collectHooks']>[0]['preHooks'];
+        preModelActionHooks?: Parameters<ModelActionHook['collectHooks']>[0]['preHooks'];
+        preResourceActionHooks?: Parameters<ResourceActionHook['collectHooks']>[0]['preHooks'];
+    };
+    registerMetadata(inputs: S): Promise<Record<string, unknown>>;
 }

package/dist/modules/test-module.container.d.ts

@@ -1,29 +1,47 @@
-import type { Constructable } from '../app.type.js';
-import type { Module } from '../decorators/module.decorator.js';
+import type { Constructable, ModuleOutput, ModuleSchemaInputs, UnknownAnchor, UnknownModel, UnknownModule } from '../app.type.js';
 import type { DiffMetadata } from '../functions/diff/diff-metadata.js';
 import { Octo } from '../main.js';
 import type { App } from '../models/app/app.model.js';
+import type { BaseAnchorSchema } from '../overlays/anchor.schema.js';
+import type { BaseResourceSchema } from '../resources/resource.schema.js';
 import type { IStateProvider } from '../services/state-management/state-provider.interface.js';
-import type { IModule } from './module.interface.js';
+import { create } from '../utilities/test-helpers/test-models.js';
+import { createTestOverlays } from '../utilities/test-helpers/test-overlays.js';
+import { createResources, createTestResources } from '../utilities/test-helpers/test-resources.js';
+export type TestModule<M extends UnknownModule> = {
+    hidden?: boolean;
+    inputs: ModuleSchemaInputs<M>;
+    moduleId: string;
+    type: Constructable<M>;
+};
 export declare class TestModuleContainer {
-    private readonly captures;
-    private readonly inputs;
     readonly octo: Octo;
-    constructor({ inputs, captures, }?: {
-        captures?: TestModuleContainer['captures'];
-        inputs?: TestModuleContainer['inputs'];
-    });
-    commit(app: App): Promise<{
+    constructor();
+    commit(app: App, { enableResourceCapture, filterByModuleIds, }?: {
+        enableResourceCapture?: boolean;
+        filterByModuleIds?: string[];
+    }): Promise<{
         modelDiffs: DiffMetadata[][];
         modelTransaction: DiffMetadata[][];
         resourceDiffs: DiffMetadata[][];
         resourceTransaction: DiffMetadata[][];
     }>;
+    createTestAnchor<S extends BaseAnchorSchema & {
+        parentInstance: UnknownModel;
+    }>(anchorId: string, properties: S['properties'], parent: S['parentInstance']): UnknownAnchor;
+    createTestModels(moduleId: string, args: Parameters<typeof create>[0]): Promise<ReturnType<typeof create>>;
+    createTestOverlays(moduleId: string, args: Parameters<typeof createTestOverlays>[0]): Promise<ReturnType<typeof createTestOverlays>>;
+    createResources(moduleId: string, args: Parameters<typeof createResources>[0], options?: Parameters<typeof createResources>[1]): Promise<ReturnType<typeof createResources>>;
+    createTestResources<S extends BaseResourceSchema[]>(moduleId: string, args: Parameters<typeof createTestResources<S>>[0], options?: Parameters<typeof createTestResources>[1]): Promise<ReturnType<typeof createTestResources<S>>>;
+    mapTransactionActions(transaction: DiffMetadata[][]): string[][];
     initialize(stateProvider?: IStateProvider, initializeInContainer?: Parameters<typeof Octo.prototype.initialize>[1], excludeInContainer?: Parameters<typeof Octo.prototype.initialize>[2]): Promise<void>;
-    loadModules(modules: {
-        hidden?: boolean;
-        properties?: Parameters<typeof Module>[0];
-        type: Constructable<IModule<unknown>>;
-    }[]): Promise<void>;
+    orderModules(modules: (Constructable<UnknownModule> | string)[]): Promise<void>;
+    registerCapture<S extends BaseResourceSchema>(resourceContext: string, response: Partial<S['response']>): void;
+    runModule<M extends UnknownModule>(module: TestModule<M>): Promise<{
+        [key: string]: ModuleOutput<M>;
+    }>;
+    runModules<M extends UnknownModule>(modules: TestModule<M>[]): Promise<{
+        [key: string]: ModuleOutput<M>;
+    }>;
     reset(): Promise<void>;
 }