@zhin.js/adapter-telegram 1.1.11 → 1.1.14

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 1.1.14
+
+### Patch Changes
+
+- Updated dependencies [974fa85]
+- Updated dependencies [1e9b3d6]
+  - @zhin.js/core@1.1.49
+
+## 1.1.13
+
+### Patch Changes
+
+- Updated dependencies [db06de8]
+  - @zhin.js/core@1.1.48
+
+## 1.1.12
+
+### Patch Changes
+
+- e40899f: Adapters now project group owners and admins onto the canonical `sender.roles` names `owner` / `admin` (Telegram creator/administrator, KOOK guild owner and admin-permission roles, Lark chat owner/managers, QQ official guild owner/admin identities). KOOK numeric role ids moved from `roles` to `permissions` (`role:<id>`). `@zhin.js/command` exports `canManageConversation` ("private chat or owner/admin/master"), now shared by the Bilibili and earthquake subscription commands; Roulette lets owners and admins toggle the mute penalty and cancel a game.
+- fbfefb7: Share segments accept `data.platform` (the song's music service: qq, netease, kugou, kuwo, migu). icqq maps it to the matching music app id when `config.appid` is absent and offers it to the Agent; adapters that cannot render share app metadata reject it like `audio` and `config`.
+- Updated dependencies [1a11207]
+- Updated dependencies [9943df6]
+- Updated dependencies [5be09ae]
+- Updated dependencies [a3ab153]
+- Updated dependencies [e8f7309]
+- Updated dependencies [5afc18f]
+- Updated dependencies [d3563d9]
+- Updated dependencies [c618eb7]
+- Updated dependencies [fbfefb7]
+  - @zhin.js/tool@1.1.8
+  - @zhin.js/core@1.1.47
+  - @zhin.js/adapter@1.1.21
+  - @zhin.js/feature-kit@1.1.7
+  - @zhin.js/im-contract@1.1.5
+  - @zhin.js/agent-feature@1.1.8
+  - @zhin.js/skill@1.1.8
+  - @zhin.js/host-http@1.1.8
+
 ## 1.1.11
 
 ### Patch Changes

package/lib/platform-permit.d.ts

@@ -1,5 +1,8 @@
 /**
  * Telegram platform permit — ChatMember 状态 + 细粒度权限
+ *
+ * `role` 使用跨平台规范名 owner / admin（原生 creator / administrator 仅作兼容输入）；
+ * 细粒度能力放在 `permissions`。
  */
 import type { PermissionSubject } from '@zhin.js/permission';
 export declare function platformPermit(perm: string): string;

package/lib/platform-permit.js

@@ -14,7 +14,7 @@ export function normalizeTelegramChatMember(member) {
     const status = member.status;
     if (status === 'creator') {
         permissions.push('chat_creator', 'chat_administrator', 'restrict_members', 'pin_messages');
-        return { role: 'creator', permissions };
+        return { role: 'owner', permissions };
     }
     if (status === 'administrator') {
         permissions.push('chat_administrator');
@@ -26,7 +26,7 @@ export function normalizeTelegramChatMember(member) {
             permissions.push('delete_messages');
         if (member.can_manage_chat)
             permissions.push('manage_chat');
-        return { role: 'administrator', permissions };
+        return { role: 'admin', permissions };
     }
     return { role: 'member', permissions };
 }
@@ -36,15 +36,15 @@ export function checkTelegramPlatformPermit(perm, subject) {
     const has = (t) => permissions.includes(t);
     switch (perm) {
         case 'chat_creator':
-            return role === 'creator' || has('chat_creator');
+            return role === 'owner' || role === 'creator' || has('chat_creator');
         case 'chat_administrator':
-            return role === 'creator' || role === 'administrator' || has('chat_administrator');
+            return role === 'owner' || role === 'admin' || role === 'creator' || role === 'administrator' || has('chat_administrator');
         case 'restrict_members':
-            return has('restrict_members') || role === 'creator';
+            return has('restrict_members') || role === 'owner' || role === 'creator';
         case 'pin_messages':
-            return has('pin_messages') || role === 'creator';
+            return has('pin_messages') || role === 'owner' || role === 'creator';
         case 'manage_chat':
-            return has('manage_chat') || role === 'creator';
+            return has('manage_chat') || role === 'owner' || role === 'creator';
         default:
             return false;
     }

package/lib/protocol.js

@@ -305,7 +305,7 @@ function buildOutboundActions(target, payload, uploads) {
                 }
                 if (!['http:', 'https:'].includes(url.protocol) || typeof data.title !== 'string' || !data.title.trim())
                     throw new EndpointDeliveryError('invalid_payload', 'Telegram share requires an HTTP(S) URL and title', 'not_sent');
-                if (['image', 'audio', 'artist', 'duration', 'config'].some(key => data[key] !== undefined))
+                if (['image', 'audio', 'artist', 'duration', 'platform', 'config'].some(key => data[key] !== undefined))
                     throw new EndpointDeliveryError('unsupported_operation', 'Telegram share media and app metadata are not implemented', 'not_sent');
                 textContent += `<a href="${escapeTelegramHtml(url.href)}">${escapeTelegramHtml(data.title)}</a>`;
                 for (const value of [data.description, data.content])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-telegram",
-  "version": "1.1.11",
+  "version": "1.1.14",
   "description": "Zhin.js Telegram Bot API adapter for Plugin Runtime (long-poll getUpdates)",
   "type": "module",
   "main": "./lib/index.js",
@@ -31,23 +31,23 @@
     "directory": "plugins/adapters/telegram"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.20",
-    "@zhin.js/agent-feature": "1.1.7",
-    "@zhin.js/core": "1.1.46",
-    "@zhin.js/feature-kit": "1.1.6",
-    "@zhin.js/host-http": "1.1.7",
-    "@zhin.js/im-contract": "1.1.4",
+    "@zhin.js/adapter": "1.1.21",
+    "@zhin.js/agent-feature": "1.1.8",
+    "@zhin.js/core": "1.1.49",
+    "@zhin.js/feature-kit": "1.1.7",
+    "@zhin.js/host-http": "1.1.8",
+    "@zhin.js/im-contract": "1.1.5",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/skill": "1.1.7",
-    "@zhin.js/tool": "1.1.7"
+    "@zhin.js/skill": "1.1.8",
+    "@zhin.js/tool": "1.1.8"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.20",
-    "@zhin.js/command": "^1.1.8",
-    "@zhin.js/core": "^1.1.46",
+    "@zhin.js/adapter": "^1.1.21",
+    "@zhin.js/command": "^1.1.9",
+    "@zhin.js/core": "^1.1.49",
     "@zhin.js/permission": "^1.1.7",
-    "zhin.js": "^1.1.11"
+    "zhin.js": "^1.1.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -65,8 +65,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.7",
-    "zhin.js": "1.1.11"
+    "@zhin.js/host-http": "1.1.8",
+    "zhin.js": "1.1.14"
   },
   "files": [
     "adapters",

package/src/platform-permit.ts

@@ -1,5 +1,8 @@
 /**
  * Telegram platform permit — ChatMember 状态 + 细粒度权限
+ *
+ * `role` 使用跨平台规范名 owner / admin（原生 creator / administrator 仅作兼容输入）；
+ * 细粒度能力放在 `permissions`。
  */
 import type { PermissionSubject } from '@zhin.js/permission';
 
@@ -29,7 +32,7 @@ export function normalizeTelegramChatMember(member: {
   const status = member.status;
   if (status === 'creator') {
     permissions.push('chat_creator', 'chat_administrator', 'restrict_members', 'pin_messages');
-    return { role: 'creator', permissions };
+    return { role: 'owner', permissions };
   }
   if (status === 'administrator') {
     permissions.push('chat_administrator');
@@ -37,7 +40,7 @@ export function normalizeTelegramChatMember(member: {
     if (member.can_pin_messages) permissions.push('pin_messages');
     if (member.can_delete_messages) permissions.push('delete_messages');
     if (member.can_manage_chat) permissions.push('manage_chat');
-    return { role: 'administrator', permissions };
+    return { role: 'admin', permissions };
   }
   return { role: 'member', permissions };
 }
@@ -49,15 +52,15 @@ export function checkTelegramPlatformPermit(perm: string, subject: PermissionSub
 
   switch (perm) {
     case 'chat_creator':
-      return role === 'creator' || has('chat_creator');
+      return role === 'owner' || role === 'creator' || has('chat_creator');
     case 'chat_administrator':
-      return role === 'creator' || role === 'administrator' || has('chat_administrator');
+      return role === 'owner' || role === 'admin' || role === 'creator' || role === 'administrator' || has('chat_administrator');
     case 'restrict_members':
-      return has('restrict_members') || role === 'creator';
+      return has('restrict_members') || role === 'owner' || role === 'creator';
     case 'pin_messages':
-      return has('pin_messages') || role === 'creator';
+      return has('pin_messages') || role === 'owner' || role === 'creator';
     case 'manage_chat':
-      return has('manage_chat') || role === 'creator';
+      return has('manage_chat') || role === 'owner' || role === 'creator';
     default:
       return false;
   }

package/src/protocol.ts

@@ -582,7 +582,7 @@ function buildOutboundActions(
         let url: URL;
         try { url = new URL(String(data.url ?? '')); } catch { throw new EndpointDeliveryError('invalid_payload', 'Telegram share requires an HTTP(S) URL', 'not_sent'); }
         if (!['http:', 'https:'].includes(url.protocol) || typeof data.title !== 'string' || !data.title.trim()) throw new EndpointDeliveryError('invalid_payload', 'Telegram share requires an HTTP(S) URL and title', 'not_sent');
-        if (['image', 'audio', 'artist', 'duration', 'config'].some(key => data[key] !== undefined)) throw new EndpointDeliveryError('unsupported_operation', 'Telegram share media and app metadata are not implemented', 'not_sent');
+        if (['image', 'audio', 'artist', 'duration', 'platform', 'config'].some(key => data[key] !== undefined)) throw new EndpointDeliveryError('unsupported_operation', 'Telegram share media and app metadata are not implemented', 'not_sent');
         textContent += `<a href="${escapeTelegramHtml(url.href)}">${escapeTelegramHtml(data.title)}</a>`;
         for (const value of [data.description, data.content]) if (typeof value === 'string' && value) textContent += `\n${escapeTelegramHtml(value)}`;
         break;