@yunzai-ng/core 0.1.0

package/dist/pipeline/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/pipeline/dispatch.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/event.d.ts

@@ -0,0 +1,130 @@
+/**
+ * 模块职责：把适配器产出的 `Incoming*Event` 补全成插件可用的运行时事件
+ * 依赖方向：依赖类型包、message/segment、pipeline/prompt、util/id、util/duration；不依赖适配器实现
+ * 生命周期：每条事件一个实例，处理完即被 GC；不持有跨事件状态
+ * 注意事项：**适配器只负责翻译报文，派生字段全部由这里算** —— 摊到各适配器里会让 `e.atBot` 在
+ *          不同协议下语义不一致，插件只能两边都试。
+ *
+ *          派生字段（`atMe` / `atUsers` / `images` / `text`）用 getter + 私有缓存：中间件改写
+ *          `message` 后调一次 `refresh()` 重算，而不是每次读取都重新遍历 —— 路由匹配阶段 `e.text`
+ *          会被读几十次。
+ *
+ *          实例**刻意不 freeze、不 seal**：`EventExtensions` 的正规用法就是插件在事件上挂自有字段。
+ *
+ *          `e.render()` 依赖「当前执行的是哪个插件」（模板根随插件而定），故该绑定由 dispatch 在调
+ *          每个 handler 之前经 `bind()` 替换，而不写进事件的构造参数 —— 一条消息会依次流经多个插件。
+ */
+import type { BotApi, IncomingEvent, IncomingMessageEvent, IncomingNoticeEvent, IncomingMetaEvent, IncomingRequestEvent, Logger, MessageEvent, MetaEvent, NoticeEvent, RenderablePage, RenderOptions, RenderedImage, RequestEvent } from "@yunzai-ng/types";
+import { PromptRegistry } from "./prompt.js";
+/**
+ * 事件工厂需要的策略视图
+ *
+ * 只取用得到的两项而不是直接依赖 `KernelPolicy`：事件构造与"主人是谁"之间
+ * 只有这么一点耦合，写成最小接口后单测里给个字面量就能跑。
+ */
+export interface EventPolicyView {
+    /** 机器人昵称列表，用于把"云崽 #体力"识别为对我说话 */
+    readonly nicknames: readonly string[];
+    /**
+     * 判断是否主人
+     * @param uid 用户 id
+     * @returns 是否主人
+     */
+    isMaster(uid: string): boolean;
+}
+/**
+ * 当前正在执行的插件在事件上的投影
+ *
+ * `PluginContext` 结构上天然满足它，因此 dispatch 直接把上下文传进来即可，
+ * 不需要额外包一层。
+ */
+export interface PluginRuntimeView {
+    /** 插件名 */
+    readonly name: string;
+    /** 插件卸载信号 */
+    readonly signal: AbortSignal;
+    /**
+     * 渲染 TSX 页面（模板根已绑定到该插件）
+     * @param page 已渲染好的页面
+     * @param opts 渲染选项
+     * @returns 图片段
+     */
+    render(page: RenderablePage, opts?: RenderOptions): Promise<RenderedImage>;
+    /**
+     * 渲染字符串模板（模板根已绑定到该插件）
+     * @param template 模板路径
+     * @param data 模板数据
+     * @param opts 渲染选项
+     * @returns 图片段
+     */
+    render(template: string, data?: Record<string, unknown>, opts?: RenderOptions): Promise<RenderedImage>;
+}
+/** 内核内部持有的消息事件：比插件看到的多一个绑定入口 */
+export interface RuntimeMessageEvent extends MessageEvent {
+    /**
+     * 绑定当前正在执行的插件
+     *
+     * 只影响 `render()`/`renderReply()`/`prompt()` 的归属。dispatch 在每个
+     * handler 前后成对调用；传 `undefined` 表示"当前不在任何插件里"。
+     * @param view 插件运行时视图
+     */
+    bind(view: PluginRuntimeView | undefined): void;
+}
+/** 事件工厂构造参数 */
+export interface EventFactoryOptions {
+    /** 日志器 */
+    readonly logger: Logger;
+    /** 策略视图 */
+    readonly policy: EventPolicyView;
+    /** `prompt` 等待者登记表 */
+    readonly prompts: PromptRegistry;
+}
+/**
+ * 运行时事件工厂
+ *
+ * 内核里唯一构造事件的地方。适配器把 `IncomingEvent` 交给 `host.submit()`，
+ * 由 dispatch 调这里补全成运行时形态。
+ */
+export declare class EventFactory {
+    #private;
+    /**
+     * @param opts 构造参数
+     */
+    constructor(opts: EventFactoryOptions);
+    /**
+     * 按事件大类分派构造
+     * @param incoming 适配器产出的事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时事件
+     */
+    create(incoming: IncomingEvent, bot: BotApi): MessageEvent | NoticeEvent | RequestEvent | MetaEvent;
+    /**
+     * 构造运行时消息事件
+     * @param incoming 适配器产出的消息事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时消息事件
+     */
+    createMessage(incoming: IncomingMessageEvent, bot: BotApi): RuntimeMessageEvent;
+    /**
+     * 构造运行时通知事件
+     * @param incoming 适配器产出的通知事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时通知事件
+     */
+    createNotice(incoming: IncomingNoticeEvent, bot: BotApi): NoticeEvent;
+    /**
+     * 构造运行时请求事件
+     * @param incoming 适配器产出的请求事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时请求事件
+     */
+    createRequest(incoming: IncomingRequestEvent, bot: BotApi): RequestEvent;
+    /**
+     * 构造运行时元事件
+     * @param incoming 适配器产出的元事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时元事件
+     */
+    createMeta(incoming: IncomingMetaEvent, bot: BotApi): MetaEvent;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/pipeline/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/pipeline/event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,MAAM,EAMN,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,MAAM,EAGN,YAAY,EAEZ,SAAS,EACT,WAAW,EAGX,cAAc,EACd,aAAa,EACb,aAAa,EAEb,YAAY,EAMb,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAA0B,cAAc,EAAgB,MAAM,aAAa,CAAA;AAUlF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU;IACV,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,aAAa;IACb,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAE1E;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACvG;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAA;CAChD;AAED,eAAe;AACf,MAAM,WAAW,mBAAmB;IAClC,UAAU;IACV,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,WAAW;IACX,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CACjC;AA4aD;;;;;GAKG;AACH,qBAAa,YAAY;;IAIvB;;OAEG;gBACS,IAAI,EAAE,mBAAmB;IAIrC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS;IAanG;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAI/E;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW;IAmCrE;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY;IA2DxE;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS;CAqBhE"}

package/dist/pipeline/event.js

@@ -0,0 +1,538 @@
+import { atUsersOf, hasAtAll, imagesOf, seg, textOf, toSegments } from "../message/segment.js";
+import { createEventId } from "../util/id.js";
+import { parseDuration } from "../util/duration.js";
+import { DEFAULT_PROMPT_TIMEOUT, PromptRegistry, sessionKeyOf } from "./prompt.js";
+/**
+ * 昵称后面允许被一并剥掉的呼唤语气字符
+ *
+ * 刻意**不含** `.` `!` `~` `/` `#` —— 这些在各家插件里都是真实的命令前缀，
+ * 剥掉会把 `云崽 .help` 变成 `help` 从而匹配不上。这里只剥"叫人"用的标点。
+ */
+const NICKNAME_TAIL_RE = /^[\s,，、:：]+/;
+/**
+ * 取错误的可读描述
+ * @param err 任意抛出物
+ * @returns 描述文本
+ */
+function errText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * 推断通知事件应该回到哪里
+ *
+ * 有群号回群、否则回给相关用户。两者都没有（如纯连接类通知）返回 undefined，
+ * 由 `reply()` 抛错 —— 静默丢弃会让插件作者以为消息发出去了。
+ * @param n 通知事件
+ * @returns 发送目标；无法推断时 undefined
+ */
+function noticeTargetOf(n) {
+    if (n.gid !== undefined)
+        return { scene: "group", gid: n.gid };
+    if (n.uid !== undefined)
+        return { scene: "private", uid: n.uid };
+    return undefined;
+}
+/** 运行时消息事件实现 */
+class MessageEventImpl {
+    /** 事件大类 */
+    kind = "message";
+    /** 事件唯一 id */
+    id;
+    /** 发生时间（毫秒） */
+    time;
+    /** 平台标识 */
+    platform;
+    /** 接收该事件的账号 id */
+    selfId;
+    /** 接收该事件的 Bot */
+    bot;
+    /** 平台原始报文 */
+    raw;
+    /** 本次事件的临时状态袋 */
+    state = {};
+    /** 场景 */
+    scene;
+    /** 平台细分类型 */
+    subType;
+    /** 平台消息 id */
+    messageId;
+    /** 会话内序号 */
+    seq;
+    /** 消息段（可改写，改后需 `refresh()`） */
+    message;
+    /** 纯文本视图 */
+    text = "";
+    /** 发送者 */
+    sender;
+    /** 所在群 */
+    group;
+    /** 所在子频道 */
+    channel;
+    /** 引用的消息 */
+    quote;
+    /** 命令匹配结果 */
+    command;
+    /** 日志器 */
+    #logger;
+    /** 策略视图 */
+    #policy;
+    /** 等待者登记表 */
+    #prompts;
+    /** 回复目标（构造时算一次，场景与群号都是只读的） */
+    #target;
+    /** 发送者在群里的角色 */
+    #role;
+    /** 是否主人 */
+    #isMaster;
+    /** 是否 @ 了自己 */
+    #atMe = false;
+    /** 被 @ 的用户 */
+    #atUsers = [];
+    /** 图片段（含引用消息里的） */
+    #images = [];
+    /** 是否已被阻断 */
+    #stopped = false;
+    /** 当前执行中的插件 */
+    #binding;
+    /**
+     * @param incoming 适配器产出的消息事件
+     * @param bot 接收该事件的 Bot
+     * @param opts 工厂依赖
+     */
+    constructor(incoming, bot, opts) {
+        this.#logger = opts.logger;
+        this.#policy = opts.policy;
+        this.#prompts = opts.prompts;
+        this.id = incoming.id ?? createEventId();
+        this.time = incoming.time ?? Date.now();
+        this.platform = bot.platform;
+        this.selfId = bot.selfId;
+        this.bot = bot;
+        this.raw = incoming.raw;
+        this.scene = incoming.scene;
+        this.subType = incoming.subType ?? incoming.scene;
+        this.messageId = incoming.messageId;
+        this.seq = incoming.seq;
+        // 不复制数组：适配器交出来就不该再持有它，复制只是白白多一次分配。
+        // 中间件改写 message 是被允许的，改的就是这一份。
+        this.message = incoming.message;
+        this.sender = incoming.sender;
+        this.group = incoming.group;
+        this.channel = incoming.channel;
+        this.quote = incoming.quote;
+        this.#role = "role" in incoming.sender ? incoming.sender.role : undefined;
+        this.#isMaster = opts.policy.isMaster(incoming.sender.uid);
+        this.#target = this.#computeTarget();
+        this.refresh();
+    }
+    /** 是否 @ 了自己（含 @全体、含昵称呼唤） */
+    get atMe() {
+        return this.#atMe;
+    }
+    /** 被 @ 的用户 id 列表 */
+    get atUsers() {
+        return this.#atUsers;
+    }
+    /** 消息中的图片段（含引用消息里的图） */
+    get images() {
+        return this.#images;
+    }
+    /** 发送者是否主人 */
+    get isMaster() {
+        return this.#isMaster;
+    }
+    /** 发送者是否群管理（群主也算） */
+    get isGroupAdmin() {
+        return this.#role === "owner" || this.#role === "admin";
+    }
+    /** 发送者是否群主 */
+    get isGroupOwner() {
+        return this.#role === "owner";
+    }
+    /** 是否私聊 */
+    get isPrivate() {
+        return this.scene === "private";
+    }
+    /** 是否群聊（频道不算，频道判断用 `scene === "guild"`） */
+    get isGroup() {
+        return this.scene === "group";
+    }
+    /** 回复该消息时应发往的目标 */
+    get target() {
+        return this.#target;
+    }
+    /** 是否已被阻断 */
+    get stopped() {
+        return this.#stopped;
+    }
+    /** 阻断后续中间件与命令匹配 */
+    stop() {
+        this.#stopped = true;
+    }
+    /**
+     * 绑定当前正在执行的插件
+     * @param view 插件运行时视图
+     */
+    bind(view) {
+        this.#binding = view;
+    }
+    /** 改写 `message` 后重算派生字段 */
+    refresh() {
+        const message = this.message;
+        const atUsers = atUsersOf(message);
+        const images = imagesOf(message);
+        // 引用消息里的图也算进来：这是"识图"类指令唯一的数据来源。
+        // 放在自身图片之后 —— 用户自己发的图优先级更高。
+        const quoted = this.quote?.message;
+        if (quoted !== undefined && quoted.length > 0)
+            images.push(...imagesOf(quoted));
+        let atMe = hasAtAll(message);
+        if (!atMe) {
+            for (const uid of atUsers) {
+                if (uid === this.selfId) {
+                    atMe = true;
+                    break;
+                }
+            }
+        }
+        let text = textOf(message);
+        const stripped = this.#stripNickname(text);
+        if (stripped !== undefined) {
+            // 昵称已经从 text 里剥掉：这样 `云崽 #体力` 与 `#体力` 走同一条路由，
+            // 插件不必自己处理昵称前缀
+            text = stripped;
+            atMe = true;
+        }
+        this.text = text;
+        this.#atUsers = atUsers;
+        this.#images = images;
+        this.#atMe = atMe;
+    }
+    /**
+     * 回复
+     * @param content 消息内容
+     * @param opts 回复选项
+     * @returns 发送结果
+     */
+    async reply(content, opts = {}) {
+        const segments = toSegments(content);
+        if (segments.length === 0) {
+            // 空内容送到平台上通常是一个含义不明的 API 报错。这里拦下并指名道姓，
+            // 因为源头几乎总是插件里某个分支忘了赋值。
+            this.#logger.warn(`插件 ${this.#binding?.name ?? "未知"} 回复了空内容，已忽略（事件 ${this.id}）`);
+            return { ok: false, messageId: "", time: Date.now() };
+        }
+        const payload = opts.at === true && this.isGroup ? [seg.at(this.sender.uid, this.sender.name), ...segments] : segments;
+        const send = {};
+        if (opts.quote === true)
+            send.quote = this.messageId;
+        else if (typeof opts.quote === "string")
+            send.quote = opts.quote;
+        if (opts.recallAfter !== undefined)
+            send.recallAfter = opts.recallAfter;
+        if (opts.autoForward !== undefined)
+            send.autoForward = opts.autoForward;
+        if (opts.splitLength !== undefined)
+            send.splitLength = opts.splitLength;
+        return this.bot.sendMessage(this.#target, payload, send);
+    }
+    /**
+     * 渲染实现
+     * @param first 页面或模板路径
+     * @param second TSX 通路为渲染选项，字符串通路为模板数据
+     * @param third 字符串通路的渲染选项
+     * @returns 图片段
+     * @throws 不在插件执行上下文里调用时
+     */
+    async render(first, second, third) {
+        const binding = this.#binding;
+        if (binding === undefined) {
+            throw new Error("e.render() 只能在插件的命令处理函数或中间件里调用：内核要靠「当前插件」定位模板根目录。" +
+                "若要在 setTimeout 等脱离上下文的回调里渲染，请改用 ctx.render()");
+        }
+        // 两条通路在此汇合后原样转交给上下文，由其统一判别形态 —— 此处再判一次
+        // 只会让"形态如何判定"散落在两个文件里
+        if (typeof first === "string")
+            return binding.render(first, second, third);
+        return binding.render(first, second);
+    }
+    /**
+     * 渲染并回复的实现
+     * @param first 页面或模板路径
+     * @param second TSX 通路为选项，字符串通路为模板数据
+     * @param third 字符串通路的选项
+     * @returns 发送结果
+     */
+    async renderReply(first, second, third) {
+        // 选项在两条通路里位置不同：TSX 通路是第二参，字符串通路是第三参。
+        // reply 也要用到同一份选项（quote / recallAfter 等），故先归一
+        const opts = typeof first === "string" ? third : second;
+        const image = typeof first === "string"
+            ? await this.render(first, second, third)
+            : await this.render(first, second);
+        return this.reply(image, opts);
+    }
+    /**
+     * 撤回本条消息
+     * @returns 是否成功
+     */
+    async recall() {
+        if (!this.bot.caps.has("recall"))
+            return false;
+        try {
+            return await this.bot.recallMessage(this.messageId);
+        }
+        catch (err) {
+            // 撤回失败是家常便饭（超过 2 分钟、没有管理权限），不值得往上抛
+            this.#logger.debug(`撤回消息 ${this.messageId} 失败：${errText(err)}`);
+            return false;
+        }
+    }
+    /**
+     * 等待同一会话的下一条消息
+     * @param opts 等待选项
+     * @returns 下一条消息事件；超时或插件卸载时 undefined
+     */
+    async prompt(opts = {}) {
+        if (opts.tip !== undefined)
+            await this.reply(opts.tip);
+        const binding = this.#binding;
+        return this.#prompts.wait({
+            key: sessionKeyOf(this),
+            uid: this.sender.uid,
+            sameUser: opts.sameUser !== false,
+            timeout: parseDuration(opts.timeout, DEFAULT_PROMPT_TIMEOUT),
+            filter: opts.filter,
+            plugin: binding?.name ?? "未知",
+            signal: binding?.signal
+        });
+    }
+    /**
+     * 剥除开头的机器人昵称
+     *
+     * 取**最长**匹配而非遍历顺序上的第一个：昵称配置为 `["云", "云崽"]` 时，
+     * 先命中 `云` 会将 `云崽帮我看看` 剥为 `崽帮我看看`。一次遍历即可求得最长者，
+     * 不必为此排序（昵称列表可能在 WebUI 中随时修改，排序结果无法长期缓存）。
+     * @param text 当前纯文本
+     * @returns 剥除昵称后的文本；未命中昵称时 undefined
+     */
+    #stripNickname(text) {
+        if (text === "")
+            return undefined;
+        let best = "";
+        for (const nick of this.#policy.nicknames) {
+            if (nick === "" || nick.length <= best.length)
+                continue;
+            if (text.startsWith(nick))
+                best = nick;
+        }
+        if (best === "")
+            return undefined;
+        return text.slice(best.length).replace(NICKNAME_TAIL_RE, "");
+    }
+    /**
+     * 算出回复目标
+     * @returns 发送目标
+     */
+    #computeTarget() {
+        switch (this.scene) {
+            case "group": {
+                const gid = this.group?.gid;
+                if (gid !== undefined)
+                    return { scene: "group", gid };
+                break;
+            }
+            case "guild": {
+                const ch = this.channel;
+                if (ch !== undefined)
+                    return { scene: "guild", guildId: ch.guildId, channelId: ch.channelId };
+                break;
+            }
+            case "private": {
+                const gid = this.group?.gid;
+                // 群临时会话带上来源群号：部分平台（OneBot 的 temp 会话）非它不可发
+                return gid === undefined
+                    ? { scene: "private", uid: this.sender.uid }
+                    : { scene: "private", uid: this.sender.uid, gid };
+            }
+        }
+        // 适配器声明了场景却没给对应的会话标识，属于适配器 bug。
+        // 退化成私聊回给发送者：至少用户能看到回复，而不是静默失败。
+        this.#logger.error(`事件 ${this.id} 的场景为 ${this.scene} 但缺少${this.scene === "group" ? "群号" : "频道信息"}，` +
+            `已退化为私聊回复；请检查适配器 ${this.bot.adapterId}`);
+        return { scene: "private", uid: this.sender.uid };
+    }
+}
+/**
+ * 运行时事件工厂
+ *
+ * 内核里唯一构造事件的地方。适配器把 `IncomingEvent` 交给 `host.submit()`，
+ * 由 dispatch 调这里补全成运行时形态。
+ */
+export class EventFactory {
+    /** 工厂依赖 */
+    #opts;
+    /**
+     * @param opts 构造参数
+     */
+    constructor(opts) {
+        this.#opts = opts;
+    }
+    /**
+     * 按事件大类分派构造
+     * @param incoming 适配器产出的事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时事件
+     */
+    create(incoming, bot) {
+        switch (incoming.kind) {
+            case "message":
+                return this.createMessage(incoming, bot);
+            case "notice":
+                return this.createNotice(incoming, bot);
+            case "request":
+                return this.createRequest(incoming, bot);
+            case "meta":
+                return this.createMeta(incoming, bot);
+        }
+    }
+    /**
+     * 构造运行时消息事件
+     * @param incoming 适配器产出的消息事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时消息事件
+     */
+    createMessage(incoming, bot) {
+        return new MessageEventImpl(incoming, bot, this.#opts);
+    }
+    /**
+     * 构造运行时通知事件
+     * @param incoming 适配器产出的通知事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时通知事件
+     */
+    createNotice(incoming, bot) {
+        const target = noticeTargetOf(incoming);
+        let stopped = false;
+        const event = {
+            ...incoming,
+            id: incoming.id ?? createEventId(),
+            time: incoming.time ?? Date.now(),
+            platform: bot.platform,
+            selfId: bot.selfId,
+            bot,
+            raw: incoming.raw,
+            state: {},
+            stop() {
+                stopped = true;
+            },
+            // 写成 getter 而不是普通字段：`stop()` 必须能被下游立刻看见
+            get stopped() {
+                return stopped;
+            },
+            /**
+             * 就地回复
+             * @param content 消息内容
+             * @returns 发送结果
+             * @throws 该通知没有可回复的会话时
+             */
+            async reply(content) {
+                if (target === undefined) {
+                    throw new Error(`通知事件 ${incoming.noticeType} 没有可回复的会话（既无群号也无用户 id）`);
+                }
+                return bot.sendMessage(target, content);
+            }
+        };
+        return event;
+    }
+    /**
+     * 构造运行时请求事件
+     * @param incoming 适配器产出的请求事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时请求事件
+     */
+    createRequest(incoming, bot) {
+        let stopped = false;
+        /**
+         * 落到平台的同意/拒绝
+         *
+         * 好友与加群的第三个参数含义不同：好友是"同意后设置的备注"，
+         * 加群是"拒绝的理由"。该不对称源自 OneBot，在此处封装以免插件误用。
+         * @param approve 是否同意
+         * @param extra 备注或理由
+         */
+        const handle = async (approve, extra) => {
+            if (incoming.requestType === "friend") {
+                if (bot.handleFriendRequest === undefined) {
+                    throw new Error(`账号 ${bot.selfId} 的适配器未实现处理好友请求`);
+                }
+                await bot.handleFriendRequest(incoming.flag, approve, approve ? extra : undefined);
+                return;
+            }
+            if (bot.handleGroupRequest === undefined) {
+                throw new Error(`账号 ${bot.selfId} 的适配器未实现处理加群请求`);
+            }
+            await bot.handleGroupRequest(incoming.flag, approve, approve ? undefined : extra);
+        };
+        const event = {
+            ...incoming,
+            id: incoming.id ?? createEventId(),
+            time: incoming.time ?? Date.now(),
+            platform: bot.platform,
+            selfId: bot.selfId,
+            bot,
+            raw: incoming.raw,
+            state: {},
+            stop() {
+                stopped = true;
+            },
+            /** 是否已被阻断 */
+            get stopped() {
+                return stopped;
+            },
+            /**
+             * 同意
+             * @param extra 好友请求的备注
+             */
+            async approve(extra) {
+                await handle(true, extra);
+            },
+            /**
+             * 拒绝
+             * @param reason 拒绝理由
+             */
+            async reject(reason) {
+                await handle(false, reason);
+            }
+        };
+        return event;
+    }
+    /**
+     * 构造运行时元事件
+     * @param incoming 适配器产出的元事件
+     * @param bot 接收该事件的 Bot
+     * @returns 运行时元事件
+     */
+    createMeta(incoming, bot) {
+        let stopped = false;
+        const event = {
+            ...incoming,
+            id: incoming.id ?? createEventId(),
+            time: incoming.time ?? Date.now(),
+            platform: bot.platform,
+            selfId: bot.selfId,
+            bot,
+            raw: incoming.raw,
+            state: {},
+            stop() {
+                stopped = true;
+            },
+            /** 是否已被阻断 */
+            get stopped() {
+                return stopped;
+            }
+        };
+        return event;
+    }
+}
+//# sourceMappingURL=event.js.map