floating-live 0.16.0-alpha.1 → 0.16.0-alpha.11

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 { PluginContext, PluginRegisterOptions } 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 {
@@ -10,37 +10,44 @@ export declare class App extends CustomEventEmitter implements PluginContext {
     private pluginManager;
     private commandManager;
     private valueManager;
+    private abortController;
     constructor();
-    on<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
-    once<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
+    on<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>, signal?: AbortSignal): void;
+    once<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>, signal?: AbortSignal): void;
     off<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
     emit<K extends keyof AppEventDetailMap>(type: K, detail: AppEventDetailMap[K], options?: AppEventEmitOptions & EventInit): void;
     /** 发送错误 */
     throw(err?: Error): void;
     error(id: string, detail?: Record<string, any>): AppError;
     /** 注册插件 */
-    register(plugin: any, options?: PluginRegisterOptions): 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;
-    whenRegister(pluginName: string, callback: (exposes: any) => (() => void) | undefined): void;
+    whenRegister<K extends keyof AppPluginExposesMap>(pluginName: K, callback: (exposes: AppPluginExposesMap[K]) => (() => void) | void): void;
+    whenRegister(pluginName: string, callback: () => (() => void) | void): void;
     getPluginExposes(pluginName: string): any;
     hasPlugin(pluginName: string): boolean;
     registerCommand<T extends keyof AppCommandMap>(name: T, func: CommandFunction<AppCommandMap[T]>, options?: CommandOptions): void;
     unregisterCommand(name: string): void;
+    hasCommand(name: string): boolean;
     call<T extends keyof AppCommandMap>(name: T, ...args: Parameters<AppCommandMap[T]>): ReturnType<AppCommandMap[T]>;
     callWithOptions<T extends keyof AppCommandMap>(name: T, options: CommandCallOptions, ...args: Parameters<AppCommandMap[T]>): ReturnType<AppCommandMap[T]>;
     useHook<T extends keyof AppHookMap>(name: T, func: HookFunction<AppHookMap[T]>, options?: HookUseOptions): void;
     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;
+    hasValue(name: string): boolean;
     getValue<K extends keyof AppValueMap>(name: K): AppValueMap[K];
     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

@@ -7,16 +7,17 @@ import { ValueManager } from "./value/manager";
 export class App extends CustomEventEmitter {
     constructor() {
         super();
+        this.abortController = new AbortController();
         this.hookManager = new HookManager(this);
         this.pluginManager = new PluginManager(this);
         this.commandManager = new CommandManager(this);
         this.valueManager = new ValueManager(this);
     }
-    on(type, listener) {
-        super.on(type, listener);
+    on(type, listener, signal = this.signal) {
+        super.on(type, listener, signal);
     }
-    once(type, listener) {
-        super.once(type, listener);
+    once(type, listener, signal = this.signal) {
+        super.once(type, listener, signal);
     }
     off(type, listener) {
         super.off(type, listener);
@@ -36,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) {
@@ -81,6 +86,9 @@ export class App extends CustomEventEmitter {
     unregisterCommand(name) {
         this.commandManager.unregister(name);
     }
+    hasCommand(name) {
+        return this.commandManager.has(name);
+    }
     call(name, ...args) {
         return this.commandManager.call(name, ...args);
     }
@@ -102,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);
@@ -113,14 +121,29 @@ export class App extends CustomEventEmitter {
     unwatch(name, watcher) {
         this.valueManager.unwatch(name, watcher);
     }
+    hasValue(name) {
+        return this.valueManager.has(name);
+    }
     getValue(name) {
         return this.valueManager.get(name);
     }
     setValue(name, value) {
         this.valueManager.set(name, value);
     }
-    destroy() { }
+    destroy() {
+        this.abortController.abort();
+    }
     //--- 其他 ---//
     /** 拓展值 */
-    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/messageInfo.d.ts

@@ -1,3 +1,4 @@
+import { EnumValue } from "../utils/types";
 /** 用户信息 */
 export interface UserInfo {
     /** 用户名 */
@@ -66,28 +67,30 @@ export interface GiftInfo {
     /** 单位 */
     unit?: string;
 }
-/** 图片大小 */
-export declare enum ImageSize {
+export declare const ImageSize: {
     /** 自定义大小 */
-    custom = 0,
+    readonly custom: 0;
     /** 小表情(文字行高) */
-    small = 1,
+    readonly small: 1;
     /** 大表情 */
-    large = 2
-}
+    readonly large: 2;
+};
+export type ImageSize = EnumValue<typeof ImageSize>;
 /** 弹幕模式 */
-export declare enum DanmakuMode {
-    left = 1,
-    bottom = 4,
-    top = 5,
-    right = 6
-}
+export declare const DanmakuMode: {
+    readonly left: 1;
+    readonly bottom: 4;
+    readonly top: 5;
+    readonly right: 6;
+};
+export type DanmakuMode = EnumValue<typeof DanmakuMode>;
 /** 用户类型 */
-export declare enum UserType {
+export declare const UserType: {
     /** 普通观众 */
-    normal = 0,
+    readonly normal: 0;
     /** 房管 */
-    admin = 1,
+    readonly admin: 1;
     /** 主播 */
-    anchor = 2
-}
+    readonly anchor: 2;
+};
+export type UserType = EnumValue<typeof UserType>;

package/dist/live/messageInfo.js

@@ -1,28 +1,24 @@
-/** 图片大小 */
-export var ImageSize;
-(function (ImageSize) {
+export const ImageSize = {
     /** 自定义大小 */
-    ImageSize[ImageSize["custom"] = 0] = "custom";
+    custom: 0,
     /** 小表情(文字行高) */
-    ImageSize[ImageSize["small"] = 1] = "small";
+    small: 1,
     /** 大表情 */
-    ImageSize[ImageSize["large"] = 2] = "large";
-})(ImageSize || (ImageSize = {}));
+    large: 2,
+};
 /** 弹幕模式 */
-export var DanmakuMode;
-(function (DanmakuMode) {
-    DanmakuMode[DanmakuMode["left"] = 1] = "left";
-    DanmakuMode[DanmakuMode["bottom"] = 4] = "bottom";
-    DanmakuMode[DanmakuMode["top"] = 5] = "top";
-    DanmakuMode[DanmakuMode["right"] = 6] = "right";
-})(DanmakuMode || (DanmakuMode = {}));
+export const DanmakuMode = {
+    left: 1,
+    bottom: 4,
+    top: 5,
+    right: 6,
+};
 /** 用户类型 */
-export var UserType;
-(function (UserType) {
+export const UserType = {
     /** 普通观众 */
-    UserType[UserType["normal"] = 0] = "normal";
+    normal: 0,
     /** 房管 */
-    UserType[UserType["admin"] = 1] = "admin";
+    admin: 1,
     /** 主播 */
-    UserType[UserType["anchor"] = 2] = "anchor";
-})(UserType || (UserType = {}));
+    anchor: 2,
+};

package/dist/live/room.d.ts

@@ -1,4 +1,5 @@
 import { CustomEventEmitter } from "../utils/EventEmitter";
+import { EnumValue } from "../utils/types";
 import { LiveMessage } from "./message";
 import { UserInfo } from "./messageInfo";
 export declare abstract class LiveRoom extends CustomEventEmitter implements LiveRoomData {
@@ -21,7 +22,7 @@ export declare abstract class LiveRoom extends CustomEventEmitter implements Liv
     liveId?: string;
     /** 房间是否打开 */
     opened: boolean;
-    /** 是否连接上房间 */
+    /** 房间连接状态 */
     connection: LiveConnectionStatus;
     /** 房间是否可用 */
     abstract available: boolean;
@@ -95,43 +96,47 @@ export interface LiveRoomStatsInfo {
     popularity?: number;
 }
 /** 直播间状态 */
-export declare enum LiveRoomStatus {
+export declare const LiveRoomStatus: {
     /** 未开播 */
-    off = 0,
+    readonly off: 0;
     /** 正在直播 */
-    live = 1,
+    readonly live: 1;
     /** 正在轮播 */
-    round = 2,
+    readonly round: 2;
     /** 被封禁 */
-    banned = -1,
+    readonly banned: -1;
     /** 已上锁 */
-    locked = -2
-}
+    readonly locked: -2;
+};
+export type LiveRoomStatus = EnumValue<typeof LiveRoomStatus>;
 /** 直播间状态 */
-export declare enum LiveConnectionStatus {
+export declare const LiveConnectionStatus: {
     /** 未连接 */
-    off = 0,
+    off: number;
     /** 连接中 */
-    connecting = 1,
+    connecting: number;
     /** 连接到服务器 */
-    connected = 2,
+    connected: number;
     /** 连接到房间 */
-    entered = 3,
+    entered: number;
     /** 连接失败或断开 */
-    disconnected = -1
-}
+    disconnected: number;
+};
+export type LiveConnectionStatus = EnumValue<typeof LiveConnectionStatus>;
 export interface LiveRoomEventMap {
     status: {
         status: LiveRoomStatus;
         timestamp: number;
         liveId?: string | number;
     };
-    update: {};
+    update: {
+        room: LiveRoomData;
+    };
     detail: {
         detail: Partial<LiveRoomDetailInfo>;
     };
     stats: {
-        stats: LiveRoomStatsInfo;
+        stats: Partial<LiveRoomStatsInfo>;
     };
     message: {
         message: LiveMessage.All;
@@ -141,6 +146,7 @@ export interface LiveRoomEventMap {
         roomId: string | number;
         data: any;
     };
+    init: {};
     connecting: {};
     connected: {};
     disconnect: {};

package/dist/live/room.js

@@ -8,7 +8,7 @@ export class LiveRoom extends CustomEventEmitter {
         this.timestamp = 0;
         /** 房间是否打开 */
         this.opened = false;
-        /** 是否连接上房间 */
+        /** 房间连接状态 */
         this.connection = LiveConnectionStatus.off;
     }
     /** 销毁 */
@@ -91,30 +91,28 @@ export class LiveRoom extends CustomEventEmitter {
     }
 }
 /** 直播间状态 */
-export var LiveRoomStatus;
-(function (LiveRoomStatus) {
+export const LiveRoomStatus = {
     /** 未开播 */
-    LiveRoomStatus[LiveRoomStatus["off"] = 0] = "off";
+    off: 0,
     /** 正在直播 */
-    LiveRoomStatus[LiveRoomStatus["live"] = 1] = "live";
+    live: 1,
     /** 正在轮播 */
-    LiveRoomStatus[LiveRoomStatus["round"] = 2] = "round";
+    round: 2,
     /** 被封禁 */
-    LiveRoomStatus[LiveRoomStatus["banned"] = -1] = "banned";
+    banned: -1,
     /** 已上锁 */
-    LiveRoomStatus[LiveRoomStatus["locked"] = -2] = "locked";
-})(LiveRoomStatus || (LiveRoomStatus = {}));
+    locked: -2,
+};
 /** 直播间状态 */
-export var LiveConnectionStatus;
-(function (LiveConnectionStatus) {
+export const LiveConnectionStatus = {
     /** 未连接 */
-    LiveConnectionStatus[LiveConnectionStatus["off"] = 0] = "off";
+    off: 0,
     /** 连接中 */
-    LiveConnectionStatus[LiveConnectionStatus["connecting"] = 1] = "connecting";
+    connecting: 1,
     /** 连接到服务器 */
-    LiveConnectionStatus[LiveConnectionStatus["connected"] = 2] = "connected";
+    connected: 2,
     /** 连接到房间 */
-    LiveConnectionStatus[LiveConnectionStatus["entered"] = 3] = "entered";
+    entered: 3,
     /** 连接失败或断开 */
-    LiveConnectionStatus[LiveConnectionStatus["disconnected"] = -1] = "disconnected";
-})(LiveConnectionStatus || (LiveConnectionStatus = {}));
+    disconnected: -1,
+};

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, PluginRegisterOptions } 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,15 +18,16 @@ export declare class CommonPluginContext implements PluginContext {
      */
     throw(err: AppError): void;
     error(id: string, options: ErrorOptions): AppError;
-    register(plugin: PluginConstructor, options?: PluginRegisterOptions): void;
+    register<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): Promise<P>;
     unregister(pluginName: string): void;
-    getPluginExposes<T>(pluginName: string): T;
-    whenRegister<T>(pluginName: string, callback: (exposes: any) => (() => void) | undefined): (() => void) | 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;
+    hasCommand(name: string): boolean;
     on<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
     once<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
     off<K extends keyof AppEventDetailMap>(type: K, listener: AppEventListener<AppEventDetailMap[K]>): void;
@@ -39,7 +40,9 @@ export declare class CommonPluginContext implements PluginContext {
     callHookSync<T extends keyof AppHookMap>(name: T, ctx: AppHookMap[T], options?: HookCallOptions): HookContext<AppHookMap[T]>;
     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;
-    getValue<K extends keyof AppValueMap>(name: K): undefined;
+    hasValue<K extends keyof AppValueMap>(name: K): boolean;
+    getValue<K extends keyof AppValueMap>(name: K): AppValueMap[K];
     setValue<K extends keyof AppValueMap>(name: K, value: AppValueMap[K]): void;
     destroy(): void;
+    get signal(): AbortSignal;
 }

package/dist/plugin/context/CommonPluginContext.js

@@ -9,7 +9,7 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     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 _CommonPluginContext_app, _CommonPluginContext_registered;
+var _CommonPluginContext_app, _CommonPluginContext_abortController, _CommonPluginContext_registered;
 import { AppError } from "../../error";
 class ListMap extends Map {
     addItem(key, value) {
@@ -35,6 +35,8 @@ export class CommonPluginContext {
     constructor(app, pluginName) {
         /** 主程序，插件不可访问 */
         _CommonPluginContext_app.set(this, void 0);
+        /** AbortController，插件不可访问 */
+        _CommonPluginContext_abortController.set(this, new AbortController());
         _CommonPluginContext_registered.set(this, {
             plugins: new Set(),
             values: new Set(),
@@ -58,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) {
@@ -105,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) {
@@ -139,6 +143,14 @@ export class CommonPluginContext {
             this.throw(err);
         }
     }
+    hasCommand(name) {
+        try {
+            return __classPrivateFieldGet(this, _CommonPluginContext_app, "f").hasCommand(name);
+        }
+        catch (err) {
+            throw this.throw(err);
+        }
+    }
     on(type, listener) {
         try {
             __classPrivateFieldGet(this, _CommonPluginContext_app, "f").on(type, listener);
@@ -234,7 +246,7 @@ export class CommonPluginContext {
             __classPrivateFieldGet(this, _CommonPluginContext_app, "f").watch(name, watcher);
         }
         catch (err) {
-            this.throw(err);
+            throw this.throw(err);
         }
     }
     unwatch(name, watcher) {
@@ -242,7 +254,15 @@ export class CommonPluginContext {
             __classPrivateFieldGet(this, _CommonPluginContext_app, "f").unwatch(name, watcher);
         }
         catch (err) {
-            this.throw(err);
+            throw this.throw(err);
+        }
+    }
+    hasValue(name) {
+        try {
+            return __classPrivateFieldGet(this, _CommonPluginContext_app, "f").hasValue(name);
+        }
+        catch (err) {
+            throw this.throw(err);
         }
     }
     getValue(name) {
@@ -250,24 +270,27 @@ export class CommonPluginContext {
             return __classPrivateFieldGet(this, _CommonPluginContext_app, "f").getValue(name);
         }
         catch (err) {
-            this.throw(err);
+            throw this.throw(err);
         }
     }
     setValue(name, value) {
         try {
-            __classPrivateFieldGet(this, _CommonPluginContext_app, "f").setValue(name, value);
+            return __classPrivateFieldGet(this, _CommonPluginContext_app, "f").setValue(name, value);
         }
         catch (err) {
-            this.throw(err);
+            throw this.throw(err);
         }
     }
     destroy() {
-        const { plugins, events, values, hooks, commands } = __classPrivateFieldGet(this, _CommonPluginContext_registered, "f");
+        const { plugins, values, hooks, commands } = __classPrivateFieldGet(this, _CommonPluginContext_registered, "f");
         plugins.forEach((pluginName) => __classPrivateFieldGet(this, _CommonPluginContext_app, "f").unregister(pluginName));
-        events.forEach((listenerList, eventName) => listenerList.forEach((listener) => __classPrivateFieldGet(this, _CommonPluginContext_app, "f").off(eventName, listener)));
         hooks.forEach((hookList, name) => hookList.forEach((hookFunc) => __classPrivateFieldGet(this, _CommonPluginContext_app, "f").off(name, hookFunc)));
         commands.forEach((name) => __classPrivateFieldGet(this, _CommonPluginContext_app, "f").unregisterCommand(name));
         values.forEach((name) => __classPrivateFieldGet(this, _CommonPluginContext_app, "f").unregisterValue(name));
+        __classPrivateFieldGet(this, _CommonPluginContext_abortController, "f").abort();
+    }
+    get signal() {
+        return __classPrivateFieldGet(this, _CommonPluginContext_abortController, "f").signal;
     }
 }
-_CommonPluginContext_app = new WeakMap(), _CommonPluginContext_registered = new WeakMap();
+_CommonPluginContext_app = new WeakMap(), _CommonPluginContext_abortController = new WeakMap(), _CommonPluginContext_registered = new WeakMap();

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, PluginRegisterOptions } 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?: PluginRegisterOptions): 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,17 +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 || {});
-            // 调用插件的register钩子
-            await plugin.register?.(pluginCtx, registerCtx.options || {});
-            this.list.set(pluginName, { plugin, context: pluginCtx });
+            // 调用插件的init钩子
+            await plugin.init?.(pluginCtx, registerCtx.options || {});
+            // 调用插件的expose钩子
+            const exposes = await plugin.expose?.(pluginCtx);
+            this.list.set(pluginName, {
+                plugin,
+                context: pluginCtx,
+                exposes,
+                core,
+            });
             this.app.emit("plugin:register", { pluginName });
             return plugin;
         })
@@ -64,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,24 +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;
-    register?(ctx: PluginContext, options?: Record<string, any>): void;
-    destroy?(ctx: PluginContext): void;
+    /** 初始化插件 */
+    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;
     /** 单次监听事件 */
@@ -32,19 +48,22 @@ export interface PluginContext {
     /** 生成错误 */
     error(id: string, options: ErrorOptions): AppError;
     /** 注册插件 */
-    register(plugin: PluginConstructor, options?: PluginRegisterOptions): void;
+    register<P extends PluginItem>(plugin: PluginConstructor<P>, options?: PluginInitOptions): Promise<P>;
     /** 取消注册插件 */
     unregister(pluginName: string): void;
     /** 获取插件暴露对象 */
-    getPluginExposes<T>(pluginName: string): T;
+    getPluginExposes<K extends keyof AppPluginExposesMap>(pluginName: K): AppPluginExposesMap[K];
     /** 等待plugin注册 */
-    whenRegister(pluginName: string, callback: (exposes: any) => (() => void) | void): void;
+    whenRegister<K extends keyof AppPluginExposesMap>(pluginName: K, callback: (exposes: AppPluginExposesMap[K]) => (() => void) | void): void;
+    whenRegister(pluginName: string, callback: () => (() => void) | void): void;
     /** 是否存在插件 */
     hasPlugin(pluginName: string): boolean;
     /** 注册指令 */
     registerCommand<T extends keyof AppCommandMap>(name: T, func: CommandFunction<AppCommandMap[T]>, options?: CommandOptions): void;
     /** 取消注册指令 */
     unregisterCommand(name: string): void;
+    /** 检测值是否存在 */
+    hasCommand(name: string): boolean;
     /** 调用指令 */
     call<T extends keyof AppCommandMap>(name: T, ...args: Parameters<AppCommandMap[T]>): ReturnType<AppCommandMap[T]>;
     /** 调用指令(可配置) */
@@ -58,16 +77,22 @@ 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;
     /** 监听值 */
     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;
+    /** 值是否存在 */
+    hasValue(name: string): boolean;
     /** 获取值 */
     getValue<K extends keyof AppValueMap>(name: K): AppValueMap[K];
     /** 设置值 */
     setValue<K extends keyof AppValueMap>(name: K, value: AppValueMap[K]): void;
     destroy(): void;
+    get signal(): AbortSignal;
+}
+export interface AppPluginExposesMap {
+    "": {};
 }

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;
@@ -12,6 +23,7 @@ declare module "../.." {
         update: (key: string) => void;
         "room.snapshot": () => LiveRoomData[];
         [name: `${string}.room.create`]: (id: string | number, options: Record<string, any>) => LiveRoom | Promise<LiveRoom>;
+        [name: `${string}.room.data`]: (id: string | number) => LiveRoomData | Promise<LiveRoomData>;
     }
     interface AppEventDetailMap {
         "live:message": {
@@ -82,12 +94,16 @@ 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);
+    init(ctx: PluginContext): void;
+    expose(): PluginExposes;
     /** 添加房间监听实例 */
     attachRoom(room: LiveRoom, open?: boolean): void;
     /** 添加房间 */
@@ -98,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");
+    }
+    init(ctx) {
         ctx.registerCommand("add", bindCommand(this.add, this));
         ctx.registerCommand("remove", bindCommand(this.remove, this));
         ctx.registerCommand("open", bindCommand(this.open, this));
@@ -13,6 +15,19 @@ 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) {
         let key = room.key;
@@ -125,7 +140,7 @@ 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;
     }

package/dist/utils/EventEmitter.d.ts

@@ -1,6 +1,6 @@
 export declare class CustomEventEmitter extends EventTarget {
-    on(type: string, listener: (e: any) => void): void;
-    once(type: string, listener: (e: any) => void): void;
+    on(type: string, listener: (e: any) => void, signal?: AbortSignal): void;
+    once(type: string, listener: (e: any) => void, signal?: AbortSignal): void;
     off(type: string, listener: (e: any) => void): void;
     emit(type: string, detail: any, options?: EventInit): void;
 }

package/dist/utils/EventEmitter.js

@@ -10,11 +10,11 @@ function getListenerCallback(listener) {
     return newItem;
 }
 export class CustomEventEmitter extends EventTarget {
-    on(type, listener) {
-        this.addEventListener(type, getListenerCallback(listener));
+    on(type, listener, signal) {
+        this.addEventListener(type, getListenerCallback(listener), { signal });
     }
-    once(type, listener) {
-        this.addEventListener(type, getListenerCallback(listener), { once: true });
+    once(type, listener, signal) {
+        this.addEventListener(type, getListenerCallback(listener), { once: true, signal });
     }
     off(type, listener) {
         this.removeEventListener(type, getListenerCallback(listener));

package/dist/utils/types.d.ts

@@ -0,0 +1 @@
+export type EnumValue<T> = T[keyof T];

package/dist/utils/types.js

@@ -0,0 +1 @@
+export {};

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.1",
+  "version": "0.16.0-alpha.11",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["./src/floatinglive.ts","./src/app.ts","./src/index.ts","./src/command/index.ts","./src/command/manager.ts","./src/command/types.ts","./src/error/index.ts","./src/error/types.ts","./src/event/index.ts","./src/event/manager.ts","./src/event/types.ts","./src/hook/index.ts","./src/hook/manager.ts","./src/hook/types.ts","./src/live/index.ts","./src/live/message.ts","./src/live/messageinfo.ts","./src/live/platform.ts","./src/live/room.ts","./src/plugin/index.ts","./src/plugin/manager.ts","./src/plugin/types.ts","./src/plugin/context/commonplugincontext.ts","./src/plugin/context/safeplugincontext.ts","./src/plugins/room/index.ts","./src/utils/eventemitter.ts","./src/utils/index.ts","./src/value/index.ts","./src/value/manager.ts","./src/value/types.ts"],"version":"5.6.3"}