@zhin.js/adapter-slack 4.1.0 → 4.1.1

package/src/slack-inbound.ts

@@ -1,140 +0,0 @@
-/**
- * Slack 入站消息解析 — 将 Slack mrkdwn 文本 + attachments + files 转为 wire segments
- */
-import type { MessageSegment } from 'zhin.js';
-import type { SlackMessageEvent, SlackEvent } from './types.js';
-import { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';
-
-export function parseSlackMessageToSegments(msg: SlackMessageEvent): MessageSegment[] {
-  const segments: MessageSegment[] = [];
-
-  if (msg.text) {
-    segments.push(...parseSlackMrkdwn(msg.text));
-  }
-
-  if ('files' in msg && Array.isArray(msg.files)) {
-    for (const file of msg.files as Record<string, unknown>[]) {
-      segments.push(parseSlackFile(file));
-    }
-  }
-
-  if ('attachments' in msg && Array.isArray(msg.attachments)) {
-    for (const att of msg.attachments as Record<string, unknown>[]) {
-      if (att.image_url) {
-        segments.push({
-          type: 'image',
-          data: {
-            url: att.image_url,
-            title: att.title,
-            text: att.text,
-          },
-        });
-      }
-    }
-  }
-
-  return segments.length > 0 ? segments : [{ type: 'text', data: { text: '' } }];
-}
-
-function parseSlackFile(file: Record<string, unknown>): MessageSegment {
-  const mime = String(file.mimetype ?? '');
-  let type: string;
-  if (mime.startsWith('image/')) type = 'image';
-  else if (mime.startsWith('video/')) type = 'video';
-  else if (mime.startsWith('audio/')) type = 'audio';
-  else type = 'file';
-
-  return {
-    type,
-    data: {
-      id: file.id,
-      name: file.name,
-      url: file.url_private ?? file.permalink,
-      size: file.size,
-      mimetype: file.mimetype,
-    },
-  };
-}
-
-export function parseSlackMrkdwn(text: string): MessageSegment[] {
-  const segments: MessageSegment[] = [];
-  let lastIndex = 0;
-
-  for (const token of scanSlackTokens(text)) {
-    const start = token.start;
-    if (start > lastIndex) {
-      const before = text.slice(lastIndex, start);
-      if (before.trim()) {
-        segments.push({ type: 'text', data: { text: mrkdwnToMarkdown(before) } });
-      }
-    }
-
-    switch (token.kind) {
-      case 'user':
-        segments.push({ type: 'at', data: { id: token.id, name: token.label || token.id, text: token.raw } });
-        break;
-      case 'channel':
-        segments.push({ type: 'channel_mention', data: { id: token.id, name: token.label || token.id, text: token.raw } });
-        break;
-      case 'link':
-        segments.push({ type: 'link', data: { url: token.url, text: token.label || token.url } });
-        break;
-    }
-    lastIndex = start + token.raw.length;
-  }
-
-  if (lastIndex < text.length) {
-    const rest = text.slice(lastIndex);
-    if (rest.trim()) {
-      segments.push({ type: 'text', data: { text: mrkdwnToMarkdown(rest) } });
-    }
-  }
-
-  return segments.length > 0 ? segments : [{ type: 'text', data: { text: mrkdwnToMarkdown(text) } }];
-}
-
-type SlackToken =
-  | { kind: 'user' | 'channel'; start: number; raw: string; id: string; label?: string }
-  | { kind: 'link'; start: number; raw: string; url: string; label?: string };
-
-function scanSlackTokens(text: string): SlackToken[] {
-  const tokens: SlackToken[] = [];
-  let cursor = 0;
-  while (cursor < text.length) {
-    const start = text.indexOf('<', cursor);
-    if (start < 0) break;
-    const end = text.indexOf('>', start + 1);
-    if (end < 0) break;
-    const raw = text.slice(start, end + 1);
-    const body = raw.slice(1, -1);
-    const sep = body.indexOf('|');
-    const head = sep >= 0 ? body.slice(0, sep) : body;
-    const label = sep >= 0 ? body.slice(sep + 1) : undefined;
-
-    if ((head.startsWith('@U') || head.startsWith('@W')) && isSlackId(head.slice(1))) {
-      tokens.push({ kind: 'user', start, raw, id: head.slice(1), label });
-    } else if (head.startsWith('#C') && isSlackId(head.slice(1))) {
-      tokens.push({ kind: 'channel', start, raw, id: head.slice(1), label });
-    } else if (head.startsWith('http://') || head.startsWith('https://')) {
-      tokens.push({ kind: 'link', start, raw, url: head, label });
-    }
-    cursor = end + 1;
-  }
-  return tokens;
-}
-
-function isSlackId(value: string): boolean {
-  if (!value) return false;
-  for (const ch of value) {
-    const code = ch.charCodeAt(0);
-    const isDigit = code >= 48 && code <= 57;
-    const isUpper = code >= 65 && code <= 90;
-    if (!isDigit && !isUpper) return false;
-  }
-  return true;
-}
-
-export function resolveSlackChannelType(event: SlackEvent): 'private' | 'group' {
-  if (event.channel_type === 'im') return 'private';
-  return 'group';
-}

package/src/slack-side-events.ts

@@ -1,74 +0,0 @@
-/**
- * Slack 事件 → zhin Notice 映射
- */
-import { mapNoticeParts, buildNotice, senderFromId } from 'zhin.js';
-import type { SlackEvent } from './types.js';
-
-export function isSlackNoticeEvent(eventType: string): boolean {
-  return SLACK_NOTICE_EVENT_TYPES.has(eventType);
-}
-
-const SLACK_NOTICE_EVENT_TYPES = new Set([
-  'member_joined_channel',
-  'member_left_channel',
-  'reaction_added',
-  'reaction_removed',
-  'message_deleted',
-  'channel_archive',
-  'channel_unarchive',
-  'channel_rename',
-  'channel_created',
-  'channel_deleted',
-  'pin_added',
-  'pin_removed',
-  'app_home_opened',
-  'team_join',
-]);
-
-export function formatSlackNotice(
-  event: SlackEvent,
-  endpointName: string,
-) {
-  const eventType = event.type;
-  const { scene_type, sub_type } = mapNoticeParts('slack', eventType);
-
-  const channelId = resolveNoticeChannelId(event);
-  const ts = event.event_ts
-    ? parseFloat(event.event_ts) * 1000
-    : Date.now();
-
-  const actorId = event.user ?? (event as any).inviter;
-  const targetId =
-    (event as any).item_user ??
-    (event as any).user ??
-    undefined;
-
-  return buildNotice(event, {
-    $id: resolveSlackSideEventDedupeKey(event),
-    $adapter: 'slack',
-    $endpoint: endpointName,
-    $type: 'notice',
-    $scene_id: channelId,
-    $scene_type: scene_type,
-    $sub_type: sub_type,
-    $actor: senderFromId(actorId),
-    $target: actorId !== targetId ? senderFromId(targetId) : undefined,
-    $timestamp: ts,
-  });
-}
-
-export function resolveSlackSideEventDedupeKey(event: SlackEvent): string {
-  const ts = event.event_ts ?? event.ts ?? '';
-  const type = event.type;
-  const channel = event.channel ?? '';
-  const user = event.user ?? '';
-  return `slack:${ts}_${type}_${channel}_${user}`;
-}
-
-function resolveNoticeChannelId(event: SlackEvent): string {
-  if (event.channel) return String(event.channel);
-  const item = (event as any).item;
-  if (item?.channel) return String(item.channel);
-  const channel = (event as any).channel_id ?? (event as any).channel?.id;
-  return channel ? String(channel) : '';
-}

package/src/transport-http.ts

@@ -1,95 +0,0 @@
-/**
- * HTTP 传输 — 在 zhin Router 上注册 /slack/events webhook
- */
-import { verifySlackSignature } from './signing.js';
-import type { SlackEventDispatcher } from './event-dispatcher.js';
-import type { SlackEndpointConfig, SlackEventEnvelope, SlackInteractionPayload, SlackSlashCommand, SlackUrlVerification } from './types.js';
-import type { Logger } from '@zhin.js/logger';
-
-export type RouterLike = {
-  post: (path: string, ...args: any[]) => void;
-};
-
-export class SlackHttpTransport {
-  constructor(
-    private config: SlackEndpointConfig,
-    private dispatcher: SlackEventDispatcher,
-    private logger: Logger,
-  ) {}
-
-  registerRoutes(router: RouterLike): void {
-    const signingSecret = this.config.signingSecret;
-
-    router.post('/slack/events', async (ctx: any) => {
-      const rawBody = await this.getRawBody(ctx);
-      const timestamp = ctx.get?.('X-Slack-Request-Timestamp') ?? ctx.headers?.['x-slack-request-timestamp'] ?? '';
-      const signature = ctx.get?.('X-Slack-Signature') ?? ctx.headers?.['x-slack-signature'] ?? '';
-
-      if (!verifySlackSignature(signingSecret, rawBody, timestamp, signature)) {
-        ctx.status = 401;
-        ctx.body = 'Invalid signature';
-        return;
-      }
-
-      const contentType: string = ctx.get?.('content-type') ?? ctx.headers?.['content-type'] ?? '';
-      let body: unknown;
-
-      if (contentType.includes('application/x-www-form-urlencoded')) {
-        const params = new URLSearchParams(rawBody);
-        const payloadStr = params.get('payload');
-        if (payloadStr) {
-          body = JSON.parse(payloadStr);
-          ctx.status = 200;
-          ctx.body = '';
-          this.handleInteraction(body as SlackInteractionPayload);
-          return;
-        }
-        body = Object.fromEntries(params);
-        if ((body as any).command) {
-          ctx.status = 200;
-          ctx.body = '';
-          this.dispatcher.routeSlashCommand(body as SlackSlashCommand);
-          return;
-        }
-      } else {
-        body = JSON.parse(rawBody);
-      }
-
-      const envelope = body as any;
-
-      if (envelope.type === 'url_verification') {
-        ctx.status = 200;
-        ctx.body = { challenge: (envelope as SlackUrlVerification).challenge };
-        return;
-      }
-
-      if (envelope.type === 'event_callback' && envelope.event) {
-        ctx.status = 200;
-        ctx.body = '';
-        this.dispatcher.routeEvent((envelope as SlackEventEnvelope).event);
-        return;
-      }
-
-      ctx.status = 200;
-      ctx.body = '';
-    });
-  }
-
-  private async getRawBody(ctx: any): Promise<string> {
-    if (ctx.request?.rawBody) return ctx.request.rawBody;
-    if (typeof ctx.request?.body === 'string') return ctx.request.body;
-    if (ctx.req) {
-      return new Promise<string>((resolve, reject) => {
-        let data = '';
-        ctx.req.on('data', (chunk: Buffer) => { data += chunk.toString(); });
-        ctx.req.on('end', () => resolve(data));
-        ctx.req.on('error', reject);
-      });
-    }
-    return JSON.stringify(ctx.request?.body ?? {});
-  }
-
-  private handleInteraction(payload: SlackInteractionPayload): void {
-    this.dispatcher.routeInteraction(payload);
-  }
-}

package/src/transport-socket.ts

@@ -1,77 +0,0 @@
-/**
- * Socket Mode 传输 — 包装 @slack/socket-mode SocketModeClient
- */
-import { SocketModeClient } from '@slack/socket-mode';
-import type { SlackEventDispatcher } from './event-dispatcher.js';
-import type { SlackEndpointConfig, SlackEventEnvelope, SlackInteractionPayload, SlackSlashCommand } from './types.js';
-import type { Logger } from '@zhin.js/logger';
-
-export class SlackSocketTransport {
-  private socketClient: SocketModeClient;
-  private connected = false;
-
-  constructor(
-    private config: SlackEndpointConfig,
-    private dispatcher: SlackEventDispatcher,
-    private logger: Logger,
-  ) {
-    if (!config.appToken) {
-      throw new Error('Socket Mode requires appToken (xapp-...)');
-    }
-    this.socketClient = new SocketModeClient({
-      appToken: config.appToken,
-      clientPingTimeout: config.clientPingTimeout ?? 15_000,
-    });
-  }
-
-  async connect(): Promise<void> {
-    this.socketClient.on('slack_event', async ({ ack, body }) => {
-      await ack();
-      this.handleEnvelope(body);
-    });
-
-    this.socketClient.on('interactive', async ({ ack, body }) => {
-      await ack();
-      this.handleInteraction(body);
-    });
-
-    this.socketClient.on('slash_commands', async ({ ack, body }) => {
-      await ack();
-      this.handleSlashCommand(body);
-    });
-
-    await this.socketClient.start();
-    this.connected = true;
-  }
-
-  async disconnect(): Promise<void> {
-    if (!this.connected) return;
-    try {
-      await this.socketClient.disconnect();
-    } catch { /* ignore */ }
-    this.connected = false;
-  }
-
-  get isConnected(): boolean { return this.connected; }
-
-  private handleEnvelope(body: unknown): void {
-    const envelope = body as SlackEventEnvelope;
-    if (envelope?.type === 'event_callback' && envelope.event) {
-      this.dispatcher.routeEvent(envelope.event);
-    }
-  }
-
-  private handleInteraction(body: unknown): void {
-    const payload = body as SlackInteractionPayload;
-    if (payload?.type) {
-      this.dispatcher.routeInteraction(payload);
-    }
-  }
-
-  private handleSlashCommand(body: unknown): void {
-    const cmd = body as SlackSlashCommand;
-    if (cmd?.command) {
-      this.dispatcher.routeSlashCommand(cmd);
-    }
-  }
-}

package/src/types.ts

@@ -1,113 +0,0 @@
-/**
- * Slack 适配器类型定义
- */
-
-export interface SlackEndpointConfig {
-  context: "slack";
-  token: string;
-  name: string;
-  signingSecret: string;
-  appToken?: string;
-  socketMode?: boolean;
-  /** Socket Mode 客户端 ping 超时（ms），默认 15000 */
-  clientPingTimeout?: number;
-  port?: number;
-}
-
-/** Slack Events API event_callback 外层包装 */
-export interface SlackEventEnvelope {
-  token?: string;
-  team_id?: string;
-  api_app_id?: string;
-  event: SlackEvent;
-  type: "event_callback";
-  event_id?: string;
-  event_time?: number;
-  authorizations?: unknown[];
-}
-
-/** Slack URL verification challenge */
-export interface SlackUrlVerification {
-  type: "url_verification";
-  token: string;
-  challenge: string;
-}
-
-/** Slack interactive payload (block_actions, etc.) */
-export interface SlackInteractionPayload {
-  type: "block_actions" | "message_action" | "shortcut" | "view_submission" | "view_closed";
-  trigger_id?: string;
-  user: { id: string; username?: string; name?: string; team_id?: string };
-  channel?: { id: string; name?: string };
-  message?: { ts: string; text?: string; [key: string]: unknown };
-  actions?: SlackBlockAction[];
-  response_url?: string;
-  [key: string]: unknown;
-}
-
-export interface SlackBlockAction {
-  type: string;
-  action_id: string;
-  block_id: string;
-  value?: string;
-  text?: { type: string; text: string };
-  action_ts?: string;
-  [key: string]: unknown;
-}
-
-/** Slack slash command payload */
-export interface SlackSlashCommand {
-  token: string;
-  team_id: string;
-  channel_id: string;
-  channel_name: string;
-  user_id: string;
-  user_name: string;
-  command: string;
-  text: string;
-  response_url: string;
-  trigger_id: string;
-  api_app_id?: string;
-}
-
-/** Union of known Slack event shapes */
-export interface SlackEvent {
-  type: string;
-  ts?: string;
-  event_ts?: string;
-  user?: string;
-  channel?: string;
-  channel_type?: string;
-  text?: string;
-  thread_ts?: string;
-  subtype?: string;
-  [key: string]: unknown;
-}
-
-/** Slack message event (narrowed from SlackEvent) */
-export type SlackMessageEvent = SlackEvent & {
-  type: "message" | "app_mention";
-  ts: string;
-  channel: string;
-};
-
-/** Assistant thread events */
-export interface SlackAssistantThreadStarted extends SlackEvent {
-  type: "assistant_thread_started";
-  assistant_thread: {
-    user_id: string;
-    context: Record<string, unknown>;
-    channel_id: string;
-    thread_ts: string;
-  };
-}
-
-export interface SlackAssistantThreadContextChanged extends SlackEvent {
-  type: "assistant_thread_context_changed";
-  assistant_thread: {
-    user_id: string;
-    context: Record<string, unknown>;
-    channel_id: string;
-    thread_ts: string;
-  };
-}