@dsh-overdrive/gateway 0.2.0 → 0.3.1

package/src/adapters/slack.ts

@@ -1,123 +0,0 @@
-import Bolt from '@slack/bolt';
-import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
-
-// @slack/bolt 是 CommonJS 包：Node 原生 ESM 下 `import { App }`（命名导入）会因
-// cjs-module-lexer 无法识别其导出而失败（App 为 undefined / 静态导入抛 SyntaxError），
-// 必须 default 导入后解构。
-const { App } = Bolt;
-
-// ── 纯函数 ────────────────────────────────────────────────────
-
-export interface RawSlackMessage {
-  channel?: string;
-  user?: string;
-  text?: string;
-  subtype?: string;
-  bot_id?: string;
-  files?: Array<{ url_private?: string; mimetype?: string }>;
-}
-
-/** 纯函数：取第一条文件的私有 URL（files[0].url_private）；无文件返回 undefined。 */
-export function slackFileUrl(raw: RawSlackMessage): string | undefined {
-  return raw.files?.[0]?.url_private;
-}
-
-type MediaKind = 'voice' | 'image' | 'video' | 'file';
-
-function mediaKindFromMime(mime?: string): MediaKind {
-  if (mime?.startsWith('image/')) return 'image';
-  if (mime?.startsWith('audio/')) return 'voice';
-  if (mime?.startsWith('video/')) return 'video';
-  return 'file';
-}
-
-export function normalizeSlackMessage(raw: RawSlackMessage): NormalizedMessage | null {
-  if (!raw.channel || !raw.user || raw.subtype === 'bot_message' || raw.bot_id) return null;
-  const text = raw.text ?? '';
-  const url = slackFileUrl(raw);
-  if (!text && !url) return null;
-  const out: NormalizedMessage = { chatId: raw.channel, userId: raw.user, text };
-  if (url) out.media = { kind: mediaKindFromMime(raw.files?.[0]?.mimetype), url };
-  return out;
-}
-
-export function slackBlocks(text: string, buttons: OutboundButton[]): unknown[] {
-  const blocks: unknown[] = [{ type: 'section', text: { type: 'mrkdwn', text } }];
-  if (buttons.length > 0) {
-    blocks.push({
-      type: 'actions',
-      elements: buttons.map((b) => ({
-        type: 'button',
-        value: b.id,
-        text: { type: 'plain_text', text: b.label },
-      })),
-    });
-  }
-  return blocks;
-}
-
-// ── 适配器 ────────────────────────────────────────────────────
-
-export interface SlackAdapterOptions {
-  botToken: string;
-  appToken: string;
-}
-
-export class SlackAdapter implements Adapter {
-  readonly id = 'slack';
-  // 解构出的 App 只有值绑定（无类型绑定），实例类型需用 InstanceType<typeof App>
-  private readonly app: InstanceType<typeof App>;
-  private connected = false;
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-
-  constructor(opts: SlackAdapterOptions) {
-    this.app = new App({ token: opts.botToken, appToken: opts.appToken, socketMode: true });
-  }
-
-  async connect(): Promise<void> {
-    this.app.message(async ({ message }) => {
-      const msg = normalizeSlackMessage(message as RawSlackMessage);
-      if (msg) this.messageCb?.(msg);
-    });
-    this.app.action(/^approve:|^reject:/, async ({ ack, body, respond }) => {
-      await ack();
-      const b = body as {
-        actions?: Array<{ value?: string }>;
-        user?: { id?: string };
-        channel?: { id?: string };
-      };
-      const action = b.actions?.[0];
-      if (action?.value) {
-        this.replyCb?.(action.value, {
-          chatId: b.channel?.id ?? '',
-          userId: b.user?.id ?? '',
-        });
-      }
-      await respond({ text: '处理中…', replace_original: false }).catch(() => undefined);
-    });
-    await this.app.start(0); // Socket Mode 不需要端口；start(0) 仅建立连接
-    this.connected = true;
-    console.log('[slack] 已连接 Slack（Socket Mode）');
-  }
-
-  async send(chatId: string, payload: OutboundPayload): Promise<void> {
-    if (payload.media) {
-      await this.app.client.files.uploadV2({
-        channel_id: chatId,
-        file: payload.media.path,
-        filename: payload.media.caption ?? payload.media.path.split('/').pop(),
-      });
-      return;
-    }
-    await this.app.client.chat.postMessage({
-      channel: chatId,
-      text: payload.text,
-      blocks: slackBlocks(payload.text, payload.buttons ?? []) as never,
-    });
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  status(): { connected: boolean } { return { connected: this.connected }; }
-}

package/src/adapters/telegram.ts

@@ -1,142 +0,0 @@
-import { Bot, InlineKeyboard, InputFile } from 'grammy';
-import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
-
-// ── 纯函数 ────────────────────────────────────────────────────
-
-export interface RawTelegramMessage {
-  chat?: { id?: number | string };
-  from?: { id?: number | string };
-  message?: {
-    text?: string;
-    caption?: string;
-    photo?: Array<{ file_id?: string }>;
-    voice?: { file_id?: string; mime_type?: string };
-    audio?: { file_id?: string; mime_type?: string };
-    video?: { file_id?: string };
-    document?: { file_id?: string };
-  };
-}
-
-/** 纯函数：取 photo 数组最后一张（最大尺寸）的 file_id；无图返回 undefined。 */
-export function telegramPhotoFileId(photo: Array<{ file_id?: string }>): string | undefined {
-  return photo[photo.length - 1]?.file_id;
-}
-
-/** 纯函数：语音消息的 file_id（voice 或 audio）；无返回 undefined。 */
-export function telegramVoiceFileId(raw: RawTelegramMessage): string | undefined {
-  return raw.message?.voice?.file_id ?? raw.message?.audio?.file_id;
-}
-
-/** 纯函数：语音消息的 MIME（voice 优先，audio 兜底）。 */
-export function telegramVoiceMime(raw: RawTelegramMessage): string | undefined {
-  return raw.message?.voice?.mime_type ?? raw.message?.audio?.mime_type;
-}
-
-/** 纯函数：Telegram 文件下载 URL 模板。file_path 需 getFile(file_id) 换取（真实调用在 adapter 薄层）。 */
-export function telegramImageUrl(token: string, filePath: string): string {
-  return `https://api.telegram.org/file/bot${token}/${filePath}`;
-}
-
-export function normalizeTelegramMessage(raw: RawTelegramMessage): NormalizedMessage | null {
-  if (raw.chat?.id === undefined || raw.from?.id === undefined) return null;
-  const msg = raw.message;
-  if (!msg) return null;
-  const text = msg.text ?? msg.caption ?? '';
-  let media: NormalizedMessage['media'];
-  if (msg.photo?.length) media = { kind: 'image' }; // url 由 adapter getFile 薄层填充
-  else if (msg.voice || msg.audio) {
-    media = { kind: 'voice', mime: telegramVoiceMime(raw) }; // url 由 adapter getFile 薄层填充（ASR 用）
-  }
-  else if (msg.video) media = { kind: 'video' };
-  else if (msg.document) media = { kind: 'file' };
-  if (!text && !media) return null;
-  const out: NormalizedMessage = { chatId: String(raw.chat.id), userId: String(raw.from.id), text };
-  if (media) out.media = media;
-  return out;
-}
-
-export function buttonRows(buttons: OutboundButton[]): Array<[string, string]> {
-  return buttons.map((b) => [b.label, b.id]);
-}
-
-// ── 适配器 ────────────────────────────────────────────────────
-
-export interface TelegramAdapterOptions { token: string; }
-
-export class TelegramAdapter implements Adapter {
-  readonly id = 'telegram';
-  private readonly bot: Bot;
-  private readonly token: string;
-  private connected = false;
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-
-  constructor(opts: TelegramAdapterOptions) {
-    this.token = opts.token;
-    this.bot = new Bot(opts.token);
-  }
-
-  async connect(): Promise<void> {
-    await this.bot.api.getMe(); // 校验 token
-    this.connected = true;
-    this.bot.on('message', (ctx) => {
-      console.log(`[telegram] 收到更新: chat=${ctx.chat?.id} from=${ctx.from?.id} text="${ctx.message?.text?.slice(0, 40) ?? ''}"`);
-      void this.handleMessage(ctx as never);
-    });
-    this.bot.on('callback_query:data', async (ctx) => {
-      const data = ctx.callbackQuery.data;
-      await ctx.answerCallbackQuery().catch(() => undefined);
-      const chat = ctx.callbackQuery.message?.chat as { id?: number | string } | undefined;
-      this.replyCb?.(data, {
-        chatId: String(chat?.id ?? ''),
-        userId: String(ctx.callbackQuery.from.id),
-      });
-    });
-    this.bot.catch((err) => console.error('[telegram]', err));
-    void this.bot.start(); // 长轮询（自托管无需 webhook）
-  }
-
-  /** 薄层：photo/voice/audio → getFile(file_id) 换 file_path → 下载 URL 填充 msg.media.url（纯函数只做模板）。 */
-  private async handleMessage(raw: RawTelegramMessage): Promise<void> {
-    const msg = normalizeTelegramMessage(raw);
-    if (!msg) return;
-    const fileId =
-      msg.media?.kind === 'image'
-        ? telegramPhotoFileId(raw.message?.photo ?? [])
-        : msg.media?.kind === 'voice'
-          ? telegramVoiceFileId(raw)
-          : undefined;
-    if (fileId) {
-      try {
-        const file = await this.bot.api.getFile(fileId);
-        if (file.file_path) msg.media!.url = telegramImageUrl(this.token, file.file_path);
-      } catch (error) {
-        console.error('[telegram] getFile 失败:', error);
-      }
-    }
-    this.messageCb?.(msg);
-  }
-
-  async send(chatId: string, payload: OutboundPayload): Promise<void> {
-    if (payload.media) {
-      const file = new InputFile(payload.media.path);
-      if (payload.media.kind === 'image') {
-        await this.bot.api.sendPhoto(chatId, file, { caption: payload.media.caption ?? '' });
-      } else {
-        await this.bot.api.sendDocument(chatId, file, { caption: payload.media.caption ?? '' });
-      }
-      return;
-    }
-    if (payload.buttons?.length) {
-      const kb = new InlineKeyboard();
-      for (const [label, id] of buttonRows(payload.buttons)) kb.text(label, id);
-      await this.bot.api.sendMessage(chatId, payload.text, { reply_markup: kb });
-      return;
-    }
-    await this.bot.api.sendMessage(chatId, payload.text);
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  status(): { connected: boolean } { return { connected: this.connected }; }
-}

package/src/adapters/wechat.ts

@@ -1,247 +0,0 @@
-// v0.2b 实验性：个人微信适配器（腾讯官方 iLink / ClawBot 协议，HTTP/JSON）。
-// 协议形状与 DSH 生态已验证实现（super-wechat-bridge）一致：
-//   - 登录：GET /ilink/bot/get_bot_qrcode?bot_type=3 → GET /ilink/bot/get_qrcode_status?qrcode=
-//   - 收：POST /ilink/bot/getupdates（长轮询，响应 data.msgs + get_updates_buf 同步游标）
-//   - 发：POST /ilink/bot/sendmessage（msg 包裹 + item_list[].text_item，必须带 base_info.channel_version）
-// 使用 iLink 需遵守《微信 ClawBot 功能使用条款》；本适配器标记为实验性，需真实设备验证。
-import { randomUUID } from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import * as qrcode from 'qrcode-terminal';
-import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
-import { PendingButtons } from '../pending-buttons.js';
-
-const DEFAULT_BASE = 'https://ilinkai.weixin.qq.com';
-const CHANNEL_VERSION = '1.0.2';
-const TEXT_CHUNK_LIMIT = 800;
-
-// ── 纯函数（可单测）───────────────────────────────────────────
-
-export interface WeChatIncomingMsg {
-  from_user_id?: string;
-  context_token?: string;
-  text_item?: { text?: string };
-  item_list?: Array<{ type?: number; text_item?: { text?: string } }>;
-}
-
-/** 纯函数：从 iLink 消息提取文本（text_item 或 item_list[].text_item，type===1 为文本）。 */
-export function extractWeChatText(msg: WeChatIncomingMsg): string | null {
-  if (msg.text_item?.text) return msg.text_item.text;
-  for (const item of msg.item_list ?? []) {
-    if (item.type === 1 && item.text_item?.text) return item.text_item.text;
-  }
-  return null;
-}
-
-/** 纯函数：iLink 入站消息 → NormalizedMessage；非文本/缺发送者返回 null。 */
-export function parseWeChatUpdate(msg: WeChatIncomingMsg): NormalizedMessage | null {
-  const userId = msg.from_user_id;
-  const text = extractWeChatText(msg);
-  if (!userId || !text) return null;
-  return { chatId: userId, userId, text };
-}
-
-/** 纯函数：getupdates 长轮询请求体。base_info.channel_version 缺失时服务器不投递（生态实测）。 */
-export function buildGetUpdatesBody(syncBuf: string): Record<string, unknown> {
-  return { get_updates_buf: syncBuf, longpolling_timeout: 35000, base_info: { channel_version: CHANNEL_VERSION } };
-}
-
-/** 纯函数：sendmessage 请求体（msg 包裹 + text_item）。clientId 可注入以便测试。 */
-export function buildSendMessageBody(
-  toUserId: string,
-  text: string,
-  contextToken: string,
-  clientId = `dsh-${randomUUID()}`,
-): Record<string, unknown> {
-  return {
-    msg: {
-      from_user_id: '',
-      to_user_id: toUserId,
-      client_id: clientId,
-      message_type: 2,
-      message_state: 2,
-      context_token: contextToken,
-      item_list: [{ type: 1, text_item: { text } }],
-    },
-    base_info: { channel_version: CHANNEL_VERSION },
-  };
-}
-
-/** 纯函数：长文本按上限分段（iLink 单条消息长度限制）。 */
-export function chunkText(text: string, limit = TEXT_CHUNK_LIMIT): string[] {
-  const chunks: string[] = [];
-  for (let i = 0; i < text.length; i += limit) chunks.push(text.slice(i, i + limit));
-  return chunks;
-}
-
-/** 纯函数：审批按钮 → 编号回复文本（原生按钮不支持时的兜底）。 */
-export function buildNumberedReplyText(text: string, buttons: OutboundButton[]): string {
-  if (buttons.length === 0) return text;
-  const options = buttons.map((b, i) => `${i + 1}) ${b.label}`).join('\n');
-  return `${text}\n\n${options}\n\n回复数字选择。`;
-}
-
-// ── 适配器（实验性）────────────────────────────────────────────
-
-export interface WeChatAdapterOptions {
-  /** iLink api-token（扫码登录后自动保存；也可预先配置 WECHAT_TOKEN） */
-  token?: string;
-  baseUrl?: string;
-  stateDir?: string;
-}
-
-export class WeChatAdapter implements Adapter {
-  readonly id = 'wechat';
-  private messageCb?: (msg: NormalizedMessage) => void;
-  private replyCb?: (buttonId: string, sender: { chatId: string; userId: string }) => void;
-  private readonly pendingButtons = new PendingButtons();
-  private readonly stateDir: string;
-  private token: string;
-  private syncBuf = '';
-  private readonly contextTokens = new Map<string, string>();
-  private polling = false;
-  private stopped = false;
-
-  constructor(private readonly opts: WeChatAdapterOptions) {
-    this.stateDir = opts.stateDir ?? 'data/wechat';
-    this.token = opts.token ?? '';
-    // 恢复持久化状态：token / sync 游标 / 上下文 token（回话关联必需）
-    try {
-      if (existsSync(join(this.stateDir, 'token.txt'))) this.token = this.token || readFileSync(join(this.stateDir, 'token.txt'), 'utf8').trim();
-      if (existsSync(join(this.stateDir, 'sync_buf.txt'))) this.syncBuf = readFileSync(join(this.stateDir, 'sync_buf.txt'), 'utf8').trim();
-      if (existsSync(join(this.stateDir, 'context_tokens.json'))) {
-        const tokens = JSON.parse(readFileSync(join(this.stateDir, 'context_tokens.json'), 'utf8')) as Record<string, unknown>;
-        for (const [k, v] of Object.entries(tokens)) if (typeof v === 'string') this.contextTokens.set(k, v);
-      }
-    } catch {
-      /* 状态文件损坏则忽略，走全新登录 */
-    }
-  }
-
-  private persistState(): void {
-    try {
-      mkdirSync(this.stateDir, { recursive: true });
-      writeFileSync(join(this.stateDir, 'token.txt'), this.token, 'utf8');
-      writeFileSync(join(this.stateDir, 'sync_buf.txt'), this.syncBuf, 'utf8');
-      writeFileSync(join(this.stateDir, 'context_tokens.json'), JSON.stringify(Object.fromEntries(this.contextTokens)), 'utf8');
-    } catch {
-      /* 持久化失败不阻断 */
-    }
-  }
-
-  async connect(): Promise<void> {
-    if (!this.token) {
-      console.log('[wechat] 未配置 WECHAT_TOKEN：尝试实验性扫码登录（v0.2b）…');
-      void this.tryLogin().then((ok) => { if (ok) this.startPolling(); });
-      return;
-    }
-    this.startPolling();
-  }
-
-  private base(): string {
-    return (this.opts.baseUrl ?? DEFAULT_BASE).replace(/\/$/, '');
-  }
-
-  private async apiFetch(endpoint: string, body: Record<string, unknown>, timeoutMs = 45000): Promise<Record<string, unknown>> {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-      const res = await fetch(`${this.base()}/${endpoint}`, {
-        method: 'POST',
-        headers: {
-          'content-type': 'application/json',
-          AuthorizationType: 'ilink_bot_token',
-          Authorization: `Bearer ${this.token}`,
-          'X-WECHAT-UIN': String(Math.floor(Math.random() * 0x7fffffff)),
-        },
-        body: JSON.stringify(body),
-        signal: controller.signal,
-      });
-      if (!res.ok) throw new Error(`iLink ${endpoint} HTTP ${res.status}`);
-      return (await res.json()) as Record<string, unknown>;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-
-  /** 实验性扫码登录：打印二维码（liteapp URL 渲染为 QR），轮询扫码状态，成功后持久化 token。 */
-  private async tryLogin(): Promise<boolean> {
-    try {
-      const res = await fetch(`${this.base()}/ilink/bot/get_bot_qrcode?bot_type=3`);
-      const d = (await res.json().catch(() => null)) as { qrcode?: string; qrcode_img_content?: string } | null;
-      if (!d?.qrcode || !d.qrcode_img_content) {
-        console.warn(`[wechat] 获取登录二维码失败: ${JSON.stringify(d).slice(0, 200)}`);
-        return false;
-      }
-      console.log('[wechat] 请用微信扫描下方二维码完成 iLink ClawBot 登录:');
-      qrcode.generate(d.qrcode_img_content, { small: true });
-      for (let i = 0; i < 60 && !this.stopped; i++) {
-        await new Promise((r) => setTimeout(r, 3000));
-        try {
-          const st = (await fetch(`${this.base()}/ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(d.qrcode)}`).then((r) => r.json())) as { bot_token?: string };
-          if (st?.bot_token) {
-            this.token = st.bot_token;
-            this.persistState();
-            console.log('[wechat] 扫码成功，已保存 token，开始收消息');
-            return true;
-          }
-        } catch {
-          /* 状态轮询瞬时失败继续重试 */
-        }
-      }
-      console.log('[wechat] 扫码超时（3 分钟未确认）；重启适配器可重新生成二维码');
-      return false;
-    } catch (error) {
-      console.warn(`[wechat] 登录流程异常: ${error instanceof Error ? error.message : String(error)}`);
-      return false;
-    }
-  }
-
-  private startPolling(): void {
-    if (this.polling) return;
-    this.polling = true;
-    void this.pollLoop();
-  }
-
-  private async pollLoop(): Promise<void> {
-    while (!this.stopped && this.token) {
-      try {
-        const data = await this.apiFetch('ilink/bot/getupdates', buildGetUpdatesBody(this.syncBuf));
-        if (typeof data.get_updates_buf === 'string') {
-          this.syncBuf = data.get_updates_buf;
-          this.persistState();
-        }
-        for (const msg of (data.msgs as WeChatIncomingMsg[] | undefined) ?? []) {
-          const normalized = parseWeChatUpdate(msg);
-          if (!normalized) continue;
-          if (msg.context_token) this.contextTokens.set(normalized.userId, msg.context_token);
-          const button = this.pendingButtons.match(normalized.chatId, normalized.text);
-          if (button) {
-            this.replyCb?.(button.id, { chatId: normalized.chatId, userId: normalized.userId });
-            continue;
-          }
-          this.messageCb?.(normalized);
-        }
-      } catch (error) {
-        if (this.stopped) break;
-        console.warn(`[wechat] 轮询失败: ${error instanceof Error ? error.message : String(error)}`);
-        await new Promise((r) => setTimeout(r, 5000));
-      }
-    }
-    this.polling = false;
-  }
-
-  async send(chatId: string, payload: OutboundPayload): Promise<void> {
-    if (!this.token) throw new Error('wechat 未登录（无 token），无法发送');
-    if (payload.buttons?.length) this.pendingButtons.set(chatId, payload.buttons);
-    const text = buildNumberedReplyText(payload.text, payload.buttons ?? []);
-    const contextToken = this.contextTokens.get(chatId) ?? '';
-    for (const chunk of chunkText(text)) {
-      await this.apiFetch('ilink/bot/sendmessage', buildSendMessageBody(chatId, chunk, contextToken));
-    }
-  }
-
-  onMessage(cb: (msg: NormalizedMessage) => void): void { this.messageCb = cb; }
-  onReply(cb: (buttonId: string, sender: { chatId: string; userId: string }) => void): void { this.replyCb = cb; }
-  status(): { connected: boolean } { return { connected: Boolean(this.token) }; }
-}