@zhin.js/adapter-milky 1.0.1 → 1.1.2

package/src/ws-endpoint.ts

@@ -0,0 +1,291 @@
+/**
+ * Milky WS client endpoint — outbound connect to Milky protocol server.
+ */
+import WebSocket from 'ws';
+import {
+  ClientEndpoint,
+  createRecallEndpointControl,
+  createEndpointLifecycle,
+  type EndpointConnectHandle,
+  type EndpointControl,
+  type EndpointLifecycle,
+  type EndpointManagement,
+  type EndpointSendRequest,
+} from 'zhin.js/adapter';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
+import type { CapabilityId } from 'zhin.js';
+import { createMilkyEndpointManagement } from './endpoint-management.js';
+import {
+  callMilkyClient,
+  createMilkyEndpointClient,
+  forwardMilkyClientEvents,
+  type MilkyClient,
+} from './client.js';
+import {
+  buildSendAction,
+  buildWsConnectOptions,
+  callApi,
+  extractInboundAudioUrl,
+  formatInboundContent,
+  formatInboundMessageId,
+  formatInboundSegments,
+  formatOutboundMessageId,
+  formatOutboundSegments,
+  isMentioned,
+  milkyInboundConversation,
+  parseMessageReceiveData,
+  parseMilkyMessageId,
+  senderNickname,
+  type MilkyEvent,
+  type MilkyIncomingMessage,
+  type MilkyWsConfig,
+} from './protocol.js';
+import type { MilkyWsCreateOptions, MilkyWsSocket } from './ws-types.js';
+
+const WS_OPEN = 1;
+
+export interface MilkyWsEndpointOptions {
+  readonly id: CapabilityId;
+  readonly config: MilkyWsConfig;
+  readonly createWebSocket?: (
+    url: string,
+    options: MilkyWsCreateOptions,
+  ) => MilkyWsSocket;
+  readonly callApi?: typeof callApi;
+}
+
+export class MilkyWsEndpoint extends ClientEndpoint<MilkyClient> {
+  readonly client: MilkyClient;
+  readonly #logger!: ReturnType<typeof getAdapterLogger>;
+
+  readonly #options: MilkyWsEndpointOptions;
+  readonly #callApi: typeof callApi;
+  readonly management: EndpointManagement;
+  readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
+  readonly #lifecycle: EndpointLifecycle;
+  #ws?: MilkyWsSocket;
+  #clientSocketRelease?: () => void;
+
+  constructor(options: MilkyWsEndpointOptions) {
+    super();
+    this.#logger = getAdapterLogger('milky', options.config.id);
+    this.#options = options;
+    this.#callApi = options.callApi ?? callApi;
+    this.client = createMilkyEndpointClient(options.config, this.#callApi);
+    this.management = createMilkyEndpointManagement({
+      callApi: (action, params) => callMilkyClient(this.client, action, params),
+    });
+    this.bindClientEvents(
+      (receive) => forwardMilkyClientEvents(this.client, receive),
+      (name, payload) => {
+        if (name === 'event') this.#admitRaw(payload as MilkyEvent);
+      },
+      (_name, error) => this.#warnPlatformEvent(error),
+    );
+    this.#lifecycle = createEndpointLifecycle({
+      name: options.config.id,
+      // reconnect_interval 旧语义为固定间隔：multiplier 1 + 无 jitter + 不封顶
+      reconnect: {
+        initialIntervalMs: options.config.reconnect_interval,
+        multiplier: 1,
+        maxIntervalMs: Number.MAX_SAFE_INTEGER,
+        jitterMs: 0,
+      },
+    });
+  }
+
+  async start(): Promise<void> {
+    if (this.#lifecycle.started) return;
+    await this.#lifecycle.start((handle) => this.#connect(handle));
+  }
+
+  close(): void {
+    super.close();
+    this.#clientSocketRelease?.();
+    this.#clientSocketRelease = undefined;
+  }
+
+  async stop(): Promise<void> {
+    this.close();
+    await this.#lifecycle.stop();
+    if (this.#ws) {
+      try {
+        this.#ws.close();
+      } catch {
+        /* ignore */
+      }
+      this.#ws = undefined;
+    }
+  }
+
+  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
+    const message = formatOutboundSegments(payload);
+    const { action, params } = buildSendAction(conversation, message);
+    const data = await callMilkyClient<{ message_seq?: number }>(this.client, action, params);
+    const messageId = formatOutboundMessageId(conversation, data?.message_seq);
+    this.#logger.debug(formatCompact({
+      op: 'milky_send',
+      endpoint: this.#options.config.id,
+      target: `${conversation.kind}:${conversation.id}`,
+      messageId,
+    }));
+    return messageId;
+  }
+
+  async recallMessage(id: string): Promise<void> {
+    const parsed = parseMilkyMessageId(id);
+    if (!parsed) throw new Error(`Invalid message id: ${id}`);
+    if (parsed.message_scene === 'group') {
+      await callMilkyClient(this.client, 'recall_group_message', {
+        group_id: parsed.peer_id,
+        message_seq: parsed.message_seq,
+      });
+    } else {
+      await callMilkyClient(this.client, 'recall_private_message', {
+        user_id: parsed.peer_id,
+        message_seq: parsed.message_seq,
+      });
+    }
+  }
+
+  #admitRaw(event: MilkyEvent): void {
+    const data = parseMessageReceiveData(event);
+    if (!data) return;
+    this.#admitMessage(data, event);
+  }
+
+  #warnPlatformEvent(error: unknown): void {
+    this.#logger.warn(formatCompact({
+      op: 'milky_platform_event_failed',
+      error: error instanceof Error ? error.message : String(error),
+    }));
+  }
+
+  #admitMessage(data: MilkyIncomingMessage, event: MilkyEvent): void {
+    const conversation = milkyInboundConversation(String(this.#options.id), data);
+    const target = `${conversation.kind}:${conversation.id}`;
+    const content = formatInboundContent(data);
+    const segments = formatInboundSegments(data);
+    const audioUrl = extractInboundAudioUrl(data);
+    const nickname = senderNickname(data);
+    const mentioned = isMentioned(data, event.self_id);
+    void this.emit('message.receive', {
+      conversation,
+      message: { conversation, id: formatInboundMessageId(data) },
+      content,
+      segments,
+      sender: { id: String(data.sender_id), name: nickname },
+      endpointId: this.#options.config.id,
+      ...(mentioned ? { mentioned: true } : {}),
+      metadata: Object.freeze({
+        message_scene: data.message_scene,
+        peer_id: String(data.peer_id),
+        sender_id: String(data.sender_id),
+        message_seq: data.message_seq,
+        time: data.time ?? event.time,
+        self_id: event.self_id != null ? String(event.self_id) : undefined,
+        ...(nickname ? { nickname } : {}),
+      }),
+    }).catch((err) => {
+      this.#logger.warn(formatCompact({
+        op: 'milky_gateway_receive_failed',
+        target,
+        error: err instanceof Error ? err.message : String(err),
+      }));
+    });
+  }
+
+  async #connect(handle: EndpointConnectHandle): Promise<void> {
+    const { url, headers, safeUrl } = buildWsConnectOptions(this.#options.config);
+    const create = this.#options.createWebSocket
+      ?? ((connectUrl: string, options: MilkyWsCreateOptions) =>
+        new WebSocket(connectUrl, { headers: options.headers }) as unknown as MilkyWsSocket);
+
+    await new Promise<void>((resolve, reject) => {
+      let settled = false;
+      const ws = create(url, { headers });
+      this.#ws = ws;
+      handle.onForceClose(() => {
+        try {
+          ws.close();
+        } catch {
+          /* ignore */
+        }
+      });
+
+      ws.on('open', () => {
+        if (settled) return;
+        settled = true;
+        if (!this.#options.config.access_token) {
+          this.#logger.warn(formatCompact({
+            endpoint: this.#options.config.id,
+            ok: false,
+            error: 'missing access_token',
+          }));
+        }
+        this.#logger.debug(formatCompact({
+          endpoint: this.#options.config.id,
+          mode: 'ws',
+          url: safeUrl,
+        }));
+        // stop-during-connect 竞态：已停止则不再武装心跳（基座 stop 已清理定时器）
+        if (this.#lifecycle.started) {
+          this.#lifecycle.startHeartbeat(() => {
+            try {
+              if (ws.readyState === WS_OPEN) ws.ping?.();
+            } catch {
+              /* ignore */
+            }
+          }, this.#options.config.heartbeat_interval);
+        }
+        resolve();
+      });
+
+      this.#clientSocketRelease?.();
+      this.#clientSocketRelease = this.client.acceptWebSocket(ws);
+
+      ws.on('close', (code, reason) => {
+        this.#clientSocketRelease?.();
+        this.#clientSocketRelease = undefined;
+        const reasonStr = typeof reason === 'string'
+          ? reason
+          : Buffer.isBuffer(reason)
+            ? reason.toString()
+            : String(reason ?? '');
+        const codeNum = typeof code === 'number' ? code : Number(code ?? 0);
+        const codeHint = codeNum === 1005
+          ? ' [无状态，多为服务端/代理未发 close 帧即断开]'
+          : codeNum === 1006
+            ? ' [异常关闭]'
+            : '';
+        this.#logger.warn(formatCompact({
+          op: 'disconnect',
+          code: codeNum,
+          error: `${reasonStr || 'closed'}${codeHint}`,
+          reconnect_ms: this.#options.config.reconnect_interval,
+        }));
+        // 基座语义：仅曾 open 的连接才武装重连；初始连接失败由 start() 的 catch 复位
+        handle.notifyClosed(new Error(`Milky WS 关闭: ${codeNum} ${reasonStr}`));
+        if (!settled) {
+          settled = true;
+          reject(new Error(`Milky WS 关闭: ${codeNum} ${reasonStr}`));
+        }
+      });
+
+      ws.on('error', (err) => {
+        const error = err instanceof Error ? err : new Error(String(err));
+        this.#logger.warn(formatCompact({
+          op: 'ws_error',
+          endpoint: this.#options.config.id,
+          ok: false,
+          error: error.message,
+        }));
+        if (!settled) {
+          settled = true;
+          reject(error);
+        }
+      });
+    });
+  }
+
+}

package/src/ws-types.ts

@@ -0,0 +1,12 @@
+/** Minimal WS surface used by the endpoint (real `ws` or test mock). */
+export interface MilkyWsSocket {
+  readonly readyState: number;
+  send?(data: string): void;
+  close(code?: number, reason?: string): void;
+  ping?(): void;
+  on(event: 'open' | 'message' | 'close' | 'error', listener: (...args: unknown[]) => void): void;
+}
+
+export interface MilkyWsCreateOptions {
+  readonly headers?: Record<string, string>;
+}

package/src/wss-endpoint.ts

@@ -0,0 +1,241 @@
+/**
+ * Milky reverse WSS endpoint — httpHostToken WS upgrade inbound + baseUrl HTTP API outbound.
+ */
+import {
+  ClientEndpoint,
+  createEndpointLifecycle,
+  createRecallEndpointControl,
+  type EndpointLifecycle,
+  type EndpointControl,
+  type EndpointManagement,
+  type EndpointSendRequest,
+} from 'zhin.js/adapter';
+import type { HttpHost, WsConnection } from '@zhin.js/host-http';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
+import type { CapabilityId } from 'zhin.js';
+import { verifyMilkyAccessToken } from './milky-auth.js';
+import { createMilkyEndpointManagement } from './endpoint-management.js';
+import { callMilkyClient, createMilkyEndpointClient, forwardMilkyClientEvents, type MilkyClient } from './client.js';
+import {
+  buildSendAction,
+  callApi,
+  extractInboundAudioUrl,
+  formatInboundContent,
+  formatInboundMessageId,
+  formatInboundSegments,
+  formatOutboundMessageId,
+  formatOutboundSegments,
+  isMentioned,
+  milkyInboundConversation,
+  parseMessageReceiveData,
+  parseMilkyMessageId,
+  senderNickname,
+  type MilkyEvent,
+  type MilkyIncomingMessage,
+  type MilkyWssConfig,
+} from './protocol.js';
+import type { MilkyWsSocket } from './ws-types.js';
+
+const WS_OPEN = 1;
+
+export interface MilkyWssEndpointOptions {
+  readonly id: CapabilityId;
+  readonly http: HttpHost;
+  readonly config: MilkyWssConfig;
+  readonly callApi?: typeof callApi;
+}
+
+export class MilkyWssEndpoint extends ClientEndpoint<MilkyClient> {
+  readonly client: MilkyClient;
+  readonly #logger!: ReturnType<typeof getAdapterLogger>;
+
+  readonly #options: MilkyWssEndpointOptions;
+  readonly #callApi: typeof callApi;
+  readonly management: EndpointManagement;
+  readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
+  #ws?: MilkyWsSocket;
+  #wsRelease?: () => void;
+  #clientSocketRelease?: () => void;
+  readonly #connectionLifecycle: EndpointLifecycle;
+  #connectionTask = Promise.resolve();
+  #started = false;
+
+  constructor(options: MilkyWssEndpointOptions) {
+    super();
+    this.#logger = getAdapterLogger('milky', options.config.id);
+    this.#options = options;
+    this.#callApi = options.callApi ?? callApi;
+    this.#connectionLifecycle = createEndpointLifecycle({
+      name: `${options.config.id}:inbound`,
+      reconnect: false,
+    });
+    this.client = createMilkyEndpointClient(options.config, this.#callApi);
+    this.management = createMilkyEndpointManagement({
+      callApi: (action, params) => callMilkyClient(this.client, action, params),
+    });
+    this.bindClientEvents(
+      (receive) => forwardMilkyClientEvents(this.client, receive),
+      (name, payload) => {
+        if (name === 'event') this.#admitRaw(payload as MilkyEvent);
+      },
+      (_name, error) => this.#warnPlatformEvent(error),
+    );
+  }
+
+  async start(): Promise<void> {
+    if (this.#started) return;
+    this.#started = true;
+    const handle = this.#options.http.ws(this.#options.config.path);
+    this.#wsRelease = handle.onConnection((connection) => {
+      this.#connectionTask = this.#connectionTask
+        .then(() => this.#acceptConnection(connection))
+        .catch((error) => {
+          this.#logger.warn(formatCompact({
+            op: 'wss_connection_failed',
+            endpoint: this.#options.config.id,
+            error: error instanceof Error ? error.message : String(error),
+          }));
+        });
+    });
+    this.#logger.info(formatCompact({
+      op: 'listen',
+      endpoint: this.#options.config.id,
+      mode: 'wss',
+      path: this.#options.config.path,
+    }));
+  }
+
+  async stop(): Promise<void> {
+    this.close();
+    this.#wsRelease?.();
+    this.#wsRelease = undefined;
+    await this.#connectionTask;
+    await this.#connectionLifecycle.stop();
+    this.#ws = undefined;
+    this.#started = false;
+  }
+
+  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
+    const message = formatOutboundSegments(payload);
+    const { action, params } = buildSendAction(conversation, message);
+    const data = await callMilkyClient<{ message_seq?: number }>(this.client, action, params);
+    const messageId = formatOutboundMessageId(conversation, data?.message_seq);
+    this.#logger.debug(formatCompact({
+      op: 'milky_send',
+      endpoint: this.#options.config.id,
+      target: `${conversation.kind}:${conversation.id}`,
+      messageId,
+    }));
+    return messageId;
+  }
+
+  async recallMessage(id: string): Promise<void> {
+    const parsed = parseMilkyMessageId(id);
+    if (!parsed) throw new Error(`Invalid message id: ${id}`);
+    if (parsed.message_scene === 'group') {
+      await callMilkyClient(this.client, 'recall_group_message', {
+        group_id: parsed.peer_id,
+        message_seq: parsed.message_seq,
+      });
+    } else {
+      await callMilkyClient(this.client, 'recall_private_message', {
+        user_id: parsed.peer_id,
+        message_seq: parsed.message_seq,
+      });
+    }
+  }
+
+  #admitRaw(event: MilkyEvent): void {
+    const data = parseMessageReceiveData(event);
+    if (!data) return;
+    this.#admitMessage(data, event);
+  }
+
+  #warnPlatformEvent(error: unknown): void {
+    this.#logger.warn(formatCompact({ op: 'milky_platform_event_failed', error: error instanceof Error ? error.message : String(error) }));
+  }
+
+  #admitMessage(data: MilkyIncomingMessage, event: MilkyEvent): void {
+    const conversation = milkyInboundConversation(String(this.#options.id), data);
+    const target = `${conversation.kind}:${conversation.id}`;
+    const content = formatInboundContent(data);
+    const segments = formatInboundSegments(data);
+    const audioUrl = extractInboundAudioUrl(data);
+    const nickname = senderNickname(data);
+    const mentioned = isMentioned(data, event.self_id);
+    void this.emit('message.receive', {
+      conversation,
+      message: { conversation, id: formatInboundMessageId(data) },
+      content,
+      segments,
+      sender: { id: String(data.sender_id) },
+      endpointId: this.#options.config.id,
+      ...(mentioned ? { mentioned: true } : {}),
+      metadata: Object.freeze({
+        message_scene: data.message_scene,
+        peer_id: String(data.peer_id),
+        sender_id: String(data.sender_id),
+        message_seq: data.message_seq,
+        time: data.time ?? event.time,
+        self_id: event.self_id != null ? String(event.self_id) : undefined,
+        ...(nickname ? { nickname } : {}),
+      }),
+    }).catch((err) => {
+      this.#logger.warn(formatCompact({
+        op: 'milky_gateway_receive_failed',
+        target,
+        error: err instanceof Error ? err.message : String(err),
+      }));
+    });
+  }
+
+  async #acceptConnection(connection: WsConnection): Promise<void> {
+    if (!verifyMilkyAccessToken(this.#options.config.access_token, connection.request)) {
+      connection.socket.close(4003, 'Unauthorized');
+      return;
+    }
+    const socket = connection.socket as unknown as MilkyWsSocket;
+    await this.#connectionLifecycle.stop();
+    await this.#connectionLifecycle.start(async (lifecycleHandle) => {
+      this.#ws = socket;
+      const releaseClientSocket = this.client.acceptWebSocket(socket);
+      this.#clientSocketRelease = releaseClientSocket;
+      lifecycleHandle.onForceClose(() => {
+        if (this.#clientSocketRelease === releaseClientSocket) {
+          releaseClientSocket();
+          this.#clientSocketRelease = undefined;
+        }
+        try {
+          socket.close();
+        } catch {
+          /* ignore */
+        }
+        if (this.#ws === socket) this.#ws = undefined;
+      });
+      this.#connectionLifecycle.startHeartbeat(() => {
+        try {
+          if (socket.readyState === WS_OPEN) socket.ping?.();
+        } catch {
+          /* ignore */
+        }
+      }, this.#options.config.heartbeat_interval);
+      socket.on('message', () => {
+        this.#connectionLifecycle.notifyHeartbeatAck();
+      });
+      socket.on('close', () => {
+        if (this.#clientSocketRelease === releaseClientSocket) {
+          releaseClientSocket();
+          this.#clientSocketRelease = undefined;
+        }
+        if (this.#ws === socket) this.#ws = undefined;
+        lifecycleHandle.notifyClosed(new Error('Milky reverse WebSocket closed'));
+      });
+    });
+    this.#logger.debug(formatCompact({
+      endpoint: this.#options.config.id,
+      mode: 'wss',
+      peer: connection.request.socket.remoteAddress,
+    }));
+  }
+
+}

package/lib/adapter.d.ts

@@ -1,29 +0,0 @@
-/**
- * Milky 适配器：单一适配器支持 WS 正向 / SSE / Webhook / 反向 WS，由 config.connection 区分
- */
-import { Adapter, Plugin } from 'zhin.js';
-import { MilkyWsClient } from './endpoint-ws.js';
-import { MilkySseClient } from './endpoint-sse.js';
-import { MilkyWebhookEndpoint } from './endpoint-webhook.js';
-import { MilkyWssServer } from './endpoint-wss.js';
-import type { MilkyEndpointConfig } from './types.js';
-export type MilkyBot = MilkyWsClient | MilkySseClient | MilkyWebhookEndpoint | MilkyWssServer;
-export declare class MilkyAdapter extends Adapter<MilkyBot> {
-    #private;
-    static readonly capabilities: readonly ["inbound", "outbound"];
-    constructor(plugin: Plugin);
-    createEndpoint(config: MilkyEndpointConfig): MilkyBot;
-    kickMember(endpointId: string, sceneId: string, userId: string): Promise<boolean>;
-    muteMember(endpointId: string, sceneId: string, userId: string, duration?: number): Promise<boolean>;
-    muteAll(endpointId: string, sceneId: string, enable?: boolean): Promise<boolean>;
-    setAdmin(endpointId: string, sceneId: string, userId: string, enable?: boolean): Promise<boolean>;
-    setMemberNickname(endpointId: string, sceneId: string, userId: string, nickname: string): Promise<boolean>;
-    setGroupName(endpointId: string, sceneId: string, name: string): Promise<boolean>;
-    listMembers(endpointId: string, sceneId: string): Promise<{
-        members: unknown[];
-        count: number;
-    }>;
-    getGroupInfo(endpointId: string, sceneId: string): Promise<unknown>;
-    start(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,OAAO,EAAE,MAAM,EAAyB,MAAM,SAAS,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EAKpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,cAAc,GAAG,oBAAoB,GAAG,cAAc,CAAC;AAE9F,qBAAa,YAAa,SAAQ,OAAO,CAAC,QAAQ,CAAC;;IACjD,gBAAyB,YAAY,mCAAoC;gBAI7D,MAAM,EAAE,MAAM;IAI1B,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,QAAQ;IAiB/C,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM9D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM;IAM9E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAO;IAM1D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAO;IAM3E,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMvF,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAM9D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;IAO/C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAMhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/lib/adapter.js

@@ -1,91 +0,0 @@
-/**
- * Milky 适配器：单一适配器支持 WS 正向 / SSE / Webhook / 反向 WS，由 config.connection 区分
- */
-import { Adapter } from 'zhin.js';
-import { MilkyWsClient } from './endpoint-ws.js';
-import { MilkySseClient } from './endpoint-sse.js';
-import { MilkyWebhookEndpoint } from './endpoint-webhook.js';
-import { MilkyWssServer } from './endpoint-wss.js';
-export class MilkyAdapter extends Adapter {
-    static capabilities = ['inbound', 'outbound'];
-    #router;
-    constructor(plugin) {
-        super(plugin, 'milky', []);
-    }
-    createEndpoint(config) {
-        switch (config.connection) {
-            case 'ws':
-                return new MilkyWsClient(this, config);
-            case 'sse':
-                return new MilkySseClient(this, config);
-            case 'webhook':
-                if (!this.#router)
-                    throw new Error('Milky connection: webhook 需要 router，请安装并在配置中启用 @zhin.js/host-router');
-                return new MilkyWebhookEndpoint(this, this.#router, config);
-            case 'wss':
-                if (!this.#router)
-                    throw new Error('Milky connection: wss 需要 router，请安装并在配置中启用 @zhin.js/host-router');
-                return new MilkyWssServer(this, this.#router, config);
-            default:
-                throw new Error(`Unknown Milky connection: ${config.connection}`);
-        }
-    }
-    async kickMember(endpointId, sceneId, userId) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.kickMember(Number(sceneId), Number(userId), false);
-    }
-    async muteMember(endpointId, sceneId, userId, duration = 600) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.muteMember(Number(sceneId), Number(userId), duration);
-    }
-    async muteAll(endpointId, sceneId, enable = true) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.muteAll(Number(sceneId), enable);
-    }
-    async setAdmin(endpointId, sceneId, userId, enable = true) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.setAdmin(Number(sceneId), Number(userId), enable);
-    }
-    async setMemberNickname(endpointId, sceneId, userId, nickname) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.setCard(Number(sceneId), Number(userId), nickname);
-    }
-    async setGroupName(endpointId, sceneId, name) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.setGroupName(Number(sceneId), name);
-    }
-    async listMembers(endpointId, sceneId) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        const members = await endpoint.getMemberList(Number(sceneId));
-        return { members: Array.isArray(members) ? members : [], count: Array.isArray(members) ? members.length : 0 };
-    }
-    async getGroupInfo(endpointId, sceneId) {
-        const endpoint = this.endpoints.get(endpointId);
-        if (!endpoint)
-            throw new Error(`Endpoint ${endpointId} 不存在`);
-        return endpoint.getGroupInfo(Number(sceneId));
-    }
-    async start() {
-        // 同步获取已就绪的 router，或通过 useContext 在 router 挂载后赋值
-        this.#router = this.plugin.inject('router');
-        this.plugin.useContext('router', (router) => {
-            this.#router = router;
-        });
-        await super.start();
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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

package/lib/api.d.ts

@@ -1,10 +0,0 @@
-export interface MilkyApiClientOptions {
-    baseUrl: string;
-    access_token?: string;
-}
-/**
- * 调用协议端 API：POST {baseUrl}/api/{apiName}，Body JSON，鉴权。
- * 非 200 或 retcode !== 0 时抛错。
- */
-export declare function callApi<T = unknown>(options: MilkyApiClientOptions, apiName: string, params?: Record<string, unknown>): Promise<T>;
-//# sourceMappingURL=api.d.ts.map