@napuketto/adapter 0.4.1 → 0.4.2

package/dist/onebot11/index.d.mts

@@ -3,137 +3,6 @@ import "../gray-tip-8zPh4d9W.mjs";
 import { BuddyCacheEventChannel, BuddyEventChannel, CanonicalElement, ChatType, FriendApi, GroupApi, GroupCache, GroupEventChannel, GroupNotifyApi, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RawMessage, RichMediaApi, TicketApi, WebApi } from "@napuketto/kernel";
 import { z } from "zod";
 import { EventBroadcaster, TransportAdapter } from "@napuketto/network";
-//#region src/onebot11/helper/message-unique.d.ts
-declare class MessageUnique {
-  /** NT msgId → OB11 message_id。 */
-  private readonly msgIdToInt;
-  /** OB11 message_id → NT msgId。 */
-  private readonly intToMsgId;
-  /** NT msgId → Peer（delete_msg / get_msg 等只有 message_id 时反查用）。 */
-  private readonly msgIdToPeer;
-  /** 递增计数器。 */
-  private cursor;
-  /** 已释放的槽位（可复用）。 */
-  private readonly freed;
-  /**
-   * 为新 NT 消息分配 OB11 message_id（幂等：同一 msgId 返回同一 id）。
-   * peer 可选：传入则记录，供 message_id → peer 反查。
-   */
-  alloc(msgId: string, peer?: Peer): number;
-  /** OB11 message_id → NT msgId。 */
-  getMsgId(messageId: number): string | undefined;
-  /** NT msgId → OB11 message_id（未分配返回 undefined）。 */
-  getMessageId(msgId: string): number | undefined;
-  /** NT msgId → Peer（alloc 时未记录返回 undefined）。 */
-  getPeer(msgId: string): Peer | undefined;
-  /** 释放 NT msgId 占用的槽位（消息过期/删除时调用，可选）。 */
-  release(msgId: string): void;
-  /** 取下一个可用 id：优先释放池，否则递增（溢出后线性扫描空洞）。 */
-  private nextFreeId;
-}
-//#endregion
-//#region src/onebot11/api/one-bot-api.d.ts
-/** 系统类本地回调（get_version_info / clean_cache / download_file / 进程控制用）。 */
-interface OneBotSystemOptions {
-  /** 运行版本（get_version_info 用，缺省 unknown）。 */
-  appVersion: string;
-  /** 缓存清理回调（clean_cache 用，未配置抛错）。 */
-  cleanCache?: () => Promise<void>;
-  /** 缓存目录（download_file 保存路径 / get_image 主动下载落盘）。 */
-  cacheDir?: string;
-  /** QQ NT global 目录（get_image/get_record 解析 NT 相对路径用，2026-09-08 T5）。 */
-  mediaBaseDir?: string;
-  /** 进程退出回调（bot_exit 用）。 */
-  exit?: () => Promise<void>;
-  /** 进程重启回调（set_restart 用，缺省退化为退出）。 */
-  restart?: () => Promise<void>;
-}
-/** OneBotApi 构造参数。 */
-interface OneBotApiOptions {
-  msgApi: MsgApi;
-  groupApi: GroupApi;
-  groupNotifyApi: GroupNotifyApi;
-  friendApi: FriendApi;
-  ticketApi: TicketApi;
-  richMediaApi: RichMediaApi;
-  profileApi: ProfileApi;
-  profileLikeApi: ProfileLikeApi;
-  webApi: WebApi;
-  /** 登录身份（get_login_info 用）。 */
-  self: {
-    uin: string;
-    nickname: string;
-  };
-  /** 系统类本地信息。 */
-  system: OneBotSystemOptions;
-  /** 群/成员缓存（ADR-008，读缓存动作用；未装配时动作直查 api）。 */
-  groupCache?: GroupCache;
-}
-/**
- * OneBot 11 动作统一依赖聚合（P2-16）。
- * 各动作经 `Pick<OneBotApi, ...>` 取所需成员；注册处只构造一次本对象。
- */
-declare class OneBotApi {
-  /** kernel 消息 API（send_msg 等消息类动作用）。 */
-  readonly msgApi: MsgApi;
-  /** kernel 群 API。 */
-  readonly groupApi: GroupApi;
-  /** kernel 群通知 API（群请求/禁言列表用）。 */
-  readonly groupNotifyApi: GroupNotifyApi;
-  /** kernel 好友 API。 */
-  readonly friendApi: FriendApi;
-  /** kernel 票据 API（get_clientkey/get_cookies 用）。 */
-  readonly ticketApi: TicketApi;
-  /** kernel 富媒体 API（群文件/翻译用）。 */
-  readonly richMediaApi: RichMediaApi;
-  /** kernel 资料 API（签名/昵称/头像用）。 */
-  readonly profileApi: ProfileApi;
-  /** kernel 点赞 API（send_like 用）。 */
-  readonly profileLikeApi: ProfileLikeApi;
-  /** kernel 群空间 web API（精华/荣誉用）。 */
-  readonly webApi: WebApi;
-  /** 群/成员缓存（ADR-008；翻译层只读消费，缺失惰性回填）。 */
-  readonly groupCache: GroupCache | undefined;
-  /** OB11 message_id ↔ NT msgId 双向映射（收链路与动作共用同一映射空间）。 */
-  readonly messageUnique: MessageUnique;
-  /** 登录身份（get_login_info 用）。 */
-  readonly self: {
-    uin: string;
-    nickname: string;
-  };
-  /** 机器人自身 uin（get_cookies / csrf 用）。 */
-  readonly selfUin: string;
-  /** 运行版本（get_version_info 用）。 */
-  readonly appVersion: string;
-  /** 缓存清理回调（clean_cache 用）。 */
-  readonly cleanCache: (() => Promise<void>) | undefined;
-  /** 缓存目录（download_file 用）。 */
-  readonly cacheDir: string | undefined;
-  /** QQ NT global 目录（媒体 NT 相对路径解析用）。 */
-  readonly mediaBaseDir: string | undefined;
-  /** 进程退出回调（bot_exit 用）。 */
-  readonly exit: (() => Promise<void>) | undefined;
-  /** 进程重启回调（set_restart 用）。 */
-  readonly restart: (() => Promise<void>) | undefined;
-  constructor(opts: OneBotApiOptions);
-  /** uin→uid 转换（委托 groupApi；私聊目标/成员 user_id 用）。 */
-  uinToUid(uins: string[]): Promise<Map<string, string>>;
-  /** uid→uin 转换（委托 groupApi；notice/grayTip 用）。 */
-  uidToUin(uids: string[]): Promise<Map<string, string>>;
-}
-//#endregion
-//#region src/onebot11/action/error-map.d.ts
-/** OB11 错误码映射表（send_msg 等所有 OB11 动作共用）。 */
-declare const ob11ErrorCodeMap: ErrorCodeMap;
-//#endregion
-//#region src/onebot11/action/group/get-group-at-all-remain.d.ts
-/** @全体剩余次数返回结构。 */
-interface AtAllRemainInfo {
-  can_at_all: boolean;
-  remain_at_all_count_for_uin: number;
-  remain_at_all_count_for_group: number;
-}
-//#endregion
 //#region src/onebot11/types/index.d.ts
 /**
  * OneBot 11 类型定义（自研描述，参考公开协议规范）
@@ -334,6 +203,168 @@ interface VersionInfo {
   walle_version?: string;
 }
 //#endregion
+//#region src/onebot11/helper/data.d.ts
+/** canonical 元素数组 → OB11 segment 数组（无法表达的元素静默跳过）。 */
+declare function canonicalToSegments(elements: CanonicalElement[]): OB11MessageSegment[];
+/** OB11 segment 数组 → canonical 元素数组。 */
+declare function segmentsToCanonical(segments: OB11MessageSegment[]): CanonicalElement[];
+/**
+ * 接收方向翻译上下文（ID 空间转换，P2-19，2026-08-07）。
+ * 翻译核心保持纯函数（ADR-008），调用方在协议边界准备上下文注入：
+ * canonical 的 at.target 是 NT uid、reply.messageId 是 NT 雪花 msgId，
+ * OB11 需要 uin / OB11 message_id。
+ */
+/** OB11 sender.role 值域（群聊；私聊 sender 无 role）。 */
+type GroupSenderRole = "owner" | "admin" | "member";
+/** CQ 码字符串 → OB11 segment 数组（未知 CQ 类型保留为 text 段原文）。 */
+declare function cqMessageToSegments(text: string): OB11MessageSegment[];
+/** canonical 元素数组 → CQ 码字符串。 */
+declare function canonicalToCqMessage(elements: CanonicalElement[]): string;
+/** CQ 码字符串 → canonical 元素数组。 */
+declare function cqMessageToCanonical(text: string): CanonicalElement[];
+//#endregion
+//#region src/onebot11/helper/message-unique.d.ts
+declare class MessageUnique {
+  /** NT msgId → OB11 message_id。 */
+  private readonly msgIdToInt;
+  /** OB11 message_id → NT msgId。 */
+  private readonly intToMsgId;
+  /** NT msgId → Peer（delete_msg / get_msg 等只有 message_id 时反查用）。 */
+  private readonly msgIdToPeer;
+  /** 递增计数器。 */
+  private cursor;
+  /** 已释放的槽位（可复用）。 */
+  private readonly freed;
+  /**
+   * 为新 NT 消息分配 OB11 message_id（幂等：同一 msgId 返回同一 id）。
+   * peer 可选：传入则记录，供 message_id → peer 反查。
+   */
+  alloc(msgId: string, peer?: Peer): number;
+  /** OB11 message_id → NT msgId。 */
+  getMsgId(messageId: number): string | undefined;
+  /** NT msgId → OB11 message_id（未分配返回 undefined）。 */
+  getMessageId(msgId: string): number | undefined;
+  /** NT msgId → Peer（alloc 时未记录返回 undefined）。 */
+  getPeer(msgId: string): Peer | undefined;
+  /** 释放 NT msgId 占用的槽位（消息过期/删除时调用，可选）。 */
+  release(msgId: string): void;
+  /** 取下一个可用 id：优先释放池，否则递增（溢出后线性扫描空洞）。 */
+  private nextFreeId;
+}
+//#endregion
+//#region src/onebot11/api/one-bot-api.d.ts
+/** 系统类本地回调（get_version_info / clean_cache / download_file / 进程控制用）。 */
+interface OneBotSystemOptions {
+  /** 运行版本（get_version_info 用，缺省 unknown）。 */
+  appVersion: string;
+  /** 缓存清理回调（clean_cache 用，未配置抛错）。 */
+  cleanCache?: () => Promise<void>;
+  /** 缓存目录（download_file 保存路径 / get_image 主动下载落盘）。 */
+  cacheDir?: string;
+  /** QQ NT global 目录（get_image/get_record 解析 NT 相对路径用，2026-09-08 T5）。 */
+  mediaBaseDir?: string;
+  /** 进程退出回调（bot_exit 用）。 */
+  exit?: () => Promise<void>;
+  /** 进程重启回调（set_restart 用，缺省退化为退出）。 */
+  restart?: () => Promise<void>;
+}
+/** OneBotApi 构造参数。 */
+interface OneBotApiOptions {
+  msgApi: MsgApi;
+  groupApi: GroupApi;
+  groupNotifyApi: GroupNotifyApi;
+  friendApi: FriendApi;
+  ticketApi: TicketApi;
+  richMediaApi: RichMediaApi;
+  profileApi: ProfileApi;
+  profileLikeApi: ProfileLikeApi;
+  webApi: WebApi;
+  /** 登录身份（get_login_info 用）。 */
+  self: {
+    uin: string;
+    nickname: string;
+  };
+  /** 系统类本地信息。 */
+  system: OneBotSystemOptions;
+  /** 群/成员缓存（ADR-008，读缓存动作用；未装配时动作直查 api）。 */
+  groupCache?: GroupCache;
+}
+/**
+ * OneBot 11 动作统一依赖聚合（P2-16）。
+ * 各动作经 `Pick<OneBotApi, ...>` 取所需成员；注册处只构造一次本对象。
+ */
+declare class OneBotApi {
+  /** kernel 消息 API（send_msg 等消息类动作用）。 */
+  readonly msgApi: MsgApi;
+  /** kernel 群 API。 */
+  readonly groupApi: GroupApi;
+  /** kernel 群通知 API（群请求/禁言列表用）。 */
+  readonly groupNotifyApi: GroupNotifyApi;
+  /** kernel 好友 API。 */
+  readonly friendApi: FriendApi;
+  /** kernel 票据 API（get_clientkey/get_cookies 用）。 */
+  readonly ticketApi: TicketApi;
+  /** kernel 富媒体 API（群文件/翻译用）。 */
+  readonly richMediaApi: RichMediaApi;
+  /** kernel 资料 API（签名/昵称/头像用）。 */
+  readonly profileApi: ProfileApi;
+  /** kernel 点赞 API（send_like 用）。 */
+  readonly profileLikeApi: ProfileLikeApi;
+  /** kernel 群空间 web API（精华/荣誉用）。 */
+  readonly webApi: WebApi;
+  /** 群/成员缓存（ADR-008；翻译层只读消费，缺失惰性回填）。 */
+  readonly groupCache: GroupCache | undefined;
+  /** OB11 message_id ↔ NT msgId 双向映射（收链路与动作共用同一映射空间）。 */
+  readonly messageUnique: MessageUnique;
+  /** 登录身份（get_login_info 用）。 */
+  readonly self: {
+    uin: string;
+    nickname: string;
+  };
+  /** 机器人自身 uin（get_cookies / csrf 用）。 */
+  readonly selfUin: string;
+  /** 运行版本（get_version_info 用）。 */
+  readonly appVersion: string;
+  /** 缓存清理回调（clean_cache 用）。 */
+  readonly cleanCache: (() => Promise<void>) | undefined;
+  /** 缓存目录（download_file 用）。 */
+  readonly cacheDir: string | undefined;
+  /** QQ NT global 目录（媒体 NT 相对路径解析用）。 */
+  readonly mediaBaseDir: string | undefined;
+  /** 进程退出回调（bot_exit 用）。 */
+  readonly exit: (() => Promise<void>) | undefined;
+  /** 进程重启回调（set_restart 用）。 */
+  readonly restart: (() => Promise<void>) | undefined;
+  constructor(opts: OneBotApiOptions);
+  /** uin→uid 转换（委托 groupApi；私聊目标/成员 user_id 用）。 */
+  uinToUid(uins: string[]): Promise<Map<string, string>>;
+  /** uid→uin 转换（委托 groupApi；notice/grayTip 用）。 */
+  uidToUin(uids: string[]): Promise<Map<string, string>>;
+  /**
+   * 群成员角色（GroupCache 缓存优先，缺失惰性回填；sender.role 判定用）。
+   * 未装配缓存 / 成员不在群 / 查询失败 → undefined（调用方回退缺省 "member"，
+   * 不阻塞消息上报）。
+   */
+  groupMemberRole(groupCode: string, uid: string): Promise<GroupSenderRole | undefined>;
+  /**
+   * 群成员角色表（历史消息批量用：一次整表读取，uid → role）。
+   * 失败语义同 groupMemberRole。
+   */
+  groupMemberRoles(groupCode: string): Promise<Map<string, GroupSenderRole> | undefined>;
+}
+//#endregion
+//#region src/onebot11/action/error-map.d.ts
+/** OB11 错误码映射表（send_msg 等所有 OB11 动作共用）。 */
+declare const ob11ErrorCodeMap: ErrorCodeMap;
+//#endregion
+//#region src/onebot11/action/group/get-group-at-all-remain.d.ts
+/** @全体剩余次数返回结构。 */
+interface AtAllRemainInfo {
+  can_at_all: boolean;
+  remain_at_all_count_for_uin: number;
+  remain_at_all_count_for_group: number;
+}
+//#endregion
 //#region src/onebot11/event/base.d.ts
 /**
  * OneBot 11 事件基类（OB11 公开协议规范，自研描述）
@@ -694,18 +725,6 @@ declare const ob11ConfigSchema: z.ZodObject<{
 /** OB11 配置类型（由 schema 推导）。 */
 type OB11Config = z.infer<typeof ob11ConfigSchema>;
 //#endregion
-//#region src/onebot11/helper/data.d.ts
-/** canonical 元素数组 → OB11 segment 数组（无法表达的元素静默跳过）。 */
-declare function canonicalToSegments(elements: CanonicalElement[]): OB11MessageSegment[];
-/** OB11 segment 数组 → canonical 元素数组。 */
-declare function segmentsToCanonical(segments: OB11MessageSegment[]): CanonicalElement[];
-/** CQ 码字符串 → OB11 segment 数组（未知 CQ 类型保留为 text 段原文）。 */
-declare function cqMessageToSegments(text: string): OB11MessageSegment[];
-/** canonical 元素数组 → CQ 码字符串。 */
-declare function canonicalToCqMessage(elements: CanonicalElement[]): string;
-/** CQ 码字符串 → canonical 元素数组。 */
-declare function cqMessageToCanonical(text: string): CanonicalElement[];
-//#endregion
 //#region src/onebot11/adapter.d.ts
 /** 最小 logger 面（校准日志用：未知事件形状打 raw JSON；缺省静默）。 */
 interface AdapterLoggerLike {
@@ -782,6 +801,7 @@ declare class NapukettoOneBot11Adapter extends BaseProtocolAdapter<OB11Config> {
   /**
    * 广播消息事件（P2-19：接收方向 ID 转换）。
    * 收集 at uid → 一次批量 uidToUin → 构造上下文 → 翻译广播。
+   * 群消息另查发送者角色（GroupCache 缓存优先，失败回退缺省 member）。
    * 翻译失败退化为原样（不阻塞上报）。
    */
   private broadcastMessageEvent;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/onebot11/helper/message-unique.ts","../../src/onebot11/api/one-bot-api.ts","../../src/onebot11/action/error-map.ts","../../src/onebot11/action/group/get-group-at-all-remain.ts","../../src/onebot11/types/index.ts","../../src/onebot11/event/base.ts","../../src/onebot11/event/message.ts","../../src/onebot11/event/meta.ts","../../src/onebot11/event/notice.ts","../../src/onebot11/event/request.ts","../../src/onebot11/event/index.ts","../../src/onebot11/action/index.ts","../../src/onebot11/helper/codec/cqcode.ts","../../src/onebot11/helper/codec/segment.ts","../../src/onebot11/helper/config.ts","../../src/onebot11/helper/data.ts","../../src/onebot11/adapter.ts","../../src/onebot11/transport.ts"],"mappings":";;;;;;cAkBa;;mBAEQ;;mBAEA;;mBAEA;;UAET;;mBAES;;;;;EAMjB,MAAM,eAAe,OAAO;;EAmB5B,SAAS;;EAKT,aAAa;;EAKb,QAAQ,gBAAgB;;EAKxB,QAAQ;;UAYA;;;;;UCvDK;;EAEb;;EAEA,mBAAmB;;EAEnB;;EAEA;;EAEA,aAAa;;EAEb,gBAAgB;;;UAIH;EACb,QAAQ;EACR,UAAU;EACV,gBAAgB;EAChB,WAAW;EACX,WAAW;EACX,cAAc;EACd,YAAY;EACZ,gBAAgB;EAChB,QAAQ;;EAER;IAAQ;IAAa;;;EAErB,QAAQ;;EAER,aAAa;;;;;;cAOJ;;WAEA,QAAQ;;WAER,UAAU;;WAEV,gBAAgB;;WAEhB,WAAW;;WAEX,WAAW;;WAEX,cAAc;;WAEd,YAAY;;WAEZ,gBAAgB;;WAEhB,QAAQ;;WAER,YAAY;;WAEZ,eAAe;;WAEf;IAAQ;IAAa;;;WAErB;;WAEA;;WAEA,mBAAmB;;WAEnB;;WAEA;;WAEA,aAAa;;WAEb,gBAAgB;EAEzB,YAAY,MAAM;;EAuBlB,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;cCzHzB,kBAAkB;;;;UCMd;EACb;EACA;EACA;;;;;;;;;UCba,WAAW;EACxB;EACA;EACA,MAAM;EACN;EACA;;;KAIQ;EACJ;EAAc;IAAQ;;;EACtB;EAAY;IAAQ;IAAY;;;EAChC;EAAc;IAAQ;;;EACtB;EAAe;IAAQ;IAAc;;;EACrC;EAAgB;IAAQ;IAAc;;;EACtC;EAAe;IAAQ;IAAc;;;EACrC;EAAc;IAAQ;;;EACtB;EAAe;IAAQ;;;EACvB;EAAiB;IAAQ;;;EACzB;EAAc;IAAQ;;;EACtB;EAAa;IAAQ;;;EACrB;EAAgB;IAAQ;;;;KAGpB,uBAAuB;;UAGlB;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;;;UAIa;EACb;EACA;EACA;EACA;IACI;IACA;IACA;IACA;;EAEJ;EACA,SAAS;EACT;EACA;EACA;;;KAIQ;;UAGK;EACb;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA,MAAM;EACN;;EAEA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA,oBAAoB;EACpB,gBAAgB;EAChB,gBAAgB;EAChB,aAAa;EACb,oBAAoB;EACpB,cAAc;;;UAID;EACb;EACA;EACA;;EAEA;EACA;EACA;EACA,eAAe;EACf,gBAAgB;EAChB;;;;;;;;;;;;KCtJQ;;UAGK;;EAEb;;EAEA;;EAEA,WAAW;;;;;UCPE;EACb;EACA;EACA;;;UAIa,oBAAoB;EACjC;EACA;;;UAIa,8BAA8B;EAC3C;EACA;;EAEA;EACA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA,QAAQ;EACR,YAAY;;;UAIC,gCAAgC;EAC7C;EACA;;EAEA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA,QAAQ;;EAER;;;KAIQ,mBAAmB,wBAAwB;;;;UC9CtC;EACb;EACA;GACC;;;UAIY,+BAA+B;EAC5C;EACA;EACA;;;UAIa,+BAA+B;EAC5C;EACA;;EAEA;EACA,QAAQ;;;KAIA,gBAAgB,yBAAyB;;;;UCvBpC;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA;EACA,MAAM;;;UAIO,kCAAkC;EAC/C;EACA;EACA;EACA;EACA;;;UAIa,qCAAqC;EAClD;EACA;EACA;EACA;EACA;EACA;;;UAIa,qCAAqC;EAClD;EACA;EACA;EACA;EACA;EACA;;;UAIa,gCAAgC;EAC7C;EACA;EACA;EACA;EACA;EACA;;EAEA;;;UAIa,iCAAiC;EAC9C;EACA;EACA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;;;UAIa,iCAAiC;EAC9C;EACA;EACA;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIa,8BAA8B;EAC3C;EACA;EACA;EACA;EACA;EACA;;EAEA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA,MAAM;;;UAIO,iCAAiC;EAC9C;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA,OAAO;;;UAIM,kCAAkC;EAC/C;EACA;EACA;EACA;EACA;;;KAIQ,kBACN,6BACA,4BACA,+BACA,+BACA,0BACA,2BACA,6BACA,8BACA,2BACA,8BACA,wBACA,6BACA,2BACA,8BACA;;;;UCpLW,+BAA+B;EAC5C;EACA;EACA;;EAEA;;EAEA;;;UAIa,8BAA8B;EAC3C;EACA;;EAEA;EACA;EACA;EACA;EACA;;;KAIQ,mBAAmB,yBAAyB;;;;KCiB5C,YAAY,mBAAoB,kBAAmB,mBAAoB;;;;UCyDlE;;EAEb,KAAK;;;iBAIO,yBAAyB,MAAM,iBAAiB;;;;;;;;;;;;;;UCjF/C;EACb;EACA,QAAQ;;;iBAII,aAAa;;iBAKb,cAAc;;iBAKd,eAAe;;iBASf,aACZ,cACA,QAAQ;;;;;;;;iBAqBI,eAAe,eAAe,eAAe;;iBAuB7C,iBAAiB,OAAO,eAAe;;;;iBC8GvC,oBAAoB,UAAU;;;;cCxJjC,kBAAgB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuB3B,EAAA,KAAA;;KAGU,aAAa,EAAE,aAAa;;;;iBC/DxB,oBAAoB,UAAU,qBAAqB;;iBAYnD,oBAAoB,UAAU,uBAAuB;;iBAoIrD,oBAAoB,eAAe;;iBAkBnC,qBAAqB,UAAU;;iBAK/B,qBAAqB,eAAe;;;;UCjHnC;EACb,KAAK,cAAc;EACnB,KAAK,cAAc;;EAEnB,MAAM,cAAc;;;UAIP,+BAA+B;;EAE5C,QAAQ,eAAe;;EAEvB,aAAa;;EAEb,YAAY;;EAEZ,eAAe;;EAEf,gBAAgB;;EAEhB,mBAAmB;;EAEnB,SAAS;;;cAIA,iCAAiC,oBAAoB;WACrD;mBAEQ;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;;WAER,UAAU;UACX;UACA;UACA;UACA;UACA;;UAEA;;UAEA;EAER,YAAY,MAAM;;;;;UAwBJ;;UAYA;;UAyCN;;UAiBM;;UAaN;;;;;;EAmJF,iBAAiB;;EAUvB;;;;;UASQ;;;;;;UA2CM;;UA2BA;;UAiBA;;UA4BA;;UAiBN;;;;;EAWF,cAAc,cAAc,UAAU,wBAAwB;;;;;UC/dvD;;EAEb,SAAS;;EAET,YAAY;;EAEZ,aAAa;;;UAIA;;EAEb,QAAQ;;EAER,aAAa;;EAEb,gBAAgB,cAAc,UAAU;;EAExC;;;iBAiBY,uBAAuB,MAAM,gCAAgC"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/onebot11/types/index.ts","../../src/onebot11/helper/data.ts","../../src/onebot11/helper/message-unique.ts","../../src/onebot11/api/one-bot-api.ts","../../src/onebot11/action/error-map.ts","../../src/onebot11/action/group/get-group-at-all-remain.ts","../../src/onebot11/event/base.ts","../../src/onebot11/event/message.ts","../../src/onebot11/event/meta.ts","../../src/onebot11/event/notice.ts","../../src/onebot11/event/request.ts","../../src/onebot11/event/index.ts","../../src/onebot11/action/index.ts","../../src/onebot11/helper/codec/cqcode.ts","../../src/onebot11/helper/codec/segment.ts","../../src/onebot11/helper/config.ts","../../src/onebot11/adapter.ts","../../src/onebot11/transport.ts"],"mappings":"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"}

package/dist/onebot11/index.mjs

@@ -1901,7 +1901,7 @@ function toOb11MessageInfo(msg, unique, ctx = {}) {
 	if (msg.chatType === ChatType.GROUP) {
 		info.group_id = Number(msg.peerUid);
 		const { sender } = info;
-		sender.role = "member";
+		sender.role = ctx.senderRole ?? "member";
 		if (msg.sendMemberName !== void 0) sender.card = msg.sendMemberName;
 	} else info.user_id = Number(msg.senderUin);
 	return info;
@@ -2258,6 +2258,7 @@ function resolveStartMsgId(messageSeq, messageUnique) {
 /**
 * 拉取历史消息并翻译为 OB11 消息信息数组。
 * 收集全部消息 at uid → 一次批量 uidToUin → 上下文注入（P2-19）。
+* 群聊另取发送者角色表（GroupCache 一次整表读取，失败回退缺省 member）。
 */
 async function fetchAndTranslateHistory(peer, messageSeq, count, deps) {
 	const startMsgId = resolveStartMsgId(messageSeq, deps.messageUnique);
@@ -2278,7 +2279,15 @@ async function fetchAndTranslateHistory(peer, messageSeq, count, deps) {
 		...uidToUin !== void 0 ? { uidToUin } : {},
 		msgIdToOb11Id: (m) => deps.messageUnique.getMessageId(m)
 	};
-	return { messages: msgs.map((msg) => toOb11MessageInfo(msg, deps.messageUnique, ctx)) };
+	let senderRoles;
+	if (peer.chatType === ChatType.GROUP) senderRoles = await deps.groupMemberRoles(peer.peerUid);
+	return { messages: msgs.map((msg) => {
+		const role = senderRoles?.get(msg.senderUid);
+		return toOb11MessageInfo(msg, deps.messageUnique, {
+			...ctx,
+			...role !== void 0 ? { senderRole: role } : {}
+		});
+	}) };
 }
 //#endregion
 //#region src/onebot11/action/message/get-friend-msg-history.ts
@@ -2508,8 +2517,10 @@ var GetMsgAction = class extends BaseAction {
 		if (atUids.length > 0) try {
 			uidToUin = await this.deps.uidToUin(atUids);
 		} catch {}
+		const senderRole = msg.chatType === ChatType.GROUP ? await this.deps.groupMemberRole(msg.peerUid, msg.senderUid) : void 0;
 		const ctx = {
 			...uidToUin !== void 0 ? { uidToUin } : {},
+			...senderRole !== void 0 ? { senderRole } : {},
 			msgIdToOb11Id: (m) => this.deps.messageUnique.getMessageId(m)
 		};
 		return toOb11MessageInfo(msg, this.deps.messageUnique, ctx);
@@ -3571,6 +3582,34 @@ var OneBotApi = class {
 	uidToUin(uids) {
 		return this.groupApi.uidToUin(uids);
 	}
+	/**
+	* 群成员角色（GroupCache 缓存优先，缺失惰性回填；sender.role 判定用）。
+	* 未装配缓存 / 成员不在群 / 查询失败 → undefined（调用方回退缺省 "member"，
+	* 不阻塞消息上报）。
+	*/
+	async groupMemberRole(groupCode, uid) {
+		if (this.groupCache === void 0) return;
+		try {
+			const member = await this.groupCache.getMember(groupCode, uid);
+			return member === void 0 ? void 0 : GroupApi.roleToString(member.role);
+		} catch {
+			return;
+		}
+	}
+	/**
+	* 群成员角色表（历史消息批量用：一次整表读取，uid → role）。
+	* 失败语义同 groupMemberRole。
+	*/
+	async groupMemberRoles(groupCode) {
+		if (this.groupCache === void 0) return;
+		try {
+			const out = /* @__PURE__ */ new Map();
+			for (const member of await this.groupCache.getMembers(groupCode)) out.set(member.uid, GroupApi.roleToString(member.role));
+			return out;
+		} catch {
+			return;
+		}
+	}
 };
 //#endregion
 //#region src/onebot11/helper/message-event.ts
@@ -3601,7 +3640,7 @@ function toOb11MessageEvent(msg, selfUin, unique, messageFormat = "array", ctx =
 		const sender = {
 			user_id: userId,
 			nickname: msg.sendNickName,
-			role: "member"
+			role: ctx.senderRole ?? "member"
 		};
 		if (msg.sendMemberName !== void 0) sender.card = msg.sendMemberName;
 		return {
@@ -4345,6 +4384,7 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 	/**
 	* 广播消息事件（P2-19：接收方向 ID 转换）。
 	* 收集 at uid → 一次批量 uidToUin → 构造上下文 → 翻译广播。
+	* 群消息另查发送者角色（GroupCache 缓存优先，失败回退缺省 member）。
 	* 翻译失败退化为原样（不阻塞上报）。
 	*/
 	async broadcastMessageEvent(msg) {
@@ -4353,8 +4393,10 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		if (atUids.length > 0) try {
 			uidToUin = await this.oneBotApi.uidToUin(atUids);
 		} catch {}
+		const senderRole = msg.chatType === ChatType.GROUP ? await this.oneBotApi.groupMemberRole(msg.peerUid, msg.senderUid) : void 0;
 		const ctx = {
 			...uidToUin !== void 0 ? { uidToUin } : {},
+			...senderRole !== void 0 ? { senderRole } : {},
 			msgIdToOb11Id: (msgId) => this.oneBotApi.messageUnique.getMessageId(msgId)
 		};
 		this.broadcastEvent(toOb11MessageEvent(msg, this.selfUin, this.oneBotApi.messageUnique, this.messageFormat, ctx));