@dsh-overdrive/gateway 0.1.0 → 0.1.2

package/dist/adapter.d.ts

@@ -0,0 +1,33 @@
+export interface NormalizedMessage {
+    chatId: string;
+    userId: string;
+    text: string;
+    media?: {
+        kind: 'voice' | 'image' | 'video' | 'file';
+        url?: string;
+        mime?: string;
+        caption?: string;
+    };
+}
+export interface OutboundButton {
+    id: string;
+    label: string;
+}
+export interface OutboundPayload {
+    text: string;
+    buttons?: OutboundButton[];
+}
+/** 平台适配器契约：M2/M3 的 WhatsApp/Telegram/… 都实现它。 */
+export interface Adapter {
+    readonly id: string;
+    connect(): Promise<void>;
+    send(chatId: string, payload: OutboundPayload): Promise<void>;
+    /** 可选：平台"正在输入"指示（Telegram/WhatsApp 实现，其余默认无操作）。 */
+    sendTyping?(chatId: string): Promise<void>;
+    /** 可选：连接状态（供控制台）。 */
+    status?(): {
+        connected: boolean;
+    };
+    onMessage(cb: (msg: NormalizedMessage) => void): void;
+    onReply(cb: (buttonId: string) => void): void;
+}

package/dist/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":""}

package/dist/adapters/cli.d.ts

@@ -0,0 +1,16 @@
+import type { Adapter, NormalizedMessage, OutboundPayload } from '../adapter.js';
+/** 本地命令行适配器：M1 用于验证全链路，也是 M2+ 平台适配器的样板。 */
+export declare class CliAdapter implements Adapter {
+    readonly id = "cli";
+    private messageCb?;
+    private replyCb?;
+    private rl?;
+    connect(): Promise<void>;
+    send(_chatId: string, payload: OutboundPayload): Promise<void>;
+    onMessage(cb: (msg: NormalizedMessage) => void): void;
+    onReply(cb: (buttonId: string) => void): void;
+    /** CLI 是本地进程内适配器：恒为已连接。 */
+    status(): {
+        connected: boolean;
+    };
+}

package/dist/adapters/cli.js

@@ -0,0 +1,34 @@
+import { createInterface } from 'node:readline';
+/** 本地命令行适配器：M1 用于验证全链路，也是 M2+ 平台适配器的样板。 */
+export class CliAdapter {
+    id = 'cli';
+    messageCb;
+    replyCb;
+    rl;
+    async connect() {
+        this.rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+        this.rl.on('line', (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            const btn = trimmed.match(/^\/btn\s+(\S+)$/i);
+            if (btn) {
+                this.replyCb?.(btn[1]);
+                return;
+            }
+            this.messageCb?.({ chatId: 'cli', userId: 'local', text: trimmed });
+        });
+    }
+    async send(_chatId, payload) {
+        const lines = [payload.text];
+        for (const b of payload.buttons ?? []) {
+            lines.push(`  [按钮] ${b.label} → 输入 /btn ${b.id}`);
+        }
+        process.stdout.write(lines.join('\n') + '\n');
+    }
+    onMessage(cb) { this.messageCb = cb; }
+    onReply(cb) { this.replyCb = cb; }
+    /** CLI 是本地进程内适配器：恒为已连接。 */
+    status() { return { connected: true }; }
+}
+//# sourceMappingURL=cli.js.map

package/dist/adapters/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/adapters/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,2CAA2C;AAC3C,MAAM,OAAO,UAAU;IACZ,EAAE,GAAG,KAAK,CAAC;IACZ,SAAS,CAAoC;IAC7C,OAAO,CAA8B;IACrC,EAAE,CAAsC;IAEhD,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC9C,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,OAAwB;QAClD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,CAAC,EAAoC,IAAU,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,CAAC,EAA8B,IAAU,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;IACpE,2BAA2B;IAC3B,MAAM,KAA6B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;CACjE"}

package/dist/adapters/dingtalk.d.ts

@@ -0,0 +1,40 @@
+import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
+import { type RobotMessage } from 'dingtalk-stream-sdk-nodejs';
+export interface ParsedRobotMessage {
+    chatId: string;
+    userId: string;
+    text: string;
+    sessionWebhook: string;
+}
+export declare function parseBotMessage(data: RobotMessage): ParsedRobotMessage | null;
+export declare function buildReplyBody(text: string): {
+    msgtype: 'text';
+    text: {
+        content: string;
+    };
+};
+export declare function buildNumberedText(text: string, buttons: OutboundButton[]): string;
+export declare function matchNumberedButton(text: string, buttons: OutboundButton[]): OutboundButton | undefined;
+export interface DingTalkAdapterOptions {
+    clientId: string;
+    clientSecret: string;
+}
+export declare class DingTalkAdapter implements Adapter {
+    private readonly opts;
+    readonly id = "dingtalk";
+    private client?;
+    private connected;
+    private messageCb?;
+    private replyCb?;
+    private readonly pendingButtons;
+    /** conversationId → 最近的 sessionWebhook（回复通道，过期由钉钉侧管理） */
+    private readonly webhooks;
+    constructor(opts: DingTalkAdapterOptions);
+    connect(): Promise<void>;
+    send(chatId: string, payload: OutboundPayload): Promise<void>;
+    onMessage(cb: (msg: NormalizedMessage) => void): void;
+    onReply(cb: (buttonId: string) => void): void;
+    status(): {
+        connected: boolean;
+    };
+}

package/dist/adapters/dingtalk.js

@@ -0,0 +1,93 @@
+import { DWClient, TOPIC_ROBOT } from 'dingtalk-stream-sdk-nodejs';
+export function parseBotMessage(data) {
+    if (data.msgtype !== 'text' || !data.text?.content)
+        return null;
+    if (!data.conversationId || !data.senderStaffId || !data.sessionWebhook)
+        return null;
+    return {
+        chatId: data.conversationId,
+        userId: data.senderStaffId,
+        text: data.text.content,
+        sessionWebhook: data.sessionWebhook,
+    };
+}
+export function buildReplyBody(text) {
+    return { msgtype: 'text', text: { content: text } };
+}
+export function buildNumberedText(text, buttons) {
+    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 function matchNumberedButton(text, buttons) {
+    const n = Number(text.trim());
+    if (!Number.isInteger(n) || n < 1 || n > buttons.length)
+        return undefined;
+    return buttons[n - 1];
+}
+export class DingTalkAdapter {
+    opts;
+    id = 'dingtalk';
+    client;
+    connected = false;
+    messageCb;
+    replyCb;
+    pendingButtons = new Map();
+    /** conversationId → 最近的 sessionWebhook（回复通道，过期由钉钉侧管理） */
+    webhooks = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async connect() {
+        const client = new DWClient({ clientId: this.opts.clientId, clientSecret: this.opts.clientSecret });
+        this.client = client;
+        client.registerCallbackListener(TOPIC_ROBOT, (msg) => {
+            let data;
+            try {
+                data = JSON.parse(msg.data);
+            }
+            catch {
+                return;
+            }
+            const parsed = parseBotMessage(data);
+            if (!parsed)
+                return;
+            this.webhooks.set(parsed.chatId, parsed.sessionWebhook);
+            const pending = this.pendingButtons.get(parsed.chatId);
+            if (pending) {
+                const button = matchNumberedButton(parsed.text, pending);
+                if (button) {
+                    this.pendingButtons.delete(parsed.chatId);
+                    this.replyCb?.(button.id);
+                    return;
+                }
+            }
+            this.messageCb?.({ chatId: parsed.chatId, userId: parsed.userId, text: parsed.text });
+        });
+        await client.connect();
+        this.connected = true;
+        console.log('[dingtalk] 钉钉 Stream 已连接');
+    }
+    async send(chatId, payload) {
+        const webhook = this.webhooks.get(chatId);
+        if (!webhook)
+            throw new Error(`钉钉会话 ${chatId} 无可用 sessionWebhook（先让用户发一条消息）`);
+        if (payload.buttons?.length)
+            this.pendingButtons.set(chatId, payload.buttons);
+        const text = buildNumberedText(payload.text, payload.buttons ?? []);
+        const res = await fetch(webhook, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(buildReplyBody(text)),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`钉钉回发失败 ${res.status}: ${body.slice(0, 200)}`);
+        }
+    }
+    onMessage(cb) { this.messageCb = cb; }
+    onReply(cb) { this.replyCb = cb; }
+    status() { return { connected: this.connected }; }
+}
+//# sourceMappingURL=dingtalk.js.map

package/dist/adapters/dingtalk.js.map

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

package/dist/adapters/discord.d.ts

@@ -0,0 +1,38 @@
+import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
+export interface RawDiscordMessage {
+    channelId?: string;
+    author?: {
+        id?: string;
+        bot?: boolean;
+    };
+    content?: string;
+    attachments?: Array<{
+        url?: string;
+        contentType?: string;
+    }>;
+}
+/** 纯函数：取第一条附件的下载 URL（attachments.first().url）；无附件返回 undefined。 */
+export declare function discordAttachmentUrl(raw: RawDiscordMessage): string | undefined;
+export declare function normalizeDiscordMessage(raw: RawDiscordMessage): NormalizedMessage | null;
+export declare function discordComponents(buttons: OutboundButton[]): Array<{
+    type: 1;
+    components: unknown[];
+}>;
+export interface DiscordAdapterOptions {
+    token: string;
+}
+export declare class DiscordAdapter implements Adapter {
+    readonly id = "discord";
+    private readonly client;
+    private connected;
+    private messageCb?;
+    private replyCb?;
+    constructor(opts: DiscordAdapterOptions);
+    connect(): Promise<void>;
+    send(chatId: string, payload: OutboundPayload): Promise<void>;
+    onMessage(cb: (msg: NormalizedMessage) => void): void;
+    onReply(cb: (buttonId: string) => void): void;
+    status(): {
+        connected: boolean;
+    };
+}

package/dist/adapters/discord.js

@@ -0,0 +1,88 @@
+import { ActionRowBuilder, ButtonBuilder, ButtonStyle, Client, Events, GatewayIntentBits, } from 'discord.js';
+/** 纯函数：取第一条附件的下载 URL（attachments.first().url）；无附件返回 undefined。 */
+export function discordAttachmentUrl(raw) {
+    return raw.attachments?.[0]?.url;
+}
+function mediaKindFromMime(mime) {
+    if (mime?.startsWith('image/'))
+        return 'image';
+    if (mime?.startsWith('audio/'))
+        return 'voice';
+    if (mime?.startsWith('video/'))
+        return 'video';
+    return 'file';
+}
+export function normalizeDiscordMessage(raw) {
+    if (!raw.channelId || !raw.author?.id || raw.author.bot)
+        return null;
+    const text = raw.content ?? '';
+    const url = discordAttachmentUrl(raw);
+    if (!text && !url)
+        return null;
+    const out = { chatId: raw.channelId, userId: raw.author.id, text };
+    if (url)
+        out.media = { kind: mediaKindFromMime(raw.attachments?.[0]?.contentType), url };
+    return out;
+}
+export function discordComponents(buttons) {
+    return [{
+            type: 1,
+            components: buttons.map((b) => ({
+                type: 2,
+                custom_id: b.id,
+                label: b.label,
+                style: 1, // ButtonStyle.Primary
+            })),
+        }];
+}
+export class DiscordAdapter {
+    id = 'discord';
+    client;
+    connected = false;
+    messageCb;
+    replyCb;
+    constructor(opts) {
+        this.client = new Client({
+            intents: [
+                GatewayIntentBits.Guilds,
+                GatewayIntentBits.GuildMessages,
+                GatewayIntentBits.DirectMessages,
+                GatewayIntentBits.MessageContent,
+            ],
+        });
+        void opts.token;
+        this.client.login(opts.token).catch((e) => console.error('[discord] 登录失败:', e));
+    }
+    async connect() {
+        this.client.once(Events.ClientReady, () => { this.connected = true; console.log('[discord] 已连接 Discord'); });
+        this.client.on(Events.MessageCreate, (m) => {
+            const msg = normalizeDiscordMessage(m);
+            if (msg)
+                this.messageCb?.(msg);
+        });
+        this.client.on(Events.InteractionCreate, async (interaction) => {
+            if (!interaction.isButton())
+                return;
+            const button = interaction;
+            await button.deferUpdate().catch(() => undefined);
+            this.replyCb?.(button.customId);
+        });
+    }
+    async send(chatId, payload) {
+        const channel = await this.client.channels.fetch(chatId);
+        if (!channel || !('send' in channel)) {
+            console.error(`[discord] 无法向 ${chatId} 发送（channel 不可用）`);
+            return;
+        }
+        if (payload.buttons?.length) {
+            const row = new ActionRowBuilder().addComponents(payload.buttons.map((b) => new ButtonBuilder().setCustomId(b.id).setLabel(b.label).setStyle(ButtonStyle.Primary)));
+            await channel.send({ content: payload.text, components: [row] });
+            return;
+        }
+        await channel.send(payload.text);
+    }
+    onMessage(cb) { this.messageCb = cb; }
+    onReply(cb) { this.replyCb = cb; }
+    status() { return { connected: this.connected }; }
+}
+//# sourceMappingURL=discord.js.map

package/dist/adapters/discord.js.map

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

package/dist/adapters/feishu.d.ts

@@ -0,0 +1,43 @@
+import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
+export interface FeishuReceivePayload {
+    event?: {
+        message?: {
+            message_id?: string;
+            chat_id?: string;
+            message_type?: string;
+            content?: string;
+        };
+        sender?: {
+            sender_id?: {
+                open_id?: string;
+            };
+        };
+    };
+}
+export declare function parseFeishuTextMessage(payload: FeishuReceivePayload): NormalizedMessage | null;
+export declare function buildNumberedText(text: string, buttons: OutboundButton[]): string;
+export declare function matchNumberedButton(text: string, buttons: OutboundButton[]): OutboundButton | undefined;
+export interface FeishuAdapterOptions {
+    appId: string;
+    appSecret: string;
+}
+export declare class FeishuAdapter implements Adapter {
+    private readonly opts;
+    readonly id = "feishu";
+    private readonly client;
+    private ws?;
+    private connected;
+    private messageCb?;
+    private replyCb?;
+    private readonly pendingButtons;
+    /** chatId → 最近一条入站消息的 message_id（send 优先 reply，缺失则 create 兜底） */
+    private readonly lastMessageIds;
+    constructor(opts: FeishuAdapterOptions);
+    connect(): Promise<void>;
+    send(chatId: string, payload: OutboundPayload): Promise<void>;
+    onMessage(cb: (msg: NormalizedMessage) => void): void;
+    onReply(cb: (buttonId: string) => void): void;
+    status(): {
+        connected: boolean;
+    };
+}

package/dist/adapters/feishu.js

@@ -0,0 +1,107 @@
+import lark from '@larksuiteoapi/node-sdk';
+// @larksuiteoapi/node-sdk 是 CommonJS 包（main=lib/index.js，无 "type":"module"）：
+// Node 原生 ESM 下必须 default 导入后解构（同 M2b 的 @slack/bolt 处理）。
+const { Client, WSClient, EventDispatcher } = lark;
+export function parseFeishuTextMessage(payload) {
+    const message = payload.event?.message;
+    const sender = payload.event?.sender?.sender_id?.open_id;
+    if (!message?.chat_id || !sender)
+        return null;
+    if (message.message_type !== 'text')
+        return null;
+    let text = '';
+    try {
+        text = JSON.parse(message.content ?? '{}').text ?? '';
+    }
+    catch {
+        return null;
+    }
+    if (!text)
+        return null;
+    return { chatId: message.chat_id, userId: sender, text };
+}
+export function buildNumberedText(text, buttons) {
+    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 function matchNumberedButton(text, buttons) {
+    const n = Number(text.trim());
+    if (!Number.isInteger(n) || n < 1 || n > buttons.length)
+        return undefined;
+    return buttons[n - 1];
+}
+export class FeishuAdapter {
+    opts;
+    id = 'feishu';
+    client;
+    ws;
+    connected = false;
+    messageCb;
+    replyCb;
+    pendingButtons = new Map();
+    /** chatId → 最近一条入站消息的 message_id（send 优先 reply，缺失则 create 兜底） */
+    lastMessageIds = new Map();
+    constructor(opts) {
+        this.opts = opts;
+        this.client = new Client({ appId: opts.appId, appSecret: opts.appSecret });
+    }
+    async connect() {
+        const dispatcher = new EventDispatcher({}).register({
+            'im.message.receive_v1': async (data) => {
+                const message = data.event?.message;
+                if (message?.chat_id && message.message_id) {
+                    this.lastMessageIds.set(message.chat_id, message.message_id);
+                }
+                const normalized = parseFeishuTextMessage(data);
+                if (!normalized)
+                    return;
+                const chatId = normalized.chatId;
+                const pending = this.pendingButtons.get(chatId);
+                if (pending) {
+                    const button = matchNumberedButton(normalized.text, pending);
+                    if (button) {
+                        this.pendingButtons.delete(chatId);
+                        this.replyCb?.(button.id);
+                        return;
+                    }
+                }
+                this.messageCb?.(normalized);
+            },
+        });
+        this.ws = new WSClient({
+            appId: this.opts.appId,
+            appSecret: this.opts.appSecret,
+            loggerLevel: lark.LoggerLevel.error,
+        });
+        await this.ws.start({ eventDispatcher: dispatcher });
+        this.connected = true;
+        console.log('[feishu] 飞书长连接已建立');
+    }
+    async send(chatId, payload) {
+        if (payload.buttons?.length)
+            this.pendingButtons.set(chatId, payload.buttons);
+        const text = buildNumberedText(payload.text, payload.buttons ?? []);
+        const content = JSON.stringify({ text });
+        const messageId = this.lastMessageIds.get(chatId);
+        if (messageId) {
+            // 有最近入站消息：im.message.reply（path=message_id）回复原消息
+            await this.client.im.message.reply({
+                path: { message_id: messageId },
+                data: { msg_type: 'text', content },
+            });
+        }
+        else {
+            // 无入站消息（主动下发）：im.message.create 按 receive_id=chat_id 发送
+            await this.client.im.message.create({
+                params: { receive_id_type: 'chat_id' },
+                data: { receive_id: chatId, msg_type: 'text', content },
+            });
+        }
+    }
+    onMessage(cb) { this.messageCb = cb; }
+    onReply(cb) { this.replyCb = cb; }
+    status() { return { connected: this.connected }; }
+}
+//# sourceMappingURL=feishu.js.map

package/dist/adapters/feishu.js.map

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

package/dist/adapters/slack.d.ts

@@ -0,0 +1,35 @@
+import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
+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 declare function slackFileUrl(raw: RawSlackMessage): string | undefined;
+export declare function normalizeSlackMessage(raw: RawSlackMessage): NormalizedMessage | null;
+export declare function slackBlocks(text: string, buttons: OutboundButton[]): unknown[];
+export interface SlackAdapterOptions {
+    botToken: string;
+    appToken: string;
+}
+export declare class SlackAdapter implements Adapter {
+    readonly id = "slack";
+    private readonly app;
+    private connected;
+    private messageCb?;
+    private replyCb?;
+    constructor(opts: SlackAdapterOptions);
+    connect(): Promise<void>;
+    send(chatId: string, payload: OutboundPayload): Promise<void>;
+    onMessage(cb: (msg: NormalizedMessage) => void): void;
+    onReply(cb: (buttonId: string) => void): void;
+    status(): {
+        connected: boolean;
+    };
+}

package/dist/adapters/slack.js

@@ -0,0 +1,83 @@
+import Bolt from '@slack/bolt';
+// @slack/bolt 是 CommonJS 包：Node 原生 ESM 下 `import { App }`（命名导入）会因
+// cjs-module-lexer 无法识别其导出而失败（App 为 undefined / 静态导入抛 SyntaxError），
+// 必须 default 导入后解构。
+const { App } = Bolt;
+/** 纯函数：取第一条文件的私有 URL（files[0].url_private）；无文件返回 undefined。 */
+export function slackFileUrl(raw) {
+    return raw.files?.[0]?.url_private;
+}
+function mediaKindFromMime(mime) {
+    if (mime?.startsWith('image/'))
+        return 'image';
+    if (mime?.startsWith('audio/'))
+        return 'voice';
+    if (mime?.startsWith('video/'))
+        return 'video';
+    return 'file';
+}
+export function normalizeSlackMessage(raw) {
+    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 = { chatId: raw.channel, userId: raw.user, text };
+    if (url)
+        out.media = { kind: mediaKindFromMime(raw.files?.[0]?.mimetype), url };
+    return out;
+}
+export function slackBlocks(text, buttons) {
+    const blocks = [{ 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 class SlackAdapter {
+    id = 'slack';
+    // 解构出的 App 只有值绑定（无类型绑定），实例类型需用 InstanceType<typeof App>
+    app;
+    connected = false;
+    messageCb;
+    replyCb;
+    constructor(opts) {
+        this.app = new App({ token: opts.botToken, appToken: opts.appToken, socketMode: true });
+    }
+    async connect() {
+        this.app.message(async ({ message }) => {
+            const msg = normalizeSlackMessage(message);
+            if (msg)
+                this.messageCb?.(msg);
+        });
+        this.app.action(/^approve:|^reject:/, async ({ ack, body, respond }) => {
+            await ack();
+            const action = body.actions?.[0];
+            if (action?.value)
+                this.replyCb?.(action.value);
+            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, payload) {
+        await this.app.client.chat.postMessage({
+            channel: chatId,
+            text: payload.text,
+            blocks: slackBlocks(payload.text, payload.buttons ?? []),
+        });
+    }
+    onMessage(cb) { this.messageCb = cb; }
+    onReply(cb) { this.replyCb = cb; }
+    status() { return { connected: this.connected }; }
+}
+//# sourceMappingURL=slack.js.map