floating-live 0.16.0-alpha.10 → 0.16.0-alpha.12

package/dist/FloatingLive.d.ts

@@ -1,6 +1,24 @@
+import { LiveRoom } from ".";
 import { App } from "./app";
 import { Room } from "./plugins/room";
 export declare class FloatingLive extends App {
     room: Room;
     constructor();
+    /** 添加房间 */
+    add(platform: string, id: number, options?: boolean | Record<string, any>): Promise<void>;
+    /** 移除房间 */
+    remove(key: string): void;
+    /** 获取房间 */
+    get(key: string): LiveRoom | undefined;
+    has(key: string): boolean;
+    /** 获取房间信息 */
+    data(key: string): import("./live").LiveRoomData | undefined;
+    /** 更新房间信息 */
+    update(key: string): void;
+    /** 打开房间连接 */
+    open(key: string): void;
+    /** 关闭房间连接 */
+    close(key: string): void;
+    /** 获取房间列表 */
+    getList(): LiveRoom[];
 }

package/dist/FloatingLive.js

@@ -3,6 +3,41 @@ import { Room } from "./plugins/room";
 export class FloatingLive extends App {
     constructor() {
         super();
-        this.room = new Room(this);
+        this.room = this.registerSync(Room, { core: true });
+    }
+    /** 添加房间 */
+    add(platform, id, options) {
+        return this.room.add(platform, id, options);
+    }
+    /** 移除房间 */
+    remove(key) {
+        return this.room.remove(key);
+    }
+    /** 获取房间 */
+    get(key) {
+        return this.room.get(key);
+    }
+    has(key) {
+        return this.room.has(key);
+    }
+    /** 获取房间信息 */
+    data(key) {
+        return this.room.data(key);
+    }
+    /** 更新房间信息 */
+    update(key) {
+        return this.room.update(key);
+    }
+    /** 打开房间连接 */
+    open(key) {
+        return this.room.open(key);
+    }
+    /** 关闭房间连接 */
+    close(key) {
+        return this.room.close(key);
+    }
+    /** 获取房间列表 */
+    getList() {
+        return this.room.getList();
     }
 }

package/dist/app.d.ts

@@ -2,7 +2,7 @@ import { CommandOptions, CommandCallOptions, AppCommandMap, CommandFunction } fr
 import { AppError } from "./error";
 import { AppEventDetailMap, AppEventEmitOptions, AppEventListener } from "./event";
 import { AppHookMap, HookCallOptions, HookContext, HookFunction, HookUseOptions } from "./hook";
-import { AppPluginExposesMap, PluginContext, PluginInitOptions } from "./plugin";
+import { AppPluginExposesMap, PluginConstructor, PluginContext, PluginInitOptions, PluginItem } from "./plugin";
 import { CustomEventEmitter } from "./utils/EventEmitter";
 import { AppValueMap, ValueOptions } from "./value";
 export declare class App extends CustomEventEmitter implements PluginContext {
@@ -20,7 +20,9 @@ export declare class App extends CustomEventEmitter implements PluginContext {
     throw(err?: Error): void;
     error(id: string, detail?: Record<string, any>): AppError;
     /** 注册插件 */
-    register(plugin: any, options?: PluginInitOptions): void;
+    register<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): Promise<P>;
+    /** 同步注册插件 */
+    registerSync<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): P;
     /** 取消注册插件 */
     unregister(pluginName: string): void;
     getPlugin(pluginName: string): void;
@@ -37,7 +39,7 @@ export declare class App extends CustomEventEmitter implements PluginContext {
     unuseHook<T extends keyof AppHookMap>(name: T, func: HookFunction<AppHookMap[T]>): void;
     callHook<T extends keyof AppHookMap>(name: T, ctx: AppHookMap[T], options?: HookCallOptions): Promise<HookContext<AppHookMap[T]>>;
     callHookSync<T extends keyof AppHookMap>(name: T, ctx: AppHookMap[T], options?: HookCallOptions): HookContext<AppHookMap[T]>;
-    registerValue<K extends keyof AppValueMap>(name: K, options: ValueOptions<AppValueMap[K]>): void;
+    registerValue<K extends keyof AppValueMap>(name: K, options: ValueOptions<AppValueMap[K]>): import("./value").ValueContext<AppValueMap[K]>;
     unregisterValue(name: string): void;
     watch<K extends keyof AppValueMap>(name: K, watcher: (value: AppValueMap[K]) => void): void;
     unwatch<K extends keyof AppValueMap>(name: K, watcher: (value: AppValueMap[K]) => void): void;
@@ -46,6 +48,6 @@ export declare class App extends CustomEventEmitter implements PluginContext {
     setValue(name: string, value: any): void;
     destroy(): void;
     /** 拓展值 */
-    define(): void;
+    define(key: string, value: ((...args: any[]) => any) | PropertyDescriptor): void;
     get signal(): AbortSignal;
 }

package/dist/app.js

@@ -37,7 +37,11 @@ export class App extends CustomEventEmitter {
     //--- 插件机制 ---//
     /** 注册插件 */
     register(plugin, options) {
-        this.pluginManager.register(plugin, options);
+        return this.pluginManager.register(plugin, options);
+    }
+    /** 同步注册插件 */
+    registerSync(plugin, options) {
+        return this.pluginManager.registerSync(plugin, options);
     }
     /** 取消注册插件 */
     unregister(pluginName) {
@@ -106,7 +110,7 @@ export class App extends CustomEventEmitter {
     }
     //--- 值机制 ---//
     registerValue(name, options) {
-        this.valueManager.register(name, options);
+        return this.valueManager.register(name, options);
     }
     unregisterValue(name) {
         this.valueManager.unregister(name);
@@ -131,7 +135,14 @@ export class App extends CustomEventEmitter {
     }
     //--- 其他 ---//
     /** 拓展值 */
-    define() { }
+    define(key, value) {
+        if (typeof value == "function") {
+            Object.defineProperty(this, key, { value });
+        }
+        else {
+            Object.defineProperty(this, key, value);
+        }
+    }
     get signal() {
         return this.abortController.signal;
     }

package/dist/live/room.d.ts

@@ -2,6 +2,7 @@ import { CustomEventEmitter } from "../utils/EventEmitter";
 import { EnumValue } from "../utils/types";
 import { LiveMessage } from "./message";
 import { UserInfo } from "./messageInfo";
+/** 直播间客户端API */
 export declare abstract class LiveRoom extends CustomEventEmitter implements LiveRoomData {
     constructor();
     /** 平台 */
@@ -30,20 +31,24 @@ export declare abstract class LiveRoom extends CustomEventEmitter implements Liv
     abstract open(): void;
     /** 关闭连接 */
     abstract close(): void;
-    /** 从服务器获取信息 */
-    abstract getInfo(): Promise<void>;
-    /** 销毁事件 */
-    protected onDestroy?(): void;
+    /** 更新房间数据 */
+    abstract update(): Promise<void>;
+    /** 从服务器获取房间数据 */
+    abstract fetchData?(): Promise<void>;
     /** 销毁 */
     destroy(): void;
+    /** 销毁事件 */
+    protected onDestroy?: () => void;
     protected emitMessage(msg: LiveMessage.All): void;
     /** 发送源消息 */
     protected emitRaw(msg: any): void;
     /** 获取数据 */
     toData(): LiveRoomData;
     get key(): string;
-    on<K extends keyof LiveRoomEventMap>(type: K, listener: (e: LiveRoomEventMap[K]) => void): void;
-    once<K extends keyof LiveRoomEventMap>(type: K, listener: (e: LiveRoomEventMap[K]) => void): void;
+}
+export interface LiveRoom {
+    on<K extends keyof LiveRoomEventMap>(type: K, listener: (e: LiveRoomEventMap[K]) => void, signal?: AbortSignal): void;
+    once<K extends keyof LiveRoomEventMap>(type: K, listener: (e: LiveRoomEventMap[K]) => void, signal?: AbortSignal): void;
     off<K extends keyof LiveRoomEventMap>(type: K, listener: (e: LiveRoomEventMap[K]) => void): void;
     emit<K extends keyof LiveRoomEventMap>(type: LiveRoomEventMap[K] extends Record<string, never> ? K : never): void;
     emit<K extends keyof LiveRoomEventMap>(type: K, detail: LiveRoomEventMap[K]): void;
@@ -124,33 +129,50 @@ export declare const LiveConnectionStatus: {
 };
 export type LiveConnectionStatus = EnumValue<typeof LiveConnectionStatus>;
 export interface LiveRoomEventMap {
+    /**  */
     status: {
         status: LiveRoomStatus;
         timestamp: number;
         liveId?: string | number;
     };
+    /** 房间数据更新 */
     update: {
         room: LiveRoomData;
     };
+    /** 细节改变 */
     detail: {
         detail: Partial<LiveRoomDetailInfo>;
     };
+    /** 统计信息改变 */
     stats: {
         stats: Partial<LiveRoomStatsInfo>;
     };
+    /** 消息 */
     message: {
         message: LiveMessage.All;
     };
+    /** 消息源数据 */
     raw: {
         platform: string;
         roomId: string | number;
         data: any;
     };
+    /** 初始化 */
     init: {};
+    /** 正在连接 */
     connecting: {};
+    /** 连接到服务器 */
     connected: {};
+    /** 断开连接 */
     disconnect: {};
+    /** 连接到房间 */
     enter: {};
+    /** 连接超时 */
+    timeout: {
+        time: number;
+    };
+    /** 开启直播间连接 */
     open: {};
+    /** 关闭直播间连接 */
     close: {};
 }

package/dist/live/room.js

@@ -1,4 +1,5 @@
 import { CustomEventEmitter } from "../utils/EventEmitter";
+/** 直播间客户端API */
 export class LiveRoom extends CustomEventEmitter {
     constructor() {
         super();
@@ -76,19 +77,6 @@ export class LiveRoom extends CustomEventEmitter {
     get key() {
         return `${this.platform}:${this.id}`;
     }
-    on(type, listener) {
-        super.on(type, listener);
-    }
-    once(type, listener) {
-        super.once(type, listener);
-        this.emit("connecting");
-    }
-    off(type, listener) {
-        super.off(type, listener);
-    }
-    emit(type, detail) {
-        super.emit(type, detail);
-    }
 }
 /** 直播间状态 */
 export const LiveRoomStatus = {

package/dist/plugin/context/CommonPluginContext.d.ts

@@ -3,8 +3,8 @@ import type { CommandOptions, CommandCallOptions, CommandFunction, AppCommandMap
 import { AppError, ErrorOptions } from "../../error";
 import { AppEventListener, AppEventEmitOptions, AppEventDetailMap } from "../../event";
 import { HookUseOptions, HookCallOptions, AppHookMap, HookFunction, HookContext } from "../../hook";
-import { AppValueMap, ValueOptions } from "../../value";
-import type { PluginContext, PluginConstructor, PluginInitOptions, AppPluginExposesMap } from "../types";
+import { AppValueMap, ValueContext, ValueOptions } from "../../value";
+import type { PluginContext, PluginConstructor, PluginInitOptions, AppPluginExposesMap, PluginItem } from "../types";
 export declare class CommonPluginContext implements PluginContext {
     #private;
     get safe(): boolean;
@@ -18,12 +18,12 @@ export declare class CommonPluginContext implements PluginContext {
      */
     throw(err: AppError): void;
     error(id: string, options: ErrorOptions): AppError;
-    register(plugin: PluginConstructor, options?: PluginInitOptions): void;
+    register<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): Promise<P>;
     unregister(pluginName: string): void;
     getPluginExposes<K extends keyof AppPluginExposesMap>(pluginName: K): AppPluginExposesMap[K];
     whenRegister(pluginName: string, callback: (exposes: any) => (() => void) | void): void;
     hasPlugin(pluginName: string): boolean;
-    registerValue<K extends keyof AppValueMap>(name: K, options: ValueOptions<AppValueMap[K]>): void;
+    registerValue<K extends keyof AppValueMap>(name: K, options: ValueOptions<AppValueMap[K]>): ValueContext<AppValueMap[K]>;
     unregisterValue(name: string): void;
     registerCommand<T extends keyof AppCommandMap>(name: T, func: CommandFunction<AppCommandMap[T]>, options?: CommandOptions): void;
     unregisterCommand(name: string): void;

package/dist/plugin/context/CommonPluginContext.js

@@ -60,11 +60,12 @@ export class CommonPluginContext {
     }
     register(plugin, options) {
         try {
-            __classPrivateFieldGet(this, _CommonPluginContext_app, "f").register(plugin, options);
+            const p = __classPrivateFieldGet(this, _CommonPluginContext_app, "f").register(plugin, options);
             __classPrivateFieldGet(this, _CommonPluginContext_registered, "f").plugins.add(plugin.name);
+            return p;
         }
         catch (err) {
-            this.throw(err);
+            throw this.throw(err);
         }
     }
     unregister(pluginName) {
@@ -107,11 +108,12 @@ export class CommonPluginContext {
     }
     registerValue(name, options) {
         try {
-            __classPrivateFieldGet(this, _CommonPluginContext_app, "f").registerValue(name, options);
+            const ctx = __classPrivateFieldGet(this, _CommonPluginContext_app, "f").registerValue(name, options);
             __classPrivateFieldGet(this, _CommonPluginContext_registered, "f").values.add(name);
+            return ctx;
         }
         catch (err) {
-            this.throw(err);
+            throw this.throw(err);
         }
     }
     unregisterValue(name) {

package/dist/plugin/context/CorePluginContext.d.ts

@@ -0,0 +1,8 @@
+import { App } from "../..";
+import { CommonPluginContext } from "./CommonPluginContext";
+/** 核心插件，具有对程序的访问权限 */
+export declare class CorePluginContext extends CommonPluginContext {
+    #private;
+    constructor(app: App, pluginName: string);
+    get app(): App;
+}

package/dist/plugin/context/CorePluginContext.js

@@ -0,0 +1,25 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CorePluginContext_app;
+import { CommonPluginContext } from "./CommonPluginContext";
+/** 核心插件，具有对程序的访问权限 */
+export class CorePluginContext extends CommonPluginContext {
+    constructor(app, pluginName) {
+        super(app, pluginName);
+        _CorePluginContext_app.set(this, void 0);
+        __classPrivateFieldSet(this, _CorePluginContext_app, app, "f");
+    }
+    get app() {
+        return __classPrivateFieldGet(this, _CorePluginContext_app, "f");
+    }
+}
+_CorePluginContext_app = new WeakMap();

package/dist/plugin/context/SafePluginContext.d.ts

@@ -2,7 +2,7 @@ import { App } from "../../app";
 import { AppCommandMap, CommandCallOptions, CommandFunction, CommandOptions } from "../../command";
 import { AppEventDetailMap, AppEventEmitOptions } from "../../event";
 import { AppHookMap, HookCallOptions, HookContext, HookFunction, HookUseOptions } from "../../hook";
-import { PluginConstructor, PluginInitOptions } from "../types";
+import { PluginConstructor, PluginItem, PluginInitOptions } from "../types";
 import { CommonPluginContext } from "./CommonPluginContext";
 export interface PluginPermissions {
     "plugin.register"?: boolean;
@@ -22,7 +22,7 @@ export declare class SafePluginContext extends CommonPluginContext {
         permissions: PluginPermissions;
     });
     private throwNotPermitted;
-    register(plugin: PluginConstructor, options?: PluginInitOptions): void;
+    register<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): Promise<P>;
     unregister(pluginName: string): void;
     emit<K extends keyof AppEventDetailMap>(type: K, detail: AppEventDetailMap[K], options?: AppEventEmitOptions & EventInit): void;
     call<T extends keyof AppCommandMap>(name: T, ...args: Parameters<AppCommandMap[T]>): ReturnType<AppCommandMap[T]>;

package/dist/plugin/manager.d.ts

@@ -1,6 +1,6 @@
 import type { App } from "../app";
 import { AppError, ErrorOptions } from "../error";
-import { PluginItem, PluginConstructor, PluginContext } from "./types";
+import { PluginItem, PluginConstructor, PluginContext, PluginRegisterOptions } from "./types";
 export interface PluginErrorOptions extends ErrorOptions {
     pluginName: string;
 }
@@ -12,14 +12,16 @@ export interface PluginData<T> {
     plugin: PluginItem;
     context: PluginContext;
     exposes?: T;
+    core?: boolean;
 }
 export declare class PluginManager {
     /** 插件列表 */
     private list;
     protected readonly app: App;
     constructor(app: App);
+    registerSync<P extends PluginItem>(pluginConstructor: PluginConstructor<P>, options?: Record<string, any>, { context, core }?: PluginRegisterOptions): P;
     /** 注册插件 */
-    register(pluginConstructor: PluginConstructor, options?: Record<string, any>): Promise<PluginItem | undefined>;
+    register<P extends PluginItem>(pluginConstructor: PluginConstructor<P>, options?: Record<string, any>, { context, core }?: PluginRegisterOptions): Promise<P>;
     /** 移除插件 */
     unregister(pluginName: string): Promise<void>;
     /** 获取插件实例 */

package/dist/plugin/manager.js

@@ -1,5 +1,6 @@
 import { CommonPluginContext } from "./context/CommonPluginContext";
 import { AppError } from "../error";
+import { CorePluginContext } from "./context/CorePluginContext";
 export class PluginError extends AppError {
     constructor(id, options) {
         super(id, options);
@@ -12,8 +13,57 @@ export class PluginManager {
         this.list = new Map();
         this.app = app;
     }
+    registerSync(pluginConstructor, options = {}, { context, core } = {}) {
+        const pluginName = pluginConstructor.pluginName;
+        if (!pluginName) {
+            throw new PluginError("plugin:register_id_missing", {
+                message: "插件注册失败",
+                cause: "插件缺少pluginName字段",
+                pluginName: "",
+            });
+        }
+        if (this.list.has(pluginName)) {
+            throw new PluginError("plugin:register_id_duplicate", {
+                message: `插件注册失败: ${pluginName}`,
+                cause: "已存在相同id的插件",
+                pluginName,
+            });
+        }
+        const registerCtx = { pluginName, options };
+        const pluginCtx = context || new CorePluginContext(this.app, pluginName);
+        try {
+            const ctx = this.app.callHookSync("plugin.register", registerCtx);
+            if (ctx.defaultPrevented)
+                throw new PluginError("plugin:register_hook_prevented", {
+                    message: `插件注册失败: ${pluginName}`,
+                    cause: "插件注册被钩子函数阻止",
+                    pluginName,
+                });
+            // 执行插件函数
+            const plugin = new pluginConstructor(pluginCtx, registerCtx.options || {});
+            // 调用插件的init钩子
+            plugin.init?.(pluginCtx, registerCtx.options || {});
+            // 调用插件的expose钩子
+            const exposes = plugin.expose?.(pluginCtx);
+            this.list.set(pluginName, {
+                plugin,
+                context: pluginCtx,
+                exposes,
+                core,
+            });
+            this.app.emit("plugin:register", { pluginName });
+            return plugin;
+        }
+        catch (err) {
+            throw new PluginError("plugin:register_fail", {
+                message: `插件注册失败: ${pluginName}`,
+                cause: err,
+                pluginName,
+            });
+        }
+    }
     /** 注册插件 */
-    async register(pluginConstructor, options = {}) {
+    async register(pluginConstructor, options = {}, { context, core } = {}) {
         const pluginName = pluginConstructor.pluginName;
         if (!pluginName) {
             throw new PluginError("plugin:register_id_missing", {
@@ -30,19 +80,28 @@ export class PluginManager {
             });
         }
         const registerCtx = { pluginName, options };
-        const pluginCtx = new CommonPluginContext(this.app, pluginName);
+        const pluginCtx = context || new CommonPluginContext(this.app, pluginName);
         return await this.app
             .callHook("plugin.register", registerCtx)
             .then(async (ctx) => {
             if (ctx.defaultPrevented)
-                return;
+                throw new PluginError("plugin:register_hook_prevented", {
+                    message: `插件注册失败: ${pluginName}`,
+                    cause: "插件注册被钩子函数阻止",
+                    pluginName,
+                });
             // 执行插件函数
             const plugin = new pluginConstructor(pluginCtx, registerCtx.options || {});
             // 调用插件的init钩子
             await plugin.init?.(pluginCtx, registerCtx.options || {});
             // 调用插件的expose钩子
             const exposes = await plugin.expose?.(pluginCtx);
-            this.list.set(pluginName, { plugin, context: pluginCtx, exposes });
+            this.list.set(pluginName, {
+                plugin,
+                context: pluginCtx,
+                exposes,
+                core,
+            });
             this.app.emit("plugin:register", { pluginName });
             return plugin;
         })
@@ -66,7 +125,14 @@ export class PluginManager {
             });
         }
         else {
-            const { plugin, context } = pluginData;
+            const { plugin, context, core } = pluginData;
+            if (core) {
+                throw new PluginError("plugin:unregister_core", {
+                    message: `插件移除失败: ${pluginName}`,
+                    cause: "无法移除核心插件",
+                    pluginName,
+                });
+            }
             // 调用插件和上下文的destroy钩子
             plugin.destroy?.(context);
             context.destroy();

package/dist/plugin/types.d.ts

@@ -1,25 +1,40 @@
+import { App } from "../app";
 import { CommandOptions, CommandCallOptions, AppCommandMap, CommandFunction } from "../command";
 import { AppError, ErrorOptions } from "../error";
 import { AppEventListener, AppEventEmitOptions, AppEventDetailMap } from "../event";
 import { AppHookMap, HookCallOptions, HookContext, HookFunction, HookUseOptions } from "../hook";
-import { AppValueMap, ValueOptions } from "../value";
+import { AppValueMap, ValueContext, ValueOptions } from "../value";
 /** 插件对象 */
 export interface PluginItem {
     pluginName: string;
+    /** 初始化插件 */
     init?(ctx: PluginContext, options?: Record<string, any>): void | Promise<void>;
+    /** 插件销毁 */
     destroy?(ctx: PluginContext): void | Promise<void>;
+    /** 插件暴露 */
     expose?(ctx: PluginContext): any;
 }
 /** 插件构造器 */
-export interface PluginConstructor {
+export interface PluginConstructor<P extends PluginItem> {
     pluginName: string;
-    new (ctx: PluginContext, options: any): PluginItem;
+    new (ctx: PluginContext, options: any): P;
 }
 /** 插件初始化选项 */
 export interface PluginInitOptions {
 }
+/** 插件注册选项 */
+export interface PluginRegisterOptions {
+    /** 提供的插件上下文 */
+    context?: PluginContext;
+    /** 核心插件，不可解除注册 */
+    core?: boolean;
+}
 /** 插件上下文 */
 export interface PluginContext {
+    /** 安全插件上下文 */
+    safe?: boolean;
+    /** App实例，仅在核心插件上下文提供 */
+    app?: App;
     /** 监听事件 */
     on<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
     /** 单次监听事件 */
@@ -33,7 +48,7 @@ export interface PluginContext {
     /** 生成错误 */
     error(id: string, options: ErrorOptions): AppError;
     /** 注册插件 */
-    register(plugin: PluginConstructor, options?: PluginInitOptions): void;
+    register<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): Promise<P>;
     /** 取消注册插件 */
     unregister(pluginName: string): void;
     /** 获取插件暴露对象 */
@@ -62,7 +77,7 @@ export interface PluginContext {
     /** 调用同步钩子 */
     callHookSync<T extends keyof AppHookMap>(name: T, ctx: AppHookMap[T], options?: HookCallOptions): HookContext<AppHookMap[T]>;
     /** 注册值 */
-    registerValue<K extends keyof AppValueMap>(name: K, options: ValueOptions<AppValueMap[K]>): void;
+    registerValue<K extends keyof AppValueMap>(name: K, options: ValueOptions<AppValueMap[K]>): ValueContext<AppValueMap[K]>;
     /** 取消注册值 */
     unregisterValue(name: string): void;
     /** 监听值 */

package/dist/plugins/room/index.d.ts

@@ -2,6 +2,17 @@ import { LiveMessage } from "../../live/message";
 import { LiveRoom, LiveRoomDetailInfo, LiveRoomData, LiveRoomStatsInfo, LiveRoomStatus } from "../../live/room";
 import { BasePlugin } from "../../plugin";
 import { PluginContext } from "../../plugin/types";
+interface PluginExposes {
+    add(platform: string, id: number, options?: boolean | Record<string, any>): void;
+    remove(key: string): void;
+    get(key: string): LiveRoom | undefined;
+    has(key: string): boolean;
+    data(key: string): LiveRoomData | undefined;
+    update(key: string): void;
+    open(key: string): void;
+    close(key: string): void;
+    getList(): LiveRoom[];
+}
 declare module "../.." {
     interface AppCommandMap {
         add: (platform: string, id: number, options?: boolean | Record<string, any>) => void;
@@ -83,14 +94,18 @@ declare module "../.." {
             options: Record<string, any>;
         };
     }
+    interface AppPluginExposesMap {
+        room: PluginExposes;
+    }
 }
 export declare class Room extends BasePlugin {
     static pluginName: string;
     private map;
-    private symbolRoomEventHandlers;
-    constructor(ctx: PluginContext);
+    private symbolAbortController;
+    init(ctx: PluginContext): void;
+    expose(): PluginExposes;
     /** 添加房间监听实例 */
-    attachRoom(room: LiveRoom, open?: boolean): void;
+    attach(room: LiveRoom, open?: boolean): void;
     /** 添加房间 */
     add(platform: string, id: number, options?: boolean | Record<string, any>): Promise<void>;
     /** 移除房间 */
@@ -99,13 +114,13 @@ export declare class Room extends BasePlugin {
     get(key: string): LiveRoom | undefined;
     has(key: string): boolean;
     /** 获取房间信息 */
-    info(key: string): LiveRoomData | undefined;
+    data(key: string): LiveRoomData | undefined;
     /** 更新房间信息 */
     update(key: string): void;
     /** 获取房间key列表 */
-    get keys(): Array<string>;
+    get keys(): string[];
     /** 获取房间列表 */
-    getList(): Array<LiveRoom>;
+    getList(): LiveRoom[];
     /** 打开房间连接 */
     open(key: string): void;
     /** 关闭房间连接 */

package/dist/plugins/room/index.js

@@ -2,10 +2,12 @@ import { AppError } from "../../error";
 import { BasePlugin } from "../../plugin";
 import { bindCommand } from "../../utils";
 export class Room extends BasePlugin {
-    constructor(ctx) {
-        super(ctx);
+    constructor() {
+        super(...arguments);
         this.map = new Map();
-        this.symbolRoomEventHandlers = Symbol("room.roomEventHandlers");
+        this.symbolAbortController = Symbol("room.abortController");
+    }
+    init(ctx) {
         ctx.registerCommand("add", bindCommand(this.add, this));
         ctx.registerCommand("remove", bindCommand(this.remove, this));
         ctx.registerCommand("open", bindCommand(this.open, this));
@@ -13,8 +15,21 @@ export class Room extends BasePlugin {
         ctx.registerCommand("update", bindCommand(this.update, this));
         ctx.registerCommand("room.snapshot", bindCommand(this.getSnapshot, this));
     }
+    expose() {
+        return {
+            add: this.add.bind(this),
+            remove: this.remove.bind(this),
+            get: this.get.bind(this),
+            has: this.has.bind(this),
+            data: this.data.bind(this),
+            update: this.update.bind(this),
+            open: this.open.bind(this),
+            close: this.close.bind(this),
+            getList: this.getList.bind(this),
+        };
+    }
     /** 添加房间监听实例 */
-    attachRoom(room, open) {
+    attach(room, open) {
         let key = room.key;
         if (this.map.has(key)) {
             this.ctx.throw(new AppError("room:add_exist", {
@@ -23,11 +38,11 @@ export class Room extends BasePlugin {
             return;
         }
         this.map.set(key, room);
-        const eventHandlers = [];
-        room[this.symbolRoomEventHandlers] = eventHandlers;
+        const abortController = new AbortController();
+        room[this.symbolAbortController] =
+            abortController;
         const setHandler = (type, listener) => {
-            room.on(type, listener);
-            eventHandlers.push([type, listener]);
+            room.on(type, listener, abortController.signal);
         };
         // 添加监听事件
         // 直播消息
@@ -100,7 +115,7 @@ export class Room extends BasePlugin {
             this.ctx.throw(this.ctx.error("room:create_fail", { message: "无法创建房间" }));
         }
         else {
-            this.attachRoom(room);
+            this.attach(room);
         }
     }
     /** 移除房间 */
@@ -112,9 +127,7 @@ export class Room extends BasePlugin {
             }));
         }
         this.map.delete(key); // 从表中删除房间
-        room[this.symbolRoomEventHandlers].forEach(([type, listener]) => {
-            room?.removeEventListener(type, listener);
-        }); // 移除房间监听实例
+        room[this.symbolAbortController]?.abort(); // 移除房间监听实例
         this.ctx.emit("room:remove", { key });
     }
     /** 获取房间 */
@@ -125,14 +138,14 @@ export class Room extends BasePlugin {
         return this.map.has(key);
     }
     /** 获取房间信息 */
-    info(key) {
+    data(key) {
         let room = this.map.get(key);
         return room ? room.toData() : undefined;
     }
     /** 更新房间信息 */
     update(key) {
         let room = this.map.get(key);
-        room && room.getInfo();
+        room && room.update();
     }
     /** 获取房间key列表 */
     get keys() {

package/dist/value/manager.d.ts

@@ -1,11 +1,11 @@
 import { App } from "../app";
-import { ValueAccessOptions, ValueOptions } from "./types";
+import { ValueAccessOptions, ValueContext, ValueOptions } from "./types";
 export declare class ValueManager {
     private list;
     protected readonly app: App;
     constructor(app: App);
     /** 注册值 */
-    register<T>(name: string, { get, set, pluginName }: ValueOptions<T>): void;
+    register<T>(name: string, { get, set, pluginName }: ValueOptions<T>): ValueContext<T>;
     /** 取消注册 */
     unregister(name: string): void;
     /** 获取值 */

package/dist/value/manager.js

@@ -10,6 +10,11 @@ export class ValueManager {
     register(name, { get, set, pluginName }) {
         this.list.set(name, { get, set, pluginName });
         this.app.emit("value:register", { name, value: get() }, { source: `plugin:${pluginName}` });
+        return {
+            emit: (v) => {
+                this.emit(name, v);
+            },
+        };
     }
     /** 取消注册 */
     unregister(name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "floating-live",
-  "version": "0.16.0-alpha.10",
+  "version": "0.16.0-alpha.12",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",