@zhin.js/core 1.1.34 → 1.1.35

package/lib/{prompt.js → schema-interaction.js}

@@ -1,10 +1,10 @@
 /**
  * Prompt类：用于实现机器人与用户的交互式提问与输入收集。
  * 支持文本、数字、确认、列表、选项、Schema等多种输入类型，自动处理超时、默认值、格式化等。
- * 典型用法：await new Prompt(plugin, event).text('请输入内容')
+ * 典型用法：await new SchemaInteraction(plugin, event).text('请输入内容')
  * @template P 适配器类型
  */
-export class Prompt {
+export class SchemaInteraction {
     plugin;
     event;
     /**
@@ -20,18 +20,22 @@ export class Prompt {
      * 获取当前会话唯一标识（适配器-机器人-频道-用户）
      */
     getChannelAddress(event) {
-        return `${event.$adapter}-${event.$bot}-${event.$channel.type}:${event.$channel.id}-${event.$sender.id}`;
+        return `${event.$adapter}-${event.$endpoint}-${event.$channel.type}:${event.$channel.id}-${event.$sender.id}`;
     }
     /**
      * 通用提问方法，支持自定义格式化、超时、默认值等
      * @param config 提问配置
      */
-    prompt(config) {
+    collect(config) {
         return new Promise(async (resolve, reject) => {
+            if (!this.event.$reply) {
+                reject(new Error('SchemaInteraction requires outbound capability on the current endpoint'));
+                return;
+            }
             const id = await this.event.$reply(config.tips);
             this.middleware(input => {
                 if (input instanceof Error) {
-                    this.event.$reply(input.message);
+                    void this.event.$reply?.(input.message);
                     if (config.defaultValue)
                         resolve(config.defaultValue);
                     else
@@ -39,7 +43,7 @@ export class Prompt {
                     return;
                 }
                 const adapter = this.plugin.inject(this.event.$adapter);
-                adapter.emit('call.recallMessage', this.event.$bot, id);
+                adapter.emit('call.recallMessage', this.event.$endpoint, id);
                 resolve(config.format(input));
             }, config.timeout, config.timeoutText);
         });
@@ -58,7 +62,7 @@ export class Prompt {
             dispose();
             clearTimeout(timer);
         };
-        const dispose = this.plugin.addMiddleware(middleware);
+        const dispose = this.plugin.root.addMiddleware(middleware);
         const timer = setTimeout(() => {
             dispose();
             callback(new Error(timeoutText));
@@ -68,7 +72,7 @@ export class Prompt {
      * 文本输入
      */
     async text(tips, timeout, defaultValue = '', timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips,
             defaultValue,
             timeoutText,
@@ -80,7 +84,7 @@ export class Prompt {
      * 任意输入
      */
     async any(tips, timeout, defaultValue = '', timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips,
             defaultValue,
             timeoutText,
@@ -92,7 +96,7 @@ export class Prompt {
      * 数字输入
      */
     async number(tips, timeout, defaultValue = 0, timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips,
             defaultValue,
             timeoutText,
@@ -104,7 +108,7 @@ export class Prompt {
      * 确认输入（如 yes/no）
      */
     async confirm(tips, condition = 'yes', timeout, defaultValue = false, timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips: `${tips}\n输入“${condition}”以确认`,
             defaultValue,
             timeout,
@@ -117,7 +121,7 @@ export class Prompt {
      */
     async list(tips, config = { type: 'text' }, timeoutText) {
         const separator = config.separator || ',';
-        return this.prompt({
+        return this.collect({
             tips: `${tips}\n值之间使用“${separator}”分隔`,
             defaultValue: config.defaultValue || [],
             timeout: config.timeout,
@@ -150,7 +154,7 @@ export class Prompt {
         const separator = config.separator || ',';
         if (config.multiple)
             moreTextArr.push(`多选请用“${separator}”分隔`);
-        return this.prompt({
+        return this.collect({
             tips: `${tips}\n${moreTextArr.join('\n')}`,
             defaultValue: config.defaultValue,
             timeout: config.timeout,
@@ -209,18 +213,18 @@ export class Prompt {
                 return (await this.confirm(schema.meta.description || schema.meta.key || 'Confirm'));
             case 'object':
                 if (schema.meta.description)
-                    await this.event.$reply(schema.meta.description);
+                    await this.event.$reply?.(schema.meta.description);
                 if (!schema.options.object)
                     throw new Error('Object schema missing object definition');
                 return (await this.getValueWithSchemas(schema.options.object));
             case 'date':
-                return await this.prompt({
+                return await this.collect({
                     tips: schema.meta.description || schema.meta.key || 'Enter a date',
                     defaultValue: schema.meta.default || new Date(),
                     format: (input) => new Date(input),
                 });
             case 'regexp':
-                return await this.prompt({
+                return await this.collect({
                     tips: schema.meta.description || schema.meta.key || 'Enter a regex pattern',
                     defaultValue: schema.meta.default || '',
                     format: (input) => new RegExp(input),
@@ -241,4 +245,3 @@ export class Prompt {
         }
     }
 }
-//# sourceMappingURL=prompt.js.map

package/lib/side-event/base.d.ts

@@ -0,0 +1,52 @@
+import type { Adapters } from '../adapter.js';
+import type { MessageSender } from '../types.js';
+/**
+ * Side Event 共享基础结构（Notice 与 Request 共用）。
+ * 字段统一为 `$foo_bar` 命名。
+ *
+ * 完整事件名：`${$type}.${$scene_type}.${$sub_type}`（见 `formatSideEventName`）。
+ */
+export interface SideEventBase {
+    /** 平台侧去重键 / flag（非 DB 行 id） */
+    $id: string;
+    $adapter: keyof Adapters;
+    $endpoint: string;
+    /** 命名空间：`notice` 或 `request` */
+    $type: string;
+    /** 平台场景 ID（群号、用户号、频道 ID 等） */
+    $scene_id: string;
+    /** 场景域（如 group、friend、channel、endpoint） */
+    $scene_type?: string;
+    /** 动作子类型（如 member_increase、add、poke） */
+    $sub_type?: string;
+    /** 主参与者（原 Notice.$operator / Request.$sender） */
+    $actor?: MessageSender;
+    /** 被操作对象 */
+    $target?: MessageSender;
+    /** 毫秒时间戳 */
+    $timestamp: number;
+    /** Canonical relation fields populated by the Adapter boundary. */
+    $message_id?: string;
+    $reaction?: string;
+    $operation?: 'added' | 'removed';
+    $duration_seconds?: number;
+    $role?: string;
+    $enabled?: boolean;
+}
+/** 组合 Side Event 完整类型名 */
+export declare function composeSideEventName(type: string, sceneType: string | undefined, subType: string | undefined): string;
+/** 从 Side Event 字段生成完整类型名 */
+export declare function formatSideEventName(event: Pick<SideEventBase, '$type' | '$scene_type' | '$sub_type'>): string;
+/** 判断 Side Event 是否匹配完整类型名（如 `notice.group.member_increase`） */
+export declare function matchesSideEventName(event: Pick<SideEventBase, '$type' | '$scene_type' | '$sub_type'>, fullName: string): boolean;
+/** 解析完整类型名为三段 */
+export declare function parseSideEventName(fullName: string): {
+    type: string;
+    scene_type?: string;
+    sub_type?: string;
+};
+/** 将 Side Event 场景映射为 IM 发送通道（group-suite 等消费者用） */
+export declare function sideEventSendChannel(event: Pick<SideEventBase, '$scene_type' | '$scene_id'>): {
+    id: string;
+    type: 'group' | 'private' | 'channel';
+};

package/lib/side-event/base.js

@@ -0,0 +1,30 @@
+/** 组合 Side Event 完整类型名 */
+export function composeSideEventName(type, sceneType, subType) {
+    return [type, sceneType, subType].filter((p) => !!p).join('.');
+}
+/** 从 Side Event 字段生成完整类型名 */
+export function formatSideEventName(event) {
+    return composeSideEventName(event.$type, event.$scene_type, event.$sub_type);
+}
+/** 判断 Side Event 是否匹配完整类型名（如 `notice.group.member_increase`） */
+export function matchesSideEventName(event, fullName) {
+    return formatSideEventName(event) === fullName;
+}
+/** 解析完整类型名为三段 */
+export function parseSideEventName(fullName) {
+    const parts = fullName.split('.');
+    return {
+        type: parts[0] ?? '',
+        scene_type: parts[1],
+        sub_type: parts.slice(2).join('.') || undefined,
+    };
+}
+/** 将 Side Event 场景映射为 IM 发送通道（group-suite 等消费者用） */
+export function sideEventSendChannel(event) {
+    const domain = event.$scene_type ?? 'private';
+    if (domain === 'group')
+        return { id: event.$scene_id, type: 'group' };
+    if (domain === 'channel')
+        return { id: event.$scene_id, type: 'channel' };
+    return { id: event.$scene_id, type: 'private' };
+}

package/lib/side-event/dispatch.d.ts

@@ -0,0 +1,15 @@
+import type { EndpointEventEmitter } from '@zhin.js/adapter';
+import { type OneBotLikeRawEvent, type SideEventPlatform } from './normalize.js';
+export interface OneBotLikeSideEventInput {
+    readonly adapter: string;
+    readonly endpointKey: string;
+    readonly platform?: SideEventPlatform;
+    readonly raw: OneBotLikeRawEvent;
+    readonly approve?: (flag: string, remark?: string) => void | Promise<void>;
+    readonly reject?: (flag: string, reason?: string) => void | Promise<void>;
+}
+/**
+ * Normalize OneBot / icqq-style notice|request|meta payloads and feed Endpoint.emit().
+ * Returns which kind was dispatched, or null when the payload is not a side event.
+ */
+export declare function receiveOneBotLikeSideEvent(emit: EndpointEventEmitter, input: OneBotLikeSideEventInput): Promise<'notice' | 'request' | 'system' | null>;

package/lib/side-event/dispatch.js

@@ -0,0 +1,140 @@
+import { buildNotice, buildRequest, buildSystem, mapNoticeParts, mapRequestParts, resolveSideEventDedupeKey, senderFromId, } from './normalize.js';
+/**
+ * Normalize OneBot / icqq-style notice|request|meta payloads and feed Endpoint.emit().
+ * Returns which kind was dispatched, or null when the payload is not a side event.
+ */
+export async function receiveOneBotLikeSideEvent(emit, input) {
+    const raw = input.raw;
+    const platform = input.platform ?? 'onebot';
+    const postType = String(raw.post_type ?? raw.type ?? '');
+    if (postType === 'notice' || postType.startsWith('notice.')) {
+        const noticeType = String(raw.notice_type ?? (postType.replace(/^notice\.?/, '') || 'unknown'));
+        const parts = mapNoticeParts(platform, noticeType, {
+            sub_type: raw.sub_type != null ? String(raw.sub_type) : undefined,
+            is_group: raw.group_id != null,
+        });
+        const id = resolveSideEventDedupeKey(raw, 'notice');
+        const memberEvent = ['member_increase', 'member_decrease', 'ban', 'admin_change'].includes(parts.sub_type);
+        const actorId = raw.operator_id
+            ?? (!memberEvent ? raw.user_id : undefined);
+        const targetId = memberEvent
+            ? raw.user_id
+            : parts.sub_type === 'poke'
+                ? raw.target_id ?? raw.self_id
+                : raw.user_id != null && String(raw.user_id) !== String(raw.operator_id ?? '')
+                    ? raw.user_id
+                    : undefined;
+        const notice = buildNotice(raw, {
+            $id: id,
+            $adapter: input.adapter,
+            $endpoint: input.endpointKey,
+            $type: 'notice',
+            $scene_id: String(raw.group_id ?? raw.user_id ?? input.endpointKey),
+            $scene_type: parts.scene_type,
+            $sub_type: parts.sub_type,
+            $actor: senderFromId(actorId),
+            $target: senderFromId(targetId),
+            $timestamp: toMillis(raw.time),
+            ...(raw.message_id != null ? { $message_id: String(raw.message_id) } : {}),
+            ...(raw.emoji_id != null || raw.code != null
+                ? { $reaction: String(raw.emoji_id ?? raw.code) }
+                : {}),
+            ...(parts.sub_type === 'emoji_reaction'
+                ? { $operation: /delete|remove/i.test(String(raw.sub_type ?? noticeType)) ? 'removed' : 'added' }
+                : {}),
+            ...(raw.duration != null ? { $duration_seconds: Math.max(0, Number(raw.duration) || 0) } : {}),
+            ...(parts.sub_type === 'admin_change'
+                ? { $role: 'admin', $enabled: String(raw.sub_type ?? '') === 'set' }
+                : {}),
+        });
+        await emit('notice.receive', notice);
+        return 'notice';
+    }
+    if (postType === 'request' || postType.startsWith('request.')) {
+        const requestType = String(raw.request_type ?? (postType.replace(/^request\.?/, '') || 'friend'));
+        const parts = mapRequestParts(platform, requestType, raw.sub_type != null ? String(raw.sub_type) : undefined);
+        const flag = raw.flag != null ? String(raw.flag) : '';
+        const id = flag || resolveSideEventDedupeKey(raw, 'request');
+        const actor = senderFromId(raw.user_id);
+        if (!actor)
+            return null;
+        const approve = input.approve;
+        const reject = input.reject;
+        let active = true;
+        const actions = new Set();
+        const requireActiveAction = () => {
+            if (!active)
+                throw new Error('Request action port expired with its generation operation');
+        };
+        const runAction = (action) => {
+            requireActiveAction();
+            const operation = Promise.resolve().then(action);
+            actions.add(operation);
+            void operation.then(() => actions.delete(operation), () => actions.delete(operation));
+            return operation;
+        };
+        const request = buildRequest(raw, {
+            $id: id,
+            $adapter: input.adapter,
+            $endpoint: input.endpointKey,
+            $type: 'request',
+            $scene_id: String(raw.group_id ?? raw.user_id ?? input.endpointKey),
+            $scene_type: parts.scene_type,
+            $sub_type: parts.sub_type,
+            $actor: actor,
+            $comment: raw.comment != null ? String(raw.comment) : undefined,
+            $timestamp: toMillis(raw.time),
+            async $approve(remark) {
+                if (!approve || !flag)
+                    throw new Error('Request approve is not available');
+                await runAction(() => approve(flag, remark));
+            },
+            async $reject(reason) {
+                if (!reject || !flag)
+                    throw new Error('Request reject is not available');
+                await runAction(() => reject(flag, reason));
+            },
+        });
+        try {
+            await emit('request.receive', request);
+        }
+        finally {
+            active = false;
+            await Promise.allSettled([...actions]);
+        }
+        return 'request';
+    }
+    if (postType === 'meta_event'
+        || postType === 'meta'
+        || postType.startsWith('meta.')
+        || postType.startsWith('system.')) {
+        const metaType = String(raw.meta_event_type
+            ?? raw.detail_type
+            ?? (postType.replace(/^(meta_event|meta|system)\.?/, '') || 'unknown'));
+        const subType = raw.sub_type != null ? String(raw.sub_type) : undefined;
+        const sceneType = postType.startsWith('system.')
+            ? (postType.split('.')[1] ?? 'system')
+            : metaType === 'lifecycle' || metaType === 'heartbeat'
+                ? metaType
+                : 'meta';
+        const system = buildSystem(raw, {
+            $id: `system:${toMillis(raw.time)}_${metaType}_${subType ?? ''}`,
+            $adapter: input.adapter,
+            $endpoint: input.endpointKey,
+            $type: 'system',
+            $scene_id: String(raw.self_id ?? input.endpointKey),
+            $scene_type: sceneType,
+            $sub_type: subType ?? metaType,
+            $timestamp: toMillis(raw.time),
+        });
+        await emit('system.receive', system);
+        return 'system';
+    }
+    return null;
+}
+function toMillis(time) {
+    const seconds = Number(time);
+    return Number.isFinite(seconds) && seconds > 0
+        ? (seconds < 1e12 ? seconds * 1000 : seconds)
+        : Date.now();
+}

package/lib/side-event/index.d.ts

@@ -0,0 +1,4 @@
+export * from './base.js';
+export * from './types.js';
+export * from './normalize.js';
+export * from './dispatch.js';

package/lib/side-event/index.js

@@ -0,0 +1,4 @@
+export * from './base.js';
+export * from './types.js';
+export * from './normalize.js';
+export * from './dispatch.js';

package/lib/side-event/normalize.d.ts

@@ -0,0 +1,42 @@
+import { Notice, type NoticeBase } from '../notice.js';
+import { Request, type RequestBase } from '../request.js';
+import { SystemEvent, type SystemEventBase } from '../system-event.js';
+import { type ComposedNoticeName, type ComposedRequestName, type SideEventParts } from './types.js';
+export type SideEventPlatform = 'onebot' | 'icqq' | 'napcat' | 'kook' | (string & {});
+export interface OneBotLikeRawEvent {
+    notice_type?: string;
+    request_type?: string;
+    sub_type?: string;
+    group_id?: number | string;
+    user_id?: number | string;
+    operator_id?: number | string;
+    flag?: string;
+    time?: number;
+    self_id?: number | string;
+    [key: string]: unknown;
+}
+/** 去重用：notice / request 无稳定 id 时组合键 */
+export declare function resolveSideEventDedupeKey(data: OneBotLikeRawEvent, kind: 'notice' | 'request'): string;
+/**
+ * 将平台原始 notice_type 映射为标准 `$scene_type` + `$sub_type`。
+ */
+export declare function mapNoticeParts(platform: SideEventPlatform, raw: string, options?: {
+    sub_type?: string;
+    is_group?: boolean;
+    notify_handler?: (subType: string | undefined, isGroup: boolean) => SideEventParts;
+}): SideEventParts;
+/**
+ * 将平台原始 request_type 映射为标准 `$scene_type` + `$sub_type`。
+ */
+export declare function mapRequestParts(_platform: SideEventPlatform, raw: string, subType?: string): SideEventParts;
+/** 组合完整 Notice 类型名（兼容旧 API） */
+export declare function mapNoticeType(platform: SideEventPlatform, raw: string, options?: Parameters<typeof mapNoticeParts>[2]): ComposedNoticeName;
+/** 组合完整 Request 类型名（兼容旧 API） */
+export declare function mapRequestType(platform: SideEventPlatform, raw: string, subType?: string): ComposedRequestName;
+export declare function senderFromId(id: unknown, name?: string): {
+    id: string;
+    name: string;
+} | undefined;
+export declare function buildNotice<T extends object>(input: T, format: NoticeBase): Notice<T>;
+export declare function buildRequest<T extends object>(input: T, format: RequestBase): Request<T>;
+export declare function buildSystem<T extends object>(input: T, format: SystemEventBase): SystemEvent<T>;

package/lib/side-event/normalize.js

@@ -0,0 +1,121 @@
+import { Notice } from '../notice.js';
+import { Request } from '../request.js';
+import { SystemEvent } from '../system-event.js';
+import { composeSideEventName, parseSideEventName, } from './base.js';
+import { KOOK_NOTICE_PARTS_MAP, ONEBOT_NOTICE_PARTS_MAP, SLACK_NOTICE_PARTS_MAP } from './types.js';
+/** 去重用：notice / request 无稳定 id 时组合键 */
+export function resolveSideEventDedupeKey(data, kind) {
+    if (data.flag != null && String(data.flag) !== '') {
+        return `${kind}:${data.flag}`;
+    }
+    const time = data.time ?? 0;
+    const type = data.notice_type ?? data.request_type ?? kind;
+    const scope = data.group_id ?? data.user_id ?? '';
+    const sub = data.sub_type ?? '';
+    return `${kind}:${time}_${type}_${scope}_${sub}`;
+}
+function resolveNotifyNoticeParts(subType, isGroup) {
+    if (subType === 'poke') {
+        return isGroup
+            ? { scene_type: 'group', sub_type: 'poke' }
+            : { scene_type: 'friend', sub_type: 'poke' };
+    }
+    if (subType === 'input_status')
+        return { scene_type: 'notify', sub_type: 'input_status' };
+    if (subType === 'title')
+        return { scene_type: 'notify', sub_type: 'title_change' };
+    if (subType === 'profile_like')
+        return { scene_type: 'notify', sub_type: 'profile_like' };
+    return { scene_type: 'notify', sub_type: subType ?? 'unknown' };
+}
+function resolveEssenceNoticeParts(subType) {
+    return subType === 'add'
+        ? { scene_type: 'group', sub_type: 'essence_add' }
+        : { scene_type: 'group', sub_type: 'essence_delete' };
+}
+/**
+ * 将平台原始 notice_type 映射为标准 `$scene_type` + `$sub_type`。
+ */
+export function mapNoticeParts(platform, raw, options) {
+    const subType = options?.sub_type;
+    const isGroup = options?.is_group ?? false;
+    if (platform === 'kook') {
+        return KOOK_NOTICE_PARTS_MAP[raw] ?? { scene_type: 'kook', sub_type: raw };
+    }
+    if (platform === 'slack') {
+        return SLACK_NOTICE_PARTS_MAP[raw] ?? { scene_type: 'slack', sub_type: raw };
+    }
+    if (raw === 'notify') {
+        const handler = options?.notify_handler ?? resolveNotifyNoticeParts;
+        return handler(subType, isGroup);
+    }
+    if (raw === 'essence') {
+        return resolveEssenceNoticeParts(subType);
+    }
+    if (ONEBOT_NOTICE_PARTS_MAP[raw]) {
+        return ONEBOT_NOTICE_PARTS_MAP[raw];
+    }
+    if (raw.startsWith('notice.')) {
+        const parsed = parseSideEventName(raw);
+        if (parsed.scene_type && parsed.sub_type) {
+            return { scene_type: parsed.scene_type, sub_type: parsed.sub_type };
+        }
+        const suffix = raw.slice('notice.'.length).replace(/\./g, '_');
+        if (ONEBOT_NOTICE_PARTS_MAP[suffix])
+            return ONEBOT_NOTICE_PARTS_MAP[suffix];
+        return { scene_type: parsed.scene_type ?? 'unknown', sub_type: parsed.sub_type ?? suffix };
+    }
+    if (platform === 'icqq' || platform === 'onebot' || platform === 'napcat') {
+        const dotted = raw.replace(/_/g, '.');
+        const parsed = parseSideEventName(`notice.${dotted}`);
+        return {
+            scene_type: parsed.scene_type ?? dotted.split('.')[0] ?? 'unknown',
+            sub_type: parsed.sub_type ?? (dotted.split('.').slice(1).join('.') || raw),
+        };
+    }
+    return { scene_type: platform, sub_type: raw };
+}
+/**
+ * 将平台原始 request_type 映射为标准 `$scene_type` + `$sub_type`。
+ */
+export function mapRequestParts(_platform, raw, subType) {
+    if (raw === 'friend' || raw.startsWith('friend')) {
+        return { scene_type: 'friend', sub_type: 'add' };
+    }
+    if (raw === 'group' || raw.startsWith('group')) {
+        return { scene_type: 'group', sub_type: subType === 'invite' ? 'invite' : 'add' };
+    }
+    if (raw.startsWith('request.')) {
+        const parsed = parseSideEventName(raw);
+        return {
+            scene_type: parsed.scene_type ?? 'unknown',
+            sub_type: parsed.sub_type ?? 'unknown',
+        };
+    }
+    return { scene_type: raw, sub_type: subType ?? 'unknown' };
+}
+/** 组合完整 Notice 类型名（兼容旧 API） */
+export function mapNoticeType(platform, raw, options) {
+    const parts = mapNoticeParts(platform, raw, options);
+    return composeSideEventName('notice', parts.scene_type, parts.sub_type);
+}
+/** 组合完整 Request 类型名（兼容旧 API） */
+export function mapRequestType(platform, raw, subType) {
+    const parts = mapRequestParts(platform, raw, subType);
+    return composeSideEventName('request', parts.scene_type, parts.sub_type);
+}
+export function senderFromId(id, name) {
+    if (id == null || id === '')
+        return undefined;
+    const s = String(id);
+    return { id: s, name: name ?? s };
+}
+export function buildNotice(input, format) {
+    return Notice.from(input, format);
+}
+export function buildRequest(input, format) {
+    return Request.from(input, format);
+}
+export function buildSystem(input, format) {
+    return SystemEvent.from(input, format);
+}

package/lib/side-event/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Side Event 标准类型。
+ * 运行时 `$type` 仅存命名空间（`notice` / `request` / `system`）；
+ * 完整名由 `${$type}.${$scene_type}.${$sub_type}` 组合。
+ */
+export type SideEventKind = 'notice' | 'request' | 'system';
+export type NoticeKind = 'notice';
+export type RequestKind = 'request';
+export type SystemKind = 'system';
+/** 完整组合名（测试 / 文档 / 消费者匹配用） */
+export type ComposedNoticeName = 'notice.group.member_increase' | 'notice.group.member_decrease' | 'notice.group.admin_change' | 'notice.group.ban' | 'notice.group.recall' | 'notice.group.poke' | 'notice.group.transfer' | 'notice.group.upload' | 'notice.group.emoji_reaction' | 'notice.group.card_change' | 'notice.group.essence_add' | 'notice.group.essence_delete' | 'notice.friend.recall' | 'notice.friend.increase' | 'notice.friend.poke' | 'notice.endpoint.lifecycle' | (string & {});
+export type ComposedRequestName = 'request.friend.add' | 'request.group.add' | 'request.group.invite' | (string & {});
+export type ComposedSystemName = 'system.login.qrcode' | 'system.login.slider' | 'system.login.device' | 'system.login.error' | 'system.login.auth' | 'system.offline' | 'system.offline.network' | 'system.offline.kickoff' | 'system.online' | (string & {});
+export interface SideEventParts {
+    scene_type: string;
+    sub_type: string;
+}
+/** OneBot / icqq 等平台 notice_type 原始值 → 标准 scene_type + sub_type */
+export declare const ONEBOT_NOTICE_PARTS_MAP: Record<string, SideEventParts>;
+/** KOOK extra.type 原始值 → 标准 scene_type + sub_type */
+export declare const KOOK_NOTICE_PARTS_MAP: Record<string, SideEventParts>;
+/** Slack event type 原始值 → 标准 scene_type + sub_type */
+export declare const SLACK_NOTICE_PARTS_MAP: Record<string, SideEventParts>;

package/lib/side-event/types.js

@@ -0,0 +1,55 @@
+/**
+ * Side Event 标准类型。
+ * 运行时 `$type` 仅存命名空间（`notice` / `request` / `system`）；
+ * 完整名由 `${$type}.${$scene_type}.${$sub_type}` 组合。
+ */
+/** OneBot / icqq 等平台 notice_type 原始值 → 标准 scene_type + sub_type */
+export const ONEBOT_NOTICE_PARTS_MAP = {
+    group_increase: { scene_type: 'group', sub_type: 'member_increase' },
+    group_decrease: { scene_type: 'group', sub_type: 'member_decrease' },
+    group_admin: { scene_type: 'group', sub_type: 'admin_change' },
+    group_ban: { scene_type: 'group', sub_type: 'ban' },
+    group_recall: { scene_type: 'group', sub_type: 'recall' },
+    friend_recall: { scene_type: 'friend', sub_type: 'recall' },
+    friend_add: { scene_type: 'friend', sub_type: 'increase' },
+    group_upload: { scene_type: 'group', sub_type: 'upload' },
+    group_transfer: { scene_type: 'group', sub_type: 'transfer' },
+    group_card: { scene_type: 'group', sub_type: 'card_change' },
+    group_msg_emoji_like: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    'group.increase': { scene_type: 'group', sub_type: 'member_increase' },
+    'group.decrease': { scene_type: 'group', sub_type: 'member_decrease' },
+    'group.admin': { scene_type: 'group', sub_type: 'admin_change' },
+    'group.ban': { scene_type: 'group', sub_type: 'ban' },
+    'group.recall': { scene_type: 'group', sub_type: 'recall' },
+    'friend.increase': { scene_type: 'friend', sub_type: 'increase' },
+    'friend.decrease': { scene_type: 'friend', sub_type: 'recall' },
+    'friend.recall': { scene_type: 'friend', sub_type: 'recall' },
+};
+/** KOOK extra.type 原始值 → 标准 scene_type + sub_type */
+export const KOOK_NOTICE_PARTS_MAP = {
+    joined_guild: { scene_type: 'group', sub_type: 'member_increase' },
+    exited_guild: { scene_type: 'group', sub_type: 'member_decrease' },
+    deleted_message: { scene_type: 'group', sub_type: 'recall' },
+    deleted_private_message: { scene_type: 'friend', sub_type: 'recall' },
+    added_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    deleted_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    private_added_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    private_deleted_reaction: { scene_type: 'group', sub_type: 'emoji_reaction' },
+};
+/** Slack event type 原始值 → 标准 scene_type + sub_type */
+export const SLACK_NOTICE_PARTS_MAP = {
+    member_joined_channel: { scene_type: 'group', sub_type: 'member_increase' },
+    member_left_channel: { scene_type: 'group', sub_type: 'member_decrease' },
+    reaction_added: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    reaction_removed: { scene_type: 'group', sub_type: 'emoji_reaction' },
+    message_deleted: { scene_type: 'group', sub_type: 'recall' },
+    channel_archive: { scene_type: 'slack', sub_type: 'channel_archive' },
+    channel_unarchive: { scene_type: 'slack', sub_type: 'channel_unarchive' },
+    channel_rename: { scene_type: 'slack', sub_type: 'channel_rename' },
+    channel_created: { scene_type: 'slack', sub_type: 'channel_created' },
+    channel_deleted: { scene_type: 'slack', sub_type: 'channel_deleted' },
+    pin_added: { scene_type: 'slack', sub_type: 'pin_added' },
+    pin_removed: { scene_type: 'slack', sub_type: 'pin_removed' },
+    app_home_opened: { scene_type: 'slack', sub_type: 'app_home_opened' },
+    team_join: { scene_type: 'friend', sub_type: 'increase' },
+};

package/lib/system-event.d.ts

@@ -0,0 +1,15 @@
+import type { Adapters } from './adapter.js';
+import type { SideEventBase } from './side-event/base.js';
+/**
+ * 系统/登录侧事件（扫码、滑块、掉线等）。
+ * `$scene_type`：`login` / `offline` / `online` 等；
+ * `$sub_type`：`qrcode` / `slider` / `device` / `kickoff` / `network` 等。
+ */
+export interface SystemEventBase extends SideEventBase {
+    $adapter: keyof Adapters;
+    $type: 'system';
+}
+export type SystemEvent<T extends object = {}> = SystemEventBase & T;
+export declare namespace SystemEvent {
+    function from<T extends object>(input: T, format: SystemEventBase): SystemEvent<T>;
+}

package/lib/system-event.js

@@ -0,0 +1,7 @@
+export var SystemEvent;
+(function (SystemEvent) {
+    function from(input, format) {
+        return Object.assign(input, format);
+    }
+    SystemEvent.from = from;
+})(SystemEvent || (SystemEvent = {}));