@zhin.js/adapter-slack 1.0.78 → 1.1.2

package/src/slack-reaction.ts

@@ -0,0 +1,23 @@
+/** 将 activity-feedback / 工具入参规范为 Slack reactions.add 的 name（不含冒号） */
+const UNICODE_TO_SLACK: Record<string, string> = {
+  '⏳': 'hourglass_flowing_sand',
+  '✅': 'white_check_mark',
+  '❌': 'x',
+  '⏰': 'alarm_clock',
+  '🤔': 'thinking_face',
+  '👀': 'eyes',
+};
+
+export function normalizeSlackReactionName(emoji: string): string {
+  const trimmed = emoji.trim();
+  if (!trimmed) return 'hourglass_flowing_sand';
+  if (UNICODE_TO_SLACK[trimmed]) return UNICODE_TO_SLACK[trimmed]!;
+  if (trimmed.startsWith(':') && trimmed.endsWith(':') && trimmed.length > 2) {
+    return trimmed.slice(1, -1);
+  }
+  let start = 0;
+  let end = trimmed.length;
+  while (start < end && trimmed[start] === ':') start++;
+  while (end > start && trimmed[end - 1] === ':') end--;
+  return trimmed.slice(start, end);
+}

package/src/slack-response-url.ts

@@ -0,0 +1,26 @@
+/**
+ * Slack response_url 即时 ephemeral 反馈（斜杠命令 / 按钮交互）
+ */
+import type { Logger } from '@zhin.js/logger';
+
+export function postSlackEphemeral(
+  responseUrl: string,
+  text: string,
+  logger?: Logger,
+): void {
+  if (!responseUrl?.trim()) return;
+
+  const body = JSON.stringify({
+    response_type: 'ephemeral',
+    text,
+    replace_original: false,
+  });
+
+  fetch(responseUrl, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body,
+  }).catch((err) => {
+    logger?.debug(`Slack response_url failed: ${err instanceof Error ? err.message : String(err)}`);
+  });
+}

package/src/slack-runtime-state.ts

@@ -0,0 +1,7 @@
+/**
+ * Slack 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
+ * 由 plugin.ts setup() provide，adapter create 与 `slack endpoint` 命令共享（同一 owner generation）。
+ */
+import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
+
+export const slackRuntimeStateToken = defineEndpointRuntimeStateToken('slack');

package/src/webhook.ts

@@ -0,0 +1,106 @@
+/**
+ * Slack webhook HTTP: signature → parse → admit.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import {
+  headerValue,
+  readTextBody,
+  verifySlackSignature,
+  type ResolvedSlackConfig,
+  type SlackInteractionPayload,
+  type SlackSlashCommand,
+  type SlackUrlVerification,
+} from './protocol.js';
+
+const logger = getLogger('slack');
+
+export interface SlackWebhookHandler {
+  readonly config: ResolvedSlackConfig;
+  handleEnvelope(body: unknown): void;
+  admitInteraction(payload: SlackInteractionPayload): void;
+  admitSlashCommand(cmd: SlackSlashCommand): void;
+}
+
+export function registerSlackWebhookRoutes(
+  http: HttpHost,
+  handler: SlackWebhookHandler,
+): HttpRouteRegistration[] {
+  const path = handler.config.webhookPath;
+  return [
+    http.route('POST', path, async (request, response) => {
+      await handleSlackWebhookRequest(request, response, handler);
+    }, { summary: 'Slack Events API / Interactivity', tags: ['slack'] }),
+  ];
+}
+
+export async function handleSlackWebhookRequest(
+  request: IncomingMessage,
+  response: ServerResponse,
+  handler: SlackWebhookHandler,
+): Promise<void> {
+  try {
+    const rawBody = await readTextBody(request);
+    const timestamp = headerValue(request.headers, 'x-slack-request-timestamp');
+    const signature = headerValue(request.headers, 'x-slack-signature');
+
+    if (!verifySlackSignature(handler.config.signingSecret, rawBody, timestamp, signature)) {
+      response.writeHead(401, { 'Content-Type': 'text/plain' });
+      response.end('Invalid signature');
+      return;
+    }
+
+    const contentType = headerValue(request.headers, 'content-type');
+    if (contentType.includes('application/x-www-form-urlencoded')) {
+      const params = new URLSearchParams(rawBody);
+      const payloadStr = params.get('payload');
+      if (payloadStr) {
+        const payload = JSON.parse(payloadStr) as SlackInteractionPayload;
+        response.writeHead(200);
+        response.end('');
+        handler.admitInteraction(payload);
+        return;
+      }
+      const body = Object.fromEntries(params) as unknown as SlackSlashCommand;
+      if (body.command) {
+        response.writeHead(200);
+        response.end('');
+        handler.admitSlashCommand(body);
+        return;
+      }
+    }
+
+    let envelope: Record<string, unknown>;
+    try {
+      envelope = JSON.parse(rawBody) as Record<string, unknown>;
+    } catch {
+      response.writeHead(200);
+      response.end('');
+      return;
+    }
+
+    if (envelope.type === 'url_verification') {
+      const challenge = (envelope as unknown as SlackUrlVerification).challenge;
+      response.writeHead(200, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ challenge }));
+      return;
+    }
+
+    if (envelope.type === 'event_callback' && envelope.event) {
+      response.writeHead(200);
+      response.end('');
+      handler.handleEnvelope(envelope);
+      return;
+    }
+
+    response.writeHead(200);
+    response.end('');
+  } catch (error) {
+    logger.error('Slack webhook error:', error);
+    if (!response.headersSent) {
+      response.writeHead(200);
+      response.end('');
+    }
+  }
+}

package/lib/adapter.d.ts

@@ -1,16 +0,0 @@
-/**
- * Slack 适配器
- */
-import { Adapter, Plugin } from "zhin.js";
-import { SlackBot } from "./bot.js";
-import type { SlackBotConfig } from "./types.js";
-export declare class SlackAdapter extends Adapter<SlackBot> {
-    constructor(plugin: Plugin);
-    createBot(config: SlackBotConfig): SlackBot;
-    kickMember(botId: string, sceneId: string, userId: string): Promise<boolean>;
-    setGroupName(botId: string, sceneId: string, name: string): Promise<boolean>;
-    listMembers(botId: string, sceneId: string): Promise<string[]>;
-    getGroupInfo(botId: string, sceneId: string): Promise<any>;
-    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,EACL,OAAO,EACP,MAAM,EACP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,YAAa,SAAQ,OAAO,CAAC,QAAQ,CAAC;gBACrC,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ;IAMrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMzD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMzD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM1C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQ3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/lib/adapter.js

@@ -1,43 +0,0 @@
-/**
- * Slack 适配器
- */
-import { Adapter, } from "zhin.js";
-import { SlackBot } from "./bot.js";
-export class SlackAdapter extends Adapter {
-    constructor(plugin) {
-        super(plugin, "slack", []);
-    }
-    createBot(config) {
-        return new SlackBot(this, config);
-    }
-    // ── IGroupManagement 标准群管方法 ──────────────────────────────────
-    async kickMember(botId, sceneId, userId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.kickFromChannel(sceneId, userId);
-    }
-    async setGroupName(botId, sceneId, name) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.renameChannel(sceneId, name);
-    }
-    async listMembers(botId, sceneId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.getChannelMembers(sceneId);
-    }
-    async getGroupInfo(botId, sceneId) {
-        const bot = this.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        return bot.getChannelInfo(sceneId);
-    }
-    // ── 生命周期 ───────────────────────────────────────────────────────
-    async start() {
-        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":"AAAA;;GAEG;AACH,OAAO,EACL,OAAO,GAER,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGpC,MAAM,OAAO,YAAa,SAAQ,OAAiB;IACjD,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,MAAsB;QAC9B,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAe,EAAE,MAAc;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,OAAe,EAAE,IAAY;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,OAAe;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,OAAe;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,kEAAkE;IAElE,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CAEF"}

package/lib/bot.d.ts

@@ -1,106 +0,0 @@
-import { Bot, Message, SendOptions } from 'zhin.js';
-import type { SlackBotConfig, SlackMessageEvent } from "./types.js";
-import type { SlackAdapter } from "./adapter.js";
-export declare class SlackBot implements Bot<SlackBotConfig, SlackMessageEvent> {
-    #private;
-    adapter: SlackAdapter;
-    $config: SlackBotConfig;
-    $connected: boolean;
-    /** 延迟到 `$connect`，避免子类 mock `$connect` 时仍在构造函数里创建 Bolt/WebClient（会在后台触发 Slack API） */
-    private app?;
-    private client?;
-    get logger(): import("zhin.js").Logger;
-    get $id(): string;
-    constructor(adapter: SlackAdapter, $config: SlackBotConfig);
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    private handleSlackMessage;
-    $formatMessage(msg: SlackMessageEvent): Message<SlackMessageEvent>;
-    private parseMessageContent;
-    private parseSlackText;
-    $sendMessage(options: SendOptions): Promise<string>;
-    private sendContentToChannel;
-    $recallMessage(id: string): Promise<void>;
-    /**
-     * 邀请用户到频道
-     * @param channel 频道 ID
-     * @param users 用户 ID 列表
-     */
-    inviteToChannel(channel: string, users: string[]): Promise<boolean>;
-    /**
-     * 从频道踢出用户
-     * @param channel 频道 ID
-     * @param user 用户 ID
-     */
-    kickFromChannel(channel: string, user: string): Promise<boolean>;
-    /**
-     * 设置频道话题
-     * @param channel 频道 ID
-     * @param topic 话题
-     */
-    setChannelTopic(channel: string, topic: string): Promise<boolean>;
-    /**
-     * 设置频道目的
-     * @param channel 频道 ID
-     * @param purpose 目的
-     */
-    setChannelPurpose(channel: string, purpose: string): Promise<boolean>;
-    /**
-     * 归档频道
-     * @param channel 频道 ID
-     */
-    archiveChannel(channel: string): Promise<boolean>;
-    /**
-     * 取消归档频道
-     * @param channel 频道 ID
-     */
-    unarchiveChannel(channel: string): Promise<boolean>;
-    /**
-     * 重命名频道
-     * @param channel 频道 ID
-     * @param name 新名称
-     */
-    renameChannel(channel: string, name: string): Promise<boolean>;
-    /**
-     * 获取频道成员列表
-     * @param channel 频道 ID
-     */
-    getChannelMembers(channel: string): Promise<string[]>;
-    /**
-     * 获取频道信息
-     * @param channel 频道 ID
-     */
-    getChannelInfo(channel: string): Promise<any>;
-    /**
-     * 获取用户信息
-     * @param user 用户 ID
-     */
-    getUserInfo(user: string): Promise<any>;
-    /**
-     * 添加消息反应
-     * @param channel 频道 ID
-     * @param timestamp 消息时间戳
-     * @param name 表情名称
-     */
-    addReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
-    /**
-     * 移除消息反应
-     * @param channel 频道 ID
-     * @param timestamp 消息时间戳
-     * @param name 表情名称
-     */
-    removeReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
-    /**
-     * 置顶消息
-     * @param channel 频道 ID
-     * @param timestamp 消息时间戳
-     */
-    pinMessage(channel: string, timestamp: string): Promise<boolean>;
-    /**
-     * 取消置顶消息
-     * @param channel 频道 ID
-     * @param timestamp 消息时间戳
-     */
-    unpinMessage(channel: string, timestamp: string): Promise<boolean>;
-}
-//# sourceMappingURL=bot.d.ts.map

package/lib/bot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiB,GAAG,EAAE,OAAO,EAAwC,WAAW,EAAE,MAAM,SAAS,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,qBAAa,QAAS,YAAW,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAC;;IAclD,OAAO,EAAE,YAAY;IAAS,OAAO,EAAE,cAAc;IAbxE,UAAU,EAAE,OAAO,CAAC;IACpB,sFAAsF;IACtF,OAAO,CAAC,GAAG,CAAC,CAAW;IACvB,OAAO,CAAC,MAAM,CAAC,CAAY;IAE3B,IAAI,MAAM,6BAET;IAED,IAAI,GAAG,WAEN;gBAEkB,OAAO,EAAE,YAAY,EAAS,OAAO,EAAE,cAAc;IA0BlE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAepB,kBAAkB;IAahC,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoElE,OAAO,CAAC,mBAAmB;IAiF3B,OAAO,CAAC,cAAc;IA+FhB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YAgB3C,oBAAoB;IAmF5B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzE;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtE;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvE;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW3E;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvD;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzD;;;;OAIG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpE;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU3D;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAUnD;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAU7C;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrF;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWxF;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUzE"}