@zhin.js/core 1.5.14 → 1.5.15

package/lib/plugin-runtime/im/im-runtime.d.ts

@@ -12,6 +12,8 @@ export declare const outboundMessageToken: import("@zhin.js/plugin-runtime").Tok
 /** Generation-owned ingress hooks before ordinary dispatch and after it misses. */
 export interface IngressRoute {
     preRoute?(message: Message, lease: SnapshotLease, requester: PluginId, conversationSequence: number | undefined): Promise<boolean>;
+    /** A live pre-route handoff that must run before handlers and commands. */
+    shouldRouteBeforeDispatch?(message: Message): boolean;
     route(message: Message, lease: SnapshotLease, requester: PluginId, conversationSequence: number | undefined): Promise<boolean>;
 }
 export declare const ingressRouteToken: import("@zhin.js/plugin-runtime").Token<IngressRoute>;
@@ -89,6 +91,8 @@ export declare class ImRuntime implements OutboundMessageService {
      */
     onMessage(listener: (event: RuntimeMessageEvent) => void): () => void;
     send(request: SendRequest): Promise<DeliveryReceipt>;
+    /** Sends through the exact generation lease that admitted the current operation. */
+    sendWithSnapshotLease(lease: SnapshotLease, request: SendRequest): Promise<DeliveryReceipt>;
     receiveEndpointEvent(event: EndpointEvent, admission?: GenerationAdmissionGate): Promise<unknown>;
     /** Console `endpoint.list` — empty until Adapter Feature projection is ready. */
     listEndpoints(): readonly {

package/lib/plugin-runtime/im/im-runtime.js

@@ -402,6 +402,13 @@ export class ImRuntime {
                         result = Object.freeze({ matched: true, command: 'pre-route', owner: requester });
                         return;
                     }
+                    if (ingressRoute?.shouldRouteBeforeDispatch?.(message) === true) {
+                        const handled = await ingressRoute.route(message, lease, requester, conversationSequence);
+                        if (handled) {
+                            result = Object.freeze({ matched: true, command: 'ai', owner: requester });
+                            return;
+                        }
+                    }
                     await this.#runHandlers(lease.value, 'message.receive', [
                         withEndpointEventPayload(source, message),
                     ]);
@@ -447,6 +454,13 @@ export class ImRuntime {
             this.#release(lease);
         }
     }
+    /** Sends through the exact generation lease that admitted the current operation. */
+    async sendWithSnapshotLease(lease, request) {
+        if (!this.#snapshots?.owns(lease) || !lease.active) {
+            throw new Error('Outbound message generation lease expired');
+        }
+        return this.#sendWithSnapshot(request, lease.value);
+    }
     async #receiveNotice(source) {
         const notice = source.payload;
         const event = conversationEventFromNotice(notice);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/core",
-  "version": "1.5.14",
+  "version": "1.5.15",
   "description": "Zhin机器人核心框架",
   "type": "module",
   "main": "./lib/index.js",
@@ -78,8 +78,8 @@
     "@zhin.js/adapter": "1.2.1",
     "@zhin.js/command": "1.0.16",
     "@zhin.js/component": "1.0.13",
-    "@zhin.js/database": "1.0.80",
     "@zhin.js/handler": "1.0.4",
+    "@zhin.js/database": "1.0.81",
     "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/interaction": "1.0.1",
     "@zhin.js/kernel": "1.0.8",