@zlink-systems/framework 0.29.1 → 0.30.1

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

@@ -1,4 +1,5 @@
 import type { ActorId } from '../Common';
+import type { ZLinkRequest } from '../Handlers/Attributes';
 export interface ZLinkActorClient {
     sendToActor(actorId: ActorId, message: unknown): ZLinkActorSendCall;
     requestToActor(actorId: ActorId, request: unknown): ZLinkActorRequestCall;
@@ -10,6 +11,6 @@ export interface ZLinkActorSendCall {
 export interface ZLinkActorRequestCall {
     metadata(key: string, value: string): this;
     timeout(timeoutMs: number): this;
-    submit<TReply>(signal?: AbortSignal): Promise<TReply>;
+    submit<TReply>(signal?: AbortSignal): ZLinkRequest<TReply>;
     yield<TReply>(signal?: AbortSignal): Promise<TReply>;
 }

package/dist/contracts/Channels/Calls.d.ts

@@ -1,4 +1,5 @@
 import type { ZLinkMessageMetadata } from '../Common';
+import type { ZLinkRequest } from '../Handlers/Attributes';
 export interface ZLinkSendCall {
     metadata(key: string, value: string): this;
     metadata(metadata: ZLinkMessageMetadata): this;
@@ -8,7 +9,7 @@ export interface ZLinkRequestCall {
     metadata(key: string, value: string): this;
     metadata(metadata: ZLinkMessageMetadata): this;
     timeout(timeoutMs: number): this;
-    submit<TReply>(signal?: AbortSignal): Promise<TReply>;
+    submit<TReply>(signal?: AbortSignal): ZLinkRequest<TReply>;
 }
 export interface ZLinkChannelRequestCall extends ZLinkRequestCall {
     yield<TReply>(signal?: AbortSignal): Promise<TReply>;

package/dist/contracts/Common/ZLinkMessageMetadata.js

@@ -4,7 +4,7 @@ exports.ZLinkMessageMetadataEmpty = void 0;
 exports.zlinkMessageMetadata = zlinkMessageMetadata;
 class ImmutableZLinkMessageMetadata {
     values;
-    constructor(values = new Map()) {
+    constructor(values = []) {
         this.values = Object.freeze(new ImmutableMetadataMap(values));
     }
     find(key) {
@@ -14,9 +14,7 @@ class ImmutableZLinkMessageMetadata {
 class ImmutableMetadataMap {
     #values;
     constructor(values) {
-        this.#values = new Map(typeof values[Symbol.iterator] === 'function'
-            ? values
-            : Object.entries(values));
+        this.#values = new Map(values);
     }
     get size() {
         return this.#values.size;
@@ -45,5 +43,13 @@ class ImmutableMetadataMap {
 }
 exports.ZLinkMessageMetadataEmpty = Object.freeze(new ImmutableZLinkMessageMetadata());
 function zlinkMessageMetadata(values) {
-    return Object.freeze(new ImmutableZLinkMessageMetadata(values));
+    const entries = typeof values[Symbol.iterator] === 'function'
+        ? values
+        : Object.entries(values);
+    const size = Array.isArray(entries)
+        ? entries.length
+        : entries.size;
+    return size === 0
+        ? exports.ZLinkMessageMetadataEmpty
+        : Object.freeze(new ImmutableZLinkMessageMetadata(entries));
 }

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

@@ -7,7 +7,6 @@ import type { ZLinkDispatchOptionsBuilder, ZLinkInboundDispatchOptions } from '.
 import type { ZLinkLocationOptions, ZLinkLocationStore, ZLinkRelocationStore } from '../Locations';
 import type { RoutingId, Type } from '../Common';
 import type { ZLinkWorkerOptions } from './RegistrationTypes';
-import type { ZLinkSpotPublisherConfig } from './Configs';
 import type { ZLinkActorFactoryBuilder, ZLinkInstanceSpotFactoryBuilder, ZLinkUserSpotFactoryBuilder } from './ObjectRoles';
 import type { ZLinkRequestHandler, ZLinkRouteRequestHandler, ZLinkRouteSendHandler, ZLinkSendHandler } from '../Handlers';
 export interface ZLinkFrameworkOptions {
@@ -96,7 +95,6 @@ export interface ZLinkMeshNodeBuilder {
     setActivationConcurrency(limit: number): this;
     setInstanceSpotIdleTimeout(timeoutMs: number): this;
     configureRouterSocket(): ZLinkMeshNodeSocketConfig;
-    configureSpotPublisher(): ZLinkSpotPublisherConfig;
     peerConnections(): ZLinkMeshPeerConnections;
     setDefaultRequestTimeout(timeoutMs: number): this;
     objects(): ZLinkMeshObjectRoleBuilder;
@@ -136,6 +134,7 @@ export interface ZLinkFanoutChannelBuilder {
     routingId(routingId: string): this;
     setRoutingIdPrefix(prefix: string): this;
     setNoDrop(noDrop?: boolean): this;
+    setSendTimeout(timeoutMs: number): this;
     enableSubscriber(): this;
     subscribe(topic: string): this;
     connect(endpoint: string): this;

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

@@ -16,8 +16,3 @@ export interface ZLinkOutboundRouteConfig {
     targetNodeRid: RoutingId;
     endpoint: string;
 }
-export interface ZLinkSpotPublisherConfig {
-    sendHighWaterMark: number;
-    sendTimeoutMs?: number;
-    lingerMs?: number;
-}

package/dist/contracts/Configuration/RegistrationBuilders.js

@@ -10,6 +10,7 @@ const ConfigurationException_1 = require("./ConfigurationException");
 const DiagnosticsValidation_1 = require("./DiagnosticsValidation");
 const EndpointNotation_1 = require("./EndpointNotation");
 const FanoutTopic_1 = require("./FanoutTopic");
+const SendTimeoutValidation_1 = require("./SendTimeoutValidation");
 const InternalDefaults_1 = require("./InternalDefaults");
 const ObjectRoles_1 = require("./ObjectRoles");
 const RegistrationBuilderPolicy_1 = require("./RegistrationBuilderPolicy");
@@ -374,6 +375,11 @@ class DefaultFanoutChannelBuilder {
         this.channel.noDrop = noDrop;
         return this;
     }
+    setSendTimeout(timeoutMs) {
+        (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`Fanout channel '${this.name}' send timeout`, timeoutMs);
+        this.channel.sendTimeoutMs = timeoutMs;
+        return this;
+    }
     enableSubscriber(endpoint) {
         this.selectSubscriberMode(endpoint === undefined ? 'automatic' : 'manual');
         this.channel.subscriber ??= { manualConnections: [] };
@@ -758,10 +764,6 @@ class DefaultMeshNodeBuilder {
         this.node.router ??= {};
         return this.node.router;
     }
-    configureSpotPublisher() {
-        this.node.publisherConfig ??= {};
-        return this.node.publisherConfig;
-    }
     peerConnections() {
         this.node.router ??= {};
         return new DefaultMeshPeerConnections(this.node.router);

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

@@ -139,6 +139,7 @@ export interface ZLinkChannelOptions {
     readonly routingId?: string;
     readonly routingIdPrefix?: string;
     readonly noDrop?: boolean;
+    readonly sendTimeoutMs?: number;
     readonly requestTimeoutMs?: number;
     readonly client?: ZLinkClientCapabilityOptions;
     readonly publisher?: ZLinkPublisherCapabilityOptions;
@@ -167,7 +168,6 @@ export interface ZLinkClientCapabilityOptions {
     readonly maxMessageSize?: number;
 }
 export interface ZLinkPublisherCapabilityOptions {
-    readonly sendTimeoutMs?: number;
     readonly bind?: string;
     readonly bindHost?: string;
     readonly advertiseHost?: string;
@@ -243,11 +243,6 @@ export interface ZLinkSpotNodeOptions {
     readonly routeSendHandlers?: readonly ZLinkRouteMeshSendHandlerRegistration[];
     readonly routeRequestHandlers?: readonly ZLinkRouteMeshRequestHandlerRegistration[];
     readonly requestTimeoutMs?: number;
-    readonly publisherConfig?: {
-        readonly sendHighWaterMark?: number;
-        readonly sendTimeoutMs?: number;
-        readonly lingerMs?: number;
-    };
     readonly entrySpotTimerHandlers?: readonly ZLinkEntrySpotTimerHandlerRegistration[];
     readonly entrySpotPacketHandlers?: readonly ZLinkEntrySpotPacketHandlerRegistration[];
     readonly entrySpotSubscriptionHandlers?: readonly ZLinkEntrySpotSubscriptionHandlerRegistration[];

package/dist/contracts/Configuration/RegistrationValidators.js

@@ -155,8 +155,9 @@ function validateChannelCapabilities(channels, peerLocationConfigured) {
         if (channel.noDrop !== undefined && typeof channel.noDrop !== 'boolean') {
             throw new ConfigurationException_1.ZLinkConfigurationException(`Channel '${channelName}' NoDrop must be a boolean.`);
         }
-        if (channel.noDrop !== undefined && channel.publisher === undefined) {
-            throw new ConfigurationException_1.ZLinkConfigurationException(`Channel '${channelName}' NoDrop requires a publisher role.`);
+        if ((channel.noDrop !== undefined || channel.sendTimeoutMs !== undefined) &&
+            channel.publisher === undefined) {
+            throw new ConfigurationException_1.ZLinkConfigurationException(`Channel '${channelName}': NoDrop and send timeout require the publisher role.`);
         }
         if (channel.server !== undefined) {
             requireEndpoint(`channel '${channelName}' server`, channel.server.bind);
@@ -167,8 +168,8 @@ function validateChannelCapabilities(channels, peerLocationConfigured) {
             requirePeerWeight(`channel '${channelName}' server weight`, channel.server.weight);
             requireSocketOptions(`channel '${channelName}' server`, channel.server);
         }
+        (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`channel '${channelName}' publisher sendTimeoutMs`, channel.sendTimeoutMs);
         if (channel.publisher !== undefined) {
-            (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`channel '${channelName}' publisher sendTimeoutMs`, channel.publisher.sendTimeoutMs);
             requireEndpoint(`channel '${channelName}' publisher`, channel.publisher.bind);
             validateListenerNetworkIdentity(`channel '${channelName}' publisher`, channel.publisher.bindHost, channel.publisher.advertiseHost);
             validateFanoutPublisherIdentity(channelName, channel.routingId, channel.routingIdPrefix, peerLocationConfigured);
@@ -220,7 +221,6 @@ function validateSpotNodes(registration) {
         }
         validateSpotNodeCapability(`SpotNode '${spotNodeName}' pubSub`, spotNode.pubSub);
         requireNonNegativeSafeInteger(`SpotNode '${spotNodeName}' instanceSpotIdleTimeoutMs`, spotNode.instanceSpotIdleTimeoutMs);
-        (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`SpotNode '${spotNodeName}' publisher sendTimeoutMs`, spotNode.publisherConfig?.sendTimeoutMs);
         validateSpotNodeFactories(spotNodeName, spotNode);
         validateSpotNodeTimers(spotNode);
         if (spotNode.objectRole === 'client' &&

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

@@ -1,5 +1,5 @@
 export type { ZLinkClientServerChannelClientBuilder, ZLinkClientServerChannelRoleBuilder, ZLinkClientServerChannelServerBuilder, ZLinkFanoutChannelBuilder, ZLinkFrameworkOptions, ZLinkMeshChannelBuilder, ZLinkMeshChannelClientBuilder, ZLinkMeshChannelServerBuilder, ZLinkMeshObjectClientBuilder, ZLinkMeshObjectRoleBuilder, ZLinkMeshObjectServerBuilder, ZLinkMeshNodeBuilder, ZLinkMeshNodeSocketConfig, ZLinkMeshPeerConnection, ZLinkMeshPeerConnections, ZLinkNetworkOptions, ZLinkMetadataPolicyBuilder, ZLinkStreamCompressionBuilder, ZLinkStreamSocketConfig, ZLinkStreamNodeBuilder } from './Builders';
-export type { ZLinkOutboundRouteConfig, ZLinkRouteConfig, ZLinkSocketConfig, ZLinkSpotPublisherConfig } from './Configs';
+export type { ZLinkOutboundRouteConfig, ZLinkRouteConfig, ZLinkSocketConfig } from './Configs';
 export * from './Connections';
 export * from './ObjectRoles';
 export type { ZLinkApplicationJobQueueOptions, ZLinkCoreHwmOptions, ZLinkWorkerOptions } from './RegistrationTypes';

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

@@ -1,16 +1,9 @@
-import { type ZLinkPacketJsonContract } from './JsonContract';
-export declare const ZLINK_DECORATOR_METADATA: unique symbol;
-export interface ZLinkDecoratorMetadata {
-    readonly kind: string;
-    readonly packetName?: string;
-    readonly groupName?: string;
-    readonly methodName?: string;
-    readonly meshName?: string;
-    readonly channelName?: string;
-    readonly topic?: string;
-    readonly jsonContract?: ZLinkPacketJsonContract;
-}
+export { ZLINK_DECORATOR_METADATA, readZLinkDecoratorMetadata } from '@zlink-systems/stream-wire/internal/json';
+export type { ZLinkDecoratorMetadata } from '@zlink-systems/stream-wire/internal/json';
 export declare function ZLinkHandlerGroup(groupName: string): ClassDecorator;
+export interface ZLinkRequest<TReply> extends Promise<TReply> {
+    readonly admitted: Promise<void>;
+}
 export declare function ZLinkRequest(packetName?: string): MethodDecorator;
 export declare function ZLinkSend(packetName?: string): MethodDecorator;
 export declare function ZLinkPublish(packetName?: string): MethodDecorator;
@@ -21,4 +14,3 @@ export declare function ZLinkSpotActorSend(packetName?: string): MethodDecorator
 export declare function ZLinkSpotActorRequest(packetName?: string): MethodDecorator;
 export declare function ZLinkStreamPacket(): MethodDecorator;
 export declare function ZLinkStreamRaw(): MethodDecorator;
-export declare function readZLinkDecoratorMetadata(target: object): readonly ZLinkDecoratorMetadata[];

package/dist/contracts/Handlers/Attributes.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZLINK_DECORATOR_METADATA = void 0;
+exports.readZLinkDecoratorMetadata = exports.ZLINK_DECORATOR_METADATA = void 0;
 exports.ZLinkHandlerGroup = ZLinkHandlerGroup;
 exports.ZLinkRequest = ZLinkRequest;
 exports.ZLinkSend = ZLinkSend;
@@ -13,9 +13,11 @@ exports.ZLinkSpotActorSend = ZLinkSpotActorSend;
 exports.ZLinkSpotActorRequest = ZLinkSpotActorRequest;
 exports.ZLinkStreamPacket = ZLinkStreamPacket;
 exports.ZLinkStreamRaw = ZLinkStreamRaw;
-exports.readZLinkDecoratorMetadata = readZLinkDecoratorMetadata;
 const JsonContract_1 = require("./JsonContract");
-exports.ZLINK_DECORATOR_METADATA = Symbol.for('@zlink-systems/framework:decorator');
+const json_1 = require("@zlink-systems/stream-wire/internal/json");
+var json_2 = require("@zlink-systems/stream-wire/internal/json");
+Object.defineProperty(exports, "ZLINK_DECORATOR_METADATA", { enumerable: true, get: function () { return json_2.ZLINK_DECORATOR_METADATA; } });
+Object.defineProperty(exports, "readZLinkDecoratorMetadata", { enumerable: true, get: function () { return json_2.readZLinkDecoratorMetadata; } });
 function ZLinkHandlerGroup(groupName) {
     return classDecorator({ kind: 'handlerGroup', groupName });
 }
@@ -68,17 +70,11 @@ function methodDecorator(metadata) {
     });
 }
 function appendMetadata(target, metadata) {
-    const current = readZLinkDecoratorMetadata(target);
-    Object.defineProperty(target, exports.ZLINK_DECORATOR_METADATA, {
+    const current = (0, json_1.readZLinkDecoratorMetadata)(target);
+    Object.defineProperty(target, json_1.ZLINK_DECORATOR_METADATA, {
         configurable: true,
         enumerable: false,
         value: [...current, metadata],
         writable: false
     });
 }
-function readZLinkDecoratorMetadata(target) {
-    if (!Object.prototype.hasOwnProperty.call(target, exports.ZLINK_DECORATOR_METADATA)) {
-        return [];
-    }
-    return target[exports.ZLINK_DECORATOR_METADATA];
-}

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

@@ -1,46 +1,2 @@
-/** Describes the fields accepted by the default framework-json-v1 serializer. */
-export type ZLinkJsonSchema = {
-    readonly type: 'boolean';
-} | {
-    readonly type: 'string';
-} | {
-    readonly type: 'number';
-} | {
-    readonly type: 'int32';
-} | {
-    readonly type: 'uint32';
-} | {
-    readonly type: 'int64';
-} | {
-    readonly type: 'uint64';
-} | {
-    readonly type: 'bytes';
-} | {
-    readonly type: 'enum';
-    readonly names: readonly string[];
-} | {
-    readonly type: 'nullable';
-    readonly value: ZLinkJsonSchema;
-} | {
-    readonly type: 'array';
-    readonly items: ZLinkJsonSchema;
-} | {
-    readonly type: 'record';
-    readonly values: ZLinkJsonSchema;
-} | {
-    readonly type: 'object';
-    readonly properties: Readonly<Record<string, ZLinkJsonSchema>>;
-    readonly required: readonly string[];
-    /** Unknown properties are ignored during decoding unless this is false. */
-    readonly additionalProperties?: boolean;
-};
-/**
- * Describes the request and optional reply fields carried under one packet
- * name by the default JSON serializer.
- */
-export interface ZLinkPacketJsonContract {
-    readonly payload: ZLinkJsonSchema;
-    readonly reply?: ZLinkJsonSchema;
-}
-export declare function defineZLinkPacketJsonContract(packetName: string, contract: ZLinkPacketJsonContract): ZLinkPacketJsonContract;
-export declare function readZLinkPacketJsonContract(packetName: string): ZLinkPacketJsonContract | undefined;
+export { defineZLinkPacketJsonContract, readZLinkPacketJsonContract } from '@zlink-systems/stream-wire/internal/json';
+export type { ZLinkJsonSchema, ZLinkPacketJsonContract } from '@zlink-systems/stream-wire/internal/json';

package/dist/contracts/Handlers/JsonContract.js

@@ -1,155 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineZLinkPacketJsonContract = defineZLinkPacketJsonContract;
-exports.readZLinkPacketJsonContract = readZLinkPacketJsonContract;
-const MAX_CONTRACT_SCHEMA_DEPTH = 64;
-const ZLINK_PACKET_JSON_CONTRACTS = Symbol.for('@zlink-systems/framework:packet-json-contracts');
-function defineZLinkPacketJsonContract(packetName, contract) {
-    if (packetName.trim().length === 0) {
-        throw new TypeError('ZLink packet name must not be empty.');
-    }
-    const runtimeContract = contract;
-    if (typeof runtimeContract !== 'object' || runtimeContract === null) {
-        throw new TypeError('ZLink packet JSON contract must be an object.');
-    }
-    const normalizedContract = runtimeContract;
-    const normalized = Object.freeze({
-        payload: normalizeJsonSchema(normalizedContract.payload, new Set(), 0),
-        ...(normalizedContract.reply === undefined
-            ? {}
-            : { reply: normalizeJsonSchema(normalizedContract.reply, new Set(), 0) })
-    });
-    const contracts = packetJsonContracts();
-    const current = contracts.get(packetName);
-    if (current !== undefined && canonicalContract(current) !== canonicalContract(normalized)) {
-        throw new TypeError(`ZLink packet '${packetName}' has conflicting JSON contracts in one process.`);
-    }
-    if (current !== undefined)
-        return current;
-    contracts.set(packetName, normalized);
-    return normalized;
-}
-function readZLinkPacketJsonContract(packetName) {
-    return packetJsonContracts().get(packetName);
-}
-function normalizeJsonSchema(schema, parents, depth) {
-    // Keep the runtime boundary defensive for JavaScript callers even though
-    // the TypeScript signature describes the accepted shape.
-    const runtimeSchema = schema;
-    if (typeof runtimeSchema !== 'object' ||
-        runtimeSchema === null ||
-        depth > MAX_CONTRACT_SCHEMA_DEPTH) {
-        throw new TypeError(`ZLink packet JSON schema must be an acyclic object with at most ${MAX_CONTRACT_SCHEMA_DEPTH} levels.`);
-    }
-    const normalizedSchema = runtimeSchema;
-    if (parents.has(normalizedSchema))
-        throw new TypeError('ZLink packet JSON schema must not contain a cycle.');
-    const nextParents = new Set(parents).add(normalizedSchema);
-    switch (normalizedSchema.type) {
-        case 'boolean':
-        case 'string':
-        case 'number':
-        case 'int32':
-        case 'uint32':
-        case 'int64':
-        case 'uint64':
-        case 'bytes':
-            return Object.freeze({ type: normalizedSchema.type });
-        case 'enum': {
-            if (!Array.isArray(normalizedSchema.names) ||
-                normalizedSchema.names.length === 0 ||
-                normalizedSchema.names.some((name) => typeof name !== 'string' || name.length === 0)) {
-                throw new TypeError('ZLink packet enum schema requires non-empty string names.');
-            }
-            if (new Set(normalizedSchema.names).size !== normalizedSchema.names.length) {
-                throw new TypeError('ZLink packet enum schema names must be unique.');
-            }
-            return Object.freeze({ type: 'enum', names: Object.freeze([...normalizedSchema.names]) });
-        }
-        case 'nullable':
-            return Object.freeze({
-                type: 'nullable',
-                value: normalizeJsonSchema(normalizedSchema.value, nextParents, depth + 1)
-            });
-        case 'array':
-            return Object.freeze({
-                type: 'array',
-                items: normalizeJsonSchema(normalizedSchema.items, nextParents, depth + 1)
-            });
-        case 'record':
-            return Object.freeze({
-                type: 'record',
-                values: normalizeJsonSchema(normalizedSchema.values, nextParents, depth + 1)
-            });
-        case 'object': {
-            const runtimeProperties = normalizedSchema.properties;
-            if (typeof runtimeProperties !== 'object' ||
-                runtimeProperties === null ||
-                Array.isArray(runtimeProperties)) {
-                throw new TypeError('ZLink packet object schema properties must be an object.');
-            }
-            if (!Array.isArray(normalizedSchema.required) ||
-                normalizedSchema.required.some((name) => typeof name !== 'string' || name.length === 0)) {
-                throw new TypeError('ZLink packet object schema required must contain property names.');
-            }
-            if (normalizedSchema.additionalProperties !== undefined &&
-                typeof normalizedSchema.additionalProperties !== 'boolean') {
-                throw new TypeError('ZLink packet object schema additionalProperties must be boolean.');
-            }
-            const properties = {};
-            for (const [name, property] of Object.entries(runtimeProperties)) {
-                if (isPrototypeKey(name)) {
-                    throw new TypeError(`ZLink packet JSON property '${name}' is not allowed.`);
-                }
-                properties[name] = normalizeJsonSchema(property, nextParents, depth + 1);
-            }
-            if (new Set(normalizedSchema.required).size !== normalizedSchema.required.length) {
-                throw new TypeError('ZLink packet JSON required properties must be unique.');
-            }
-            for (const name of normalizedSchema.required) {
-                if (isPrototypeKey(name)) {
-                    throw new TypeError(`ZLink packet JSON property '${name}' is not allowed.`);
-                }
-                if (!Object.prototype.hasOwnProperty.call(properties, name)) {
-                    throw new TypeError(`ZLink packet JSON required property '${name}' has no property schema.`);
-                }
-            }
-            return Object.freeze({
-                type: 'object',
-                properties: Object.freeze(properties),
-                required: Object.freeze([...normalizedSchema.required]),
-                ...(normalizedSchema.additionalProperties === undefined
-                    ? {}
-                    : { additionalProperties: normalizedSchema.additionalProperties })
-            });
-        }
-    }
-    throw new TypeError(`ZLink packet JSON schema type '${String(normalizedSchema.type)}' is not supported.`);
-}
-function packetJsonContracts() {
-    const root = globalThis;
-    let contracts = root[ZLINK_PACKET_JSON_CONTRACTS];
-    if (contracts === undefined) {
-        contracts = new Map();
-        Object.defineProperty(root, ZLINK_PACKET_JSON_CONTRACTS, {
-            configurable: false,
-            enumerable: false,
-            value: contracts,
-            writable: false
-        });
-    }
-    return contracts;
-}
-function canonicalContract(value) {
-    if (Array.isArray(value))
-        return `[${value.map(canonicalContract).join(',')}]`;
-    if (typeof value !== 'object' || value === null)
-        return JSON.stringify(value);
-    return `{${Object.entries(value)
-        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
-        .map(([key, item]) => `${JSON.stringify(key)}:${canonicalContract(item)}`)
-        .join(',')}}`;
-}
-function isPrototypeKey(name) {
-    return name === '__proto__' || name === 'prototype' || name === 'constructor';
-}
+exports.readZLinkPacketJsonContract = exports.defineZLinkPacketJsonContract = void 0;
+var json_1 = require("@zlink-systems/stream-wire/internal/json");
+Object.defineProperty(exports, "defineZLinkPacketJsonContract", { enumerable: true, get: function () { return json_1.defineZLinkPacketJsonContract; } });
+Object.defineProperty(exports, "readZLinkPacketJsonContract", { enumerable: true, get: function () { return json_1.readZLinkPacketJsonContract; } });

package/dist/contracts/Spots/Contracts.d.ts

@@ -2,6 +2,7 @@ import type { ZLinkActor } from '../Actors';
 import type { ZLinkChannelRequestCall, ZLinkPublishCall, ZLinkSendCall } from '../Channels';
 import type { RoutingId, SpotId, Type, ZLinkMessageMetadata } from '../Common';
 import type { ZLinkSpotTimerHandler } from '../Handlers';
+import type { ZLinkRequest } from '../Handlers/Attributes';
 import type { ZLinkTimer, ZLinkTimerOptions } from '../Timers';
 import type { ZLinkEntrySpot, ZLinkInstanceSpot, ZLinkSpot, ZLinkSpotRelocationReadyCall } from './ZLinkSpot';
 export interface ZLinkActorHandlerRegistry {
@@ -77,7 +78,7 @@ export interface ZLinkSpotRequestCall {
     instanceSpot(instanceSpotType: string): this;
     inMesh(meshName: string): this;
     timeout(timeoutMs: number): this;
-    submit<TReply>(signal?: AbortSignal): Promise<TReply>;
+    submit<TReply>(signal?: AbortSignal): ZLinkRequest<TReply>;
     yield<TReply>(signal?: AbortSignal): Promise<TReply>;
 }
 export declare enum ZLinkSpotCreateState {

package/dist/internal.d.ts

@@ -1,5 +1,6 @@
 /** Test and companion-package integration surface. It is not exported by package.json. */
 export * from './index';
+export { requireValidSendTimeoutMs } from './contracts/Configuration/SendTimeoutValidation';
 export * from './runtime/diagnostics';
 export * from './runtime/host';
 export * from './runtime/admission';

package/dist/internal.js

@@ -14,9 +14,11 @@ 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 = 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.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = 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);
 __exportStar(require("./runtime/admission"), exports);

package/dist/nest-integration.d.ts

@@ -11,7 +11,7 @@ import type { ZLinkFrameworkRegistration } from './contracts/Configuration/Regis
 import type { ZLinkCodecSerializerRegistration, ZLinkFrameworkRegistrationOptions, ZLinkStreamCodecRegistration } from './contracts/Configuration/RegistrationTypes';
 import { captureZLinkExecutionTurn } from './runtime/execution';
 export { registerHandlerFilterScope as registerIntegrationHandlerFilterScope, type ZLinkHandlerFilterScopeRunner } from './runtime/channels/handler-filter-scope';
-export { disposeOwnedInstance as disposeIntegrationHandler, disposeOwnedInstances as disposeIntegrationHandlers } from './runtime/handlers/handler-instance-scope';
+export { registerHandlerInstanceScopeFactory as registerIntegrationHandlerInstanceScopeFactory, disposeOwnedInstance as disposeIntegrationHandler, disposeOwnedInstances as disposeIntegrationHandlers } from './runtime/handlers/handler-instance-scope';
 export interface ZLinkNestIntegrationRuntimeHost extends Pick<import('./contracts').ZLinkFrameworkRuntime, 'shutdown'> {
     readonly channelRuntimeOptions: unknown;
     readonly routeMeshRuntimeOptions: ZLinkRouteMeshRuntimeOptions;

package/dist/nest-integration.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.disposeIntegrationHandlers = exports.disposeIntegrationHandler = 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.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;
@@ -46,6 +46,7 @@ const execution_1 = require("./runtime/execution");
 var handler_filter_scope_1 = require("./runtime/channels/handler-filter-scope");
 Object.defineProperty(exports, "registerIntegrationHandlerFilterScope", { enumerable: true, get: function () { return handler_filter_scope_1.registerHandlerFilterScope; } });
 var handler_instance_scope_1 = require("./runtime/handlers/handler-instance-scope");
+Object.defineProperty(exports, "registerIntegrationHandlerInstanceScopeFactory", { enumerable: true, get: function () { return handler_instance_scope_1.registerHandlerInstanceScopeFactory; } });
 Object.defineProperty(exports, "disposeIntegrationHandler", { enumerable: true, get: function () { return handler_instance_scope_1.disposeOwnedInstance; } });
 Object.defineProperty(exports, "disposeIntegrationHandlers", { enumerable: true, get: function () { return handler_instance_scope_1.disposeOwnedInstances; } });
 function createIntegrationDispatchOptionsBuilder(dispatch) {

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

@@ -11,7 +11,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) => Promise<unknown> | undefined;
+    readonly handoffCapture?: (meshName: string, actorId: string, parts: readonly Message[], returnResponse: boolean, actor: ActorRef, deadlineUnixMs?: number, onAdmitted?: () => void) => Promise<unknown> | undefined;
     readonly sendErrorReporter?: (error: unknown) => void;
     readonly routeTransport?: ZLinkActorRoutedJoinTransport;
     readonly transportDeliveryGate?: () => {