@clowder-ai/connector-feishu 0.0.0-stage → 0.1.0-alpha.5

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@clowder-ai/connector-feishu",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-alpha.5",
+  "description": "Feishu and Lark enterprise messaging connector for Clowder AI hosts",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest": "./plugin.yaml"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "plugin.yaml",
+    "README.md",
+    "assets",
+    "npm-shrinkwrap.json",
+    "README.en.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json",
+    "test": "node --import tsx --test src/**/*.test.ts",
+    "lint": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json",
+    "clean": "rm -rf dist",
+    "prepack": "pnpm build"
+  },
+  "dependencies": {
+    "@clowder-ai/plugin-sdk": "0.2.0-beta.21",
+    "@larksuiteoapi/node-sdk": "1.59.0",
+    "qrcode": "1.5.4",
+    "@clowder-ai/plugin-contract": "0.1.0-beta.37"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "@types/qrcode": "^1.5.5",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "yaml": "2.9.0"
+  },
+  "keywords": [
+    "clowder-ai",
+    "connector",
+    "feishu",
+    "lark",
+    "messaging"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zts212653/clowder-ai-plugins.git",
+    "directory": "packages/connector-feishu"
+  }
+}

package/plugin.yaml

@@ -0,0 +1,118 @@
+pluginId: official.connector.feishu
+version: 0.1.0-alpha.5
+contractVersion: 0.1.0
+name: Feishu / Lark Connector
+description:
+  default: Receive and send Feishu or Lark messages through a Host-owned connector binding.
+  translations:
+    zh-CN: 通过宿主所有的连接器绑定接收和发送飞书或 Lark 消息。
+icon:
+  type: svg
+  src: assets/icon.svg
+configuration:
+  - key: appId
+    label: App ID
+    kind: string
+    required: true
+  - key: appSecret
+    label: App Secret
+    kind: secret
+    required: true
+  - key: connectionMode
+    label: 连接模式
+    kind: select
+    required: false
+    default: webhook
+    options:
+      - value: webhook
+        label: Webhook（需公网 URL）
+      - value: websocket
+        label: WebSocket（无需公网，推荐内网）
+  - key: verificationToken
+    label: Verification Token
+    kind: secret
+    required: false
+    requiredWhen:
+      key: connectionMode
+      value: webhook
+  - key: groupBotMentionsJson
+    label: Group Bot Mentions (JSON, .env-only)
+    kind: string
+    required: false
+    hidden: true
+  - key: feishu_qr_login
+    label: 飞书扫码授权
+    kind: operation
+    required: false
+    target: [appId, appSecret, connectionMode]
+    actions:
+      - id: qr-generate
+        label: 生成二维码
+        render: button
+        resultRender: img
+        action:
+          method: feishu.qr-generate
+        next: qr-status
+      - id: qr-status
+        label: 等待扫码
+        render: polling
+        action:
+          method: feishu.qr-status
+        timeout: 600
+        rollback: qr-generate
+        next: disconnect
+      - id: disconnect
+        label: 断开连接
+        render: button
+        action:
+          method: feishu.disconnect
+        next: qr-generate
+test:
+  action:
+    method: feishu.test
+permissions:
+  label: 飞书
+steps:
+  - text: "在飞书开放平台创建企业自建应用，获取 App ID 和 App Secret"
+  - text: "选择连接模式：Webhook（需公网 URL）或 WebSocket（无需公网，推荐内网环境）"
+  - text: "在「事件订阅」中配置请求地址并获取 Verification Token"
+    mode: webhook
+  - text: "在「事件订阅」中选择「使用长连接接收事件」，无需 Verification Token"
+    mode: websocket
+contributions:
+  - type: identity
+    id: feishu-bot
+    displayName: Feishu bot
+  - type: message-subscription
+    id: feishu
+    binding: feishu-bot
+    action:
+      method: feishu.outbound
+    presentation: v2
+  - type: media-source
+    id: feishu-media
+    binding: feishu-bot
+  - type: webhook
+    id: feishu-events
+    path: feishu/events
+    methods: [POST]
+    action:
+      method: feishu.webhook
+    verificationSecretRef: verificationToken
+features:
+  - id: feishu-messaging
+    name: Feishu messaging
+    resources: []
+    contributions:
+      - type: identity
+        id: feishu-bot
+      - type: message-subscription
+        id: feishu
+      - type: media-source
+        id: feishu-media
+      - type: webhook
+        id: feishu-events
+    capabilities: [plugin.config.read, plugin.state.get, plugin.state.set, streams.read, message.event.subscribe, messaging.send, secret.read, thread.readContent, thread.listMetadata, thread.write]
+runtime:
+  transport: builtin
+  entrypoint: dist/plugin-entrypoint.js