@zlink-systems/framework 0.25.0 → 0.27.0

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

@@ -1,11 +1,5 @@
 import type { ZLinkFanoutPublishCall } from './Calls';
-export interface ZLinkFanoutListenerStatus {
-    readonly channelName: string;
-    readonly endpoint: string;
-    readonly observedAt: Date;
-}
 export interface ZLinkFanoutClient {
     publish(channelName: string, event: unknown): ZLinkFanoutPublishCall;
     publish(channelName: string, topic: string, event: unknown): ZLinkFanoutPublishCall;
-    getListenerStatus(channelName: string): ZLinkFanoutListenerStatus;
 }

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

@@ -4,3 +4,9 @@ export type RoutingId = string;
 export type ActorId = string;
 /** Global logical Spot identity. It is not a transport RoutingId. */
 export type SpotId = string;
+export declare const ZLINK_MAX_ACTOR_ID_BYTES = 255;
+export declare const ZLINK_MAX_SPOT_ID_BYTES = 255;
+export declare const ZLINK_MAX_ROUTING_ID_BYTES = 255;
+export declare const ZLINK_MAX_STABLE_TYPE_BYTES = 255;
+export declare const ZLINK_MAX_MESH_NAME_BYTES = 255;
+export declare const ZLINK_MAX_IDENTITY_TEXT_BYTES = 255;

package/dist/contracts/Common/CoreTypes.js

@@ -1,2 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZLINK_MAX_IDENTITY_TEXT_BYTES = exports.ZLINK_MAX_MESH_NAME_BYTES = exports.ZLINK_MAX_STABLE_TYPE_BYTES = exports.ZLINK_MAX_ROUTING_ID_BYTES = exports.ZLINK_MAX_SPOT_ID_BYTES = exports.ZLINK_MAX_ACTOR_ID_BYTES = void 0;
+exports.ZLINK_MAX_ACTOR_ID_BYTES = 255;
+exports.ZLINK_MAX_SPOT_ID_BYTES = 255;
+exports.ZLINK_MAX_ROUTING_ID_BYTES = 255;
+exports.ZLINK_MAX_STABLE_TYPE_BYTES = 255;
+exports.ZLINK_MAX_MESH_NAME_BYTES = 255;
+exports.ZLINK_MAX_IDENTITY_TEXT_BYTES = 255;

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

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

package/dist/contracts/Common/index.js

@@ -16,7 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isZLinkMessage = exports.ZLinkMessage = void 0;
 __exportStar(require("./ActorRef"), exports);
-__exportStar(require("./CoreTypes"), exports);
 __exportStar(require("./ZLinkEncodedPayload"), exports);
 __exportStar(require("./ZLinkMessageMetadata"), exports);
 var ZLinkMessage_1 = require("./ZLinkMessage");

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

@@ -1,6 +1,14 @@
 /** Default complete header plus payload size accepted by a StreamNode. */
 export declare const DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE: number;
+/** service-wire 스키마가 정한 relocation chunk payload의 바이트 상한입니다. */
+export declare const RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = 67108864;
+/** Default MeshNode pending activation limit (spec 03-mesh-node §5.1). */
+export declare const DEFAULT_ACTIVATION_CONCURRENCY_LIMIT = 128;
 /** Defaults shared by registration normalization and the runtime worker pool. */
 export declare const DEFAULT_WORKER_MIN_THREADS = 0;
 export declare const DEFAULT_WORKER_IDLE_TIMEOUT_MS = 30000;
 export declare function defaultWorkerMaxThreads(): number;
+export declare const ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = 4096;
+export declare const AUTHORITY_ENVELOPE_MAX_BYTES: number;
+export declare const CREATION_INTENT_MAX_BYTES: number;
+export declare const CREATION_TERMINAL_ENVELOPE_MAX_BYTES: number;

package/dist/contracts/Configuration/InternalDefaults.js

@@ -33,14 +33,22 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_WORKER_IDLE_TIMEOUT_MS = exports.DEFAULT_WORKER_MIN_THREADS = exports.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE = void 0;
+exports.CREATION_TERMINAL_ENVELOPE_MAX_BYTES = exports.CREATION_INTENT_MAX_BYTES = exports.AUTHORITY_ENVELOPE_MAX_BYTES = exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = exports.DEFAULT_WORKER_IDLE_TIMEOUT_MS = exports.DEFAULT_WORKER_MIN_THREADS = exports.DEFAULT_ACTIVATION_CONCURRENCY_LIMIT = exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = exports.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE = void 0;
 exports.defaultWorkerMaxThreads = defaultWorkerMaxThreads;
 const os = __importStar(require("node:os"));
 /** Default complete header plus payload size accepted by a StreamNode. */
 exports.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE = 64 * 1024;
+/** service-wire 스키마가 정한 relocation chunk payload의 바이트 상한입니다. */
+exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = 67_108_864;
+/** Default MeshNode pending activation limit (spec 03-mesh-node §5.1). */
+exports.DEFAULT_ACTIVATION_CONCURRENCY_LIMIT = 128;
 /** Defaults shared by registration normalization and the runtime worker pool. */
 exports.DEFAULT_WORKER_MIN_THREADS = 0;
 exports.DEFAULT_WORKER_IDLE_TIMEOUT_MS = 30_000;
 function defaultWorkerMaxThreads() {
     return Math.max(2, os.availableParallelism());
 }
+exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = 4096;
+exports.AUTHORITY_ENVELOPE_MAX_BYTES = 1024 * 1024;
+exports.CREATION_INTENT_MAX_BYTES = 1024 * 1024;
+exports.CREATION_TERMINAL_ENVELOPE_MAX_BYTES = 1024 * 1024;

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

@@ -1,11 +1,22 @@
 import type { ZLinkFrameworkOptions } from '../../contracts';
+import { ZLinkApplicationJobQueueProfile } from '../Dispatch';
+import type { ZLinkFrameworkRegistration, ZLinkFrameworkRegistrationOptions } from './RegistrationTypes';
+import { validateFrameworkRegistration } from './RegistrationValidators';
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
 export { ZLinkConfigurationException } from './ConfigurationException';
 export { createFrameworkOptions } from './RegistrationBuilders';
 export { hasActorManager, hasSpotNode, hasSpotPublisherClient, requirePositiveInteger } from './RegistrationNormalizers';
-import type { ZLinkFrameworkRegistration, ZLinkFrameworkRegistrationOptions } from './RegistrationTypes';
 export * from './RegistrationTypes';
-import { validateFrameworkRegistration } from './RegistrationValidators';
 export { validateFrameworkRegistration };
 export { normalizeEndpoint, buildAdvertisedEndpoint, parseEndpointHostPort } from './EndpointNotation';
+export declare const DEFAULT_SESSION_REPLACEMENT_CALLBACK_TIMEOUT_MS = 30000;
 export declare function createFrameworkRegistration(options?: ZLinkFrameworkRegistrationOptions): ZLinkFrameworkRegistration;
+export declare function normalizeFrameworkRegistration(options: ZLinkFrameworkRegistrationOptions): ZLinkFrameworkRegistration;
+export declare const MAX_QUEUED_APPLICATION_JOBS = 2147483647n;
+export declare const DEFAULT_PAUSE_THRESHOLD_PERCENT = 80;
+export declare const DEFAULT_RESUME_THRESHOLD_PERCENT = 60;
+export declare const APPLICATION_JOB_QUEUE_PERCENT_SCALE = 100;
+export declare function isKnownApplicationJobQueueProfile(value: unknown): value is ZLinkApplicationJobQueueProfile;
+export declare function validateApplicationJobQueueMaximum(value: bigint | undefined, createError: (message: string) => Error): void;
+export declare function validateApplicationJobQueuePressureThresholds(pause: number, resume: number, createError: (message: string) => Error): void;
 export declare function createFrameworkRegistrationWithBuilder(configure: (options: ZLinkFrameworkOptions) => void): ZLinkFrameworkRegistration;

package/dist/contracts/Configuration/Registration.js

@@ -14,32 +14,44 @@ 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.parseEndpointHostPort = exports.buildAdvertisedEndpoint = exports.normalizeEndpoint = exports.validateFrameworkRegistration = exports.requirePositiveInteger = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.createFrameworkOptions = exports.ZLinkConfigurationException = void 0;
+exports.APPLICATION_JOB_QUEUE_PERCENT_SCALE = exports.DEFAULT_RESUME_THRESHOLD_PERCENT = exports.DEFAULT_PAUSE_THRESHOLD_PERCENT = exports.MAX_QUEUED_APPLICATION_JOBS = exports.DEFAULT_SESSION_REPLACEMENT_CALLBACK_TIMEOUT_MS = exports.parseEndpointHostPort = exports.buildAdvertisedEndpoint = exports.normalizeEndpoint = exports.validateFrameworkRegistration = exports.requirePositiveInteger = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.createFrameworkOptions = exports.ZLinkConfigurationException = exports.DEFAULT_REQUEST_TIMEOUT_MS = void 0;
 exports.createFrameworkRegistration = createFrameworkRegistration;
+exports.normalizeFrameworkRegistration = normalizeFrameworkRegistration;
+exports.isKnownApplicationJobQueueProfile = isKnownApplicationJobQueueProfile;
+exports.validateApplicationJobQueueMaximum = validateApplicationJobQueueMaximum;
+exports.validateApplicationJobQueuePressureThresholds = validateApplicationJobQueuePressureThresholds;
 exports.createFrameworkRegistrationWithBuilder = createFrameworkRegistrationWithBuilder;
+const zlink_1 = require("@zlink-systems/zlink");
+const CoreTypes_1 = require("../Common/CoreTypes");
 const Dispatch_1 = require("../Dispatch");
+const Options_1 = require("../Locations/Options");
+const RegistrationBuilders_1 = require("./RegistrationBuilders");
+const RegistrationCodecRegistry_1 = require("./RegistrationCodecRegistry");
+const RegistrationNormalizers_1 = require("./RegistrationNormalizers");
+const RegistrationValidators_1 = require("./RegistrationValidators");
+Object.defineProperty(exports, "validateFrameworkRegistration", { enumerable: true, get: function () { return RegistrationValidators_1.validateFrameworkRegistration; } });
+exports.DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
 var ConfigurationException_1 = require("./ConfigurationException");
 Object.defineProperty(exports, "ZLinkConfigurationException", { enumerable: true, get: function () { return ConfigurationException_1.ZLinkConfigurationException; } });
-const RegistrationBuilders_1 = require("./RegistrationBuilders");
 var RegistrationBuilders_2 = require("./RegistrationBuilders");
 Object.defineProperty(exports, "createFrameworkOptions", { enumerable: true, get: function () { return RegistrationBuilders_2.createFrameworkOptions; } });
-const RegistrationCodecRegistry_1 = require("./RegistrationCodecRegistry");
-const RegistrationNormalizers_1 = require("./RegistrationNormalizers");
 var RegistrationNormalizers_2 = require("./RegistrationNormalizers");
 Object.defineProperty(exports, "hasActorManager", { enumerable: true, get: function () { return RegistrationNormalizers_2.hasActorManager; } });
 Object.defineProperty(exports, "hasSpotNode", { enumerable: true, get: function () { return RegistrationNormalizers_2.hasSpotNode; } });
 Object.defineProperty(exports, "hasSpotPublisherClient", { enumerable: true, get: function () { return RegistrationNormalizers_2.hasSpotPublisherClient; } });
 Object.defineProperty(exports, "requirePositiveInteger", { enumerable: true, get: function () { return RegistrationNormalizers_2.requirePositiveInteger; } });
 __exportStar(require("./RegistrationTypes"), exports);
-const RegistrationValidators_1 = require("./RegistrationValidators");
-Object.defineProperty(exports, "validateFrameworkRegistration", { enumerable: true, get: function () { return RegistrationValidators_1.validateFrameworkRegistration; } });
 var EndpointNotation_1 = require("./EndpointNotation");
 Object.defineProperty(exports, "normalizeEndpoint", { enumerable: true, get: function () { return EndpointNotation_1.normalizeEndpoint; } });
 Object.defineProperty(exports, "buildAdvertisedEndpoint", { enumerable: true, get: function () { return EndpointNotation_1.buildAdvertisedEndpoint; } });
 Object.defineProperty(exports, "parseEndpointHostPort", { enumerable: true, get: function () { return EndpointNotation_1.parseEndpointHostPort; } });
-const DEFAULT_MESSAGE_FOLLOW_DURATION_MS = 30_000;
-const DEFAULT_SESSION_REPLACEMENT_CALLBACK_TIMEOUT_MS = 30_000;
+exports.DEFAULT_SESSION_REPLACEMENT_CALLBACK_TIMEOUT_MS = 30_000;
 function createFrameworkRegistration(options = {}) {
+    const registration = normalizeFrameworkRegistration(options);
+    (0, RegistrationValidators_1.validateFrameworkRegistration)(registration, options);
+    return registration;
+}
+function normalizeFrameworkRegistration(options) {
     const codecRegistry = (0, RegistrationCodecRegistry_1.createCodecRegistry)(options.codecs);
     const network = (0, RegistrationNormalizers_1.normalizeNetworkOptions)(options.network);
     const routeChannelOptions = (0, RegistrationNormalizers_1.toRouteChannelOptions)(options);
@@ -53,8 +65,8 @@ function createFrameworkRegistration(options = {}) {
         requestTimeoutMs: (0, RegistrationNormalizers_1.normalizeOptionalPositiveInteger)(options.requestTimeoutMs, 'requestTimeoutMs'),
         actorFactories: (0, RegistrationNormalizers_1.actorFactoriesFromSpotNodes)(spotNodes),
         actorTransferTimeoutMs: (0, RegistrationNormalizers_1.normalizeOptionalPositiveInteger)(options.actorTransferTimeoutMs, 'actorTransferTimeoutMs'),
-        messageFollowDurationMs: normalizeNonNegativeInteger(options.messageFollowDurationMs, 'messageFollowDurationMs', DEFAULT_MESSAGE_FOLLOW_DURATION_MS),
-        sessionReplacementCallbackTimeoutMs: normalizePositiveInteger(options.sessionReplacementCallbackTimeoutMs, 'sessionReplacementCallbackTimeoutMs', DEFAULT_SESSION_REPLACEMENT_CALLBACK_TIMEOUT_MS),
+        messageFollowDurationMs: normalizeNonNegativeInteger(options.messageFollowDurationMs, 'messageFollowDurationMs', Options_1.zlinkDefaultLocationOptions.messageFollowDurationMs),
+        sessionReplacementCallbackTimeoutMs: normalizePositiveInteger(options.sessionReplacementCallbackTimeoutMs, 'sessionReplacementCallbackTimeoutMs', exports.DEFAULT_SESSION_REPLACEMENT_CALLBACK_TIMEOUT_MS),
         spotFactories: (0, RegistrationNormalizers_1.toSpotFactorySet)(options.spotFactories, spotNodes),
         channels: (0, RegistrationNormalizers_1.toChannelMap)(options.channels, network),
         channelClients: (0, RegistrationNormalizers_1.channelNamesWith)(options.channels, (channel) => channel.client !== undefined),
@@ -73,36 +85,42 @@ function createFrameworkRegistration(options = {}) {
         applicationJobQueue: normalizeApplicationJobQueue(options.applicationJobQueue),
         locations: (0, RegistrationNormalizers_1.normalizeLocationRegistration)(options.locations)
     };
-    (0, RegistrationValidators_1.validateFrameworkRegistration)(registration, options);
     return registration;
 }
-function normalizeApplicationJobQueue(value) {
-    const profile = value?.profile ?? Dispatch_1.ZLinkApplicationJobQueueProfile.Balanced;
-    if (!Object.values(Dispatch_1.ZLinkApplicationJobQueueProfile).includes(profile)) {
-        throw new TypeError('applicationJobQueue.profile must be a supported profile.');
+exports.MAX_QUEUED_APPLICATION_JOBS = 2147483647n;
+exports.DEFAULT_PAUSE_THRESHOLD_PERCENT = 80;
+exports.DEFAULT_RESUME_THRESHOLD_PERCENT = 60;
+exports.APPLICATION_JOB_QUEUE_PERCENT_SCALE = 100;
+function isKnownApplicationJobQueueProfile(value) {
+    return Object.values(Dispatch_1.ZLinkApplicationJobQueueProfile).includes(value);
+}
+function validateApplicationJobQueueMaximum(value, createError) {
+    if (value !== undefined &&
+        (typeof value !== 'bigint' || value < 1n || value > exports.MAX_QUEUED_APPLICATION_JOBS)) {
+        throw createError(`maxQueuedApplicationJobs must be a bigint in the range 1..${exports.MAX_QUEUED_APPLICATION_JOBS}.`);
     }
-    const maxQueuedApplicationJobs = value?.maxQueuedApplicationJobs;
-    if (maxQueuedApplicationJobs !== undefined &&
-        (typeof maxQueuedApplicationJobs !== 'bigint' ||
-            maxQueuedApplicationJobs < 1n ||
-            maxQueuedApplicationJobs > 2147483647n)) {
-        throw new TypeError('applicationJobQueue.maxQueuedApplicationJobs must be a bigint in the range 1..2147483647.');
+}
+function validateApplicationJobQueuePressureThresholds(pause, resume, createError) {
+    if (!Number.isInteger(pause) || pause < 1 || pause > exports.APPLICATION_JOB_QUEUE_PERCENT_SCALE) {
+        throw createError(`pauseThresholdPercent must be an integer in the range 1..${exports.APPLICATION_JOB_QUEUE_PERCENT_SCALE}.`);
     }
-    const pauseThresholdPercent = value?.pauseThresholdPercent ?? 80;
-    const resumeThresholdPercent = value?.resumeThresholdPercent ?? 60;
-    if (!Number.isInteger(pauseThresholdPercent) ||
-        pauseThresholdPercent < 1 ||
-        pauseThresholdPercent > 100) {
-        throw new TypeError('applicationJobQueue.pauseThresholdPercent must be an integer in the range 1..100.');
+    if (!Number.isInteger(resume) || resume < 0 || resume >= exports.APPLICATION_JOB_QUEUE_PERCENT_SCALE) {
+        throw createError(`resumeThresholdPercent must be an integer in the range 0..${exports.APPLICATION_JOB_QUEUE_PERCENT_SCALE - 1}.`);
     }
-    if (!Number.isInteger(resumeThresholdPercent) ||
-        resumeThresholdPercent < 0 ||
-        resumeThresholdPercent > 99) {
-        throw new TypeError('applicationJobQueue.resumeThresholdPercent must be an integer in the range 0..99.');
+    if (resume >= pause) {
+        throw createError('resumeThresholdPercent must be less than pauseThresholdPercent.');
     }
-    if (resumeThresholdPercent >= pauseThresholdPercent) {
-        throw new TypeError('applicationJobQueue.resumeThresholdPercent must be less than pauseThresholdPercent.');
+}
+function normalizeApplicationJobQueue(value) {
+    const profile = value?.profile ?? Dispatch_1.ZLinkApplicationJobQueueProfile.Balanced;
+    if (!isKnownApplicationJobQueueProfile(profile)) {
+        throw new TypeError('applicationJobQueue.profile must be a supported profile.');
     }
+    const maxQueuedApplicationJobs = value?.maxQueuedApplicationJobs;
+    validateApplicationJobQueueMaximum(maxQueuedApplicationJobs, (message) => new TypeError(`applicationJobQueue.${message}`));
+    const pauseThresholdPercent = value?.pauseThresholdPercent ?? exports.DEFAULT_PAUSE_THRESHOLD_PERCENT;
+    const resumeThresholdPercent = value?.resumeThresholdPercent ?? exports.DEFAULT_RESUME_THRESHOLD_PERCENT;
+    validateApplicationJobQueuePressureThresholds(pauseThresholdPercent, resumeThresholdPercent, (message) => new TypeError(`applicationJobQueue.${message}`));
     return Object.freeze({
         profile,
         maxQueuedApplicationJobs,
@@ -114,7 +132,8 @@ function normalizeCoreHwm(value) {
     if (value === undefined)
         return undefined;
     const { profile, memoryLimitBytes, budgetBytes } = value;
-    if (profile !== undefined && (!Number.isInteger(profile) || profile < 0 || profile > 3)) {
+    if (profile !== undefined &&
+        (!Number.isInteger(profile) || profile < 0 || profile > zlink_1.AutoHwmProfile.Throughput)) {
         throw new TypeError('coreHwm.profile must be a Core Auto HWM profile value.');
     }
     for (const [name, bytes] of [
@@ -139,8 +158,11 @@ function normalizeMaintenanceWave(value) {
     if (value === undefined)
         return undefined;
     const byteLength = typeof value === 'string' ? new TextEncoder().encode(value).byteLength : 0;
-    if (typeof value !== 'string' || byteLength === 0 || byteLength > 255 || value.includes('\0')) {
-        throw new TypeError('maintenanceWave must be a 1..255 byte UTF-8 string without NUL.');
+    if (typeof value !== 'string' ||
+        byteLength === 0 ||
+        byteLength > CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES ||
+        value.includes('\0')) {
+        throw new TypeError(`maintenanceWave must be a 1..${CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES} byte UTF-8 string without NUL.`);
     }
     return value;
 }

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

@@ -1,4 +1,16 @@
-import type { Type, ZLinkEntrySpot, ZLinkSpot } from '../../contracts';
+import type { Type, ZLinkEntrySpot, ZLinkSpot, ZLinkRelocationStore } from '../../contracts';
+export declare const MAX_LISTENER_PORT = 65535;
+export declare function registerRelocationStore(options: {
+    relocationStoreInstance?: ZLinkRelocationStore;
+}, store: ZLinkRelocationStore): void;
+export declare function isValidListenerPort(value: number): boolean;
+export declare const ZLINK_MAX_CAPACITY = 2147483647;
+export declare function isValidPositiveCapacity(value: number): boolean;
+export declare function isValidCapacity(value: number): boolean;
+export declare const ZLINK_DEFAULT_PUBLIC_WEIGHT = 100;
+export declare const ZLINK_MAX_PUBLIC_WEIGHT = 10000;
+export declare function isValidPublicWeight(value: number): boolean;
+export declare function requirePublicWeight(value: number, label: string): number;
 export declare function validateMessageFollowDuration(timeoutMs: number): number;
 export declare function validateActorTransferTimeout(timeoutMs: number): number;
 export declare function validateSessionReplacementCallbackTimeout(timeoutMs: number): number;

package/dist/contracts/Configuration/RegistrationBuilderPolicy.js

@@ -1,5 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZLINK_MAX_PUBLIC_WEIGHT = exports.ZLINK_DEFAULT_PUBLIC_WEIGHT = exports.ZLINK_MAX_CAPACITY = exports.MAX_LISTENER_PORT = void 0;
+exports.registerRelocationStore = registerRelocationStore;
+exports.isValidListenerPort = isValidListenerPort;
+exports.isValidPositiveCapacity = isValidPositiveCapacity;
+exports.isValidCapacity = isValidCapacity;
+exports.isValidPublicWeight = isValidPublicWeight;
+exports.requirePublicWeight = requirePublicWeight;
 exports.validateMessageFollowDuration = validateMessageFollowDuration;
 exports.validateActorTransferTimeout = validateActorTransferTimeout;
 exports.validateSessionReplacementCallbackTimeout = validateSessionReplacementCallbackTimeout;
@@ -7,7 +14,36 @@ exports.registerEntrySpot = registerEntrySpot;
 exports.registerSpotFactory = registerSpotFactory;
 exports.registerActorFactory = registerActorFactory;
 exports.validateRoutingIdPrefix = validateRoutingIdPrefix;
+const CoreTypes_1 = require("../Common/CoreTypes");
 const ConfigurationException_1 = require("./ConfigurationException");
+exports.MAX_LISTENER_PORT = 65_535;
+function registerRelocationStore(options, store) {
+    if (options.relocationStoreInstance !== undefined) {
+        throw new ConfigurationException_1.ZLinkConfigurationException('Relocation Store is already registered.');
+    }
+    options.relocationStoreInstance = store;
+}
+function isValidListenerPort(value) {
+    return Number.isInteger(value) && value >= 0 && value <= exports.MAX_LISTENER_PORT;
+}
+exports.ZLINK_MAX_CAPACITY = 0x7fff_ffff;
+function isValidPositiveCapacity(value) {
+    return Number.isSafeInteger(value) && value > 0 && value <= exports.ZLINK_MAX_CAPACITY;
+}
+function isValidCapacity(value) {
+    return Number.isSafeInteger(value) && value >= 0 && value <= exports.ZLINK_MAX_CAPACITY;
+}
+exports.ZLINK_DEFAULT_PUBLIC_WEIGHT = 100;
+exports.ZLINK_MAX_PUBLIC_WEIGHT = 10_000;
+function isValidPublicWeight(value) {
+    return Number.isInteger(value) && value >= 0 && value <= exports.ZLINK_MAX_PUBLIC_WEIGHT;
+}
+function requirePublicWeight(value, label) {
+    if (!isValidPublicWeight(value)) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 0..${exports.ZLINK_MAX_PUBLIC_WEIGHT}.`);
+    }
+    return value;
+}
 function validateMessageFollowDuration(timeoutMs) {
     if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0) {
         throw new ConfigurationException_1.ZLinkConfigurationException('Message Follow duration must be a non-negative safe integer.');
@@ -54,7 +90,8 @@ function validateRoutingIdPrefix(prefix) {
     if (prefix.trim().length === 0 || prefix !== prefix.trim()) {
         throw new ConfigurationException_1.ZLinkConfigurationException('Routing-id prefix must not be empty or padded.');
     }
-    if (Buffer.byteLength(`${prefix}-00000000-0000-0000-0000-000000000000`, 'utf8') > 255) {
+    if (Buffer.byteLength(`${prefix}-00000000-0000-0000-0000-000000000000`, 'utf8') >
+        CoreTypes_1.ZLINK_MAX_ROUTING_ID_BYTES) {
         throw new ConfigurationException_1.ZLinkConfigurationException('Routing-id prefix is too long for a generated routing id.');
     }
     return prefix;

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

@@ -1,8 +1,7 @@
 import type { ZLinkFrameworkOptions, ZLinkLocationOptionValues, ZLinkStreamCompressionBuilder, ZLinkStreamCompressionCodec } from '../../contracts';
-import type { ZLinkDispatchOptions, ZLinkDispatchOptionsBuilder, ZLinkInboundDispatchOptions, ZLinkMessageFlowLogMode } from '../Dispatch';
-import { ZLinkApplicationJobQueueProfile, ZLinkCoreHwmProfile } from '../Dispatch';
+import { type ZLinkDispatchOptions, type ZLinkDispatchOptionsBuilder, type ZLinkInboundDispatchOptions, type ZLinkMessageFlowLogMode, ZLinkApplicationJobQueueProfile, ZLinkCoreHwmProfile } from '../Dispatch';
 import type { ZLinkLocationOptions } from '../Locations';
-import type { ZLinkApplicationJobQueueOptions, ZLinkFrameworkRegistrationOptions, ZLinkCoreHwmOptions } from './RegistrationTypes';
+import type { ZLinkApplicationJobQueueOptions, ZLinkCoreHwmOptions, ZLinkFrameworkRegistrationOptions } from './RegistrationTypes';
 export declare function createFrameworkOptions(configure: (options: ZLinkFrameworkOptions) => void): ZLinkFrameworkRegistrationOptions;
 export declare class DefaultDispatchOptionsBuilder implements ZLinkDispatchOptionsBuilder {
     private readonly dispatch;

package/dist/contracts/Configuration/RegistrationBuilders.js

@@ -2,19 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultStreamCompressionBuilder = exports.DefaultLocationOptionsBuilder = exports.DefaultInboundDispatchOptionsBuilder = exports.DefaultDispatchOptionsBuilder = void 0;
 exports.createFrameworkOptions = createFrameworkOptions;
-const ObjectRoles_1 = require("./ObjectRoles");
-const Attributes_1 = require("../Handlers/Attributes");
-const Dispatch_1 = require("../Dispatch");
 const zlink_1 = require("@zlink-systems/zlink");
-const RuntimeEndpointConnections_1 = require("./RuntimeEndpointConnections");
+const CoreTypes_1 = require("../Common/CoreTypes");
+const Dispatch_1 = require("../Dispatch");
+const Attributes_1 = require("../Handlers/Attributes");
 const ConfigurationException_1 = require("./ConfigurationException");
-const RegistrationCodecRegistry_1 = require("./RegistrationCodecRegistry");
-const RegistrationNormalizers_1 = require("./RegistrationNormalizers");
+const DiagnosticsValidation_1 = require("./DiagnosticsValidation");
 const EndpointNotation_1 = require("./EndpointNotation");
+const FanoutTopic_1 = require("./FanoutTopic");
 const InternalDefaults_1 = require("./InternalDefaults");
+const ObjectRoles_1 = require("./ObjectRoles");
 const RegistrationBuilderPolicy_1 = require("./RegistrationBuilderPolicy");
-const DiagnosticsValidation_1 = require("./DiagnosticsValidation");
-const FanoutTopic_1 = require("./FanoutTopic");
+const RegistrationCodecRegistry_1 = require("./RegistrationCodecRegistry");
+const RegistrationNormalizers_1 = require("./RegistrationNormalizers");
+const RuntimeEndpointConnections_1 = require("./RuntimeEndpointConnections");
 function createFrameworkOptions(configure) {
     const builder = new ZLinkFrameworkOptionsBuilder();
     configure(builder);
@@ -54,7 +55,7 @@ class ZLinkFrameworkOptionsBuilder {
     }
     addRelocationStore(store) {
         this.options.locations ??= { options: {} };
-        this.options.locations.relocationStoreInstance = store;
+        (0, RegistrationBuilderPolicy_1.registerRelocationStore)(this.options.locations, store);
         return this;
     }
     setApplicationVersion(version) {
@@ -470,8 +471,8 @@ class DefaultClientServerChannelServerBuilder {
         this.channel = channel;
     }
     listen(port = 0) {
-        if (!Number.isInteger(port) || port < 0 || port > 65_535) {
-            throw new ConfigurationException_1.ZLinkConfigurationException(`ClientServer channel '${this.name}' port must be between 0 and 65535.`);
+        if (!(0, RegistrationBuilderPolicy_1.isValidListenerPort)(port)) {
+            throw new ConfigurationException_1.ZLinkConfigurationException(`ClientServer channel '${this.name}' port must be between 0 and ${RegistrationBuilderPolicy_1.MAX_LISTENER_PORT}.`);
         }
         this.server.port = port;
         this.updateBind();
@@ -490,7 +491,7 @@ class DefaultClientServerChannelServerBuilder {
         return this;
     }
     setWeight(weight) {
-        this.server.weight = requirePublicWeight(weight, `ClientServer channel '${this.name}' weight`);
+        this.server.weight = (0, RegistrationBuilderPolicy_1.requirePublicWeight)(weight, `ClientServer channel '${this.name}' weight`);
         return this;
     }
     addHandlerGroup(groupName) {
@@ -695,8 +696,8 @@ class DefaultMeshNodeBuilder {
             this.node.router.port = undefined;
             return this;
         }
-        if (!Number.isInteger(endpointOrPort) || endpointOrPort < 0 || endpointOrPort > 65_535) {
-            throw new ConfigurationException_1.ZLinkConfigurationException(`RouteMesh '${this.name}' port must be between 0 and 65535.`);
+        if (!(0, RegistrationBuilderPolicy_1.isValidListenerPort)(endpointOrPort)) {
+            throw new ConfigurationException_1.ZLinkConfigurationException(`RouteMesh '${this.name}' port must be between 0 and ${RegistrationBuilderPolicy_1.MAX_LISTENER_PORT}.`);
         }
         this.node.router.port = endpointOrPort;
         this.updateBind();
@@ -725,7 +726,7 @@ class DefaultMeshNodeBuilder {
         return this;
     }
     setPlacementWeight(weight) {
-        this.node.placementWeight = requirePublicWeight(weight, 'Placement weight');
+        this.node.placementWeight = (0, RegistrationBuilderPolicy_1.requirePublicWeight)(weight, 'Placement weight');
         return this;
     }
     setActorLimit(limit) {
@@ -1040,7 +1041,7 @@ class DefaultMeshChannelServerBuilder {
         this.channel = channel;
     }
     setWeight(weight) {
-        this.channel.weight = requirePublicWeight(weight, 'Mesh channel weight');
+        this.channel.weight = (0, RegistrationBuilderPolicy_1.requirePublicWeight)(weight, 'Mesh channel weight');
         return this;
     }
     addHandlerGroup(groupName) {
@@ -1110,20 +1111,20 @@ function endpointList(endpoint) {
 }
 function requireStableObjectType(value, label) {
     const byteLength = Buffer.byteLength(value, 'utf8');
-    if (byteLength < 1 || byteLength > 255 || value.includes('\0')) {
-        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must contain 1..255 UTF-8 bytes and no NUL.`);
+    if (byteLength < 1 || byteLength > CoreTypes_1.ZLINK_MAX_STABLE_TYPE_BYTES || value.includes('\0')) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must contain 1..${CoreTypes_1.ZLINK_MAX_STABLE_TYPE_BYTES} UTF-8 bytes and no NUL.`);
     }
     return value;
 }
 function requirePositiveCapacity(value, label) {
-    if (!Number.isSafeInteger(value) || value <= 0 || value > 0x7fff_ffff) {
-        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 1..2147483647.`);
+    if (!(0, RegistrationBuilderPolicy_1.isValidPositiveCapacity)(value)) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 1..${RegistrationBuilderPolicy_1.ZLINK_MAX_CAPACITY}.`);
     }
     return value;
 }
 function requireCapacity(value, label) {
-    if (!Number.isSafeInteger(value) || value < 0 || value > 0x7fff_ffff) {
-        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 0..2147483647.`);
+    if (!(0, RegistrationBuilderPolicy_1.isValidCapacity)(value)) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 0..${RegistrationBuilderPolicy_1.ZLINK_MAX_CAPACITY}.`);
     }
     return value;
 }
@@ -1133,12 +1134,6 @@ function requireNonNegativeSafeInteger(value, label) {
     }
     return value;
 }
-function requirePublicWeight(value, label) {
-    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
-        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer in 0..10000.`);
-    }
-    return value;
-}
 function requireFactoryConfigure(configure) {
     if (typeof configure !== 'function') {
         throw new ConfigurationException_1.ZLinkConfigurationException('Object factory requires a configure callback.');
@@ -1162,8 +1157,8 @@ function validateUserSpotFactoryOptions(options) {
     }
 }
 function validateStableTypeLimit(value) {
-    if (value !== undefined && (!Number.isInteger(value) || value < 0 || value > 2_147_483_647)) {
-        throw new ConfigurationException_1.ZLinkConfigurationException('stableTypeLimit must be an integer from 0 through 2147483647.');
+    if (value !== undefined && !(0, RegistrationBuilderPolicy_1.isValidCapacity)(value)) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`stableTypeLimit must be an integer from 0 through ${RegistrationBuilderPolicy_1.ZLINK_MAX_CAPACITY}.`);
     }
 }
 function rejectDuplicateObjectType(registrations, stableType, meshName) {
@@ -1180,8 +1175,8 @@ function requireRegistrationName(value, label) {
     }
 }
 function requireListenerPort(value, label) {
-    if (!Number.isInteger(value) || value < 0 || value > 65_535) {
-        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be between 0 and 65535.`);
+    if (!(0, RegistrationBuilderPolicy_1.isValidListenerPort)(value)) {
+        throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be between 0 and ${RegistrationBuilderPolicy_1.MAX_LISTENER_PORT}.`);
     }
     return value;
 }

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

@@ -169,6 +169,7 @@ export interface ZLinkClientCapabilityOptions {
     readonly maxMessageSize?: number;
 }
 export interface ZLinkPublisherCapabilityOptions {
+    readonly sendTimeoutMs?: number;
     readonly bind?: string;
     readonly bindHost?: string;
     readonly advertiseHost?: string;

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,9 +451,7 @@ 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);

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",