@zlink-systems/framework 0.26.0 → 0.28.0

package/dist/contracts/Configuration/RegistrationValidators.js

@@ -1,13 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateFrameworkRegistration = validateFrameworkRegistration;
+const Locations_1 = require("../Locations");
 const ConfigurationException_1 = require("./ConfigurationException");
+const FanoutTopic_1 = require("./FanoutTopic");
+const InternalDefaults_1 = require("./InternalDefaults");
+const RegistrationBuilderPolicy_1 = require("./RegistrationBuilderPolicy");
 const RegistrationNormalizers_1 = require("./RegistrationNormalizers");
 const RouteChannelInternalState_1 = require("./RouteChannelInternalState");
-const TimerRegistrationValidator_1 = require("./TimerRegistrationValidator");
-const Locations_1 = require("../Locations");
 const SendTimeoutValidation_1 = require("./SendTimeoutValidation");
-const FanoutTopic_1 = require("./FanoutTopic");
+const TimerRegistrationValidator_1 = require("./TimerRegistrationValidator");
+const ROUTE_CACHE_FOLLOW_MARGIN_MS = 5000;
 function validateFrameworkRegistration(registration, _options = {}) {
     validateListenerNetworkIdentity('process network', registration.network.bindHost, registration.network.advertiseHost);
     const actorCapableSpotNodes = [...registration.spotNodes.values()].filter((spotNode) => toActorFactoryCount(spotNode.actorFactories) > 0);
@@ -88,9 +91,10 @@ function validateLocationRegistration(registration) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`${name} must be a finite positive number.`);
         }
     }
-    if (options.ownerLeaseRenewIntervalMs + options.ownerLeaseRenewTimeoutMs >=
+    if (Math.max(options.ownerLeaseRenewIntervalMs, options.ownerLeaseRenewTimeoutMs) +
+        options.ownerLeaseRenewTimeoutMs >=
         options.ownerLeaseTtlMs - options.ownerLeaseFencingMarginMs) {
-        throw new ConfigurationException_1.ZLinkConfigurationException('ownerLeaseRenewIntervalMs + ownerLeaseRenewTimeoutMs must be less than ownerLeaseTtlMs - ownerLeaseFencingMarginMs.');
+        throw new ConfigurationException_1.ZLinkConfigurationException('max(ownerLeaseRenewIntervalMs, ownerLeaseRenewTimeoutMs) + ownerLeaseRenewTimeoutMs must be less than ownerLeaseTtlMs - ownerLeaseFencingMarginMs.');
     }
     for (const [name, value] of Object.entries({
         relocationCutoverWaitTimeoutMs: options.relocationCutoverWaitTimeoutMs,
@@ -100,8 +104,8 @@ function validateLocationRegistration(registration) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`${name} must be a positive integer.`);
         }
     }
-    if (options.relocationPayloadChunkLimitBytes > 67_108_864) {
-        throw new ConfigurationException_1.ZLinkConfigurationException('relocationPayloadChunkLimitBytes must not exceed the 64 MiB wire chunk bound.');
+    if (options.relocationPayloadChunkLimitBytes > InternalDefaults_1.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`relocationPayloadChunkLimitBytes must not exceed the ${InternalDefaults_1.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES / (1024 * 1024)} MiB wire chunk bound.`);
     }
     for (const [name, value] of Object.entries({
         relocationInFlightPayloadBudgetBytes: options.relocationInFlightPayloadBudgetBytes,
@@ -121,8 +125,8 @@ function validateLocationRegistration(registration) {
     }
     if (options.routeCacheMaxAgeMs > 0 &&
         options.messageFollowDurationMs > 0 &&
-        options.routeCacheMaxAgeMs > options.messageFollowDurationMs - 5000) {
-        throw new ConfigurationException_1.ZLinkConfigurationException('routeCacheMaxAgeMs must be at least 5000 ms shorter than messageFollowDurationMs.');
+        options.routeCacheMaxAgeMs > options.messageFollowDurationMs - ROUTE_CACHE_FOLLOW_MARGIN_MS) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`routeCacheMaxAgeMs must be at least ${ROUTE_CACHE_FOLLOW_MARGIN_MS} ms shorter than messageFollowDurationMs.`);
     }
 }
 function requireNonNegativeInteger(label, value) {
@@ -164,6 +168,7 @@ function validateChannelCapabilities(channels, peerLocationConfigured) {
             requireSocketOptions(`channel '${channelName}' server`, channel.server);
         }
         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);
@@ -446,18 +451,14 @@ function requirePeerWeight(label, value) {
     if (value === undefined) {
         return;
     }
-    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
-        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 0..10000.`);
-    }
+    (0, RegistrationBuilderPolicy_1.requirePublicWeight)(value, label);
 }
 function requireSocketOptions(label, options) {
     requireNonNegativeInteger(`${label} sendHighWaterMark`, options.sendHighWaterMark);
     requireNonNegativeInteger(`${label} receiveHighWaterMark`, options.receiveHighWaterMark);
     requireNonNegativeInteger(`${label} maxMessageSize`, options.maxMessageSize);
-    (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`${label} sendTimeoutMs`, options.sendTimeoutMs);
 }
 function requireRouteMeshSocketOptions(label, options) {
     requireNonNegativeInteger(`${label} sendHighWaterMark`, options.sendHighWaterMark);
     requireNonNegativeInteger(`${label} receiveHighWaterMark`, options.receiveHighWaterMark);
-    (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`${label} sendTimeoutMs`, options.sendTimeoutMs);
 }

package/dist/contracts/Configuration/TimerRegistrationValidator.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateTimerRegistration = validateTimerRegistration;
 const Timers_1 = require("../Timers");
 const ConfigurationException_1 = require("./ConfigurationException");
+const MAX_TIMER_CATCH_UP_TICKS = 2_147_483_647;
 function validateTimerRegistration(name, periodMs, options) {
     if (name.trim().length === 0) {
         throw new ConfigurationException_1.ZLinkConfigurationException('SPOT timer name must not be empty.');
@@ -18,7 +19,7 @@ function validateTimerRegistration(name, periodMs, options) {
         (options.maxCatchUpTicks === undefined ||
             !Number.isInteger(options.maxCatchUpTicks) ||
             options.maxCatchUpTicks < 1 ||
-            options.maxCatchUpTicks > 2_147_483_647)) {
-        throw new ConfigurationException_1.ZLinkConfigurationException('SPOT timer MaxCatchUpTicks must be an integer from 1 through 2,147,483,647.');
+            options.maxCatchUpTicks > MAX_TIMER_CATCH_UP_TICKS)) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`SPOT timer MaxCatchUpTicks must be an integer from 1 through ${MAX_TIMER_CATCH_UP_TICKS.toLocaleString('en-US')}.`);
     }
 }

package/dist/contracts/Dispatch/ZLinkDispatchOptions.d.ts

@@ -162,7 +162,7 @@ export declare enum ZLinkDispatchMessageKind {
     ActorRequest = "actorRequest",
     ActorSend = "actorSend"
 }
-export type ZLinkDispatchErrorReason = 'no_handler' | 'decode_error' | 'handler_exception' | 'invalid_frame' | 'reply_path_missing' | 'unexpected_reply' | 'backpressure' | 'stale_target' | 'shutdown';
+export type ZLinkDispatchErrorReason = 'no_handler' | 'decode_error' | 'handler_exception' | 'invalid_frame' | 'reply_path_missing' | 'unexpected_reply' | 'backpressure' | 'target_closed' | 'stale_target' | 'shutdown';
 export type ZLinkDispatchErrorAction = 'reply_error' | 'fail_caller' | 'drop';
 export declare enum ZLinkRuntimeDispatchErrorReason {
     HandlerMissing = "no_handler",

package/dist/contracts/Handlers/JsonContract.js

@@ -2,6 +2,7 @@
 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) {
@@ -35,8 +36,10 @@ 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 > 64) {
-        throw new TypeError('ZLink packet JSON schema must be an acyclic object with at most 64 levels.');
+    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))
@@ -95,7 +98,7 @@ function normalizeJsonSchema(schema, parents, depth) {
             }
             const properties = {};
             for (const [name, property] of Object.entries(runtimeProperties)) {
-                if (name === '__proto__' || name === 'prototype' || name === 'constructor') {
+                if (isPrototypeKey(name)) {
                     throw new TypeError(`ZLink packet JSON property '${name}' is not allowed.`);
                 }
                 properties[name] = normalizeJsonSchema(property, nextParents, depth + 1);
@@ -104,7 +107,7 @@ function normalizeJsonSchema(schema, parents, depth) {
                 throw new TypeError('ZLink packet JSON required properties must be unique.');
             }
             for (const name of normalizedSchema.required) {
-                if (name === '__proto__' || name === 'prototype' || name === 'constructor') {
+                if (isPrototypeKey(name)) {
                     throw new TypeError(`ZLink packet JSON property '${name}' is not allowed.`);
                 }
                 if (!Object.prototype.hasOwnProperty.call(properties, name)) {
@@ -147,3 +150,6 @@ function canonicalContract(value) {
         .map(([key, item]) => `${JSON.stringify(key)}:${canonicalContract(item)}`)
         .join(',')}}`;
 }
+function isPrototypeKey(name) {
+    return name === '__proto__' || name === 'prototype' || name === 'constructor';
+}

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

@@ -60,7 +60,7 @@ export type ZLinkAuthorityReadResult = {
 export type ZLinkAuthorityMutation = {
     readonly kind: 'put';
     readonly payload: Uint8Array;
-    readonly generationTransition: 'preserve';
+    readonly generationTransition: 'preserve' | 'reincarnate';
 } | {
     /** Rebinds an authority retained by the same owner after lease recovery. */
     readonly kind: 'rebindOwnerLease';

package/dist/contracts/Locations/Authority.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkAuthorityScanCursor = void 0;
+const ZLINK_AUTHORITY_MAX_SCAN_CURSOR_BYTES = 4096;
 class ZLinkAuthorityScanCursor {
     encoded;
     constructor(encoded) {
@@ -8,8 +9,8 @@ class ZLinkAuthorityScanCursor {
     }
     static from(encoded) {
         const byteLength = Buffer.byteLength(encoded, 'utf8');
-        if (byteLength < 1 || byteLength > 4096) {
-            throw new RangeError('Authority scan cursor must contain 1..4096 UTF-8 bytes.');
+        if (byteLength < 1 || byteLength > ZLINK_AUTHORITY_MAX_SCAN_CURSOR_BYTES) {
+            throw new RangeError(`Authority scan cursor must contain 1..${ZLINK_AUTHORITY_MAX_SCAN_CURSOR_BYTES} UTF-8 bytes.`);
         }
         return new ZLinkAuthorityScanCursor(encoded);
     }

package/dist/contracts/Locations/Options.js

@@ -5,7 +5,7 @@ exports.zlinkRuntimeDefaultLocationOptions = {
     ownerLeaseRenewIntervalMs: 5000,
     ownerLeaseTtlMs: 15000,
     pollingIntervalMs: 1000,
-    listPageSize: 1000,
+    listPageSize: 100,
     storeFailureGraceMs: 30000,
     ownerLeaseFencingMarginMs: 5000,
     ownerLeaseRenewTimeoutMs: 3000,

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

@@ -1,3 +1,11 @@
+export declare const ZLINK_PROVIDER_MAX_PAGE_SIZE = 1000;
+export declare const ZLINK_PROVIDER_MAX_KEY_BYTES = 1024;
+export declare const ZLINK_PROVIDER_MAX_VALUE_BYTES: number;
+export declare const ZLINK_PROVIDER_MAX_VERSION_BYTES = 4096;
+export declare const ZLINK_PROVIDER_MAX_WRITE_KEYS = 2048;
+export declare const ZLINK_PROVIDER_MAX_WRITE_BYTES: number;
+export declare const ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES: number;
+export declare const ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES = 4096;
 declare const zlinkStoreKeyBrand: unique symbol;
 declare const zlinkStoreVersionBrand: unique symbol;
 declare const zlinkStoreScanCursorBrand: unique symbol;
@@ -33,6 +41,10 @@ export type ZLinkStoreCondition = {
     readonly kind: 'version';
     readonly key: ZLinkStoreKey;
     readonly expected: ZLinkStoreVersion;
+} | {
+    readonly kind: 'value';
+    readonly key: ZLinkStoreKey;
+    readonly expected: Uint8Array;
 };
 export type ZLinkStoreMutation = {
     readonly kind: 'put';

package/dist/contracts/Locations/Stores.js

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES = exports.ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES = exports.ZLINK_PROVIDER_MAX_WRITE_BYTES = exports.ZLINK_PROVIDER_MAX_WRITE_KEYS = exports.ZLINK_PROVIDER_MAX_VERSION_BYTES = exports.ZLINK_PROVIDER_MAX_VALUE_BYTES = exports.ZLINK_PROVIDER_MAX_KEY_BYTES = exports.ZLINK_PROVIDER_MAX_PAGE_SIZE = void 0;
+exports.ZLINK_PROVIDER_MAX_PAGE_SIZE = 1000;
+exports.ZLINK_PROVIDER_MAX_KEY_BYTES = 1024;
+exports.ZLINK_PROVIDER_MAX_VALUE_BYTES = 1024 * 1024;
+exports.ZLINK_PROVIDER_MAX_VERSION_BYTES = 4096;
+exports.ZLINK_PROVIDER_MAX_WRITE_KEYS = 2048;
+exports.ZLINK_PROVIDER_MAX_WRITE_BYTES = 4 * 1024 * 1024;
+exports.ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES = 4 * 1024 * 1024;
+exports.ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES = 4096;

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

@@ -22,7 +22,7 @@ export interface ZLinkWorkerCall<T> {
 export interface ZLinkSpotCommonContext<TSpot = ZLinkSpot> {
     readonly meshName: string;
     readonly spotId: SpotId;
-    readonly objectGeneration: number;
+    readonly objectGeneration: bigint;
     readonly nodeRid: RoutingId;
     readonly outbound: ZLinkSpotOutbound;
     addTimer<THandler extends ZLinkSpotTimerHandler<TSpot>>(name: string, periodMs: number, handlerType: Type<THandler>, options?: ZLinkTimerOptions, signal?: AbortSignal): Promise<ZLinkTimer>;
@@ -68,7 +68,7 @@ export interface ZLinkSpotSendCall {
     instanceSpot(): this;
     instanceSpot(instanceSpotType: string): this;
     inMesh(meshName: string): this;
-    submit(signal?: AbortSignal): Promise<void>;
+    submit(): Promise<void>;
 }
 export interface ZLinkSpotRequestCall {
     metadata(key: string, value: string): this;

package/dist/contracts/Streams/BoundSessionContracts.d.ts

@@ -4,5 +4,5 @@ export interface ZLinkBoundSession {
 }
 export interface ZLinkBoundSessionSendCall {
     metadata(key: string, value: string): this;
-    submit(signal?: AbortSignal): Promise<void>;
+    submit(): Promise<void>;
 }

package/dist/contracts/Streams/IZLinkSession.d.ts

@@ -36,10 +36,9 @@ export interface ZLinkSessionClient {
 export interface ZLinkSessionSendCall {
     metadata(key: string, value: string): this;
     compress(enabled?: boolean): this;
-    timeout(timeoutMs: number): this;
-    submit(signal?: AbortSignal): Promise<void>;
+    submit(): Promise<void>;
 }
 export interface ZLinkSessionReplyCall {
     compress(enabled?: boolean): this;
-    submit(signal?: AbortSignal): Promise<void>;
+    submit(): Promise<void>;
 }

package/dist/contracts/Streams/IZLinkSessionActor.d.ts

@@ -9,7 +9,7 @@ export interface ZLinkSessionActors {
 export interface ZLinkSessionActor {
     readonly actorId: string;
     readonly ref: ActorRef;
-    relay(payload: ZLinkMessage, signal?: AbortSignal): Promise<void>;
-    relay(dispatch: ZLinkSessionDispatchContext, payload: ZLinkMessage, signal?: AbortSignal): Promise<void>;
+    relay(payload: ZLinkMessage): Promise<void>;
+    relay(dispatch: ZLinkSessionDispatchContext, payload: ZLinkMessage): Promise<void>;
     notifyDisconnected(signal?: AbortSignal): Promise<void>;
 }

package/dist/internal.d.ts

@@ -25,3 +25,7 @@ export * from './runtime/foundation';
 export * from './runtime/foundation/service-authority-payload-codec';
 export * from './runtime/framework-errors-internal';
 export * from './contracts/Configuration/Registration';
+export * from './contracts/Locations/Stores';
+export { ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES } from './contracts/Configuration/InternalDefaults';
+export { ZLINK_MAX_STABLE_TYPE_BYTES } from './contracts/Common/CoreTypes';
+export { MAX_LISTENER_PORT, ZLINK_MAX_PUBLIC_WEIGHT, ZLINK_MAX_CAPACITY, isValidPublicWeight, isValidPositiveCapacity, isValidListenerPort, isValidCapacity, requirePublicWeight } from './contracts/Configuration/RegistrationBuilderPolicy';

package/dist/internal.js

@@ -14,7 +14,7 @@ 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.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 = void 0;
 /** Test and companion-package integration surface. It is not exported by package.json. */
 __exportStar(require("./index"), exports);
 __exportStar(require("./runtime/diagnostics"), exports);
@@ -47,3 +47,17 @@ __exportStar(require("./runtime/foundation"), exports);
 __exportStar(require("./runtime/foundation/service-authority-payload-codec"), exports);
 __exportStar(require("./runtime/framework-errors-internal"), exports);
 __exportStar(require("./contracts/Configuration/Registration"), exports);
+__exportStar(require("./contracts/Locations/Stores"), exports);
+var InternalDefaults_1 = require("./contracts/Configuration/InternalDefaults");
+Object.defineProperty(exports, "ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES", { enumerable: true, get: function () { return InternalDefaults_1.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES; } });
+var CoreTypes_1 = require("./contracts/Common/CoreTypes");
+Object.defineProperty(exports, "ZLINK_MAX_STABLE_TYPE_BYTES", { enumerable: true, get: function () { return CoreTypes_1.ZLINK_MAX_STABLE_TYPE_BYTES; } });
+var RegistrationBuilderPolicy_1 = require("./contracts/Configuration/RegistrationBuilderPolicy");
+Object.defineProperty(exports, "MAX_LISTENER_PORT", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.MAX_LISTENER_PORT; } });
+Object.defineProperty(exports, "ZLINK_MAX_PUBLIC_WEIGHT", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.ZLINK_MAX_PUBLIC_WEIGHT; } });
+Object.defineProperty(exports, "ZLINK_MAX_CAPACITY", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.ZLINK_MAX_CAPACITY; } });
+Object.defineProperty(exports, "isValidPublicWeight", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidPublicWeight; } });
+Object.defineProperty(exports, "isValidPositiveCapacity", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidPositiveCapacity; } });
+Object.defineProperty(exports, "isValidListenerPort", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidListenerPort; } });
+Object.defineProperty(exports, "isValidCapacity", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidCapacity; } });
+Object.defineProperty(exports, "requirePublicWeight", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.requirePublicWeight; } });

package/dist/nest-integration.d.ts

@@ -1,7 +1,8 @@
-export { ZLinkConfigurationException, createFrameworkRegistration, hasActorManager, hasSpotNode, hasSpotPublisherClient } from './contracts/Configuration/Registration';
+export { ZLinkConfigurationException, createFrameworkRegistration, normalizeFrameworkRegistration, hasActorManager, hasSpotNode, hasSpotPublisherClient } from './contracts/Configuration/Registration';
 export type * from './contracts/Configuration/RegistrationTypes';
 export type * from './contracts';
-export { registerActorFactory, validateRoutingIdPrefix, registerEntrySpot, registerSpotFactory, validateActorTransferTimeout, validateMessageFollowDuration, validateSessionReplacementCallbackTimeout } from './contracts/Configuration/RegistrationBuilderPolicy';
+export { ZLinkSpotActorSend, ZLinkSpotActorRequest } from './contracts/Handlers/Attributes';
+export { registerActorFactory, registerRelocationStore, validateRoutingIdPrefix, registerEntrySpot, registerSpotFactory, validateActorTransferTimeout, validateMessageFollowDuration, validateSessionReplacementCallbackTimeout } from './contracts/Configuration/RegistrationBuilderPolicy';
 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';
@@ -10,6 +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 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.registerIntegrationHandlerFilterScope = exports.validateSessionReplacementCallbackTimeout = exports.validateMessageFollowDuration = exports.validateActorTransferTimeout = exports.registerSpotFactory = exports.registerEntrySpot = exports.validateRoutingIdPrefix = exports.registerActorFactory = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.createFrameworkRegistration = exports.ZLinkConfigurationException = void 0;
+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.createIntegrationDispatchOptionsBuilder = createIntegrationDispatchOptionsBuilder;
 exports.createIntegrationInboundDispatchOptionsBuilder = createIntegrationInboundDispatchOptionsBuilder;
 exports.createIntegrationLocationOptionsBuilder = createIntegrationLocationOptionsBuilder;
@@ -19,11 +19,16 @@ exports.createIntegrationHttpExecutionScheduler = createIntegrationHttpExecution
 var Registration_1 = require("./contracts/Configuration/Registration");
 Object.defineProperty(exports, "ZLinkConfigurationException", { enumerable: true, get: function () { return Registration_1.ZLinkConfigurationException; } });
 Object.defineProperty(exports, "createFrameworkRegistration", { enumerable: true, get: function () { return Registration_1.createFrameworkRegistration; } });
+Object.defineProperty(exports, "normalizeFrameworkRegistration", { enumerable: true, get: function () { return Registration_1.normalizeFrameworkRegistration; } });
 Object.defineProperty(exports, "hasActorManager", { enumerable: true, get: function () { return Registration_1.hasActorManager; } });
 Object.defineProperty(exports, "hasSpotNode", { enumerable: true, get: function () { return Registration_1.hasSpotNode; } });
 Object.defineProperty(exports, "hasSpotPublisherClient", { enumerable: true, get: function () { return Registration_1.hasSpotPublisherClient; } });
+var Attributes_1 = require("./contracts/Handlers/Attributes");
+Object.defineProperty(exports, "ZLinkSpotActorSend", { enumerable: true, get: function () { return Attributes_1.ZLinkSpotActorSend; } });
+Object.defineProperty(exports, "ZLinkSpotActorRequest", { enumerable: true, get: function () { return Attributes_1.ZLinkSpotActorRequest; } });
 var RegistrationBuilderPolicy_1 = require("./contracts/Configuration/RegistrationBuilderPolicy");
 Object.defineProperty(exports, "registerActorFactory", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerActorFactory; } });
+Object.defineProperty(exports, "registerRelocationStore", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerRelocationStore; } });
 Object.defineProperty(exports, "validateRoutingIdPrefix", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.validateRoutingIdPrefix; } });
 Object.defineProperty(exports, "registerEntrySpot", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerEntrySpot; } });
 Object.defineProperty(exports, "registerSpotFactory", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerSpotFactory; } });
@@ -40,6 +45,9 @@ const workers_1 = require("./runtime/workers");
 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, "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) {
     return new RegistrationBuilders_1.DefaultDispatchOptionsBuilder(dispatch);
 }
@@ -59,14 +67,15 @@ function createIntegrationRuntimeHost(registration, providerResolver) {
     return new host_1.ZLinkFrameworkRuntimeHost({ registration, providerResolver });
 }
 function createIntegrationChannelClient(registration, runtime) {
-    return new channels_1.DefaultZLinkChannelClient(registration, runtimeHost(runtime).channelTransport);
+    const host = runtimeHost(runtime);
+    return new channels_1.DefaultZLinkChannelClient(registration, host.channelTransport, host.routeTransport, host.spotRouterChannelIdForMesh);
 }
 function createIntegrationFanoutClient(registration, runtime) {
     return new channels_1.DefaultZLinkFanoutClient(registration, runtimeHost(runtime).channelTransport);
 }
 function createIntegrationRouteClient(registration, runtime) {
     const host = runtimeHost(runtime);
-    return new channels_1.DefaultZLinkRouteClient(registration, host.routeTransport, host.spotRouterChannelIdForMesh);
+    return new channels_1.DefaultZLinkRouteClient(registration, host.routeTransport, host.spotRouterChannelIdForMesh, host.channelTransport);
 }
 function createIntegrationSpotPublisherClient(registration, runtime) {
     return new channels_1.DefaultZLinkSpotPublisherClient(registration, runtimeHost(runtime).spotPublisherTransport);
@@ -84,7 +93,7 @@ function createIntegrationActorManager(registration, runtime, providerResolver)
         boundSessionFactory: runtimeOptions.boundSessionFactory ??
             host.boundSessionFactory.create.bind(host.boundSessionFactory),
         providerResolver
-    });
+    }, host.detachedTaskRunner());
     host.setActorManager(manager);
     return manager;
 }
@@ -117,6 +126,7 @@ function createIntegrationSpotManager(registration, runtime, providerResolver) {
             ...(spotNode.spotActorRequestHandlers ?? [])
         ]),
         ...runtimeOptions,
+        detachedTaskRunner: host.detachedTaskRunner(),
         spotRouteResolver: runtimeOptions.spotRouteResolver,
         routedTransport: host.routeTransport,
         providerResolver,

package/dist/runtime/abort.d.ts

@@ -10,4 +10,5 @@ export declare function isAbortError(error: unknown): boolean;
 export declare function createDeadlineExceededError(message?: string): ZLinkDeadlineExceededError;
 export declare function isDeadlineExceededError(error: unknown): boolean;
 export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+export declare function macrotaskBoundary(): Promise<void>;
 export declare function awaitWithAbort<T>(operation: Promise<T>, signal: AbortSignal | undefined, abortOperation?: () => void): Promise<T>;

package/dist/runtime/abort.js

@@ -6,6 +6,7 @@ exports.isAbortError = isAbortError;
 exports.createDeadlineExceededError = createDeadlineExceededError;
 exports.isDeadlineExceededError = isDeadlineExceededError;
 exports.throwIfAborted = throwIfAborted;
+exports.macrotaskBoundary = macrotaskBoundary;
 exports.awaitWithAbort = awaitWithAbort;
 /** The typed cancellation error produced by Framework admission helpers. */
 class ZLinkAbortError extends Error {
@@ -40,11 +41,10 @@ function throwIfAborted(signal) {
         throw createAbortError();
     }
 }
+function macrotaskBoundary() {
+    return new Promise((resolve) => setImmediate(resolve));
+}
 function awaitWithAbort(operation, signal, abortOperation) {
-    if (signal?.aborted === true) {
-        abortOperation?.();
-        throw createAbortError();
-    }
     if (signal === undefined) {
         return operation;
     }
@@ -63,7 +63,6 @@ function awaitWithAbort(operation, signal, abortOperation) {
             abortOperation?.();
             reject(createAbortError());
         };
-        signal.addEventListener('abort', abort, { once: true });
         operation.then((value) => {
             if (settle())
                 resolve(value);
@@ -71,5 +70,9 @@ function awaitWithAbort(operation, signal, abortOperation) {
             if (settle())
                 reject(error);
         });
+        if (signal.aborted)
+            abort();
+        else
+            signal.addEventListener('abort', abort, { once: true });
     });
 }

package/dist/runtime/activation-admission.d.ts

@@ -14,9 +14,8 @@ export interface ZLinkActivationConcurrency {
  */
 export declare class ZLinkActivationAdmission {
     private readonly limitOf;
-    private readonly changed?;
     private readonly records;
-    constructor(limitOf: (meshName: string) => number, changed?: ((meshName: string) => void) | undefined);
+    constructor(limitOf: (meshName: string) => number);
     current(meshName: string): ZLinkActivationConcurrency;
     hasHeadroom(meshName: string): boolean;
     /**

package/dist/runtime/activation-admission.js

@@ -13,11 +13,9 @@ const framework_errors_internal_1 = require("./framework-errors-internal");
  */
 class ZLinkActivationAdmission {
     limitOf;
-    changed;
     records = new Map();
-    constructor(limitOf, changed) {
+    constructor(limitOf) {
         this.limitOf = limitOf;
-        this.changed = changed;
     }
     current(meshName) {
         const record = this.records.get(meshName);
@@ -39,20 +37,18 @@ class ZLinkActivationAdmission {
             throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted, `MeshNode '${meshName}' has no activation admission headroom.`);
         }
         record.active += 1;
-        this.changed?.(meshName);
         let released = false;
         return () => {
             if (released)
                 return;
             released = true;
             record.active -= 1;
-            this.changed?.(meshName);
         };
     }
     record(meshName) {
         let record = this.records.get(meshName);
         if (record === undefined) {
-            record = { meshName, limit: this.limitOf(meshName), active: 0 };
+            record = { limit: this.limitOf(meshName), active: 0 };
             this.records.set(meshName, record);
         }
         return record;

package/dist/runtime/actors/actor-authority-payload-codec.d.ts

@@ -1,5 +1,4 @@
-import type { RoutingId } from '../../contracts';
-import { ZLinkSpotKind } from '../../contracts';
+import { type RoutingId, ZLinkSpotKind } from '../../contracts';
 export type ZLinkActorAuthorityState = 'creating' | 'ready';
 export interface ZLinkActorAuthorityPayload {
     readonly state: ZLinkActorAuthorityState;