@teqfw/core/src/Shared/App/Di/PreProcessor/Replace.mjs

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

/**
 * Pre-processor handler to replace one object key with another.
 *
 * Usage in teqfw.json:
 *     "replaces": {
 *       "back": {},
 *       "front": {},
 *       "shared": {
 *         "TeqFw_Core_Shared_Api_Logger": "TeqFw_Core_Shared_Logger"
 *       }
 *     }
 *
 *
 * @implements TeqFw_Di_Api_Container_PreProcessor_Chunk
 */
export default class TeqFw_Core_Shared_App_Di_PreProcessor_Replace {

    constructor() {
        // VARS
        /**
         * Storage for ES modules replacements (interface => implementation).
         * Sample: {['Vnd_Plug_Interface']:'Vnd_Plug_Impl', ...}
         * @type {Object<string, string>}
         */
        const map = {};

        // INSTANCE METHODS

        /**
         * Add replacement for ES6 modules.
         *
         * @param {string} orig ('Vnd_Plug_Interface')
         * @param {string} alter ('Vnd_Plug_Impl')
         */
        this.add = function (orig, alter) {
            map[orig] = alter;
        };

        this.modify = function (depId, originalId, stack) {
            let module = depId.moduleName;
            while (map[module]) module = map[module];
            if (module !== depId.moduleName) {
                const res = Object.assign({}, depId);
                res.moduleName = module;
                return res;
            } else
                return depId;
        };
    }

}