@zhin.js/adapter-onebot12 5.0.13 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zhin.js/adapter-onebot12
 
+## 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/onebot12.js

@@ -15,6 +15,7 @@ export { OneBot12WsEndpoint } from "../lib/ws-endpoint.js";
 export { OneBot12WssEndpoint } from "../lib/wss-endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
+    operations: ['recall'],
     // 媒体段经 upload_file 物化为 file_id（spec 正式投递）；上传失败降级扩展字段透传。
     // 无卡片交互面，交互段降级纯文本。
     segments: {

package/adapters/onebot12.ts

@@ -29,6 +29,7 @@ declare module '@zhin.js/core' {
 
 export default defineAdapter<OneBot12AdapterConfig>({
   capabilities: ['inbound', 'outbound'],
+  operations: ['recall'],
   // 媒体段经 upload_file 物化为 file_id（spec 正式投递）；上传失败降级扩展字段透传。
   // 无卡片交互面，交互段降级纯文本。
   segments: {

package/lib/webhook.d.ts

@@ -1,4 +1,4 @@
-import type { EndpointInstance, EndpointManagement, 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';
@@ -14,6 +14,7 @@ export interface OneBot12WebhookEndpointOptions {
 export declare class OneBot12WebhookEndpoint implements EndpointInstance {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     readonly content: import("@zhin.js/adapter").EndpointContentPort;
     constructor(options: OneBot12WebhookEndpointOptions);
     start(): Promise<void>;
@@ -21,6 +22,7 @@ export declare class OneBot12WebhookEndpoint implements EndpointInstance {
     close(): void;
     stop(): Promise<void>;
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    recallMessage(messageId: string): Promise<void>;
     /** Public API for management surface / callers；webhook 模式走 api_url。 */
     callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
     admit(ev: OneBot12Event): void;

package/lib/webhook.js

@@ -1,3 +1,4 @@
+import { createRecallEndpointControl, } from 'zhin.js/adapter';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import { createOneBot12EndpointManagement } from './endpoint-management.js';
 import { buildSendMessageParams, callOneBot12Action, formatInboundContent, formatOutboundSegments, isBotMentioned, isMessageEvent, onebot12InboundConversation, senderNickname, senderUserId, uploadOneBot12MediaSegments, } from './protocol.js';
@@ -8,6 +9,7 @@ const logger = getLogger('onebot12');
 export class OneBot12WebhookEndpoint {
     #options;
     management = createOneBot12EndpointManagement(this);
+    control = createRecallEndpointControl((id) => this.recallMessage(id));
     content = createOneBot12ContentPort((action, params) => this.callApi(action, params));
     #callAction;
     #routeReleases = [];
@@ -72,6 +74,11 @@ export class OneBot12WebhookEndpoint {
         }));
         return messageId;
     }
+    async recallMessage(messageId) {
+        if (!messageId)
+            return;
+        await this.callApi('delete_message', { message_id: messageId });
+    }
     /** Public API for management surface / callers；webhook 模式走 api_url。 */
     async callApi(action, params = {}) {
         const apiUrl = this.#options.config.api_url;

package/lib/ws-endpoint.d.ts

@@ -1,4 +1,4 @@
-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 { CapabilityId } from 'zhin.js';
 import { type OneBot12Event, type OneBot12WsConfig } from './protocol.js';
@@ -13,6 +13,7 @@ export interface OneBot12WsEndpointOptions {
 export declare class OneBot12WsEndpoint implements EndpointInstance {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     readonly content: import("@zhin.js/adapter").EndpointContentPort;
     constructor(options: OneBot12WsEndpointOptions);
     start(): Promise<void>;

package/lib/ws-endpoint.js

@@ -3,7 +3,7 @@
  */
 import WebSocket from 'ws';
 import { clearTimeout } from 'node:timers';
-import { createEndpointLifecycle, } from 'zhin.js/adapter';
+import { createRecallEndpointControl, createEndpointLifecycle, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createOneBot12EndpointManagement } from './endpoint-management.js';
 import { buildSendMessageParams, buildWsConnectOptions, formatInboundContent, formatOutboundSegments, isBotMentioned, isMessageEvent, onebot12InboundConversation, senderNickname, senderUserId, uploadOneBot12MediaSegments, } from './protocol.js';
@@ -14,6 +14,7 @@ export class OneBot12WsEndpoint {
     #logger;
     #options;
     management = createOneBot12EndpointManagement(this);
+    control = createRecallEndpointControl((id) => this.recallMessage(id));
     content = createOneBot12ContentPort((action, params) => this.callApi(action, params));
     #lifecycle;
     #ws;

package/lib/wss-endpoint.d.ts

@@ -1,4 +1,4 @@
-import type { EndpointInstance, EndpointManagement, 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';
@@ -13,6 +13,7 @@ export interface OneBot12WssEndpointOptions {
 export declare class OneBot12WssEndpoint implements EndpointInstance {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     readonly content: import("@zhin.js/adapter").EndpointContentPort;
     constructor(options: OneBot12WssEndpointOptions);
     start(): Promise<void>;

package/lib/wss-endpoint.js

@@ -2,6 +2,7 @@
  * OneBot12 reverse WSS endpoint — accepts inbound WebSocket from OneBot implementation.
  */
 import { clearInterval } from 'node:timers';
+import { createRecallEndpointControl, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createOneBot12EndpointManagement } from './endpoint-management.js';
 import { buildSendMessageParams, formatInboundContent, formatOutboundSegments, isBotMentioned, isMessageEvent, onebot12InboundConversation, senderNickname, senderUserId, uploadOneBot12MediaSegments, } from './protocol.js';
@@ -13,6 +14,7 @@ export class OneBot12WssEndpoint {
     #logger;
     #options;
     management = createOneBot12EndpointManagement(this);
+    control = createRecallEndpointControl((id) => this.recallMessage(id));
     content = createOneBot12ContentPort((action, params) => this.callApi(action, params));
     #ws;
     #wsRelease;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-onebot12",
-  "version": "5.0.13",
+  "version": "6.0.0",
   "description": "Zhin.js OneBot 12 adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,9 +40,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"
   },
@@ -51,14 +51,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/webhook.ts

@@ -2,7 +2,13 @@
  * OneBot12 HTTP webhook endpoint — POST inbound + api_url outbound.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
-import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import {
+  createRecallEndpointControl,
+  type EndpointControl,
+  type EndpointInstance,
+  type EndpointManagement,
+  type EndpointSendRequest,
+} from 'zhin.js/adapter';
 import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getLogger } from '@zhin.js/logger';
@@ -40,6 +46,7 @@ export interface OneBot12WebhookEndpointOptions {
 export class OneBot12WebhookEndpoint implements EndpointInstance {
   readonly #options: OneBot12WebhookEndpointOptions;
   readonly management: EndpointManagement = createOneBot12EndpointManagement(this);
+  readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
   readonly content = createOneBot12ContentPort((action, params) => this.callApi(action, params));
   readonly #callAction: typeof callOneBot12Action;
   #routeReleases: HttpRouteRegistration[] = [];
@@ -113,6 +120,11 @@ export class OneBot12WebhookEndpoint implements EndpointInstance {
     return messageId;
   }
 
+  async recallMessage(messageId: string): Promise<void> {
+    if (!messageId) return;
+    await this.callApi('delete_message', { message_id: messageId });
+  }
+
   /** Public API for management surface / callers；webhook 模式走 api_url。 */
   async callApi(action: string, params: Record<string, unknown> = {}): Promise<unknown> {
     const apiUrl = this.#options.config.api_url;

package/src/ws-endpoint.ts

@@ -4,8 +4,10 @@
 import WebSocket from 'ws';
 import { clearTimeout } from 'node:timers';
 import {
+  createRecallEndpointControl,
   createEndpointLifecycle,
   type EndpointConnectHandle,
+  type EndpointControl,
   type EndpointInstance,
   type EndpointLifecycle,
   type EndpointManagement,
@@ -55,6 +57,7 @@ export class OneBot12WsEndpoint implements EndpointInstance {
 
   readonly #options: OneBot12WsEndpointOptions;
   readonly management: EndpointManagement = createOneBot12EndpointManagement(this);
+  readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
   readonly content = createOneBot12ContentPort((action, params) => this.callApi(action, params));
   readonly #lifecycle: EndpointLifecycle;
   #ws?: OneBot12WsSocket;

package/src/wss-endpoint.ts

@@ -2,7 +2,13 @@
  * OneBot12 reverse WSS endpoint — accepts inbound WebSocket from OneBot implementation.
  */
 import { clearInterval } from 'node:timers';
-import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import {
+  createRecallEndpointControl,
+  type EndpointControl,
+  type EndpointInstance,
+  type EndpointManagement,
+  type EndpointSendRequest,
+} from 'zhin.js/adapter';
 import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, WsConnection } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
@@ -41,6 +47,7 @@ export class OneBot12WssEndpoint implements EndpointInstance {
 
   readonly #options: OneBot12WssEndpointOptions;
   readonly management: EndpointManagement = createOneBot12EndpointManagement(this);
+  readonly control: EndpointControl = createRecallEndpointControl((id) => this.recallMessage(id));
   readonly content = createOneBot12ContentPort((action, params) => this.callApi(action, params));
   #ws?: OneBot12WsSocket;
   #wsRelease?: () => void;