@zlink-systems/framework 0.20.0 → 0.22.0

package/dist/contracts/Common/ZLinkMessage.js

@@ -103,11 +103,11 @@ function readZLinkMessageDeclaredType(message) {
  * the runtime type requested by `ZLinkMessage.decode(type)`.
  */
 function materializeZLinkMessageValue(value, type) {
-    if (type === undefined
-        || type === Object
-        || value === null
-        || typeof value !== 'object'
-        || Array.isArray(value)) {
+    if (type === undefined ||
+        type === Object ||
+        value === null ||
+        typeof value !== 'object' ||
+        Array.isArray(value)) {
         return value;
     }
     const prototype = type.prototype;

package/dist/contracts/Configuration/CodecContentType.js

@@ -29,9 +29,7 @@ function normalizeCodecContentType(contentType) {
         }
         if (!isTokenCharacter(code))
             throw invalidContentType();
-        normalized += code >= 0x41 && code <= 0x5a
-            ? String.fromCharCode(code + 0x20)
-            : value[index];
+        normalized += code >= 0x41 && code <= 0x5a ? String.fromCharCode(code + 0x20) : value[index];
     }
     if (slash === -1)
         throw invalidContentType();
@@ -58,10 +56,10 @@ function isOuterWhitespace(code) {
     return code === 0x20 || code === 0x09;
 }
 function isTokenCharacter(code) {
-    return (code >= 0x30 && code <= 0x39)
-        || (code >= 0x41 && code <= 0x5a)
-        || (code >= 0x61 && code <= 0x7a)
-        || mediaTypePunctuation.has(code);
+    return ((code >= 0x30 && code <= 0x39) ||
+        (code >= 0x41 && code <= 0x5a) ||
+        (code >= 0x61 && code <= 0x7a) ||
+        mediaTypePunctuation.has(code));
 }
 function invalidContentType() {
     return new ConfigurationException_1.ZLinkConfigurationException('Codec content type must be a parameter-free ASCII type/subtype.');

package/dist/contracts/Configuration/DiagnosticsValidation.js

@@ -3,12 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.requireMessageFlowLogMode = requireMessageFlowLogMode;
 exports.requireTraceSampleRate = requireTraceSampleRate;
 const ConfigurationException_1 = require("./ConfigurationException");
-const MESSAGE_FLOW_MODES = new Set([
-    'off',
-    'errors',
-    'normal',
-    'detailed'
-]);
+const MESSAGE_FLOW_MODES = new Set(['off', 'errors', 'normal', 'detailed']);
 function requireMessageFlowLogMode(value) {
     if (typeof value !== 'string' || !MESSAGE_FLOW_MODES.has(value)) {
         throw new ConfigurationException_1.ZLinkConfigurationException("messageFlow must be one of 'off', 'errors', 'normal', or 'detailed'.");

package/dist/contracts/Configuration/EndpointNotation.js

@@ -79,9 +79,9 @@ function normalizeEndpoint(endpoint) {
     const { host, port } = splitHostPort(hostPort);
     const normalizedHost = normalizeHost(host);
     const normalizedPort = normalizePort(port);
-    return `${scheme}://${userInfo}${normalizedHost}`
-        + (normalizedPort.length > 0 ? `:${normalizedPort}` : '')
-        + normalizeSuffix(suffix);
+    return (`${scheme}://${userInfo}${normalizedHost}` +
+        (normalizedPort.length > 0 ? `:${normalizedPort}` : '') +
+        normalizeSuffix(suffix));
 }
 function findAuthorityEnd(rest) {
     if (rest.startsWith('[')) {
@@ -197,11 +197,7 @@ function buildAdvertisedEndpoint(boundEndpoint, advertiseHost, restrictToScheme)
         if (match === null)
             return normalized;
         const boundHost = unbracketHost(match[2]);
-        const defaultHost = boundHost === '0.0.0.0'
-            ? '127.0.0.1'
-            : boundHost === '::'
-                ? '::1'
-                : undefined;
+        const defaultHost = boundHost === '0.0.0.0' ? '127.0.0.1' : boundHost === '::' ? '::1' : undefined;
         if (defaultHost === undefined)
             return normalized;
         const host = defaultHost.includes(':') ? `[${defaultHost}]` : defaultHost;

package/dist/contracts/Configuration/Registration.js

@@ -82,22 +82,22 @@ function normalizeApplicationJobQueue(value) {
         throw new TypeError('applicationJobQueue.profile must be a supported profile.');
     }
     const maxQueuedApplicationJobs = value?.maxQueuedApplicationJobs;
-    if (maxQueuedApplicationJobs !== undefined
-        && (typeof maxQueuedApplicationJobs !== 'bigint'
-            || maxQueuedApplicationJobs < 1n
-            || maxQueuedApplicationJobs > 2147483647n)) {
+    if (maxQueuedApplicationJobs !== undefined &&
+        (typeof maxQueuedApplicationJobs !== 'bigint' ||
+            maxQueuedApplicationJobs < 1n ||
+            maxQueuedApplicationJobs > 2147483647n)) {
         throw new TypeError('applicationJobQueue.maxQueuedApplicationJobs must be a bigint in the range 1..2147483647.');
     }
     const pauseThresholdPercent = value?.pauseThresholdPercent ?? 80;
     const resumeThresholdPercent = value?.resumeThresholdPercent ?? 60;
-    if (!Number.isInteger(pauseThresholdPercent)
-        || pauseThresholdPercent < 1
-        || pauseThresholdPercent > 100) {
+    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(resumeThresholdPercent)
-        || resumeThresholdPercent < 0
-        || resumeThresholdPercent > 99) {
+    if (!Number.isInteger(resumeThresholdPercent) ||
+        resumeThresholdPercent < 0 ||
+        resumeThresholdPercent > 99) {
         throw new TypeError('applicationJobQueue.resumeThresholdPercent must be an integer in the range 0..99.');
     }
     if (resumeThresholdPercent >= pauseThresholdPercent) {
@@ -117,7 +117,10 @@ function normalizeCoreHwm(value) {
     if (profile !== undefined && (!Number.isInteger(profile) || profile < 0 || profile > 3)) {
         throw new TypeError('coreHwm.profile must be a Core Auto HWM profile value.');
     }
-    for (const [name, bytes] of [['memoryLimitBytes', memoryLimitBytes], ['budgetBytes', budgetBytes]]) {
+    for (const [name, bytes] of [
+        ['memoryLimitBytes', memoryLimitBytes],
+        ['budgetBytes', budgetBytes]
+    ]) {
         if (bytes !== undefined && (typeof bytes !== 'bigint' || bytes <= 0n)) {
             throw new TypeError(`coreHwm.${name} must be a positive bigint.`);
         }

package/dist/contracts/Configuration/RegistrationBuilders.js

@@ -74,7 +74,8 @@ class ZLinkFrameworkOptionsBuilder {
         return this;
     }
     setSessionReplacementCallbackTimeout(timeoutMs) {
-        this.options.sessionReplacementCallbackTimeoutMs = (0, RegistrationBuilderPolicy_1.validateSessionReplacementCallbackTimeout)(timeoutMs);
+        this.options.sessionReplacementCallbackTimeoutMs =
+            (0, RegistrationBuilderPolicy_1.validateSessionReplacementCallbackTimeout)(timeoutMs);
         return this;
     }
     configureLocations() {
@@ -239,11 +240,16 @@ class DefaultInboundDispatchOptionsBuilder {
 exports.DefaultInboundDispatchOptionsBuilder = DefaultInboundDispatchOptionsBuilder;
 function coreHwmProfileValue(value) {
     switch (value) {
-        case Dispatch_1.ZLinkCoreHwmProfile.Compact: return zlink_1.AutoHwmProfile.Compact;
-        case Dispatch_1.ZLinkCoreHwmProfile.LowLatency: return zlink_1.AutoHwmProfile.LowLatency;
-        case Dispatch_1.ZLinkCoreHwmProfile.Balanced: return zlink_1.AutoHwmProfile.Balanced;
-        case Dispatch_1.ZLinkCoreHwmProfile.Throughput: return zlink_1.AutoHwmProfile.Throughput;
-        default: throw new TypeError('coreHwmProfile must be a supported profile.');
+        case Dispatch_1.ZLinkCoreHwmProfile.Compact:
+            return zlink_1.AutoHwmProfile.Compact;
+        case Dispatch_1.ZLinkCoreHwmProfile.LowLatency:
+            return zlink_1.AutoHwmProfile.LowLatency;
+        case Dispatch_1.ZLinkCoreHwmProfile.Balanced:
+            return zlink_1.AutoHwmProfile.Balanced;
+        case Dispatch_1.ZLinkCoreHwmProfile.Throughput:
+            return zlink_1.AutoHwmProfile.Throughput;
+        default:
+            throw new TypeError('coreHwmProfile must be a supported profile.');
     }
 }
 class DefaultLocationOptionsBuilder {
@@ -764,7 +770,10 @@ class DefaultMeshNodeBuilder {
     }
     addRouteRequestHandler(handlerType) {
         this.node.routeRequestHandlers ??= [];
-        this.node.routeRequestHandlers.push({ packetName: handlerPacketName(handlerType), handlerType });
+        this.node.routeRequestHandlers.push({
+            packetName: handlerPacketName(handlerType),
+            handlerType
+        });
         return this;
     }
     updateBind() {
@@ -772,9 +781,7 @@ class DefaultMeshNodeBuilder {
         if (router?.port === undefined)
             return;
         const bindHost = router.bindHost ?? '127.0.0.1';
-        const host = bindHost.includes(':') && !bindHost.startsWith('[')
-            ? `[${bindHost}]`
-            : bindHost;
+        const host = bindHost.includes(':') && !bindHost.startsWith('[') ? `[${bindHost}]` : bindHost;
         router.bind = `tcp://${host}:${router.port}`;
     }
 }
@@ -885,8 +892,8 @@ class DefaultUserSpotFactoryBuilder extends DefaultFactoryBuilder {
             relocationCoordinationMode: this.relocationCoordinationModeValue
         };
         validateUserSpotFactoryOptions(options);
-        if (options.executionMode === ObjectRoles_1.ZLinkUserSpotExecutionMode.PerActor
-            && relocation.kind !== 'recreate') {
+        if (options.executionMode === ObjectRoles_1.ZLinkUserSpotExecutionMode.PerActor &&
+            relocation.kind !== 'recreate') {
             throw new ConfigurationException_1.ZLinkConfigurationException('PerActor User Spots require RecreateOnRelocation.');
         }
         return { options, relocation };
@@ -1073,7 +1080,10 @@ class DefaultMeshPeerConnections {
         const normalizedEndpoint = (0, EndpointNotation_1.normalizeEndpoint)(endpoint);
         this.router.manualPeerConnections ??= [];
         if (!this.router.manualPeerConnections.some((peer) => peer.endpoint === normalizedEndpoint && peer.peerRid === expectedRoutingIdOrEndpoint)) {
-            this.router.manualPeerConnections.push({ peerRid: expectedRoutingIdOrEndpoint, endpoint: normalizedEndpoint });
+            this.router.manualPeerConnections.push({
+                peerRid: expectedRoutingIdOrEndpoint,
+                endpoint: normalizedEndpoint
+            });
         }
     }
     disconnect(endpoint) {
@@ -1137,23 +1147,22 @@ function requireFactoryConfigure(configure) {
 function validateUserSpotFactoryOptions(options) {
     validateStableTypeLimit(options?.stableTypeLimit);
     const executionMode = options?.executionMode;
-    if (executionMode !== undefined
-        && executionMode !== ObjectRoles_1.ZLinkUserSpotExecutionMode.SpotWide
-        && executionMode !== ObjectRoles_1.ZLinkUserSpotExecutionMode.PerActor) {
+    if (executionMode !== undefined &&
+        executionMode !== ObjectRoles_1.ZLinkUserSpotExecutionMode.SpotWide &&
+        executionMode !== ObjectRoles_1.ZLinkUserSpotExecutionMode.PerActor) {
         throw new ConfigurationException_1.ZLinkConfigurationException('User Spot executionMode is invalid.');
     }
-    if (options?.relocationCoordinationMode !== ObjectRoles_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged
-        && options?.relocationCoordinationMode !== ObjectRoles_1.ZLinkSpotRelocationCoordinationMode.ApplicationSignaled) {
+    if (options?.relocationCoordinationMode !== ObjectRoles_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged &&
+        options?.relocationCoordinationMode !== ObjectRoles_1.ZLinkSpotRelocationCoordinationMode.ApplicationSignaled) {
         throw new ConfigurationException_1.ZLinkConfigurationException('User Spot relocationCoordinationMode is invalid.');
     }
-    if (options.executionMode === ObjectRoles_1.ZLinkUserSpotExecutionMode.PerActor
-        && options.relocationCoordinationMode === ObjectRoles_1.ZLinkSpotRelocationCoordinationMode.ApplicationSignaled) {
+    if (options.executionMode === ObjectRoles_1.ZLinkUserSpotExecutionMode.PerActor &&
+        options.relocationCoordinationMode === ObjectRoles_1.ZLinkSpotRelocationCoordinationMode.ApplicationSignaled) {
         throw new ConfigurationException_1.ZLinkConfigurationException('ApplicationSignaled relocation coordination mode is valid only for SpotWide User Spots.');
     }
 }
 function validateStableTypeLimit(value) {
-    if (value !== undefined
-        && (!Number.isInteger(value) || value < 0 || value > 2_147_483_647)) {
+    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.');
     }
 }
@@ -1163,9 +1172,7 @@ function rejectDuplicateObjectType(registrations, stableType, meshName) {
     }
 }
 function handlerPacketName(handlerType) {
-    return (0, Attributes_1.readZLinkDecoratorMetadata)(handlerType)
-        .find((metadata) => metadata.kind === 'packet' && metadata.packetName !== undefined)
-        ?.packetName ?? handlerType.name;
+    return ((0, Attributes_1.readZLinkDecoratorMetadata)(handlerType).find((metadata) => metadata.kind === 'packet' && metadata.packetName !== undefined)?.packetName ?? handlerType.name);
 }
 function requireRegistrationName(value, label) {
     if (value.trim().length === 0 || value.trim() !== value) {

package/dist/contracts/Configuration/RegistrationNormalizers.js

@@ -42,32 +42,34 @@ function normalizeNetworkOptions(value) {
 }
 function toChannelMap(channels, network) {
     return new Map(Object.entries(channels ?? {}).map(([name, channel]) => {
-        const server = channel.server === undefined
-            ? undefined
-            : normalizeListener(channel.server, network);
-        const publisher = channel.publisher === undefined
-            ? undefined
-            : normalizeListener(channel.publisher, network);
+        const server = channel.server === undefined ? undefined : normalizeListener(channel.server, network);
+        const publisher = channel.publisher === undefined ? undefined : normalizeListener(channel.publisher, network);
         // In-place: channel.client/subscriber.manualConnections can be the same
         // array a live RuntimeEndpointConnections handle mutates, so this must
         // not replace the array or the containing client/subscriber object.
         normalizeEndpointList(channel.client?.manualConnections);
         normalizeEndpointList(channel.subscriber?.manualConnections);
-        return [name, {
+        return [
+            name,
+            {
                 ...channel,
                 ...(server === undefined ? {} : { server }),
                 ...(publisher === undefined ? {} : { publisher }),
                 requestTimeoutMs: normalizeOptionalPositiveInteger(channel.requestTimeoutMs, `${name}.requestTimeoutMs`)
-            }];
+            }
+        ];
     }));
 }
 function toStreamNodeMap(streamNodes, network) {
     return new Map(Object.entries(streamNodes ?? {}).map(([name, streamNode]) => {
         const normalized = normalizeListener(streamNode, network);
-        return [name, {
+        return [
+            name,
+            {
                 ...normalized,
                 maxMessageSize: streamNode.maxMessageSize ?? InternalDefaults_1.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE
-            }];
+            }
+        ];
     }));
 }
 function toRouteChannelOptions(options) {
@@ -120,14 +122,14 @@ function hasSpotNode(registration) {
     return registration.spotNodes.size > 0;
 }
 function hasActorManager(registration) {
-    const hasObjectCapability = [...registration.spotNodes.values()].some(node => node.objectRole === 'client'
-        || node.objectRole === 'server'
-        || (node.actorFactories instanceof Map
+    const hasObjectCapability = [...registration.spotNodes.values()].some((node) => node.objectRole === 'client' ||
+        node.objectRole === 'server' ||
+        (node.actorFactories instanceof Map
             ? node.actorFactories.size > 0
-            : Object.keys(node.actorFactories ?? {}).length > 0)
-        || Object.keys(node.actorFactoryRegistrations ?? {}).length > 0);
-    return hasObjectCapability && (registration.locations.useInMemoryStores
-        || registration.locations.storeInstance !== undefined);
+            : Object.keys(node.actorFactories ?? {}).length > 0) ||
+        Object.keys(node.actorFactoryRegistrations ?? {}).length > 0);
+    return (hasObjectCapability &&
+        (registration.locations.useInMemoryStores || registration.locations.storeInstance !== undefined));
 }
 function hasSpotPublisherClient(registration) {
     return registration.spotPublisherClients.size > 0;
@@ -179,9 +181,7 @@ function toSpotNodeMap(value, network) {
     }));
 }
 function normalizeSpotNodeOptions(spotNode, network) {
-    const router = spotNode.router === undefined
-        ? undefined
-        : normalizeListener(spotNode.router, network);
+    const router = spotNode.router === undefined ? undefined : normalizeListener(spotNode.router, network);
     return {
         ...spotNode,
         router: router === undefined
@@ -204,8 +204,7 @@ function normalizeSpotNodeOptions(spotNode, network) {
 function normalizeListener(listener, network) {
     const usesConfiguredEndpoint = listener.bind !== undefined && listener.port === undefined;
     const port = listener.port ?? (usesConfiguredEndpoint ? endpointPort(listener.bind) : 0);
-    const bindHost = listener.bindHost
-        ?? (usesConfiguredEndpoint ? endpointHost(listener.bind) : network.bindHost);
+    const bindHost = listener.bindHost ?? (usesConfiguredEndpoint ? endpointHost(listener.bind) : network.bindHost);
     const bind = usesConfiguredEndpoint
         ? (0, EndpointNotation_1.normalizeEndpoint)(listener.bind)
         : tcpEndpoint(bindHost ?? network.bindHost, port);
@@ -303,10 +302,10 @@ function normalizeStreamCompression(value) {
     };
 }
 function isStreamCompressionCodec(value) {
-    return typeof value === 'object'
-        && value !== null
-        && typeof value.compress === 'function'
-        && typeof value.decompress === 'function';
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.compress === 'function' &&
+        typeof value.decompress === 'function');
 }
 function normalizeLocationRegistration(value) {
     return {

package/dist/contracts/Configuration/RegistrationValidators.js

@@ -10,8 +10,7 @@ const SendTimeoutValidation_1 = require("./SendTimeoutValidation");
 const FanoutTopic_1 = require("./FanoutTopic");
 function validateFrameworkRegistration(registration, _options = {}) {
     validateListenerNetworkIdentity('process network', registration.network.bindHost, registration.network.advertiseHost);
-    const actorCapableSpotNodes = [...registration.spotNodes.values()]
-        .filter((spotNode) => toActorFactoryCount(spotNode.actorFactories) > 0);
+    const actorCapableSpotNodes = [...registration.spotNodes.values()].filter((spotNode) => toActorFactoryCount(spotNode.actorFactories) > 0);
     if (actorCapableSpotNodes.length > 1) {
         throw new ConfigurationException_1.ZLinkConfigurationException('Actor factory registration is ambiguous because more than one SpotNode owns actor factories.');
     }
@@ -26,10 +25,10 @@ function validateFrameworkRegistration(registration, _options = {}) {
 }
 function validateChannelTopologyNames(registration) {
     const declaredChannelNames = new Set([...registration.channels]
-        .filter(([, channel]) => channel.client !== undefined
-        || channel.server !== undefined
-        || channel.publisher !== undefined
-        || channel.subscriber !== undefined)
+        .filter(([, channel]) => channel.client !== undefined ||
+        channel.server !== undefined ||
+        channel.publisher !== undefined ||
+        channel.subscriber !== undefined)
         .map(([channelName]) => channelName));
     if (declaredChannelNames.size === 0)
         return;
@@ -52,8 +51,7 @@ function toActorFactoryCount(value) {
     return value instanceof Map ? value.size : Object.keys(value).length;
 }
 function hasLocationStores(registration) {
-    return registration.locations.useInMemoryStores
-        || registration.locations.storeInstance !== undefined;
+    return (registration.locations.useInMemoryStores || registration.locations.storeInstance !== undefined);
 }
 function validateWorkerOptions(worker) {
     if (worker === undefined) {
@@ -72,10 +70,10 @@ function validateLocationRegistration(registration) {
         throw new ConfigurationException_1.ZLinkConfigurationException('In-memory location stores cannot be combined with explicit location store registrations.');
     }
     const store = locations.storeInstance;
-    if (store !== undefined
-        && (typeof store.read !== 'function'
-            || typeof store.write !== 'function'
-            || typeof store.scan !== 'function')) {
+    if (store !== undefined &&
+        (typeof store.read !== 'function' ||
+            typeof store.write !== 'function' ||
+            typeof store.scan !== 'function')) {
         throw new ConfigurationException_1.ZLinkConfigurationException('Location Store must implement read, write, and scan.');
     }
     const options = { ...Locations_1.zlinkDefaultLocationOptions, ...locations.options };
@@ -90,8 +88,8 @@ function validateLocationRegistration(registration) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`${name} must be a finite positive number.`);
         }
     }
-    if (options.ownerLeaseRenewIntervalMs + options.ownerLeaseRenewTimeoutMs
-        >= options.ownerLeaseTtlMs - options.ownerLeaseFencingMarginMs) {
+    if (options.ownerLeaseRenewIntervalMs + options.ownerLeaseRenewTimeoutMs >=
+        options.ownerLeaseTtlMs - options.ownerLeaseFencingMarginMs) {
         throw new ConfigurationException_1.ZLinkConfigurationException('ownerLeaseRenewIntervalMs + ownerLeaseRenewTimeoutMs must be less than ownerLeaseTtlMs - ownerLeaseFencingMarginMs.');
     }
     for (const [name, value] of Object.entries({
@@ -121,9 +119,9 @@ function validateLocationRegistration(registration) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`${name} must be a finite non-negative number.`);
         }
     }
-    if (options.routeCacheMaxAgeMs > 0
-        && options.messageFollowDurationMs > 0
-        && options.routeCacheMaxAgeMs > options.messageFollowDurationMs - 5000) {
+    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.');
     }
 }
@@ -183,11 +181,12 @@ function validateChannelCapabilities(channels, peerLocationConfigured) {
         if (channel.subscriber !== undefined && (channel.publishHandlers ?? []).length === 0) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`Channel '${channelName}' subscriber must register at least one publish handler.`);
         }
-        if (((channel.requestHandlers ?? []).length > 0 || (channel.sendHandlers ?? []).length > 0) && channel.server === undefined) {
+        if (((channel.requestHandlers ?? []).length > 0 || (channel.sendHandlers ?? []).length > 0) &&
+            channel.server === undefined) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`Channel '${channelName}' request/send handlers require a server capability.`);
         }
-        if (channel.server !== undefined
-            && (channel.requestHandlers ?? []).length + (channel.sendHandlers ?? []).length === 0) {
+        if (channel.server !== undefined &&
+            (channel.requestHandlers ?? []).length + (channel.sendHandlers ?? []).length === 0) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`Channel '${channelName}' server must register at least one request or send handler.`);
         }
         validateDuplicatePacketNames(`channel '${channelName}' request handler`, channel.requestHandlers?.map((handler) => handler.packetName));
@@ -219,9 +218,9 @@ function validateSpotNodes(registration) {
         (0, SendTimeoutValidation_1.requireValidSendTimeoutMs)(`SpotNode '${spotNodeName}' publisher sendTimeoutMs`, spotNode.publisherConfig?.sendTimeoutMs);
         validateSpotNodeFactories(spotNodeName, spotNode);
         validateSpotNodeTimers(spotNode);
-        if (spotNode.objectRole === 'client'
-            && ((spotNode.routeSendHandlers?.length ?? 0) > 0
-                || (spotNode.routeRequestHandlers?.length ?? 0) > 0)) {
+        if (spotNode.objectRole === 'client' &&
+            ((spotNode.routeSendHandlers?.length ?? 0) > 0 ||
+                (spotNode.routeRequestHandlers?.length ?? 0) > 0)) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`Object Client RouteMesh '${spotNodeName}' cannot register Node-direct handlers.`);
         }
         if (spotNode.router?.routingId !== undefined &&
@@ -234,8 +233,7 @@ function validateSpotNodes(registration) {
 function validateMeshChannels(spotNodeName, meshChannels) {
     for (const [channelName, channel] of Object.entries(meshChannels ?? {})) {
         requireName(`RouteMesh '${spotNodeName}' channel`, channelName);
-        const handlerCount = (channel.requestHandlers?.length ?? 0)
-            + (channel.sendHandlers?.length ?? 0);
+        const handlerCount = (channel.requestHandlers?.length ?? 0) + (channel.sendHandlers?.length ?? 0);
         if (channel.client === true && channel.server === true) {
             throw new ConfigurationException_1.ZLinkConfigurationException(`RouteMesh '${spotNodeName}' channel '${channelName}' must register exactly one role.`);
         }
@@ -273,7 +271,9 @@ function validateSpotNodeCapability(capabilityName, capability) {
     validateManualConnections(capabilityName, capability.manualConnections);
     validateRouterPeerConnections(capabilityName, 'manualPeerConnections' in capability ? capability.manualPeerConnections : undefined);
     requireEndpoint(capabilityName, capability.bind);
-    if (capability.routingId !== undefined && (capability.routingId.trim().length === 0 || capability.routingId.trim() !== capability.routingId)) {
+    if (capability.routingId !== undefined &&
+        (capability.routingId.trim().length === 0 ||
+            capability.routingId.trim() !== capability.routingId)) {
         throw new ConfigurationException_1.ZLinkConfigurationException(`${capabilityName} routingId must not be empty or padded.`);
     }
 }
@@ -289,9 +289,7 @@ function validateListenerNetworkIdentity(capabilityName, configuredBindHost, adv
     }
 }
 function isWildcardHost(host) {
-    const normalized = host.startsWith('[') && host.endsWith(']')
-        ? host.slice(1, -1)
-        : host;
+    const normalized = host.startsWith('[') && host.endsWith(']') ? host.slice(1, -1) : host;
     return normalized === '0.0.0.0' || normalized === '::';
 }
 function validateManualConnections(capabilityName, manualConnections) {
@@ -407,10 +405,10 @@ function isRouteTransportConfigured(routeChannel) {
     return isRoutePacketCapabilityConfigured(routeChannel);
 }
 function isRoutePacketCapabilityConfigured(routeChannel) {
-    return hasBind(routeChannel.bind)
-        || (0, RouteChannelInternalState_1.isRouteClientEnabled)(routeChannel)
-        || (routeChannel.manualConnections ?? []).length > 0
-        || routeChannelHandlerCount(routeChannel) > 0;
+    return (hasBind(routeChannel.bind) ||
+        (0, RouteChannelInternalState_1.isRouteClientEnabled)(routeChannel) ||
+        (routeChannel.manualConnections ?? []).length > 0 ||
+        routeChannelHandlerCount(routeChannel) > 0);
 }
 function isAcceptedSpotRouteChannel(registration, routeChannel) {
     if (!(0, RouteChannelInternalState_1.isRouteTransportDeclared)(routeChannel)) {
@@ -422,11 +420,11 @@ function isAcceptedSpotRouteChannel(registration, routeChannel) {
     if (routeChannel.routingId !== undefined) {
         return [...registration.spotNodes.values()].some((spotNode) => spotNode.router?.routingId === routeChannel.routingId);
     }
-    return [...registration.spotNodes.values()].filter((spotNode) => spotNode.router !== undefined).length === 1;
+    return ([...registration.spotNodes.values()].filter((spotNode) => spotNode.router !== undefined)
+        .length === 1);
 }
 function validateRouteMeshCapability(capabilityName, routeChannel, peerLocationConfigured = false) {
-    const clientEnabled = (0, RouteChannelInternalState_1.isRouteClientEnabled)(routeChannel)
-        || (routeChannel.manualConnections ?? []).length > 0;
+    const clientEnabled = (0, RouteChannelInternalState_1.isRouteClientEnabled)(routeChannel) || (routeChannel.manualConnections ?? []).length > 0;
     if (!hasBind(routeChannel.bind) && !clientEnabled) {
         throw new ConfigurationException_1.ZLinkConfigurationException(`${capabilityName} must enable server or client capability.`);
     }
@@ -437,9 +435,9 @@ function validateRouteMeshCapability(capabilityName, routeChannel, peerLocationC
     requireRouteMeshSocketOptions(capabilityName, routeChannel);
 }
 function routeChannelHandlerCount(routeChannel) {
-    return (routeChannel.handlers ?? []).length +
+    return ((routeChannel.handlers ?? []).length +
         (routeChannel.sendHandlers ?? []).length +
-        (routeChannel.requestHandlers ?? []).length;
+        (routeChannel.requestHandlers ?? []).length);
 }
 function hasBind(endpoint) {
     return endpoint !== undefined && endpoint.trim().length > 0;

package/dist/contracts/Configuration/SendTimeoutValidation.js

@@ -7,10 +7,10 @@ exports.ZLINK_MAX_SEND_TIMEOUT_MS = 2_147_483_647;
 function requireValidSendTimeoutMs(label, value) {
     if (value === undefined)
         return;
-    if (!Number.isFinite(value)
-        || !Number.isInteger(value)
-        || value < 1
-        || value > exports.ZLINK_MAX_SEND_TIMEOUT_MS) {
+    if (!Number.isFinite(value) ||
+        !Number.isInteger(value) ||
+        value < 1 ||
+        value > exports.ZLINK_MAX_SEND_TIMEOUT_MS) {
         throw new ConfigurationException_1.ZLinkConfigurationException(`${label} must be an integer between 1 and ${exports.ZLINK_MAX_SEND_TIMEOUT_MS} milliseconds.`);
     }
 }

package/dist/contracts/Configuration/TimerRegistrationValidator.js

@@ -10,15 +10,15 @@ function validateTimerRegistration(name, periodMs, options) {
     if (!Number.isFinite(periodMs) || periodMs <= 0) {
         throw new ConfigurationException_1.ZLinkConfigurationException('SPOT timer period must be greater than zero.');
     }
-    if (options?.overrunPolicy !== undefined
-        && !Object.values(Timers_1.ZLinkTimerOverrunPolicy).includes(options.overrunPolicy)) {
+    if (options?.overrunPolicy !== undefined &&
+        !Object.values(Timers_1.ZLinkTimerOverrunPolicy).includes(options.overrunPolicy)) {
         throw new ConfigurationException_1.ZLinkConfigurationException('SPOT timer overrun policy is not supported.');
     }
-    if (options?.overrunPolicy === Timers_1.ZLinkTimerOverrunPolicy.CatchUpBounded
-        && (options.maxCatchUpTicks === undefined
-            || !Number.isInteger(options.maxCatchUpTicks)
-            || options.maxCatchUpTicks < 1
-            || options.maxCatchUpTicks > 2_147_483_647)) {
+    if (options?.overrunPolicy === Timers_1.ZLinkTimerOverrunPolicy.CatchUpBounded &&
+        (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.');
     }
 }

package/dist/contracts/Handlers/JsonContract.js

@@ -53,9 +53,9 @@ function normalizeJsonSchema(schema, parents, depth) {
         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)) {
+            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) {
@@ -64,21 +64,33 @@ function normalizeJsonSchema(schema, parents, depth) {
             return Object.freeze({ type: 'enum', names: Object.freeze([...normalizedSchema.names]) });
         }
         case 'nullable':
-            return Object.freeze({ type: 'nullable', value: normalizeJsonSchema(normalizedSchema.value, nextParents, depth + 1) });
+            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) });
+            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) });
+            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)) {
+            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)) {
+            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') {
+            if (normalizedSchema.additionalProperties !== undefined &&
+                typeof normalizedSchema.additionalProperties !== 'boolean') {
                 throw new TypeError('ZLink packet object schema additionalProperties must be boolean.');
             }
             const properties = {};
@@ -131,7 +143,7 @@ function canonicalContract(value) {
     if (typeof value !== 'object' || value === null)
         return JSON.stringify(value);
     return `{${Object.entries(value)
-        .sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
         .map(([key, item]) => `${JSON.stringify(key)}:${canonicalContract(item)}`)
         .join(',')}}`;
 }