core-mvc/src/application.ts

Simple but powerful MVC framework for NodeJS.

import { AsyncContainerModule, Container } from 'inversify';
import { buildProviderModule } from 'inversify-binding-decorators';
import { initializeControllers } from './runtime/lifecycle';

export type AsyncContainerModuleCreator = (
    container: Container
) => AsyncContainerModule;

export class Application {
    private containerModules: (
        | AsyncContainerModule
        | AsyncContainerModuleCreator
    )[] = [];

    addContainerModule(
        containerModule: AsyncContainerModule | AsyncContainerModuleCreator
    ) {
        this.containerModules.push(containerModule);
    }

    async start({
        container = new Container(),
    }: {
        /**
         * Useful for migrating large apps that initialize their own container.
         *
         * Do not use in new projects.
         *
         * @deprecated
         */
        container?: Container;
    } = {}) {
        for (const containerModule of this.containerModules) {
            await container.loadAsync(
                containerModule instanceof AsyncContainerModule
                    ? containerModule
                    : containerModule(container)
            );
        }
        container.load(buildProviderModule());
        initializeControllers(container);

        return { container };
    }
}