import { OnModuleInit } from '@nestjs/common'; import { isFunction, isNil } from '@nestjs/common/utils/shared.utils'; import { iterate } from 'iterare'; import { getNonTransientInstances, getTransientInstances, } from '../injector/helpers/transient-instances'; import { InstanceWrapper } from '../injector/instance-wrapper'; import { Module } from '../injector/module'; /** * Returns true or false if the given instance has a `onModuleInit` function * * @param instance The instance which should be checked */ function hasOnModuleInitHook(instance: unknown): instance is OnModuleInit { return isFunction((instance as OnModuleInit).onModuleInit); } /** * Calls the given instances */ function callOperator(instances: InstanceWrapper[]): Promise[] { return iterate(instances) .filter(instance => !isNil(instance)) .filter(hasOnModuleInitHook) .map(async instance => (instance as any as OnModuleInit).onModuleInit()) .toArray(); } /** * Calls the `onModuleInit` function on the module and its children * (providers / controllers). * * @param module The module which will be initialized */ export async function callModuleInitHook(module: Module): Promise { const providers = module.getNonAliasProviders(); // Module (class) instance is the first element of the providers array // Lifecycle hook has to be called once all classes are properly initialized const [_, moduleClassHost] = providers.shift(); const instances = [ ...module.controllers, ...providers, ...module.injectables, ...module.middlewares, ]; const nonTransientInstances = getNonTransientInstances(instances); await Promise.all(callOperator(nonTransientInstances)); const transientInstances = getTransientInstances(instances); await Promise.all(callOperator(transientInstances)); // Call the instance itself const moduleClassInstance = moduleClassHost.instance; if ( moduleClassInstance && hasOnModuleInitHook(moduleClassInstance) && moduleClassHost.isDependencyTreeStatic() ) { await moduleClassInstance.onModuleInit(); } }