ST-Amily2-Chat-Optimisation/SL/bus/Amily2Bus.js

import Logger from './log/Logger.js';
import FilePipe from './file/FilePipe.js';

class Amily2Bus {
    constructor() {
        /** @type {Logger|null} */
        this.Logger = new Logger();
        /** @type {FilePipe|null} */
        this.FilePipe = new FilePipe();
        
        // 已注册插件列表，防止重复注册
        this.registry = new Set();

        console.log('[Amily2Bus] Core container initialized with secure registry.');
    }

    /**
     * 直接记录系统级日志 (Global Scope)
     * 支持手动指定来源，方便终端调试或非插件环境调用
     * @param {string} type 日志级别 (debug, info, warn, error)
     * @param {string} message 消息内容
     * @param {string} [origin='Bus'] 来源模块，默认为 'Bus'
     * @param {string} [plugin='Global'] 来源插件/命名空间，调试时可指定如 'Console'
     */
    log(type, message, origin = 'Bus', plugin = 'Global') {
        if (this.Logger) {
            this.Logger.process(plugin, origin, type, message);
        }
    }

    /**
     * 注册插件并获取专属上下文
     * @param {string} pluginName 插件名称
     * @returns {Object} 包含该插件专属 API 的上下文对象
     */
    register(pluginName) {
        if (!pluginName || typeof pluginName !== 'string') {
            throw new Error('[Amily2Bus] Invalid plugin name.');
        }

        if (this.registry.has(pluginName)) {
            console.warn(`[Amily2Bus] Plugin '${pluginName}' is already registered.`);
        } else {
            this.registry.add(pluginName);
            console.log(`[Amily2Bus] Plugin registered: ${pluginName}`);
        }

        // 返回该插件专属的 API 上下文 (Capability Token)
        return {
            // 绑定了身份的日志接口
            log: (origin, type, message) => {
                if (this.Logger) {
                    // 自动填充 plugin 参数
                    this.Logger.log(pluginName, origin, type, message);
                }
            },
            
            // 绑定了身份的文件接口
            file: {
                read: (path) => {
                    return this.FilePipe ? this.FilePipe.read(pluginName, path) : null;
                },
                write: (path, data) => {
                    return this.FilePipe ? this.FilePipe.write(pluginName, path, data) : false;
                }
            }
        };
    }
}
export function initializeAmilyBus() {
    if (!window.Amily2Bus || !(window.Amily2Bus instanceof Amily2Bus)) {
        window.Amily2Bus = new Amily2Bus();
        console.log('[Amily2] Amily2Bus 已成功初始化并附加到 window 对象');
    }
}