@napuketto/adapter 0.0.1 → 0.0.3

package/dist/raw-message-Du7tvR1D.mjs

@@ -0,0 +1,59 @@
+import { z } from "zod";
+//#region src/core/transport-schema.ts
+/**
+* 协议传输实例 schema（OB11 / Satori 共用，2026-08-08 克隆合并）
+*
+* HTTP 反向服务器 / WS 事件服务器的实例级 schema 结构两协议一致，
+* 仅默认端口与扩展字段不同——提取工厂函数，各协议按需调用。
+*/
+/** 传输实例基础 schema（enabled/host/port/token 骨架，HTTP 与 WS 共用）。 */
+function createServerSchema(defaultPort) {
+	return z.object({
+		enabled: z.boolean().default(false),
+		host: z.string().default("127.0.0.1"),
+		port: z.number().int().default(defaultPort),
+		/** 实例级 token，覆盖全局 token（缺省继承全局）。 */
+		token: z.string().optional()
+	});
+}
+/** HTTP 反向服务器实例 schema（第三方指令入口 / HTTP RPC，OB11 / Satori 共用）。 */
+function createHttpServerSchema(defaultPort) {
+	return createServerSchema(defaultPort);
+}
+/** WS 事件服务器实例 schema（反向 WS server，OB11 / Satori 共用）。 */
+function createWsServerSchema(defaultPort) {
+	return createServerSchema(defaultPort);
+}
+//#endregion
+//#region src/core/gray-tip.ts
+/** 收集 grayTip 涉及的 uid（批量 uidToUin 用）。 */
+function collectGrayTipUids(msg) {
+	const uids = /* @__PURE__ */ new Set();
+	for (const el of msg.elements) {
+		const g = el.grayTipElement;
+		if (g === void 0) continue;
+		const revoke = g.revokeElement;
+		if (revoke?.operatorUid !== void 0 && revoke.operatorUid !== "") uids.add(revoke.operatorUid);
+		const grp = g.groupElement;
+		if (grp === void 0) continue;
+		if (grp.memberUid !== void 0 && grp.memberUid !== "") uids.add(grp.memberUid);
+		if (grp.adminUid !== void 0 && grp.adminUid !== "") uids.add(grp.adminUid);
+		if (grp.shutUp?.admin?.uid !== void 0 && grp.shutUp.admin.uid !== "") uids.add(grp.shutUp.admin.uid);
+		if (grp.shutUp?.member?.uid !== void 0 && grp.shutUp.member.uid !== "") uids.add(grp.shutUp.member.uid);
+	}
+	return [...uids];
+}
+//#endregion
+//#region src/core/raw-message.ts
+/** 逐条处理消息（自动规范化数组 + 过滤非对象项）。 */
+function forEachRawMessage(msgs, handler) {
+	const list = Array.isArray(msgs) ? msgs : [msgs];
+	for (const msg of list) {
+		if (!msg || typeof msg !== "object") continue;
+		handler(msg);
+	}
+}
+//#endregion
+export { createWsServerSchema as i, collectGrayTipUids as n, createHttpServerSchema as r, forEachRawMessage as t };
+
+//# sourceMappingURL=raw-message-Du7tvR1D.mjs.map

package/dist/raw-message-Du7tvR1D.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-message-Du7tvR1D.mjs","names":[],"sources":["../src/core/transport-schema.ts","../src/core/gray-tip.ts","../src/core/raw-message.ts"],"sourcesContent":["/**\n * 协议传输实例 schema（OB11 / Satori 共用，2026-08-08 克隆合并）\n *\n * HTTP 反向服务器 / WS 事件服务器的实例级 schema 结构两协议一致，\n * 仅默认端口与扩展字段不同——提取工厂函数，各协议按需调用。\n */\nimport { z } from \"zod\";\n\n/** 传输实例基础 schema（enabled/host/port/token 骨架，HTTP 与 WS 共用）。 */\nfunction createServerSchema(defaultPort: number) {\n    return z.object({\n        enabled: z.boolean().default(false),\n        host: z.string().default(\"127.0.0.1\"),\n        port: z.number().int().default(defaultPort),\n        /** 实例级 token，覆盖全局 token（缺省继承全局）。 */\n        token: z.string().optional(),\n    });\n}\n\n/** HTTP 反向服务器实例 schema（第三方指令入口 / HTTP RPC，OB11 / Satori 共用）。 */\nexport function createHttpServerSchema(defaultPort: number) {\n    return createServerSchema(defaultPort);\n}\n\n/** WS 事件服务器实例 schema（反向 WS server，OB11 / Satori 共用）。 */\nexport function createWsServerSchema(defaultPort: number) {\n    return createServerSchema(defaultPort);\n}\n","/**\n * grayTip 元素工具（OB11 / Satori 共用，2026-08-08 克隆合并）\n *\n * grayTip（系统提示消息）涉及的操作者/成员 uid 需要批量 uid→uin 转换，\n * 两协议翻译层共用同一套收集逻辑。\n */\nimport type { RawMessage } from \"@napuketto/kernel\";\n\n/** 收集 grayTip 涉及的 uid（批量 uidToUin 用）。 */\nexport function collectGrayTipUids(msg: RawMessage): string[] {\n    const uids = new Set<string>();\n    for (const el of msg.elements) {\n        const g = el.grayTipElement;\n        if (g === undefined) {\n            continue;\n        }\n        const revoke = g.revokeElement;\n        if (revoke?.operatorUid !== undefined && revoke.operatorUid !== \"\") {\n            uids.add(revoke.operatorUid);\n        }\n        const grp = g.groupElement;\n        if (grp === undefined) {\n            continue;\n        }\n        if (grp.memberUid !== undefined && grp.memberUid !== \"\") {\n            uids.add(grp.memberUid);\n        }\n        if (grp.adminUid !== undefined && grp.adminUid !== \"\") {\n            uids.add(grp.adminUid);\n        }\n        if (grp.shutUp?.admin?.uid !== undefined && grp.shutUp.admin.uid !== \"\") {\n            uids.add(grp.shutUp.admin.uid);\n        }\n        if (grp.shutUp?.member?.uid !== undefined && grp.shutUp.member.uid !== \"\") {\n            uids.add(grp.shutUp.member.uid);\n        }\n    }\n    return [...uids];\n}\n","/**\n * RawMessage 数组规范化（OB11 / Satori 共用，2026-08-08 克隆合并）\n *\n * onRecvMsg 回调参数运行时实证为消息数组（2026-08-07），但兼容单条对象\n * 传入——统一规范化为数组并过滤无效项后逐条回调。\n */\nimport type { RawMessage } from \"@napuketto/kernel\";\n\n/** 逐条处理消息（自动规范化数组 + 过滤非对象项）。 */\nexport function forEachRawMessage(msgs: unknown, handler: (msg: RawMessage) => void): void {\n    const list = Array.isArray(msgs) ? msgs : [msgs];\n    for (const msg of list) {\n        if (!msg || typeof msg !== \"object\") {\n            continue;\n        }\n        handler(msg as RawMessage);\n    }\n}\n"],"mappings":";;;;;;;;;AASA,SAAS,mBAAmB,aAAqB;CAC7C,OAAO,EAAE,OAAO;EACZ,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK;EAClC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,WAAW;EACpC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,WAAW;;EAE1C,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,CAAC;AACL;;AAGA,SAAgB,uBAAuB,aAAqB;CACxD,OAAO,mBAAmB,WAAW;AACzC;;AAGA,SAAgB,qBAAqB,aAAqB;CACtD,OAAO,mBAAmB,WAAW;AACzC;;;;AClBA,SAAgB,mBAAmB,KAA2B;CAC1D,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,MAAM,IAAI,UAAU;EAC3B,MAAM,IAAI,GAAG;EACb,IAAI,MAAM,KAAA,GACN;EAEJ,MAAM,SAAS,EAAE;EACjB,IAAI,QAAQ,gBAAgB,KAAA,KAAa,OAAO,gBAAgB,IAC5D,KAAK,IAAI,OAAO,WAAW;EAE/B,MAAM,MAAM,EAAE;EACd,IAAI,QAAQ,KAAA,GACR;EAEJ,IAAI,IAAI,cAAc,KAAA,KAAa,IAAI,cAAc,IACjD,KAAK,IAAI,IAAI,SAAS;EAE1B,IAAI,IAAI,aAAa,KAAA,KAAa,IAAI,aAAa,IAC/C,KAAK,IAAI,IAAI,QAAQ;EAEzB,IAAI,IAAI,QAAQ,OAAO,QAAQ,KAAA,KAAa,IAAI,OAAO,MAAM,QAAQ,IACjE,KAAK,IAAI,IAAI,OAAO,MAAM,GAAG;EAEjC,IAAI,IAAI,QAAQ,QAAQ,QAAQ,KAAA,KAAa,IAAI,OAAO,OAAO,QAAQ,IACnE,KAAK,IAAI,IAAI,OAAO,OAAO,GAAG;CAEtC;CACA,OAAO,CAAC,GAAG,IAAI;AACnB;;;;AC7BA,SAAgB,kBAAkB,MAAe,SAA0C;CACvF,MAAM,OAAO,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;CAC/C,KAAK,MAAM,OAAO,MAAM;EACpB,IAAI,CAAC,OAAO,OAAO,QAAQ,UACvB;EAEJ,QAAQ,GAAiB;CAC7B;AACJ"}

package/dist/satori/index.d.mts

@@ -0,0 +1,488 @@
+import { o as ActionRegistry, r as ProtocolConfig, t as BaseProtocolAdapter } from "../index-CmhGncOe.mjs";
+import "../gray-tip-CcpfI1Og.mjs";
+import { CanonicalElement, FriendApi, GroupApi, GroupCache, GroupNotifyApi, KernelErrorCode, MsgApi, MsgEventChannel, Peer, ProfileApi } from "@napuketto/kernel";
+import { ZodType, z } from "zod";
+import { EventBroadcaster, TransportAdapter } from "@napuketto/network";
+//#region src/satori/action/base-action.d.ts
+/** 动作错误（带 HTTP 状态码；由 transport 层透传）。 */
+declare class SatoriActionError extends Error {
+  readonly status: number;
+  constructor(status: number, message: string);
+}
+/**
+ * Satori 动作基类：校验 + 执行 + 错误映射。
+ * 成功返回资源对象（或数组/分页列表），失败抛 SatoriActionError。
+ */
+declare abstract class BaseSatoriAction<TPayload, TReturn> {
+  /** 动作名（resource.method，如 "message.create"）。 */
+  abstract readonly name: string;
+  /** 参数校验 schema。 */
+  abstract readonly schema: ZodType<TPayload>;
+  /** 校验并执行（HTTP/WS 共用）。 */
+  run(payload: unknown): Promise<TReturn>;
+  /** 动作实现（只抛错或返回资源；不包装响应）。 */
+  protected abstract _handle(payload: TPayload): Promise<TReturn>;
+}
+//#endregion
+//#region src/satori/helper/element/element.d.ts
+/** Satori 消息元素（与规范 satori-parse 形状一致；type="text" 为文本节点）。 */
+interface SatoriElement {
+  type: string;
+  attrs?: Record<string, string>;
+  children?: SatoriElement[];
+  text?: string;
+}
+/**
+ * 解析 Satori 消息字符串 → 元素树。
+ * 容错：未配对标签/非法标签按文本保留；解析不抛错（消息内容宽容）。
+ */
+declare function parseElements(source: string): SatoriElement[];
+/** 元素树 → Satori 消息字符串。 */
+declare function renderElements(elements: SatoriElement[]): string;
+//#endregion
+//#region src/satori/helper/element/canonical.d.ts
+/** 收方向依赖（at uid 解析）。 */
+interface CanonicalToSatoriDeps {
+  /** uid → uin（at 目标显示用；未提供原样返回 uid）。 */
+  uidToUin?: (uids: string[]) => Promise<Map<string, string>>;
+}
+/**
+ * 收方向：kernel canonical 元素 → Satori 元素树（纯函数映射，宽容忽略 unknown）。
+ * at 目标为 uid 时经 uidToUin 转换（异步）；无转换器时原样。
+ */
+declare function canonicalToSatoriElements(elements: CanonicalElement[], deps?: CanonicalToSatoriDeps): Promise<SatoriElement[]>;
+//#endregion
+//#region src/satori/helper/element/deps.d.ts
+/**
+ * 发方向转换依赖契约（Satori 元素 → kernel canonical）
+ *
+ * 2026-08-08 从 element-convert.ts 独立：media-convert.ts（媒体转换器）同样
+ * 消费该类型，独立成文件后消除 element-convert ↔ media-convert 的循环引用
+ * （madge 检测的 type-only 环）。
+ */
+/** 发方向依赖（at uin 转换 + 资源下载目录）。 */
+interface SatoriToCanonicalDeps {
+  /** uin → uid（at 目标转换）。 */
+  uinToUid: (uins: string[]) => Promise<Map<string, string>>;
+  /** 资源（img/audio/video/file）下载缓存目录。 */
+  cacheDir: string;
+}
+//#endregion
+//#region src/satori/helper/element/element-convert.d.ts
+/** 发方向：Satori 元素树 → kernel canonical（at uin→uid + 资源下载/转码）。 */
+declare function satoriToCanonicalElements(elements: SatoriElement[], deps: SatoriToCanonicalDeps): Promise<CanonicalElement[]>;
+/** 解析消息 content 字符串 → canonical（message.create 用）。 */
+declare function parseContentToCanonical(content: string, deps: SatoriToCanonicalDeps): Promise<CanonicalElement[]>;
+//#endregion
+//#region src/satori/api/satori-api.d.ts
+/** SatoriApi 构造参数。 */
+interface SatoriApiOptions {
+  msgApi: MsgApi;
+  groupApi: GroupApi;
+  groupNotifyApi: GroupNotifyApi;
+  friendApi: FriendApi;
+  profileApi: ProfileApi;
+  /** 登录身份（login.get / READY logins 用）。 */
+  self: {
+    uin: string;
+    nickname: string;
+  };
+  /** 媒体资源下载缓存目录（发方向 img/audio/video/file 的 http(s) src）。 */
+  cacheDir: string;
+  /** 群/成员缓存（ADR-008；guild.member.get / user.get 读缓存用）。 */
+  groupCache?: GroupCache;
+}
+/** Satori 动作统一依赖聚合。 */
+declare class SatoriApi {
+  readonly msgApi: MsgApi;
+  readonly groupApi: GroupApi;
+  readonly groupNotifyApi: GroupNotifyApi;
+  readonly friendApi: FriendApi;
+  readonly profileApi: ProfileApi;
+  readonly self: {
+    uin: string;
+    nickname: string;
+  };
+  readonly selfUin: string;
+  readonly cacheDir: string;
+  readonly groupCache: GroupCache | undefined;
+  /**
+   * 频道类型缓存：channel_id → isGroup（群聊频道 id 与私聊 uin 无法从数字
+   * 规则区分，需从事件/查询回填——QQ 平台群号与用户 uin 同为数字）。
+   */
+  private readonly channelTypeCache;
+  constructor(opts: SatoriApiOptions);
+  /** 记录频道类型（消息事件翻译时回填：chatType GROUP → true）。 */
+  setChannelType(channelId: string, isGroup: boolean): void;
+  /**
+   * 解析 channel_id → Peer（消息动作共用）。
+   * 缓存命中直接取类型；未命中先试群号（getGroupInfo 成功 = 群聊），
+   * 失败按私聊（uin → uid）。
+   */
+  resolvePeer(channelId: string): Promise<Peer>;
+  /** uin → 私聊 Peer（uin→uid 转换；转换失败原样 uin 兜底）。 */
+  private toC2cPeer;
+  /** uin → uid（委托 groupApi；私聊发送 / at 目标用）。 */
+  uinToUid(uins: string[]): Promise<Map<string, string>>;
+  /** uid → uin（委托 groupApi；收方向 at / 用户 ID 用）。 */
+  uidToUin(uids: string[]): Promise<Map<string, string>>;
+  /** 发方向元素转换依赖（at uin→uid + 资源下载目录）。 */
+  toCanonicalDeps(): SatoriToCanonicalDeps;
+}
+//#endregion
+//#region src/satori/action/registry.d.ts
+/** Satori 动作注册表（BaseSatoriAction 专用）。 */
+type SatoriActionRegistry = ActionRegistry<BaseSatoriAction<unknown, unknown>>;
+//#endregion
+//#region src/satori/action/index.d.ts
+/** 动作注册依赖（单聚合对象）。 */
+interface SatoriActionDeps {
+  api: SatoriApi;
+}
+/** 创建 Satori 动作注册表。 */
+declare function createSatoriActionRegistry(deps: SatoriActionDeps): SatoriActionRegistry;
+//#endregion
+//#region src/satori/helper/config.d.ts
+/** Satori 配置 schema。 */
+declare const satoriConfigSchema: z.ZodObject<{
+  token: z.ZodOptional<z.ZodString>;
+  cacheDir: z.ZodOptional<z.ZodString>;
+  httpServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  wsServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Satori 配置类型（由 schema 推导）。 */
+type SatoriConfig = z.infer<typeof satoriConfigSchema>;
+//#endregion
+//#region src/satori/helper/error.d.ts
+/** KernelErrorCode → HTTP 状态码映射表。 */
+declare const satoriHttpStatusMap: Record<KernelErrorCode, number>;
+/** HTTP 状态码常量。 */
+declare const HTTP_STATUS: {
+  readonly ok: 200;
+  readonly badRequest: 400;
+  readonly unauthorized: 401;
+  readonly forbidden: 403;
+  readonly notFound: 404;
+  readonly notImplemented: 501;
+  readonly serverError: 500;
+};
+//#endregion
+//#region src/satori/types/resource.d.ts
+/**
+ * Satori 资源类型（协议 v1，自研描述，规范参考 satori.chat/zh-CN/resources）
+ *
+ * 说明：Satori 大部分字段可选（平台差异）。QQ 平台（platform=qq）语义
+ * 见 docs/satori.md §3 ID 映射。
+ */
+/** 频道类型。 */
+declare const ChannelType: {
+  readonly TEXT: 0;
+  readonly DIRECT: 1;
+  readonly CATEGORY: 2;
+  readonly VOICE: 3;
+};
+type ChannelType = (typeof ChannelType)[keyof typeof ChannelType];
+/** 登录状态。 */
+declare const LoginStatus: {
+  readonly OFFLINE: 0;
+  readonly ONLINE: 1;
+  readonly CONNECT: 2;
+  readonly DISCONNECT: 3;
+  readonly RECONNECT: 4;
+};
+type LoginStatus = (typeof LoginStatus)[keyof typeof LoginStatus];
+/** 用户（user.id 为平台内唯一标识；QQ 平台 = uin）。 */
+interface User {
+  id: string;
+  name?: string;
+  nick?: string;
+  avatar?: string;
+  is_bot?: boolean;
+}
+/** 频道（群聊频道与群组重合：id = 群号；私聊频道 id = 对端 uin）。 */
+interface Channel {
+  id: string;
+  type: ChannelType;
+  name?: string;
+  parent_id?: string;
+}
+/** 群组（id = 群号）。 */
+interface Guild {
+  id: string;
+  name?: string;
+  avatar?: string;
+}
+/** 群组成员。 */
+interface GuildMember {
+  user?: User;
+  nick?: string;
+  avatar?: string;
+  joined_at?: number;
+  roles?: GuildRole[];
+}
+/** 群组角色。 */
+interface GuildRole {
+  id: string;
+  name?: string;
+}
+/** 好友。 */
+interface Friend {
+  user?: User;
+  nick?: string;
+}
+/** 表情。 */
+interface Emoji {
+  id: string;
+  name?: string;
+}
+/** 登录信息（非登录事件中 login 只带 sn/user/platform）。 */
+interface Login {
+  /** 序列号（仅标识 Login 对象，非持久化，与 login.user.id 区分）。 */
+  sn: number;
+  /** 平台名称（qq）。 */
+  platform?: string;
+  /** 平台用户（机器人身份）。 */
+  user?: User;
+  /** 登录状态。 */
+  status: LoginStatus;
+  /** 适配器名称（napuketto）。 */
+  adapter: string;
+  /** 平台特性列表（features 判断 API 可用性）。 */
+  features?: string[];
+}
+/** 消息（content 为 Satori 元素字符串；资源提升后不含 user/member/channel）。 */
+interface Message {
+  id: string;
+  content?: string;
+  channel?: Channel;
+  guild?: Guild;
+  member?: GuildMember;
+  user?: User;
+  created_at?: number;
+  updated_at?: number;
+}
+//#endregion
+//#region src/satori/helper/translate.d.ts
+/** 收方向翻译依赖（uid → uin 转换，缺省 at 原样 uid）。 */
+interface SatoriTranslateDeps {
+  /** 机器人自身 uin（频道类型判定 / 私聊对端兜底）。 */
+  selfUin: string;
+  /** uid → uin（at 目标 / 用户 ID；缺省不转换）。 */
+  uidToUin?: (uids: string[]) => Promise<Map<string, string>>;
+}
+//#endregion
+//#region src/satori/adapter.d.ts
+/** 适配器构造参数。 */
+interface SatoriAdapterOptions extends SatoriApiOptions {
+  /** 协议配置（zod 校验 + seed 装配）。 */
+  config: ProtocolConfig<SatoriConfig>;
+  /** network 事件广播（注册传输后 emit 推给第三方）。 */
+  broadcaster: EventBroadcaster;
+  /** kernel 消息事件通道（消息收链路入口）。 */
+  msgChannel: MsgEventChannel;
+}
+/** Satori 协议适配器。 */
+declare class NapukettoSatoriAdapter extends BaseProtocolAdapter<SatoriConfig> {
+  readonly protocol = "satori";
+  readonly configSchema: import("zod").ZodObject<{
+    token: import("zod").ZodOptional<import("zod").ZodString>;
+    cacheDir: import("zod").ZodOptional<import("zod").ZodString>;
+    httpServers: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+      enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      host: import("zod").ZodDefault<import("zod").ZodString>;
+      port: import("zod").ZodDefault<import("zod").ZodNumber>;
+      token: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>>;
+    wsServers: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+      enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      host: import("zod").ZodDefault<import("zod").ZodString>;
+      port: import("zod").ZodDefault<import("zod").ZodNumber>;
+      token: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>>;
+  }, import("zod/v4/core").$strip>;
+  private readonly msgChannel;
+  private readonly api;
+  private readonly registry;
+  private transports;
+  private unsubscribe;
+  private eventSn;
+  constructor(opts: SatoriAdapterOptions);
+  /** 启动传输：装配（HTTP RPC + WS 事件服务）+ 打开 server + 订阅消息事件。 */
+  private startTransports;
+  /** 当前登录信息（READY logins / meta / login.get 用）。 */
+  private currentLogin;
+  /** 广播 login-updated 事件（适配器启停时）。 */
+  private broadcastLoginUpdated;
+  /** 停止：退订 + 关闭传输 + 广播 login-updated（离线）。 */
+  private stopAll;
+  /** 订阅 kernel 消息事件（幂等）。 */
+  private subscribe;
+  /** 广播消息事件（message-created）。 */
+  private broadcastMessageCreated;
+  /** 广播 grayTip 事件（message-deleted / guild-member-added / removed）。 */
+  private broadcastGrayTip;
+  /** 广播事件内容（sn 递增 + 最小 login 包装 + EVENT 信令）。 */
+  private broadcastContent;
+  /** 事件 sn（递增，从 1 起）。 */
+  private nextSn;
+  /** 退订（幂等）。 */
+  private unsubscribeAll;
+}
+//#endregion
+//#region src/satori/event/translate.d.ts
+/** 事件内容（不含 sn/login，由 adapter 包一层完整 Event）。 */
+interface SatoriEventContent {
+  type: string;
+  timestamp: number;
+  channel?: Channel;
+  guild?: Guild;
+  message?: Message;
+  user?: User;
+  member?: GuildMember;
+  operator?: User;
+}
+/** 事件翻译依赖（selfUin + uidToUin）。 */
+interface SatoriEventDeps extends SatoriTranslateDeps {}
+//#endregion
+//#region src/satori/types/api.d.ts
+/**
+ * Satori 分页与通用 API 类型（协议 v1，规范参考 satori.chat/zh-CN/protocol/api.html）
+ */
+/** 分页列表（next 为空表示无更多数据）。 */
+interface List<T> {
+  data: T[];
+  next?: string;
+}
+/** 双向分页列表（message.list 等）。 */
+interface BidiList<T> {
+  data: T[];
+  prev?: string;
+  next?: string;
+}
+/** 分页方向（message.list）。 */
+declare const Direction: {
+  readonly BEFORE: "before";
+  readonly AFTER: "after";
+  readonly AROUND: "around";
+};
+type Direction = (typeof Direction)[keyof typeof Direction];
+/** 排序方向。 */
+declare const Order: {
+  readonly ASC: "asc";
+  readonly DESC: "desc";
+};
+type Order = (typeof Order)[keyof typeof Order];
+//#endregion
+//#region src/satori/types/event.d.ts
+/** 信令类型。 */
+declare const Opcode: {
+  readonly EVENT: 0;
+  readonly PING: 1;
+  readonly PONG: 2;
+  readonly IDENTIFY: 3;
+  readonly READY: 4;
+  readonly META: 5;
+};
+type Opcode = (typeof Opcode)[keyof typeof Opcode];
+/** 信令外壳。 */
+interface Signal<T = unknown> {
+  op: Opcode;
+  body?: T;
+}
+/** IDENTIFY 信令 body（鉴权 + 可选会话恢复）。 */
+interface IdentifyBody {
+  token?: string;
+  sn?: number;
+}
+/** READY 信令 body。 */
+interface ReadyBody {
+  logins: Login[];
+  proxy_urls: string[];
+}
+/** META 信令 body（不反映登录状态，不含 logins）。 */
+interface MetaBody {
+  proxy_urls: string[];
+}
+/** 交互指令（interaction 事件）。 */
+interface Argv {
+  name?: string;
+  arguments?: string;
+  options?: Record<string, string>;
+}
+/** 交互按钮。 */
+interface Button {
+  id?: string;
+}
+/** 事件对象（type 为事件类型；各资源字段按规范可选）。 */
+interface Event {
+  /** 事件序列号（会话内递增，1 起）。 */
+  sn: number;
+  /** 事件类型（message-created 等）。 */
+  type: string;
+  /** 事件时间戳（毫秒）。 */
+  timestamp: number;
+  /** 登录信息（非登录事件只带 sn/user/platform）。 */
+  login: Login;
+  /** 交互指令（button 等）。 */
+  argv?: Argv;
+  /** 交互按钮。 */
+  button?: Button;
+  /** 事件所属频道。 */
+  channel?: Channel;
+  /** 事件的表情（reaction 事件）。 */
+  emoji?: Emoji;
+  /** 事件的好友（friend 事件）。 */
+  friend?: Friend;
+  /** 事件所属群组。 */
+  guild?: Guild;
+  /** 事件的目标成员。 */
+  member?: GuildMember;
+  /** 事件的消息。 */
+  message?: Message;
+  /** 事件的操作者。 */
+  operator?: User;
+  /** 事件的目标角色。 */
+  role?: GuildRole;
+  /** 事件的目标用户。 */
+  user?: User;
+}
+//#endregion
+//#region src/satori/transport.d.ts
+/** 传输装配结果。 */
+interface SatoriTransportSet {
+  /** 传输适配器（HTTP RPC + WS 事件服务，均已注册 broadcaster）。 */
+  adapters: TransportAdapter[];
+  /** 停止：关闭全部传输（幂等）。 */
+  close: () => Promise<void>;
+}
+/** 传输装配选项。 */
+interface AssembleSatoriTransportsOptions {
+  /** Satori 配置。 */
+  config: SatoriConfig;
+  /** 事件广播（WS 事件服务注册到它，EVENT 信令经 broadcastEvent 推送）。 */
+  broadcaster: EventBroadcaster;
+  /** 动作注册表（HTTP RPC 分发用）。 */
+  registry: SatoriActionRegistry;
+  /** 登录信息构造（READY logins / meta 用）。 */
+  login: () => Login;
+}
+/** 按配置装配 Satori 传输。 */
+declare function assembleSatoriTransports(opts: AssembleSatoriTransportsOptions): SatoriTransportSet;
+/** 事件信令（adapter 广播用）。 */
+declare function toEventSignal(event: Event): {
+  op: number;
+  body: Event;
+};
+//#endregion
+export { type Argv, type AssembleSatoriTransportsOptions, type BidiList, type Button, type CanonicalToSatoriDeps, type Channel, type ChannelType, type Direction, type Emoji, type Event, type Friend, type Guild, type GuildMember, type GuildRole, HTTP_STATUS, type IdentifyBody, type List, type Login, type LoginStatus, type Message, type MetaBody, NapukettoSatoriAdapter, type Opcode, type Order, type ReadyBody, type SatoriActionDeps, SatoriActionError, type SatoriAdapterOptions, SatoriApi, type SatoriApiOptions, type SatoriConfig, type SatoriElement, type SatoriEventContent, type SatoriEventDeps, type SatoriToCanonicalDeps, type SatoriTransportSet, type Signal, type User, assembleSatoriTransports, canonicalToSatoriElements, createSatoriActionRegistry, parseContentToCanonical, parseElements, renderElements, satoriConfigSchema, satoriHttpStatusMap, satoriToCanonicalElements, toEventSignal };
+//# sourceMappingURL=index.d.mts.map

package/dist/satori/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/satori/action/base-action.ts","../../src/satori/helper/element/element.ts","../../src/satori/helper/element/canonical.ts","../../src/satori/helper/element/deps.ts","../../src/satori/helper/element/element-convert.ts","../../src/satori/api/satori-api.ts","../../src/satori/action/registry.ts","../../src/satori/action/index.ts","../../src/satori/helper/config.ts","../../src/satori/helper/error.ts","../../src/satori/types/resource.ts","../../src/satori/helper/translate.ts","../../src/satori/adapter.ts","../../src/satori/event/translate.ts","../../src/satori/types/api.ts","../../src/satori/types/event.ts","../../src/satori/transport.ts"],"mappings":"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"}