@zlink-systems/framework 0.29.1 → 0.30.1

package/dist/runtime/backend/node/node-raw-mesh-backend.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkNodeRawMeshBackend = void 0;
 exports.requestFailureResult = requestFailureResult;
+const durable_service_request_1 = require("../../foundation/durable-service-request");
 const stream_wire_1 = require("@zlink-systems/stream-wire");
 const zlink_1 = require("@zlink-systems/zlink");
 const node_crypto_1 = require("node:crypto");
@@ -12,7 +13,6 @@ const EndpointNotation_1 = require("../../../contracts/Configuration/EndpointNot
 const InternalDefaults_1 = require("../../../contracts/Configuration/InternalDefaults");
 const Registration_1 = require("../../../contracts/Configuration/Registration");
 const RegistrationBuilderPolicy_1 = require("../../../contracts/Configuration/RegistrationBuilderPolicy");
-const admission_1 = require("../../admission");
 const operation_identity_1 = require("../../foundation/operation-identity");
 const operation_registry_1 = require("../../foundation/operation-registry");
 const raw_service_mesh_runtime_1 = require("../../foundation/raw-service-mesh-runtime");
@@ -58,12 +58,11 @@ class ZLinkNodeRawMeshBackend {
     applicationJobQueue;
     applicationJobReceiveFlowFailureSink;
     peerAdmissionSealed;
+    infrastructureTaskRunner;
     nativeInstance = this;
     channels = new Map();
     peerIntents = new Map();
-    completions = [];
-    completionHead = 0;
-    completionCount = 0;
+    completionHandler;
     routingId;
     lifecycleGeneration;
     bindEndpoint;
@@ -107,12 +106,13 @@ class ZLinkNodeRawMeshBackend {
     messageFollowHandler;
     dispatchErrors;
     peerDisconnectedHandlers = new Set();
-    constructor(meshName, routingId, bindingPort, applicationJobQueue, applicationJobReceiveFlowFailureSink, peerAdmissionSealed) {
+    constructor(meshName, routingId, bindingPort, applicationJobQueue, applicationJobReceiveFlowFailureSink, peerAdmissionSealed, infrastructureTaskRunner) {
         this.meshName = meshName;
         this.bindingPort = bindingPort;
         this.applicationJobQueue = applicationJobQueue;
         this.applicationJobReceiveFlowFailureSink = applicationJobReceiveFlowFailureSink;
         this.peerAdmissionSealed = peerAdmissionSealed;
+        this.infrastructureTaskRunner = infrastructureTaskRunner;
         if (meshName.length === 0)
             throw new TypeError('MeshName must be non-empty.');
         if (routingId === undefined || routingId.length === 0) {
@@ -169,8 +169,8 @@ class ZLinkNodeRawMeshBackend {
         const result = await this.requireStateful().sendToMissingInstanceSpotFrame(target, encodeMultipartApplicationFrame(parts), deadlineUnixMs, sourceSpotId, metadata === undefined ? undefined : (0, service_metadata_codec_1.encodeServiceMetadataFrame)(metadata));
         return result;
     }
-    requestToMissingInstanceSpot(target, parts, deadlineUnixMs, sourceSpotId, metadata) {
-        return this.observeStateful(service_runtime_contracts_1.OperationKind.InstanceSpotRequest, this.requireStateful().requestToMissingInstanceSpotFrame(target, encodeMultipartApplicationFrame(parts), deadlineUnixMs, sourceSpotId, metadata === undefined ? undefined : (0, service_metadata_codec_1.encodeServiceMetadataFrame)(metadata)));
+    requestToMissingInstanceSpot(target, parts, deadlineUnixMs, sourceSpotId, metadata, onAdmitted) {
+        return this.observeStateful(service_runtime_contracts_1.OperationKind.InstanceSpotRequest, this.requireStateful().requestToMissingInstanceSpotFrame(target, encodeMultipartApplicationFrame(parts), deadlineUnixMs, sourceSpotId, metadata === undefined ? undefined : (0, service_metadata_codec_1.encodeServiceMetadataFrame)(metadata), onAdmitted));
     }
     setRoutingId(routingId) {
         if (String(routingId) !== this.routingId) {
@@ -203,6 +203,8 @@ class ZLinkNodeRawMeshBackend {
             resolveAdvertisedEndpoint: (boundEndpoint) => this.resolveAdvertisedEndpoint(boundEndpoint),
             bindingPort: this.bindingPort,
             applicationJobQueue: this.requireApplicationJobQueue(),
+            onReceiveReady: () => this.onReadable(true, false),
+            infrastructureTaskRunner: this.infrastructureTaskRunner,
             peerAdmissionSealed: this.peerAdmissionSealed,
             onReceiveFlowConfigFailure: this.applicationJobReceiveFlowFailureSink,
             onMailboxReady: (domain) => this.readyHandler?.(domain === 'application' ? service_runtime_contracts_1.ReadyDomain.Application : service_runtime_contracts_1.ReadyDomain.Infrastructure),
@@ -220,13 +222,7 @@ class ZLinkNodeRawMeshBackend {
                     }
                 }
             },
-            onPeerDisconnected: (nodeRoutingId, endpoint) => {
-                for (const [intentId, peer] of this.peerIntents) {
-                    if (peer.endpoint === endpoint &&
-                        (peer.nodeRoutingId === undefined || peer.nodeRoutingId === nodeRoutingId)) {
-                        this.peerIntents.delete(intentId);
-                    }
-                }
+            onPeerDisconnected: (_nodeRoutingId, endpoint) => {
                 for (const handler of this.peerDisconnectedHandlers)
                     handler(endpoint);
             }
@@ -275,7 +271,6 @@ class ZLinkNodeRawMeshBackend {
         this.stateful = undefined;
         this.runtime?.close();
         this.runtime = undefined;
-        this.clearCompletions();
         this.closed = true;
     }
     addChannelName(name) {
@@ -379,13 +374,28 @@ class ZLinkNodeRawMeshBackend {
     isObjectClientNodeDirectTarget(targetRid) {
         return this.requireRuntime().isObjectClientNodeDirectTarget(String(targetRid));
     }
+    observePeerRoute(targetRid) {
+        return this.requireRuntime().observePeerRoute(String(targetRid));
+    }
+    hasPeerRouteOrConnectionIntent(targetRid, endpoint) {
+        const rid = String(targetRid);
+        if (this.requireRuntime().hasSelectedPeerRoute(rid))
+            return true;
+        for (const intent of this.peerIntents.values()) {
+            if (intent.nodeRoutingId === rid ||
+                (intent.nodeRoutingId === undefined && intent.endpoint === endpoint))
+                return true;
+        }
+        return false;
+    }
     isPeerRouteReady(targetRid, lifecycleGeneration) {
         return this.requireRuntime().isPeerRouteReady(String(targetRid), lifecycleGeneration);
     }
-    async sendToNode(targetRid, parts) {
-        return (await this.requireRuntime().sendToNode(String(targetRid), encodeMultipartApplicationFrame(parts)))
-            ? zlink_1.SubmitResult.Ok
-            : zlink_1.SubmitResult.NotConnected;
+    sendToNode(targetRid, parts) {
+        const submitted = this.requireRuntime().sendToNode(String(targetRid), encodeMultipartApplicationFrame(parts));
+        return submitted instanceof Promise
+            ? submitted.then(nodeSendResult)
+            : nodeSendResult(submitted);
     }
     async sendInfrastructureControl(targetRid, record) {
         return (await this.requireRuntime().sendService(String(targetRid), (Array.isArray(record) ? record : [record]).map((value) => Buffer.from(value))))
@@ -398,17 +408,17 @@ class ZLinkNodeRawMeshBackend {
             : zlink_1.SubmitResult.NotConnected;
     }
     async requestInfrastructureControlFrames(targetRid, frames, options) {
-        return await this.requireRuntime().requestService(String(targetRid), frames.map((frame) => Buffer.from(frame)), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS);
+        return (0, durable_service_request_1.requestDurableService)(this.requireRuntime(), String(targetRid), frames, performance.now() + (options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS), 'relocation control', options?.signal, options?.onSubmitted);
     }
     requestToNode(targetRid, parts, options) {
-        const pending = this.requireRuntime().requestToNode(String(targetRid), encodeMultipartApplicationFrame(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS);
+        const pending = this.requireRuntime().requestToNode(String(targetRid), encodeMultipartApplicationFrame(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, options?.onAdmitted);
         return this.observeCompletion(pending.id, service_runtime_contracts_1.OperationKind.NodeRequest, pending.promise);
     }
     async sendToChannel(channelName, parts) {
         return this.requireRuntime().sendToChannel(channelName, encodeMultipartApplicationFrame(parts));
     }
     requestToChannel(channelName, parts, options) {
-        const pending = this.requireRuntime().requestToChannel(channelName, encodeMultipartApplicationFrame(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS);
+        const pending = this.requireRuntime().requestToChannel(channelName, encodeMultipartApplicationFrame(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, options?.onAdmitted);
         return this.observeCompletion(pending.id, service_runtime_contracts_1.OperationKind.ChannelRequest, pending.promise);
     }
     status() {
@@ -426,7 +436,7 @@ class ZLinkNodeRawMeshBackend {
             admittedPeerCount: peers.length,
             drainingPeerCount: peers.filter((peer) => peer.descriptor.state === 'draining').length,
             pendingApplicationMessages: BigInt(this.runtime?.mailbox.pendingMessages('application') ?? 0),
-            pendingInfrastructureMessages: BigInt((this.runtime?.mailbox.pendingMessages('infrastructure') ?? 0) + this.completionCount),
+            pendingInfrastructureMessages: BigInt(this.runtime?.mailbox.pendingMessages('infrastructure') ?? 0),
             pendingBytes: BigInt((this.runtime?.mailbox.pendingBytes('application') ?? 0) +
                 (this.runtime?.mailbox.pendingBytes('infrastructure') ?? 0)),
             lastError: 0,
@@ -519,6 +529,9 @@ class ZLinkNodeRawMeshBackend {
             }
         };
     }
+    setCompletionHandler(handler) {
+        this.completionHandler = handler;
+    }
     setReadyHandler(handler) {
         this.readyHandler = handler;
         this.notifyReady();
@@ -532,7 +545,6 @@ class ZLinkNodeRawMeshBackend {
     drainReady(domains, batch) {
         const target = requireRawReadyBatch(batch);
         if ((domains & service_runtime_contracts_1.ReadyDomain.Infrastructure) !== 0) {
-            this.drainCompletions(target);
             this.drainMailbox('infrastructure', target);
         }
         if ((domains & service_runtime_contracts_1.ReadyDomain.Application) !== 0) {
@@ -540,7 +552,7 @@ class ZLinkNodeRawMeshBackend {
         }
         const runtime = this.runtime;
         const infrastructureResidue = (domains & service_runtime_contracts_1.ReadyDomain.Infrastructure) !== 0 &&
-            (this.completionCount > 0 || (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0);
+            (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0;
         const applicationResidue = (domains & service_runtime_contracts_1.ReadyDomain.Application) !== 0 &&
             (runtime?.mailbox.pendingMessages('application') ?? 0) > 0;
         return {
@@ -664,8 +676,8 @@ class ZLinkNodeRawMeshBackend {
         const result = await this.requireStateful().sendToInstanceSpot(route, encodeMultipart(parts), sourceSpotId, metadata === undefined ? undefined : (0, service_metadata_codec_1.encodeServiceMetadataFrame)(metadata), instanceIntent);
         return result;
     }
-    requestInstanceSpot(route, parts, timeoutMs = Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, sourceSpotId, metadata, instanceIntent = false) {
-        return this.observeStateful(service_runtime_contracts_1.OperationKind.InstanceSpotRequest, this.requireStateful().requestToInstanceSpot(route, encodeMultipart(parts), timeoutMs, sourceSpotId, metadata === undefined ? undefined : (0, service_metadata_codec_1.encodeServiceMetadataFrame)(metadata), instanceIntent));
+    requestInstanceSpot(route, parts, timeoutMs = Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, sourceSpotId, metadata, instanceIntent = false, onAdmitted) {
+        return this.observeStateful(service_runtime_contracts_1.OperationKind.InstanceSpotRequest, this.requireStateful().requestToInstanceSpot(route, encodeMultipart(parts), timeoutMs, sourceSpotId, metadata === undefined ? undefined : (0, service_metadata_codec_1.encodeServiceMetadataFrame)(metadata), instanceIntent, onAdmitted));
     }
     actorLookup(actorId) {
         const actor = this.requireStateful().actor(actorId);
@@ -705,13 +717,13 @@ class ZLinkNodeRawMeshBackend {
         return this.requireStateful().sendToActor(actor, this.peerGeneration(String(actor.nodeRid)), actor.generation, encodeMultipart(parts));
     }
     requestToActor(actor, parts, options) {
-        return this.observeStateful(service_runtime_contracts_1.OperationKind.ActorRequest, this.requireStateful().requestToActor(actor, this.peerGeneration(String(actor.nodeRid)), actor.generation, encodeMultipart(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS));
+        return this.observeStateful(service_runtime_contracts_1.OperationKind.ActorRequest, this.requireStateful().requestToActor(actor, this.peerGeneration(String(actor.nodeRid)), actor.generation, encodeMultipart(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, undefined, undefined, options?.onAdmitted));
     }
     async actorSendToActor(source, target, parts) {
         return (await this.requireStateful().sendToActor(target, this.peerGeneration(String(target.nodeRid)), target.generation, encodeMultipart(parts), source));
     }
     actorRequestToActor(source, target, parts, options) {
-        return this.observeStateful(service_runtime_contracts_1.OperationKind.ActorRequest, this.requireStateful().requestToActor(target, this.peerGeneration(String(target.nodeRid)), target.generation, encodeMultipart(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, source));
+        return this.observeStateful(service_runtime_contracts_1.OperationKind.ActorRequest, this.requireStateful().requestToActor(target, this.peerGeneration(String(target.nodeRid)), target.generation, encodeMultipart(parts), options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, source, undefined, options?.onAdmitted));
     }
     async sendActorBoundSession(actor, expectedBindingGeneration, parts, _flags) {
         return (await this.requireStateful().sendBoundSession(actor, expectedBindingGeneration, encodeMultipart(parts)));
@@ -719,7 +731,7 @@ class ZLinkNodeRawMeshBackend {
     closeActorBoundSession(actor, expectedBindingGeneration, timeoutMs = Registration_1.DEFAULT_REQUEST_TIMEOUT_MS) {
         const binding = this.requireStateful().registry.binding(actor);
         if (binding === undefined) {
-            return this.enqueueImmediateFailure(service_runtime_contracts_1.OperationKind.StreamUnbind, zlink_1.RequestResult.NotFound);
+            return this.observeImmediateFailure(service_runtime_contracts_1.OperationKind.StreamUnbind, zlink_1.RequestResult.NotFound);
         }
         return this.observeStateful(service_runtime_contracts_1.OperationKind.StreamUnbind, this.requireStateful().unbindSession(binding.sessionRid, actor, expectedBindingGeneration, timeoutMs));
     }
@@ -732,8 +744,8 @@ class ZLinkNodeRawMeshBackend {
     async sendFromSpot(source, target, parts) {
         return (await this.requireStateful().sendToSpot(source.ref.spotId, target, encodeMultipart(parts)));
     }
-    requestFromSpot(source, target, parts, timeoutMs) {
-        return this.observeStateful(service_runtime_contracts_1.OperationKind.SpotRequest, this.requireStateful().requestToSpot(source.ref.spotId, target, encodeMultipart(parts), timeoutMs));
+    requestFromSpot(source, target, parts, timeoutMs, onAdmitted) {
+        return this.observeStateful(service_runtime_contracts_1.OperationKind.SpotRequest, this.requireStateful().requestToSpot(source.ref.spotId, target, encodeMultipart(parts), timeoutMs, onAdmitted));
     }
     closeSpot(state) {
         return this.requireStateful().registry.closeSpot(state.ref);
@@ -742,6 +754,8 @@ class ZLinkNodeRawMeshBackend {
         await this.requireStateful().publishLogicalMulticast(channelName, topic, encodeMultipart(parts), state.ref.spotId);
     }
     setSpotSubscription(state, channelName, topicFilter) {
+        if (!this.channels.has(channelName))
+            throw new contracts_1.ZLinkFrameworkException(contracts_1.ZLinkFrameworkErrorKind.InvalidOperation, `Spot does not participate in subscription channel '${channelName}'.`);
         this.requireStateful().setSubscription(state, channelName, topicFilter);
     }
     unsetSpotSubscription(state, channelName, topicFilter) {
@@ -824,7 +838,7 @@ class ZLinkNodeRawMeshBackend {
     notifyReady() {
         const runtime = this.runtime;
         let domains = service_runtime_contracts_1.ReadyDomain.None;
-        if (this.completionCount > 0 || (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0) {
+        if ((runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0) {
             domains |= service_runtime_contracts_1.ReadyDomain.Infrastructure;
         }
         if ((runtime?.mailbox.pendingMessages('application') ?? 0) > 0) {
@@ -835,61 +849,31 @@ class ZLinkNodeRawMeshBackend {
     }
     observeCompletion(low, operationKind, promise) {
         const id = { high: 1n, low };
-        void promise.then((result) => this.enqueueCompletion(id, operationKind, result), (error) => this.enqueueCompletion(id, operationKind, requestFailureResult(error)));
+        void promise.then((result) => this.deliverCompletion(id, operationKind, result), (error) => this.deliverCompletion(id, operationKind, requestFailureResult(error)));
         return id;
     }
     observeStateful(operationKind, pending) {
         const id = { high: operation_identity_1.ZLINK_NATIVE_CORRELATION_OPERATION_NAMESPACE, low: pending.id };
-        void pending.promise.then((result) => this.enqueueCompletion(id, operationKind, result), (error) => this.enqueueCompletion(id, operationKind, requestFailureResult(error)));
+        void pending.promise.then((result) => this.deliverCompletion(id, operationKind, result), (error) => this.deliverCompletion(id, operationKind, requestFailureResult(error)));
         return id;
     }
-    enqueueImmediateFailure(operationKind, terminalResult) {
+    observeImmediateFailure(operationKind, terminalResult) {
         const low = this.nextPeerIntent++;
-        const id = { high: 1n, low };
-        this.enqueueCompletion(id, operationKind, { terminalResult, failureCode: 0 });
-        return id;
+        return this.observeCompletion(low, operationKind, Promise.resolve({ terminalResult, failureCode: 0 }));
     }
-    enqueueCompletion(operationId, operationKind, result) {
-        if (this.closed)
+    deliverCompletion(operationId, operationKind, result) {
+        if (this.completionHandler !== undefined) {
+            this.completionHandler({ operationId, terminalResult: result.terminalResult }, () => completionRecord(operationId, operationKind, result));
             return;
-        this.completions.push({ operationId, operationKind, result });
-        this.completionCount += 1;
-        this.readyHandler?.(service_runtime_contracts_1.ReadyDomain.Infrastructure);
-    }
-    drainCompletions(batch) {
-        while (!batch.full && this.completionCount > 0) {
-            const completion = this.takeCompletion();
-            if (completion === undefined)
-                continue;
-            batch.push({
-                ownerKind: service_runtime_contracts_1.ReadyOwnerKind.Node,
-                domain: service_runtime_contracts_1.ReadyDomain.Infrastructure,
-                spotId: null,
-                actor: null,
-                terminalCompletion: true
-            }, new CompletionClaim(completion));
-        }
-    }
-    takeCompletion() {
-        const completion = this.completions[this.completionHead];
-        if (completion === undefined)
-            return undefined;
-        this.completions[this.completionHead] = undefined;
-        this.completionHead += 1;
-        this.completionCount -= 1;
-        if (this.completionCount === 0) {
-            this.clearCompletions();
-        }
-        else if ((0, admission_1.shouldCompactBackingArray)(this.completionHead, this.completions.length)) {
-            this.completions.splice(0, this.completionHead);
-            this.completionHead = 0;
         }
-        return completion;
-    }
-    clearCompletions() {
-        this.completions.length = 0;
-        this.completionHead = 0;
-        this.completionCount = 0;
+        // The raw pull contract uses the existing infrastructure mailbox. A
+        // registered Framework owner receives the terminal directly above.
+        this.runtime?.mailbox.tryEnqueue({
+            owner: this.routingId,
+            domain: 'infrastructure',
+            parts: [],
+            completion: completionRecord(operationId, operationKind, result)
+        });
     }
     drainMailbox(domain, batch) {
         const runtime = this.runtime;
@@ -899,7 +883,15 @@ class ZLinkNodeRawMeshBackend {
             const claim = runtime.mailbox.tryClaim(domain, MAX_DRAIN_RECORDS, Number.MAX_SAFE_INTEGER);
             if (claim === undefined)
                 break;
-            const owner = readyOwner(claim.owner, this.routingId, this.stateful, domain);
+            const owner = claim.records[0]?.completion === undefined
+                ? readyOwner(claim.owner, this.routingId, this.stateful, domain)
+                : {
+                    ownerKind: service_runtime_contracts_1.ReadyOwnerKind.Node,
+                    domain: service_runtime_contracts_1.ReadyDomain.Infrastructure,
+                    spotId: null,
+                    actor: null,
+                    terminalCompletion: true
+                };
             batch.push(owner, new MailboxClaim(runtime, claim));
         }
     }
@@ -973,7 +965,7 @@ class RawServiceSpot {
         const routeFence = requireDirectSpotRouteFence(options?.routeFence, String(targetNodeRid), String(targetSpotId), targetSpotGeneration, options?.entrySpot === true
             ? this.backend.entrySpotRouteFence(String(targetNodeRid), String(targetSpotId))
             : undefined);
-        return this.backend.requestFromSpot(this.state, routeFence, parts, options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS);
+        return this.backend.requestFromSpot(this.state, routeFence, parts, options?.timeoutMs ?? Registration_1.DEFAULT_REQUEST_TIMEOUT_MS, options?.onAdmitted);
     }
     async publish(channelName, topic, parts, options) {
         this.requireOpen();
@@ -1012,6 +1004,9 @@ class RawServiceSpot {
             throw new Error(`Spot '${this.routingId}' is closed.`);
     }
 }
+function nodeSendResult(submitted) {
+    return submitted ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.NotConnected;
+}
 function requireDirectSpotRouteFence(route, targetNodeRid, targetSpotId, targetSpotGeneration, entryRoute) {
     if (route === undefined && entryRoute !== undefined) {
         return entryRoute;
@@ -1093,7 +1088,7 @@ class RawStreamSessionService {
         if (target === undefined)
             return false;
         const operation = this.stream.send(target);
-        const parts = decodeMultipartBuffers((0, service_wire_m6a_codec_1.decodeApplicationPayloadView)(payload).payload);
+        const parts = decodeMultipartParts((0, service_wire_m6a_codec_1.decodeApplicationPayloadView)(payload).payload, borrowMultipartPart);
         if (parts.length === 0)
             return false;
         const actorSlot = await (0, service_session_binding_ingress_port_1.serviceSessionBindingIngressPortIfRegistered)(this)?.actorSlot(actorId, sessionRid);
@@ -1259,49 +1254,35 @@ class MailboxClaim {
         this.runtime.mailbox.release(this.claim, this.remaining);
     }
 }
-class CompletionClaim {
-    completion;
-    consumed = false;
-    constructor(completion) {
-        this.completion = completion;
-    }
-    recvBatch() {
-        if (this.consumed)
-            return { ok: false, records: [] };
-        this.consumed = true;
-        const payload = this.completion.result.payload;
-        return {
-            ok: true,
-            records: [
-                {
-                    kind: service_runtime_contracts_1.ReceiveKind.Completion,
-                    domain: service_runtime_contracts_1.ReadyDomain.Infrastructure,
-                    sourceNodeRid: null,
-                    sourceSpotId: null,
-                    sourceBindingGeneration: 0n,
-                    sourceActor: null,
-                    operationId: this.completion.operationId,
-                    operationKind: this.completion.operationKind,
-                    channelName: null,
-                    topic: null,
-                    applicationMetadata: null,
-                    kindData: 'kindData' in this.completion.result ? (this.completion.result.kindData ?? null) : null,
-                    terminalResult: this.completion.result.terminalResult,
-                    failureErrno: this.completion.result.failureCode,
-                    parts: payload === undefined
-                        ? []
-                        : payload.contentType === MULTIPART_CONTENT_TYPE
-                            ? decodeMultipart(payload.payload)
-                            : [zlink_1.Message.from(payload.payload)],
-                    reply: () => zlink_1.SubmitResult.InvalidState,
-                    replyActorJoin: () => zlink_1.SubmitResult.NotSupported
-                }
-            ]
-        };
-    }
-    release() { }
+function completionRecord(operationId, operationKind, result) {
+    const payload = result.payload;
+    return {
+        kind: service_runtime_contracts_1.ReceiveKind.Completion,
+        domain: service_runtime_contracts_1.ReadyDomain.Infrastructure,
+        sourceNodeRid: null,
+        sourceSpotId: null,
+        sourceBindingGeneration: 0n,
+        sourceActor: null,
+        operationId,
+        operationKind,
+        channelName: null,
+        topic: null,
+        applicationMetadata: null,
+        kindData: 'kindData' in result ? (result.kindData ?? null) : null,
+        terminalResult: result.terminalResult,
+        failureErrno: result.failureCode,
+        parts: payload === undefined
+            ? []
+            : payload.contentType === MULTIPART_CONTENT_TYPE
+                ? decodeMultipart(payload.payload)
+                : [runtime_message_1.ZLinkBufferMessage.from(payload.payload)],
+        reply: () => zlink_1.SubmitResult.InvalidState,
+        replyActorJoin: () => zlink_1.SubmitResult.NotSupported
+    };
 }
 function decodeMultipartRecord(runtime, record) {
+    if (record.completion !== undefined)
+        return record.completion;
     const stateful = (0, service_stateful_runtime_1.statefulMailboxData)(record);
     if (stateful !== undefined) {
         return decodeStatefulRecord(record, stateful);
@@ -1671,22 +1652,15 @@ function decodeApplicationEnvelope(frame) {
     return { packetName, contentType, payload: bytes.subarray(offset) };
 }
 function decodeMultipart(payload) {
-    const buffers = decodeMultipartBuffers(payload);
-    const parts = new Array(buffers.length);
-    let materialized = 0;
-    try {
-        for (; materialized < buffers.length; materialized += 1) {
-            parts[materialized] = runtime_message_1.ZLinkBufferMessage.fromOwned(buffers[materialized]);
-        }
-        return parts;
-    }
-    catch (error) {
-        for (let index = 0; index < materialized; index += 1)
-            parts[index].close();
-        throw error;
-    }
+    return decodeMultipartParts(payload, runtime_message_1.ZLinkBufferMessage.fromOwned, closeMultipartMessage);
 }
-function decodeMultipartBuffers(payload) {
+function closeMultipartMessage(part) {
+    part.close();
+}
+function borrowMultipartPart(part) {
+    return part;
+}
+function decodeMultipartParts(payload, materialize, release) {
     const bytes = Buffer.from(payload.buffer, payload.byteOffset, payload.byteLength);
     if (bytes.length < 4)
         throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Truncated multipart payload.');
@@ -1696,22 +1670,32 @@ function decodeMultipartBuffers(payload) {
     }
     const result = new Array(count);
     let offset = 4;
-    for (let index = 0; index < count; index++) {
-        if (bytes.length - offset < 4) {
-            throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Truncated multipart part length.');
+    let index = 0;
+    try {
+        for (; index < count; index++) {
+            if (bytes.length - offset < 4) {
+                throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Truncated multipart part length.');
+            }
+            const length = bytes.readUInt32BE(offset);
+            offset += 4;
+            if (bytes.length - offset < length) {
+                throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Truncated multipart part.');
+            }
+            result[index] = materialize(bytes.subarray(offset, offset + length));
+            offset += length;
         }
-        const length = bytes.readUInt32BE(offset);
-        offset += 4;
-        if (bytes.length - offset < length) {
-            throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Truncated multipart part.');
+        if (offset !== bytes.length) {
+            throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Multipart payload has trailing bytes.');
         }
-        result[index] = bytes.subarray(offset, offset + length);
-        offset += length;
+        return result;
     }
-    if (offset !== bytes.length) {
-        throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Multipart payload has trailing bytes.');
+    catch (error) {
+        if (release !== undefined) {
+            for (let retained = 0; retained < index; retained++)
+                release(result[retained]);
+        }
+        throw error;
     }
-    return result;
 }
 function messageBytesView(value) {
     if (typeof value === 'object' && 'data' in value) {

package/dist/runtime/backend/node/node-socket-backend-adapter.js

@@ -10,6 +10,8 @@ const node_event_loop_poller_1 = require("./node-event-loop-poller");
 const eventLoopPollers = new WeakMap();
 function wrapSocket(nativeInstance, pollCompletion) {
     const socket = nativeInstance;
+    if (socket.options !== undefined)
+        socket.options.linger = 0;
     const hasRequest = typeof nativeInstance.request === 'function';
     const hasRoutedPeer = hasRequest && typeof nativeInstance.reply === 'function';
     const hasStream = typeof nativeInstance.recvPacket === 'function';
@@ -18,9 +20,9 @@ function wrapSocket(nativeInstance, pollCompletion) {
         : new node_event_loop_poller_1.ZLinkNodeEventLoopPoller(nativeInstance, pollCompletion, () => { });
     const adapter = {
         nativeInstance,
+        receiveAdmission: undefined,
         async dispose() {
             eventLoopPoller?.dispose();
-            (0, node_backend_adapter_support_1.disableSocketLinger)(nativeInstance);
             (0, node_backend_adapter_support_1.closeBindingHandle)(nativeInstance);
         },
         close() {
@@ -44,9 +46,6 @@ function wrapSocket(nativeInstance, pollCompletion) {
                 .setChannelName;
             setChannelName?.call(nativeInstance, channelName);
         },
-        setReceiveFlowState(state) {
-            nativeInstance.setReceiveFlowState(state);
-        },
         setProbe(enabled) {
             requireSocketOptions(socket).probe = enabled;
         },
@@ -68,6 +67,12 @@ function wrapSocket(nativeInstance, pollCompletion) {
         setRoutingId(routingId) {
             nativeInstance.setRoutingId((0, node_backend_adapter_support_1.toNativeRoutingId)(routingId));
         },
+        get lingerMs() {
+            return requireSocketOptions(socket).linger;
+        },
+        set lingerMs(value) {
+            requireSocketOptions(socket).linger = value;
+        },
         get peerWeight() {
             return socket.options?.peerWeight ?? RegistrationBuilderPolicy_1.ZLINK_DEFAULT_PUBLIC_WEIGHT;
         },
@@ -139,12 +144,12 @@ function wrapSocket(nativeInstance, pollCompletion) {
         },
         request(...args) {
             if (hasRoutedPeer) {
-                const [routingId, payload, timeoutMs] = args;
-                return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.request((0, node_backend_adapter_support_1.toNativeRoutingId)(routingId)), payload, timeoutMs);
+                const [routingId, payload, timeoutMs, onAdmitted] = args;
+                return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.request((0, node_backend_adapter_support_1.toNativeRoutingId)(routingId)), payload, timeoutMs, undefined, onAdmitted);
             }
             if (hasRequest) {
-                const [payload, timeoutMs] = args;
-                return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.request(), payload, timeoutMs);
+                const [payload, timeoutMs, onAdmitted] = args;
+                return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.request(), payload, timeoutMs, adapter.receiveAdmission?.recordReceived, onAdmitted);
             }
             throw new TypeError('Backend request requires a DEALER or ROUTER socket.');
         },
@@ -196,8 +201,8 @@ function wrapSocket(nativeInstance, pollCompletion) {
             const operation = nativeInstance.sendToSpot((0, node_backend_adapter_support_1.toNativeRoutingId)(targetRid), (0, node_backend_adapter_support_1.toNativeRoutingId)(targetSpot));
             await (0, node_backend_adapter_support_1.submitBindingAsyncSend)(operation, payload);
         },
-        requestToSpot(targetRid, targetSpot, payload, timeoutMs) {
-            return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.requestToSpot((0, node_backend_adapter_support_1.toNativeRoutingId)(targetRid), (0, node_backend_adapter_support_1.toNativeRoutingId)(targetSpot)), payload, timeoutMs);
+        requestToSpot(targetRid, targetSpot, payload, timeoutMs, onAdmitted) {
+            return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.requestToSpot((0, node_backend_adapter_support_1.toNativeRoutingId)(targetRid), (0, node_backend_adapter_support_1.toNativeRoutingId)(targetSpot)), payload, timeoutMs, undefined, onAdmitted);
         },
         disconnectPeer(routingId) {
             disconnectStreamPeer(nativeInstance, routingId);

package/dist/runtime/backend/raw-binding-port.d.ts

@@ -1,3 +1,8 @@
+import type { SubmitResult } from './runtime-values';
+export interface ZLinkRawSendSubmission {
+    readonly result: typeof SubmitResult.Ok | typeof SubmitResult.Backpressured;
+    readonly admitted: Promise<void>;
+}
 export interface ZLinkRawReceivedRecord {
     readonly sourceRid: string;
     readonly sourceRoute: Uint8Array;
@@ -29,7 +34,6 @@ export interface ZLinkRawSocketPort {
     unbind(endpoint: string): void;
     connect(endpoint: string): void;
     disconnect(endpoint: string): void;
-    setReceiveFlowState(state: 'running' | 'paused'): void;
     monitor(): ZLinkRawMonitorPort;
     close(): void;
 }
@@ -44,12 +48,15 @@ export interface ZLinkRawRouterRoute {
     readonly routeGeneration: bigint;
 }
 export interface ZLinkRawRouterPort extends ZLinkRawSocketPort {
+    setReceiveFlowState(state: 'running' | 'paused'): void;
+    /** Reports Core submit synchronously; admitted observes only pending admission. */
+    submitSend(targetRid: string, parts: readonly Uint8Array[]): ZLinkRawSendSubmission;
     disconnectRid?(routingId: string): void;
     localEndpoint(): string;
     setRoutingId(routingId: string): void;
     connectToRoutingId(routingId: string, endpoint: string): void;
     send(targetRid: string, parts: readonly Uint8Array[]): Promise<void>;
-    request(targetRid: string, parts: readonly Uint8Array[], timeoutMs: number): Promise<readonly Buffer[]>;
+    request(targetRid: string, parts: readonly Uint8Array[], timeoutMs: number, recordReceived?: () => void, onAdmitted?: () => void): Promise<readonly Buffer[]>;
     receive(dontWait?: boolean): ZLinkRawReceivedRecord | undefined;
     /** The selected route of every RID. The socket's one route observer calls it. */
     routesSnapshot(): readonly ZLinkRawRouterRoute[];
@@ -57,7 +64,7 @@ export interface ZLinkRawRouterPort extends ZLinkRawSocketPort {
 export interface ZLinkRawDealerPort extends ZLinkRawSocketPort {
     setRoutingId(routingId: string): void;
     send(parts: readonly Uint8Array[]): Promise<void>;
-    request(parts: readonly Uint8Array[], timeoutMs: number): Promise<readonly Buffer[]>;
+    request(parts: readonly Uint8Array[], timeoutMs: number, onAdmitted?: () => void): Promise<readonly Buffer[]>;
     receive(dontWait?: boolean): ZLinkRawReceivedRecord | undefined;
 }
 export interface ZLinkRawHostPort {

package/dist/runtime/backend/runtime-message.d.ts

@@ -4,6 +4,7 @@ export declare class ZLinkBufferMessage implements Message {
     private constructor();
     static from(value: Message | Buffer | Uint8Array | string): ZLinkBufferMessage;
     static fromOwned(bytes: Buffer): ZLinkBufferMessage;
+    static retainPayload(message: Message): Buffer;
     data(): Buffer;
     toBytes(): Uint8Array;
     copy(): Message;

package/dist/runtime/backend/runtime-message.js

@@ -16,6 +16,11 @@ class ZLinkBufferMessage {
     static fromOwned(bytes) {
         return new ZLinkBufferMessage(bytes);
     }
+    static retainPayload(message) {
+        // Binding data() Buffers retain their storage after the message handle closes.
+        // Preserve that ownership at runtime boundaries without copying the payload.
+        return message.data();
+    }
     data() {
         return this.bytes;
     }