@zlink-systems/framework 0.29.1 → 0.30.0

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

@@ -34,7 +34,12 @@ class ZLinkNodeChannelBackendAdapter {
         return (0, node_socket_backend_adapter_1.wrapSocket)(node_backend_adapter_support_1.zlink.createDealerSocket(asNodeContext(context)), true);
     }
     createRouterSocket(context) {
-        return (0, node_socket_backend_adapter_1.wrapSocket)(node_backend_adapter_support_1.zlink.createRouterSocket(asNodeContext(context)), true);
+        const socket = node_backend_adapter_support_1.zlink.createRouterSocket(asNodeContext(context));
+        const adapter = (0, node_socket_backend_adapter_1.wrapSocket)(socket, true);
+        adapter.setReceiveFlowState = (state) => {
+            socket.setReceiveFlowState(state);
+        };
+        return adapter;
     }
     createPublisherSocket(context) {
         return (0, node_socket_backend_adapter_1.wrapSocket)(node_backend_adapter_support_1.zlink.createPubSocket(asNodeContext(context)));

package/dist/runtime/backend/node/node-backend-adapter-support.d.ts

@@ -38,9 +38,10 @@ export declare function isRouteRecvRetryable(error: unknown): boolean;
 export declare function submitBindingPublish(operation: ZLinkBindingPublishOperation, payload: unknown): void;
 export declare function submitBindingReply(operation: ZLinkBindingReplyOperation, payload: unknown): void;
 export declare function submitBindingAsyncSend(operation: ZLinkBindingAsyncSendOperation, payload: unknown): Promise<void>;
+export declare function submitBindingSend(operation: ZLinkBindingAsyncSendOperation, payload: unknown): import('../raw-binding-port').ZLinkRawSendSubmission;
 export declare function submitBindingSyncSend(operation: ZLinkBindingAsyncSendOperation, payload: unknown): void;
-export declare function submitBindingRequest(operation: ZLinkBindingRequestOperation, payload: unknown, timeoutMs: number | undefined): Promise<readonly unknown[]>;
-export declare function bindingRequestReply(submission: import('@zlink-systems/zlink').RequestSubmission, deadlineMs: number | undefined): Promise<import('@zlink-systems/zlink').Message[]>;
+export declare function submitBindingRequest(operation: ZLinkBindingRequestOperation, payload: unknown, timeoutMs: number | undefined, recordReceived?: () => void): Promise<readonly unknown[]>;
+export declare function bindingRequestReply(submission: import('@zlink-systems/zlink').RequestSubmission, deadlineMs: number | undefined, recordReceived?: () => void): Promise<import('@zlink-systems/zlink').Message[]>;
 export declare function closeBindingReply(replies: readonly import('@zlink-systems/zlink').Message[]): void;
 /**
  * Closes a binding handle once. An already closed or terminated handle counts as
@@ -50,7 +51,6 @@ export declare function closeBindingHandle(target: {
     close(): void;
 }): void;
 export declare function isContextTerminatedError(error: unknown): boolean;
-export declare function disableSocketLinger(target: unknown): void;
 export declare function toNativeRoutingId(routingId: unknown): unknown;
 export declare function translateBindingResultError(error: unknown, phase?: 'submit' | 'completion'): unknown;
 export declare function toNativeActorRef(actor: unknown): unknown;

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

@@ -6,13 +6,13 @@ exports.isRouteRecvRetryable = isRouteRecvRetryable;
 exports.submitBindingPublish = submitBindingPublish;
 exports.submitBindingReply = submitBindingReply;
 exports.submitBindingAsyncSend = submitBindingAsyncSend;
+exports.submitBindingSend = submitBindingSend;
 exports.submitBindingSyncSend = submitBindingSyncSend;
 exports.submitBindingRequest = submitBindingRequest;
 exports.bindingRequestReply = bindingRequestReply;
 exports.closeBindingReply = closeBindingReply;
 exports.closeBindingHandle = closeBindingHandle;
 exports.isContextTerminatedError = isContextTerminatedError;
-exports.disableSocketLinger = disableSocketLinger;
 exports.toNativeRoutingId = toNativeRoutingId;
 exports.translateBindingResultError = translateBindingResultError;
 exports.toNativeActorRef = toNativeActorRef;
@@ -76,6 +76,11 @@ function submitBindingReply(operation, payload) {
     }
 }
 async function submitBindingAsyncSend(operation, payload) {
+    const submission = submitBindingSend(operation, payload);
+    if (submission.result === runtime_values_1.SubmitResult.Backpressured)
+        await submission.admitted;
+}
+function submitBindingSend(operation, payload) {
     let submission;
     try {
         let current;
@@ -91,13 +96,14 @@ async function submitBindingAsyncSend(operation, payload) {
         throw translateBindingResultError(error, 'submit');
     }
     if (submission.result === runtime_values_1.SubmitResult.Backpressured) {
-        try {
-            await submission.admitted;
-        }
-        catch (error) {
-            throw translateBindingResultError(error, 'completion');
-        }
+        return {
+            result: submission.result,
+            admitted: submission.admitted.catch((error) => {
+                throw translateBindingResultError(error, 'completion');
+            })
+        };
     }
+    return { result: runtime_values_1.SubmitResult.Ok, admitted: submission.admitted };
 }
 function submitBindingSyncSend(operation, payload) {
     try {
@@ -114,7 +120,7 @@ function submitBindingSyncSend(operation, payload) {
         throw translateBindingResultError(error);
     }
 }
-async function submitBindingRequest(operation, payload, timeoutMs) {
+async function submitBindingRequest(operation, payload, timeoutMs, recordReceived) {
     const deadlineMs = timeoutMs === undefined ? undefined : performance.now() + timeoutMs;
     try {
         let current;
@@ -132,25 +138,31 @@ async function submitBindingRequest(operation, payload, timeoutMs) {
         if (timeoutMs !== undefined) {
             current = current.timeout(timeoutMs);
         }
-        return await bindingRequestReply(current.submit(), deadlineMs);
+        return await bindingRequestReply(current.submit(), deadlineMs, recordReceived);
     }
     catch (error) {
         throw translateBindingResultError(error);
     }
 }
-async function bindingRequestReply(submission, deadlineMs) {
+async function bindingRequestReply(submission, deadlineMs, recordReceived) {
     const reply = submission.reply;
     if (submission.result === runtime_values_1.SubmitResult.Backpressured) {
         try {
             const [, replies] = await (0, request_deadline_1.waitRequestReply)(Promise.all([submission.admitted, reply]), 'Request', deadlineMs);
+            recordReceived?.();
             return replies;
         }
         catch (error) {
-            void reply.then(closeBindingReply, () => undefined);
+            void reply.then((parts) => {
+                recordReceived?.();
+                closeBindingReply(parts);
+            }, () => undefined);
             throw error;
         }
     }
-    return reply;
+    const replies = await reply;
+    recordReceived?.();
+    return replies;
 }
 function closeBindingReply(replies) {
     for (const reply of replies)
@@ -182,23 +194,6 @@ function isSuccessfulOrAlreadyShutdownCloseError(error) {
 function isContextTerminatedError(error) {
     return error instanceof Error && /context was terminated/i.test(error.message);
 }
-function disableSocketLinger(target) {
-    if (target !== null &&
-        typeof target === 'object' &&
-        'options' in target &&
-        typeof target.options === 'object' &&
-        target.options !== null &&
-        'linger' in target.options) {
-        try {
-            target.options.linger = 0;
-        }
-        catch (error) {
-            if (!isContextTerminatedError(error)) {
-                throw error;
-            }
-        }
-    }
-}
 function toNativeRoutingId(routingId) {
     if (typeof routingId === 'string')
         return exports.zlink.RoutingId.from(routingId);

package/dist/runtime/backend/node/node-mesh-backend-adapter.d.ts

@@ -1,12 +1,4 @@
 import type { ZLinkBackendContext, ZLinkBackendMeshNode, ZLinkMeshBackendAdapter } from '../contracts';
 export declare class ZLinkNodeMeshBackendAdapter implements ZLinkMeshBackendAdapter {
-    createMeshNode(context: ZLinkBackendContext, options: {
-        readonly meshName: string;
-        readonly routingId?: string;
-        readonly receiveTimeoutMs?: number;
-        readonly trustProfile?: string;
-        readonly applicationJobQueue: import('../../application-jobs/contracts').ApplicationJobQueuePort;
-        readonly applicationJobReceiveFlowFailureSink?: (error: unknown) => void;
-        readonly peerAdmissionSealed?: () => boolean;
-    }): ZLinkBackendMeshNode;
+    createMeshNode(context: ZLinkBackendContext, options: Parameters<ZLinkMeshBackendAdapter['createMeshNode']>[1]): ZLinkBackendMeshNode;
 }

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

@@ -12,7 +12,7 @@ class ZLinkNodeMeshBackendAdapter {
         if (!isBindingContext(bindingContext)) {
             throw new TypeError('Node MeshNode creation requires the Node binding Context owned by the host.');
         }
-        return new node_raw_mesh_backend_1.ZLinkNodeRawMeshBackend(options.meshName, options.routingId, new node_raw_binding_port_1.ZLinkNodeRawBindingPort(bindingContext, options.receiveTimeoutMs), options.applicationJobQueue, options.applicationJobReceiveFlowFailureSink, options.peerAdmissionSealed);
+        return new node_raw_mesh_backend_1.ZLinkNodeRawMeshBackend(options.meshName, options.routingId, new node_raw_binding_port_1.ZLinkNodeRawBindingPort(bindingContext, options.receiveTimeoutMs), options.applicationJobQueue, options.applicationJobReceiveFlowFailureSink, options.peerAdmissionSealed, options.infrastructureTaskRunner);
     }
 }
 exports.ZLinkNodeMeshBackendAdapter = ZLinkNodeMeshBackendAdapter;

package/dist/runtime/backend/node/node-raw-binding-port.js

@@ -114,10 +114,6 @@ class NodeRawSocketPort {
         connectable(this.socket).disconnect(endpoint);
         this.endpoints.delete(`connect\0${endpoint}`);
     }
-    setReceiveFlowState(state) {
-        this.requireOpen();
-        this.socket.setReceiveFlowState(state === 'paused' ? zlink_1.ReceiveFlowState.PAUSED : zlink_1.ReceiveFlowState.RUNNING);
-    }
     monitor() {
         this.requireOpen();
         const nativeMonitor = this.socket.monitorOpen();
@@ -178,6 +174,10 @@ class NodeRawSocketPort {
 }
 class NodeRawRouterPort extends NodeRawSocketPort {
     nextIncomingRequestSequence = 1n;
+    setReceiveFlowState(state) {
+        this.requireOpen();
+        this.socket.setReceiveFlowState(state === 'paused' ? zlink_1.ReceiveFlowState.PAUSED : zlink_1.ReceiveFlowState.RUNNING);
+    }
     disconnectRid(routingId) {
         this.requireOpen();
         this.socket.disconnectRid(bindingRoutingId(routingId));
@@ -209,7 +209,12 @@ class NodeRawRouterPort extends NodeRawSocketPort {
         requireParts(parts);
         return (0, node_backend_adapter_support_1.submitBindingAsyncSend)(this.socket.send(bindingRoutingId(targetRid)), parts);
     }
-    async request(targetRid, parts, timeoutMs) {
+    submitSend(targetRid, parts) {
+        this.requireOpen();
+        requireParts(parts);
+        return (0, node_backend_adapter_support_1.submitBindingSend)(this.socket.send(bindingRoutingId(targetRid)), parts);
+    }
+    async request(targetRid, parts, timeoutMs, recordReceived) {
         this.requireOpen();
         const deadlineMs = performance.now() + timeoutMs;
         let submission;
@@ -222,7 +227,7 @@ class NodeRawRouterPort extends NodeRawSocketPort {
             throw (0, node_backend_adapter_support_1.translateBindingResultError)(error, 'submit');
         }
         try {
-            const replies = await (0, node_backend_adapter_support_1.bindingRequestReply)(submission, deadlineMs);
+            const replies = await (0, node_backend_adapter_support_1.bindingRequestReply)(submission, deadlineMs, recordReceived);
             return copyAndClose(replies);
         }
         catch (error) {

package/dist/runtime/backend/node/node-raw-mesh-backend.d.ts

@@ -1,4 +1,5 @@
 import { SubmitResult, type RequestResult as RequestResultValue, type SubmitResult as SubmitResultValue } from '@zlink-systems/zlink';
+import type { ZLinkMeshCompletionHandler } from '../mesh-completion-table';
 import { type RoutingId } from '../../../contracts';
 import type { ApplicationJobQueuePort } from '../../application-jobs/contracts';
 import type { ZLinkDispatchErrorReporter } from '../../channels/dispatch-error-reporter';
@@ -7,7 +8,7 @@ import type { ServiceInstanceActivationRecoveryEnvelope } from '../../foundation
 import { type MeshOperationId, type MeshPeerEntry, type MeshPublisher, type ReadyBatch, type ReadyRecord, type ReceiveBatch, type ServiceSpot, type StreamSessionService, MeshNodeRuntimeState } from '../../foundation/service-runtime-contracts';
 import type { ServiceActorRef, ServiceSpotState } from '../../foundation/service-stateful-registry';
 import { type ServiceAsyncInstanceActivationAuthority, type ServiceInstanceApplicationLifecycle, type ServicePendingInstanceActivation, type ServiceSpotMessageFollowSeal, type ServiceUserSpotOperationHandler, type ServiceUserSpotOperationResult } from '../../foundation/service-stateful-runtime';
-import type { ServiceActorCreateRecord, ServiceDirectSpotRouteFence, ServiceInstanceActivationTarget, ServiceInstanceRouteFence, ServiceSpotRouteFence, ServiceUserSpotCloseRecord, ServiceUserSpotCreateRecord } from '../../foundation/service-stateful-wire-codec';
+import type { ServiceActorCreateRecord, ServiceDirectSpotRouteFence, ServiceInstanceActivationTarget, ServiceInstanceColdActivationTarget, ServiceInstanceRouteFence, ServiceSpotRouteFence, ServiceUserSpotCloseRecord, ServiceUserSpotCreateRecord } from '../../foundation/service-stateful-wire-codec';
 import type { ServiceNodeDescriptor } from '../../foundation/service-topology-registry';
 import { type ServiceApplicationPayload } from '../../foundation/service-wire-m6a-codec';
 import type { ZLinkBackendActorRef, ZLinkBackendMeshNode, ZLinkBackendObjectPlacement } from '../contracts';
@@ -24,12 +25,11 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     private readonly applicationJobQueue?;
     private readonly applicationJobReceiveFlowFailureSink?;
     private readonly peerAdmissionSealed?;
+    private readonly infrastructureTaskRunner?;
     readonly nativeInstance: this;
     private readonly channels;
     private readonly peerIntents;
-    private readonly completions;
-    private completionHead;
-    private completionCount;
+    private completionHandler?;
     private readonly routingId;
     private readonly lifecycleGeneration;
     private bindEndpoint?;
@@ -56,7 +56,7 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     private messageFollowHandler?;
     private dispatchErrors?;
     private readonly peerDisconnectedHandlers;
-    constructor(meshName: string, routingId: string | undefined, bindingPort: ZLinkRawBindingPort, applicationJobQueue?: ApplicationJobQueuePort | undefined, applicationJobReceiveFlowFailureSink?: ((error: unknown) => void) | undefined, peerAdmissionSealed?: (() => boolean) | undefined);
+    constructor(meshName: string, routingId: string | undefined, bindingPort: ZLinkRawBindingPort, applicationJobQueue?: ApplicationJobQueuePort | undefined, applicationJobReceiveFlowFailureSink?: ((error: unknown) => void) | undefined, peerAdmissionSealed?: (() => boolean) | undefined, infrastructureTaskRunner?: import("../../spots/spot-actor-join-dispatch").ZLinkDetachedTaskRunner | undefined);
     configureObjectPlacement(options: {
         readonly role: ServiceNodeDescriptor['objectRole'];
         readonly placementWeight: number;
@@ -79,8 +79,8 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     onPeerDisconnected(handler: (endpoint: string) => void): void;
     selectObjectPlacement(stableType: string): ZLinkBackendObjectPlacement;
     instanceSpotPlacementTypes(): readonly string[];
-    sendToMissingInstanceSpot(target: ServiceInstanceActivationTarget, parts: MessageLike | readonly MessageLike[], deadlineUnixMs: bigint, sourceSpotId?: string, metadata?: ReadonlyMap<string, string>): Promise<SubmitResult>;
-    requestToMissingInstanceSpot(target: ServiceInstanceActivationTarget, parts: MessageLike | readonly MessageLike[], deadlineUnixMs: bigint, sourceSpotId?: string, metadata?: ReadonlyMap<string, string>): MeshOperationId;
+    sendToMissingInstanceSpot(target: ServiceInstanceColdActivationTarget, parts: MessageLike | readonly MessageLike[], deadlineUnixMs: bigint, sourceSpotId?: string, metadata?: ReadonlyMap<string, string>): Promise<SubmitResult>;
+    requestToMissingInstanceSpot(target: ServiceInstanceColdActivationTarget, parts: MessageLike | readonly MessageLike[], deadlineUnixMs: bigint, sourceSpotId?: string, metadata?: ReadonlyMap<string, string>): MeshOperationId;
     setRoutingId(routingId: unknown): void;
     setBind(endpoint: string): void;
     setAdvertiseHost(host: string): void;
@@ -151,6 +151,7 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
         weights: number[];
     };
     createPublisher(): MeshPublisher;
+    setCompletionHandler(handler: ZLinkMeshCompletionHandler): void;
     setReadyHandler(handler: (readyDomains: number) => number): void;
     createReadyBatch(capacity: number): ReadyBatch;
     createReceiveBatch(messageCapacity: number, partCapacity: number): ReceiveBatch;
@@ -249,11 +250,8 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     private notifyReady;
     private observeCompletion;
     private observeStateful;
-    private enqueueImmediateFailure;
-    private enqueueCompletion;
-    private drainCompletions;
-    private takeCompletion;
-    private clearCompletions;
+    private observeImmediateFailure;
+    private deliverCompletion;
     private drainMailbox;
     private requireRuntime;
     private requireApplicationJobQueue;

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

@@ -12,7 +12,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 +57,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 +105,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) {
@@ -203,6 +202,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),
@@ -275,7 +276,6 @@ class ZLinkNodeRawMeshBackend {
         this.stateful = undefined;
         this.runtime?.close();
         this.runtime = undefined;
-        this.clearCompletions();
         this.closed = true;
     }
     addChannelName(name) {
@@ -426,7 +426,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 +519,9 @@ class ZLinkNodeRawMeshBackend {
             }
         };
     }
+    setCompletionHandler(handler) {
+        this.completionHandler = handler;
+    }
     setReadyHandler(handler) {
         this.readyHandler = handler;
         this.notifyReady();
@@ -532,7 +535,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 +542,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 {
@@ -719,7 +721,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));
     }
@@ -824,7 +826,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 +837,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 +871,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));
         }
     }
@@ -1259,49 +1239,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);

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;
         },
@@ -144,7 +149,7 @@ function wrapSocket(nativeInstance, pollCompletion) {
             }
             if (hasRequest) {
                 const [payload, timeoutMs] = args;
-                return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.request(), payload, timeoutMs);
+                return (0, node_backend_adapter_support_1.submitBindingRequest)(nativeInstance.request(), payload, timeoutMs, adapter.receiveAdmission?.recordReceived);
             }
             throw new TypeError('Backend request requires a DEALER or ROUTER socket.');
         },