@zhin.js/adapter-satori 5.0.13 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zhin.js/adapter-satori
 
+## 6.0.0
+
+### Patch Changes
+
+- f2c532f: Expose exact per-Endpoint message operations through one validated Adapter capability model, route Core control calls through declared active capabilities, and connect existing recall, edit, reaction, and typing implementations across platform adapters.
+- Updated dependencies [b10d058]
+- Updated dependencies [f2c532f]
+  - @zhin.js/host-http@1.0.12
+  - @zhin.js/adapter@1.2.0
+  - @zhin.js/core@1.5.13
+  - zhin.js@6.0.13
+
 ## 5.0.13
 
 ### Patch Changes

package/adapters/satori.js

@@ -11,6 +11,7 @@ import { satoriRuntimeStateToken } from "../lib/satori-runtime-state.js";
 export { SatoriWebhookEndpoint, SatoriWsEndpoint } from "../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
+    operations: ['recall'],
     // Satori 协议 img/file 元素消费 url 与 base64 内联数据；无卡片交互面，交互段降级纯文本。
     segments: {
         outboundMedia: ['url', 'base64'],

package/adapters/satori.ts

@@ -22,6 +22,7 @@ export type {
 
 export default defineAdapter<SatoriAdapterConfig>({
   capabilities: ['inbound', 'outbound'],
+  operations: ['recall'],
   // Satori 协议 img/file 元素消费 url 与 base64 内联数据；无卡片交互面，交互段降级纯文本。
   segments: {
     outboundMedia: ['url', 'base64'],

package/lib/endpoint.d.ts

@@ -1,7 +1,7 @@
 /**
  * SatoriEndpoint — WebSocket and webhook lifecycle, outbound, admit.
  */
-import { type EndpointInstance, type EndpointManagement, type EndpointSendRequest } from 'zhin.js/adapter';
+import { type EndpointControl, type EndpointInstance, type EndpointManagement, type EndpointSendRequest } from 'zhin.js/adapter';
 import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
@@ -19,6 +19,7 @@ export interface SatoriWsEndpointOptions {
 export declare class SatoriWsEndpoint implements EndpointInstance {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     constructor(options: SatoriWsEndpointOptions);
     start(): Promise<void>;
     open(): void;
@@ -27,7 +28,7 @@ export declare class SatoriWsEndpoint implements EndpointInstance {
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a gateway event when the endpoint is open. */
     admit(body: SatoriEventBody): void;
-    recall(id: string): Promise<void>;
+    recall(id: string, fallbackChannelId?: string): Promise<void>;
     /** Test helper: inject a READY login without a live socket. */
     setLogin(login: SatoriLogin): void;
 }
@@ -42,6 +43,7 @@ export interface SatoriWebhookEndpointOptions {
 export declare class SatoriWebhookEndpoint implements EndpointInstance {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     constructor(options: SatoriWebhookEndpointOptions);
     /** Used by webhook handler. */
     get isOpen(): boolean;
@@ -52,7 +54,7 @@ export declare class SatoriWebhookEndpoint implements EndpointInstance {
     stop(): Promise<void>;
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     admit(body: SatoriEventBody): void;
-    recall(id: string): Promise<void>;
+    recall(id: string, fallbackChannelId?: string): Promise<void>;
     /** Test helper: inject login without a live webhook push. */
     setLogin(login: SatoriLogin): void;
 }

package/lib/endpoint.js

@@ -15,6 +15,9 @@ export class SatoriWsEndpoint {
     #lastSn;
     #open = false;
     management = createSatoriEndpointManagement((resource, method, params) => this.#api(resource, method, params));
+    control = Object.freeze({
+        recall: (message) => this.recall(message.id, message.conversation.id),
+    });
     constructor(options) {
         this.#logger = getAdapterLogger('satori', options.config.id);
         this.#options = options;
@@ -114,10 +117,10 @@ export class SatoriWsEndpoint {
             }));
         });
     }
-    async recall(id) {
+    async recall(id, fallbackChannelId) {
         const { channelId, messageId } = parseMessageRef(id);
         await this.#api('message', 'delete', {
-            channel_id: channelId,
+            channel_id: channelId || fallbackChannelId || '',
             message_id: messageId,
         });
     }
@@ -248,6 +251,9 @@ export class SatoriWebhookEndpoint {
     #open = false;
     #started = false;
     management = createSatoriEndpointManagement((resource, method, params) => this.#api(resource, method, params));
+    control = Object.freeze({
+        recall: (message) => this.recall(message.id, message.conversation.id),
+    });
     constructor(options) {
         this.#logger = getAdapterLogger('satori', options.config.id);
         this.#options = options;
@@ -343,10 +349,10 @@ export class SatoriWebhookEndpoint {
             }));
         });
     }
-    async recall(id) {
+    async recall(id, fallbackChannelId) {
         const { channelId, messageId } = parseMessageRef(id);
         await this.#api('message', 'delete', {
-            channel_id: channelId,
+            channel_id: channelId || fallbackChannelId || '',
             message_id: messageId,
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-satori",
-  "version": "5.0.13",
+  "version": "6.0.0",
   "description": "Zhin.js Satori adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -39,9 +39,9 @@
   },
   "dependencies": {
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.11",
-    "@zhin.js/core": "1.5.12",
-    "@zhin.js/host-http": "1.0.11",
+    "@zhin.js/adapter": "1.2.0",
+    "@zhin.js/core": "1.5.13",
+    "@zhin.js/host-http": "1.0.12",
     "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/logger": "1.0.76"
   },
@@ -50,14 +50,14 @@
     "@types/ws": "^8.18.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@zhin.js/host-http": "1.0.11",
-    "zhin.js": "6.0.12"
+    "@zhin.js/host-http": "1.0.12",
+    "zhin.js": "6.0.13"
   },
   "peerDependencies": {
-    "@zhin.js/adapter": "1.1.11",
+    "@zhin.js/adapter": "1.2.0",
     "@zhin.js/command": "1.0.15",
-    "@zhin.js/core": "1.5.12",
-    "zhin.js": "6.0.12"
+    "@zhin.js/core": "1.5.13",
+    "zhin.js": "6.0.13"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/src/endpoint.ts

@@ -5,6 +5,7 @@ import {
   createEndpointLifecycle,
   type EndpointChannel,
   type EndpointConnectHandle,
+  type EndpointControl,
   type EndpointGroup,
   type EndpointInstance,
   type EndpointLifecycle,
@@ -66,6 +67,9 @@ export class SatoriWsEndpoint implements EndpointInstance {
   readonly management: EndpointManagement = createSatoriEndpointManagement(
     (resource, method, params) => this.#api(resource, method, params),
   );
+  readonly control: EndpointControl = Object.freeze<EndpointControl>({
+    recall: (message) => this.recall(message.id, message.conversation.id),
+  });
 
   constructor(options: SatoriWsEndpointOptions) {
     this.#logger = getAdapterLogger('satori', options.config.id);
@@ -168,10 +172,10 @@ export class SatoriWsEndpoint implements EndpointInstance {
     });
   }
 
-  async recall(id: string): Promise<void> {
+  async recall(id: string, fallbackChannelId?: string): Promise<void> {
     const { channelId, messageId } = parseMessageRef(id);
     await this.#api('message', 'delete', {
-      channel_id: channelId,
+      channel_id: channelId || fallbackChannelId || '',
       message_id: messageId,
     });
   }
@@ -325,6 +329,9 @@ export class SatoriWebhookEndpoint implements EndpointInstance {
   readonly management: EndpointManagement = createSatoriEndpointManagement(
     (resource, method, params) => this.#api(resource, method, params),
   );
+  readonly control: EndpointControl = Object.freeze<EndpointControl>({
+    recall: (message) => this.recall(message.id, message.conversation.id),
+  });
 
   constructor(options: SatoriWebhookEndpointOptions) {
     this.#logger = getAdapterLogger('satori', options.config.id);
@@ -425,10 +432,10 @@ export class SatoriWebhookEndpoint implements EndpointInstance {
     });
   }
 
-  async recall(id: string): Promise<void> {
+  async recall(id: string, fallbackChannelId?: string): Promise<void> {
     const { channelId, messageId } = parseMessageRef(id);
     await this.#api('message', 'delete', {
-      channel_id: channelId,
+      channel_id: channelId || fallbackChannelId || '',
       message_id: messageId,
     });
   }