@teqfw/core/src/Back/App/A/Init/Plugins.mjs

Core functionalities for plugin scanning, local configuration management, and command-line utilities for building modern web applications with the Tequila Framework.

/**
 * Run the initialization of teq-plugins.
 *
 * @implements TeqFw_Core_Shared_Api_Act
 */
export default class TeqFw_Core_Back_App_A_Init_Plugins {
    /**
     * @param {TeqFw_Di_Api_Container} container
     * @param {TeqFw_Core_Back_Defaults} DEF
     * @param {TeqFw_Core_Shared_Api_Logger} logger -  instance
     */
    constructor(
        {
            container,
            TeqFw_Core_Back_Defaults$: DEF,
            TeqFw_Core_Shared_Logger$$: logger, // inject the implementation
        }
    ) {
        /**
         * @param {TeqFw_Core_Back_Api_Plugin_Registry} plugins
         * @returns {Promise<void>}
         */
        this.act = async function ({plugins}) {
            const items = plugins.getItemsByLevels();
            for (const item of items) {
                /** @type {TeqFw_Core_Back_Plugin_Dto_Desc.Dto} */
                const desc = item.teqfw[DEF.SHARED.NAME];
                if (desc?.plugin?.onInit) {
                    const es6 = desc.plugin.onInit;
                    try {
                        const fn = await container.get(`${es6}$$`); // new instance, we don't need these objects more
                        if (typeof fn === 'function') {
                            logger.info(`Initializing the '${item.name}' plugin...`);
                            await fn();
                        }
                    } catch (e) {
                        logger.error(`Cannot initialize the plugin using the '${es6}' factory.`
                            + ` Error: ${e.message}`);
                    }
                }
            }
        };
    }
}