@zhin.js/adapter-line 0.1.1 → 1.1.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/adapter-line",
-  "version": "0.1.1",
-  "description": "Zhin.js adapter for LINE Messaging API",
+  "version": "1.1.0",
+  "description": "Zhin.js LINE Messaging API adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -31,34 +31,53 @@
     "type": "git",
     "directory": "plugins/adapters/line"
   },
-  "devDependencies": {
-    "@types/node": "^25.9.2",
-    "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.89",
-    "@zhin.js/host-api": "1.0.1",
-    "@zhin.js/host-router": "1.0.1",
-    "@zhin.js/logger": "0.1.71",
-    "zhin.js": "2.0.1"
+  "dependencies": {
+    "@zhin.js/adapter": "1.1.12",
+    "@zhin.js/core": "1.1.35",
+    "@zhin.js/feature-kit": "1.1.0",
+    "@zhin.js/host-http": "1.1.0",
+    "@zhin.js/im-contract": "1.1.0",
+    "@zhin.js/logger": "1.1.0"
   },
   "peerDependencies": {
-    "@zhin.js/host-router": "1.0.1",
-    "@zhin.js/host-api": "1.0.1",
-    "@zhin.js/logger": "0.1.71",
-    "zhin.js": "2.0.1"
+    "zod": "^4.0.0",
+    "@zhin.js/adapter": "^1.1.12",
+    "@zhin.js/agent": "^1.1.23",
+    "@zhin.js/command": "^1.1.0",
+    "@zhin.js/core": "^1.1.35",
+    "@zhin.js/host-http": "^1.1.0",
+    "zhin.js": "^1.1.0"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/host-router": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "zhin.js": {
       "optional": true
     },
-    "@zhin.js/host-api": {
+    "zod": {
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/agent": "1.1.23",
+    "zhin.js": "1.1.0"
+  },
   "files": [
+    "adapters",
+    "commands",
+    "plugin.js",
+    "schema.json",
     "src",
     "lib",
-    "skills",
-    "plugin.yml",
+    "agent",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -66,9 +85,30 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/adapter",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "zhin build",
-    "clean": "rimraf lib dist",
-    "build:node": "tsc"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/line/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,14 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createEndpointRuntimeState } from 'zhin.js/adapter';
+import { definePlugin } from 'zhin.js';
+import { lineRuntimeStateToken } from "./lib/line-runtime-state.js";
+export default definePlugin({
+    name: 'line',
+    metadata: {
+        displayName: 'LINE Messaging API Adapter',
+    },
+    setup(context) {
+        // 运行中 endpoint 注册表（line.endpoint list 的"运行中"数据源）
+        context.resources.provide(lineRuntimeStateToken, createEndpointRuntimeState());
+    },
+});

package/schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "webhookPath": {
+      "type": "string",
+      "default": "/line/webhook"
+    },
+    "apiBaseUrl": {
+      "type": "string",
+      "default": "https://api.line.me"
+    },
+    "master": {
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "框架 master（LINE user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+    },
+    "trusted": {
+      "type": "array",
+      "items": {
+        "type": [
+          "string",
+          "number"
+        ],
+        "description": "Trusted LINE user id"
+      },
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+    },
+    "endpoints": {
+      "type": "array",
+      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "master": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "本 endpoint 的框架 master（LINE user id）；覆盖顶层 master"
+          },
+          "trusted": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Trusted LINE user id"
+            },
+            "description": "本 endpoint 的 trusted 列表"
+          },
+          "channelSecret": {
+            "type": "string",
+            "description": "LINE channel secret"
+          },
+          "channelAccessToken": {
+            "type": "string",
+            "description": "LINE channel access token"
+          },
+          "id": {
+            "type": "string",
+            "description": "LINE bot name"
+          }
+        },
+        "required": [
+          "id",
+          "channelSecret",
+          "channelAccessToken"
+        ]
+      }
+    },
+    "commandPrefix": {
+      "type": "string",
+      "default": "",
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+    }
+  },
+  "required": [
+    "endpoints"
+  ]
+}

package/src/client.ts

@@ -0,0 +1,87 @@
+import type { LineFetch } from './endpoint.js';
+import { defineEndpointClient } from 'zhin.js/adapter';
+import type { LineEvent, ResolvedLineConfig } from './protocol.js';
+
+export interface LineGroupMember {
+  readonly user_id: string;
+  readonly nickname: string;
+}
+
+/** Direct LINE Messaging API client; it has no Endpoint lifecycle methods. */
+export class LineClient {
+  constructor(
+    readonly config: ResolvedLineConfig,
+    readonly fetch: LineFetch,
+  ) {}
+
+  async request<T = unknown>(path: string, init: {
+    readonly method?: string;
+    readonly body?: string;
+    readonly signal?: AbortSignal;
+  } = {}): Promise<T> {
+    const response = await this.fetch(`${this.config.apiBaseUrl}${path}`, {
+      method: init.method ?? 'GET',
+      headers: {
+        Authorization: `Bearer ${this.config.channelAccessToken}`,
+        ...(init.body === undefined ? {} : { 'Content-Type': 'application/json' }),
+      },
+      ...(init.body === undefined ? {} : { body: init.body }),
+      signal: init.signal ?? AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`LINE API error ${response.status}: ${text}`);
+    }
+    return await response.json() as T;
+  }
+
+  getProfile(userId: string): Promise<unknown> {
+    return this.request(`/v2/profile/${encodeURIComponent(userId)}`);
+  }
+
+  getGroupMemberIds(groupId: string, start?: string): Promise<{
+    readonly memberIds?: string[];
+    readonly next?: string;
+  }> {
+    const kind = groupId.startsWith('R') ? 'room' : 'group';
+    const query = start ? `?start=${encodeURIComponent(start)}` : '';
+    return this.request(
+      `/v2/bot/${kind}/${encodeURIComponent(groupId)}/members/ids${query}`,
+    );
+  }
+
+  async getGroupMembers(groupId: string): Promise<LineGroupMember[]> {
+    const kind = groupId.startsWith('R') ? 'room' : 'group';
+    const ids: string[] = [];
+    let next: string | undefined;
+    do {
+      const page = await this.getGroupMemberIds(groupId, next);
+      ids.push(...(page.memberIds ?? []).filter((id) => typeof id === 'string' && id.length > 0));
+      next = page.next || undefined;
+    } while (next);
+
+    return Promise.all(ids.map(async (userId) => {
+      try {
+        const profile = await this.request<{ displayName?: string }>(
+          `/v2/bot/${kind}/${encodeURIComponent(groupId)}/member/${encodeURIComponent(userId)}`,
+        );
+        return { user_id: userId, nickname: String(profile.displayName ?? userId) };
+      } catch {
+        return { user_id: userId, nickname: userId };
+      }
+    }));
+  }
+}
+
+export type LineClientEventMap = Record<string, LineEvent>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly line: {
+      readonly client: LineClient;
+      readonly events: LineClientEventMap;
+    };
+  }
+}
+
+export const lineClient = defineEndpointClient<LineClient, LineClientEventMap>('line');