@zlink-systems/framework 0.30.3 → 0.32.0

package/dist/contracts/Actors/ZLinkActor.d.ts

@@ -1,7 +1,9 @@
 import type { ZLinkActorContext } from './ZLinkActorContext';
 import type { ZLinkActorJoinCompletion } from './ZLinkActorFactory';
+import type { ZLinkSessionBindingIdentity } from './ZLinkSessionBindingIdentity';
 export interface ZLinkActor {
     readonly context: ZLinkActorContext;
     configure?(): void;
     onJoinCompleted?(completion: ZLinkActorJoinCompletion): Promise<void>;
+    onDuplicateBind?(current: ZLinkSessionBindingIdentity, incoming: ZLinkSessionBindingIdentity, signal: AbortSignal): Promise<string | undefined>;
 }

package/dist/contracts/Actors/ZLinkSessionBindingIdentity.d.ts

@@ -0,0 +1,6 @@
+import type { RoutingId } from '../Common';
+export interface ZLinkSessionBindingIdentity {
+    readonly sessionOwnerNodeRid: RoutingId;
+    readonly sessionOwnerNodeGeneration: bigint;
+    readonly bindingGeneration: bigint;
+}

package/dist/contracts/Actors/ZLinkSessionBindingIdentity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/Actors/index.d.ts

@@ -1,4 +1,5 @@
 export * from './ZLinkActor';
+export * from './ZLinkSessionBindingIdentity';
 export * from './ZLinkActorContext';
 export * from './ZLinkActorClient';
 export * from './ZLinkActorFactory';

package/dist/contracts/Actors/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ZLinkActor"), exports);
+__exportStar(require("./ZLinkSessionBindingIdentity"), exports);
 __exportStar(require("./ZLinkActorContext"), exports);
 __exportStar(require("./ZLinkActorClient"), exports);
 __exportStar(require("./ZLinkActorFactory"), exports);

package/dist/contracts/Common/CoreTypes.d.ts

@@ -1,4 +1,5 @@
 export type Type<T = unknown> = new (...args: never[]) => T;
+export type ZLinkMessageTypeResolver<T = unknown> = Type<T> | (() => Type<T>);
 export type RoutingId = string;
 /** Global logical Actor identity. It does not encode a Mesh or owner route. */
 export type ActorId = string;

package/dist/contracts/Common/HandlerMessageType.d.ts

@@ -0,0 +1,8 @@
+import type { Type } from './CoreTypes';
+export interface ZLinkHandlerMessageType {
+    readonly type: Type;
+}
+/** Reads a handler's declared type once and defers/caches a lazy resolver until decode. */
+export declare function resolveHandlerMessageType(handlerType: Type): ZLinkHandlerMessageType | undefined;
+/** Converts a stored registration resolver to the constructor expected by a codec. */
+export declare function resolveMessageTypeForDecode(messageType?: ZLinkHandlerMessageType): Type | undefined;

package/dist/contracts/Common/HandlerMessageType.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveHandlerMessageType = resolveHandlerMessageType;
+exports.resolveMessageTypeForDecode = resolveMessageTypeForDecode;
+/** Reads a handler's declared type once and defers/caches a lazy resolver until decode. */
+function resolveHandlerMessageType(handlerType) {
+    const declared = handlerType.messageType;
+    if (declared === undefined)
+        return undefined;
+    if (isTypeConstructor(declared))
+        return { type: declared };
+    let state = 'unresolved';
+    let resolved;
+    let failure;
+    return {
+        get type() {
+            if (state === 'unresolved') {
+                try {
+                    resolved = declared();
+                    state = 'resolved';
+                }
+                catch (error) {
+                    failure = error;
+                    state = 'failed';
+                }
+            }
+            if (state === 'failed')
+                throw failure;
+            return resolved;
+        }
+    };
+}
+/** Converts a stored registration resolver to the constructor expected by a codec. */
+function resolveMessageTypeForDecode(messageType) {
+    return messageType?.type;
+}
+function isTypeConstructor(value) {
+    // Class constructors have a non-writable prototype property; ordinary resolver functions do not.
+    return (typeof value === 'function' &&
+        Object.getOwnPropertyDescriptor(value, 'prototype')?.writable === false);
+}

package/dist/contracts/Common/ZLinkEncodedPayload.d.ts

@@ -1,4 +1,5 @@
 export declare class ZLinkEncodedPayload {
+    #private;
     private constructor();
     /** Copies the supplied bytes. */
     static from(bytes: Uint8Array): ZLinkEncodedPayload;
@@ -14,5 +15,4 @@ export declare class ZLinkEncodedPayload {
     isEmpty(): boolean;
     getString(encoding?: BufferEncoding): string;
     close(): void;
-    private stored;
 }

package/dist/contracts/Common/ZLinkEncodedPayload.js

@@ -1,15 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkEncodedPayload = void 0;
-const encoded_payload_storage_1 = require("./encoded-payload-storage");
 class ZLinkEncodedPayload {
+    #bytes;
     constructor(bytes, owned) {
-        if (owned) {
-            (0, encoded_payload_storage_1.adoptEncodedPayload)(this, bytes);
-        }
-        else {
-            (0, encoded_payload_storage_1.storeEncodedPayload)(this, bytes);
-        }
+        this.#bytes = !owned
+            ? Buffer.from(bytes)
+            : Buffer.isBuffer(bytes)
+                ? bytes
+                : Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
     }
     /** Copies the supplied bytes. */
     static from(bytes) {
@@ -21,36 +20,29 @@ class ZLinkEncodedPayload {
     }
     /** Returns a copy of the stored bytes. */
     data() {
-        return new Uint8Array(this.stored());
+        return new Uint8Array(this.#bytes);
     }
     /** Returns the stored bytes without copying. Do not modify this view or its backing buffer. */
     view() {
-        return this.stored();
+        return this.#bytes;
     }
     toBytes() {
         return this.data();
     }
     copy() {
-        return ZLinkEncodedPayload.from(this.stored());
+        return ZLinkEncodedPayload.from(this.#bytes);
     }
     size() {
-        return this.stored().length;
+        return this.#bytes.length;
     }
     isEmpty() {
-        return this.stored().length === 0;
+        return this.#bytes.length === 0;
     }
     getString(encoding = 'utf8') {
-        return this.stored().toString(encoding);
+        return this.#bytes.toString(encoding);
     }
     close() {
         // ZLinkEncodedPayload owns managed memory only; this mirrors Message-like readers.
     }
-    stored() {
-        const payload = (0, encoded_payload_storage_1.borrowEncodedPayload)(this);
-        if (payload === undefined) {
-            throw new Error('ZLink encoded payload storage is unavailable.');
-        }
-        return payload;
-    }
 }
 exports.ZLinkEncodedPayload = ZLinkEncodedPayload;

package/dist/contracts/Common/ZLinkMessage.js

@@ -115,13 +115,17 @@ function materializeZLinkMessageValue(value, type) {
         return value;
     }
     const materialized = Object.create(prototype);
-    for (const [key, item] of Object.entries(value)) {
-        Object.defineProperty(materialized, key, {
-            configurable: true,
-            enumerable: true,
-            value: item,
-            writable: true
-        });
+    const descriptor = {
+        configurable: true,
+        enumerable: true,
+        value: undefined,
+        writable: true
+    };
+    for (const key in value) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+            descriptor.value = value[key];
+            Object.defineProperty(materialized, key, descriptor);
+        }
     }
     return materialized;
 }

package/dist/contracts/Common/encoded-payload-storage.d.ts

@@ -1,3 +1 @@
-export declare function storeEncodedPayload(owner: object, bytes: Uint8Array): Buffer;
-export declare function adoptEncodedPayload(owner: object, bytes: Uint8Array): Buffer;
 export declare function borrowEncodedPayload(owner: object): Buffer | undefined;

package/dist/contracts/Common/encoded-payload-storage.js

@@ -1,21 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.storeEncodedPayload = storeEncodedPayload;
-exports.adoptEncodedPayload = adoptEncodedPayload;
 exports.borrowEncodedPayload = borrowEncodedPayload;
-const encodedPayloadStorage = new WeakMap();
-function storeEncodedPayload(owner, bytes) {
-    const stored = Buffer.from(bytes);
-    encodedPayloadStorage.set(owner, stored);
-    return stored;
-}
-function adoptEncodedPayload(owner, bytes) {
-    const stored = Buffer.isBuffer(bytes)
-        ? bytes
-        : Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-    encodedPayloadStorage.set(owner, stored);
-    return stored;
-}
+const ZLinkEncodedPayload_1 = require("./ZLinkEncodedPayload");
 function borrowEncodedPayload(owner) {
-    return encodedPayloadStorage.get(owner);
+    return owner instanceof ZLinkEncodedPayload_1.ZLinkEncodedPayload
+        ? ZLinkEncodedPayload_1.ZLinkEncodedPayload.prototype.view.call(owner)
+        : undefined;
 }

package/dist/contracts/Common/index.d.ts

@@ -1,5 +1,5 @@
 export * from './ActorRef';
-export type { Type, RoutingId, ActorId, SpotId } from './CoreTypes';
+export type { Type, ZLinkMessageTypeResolver, RoutingId, ActorId, SpotId } from './CoreTypes';
 export * from './ZLinkEncodedPayload';
 export * from './ZLinkMessageMetadata';
 export { ZLinkMessage, isZLinkMessage } from './ZLinkMessage';

package/dist/contracts/Common/payload-slab.d.ts

@@ -0,0 +1,4 @@
+/** Allocates independent bytes; previously returned regions are never reused. */
+export declare function allocatePayloadBytes(length: number): Buffer;
+/** Copies bytes into an exact, standalone backing store with no Buffer pool. */
+export declare function copyPayloadBytes(bytes: Uint8Array): Buffer;

package/dist/contracts/Common/payload-slab.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocatePayloadBytes = allocatePayloadBytes;
+exports.copyPayloadBytes = copyPayloadBytes;
+const SLAB_BYTES = 64 * 1024;
+const MAX_POOLED_BYTES = 16 * 1024;
+const ALIGNMENT = 8;
+let slab;
+let offset = 0;
+/** Allocates independent bytes; previously returned regions are never reused. */
+function allocatePayloadBytes(length) {
+    if (length > MAX_POOLED_BYTES || length < 0 || !Number.isInteger(length)) {
+        return Buffer.allocUnsafe(length);
+    }
+    if (slab === undefined || offset + length > SLAB_BYTES) {
+        slab = Buffer.allocUnsafe(SLAB_BYTES);
+        offset = 0;
+    }
+    const bytes = slab.subarray(offset, offset + length);
+    offset += Math.ceil(length / ALIGNMENT) * ALIGNMENT;
+    // Transient runtime frames only; local queues and application boundaries
+    // copy before they retain or expose these bytes.
+    return bytes;
+}
+/** Copies bytes into an exact, standalone backing store with no Buffer pool. */
+function copyPayloadBytes(bytes) {
+    const copy = Buffer.allocUnsafeSlow(bytes.byteLength);
+    copy.set(bytes);
+    return copy;
+}

package/dist/contracts/Configuration/RegistrationBuilders.js

@@ -11,6 +11,7 @@ const DiagnosticsValidation_1 = require("./DiagnosticsValidation");
 const EndpointNotation_1 = require("./EndpointNotation");
 const FanoutTopic_1 = require("./FanoutTopic");
 const SendTimeoutValidation_1 = require("./SendTimeoutValidation");
+const HandlerMessageType_1 = require("../Common/HandlerMessageType");
 const InternalDefaults_1 = require("./InternalDefaults");
 const ObjectRoles_1 = require("./ObjectRoles");
 const RegistrationBuilderPolicy_1 = require("./RegistrationBuilderPolicy");
@@ -509,12 +510,12 @@ class DefaultClientServerChannelServerBuilder {
     }
     addSendHandler(handlerType) {
         this.channel.sendHandlers ??= [];
-        this.channel.sendHandlers.push({ packetName: handlerPacketName(handlerType), handlerType });
+        this.channel.sendHandlers.push(handlerRegistration(handlerType));
         return this;
     }
     addRequestHandler(handlerType) {
         this.channel.requestHandlers ??= [];
-        this.channel.requestHandlers.push({ packetName: handlerPacketName(handlerType), handlerType });
+        this.channel.requestHandlers.push(handlerRegistration(handlerType));
         return this;
     }
     get server() {
@@ -777,15 +778,12 @@ class DefaultMeshNodeBuilder {
     }
     addRouteSendHandler(handlerType) {
         this.node.routeSendHandlers ??= [];
-        this.node.routeSendHandlers.push({ packetName: handlerPacketName(handlerType), handlerType });
+        this.node.routeSendHandlers.push(handlerRegistration(handlerType));
         return this;
     }
     addRouteRequestHandler(handlerType) {
         this.node.routeRequestHandlers ??= [];
-        this.node.routeRequestHandlers.push({
-            packetName: handlerPacketName(handlerType),
-            handlerType
-        });
+        this.node.routeRequestHandlers.push(handlerRegistration(handlerType));
         return this;
     }
     updateBind() {
@@ -1064,12 +1062,12 @@ class DefaultMeshChannelServerBuilder {
     }
     addSendHandler(handlerType) {
         this.channel.sendHandlers ??= [];
-        this.channel.sendHandlers.push({ packetName: handlerPacketName(handlerType), handlerType });
+        this.channel.sendHandlers.push(handlerRegistration(handlerType));
         return this;
     }
     addRequestHandler(handlerType) {
         this.channel.requestHandlers ??= [];
-        this.channel.requestHandlers.push({ packetName: handlerPacketName(handlerType), handlerType });
+        this.channel.requestHandlers.push(handlerRegistration(handlerType));
         return this;
     }
 }
@@ -1177,6 +1175,14 @@ function rejectDuplicateObjectType(registrations, stableType, meshName) {
         throw new ConfigurationException_1.ZLinkConfigurationException(`Duplicate object factory '${stableType}' on RouteMesh '${meshName}'.`);
     }
 }
+function handlerRegistration(handlerType) {
+    const messageType = (0, HandlerMessageType_1.resolveHandlerMessageType)(handlerType);
+    return {
+        packetName: handlerPacketName(handlerType),
+        handlerType,
+        ...(messageType === undefined ? {} : { messageType })
+    };
+}
 function handlerPacketName(handlerType) {
     return ((0, Attributes_1.readZLinkDecoratorMetadata)(handlerType).find((metadata) => metadata.kind === 'packet' && metadata.packetName !== undefined)?.packetName ?? handlerType.name);
 }

package/dist/contracts/Configuration/RegistrationTypes.d.ts

@@ -1,3 +1,4 @@
+import type { ZLinkHandlerMessageType } from '../Common/HandlerMessageType';
 import type { RoutingId, Type, ZLinkActor, ZLinkActorFactory, ZLinkEntrySpot, ZLinkHandlerFilter, ZLinkInstanceSpot, ZLinkMetricsOptions, ZLinkMessageContext, ZLinkPublishMessageContext, ZLinkRouteMessageContext, ZLinkSpot, ZLinkStreamCompressionOptions, ZLinkTimerOptions } from '../../contracts';
 import type { AutoHwmProfileValue } from '@zlink-systems/zlink';
 import type { ZLinkMessageSerializer } from '../Codecs';
@@ -270,18 +271,22 @@ export interface ZLinkMeshChannelOptions {
 export interface ZLinkMeshSendHandlerRegistration {
     readonly packetName: string;
     readonly handlerType: Type;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkMeshRequestHandlerRegistration {
     readonly packetName: string;
     readonly handlerType: Type;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkRouteMeshSendHandlerRegistration {
     readonly packetName: string;
     readonly handlerType: Type;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkRouteMeshRequestHandlerRegistration {
     readonly packetName: string;
     readonly handlerType: Type;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkEntrySpotTimerHandlerRegistration {
     readonly entrySpotType: Type<ZLinkEntrySpot>;
@@ -294,24 +299,28 @@ export interface ZLinkEntrySpotPacketHandlerRegistration {
     readonly entrySpotType: Type<ZLinkEntrySpot>;
     readonly handlerType: Type;
     readonly packetName?: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkEntrySpotSubscriptionHandlerRegistration {
     readonly entrySpotType: Type<ZLinkEntrySpot>;
     readonly handlerType: Type;
     readonly channelName: string;
     readonly topic: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkEntrySpotActorSendHandlerRegistration {
     readonly entrySpotType: Type<ZLinkEntrySpot>;
     readonly actorType: Type<ZLinkActor>;
     readonly handlerType: Type;
     readonly packetName: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkEntrySpotActorRequestHandlerRegistration {
     readonly entrySpotType: Type<ZLinkEntrySpot>;
     readonly actorType: Type<ZLinkActor>;
     readonly handlerType: Type;
     readonly packetName: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkSpotTimerHandlerRegistration {
     readonly spotType: Type<ZLinkSpot>;
@@ -324,24 +333,28 @@ export interface ZLinkSpotPacketHandlerRegistration {
     readonly spotType: Type<ZLinkSpot>;
     readonly handlerType: Type;
     readonly packetName?: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkSpotSubscriptionHandlerRegistration {
     readonly spotType: Type<ZLinkSpot>;
     readonly handlerType: Type;
     readonly channelName: string;
     readonly topic: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkSpotActorSendHandlerRegistration {
     readonly spotType: Type<ZLinkSpot>;
     readonly actorType: Type<ZLinkActor>;
     readonly handlerType: Type;
     readonly packetName: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkSpotActorRequestHandlerRegistration {
     readonly spotType: Type<ZLinkSpot>;
     readonly actorType: Type<ZLinkActor>;
     readonly handlerType: Type;
     readonly packetName: string;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkSpotRouterCapabilityOptions {
     readonly bind?: string;
@@ -368,21 +381,26 @@ export interface ZLinkRouteChannelHandlerOptions {
     readonly kind: 'send' | 'request';
     readonly packetName: string;
     readonly handler: ZLinkRouteChannelSendHandler | ZLinkRouteChannelRequestHandler;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkRouteChannelSendHandlerRegistration {
     readonly packetName: string;
     readonly handler: ZLinkRouteChannelSendHandler;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkRouteChannelRequestHandlerRegistration {
     readonly packetName: string;
     readonly handler: ZLinkRouteChannelRequestHandler;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkChannelPublishHandlerRegistration {
     readonly packetName: string;
     readonly handler: ZLinkChannelPublishHandler;
+    readonly messageType?: ZLinkHandlerMessageType;
 }
 export interface ZLinkChannelRequestHandlerRegistration {
     readonly packetName: string;
+    readonly messageType?: ZLinkHandlerMessageType;
     readonly handler?: {
         handle(payload: unknown, context: ZLinkMessageContext): Promise<unknown>;
     };
@@ -390,6 +408,7 @@ export interface ZLinkChannelRequestHandlerRegistration {
 }
 export interface ZLinkChannelSendHandlerRegistration {
     readonly packetName: string;
+    readonly messageType?: ZLinkHandlerMessageType;
     readonly handler?: {
         handle(payload: unknown, context: ZLinkMessageContext): Promise<void>;
     };

package/dist/contracts/Handlers/Contexts.d.ts

@@ -6,6 +6,7 @@ export interface ZLinkMessageContext {
     readonly contentType?: string;
     readonly metadata: ZLinkMessageMetadata;
     readonly correlationId?: string;
+    readonly receivedAt: Date;
 }
 export interface ZLinkPublishMessageContext extends ZLinkMessageContext {
     readonly channelName: string;

package/dist/contracts/Locations/Authority.d.ts

@@ -1,3 +1,4 @@
+import type { ZLinkFrameworkErrorKind } from '../Errors';
 import type { RoutingId } from '../Common';
 import type { ZLinkMeshNodeDescriptorKey } from './Keys';
 import type { ZLinkLocationOwnerToken } from './Writes';
@@ -83,6 +84,7 @@ export type ZLinkAuthorityCompareExchangeResult = ({
 } | {
     readonly kind: 'conflict';
     readonly current: ZLinkAuthorityReadResult;
+    readonly membershipFailure?: ZLinkFrameworkErrorKind.NotFound | ZLinkFrameworkErrorKind.Unavailable;
 } | {
     readonly kind: 'generationExhausted';
 };

package/dist/internal.d.ts

@@ -3,6 +3,11 @@ export * from './index';
 export { requireValidSendTimeoutMs } from './contracts/Configuration/SendTimeoutValidation';
 export * from './runtime/diagnostics';
 export * from './runtime/host';
+export { ZLinkActorPlacementCoordinator } from './runtime/host/actor-placement-coordinator';
+export { ZLinkActorTransferRuntime } from './runtime/host/actor-transfer-runtime';
+export { ApplicationJobQueue, ApplicationJobQueuePermit, nodeEffectiveProcessorCount, resolveApplicationJobQueueConfiguration } from './runtime/host/application-job-queue';
+export { ZLinkLocationRuntimeOwner } from './runtime/host/location-runtime-owner';
+export { relocationFailedFailureCode, ZLinkHostServiceRelocationRuntime } from './runtime/host/service-relocation-host-runtime';
 export * from './runtime/admission';
 export * from './runtime/activation-admission';
 export * from './runtime/streams';
@@ -17,9 +22,13 @@ export * from './runtime/locations/canonical-codec';
 export { ZLinkLocationAutoConnectType, ZLinkLocationKind, ZLinkRouteKind } from './contracts/Locations/Values';
 export { ZLinkLocationWriteIntent, ZLinkLocationWriteStatus } from './contracts/Locations/Writes';
 export * from './runtime/channels';
+export { ZLinkChannelRuntimeLifecycle } from './runtime/channels/channel-runtime-lifecycle';
+export { ZLinkChannelSocketRegistry } from './runtime/channels/channel-socket-registry';
+export { ZLinkChannelDispatchPipeline } from './runtime/channels/channel-dispatch-pipeline';
 export * from './runtime/backend';
 export * from './runtime/codecs';
 export * from './runtime/execution';
+export { ZLinkSerialExecutionQueue } from './runtime/execution/serial-execution-queue';
 export * from './runtime/handlers';
 export * from './runtime/messaging';
 export * from './runtime/foundation';

package/dist/internal.js

@@ -14,13 +14,27 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requirePublicWeight = exports.isValidCapacity = exports.isValidListenerPort = exports.isValidPositiveCapacity = exports.isValidPublicWeight = exports.ZLINK_MAX_CAPACITY = exports.ZLINK_MAX_PUBLIC_WEIGHT = exports.MAX_LISTENER_PORT = exports.ZLINK_MAX_STABLE_TYPE_BYTES = exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = exports.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = exports.requireValidSendTimeoutMs = void 0;
+exports.requirePublicWeight = exports.isValidCapacity = exports.isValidListenerPort = exports.isValidPositiveCapacity = exports.isValidPublicWeight = exports.ZLINK_MAX_CAPACITY = exports.ZLINK_MAX_PUBLIC_WEIGHT = exports.MAX_LISTENER_PORT = exports.ZLINK_MAX_STABLE_TYPE_BYTES = exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = exports.ZLinkSerialExecutionQueue = exports.ZLinkChannelDispatchPipeline = exports.ZLinkChannelSocketRegistry = exports.ZLinkChannelRuntimeLifecycle = exports.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = exports.ZLinkHostServiceRelocationRuntime = exports.relocationFailedFailureCode = exports.ZLinkLocationRuntimeOwner = exports.resolveApplicationJobQueueConfiguration = exports.nodeEffectiveProcessorCount = exports.ApplicationJobQueuePermit = exports.ApplicationJobQueue = exports.ZLinkActorTransferRuntime = exports.ZLinkActorPlacementCoordinator = exports.requireValidSendTimeoutMs = void 0;
 /** Test and companion-package integration surface. It is not exported by package.json. */
 __exportStar(require("./index"), exports);
 var SendTimeoutValidation_1 = require("./contracts/Configuration/SendTimeoutValidation");
 Object.defineProperty(exports, "requireValidSendTimeoutMs", { enumerable: true, get: function () { return SendTimeoutValidation_1.requireValidSendTimeoutMs; } });
 __exportStar(require("./runtime/diagnostics"), exports);
 __exportStar(require("./runtime/host"), exports);
+var actor_placement_coordinator_1 = require("./runtime/host/actor-placement-coordinator");
+Object.defineProperty(exports, "ZLinkActorPlacementCoordinator", { enumerable: true, get: function () { return actor_placement_coordinator_1.ZLinkActorPlacementCoordinator; } });
+var actor_transfer_runtime_1 = require("./runtime/host/actor-transfer-runtime");
+Object.defineProperty(exports, "ZLinkActorTransferRuntime", { enumerable: true, get: function () { return actor_transfer_runtime_1.ZLinkActorTransferRuntime; } });
+var application_job_queue_1 = require("./runtime/host/application-job-queue");
+Object.defineProperty(exports, "ApplicationJobQueue", { enumerable: true, get: function () { return application_job_queue_1.ApplicationJobQueue; } });
+Object.defineProperty(exports, "ApplicationJobQueuePermit", { enumerable: true, get: function () { return application_job_queue_1.ApplicationJobQueuePermit; } });
+Object.defineProperty(exports, "nodeEffectiveProcessorCount", { enumerable: true, get: function () { return application_job_queue_1.nodeEffectiveProcessorCount; } });
+Object.defineProperty(exports, "resolveApplicationJobQueueConfiguration", { enumerable: true, get: function () { return application_job_queue_1.resolveApplicationJobQueueConfiguration; } });
+var location_runtime_owner_1 = require("./runtime/host/location-runtime-owner");
+Object.defineProperty(exports, "ZLinkLocationRuntimeOwner", { enumerable: true, get: function () { return location_runtime_owner_1.ZLinkLocationRuntimeOwner; } });
+var service_relocation_host_runtime_1 = require("./runtime/host/service-relocation-host-runtime");
+Object.defineProperty(exports, "relocationFailedFailureCode", { enumerable: true, get: function () { return service_relocation_host_runtime_1.relocationFailedFailureCode; } });
+Object.defineProperty(exports, "ZLinkHostServiceRelocationRuntime", { enumerable: true, get: function () { return service_relocation_host_runtime_1.ZLinkHostServiceRelocationRuntime; } });
 __exportStar(require("./runtime/admission"), exports);
 __exportStar(require("./runtime/activation-admission"), exports);
 __exportStar(require("./runtime/streams"), exports);
@@ -40,9 +54,17 @@ var Writes_1 = require("./contracts/Locations/Writes");
 Object.defineProperty(exports, "ZLinkLocationWriteIntent", { enumerable: true, get: function () { return Writes_1.ZLinkLocationWriteIntent; } });
 Object.defineProperty(exports, "ZLinkLocationWriteStatus", { enumerable: true, get: function () { return Writes_1.ZLinkLocationWriteStatus; } });
 __exportStar(require("./runtime/channels"), exports);
+var channel_runtime_lifecycle_1 = require("./runtime/channels/channel-runtime-lifecycle");
+Object.defineProperty(exports, "ZLinkChannelRuntimeLifecycle", { enumerable: true, get: function () { return channel_runtime_lifecycle_1.ZLinkChannelRuntimeLifecycle; } });
+var channel_socket_registry_1 = require("./runtime/channels/channel-socket-registry");
+Object.defineProperty(exports, "ZLinkChannelSocketRegistry", { enumerable: true, get: function () { return channel_socket_registry_1.ZLinkChannelSocketRegistry; } });
+var channel_dispatch_pipeline_1 = require("./runtime/channels/channel-dispatch-pipeline");
+Object.defineProperty(exports, "ZLinkChannelDispatchPipeline", { enumerable: true, get: function () { return channel_dispatch_pipeline_1.ZLinkChannelDispatchPipeline; } });
 __exportStar(require("./runtime/backend"), exports);
 __exportStar(require("./runtime/codecs"), exports);
 __exportStar(require("./runtime/execution"), exports);
+var serial_execution_queue_1 = require("./runtime/execution/serial-execution-queue");
+Object.defineProperty(exports, "ZLinkSerialExecutionQueue", { enumerable: true, get: function () { return serial_execution_queue_1.ZLinkSerialExecutionQueue; } });
 __exportStar(require("./runtime/handlers"), exports);
 __exportStar(require("./runtime/messaging"), exports);
 __exportStar(require("./runtime/foundation"), exports);

package/dist/nest-integration.d.ts

@@ -3,6 +3,7 @@ export type * from './contracts/Configuration/RegistrationTypes';
 export type * from './contracts';
 export { ZLinkSpotActorSend, ZLinkSpotActorRequest } from './contracts/Handlers/Attributes';
 export { registerActorFactory, registerRelocationStore, validateRoutingIdPrefix, registerEntrySpot, registerSpotFactory, validateActorTransferTimeout, validateMessageFollowDuration, validateSessionReplacementCallbackTimeout } from './contracts/Configuration/RegistrationBuilderPolicy';
+export { resolveHandlerMessageType } from './contracts/Common/HandlerMessageType';
 import type { ZLinkLocationRuntimeQuery, ZLinkActorClient, ZLinkActorManager, ZLinkChannelClient, ZLinkClientServerRuntime, ZLinkCodecRegistryBuilder, ZLinkCodecRegistrar, ZLinkDispatchOptions, ZLinkDispatchOptionsBuilder, ZLinkFanoutClient, ZLinkFanoutRuntime, ZLinkRouteClient, ZLinkRouteMeshRuntime, ZLinkRouteMeshRuntimeOptions, ZLinkSpotManager, ZLinkSpotOutbound, ZLinkSpotPublisherClient, ZLinkStreamCompressionBuilder, ZLinkStreamCompressionCodec } from './contracts';
 import type { ZLinkProviderResolver } from './contracts/Common/ZLinkProviderResolver';
 import type { ZLinkSpotHandleResolver } from './runtime/spots/spot-handle';

package/dist/nest-integration.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.disposeIntegrationHandlers = exports.disposeIntegrationHandler = exports.registerIntegrationHandlerInstanceScopeFactory = exports.registerIntegrationHandlerFilterScope = exports.validateSessionReplacementCallbackTimeout = exports.validateMessageFollowDuration = exports.validateActorTransferTimeout = exports.registerSpotFactory = exports.registerEntrySpot = exports.validateRoutingIdPrefix = exports.registerRelocationStore = exports.registerActorFactory = exports.ZLinkSpotActorRequest = exports.ZLinkSpotActorSend = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.normalizeFrameworkRegistration = exports.createFrameworkRegistration = exports.ZLinkConfigurationException = void 0;
+exports.disposeIntegrationHandlers = exports.disposeIntegrationHandler = exports.registerIntegrationHandlerInstanceScopeFactory = exports.registerIntegrationHandlerFilterScope = exports.resolveHandlerMessageType = exports.validateSessionReplacementCallbackTimeout = exports.validateMessageFollowDuration = exports.validateActorTransferTimeout = exports.registerSpotFactory = exports.registerEntrySpot = exports.validateRoutingIdPrefix = exports.registerRelocationStore = exports.registerActorFactory = exports.ZLinkSpotActorRequest = exports.ZLinkSpotActorSend = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.normalizeFrameworkRegistration = exports.createFrameworkRegistration = exports.ZLinkConfigurationException = void 0;
 exports.createIntegrationDispatchOptionsBuilder = createIntegrationDispatchOptionsBuilder;
 exports.createIntegrationInboundDispatchOptionsBuilder = createIntegrationInboundDispatchOptionsBuilder;
 exports.createIntegrationLocationOptionsBuilder = createIntegrationLocationOptionsBuilder;
@@ -35,6 +35,8 @@ Object.defineProperty(exports, "registerSpotFactory", { enumerable: true, get: f
 Object.defineProperty(exports, "validateActorTransferTimeout", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.validateActorTransferTimeout; } });
 Object.defineProperty(exports, "validateMessageFollowDuration", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.validateMessageFollowDuration; } });
 Object.defineProperty(exports, "validateSessionReplacementCallbackTimeout", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.validateSessionReplacementCallbackTimeout; } });
+var HandlerMessageType_1 = require("./contracts/Common/HandlerMessageType");
+Object.defineProperty(exports, "resolveHandlerMessageType", { enumerable: true, get: function () { return HandlerMessageType_1.resolveHandlerMessageType; } });
 const RegistrationBuilders_1 = require("./contracts/Configuration/RegistrationBuilders");
 const RegistrationCodecRegistry_1 = require("./contracts/Configuration/RegistrationCodecRegistry");
 const channels_1 = require("./runtime/channels");

package/dist/runtime/actors/actor-client.d.ts

@@ -1,9 +1,12 @@
+import { RequestRuntime } from '../foundation/request-runtime';
+import type { PendingOperation } from '../foundation/operation-registry';
 import { type ActorRef, type ZLinkActorClient, type ZLinkActorRequestCall, type ZLinkActorSendCall, type ZLinkMessageSerializer } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
 import { type ZLinkBackendMeshNode, type ZLinkMeshCompletionTable } from '../backend';
 import type { ZLinkStoreLocationResolvers } from '../locations';
 import type { ZLinkActorRoutedJoinTransport } from './actor-routed-join-transport';
 export interface ZLinkActorClientOptions {
+    readonly requests?: RequestRuntime;
     readonly nodeProvider: (meshName: string) => ZLinkBackendMeshNode | undefined;
     readonly completionTableProvider: (meshName: string) => ZLinkMeshCompletionTable | undefined;
     readonly locationResolver: () => ZLinkStoreLocationResolvers | undefined;
@@ -11,7 +14,7 @@ export interface ZLinkActorClientOptions {
     readonly defaultRequestTimeoutMs?: number;
     readonly staleActorRefReporter?: (meshName: string, actorId: string) => void;
     readonly staleActorRefPredicate?: (meshName: string, actor: ActorRef) => boolean;
-    readonly handoffCapture?: (meshName: string, actorId: string, parts: readonly Message[], returnResponse: boolean, actor: ActorRef, deadlineUnixMs?: number, onAdmitted?: () => void) => Promise<unknown> | undefined;
+    readonly handoffCapture?: (meshName: string, actorId: string, parts: readonly Message[], returnResponse: boolean, actor: ActorRef, deadlineUnixMs?: number, onAdmitted?: () => void, requestOperation?: PendingOperation<unknown>) => Promise<unknown> | undefined;
     readonly sendErrorReporter?: (error: unknown) => void;
     readonly routeTransport?: ZLinkActorRoutedJoinTransport;
     readonly transportDeliveryGate?: () => {
@@ -20,13 +23,14 @@ export interface ZLinkActorClientOptions {
 }
 export declare class DefaultZLinkActorClient implements ZLinkActorClient {
     private readonly options;
+    private readonly requests;
     constructor(options: ZLinkActorClientOptions);
     sendToActor(actorId: string, message: unknown): ZLinkActorSendCall;
     requestToActor(actorId: string, request: unknown): ZLinkActorRequestCall;
     private send;
     private request;
     private resolveActorRoute;
-    private invalidateActorRoute;
+    private mapActorFailure;
     private throwIfKnownStale;
     private createPacketParts;
     private submitActorSend;