@napuketto/adapter 0.4.1 → 0.5.0

package/dist/kurobot/index.mjs

@@ -1,5 +1,5 @@
 import { r as BaseProtocolAdapter } from "../core-DyXyDUcU.mjs";
-import { t as forEachRawMessage } from "../raw-message-6KdlG8kR.mjs";
+import { t as forEachRawMessage } from "../raw-message-D_ecJy4C.mjs";
 import { createRequire } from "node:module";
 import { ChatType, toCanonicalElements } from "@napuketto/kernel";
 import { z } from "zod";

package/dist/milky/index.d.mts

@@ -0,0 +1,187 @@
+import { i as ProtocolConfig, n as BaseProtocolAdapter, s as ActionRegistry } from "../index-CDKj-jus.mjs";
+import { ChatType, FriendApi, GroupApi, GroupCache, KernelErrorCode, MsgApi, MsgEventChannel, Peer, ProfileApi, RawMessage } from "@napuketto/kernel";
+import { ZodType, z } from "zod";
+import { EventBroadcaster, TransportAdapter } from "@napuketto/network";
+//#region src/milky/helper/seq-index.d.ts
+declare class MessageSeqIndex {
+  /** `${chatType}:${peerUid}:${seq}` → msgId。 */
+  private readonly seqToMsg;
+  /** msgId → seq 元信息。 */
+  private readonly msgToMeta;
+  /** 接收链路登记（一条消息双向写入；重复 msgId 覆盖）。 */
+  record(msg: RawMessage): void;
+  /** seq → msgId（反查；未登记返回 undefined）。 */
+  resolveMsgId(chatType: ChatType, peerUid: string, seq: number): string | undefined;
+  /**
+   * 批量回填 reply 引用元信息（msgId → Milky reply 段 data 所需三元组）。
+   * 未命中的 id 不进表（翻译层按 0 兜底）。
+   */
+  collectReplyMeta(msgIds: string[]): Map<string, {
+    messageSeq: number;
+    senderId: number;
+    time: number;
+  }>;
+  /** key 规则（chatType 数值 + peerUid + seq；peerUid 群聊=群号，C2C=uid）。 */
+  private key;
+  /** FIFO 淘汰到容量上限内。 */
+  private evict;
+}
+//#endregion
+//#region src/milky/api.d.ts
+/** MilkyApi 构造参数。 */
+interface MilkyApiOptions {
+  msgApi: MsgApi;
+  groupApi: GroupApi;
+  friendApi: FriendApi;
+  profileApi: ProfileApi;
+  /** 登录身份（get_login_info / self_id 用）。 */
+  self: {
+    uin: string;
+    nickname: string;
+  };
+  /** 群/成员缓存（群实体回填 / get_group_list；未装配时动作直查 api）。 */
+  groupCache?: GroupCache;
+  /** QQ 客户端版本（get_impl_info.qq_protocol_version）。 */
+  qqVersion: string;
+  /** 协议端版本（get_impl_info.impl_version）。 */
+  implVersion: string;
+  /** 发送媒体 http(s)/base64 URI 下载缓存目录（缺省 = 远程媒体发送不可用）。 */
+  mediaDir?: string;
+}
+declare class MilkyApi {
+  readonly msgApi: MsgApi;
+  readonly groupApi: GroupApi;
+  readonly friendApi: FriendApi;
+  readonly profileApi: ProfileApi;
+  readonly self: {
+    uin: string;
+    nickname: string;
+  };
+  readonly groupCache: GroupCache | undefined;
+  readonly qqVersion: string;
+  readonly implVersion: string;
+  readonly mediaDir: string | undefined;
+  /** message_seq ↔ msgId 双向映射（接收链路 record，动作侧反查）。 */
+  readonly seqIndex: MessageSeqIndex;
+  constructor(opts: MilkyApiOptions, seqIndex: MessageSeqIndex);
+  /** uin → uid（私聊目标 / at 段发送转换）。 */
+  uinToUid(uins: string[]): Promise<Map<string, string>>;
+  /** uid → uin（事件路径 mention 转换）。 */
+  uidToUin(uids: string[]): Promise<Map<string, string>>;
+  /**
+   * message_scene + 数字 ID → NT Peer。
+   * group = 群号直作 peerUid；friend/temp = uin → uid（失败退 uin 原样，交 QQ 端判断）。
+   */
+  resolvePeer(scene: "friend" | "group" | "temp", id: number): Promise<Peer>;
+  /**
+   * seq → msgId（索引优先，未登记扫描近段历史兜底）。
+   * 两层都未命中返回 undefined（调用方抛 NOT_FOUND）。
+   */
+  resolveMsgIdBySeq(peer: Peer, seq: number, chatType: Peer["chatType"]): Promise<string | undefined>;
+  /** 发送结果回查：msgId → {message_seq, time}（sendMessage 只回 msgId）。 */
+  resolveSentOutput(peer: Peer, msgId: string): Promise<{
+    message_seq: number;
+    time: number;
+  }>;
+}
+//#endregion
+//#region src/milky/action/error-map.d.ts
+/** KernelErrorCode → Milky retcode 映射表（-400/-403 规范语义，其余自定负数）。 */
+type MilkyErrorCodeMap = Record<KernelErrorCode, number>;
+//#endregion
+//#region src/milky/action/base-action.d.ts
+/** Milky 动作结果（retcode 为规范负数族；transport 原样组装信封）。 */
+interface MilkyActionResult<T> {
+  status: "ok" | "failed";
+  retcode: number;
+  data: T | null;
+  message: string;
+}
+declare abstract class MilkyAction<TPayload, TReturn> {
+  abstract readonly name: string;
+  abstract readonly schema: ZodType<TPayload>;
+  protected abstract readonly errorCodeMap: MilkyErrorCodeMap;
+  protected abstract _handle(payload: TPayload): Promise<TReturn>;
+  /** 校验并执行（HTTP /api 入口；WS /event 不承载动作）。 */
+  handle(payload: unknown): Promise<MilkyActionResult<TReturn>>;
+}
+//#endregion
+//#region src/milky/action/index.d.ts
+/** Milky 动作注册表（P0 9 动作）。 */
+declare function createMilkyActionRegistry(opts: {
+  api: MilkyApi;
+}): ActionRegistry<MilkyAction<unknown, unknown>>;
+//#endregion
+//#region src/milky/config.d.ts
+/** Milky 配置 schema。 */
+declare const milkyConfigSchema: z.ZodObject<{
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  host: z.ZodDefault<z.ZodString>;
+  port: z.ZodDefault<z.ZodNumber>;
+  token: z.ZodDefault<z.ZodString>;
+  eventModes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    sse: "sse";
+    ws: "ws";
+  }>>>;
+  webhooks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  cacheDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Milky 配置类型（由 schema 推导）。 */
+type MilkyConfig = z.infer<typeof milkyConfigSchema>;
+//#endregion
+//#region src/milky/transport.d.ts
+/** 校准 logger 最小面（webhook 失败 / 配置异常提示；缺省静默）。 */
+interface MilkyLoggerLike {
+  warn(obj: unknown, msg?: string): void;
+  info(obj: unknown, msg?: string): void;
+}
+//#endregion
+//#region src/milky/adapter.d.ts
+/** 适配器构造参数（api 相关字段继承 MilkyApiOptions）。 */
+interface MilkyAdapterOptions extends MilkyApiOptions {
+  config: ProtocolConfig<MilkyConfig>;
+  broadcaster: EventBroadcaster;
+  /** kernel 消息事件通道（收链路入口）。 */
+  msgChannel: MsgEventChannel;
+  /** 校准日志（webhook 失败 / 启停提示；IPC 模式传 loader pino 实例）。 */
+  logger?: MilkyLoggerLike;
+}
+declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
+  readonly protocol = "milky";
+  private readonly msgChannel;
+  private readonly calibLogger;
+  private readonly api;
+  private readonly seqIndex;
+  /** 动作注册表（公共只读：装配方/测试枚举）。 */
+  readonly registry: ReturnType<typeof createMilkyActionRegistry>;
+  private unsubscribes;
+  private stopTransports;
+  constructor(opts: MilkyAdapterOptions);
+  /** 启动传输 + 订阅（enabled=false 空转：不订阅不起传输）。 */
+  private startTransports;
+  /** 热更新：停止重建（enabled 切换生效）。 */
+  private reloadTransports;
+  /** 停止：退订 + 关传输。 */
+  private stopAll;
+  /** 订阅 kernel 消息通道（幂等）。 */
+  private subscribe;
+  /** 退订（幂等）。 */
+  private unsubscribeAll;
+  /** 单条消息：seq 登记 → grayTip→recall / 普通→message_receive（自消息不上报）。 */
+  private handleIncoming;
+  /** message_receive 组装：at uid→uin + reply 回填 + 群实体回填（全部 fail-soft）。 */
+  private buildMessageReceiveEvent;
+  /** at uid → uin 批量转换（mention.user_id 用；失败 mention 段跳过）。 */
+  private fillMentionUids;
+  /** reply 引用元信息回填（seqIndex 命中即用；未命中不强查）。 */
+  private fillReplyMeta;
+  /** 群场景实体回填（GroupCache 缓存优先，失败最小实体兜底）。 */
+  private fillGroupEntities;
+  /** message_recall 组装（非撤回 grayTip 返回 null 静默）。 */
+  private buildRecallEvent;
+  /** 撤回操作者 uid → uin（未撤回/转换失败返回 undefined，operator_id 兜底 0）。 */
+  private resolveOperatorUin;
+}
+//#endregion
+export { type MilkyAdapterOptions, type MilkyConfig, NapukettoMilkyAdapter, milkyConfigSchema };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/milky/helper/seq-index.ts","../../src/milky/api.ts","../../src/milky/action/error-map.ts","../../src/milky/action/base-action.ts","../../src/milky/action/index.ts","../../src/milky/config.ts","../../src/milky/transport.ts","../../src/milky/adapter.ts"],"mappings":";;;;;cAsBa;;mBAEQ;;mBAEA;;EAGjB,OAAO,KAAK;;EAeZ,aAAa,UAAU,UAAU,iBAAiB;;;;;EAQlD,iBACI,mBACD;IAAc;IAAoB;IAAkB;;;UAgB/C;;UAKA;;;;;UCxDK;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,YAAY;;EAEZ;IAAQ;IAAa;;;EAErB,aAAa;;EAEb;;EAEA;;EAEA;;cAGS;WACA,QAAQ;WACR,UAAU;WACV,WAAW;WACX,YAAY;WACZ;IAAQ;IAAa;;WACrB,YAAY;WACZ;WACA;WACA;;WAEA,UAAU;EAEnB,YAAY,MAAM,iBAAiB,UAAU;;EAc7C,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;EAQ5B,YAAY,oCAAoC,aAAa,QAAQ;;;;;EAqBrE,kBACF,MAAM,MACN,aACA,UAAU,mBACX;;EAeG,kBACF,MAAM,MACN,gBACD;IAAU;IAAqB;;;;;;KC9G1B,oBAAoB,OAAO;;;;UCItB,kBAAkB;EAC/B;EACA;EACA,MAAM;EACN;;uBAYkB,YAAY,UAAU;oBACtB;oBACA,QAAQ,QAAQ;8BACN,cAAc;qBAEvB,QAAQ,SAAS,WAAW,QAAQ;;EAGjD,OAAO,mBAAmB,QAAQ,kBAAkB;;;;;iBCf9C,0BAA0B;EACtC,KAAK;IACL,eAAe;;;;cCfN,mBAAiB,EAAA;;;;;;;;;;;GAe5B,EAAA,KAAA;;KAGU,cAAc,EAAE,aAAa;;;;UCQxB;EACb,KAAK,cAAc;EACnB,KAAK,cAAc;;;;;UCRN,4BAA4B;EACzC,QAAQ,eAAe;EACvB,aAAa;;EAEb,YAAY;;EAEZ,SAAS;;cAGA,8BAA8B,oBAAoB;WAClD;mBAEQ;mBACA;mBACA;mBACA;;WAER,UAAU,kBAAkB;UAC7B;UACA;EAER,YAAY,MAAM;;UAkBJ;;UAuBA;;UAMA;;UASN;;UAYA;;UAQM;;UAmBA;;UAUA;;UAkBN;;UAWM;;UAaA;;UASN"}