@zhin.js/adapter-slack 4.1.0 → 5.0.0

package/lib/webhook.js

@@ -0,0 +1,69 @@
+import { getLogger } from '@zhin.js/logger';
+import { headerValue, readTextBody, verifySlackSignature, } from './protocol.js';
+const logger = getLogger('slack');
+export function registerSlackWebhookRoutes(http, handler) {
+    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, response, handler) {
+    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) {
+                response.writeHead(200);
+                response.end('');
+                handler.admitInteraction(JSON.parse(payloadStr));
+                return;
+            }
+            const body = Object.fromEntries(params);
+            if (body.command) {
+                response.writeHead(200);
+                response.end('');
+                handler.admitSlashCommand(body);
+                return;
+            }
+        }
+        let envelope;
+        try {
+            envelope = JSON.parse(rawBody);
+        }
+        catch {
+            response.writeHead(200);
+            response.end('');
+            return;
+        }
+        if (envelope.type === 'url_verification') {
+            const challenge = envelope.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);
+        response.writeHead(200);
+        response.end('');
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/adapter-slack",
-  "version": "4.1.0",
-  "description": "Zhin.js adapter for Slack",
+  "version": "5.0.0",
+  "description": "Zhin.js Slack adapter for Plugin Runtime (Socket Mode / HTTP Events)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -34,24 +34,23 @@
   "dependencies": {
     "@slack/socket-mode": "^2.0.3",
     "@slack/web-api": "^7.17.0",
-    "@zhin.js/logger": "1.0.74"
-  },
-  "devDependencies": {
-    "@types/node": "^26.1.0",
-    "typescript": "^6.0.3",
-    "zod": "^4.4.3",
-    "@zhin.js/host-router": "2.0.3",
-    "zhin.js": "4.1.2",
-    "@zhin.js/agent": "1.0.3"
+    "@zhin.js/adapter": "1.1.0",
+    "@zhin.js/core": "1.4.0",
+    "@zhin.js/host-http": "1.0.2",
+    "@zhin.js/logger": "1.0.75",
+    "@zhin.js/plugin-runtime": "1.1.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "zhin.js": "4.1.2",
-    "@zhin.js/agent": "1.0.3",
-    "@zhin.js/host-router": "2.0.3"
+    "@zhin.js/adapter": "1.1.0",
+    "@zhin.js/agent": "1.0.5",
+    "@zhin.js/core": "1.4.0",
+    "@zhin.js/host-http": "1.0.2",
+    "@zhin.js/plugin-runtime": "1.1.0",
+    "zhin.js": "5.0.0"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/host-router": {
+    "zhin.js": {
       "optional": true
     },
     "@zhin.js/agent": {
@@ -61,13 +60,21 @@
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/agent": "1.0.5",
+    "zhin.js": "5.0.0"
+  },
   "files": [
+    "adapters",
+    "plugin.ts",
+    "schema.json",
     "src",
     "lib",
     "agent",
-    "client",
-    "dist",
-    "plugin.yml",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -78,9 +85,23 @@
   "engines": {
     "node": "^20.19.0 || >=22.12.0"
   },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.ts",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/adapter",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "pnpm build:node",
+    "build": "tsc",
     "clean": "rimraf lib",
-    "build:node": "tsc"
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/slack/tests"
   }
 }

package/plugin.ts

@@ -0,0 +1,13 @@
+import { definePlugin } from '@zhin.js/plugin-runtime';
+import { registerSlackPlatformPermitChecker } from './src/platform-permit.js';
+
+export default definePlugin({
+  name: 'slack',
+  metadata: {
+    displayName: 'Slack Adapter',
+  },
+  setup() {
+    // 平台权限门禁：workspace_owner / channel_manager 等（agent 工具 platformPermit）
+    return registerSlackPlatformPermitChecker();
+  },
+});

package/schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "socketMode": {
+      "type": "boolean",
+      "default": true,
+      "description": "Prefer Socket Mode (default). Set false for HTTP Events via httpHostToken."
+    },
+    "webhookPath": {
+      "type": "string",
+      "default": "/slack/events"
+    },
+    "clientPingTimeout": {
+      "type": "number",
+      "default": 15000,
+      "description": "Socket Mode client ping timeout (ms)"
+    },
+    "endpoints": {
+      "type": "array",
+      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（name 必填，其余覆盖顶层）",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Slack bot name"
+          },
+          "token": {
+            "type": "string",
+            "description": "Bot User OAuth Token (xoxb-...)"
+          },
+          "signingSecret": {
+            "type": "string",
+            "description": "Required for HTTP Events API (socketMode: false)"
+          },
+          "appToken": {
+            "type": "string",
+            "description": "App-Level Token (xapp-...) for Socket Mode"
+          }
+        },
+        "required": [
+          "name",
+          "token"
+        ]
+      }
+    },
+    "commandPrefix": {
+      "type": "string",
+      "default": "",
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+    }
+  },
+  "required": [
+    "endpoints"
+  ]
+}