@zlink-systems/framework 0.26.0 → 0.27.0

package/dist/runtime/foundation/service-stateful-wire-codec.d.ts

@@ -108,7 +108,7 @@ export type ServiceWireRelocationObject = {
 /** Shared CRC-32C wire bounds for the direct relocation payload transfer. */
 export declare const RELOCATION_PAYLOAD_TOTAL_LENGTH_MAX = 274877906944n;
 export declare const RELOCATION_PAYLOAD_CHUNK_COUNT_MAX = 4096;
-export declare const RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = 67108864;
+export { RELOCATION_STATE_CHUNK_DATA_MAX_BYTES } from '../../contracts/Configuration/InternalDefaults';
 interface ServiceWireRelocationBase {
     readonly relocation: ServiceWireOperationId;
     readonly targetAttemptGeneration: bigint;
@@ -463,6 +463,7 @@ export type ServiceStatefulWireRecord = {
 } | {
     readonly kind: 'instanceSpot';
     readonly activation: 'ready';
+    readonly instanceIntent: boolean;
     readonly route: ServiceInstanceRouteFence;
     readonly sourceNodeGeneration: bigint;
     readonly sourceNodeRid: string;
@@ -549,7 +550,7 @@ export declare function decodeSessionRelocationRoute(frame: Uint8Array): Service
 export declare function encodeInstanceSpotHeader(route: ServiceInstanceRouteFence, sourceNodeGeneration: bigint, sourceNodeRid: string, sourceSpotId: string | undefined, operationKind: 'send' | 'request', operation: {
     readonly high: bigint;
     readonly low: bigint;
-}, replyRouteId?: bigint, hasMetadata?: boolean): Buffer;
+}, replyRouteId?: bigint, hasMetadata?: boolean, instanceIntent?: boolean): Buffer;
 export declare function encodeInstanceSpotActivationHeader(target: ServiceInstanceActivationTarget, sourceNodeGeneration: bigint, sourceNodeRid: string, sourceSpotId: string | undefined, operationKind: 'send' | 'request', operation: {
     readonly high: bigint;
     readonly low: bigint;
@@ -599,4 +600,3 @@ export declare function encodeServiceWireFrozenActorApplicationRecord(input: {
     readonly replyRouteId?: bigint;
     readonly payload: NonNullable<ServiceMaintenanceReplyRelay['payload']>;
 }): ServiceWireFrozenRecord;
-export {};

package/dist/runtime/foundation/service-stateful-wire-codec.js

@@ -36,15 +36,21 @@ exports.decodeServiceWireFrozenRecord = decodeServiceWireFrozenRecord;
 exports.decodeServiceWireFrozenRecordPrefix = decodeServiceWireFrozenRecordPrefix;
 exports.encodeServiceWireFrozenRecord = encodeServiceWireFrozenRecord;
 exports.encodeServiceWireFrozenActorApplicationRecord = encodeServiceWireFrozenActorApplicationRecord;
-const service_runtime_contracts_1 = require("./service-runtime-contracts");
-const service_wire_m6a_codec_1 = require("./service-wire-m6a-codec");
+const stream_wire_1 = require("@zlink-systems/stream-wire");
+const InternalDefaults_1 = require("../../contracts/Configuration/InternalDefaults");
 const framework_errors_internal_1 = require("../framework-errors-internal");
-const routing_id_1 = require("../routing-id");
-const service_wire_constants_generated_1 = require("./service-wire-constants.generated");
-const service_wire_binary_primitives_1 = require("./service-wire-binary-primitives");
 const service_wire_codec_generated_1 = require("../protocol/service_wire_codec.generated");
 const service_wire_pilot_codec_generated_1 = require("../protocol/service_wire_pilot_codec.generated");
-const PREFIX_SIZE = 5;
+const routing_id_1 = require("../routing-id");
+const service_runtime_contracts_1 = require("./service-runtime-contracts");
+const service_wire_binary_primitives_1 = require("./service-wire-binary-primitives");
+const service_wire_constants_generated_1 = require("./service-wire-constants.generated");
+const service_wire_m6a_codec_1 = require("./service-wire-m6a-codec");
+const MESSAGE_FOLLOW_MAX_BODY_BYTES = 16 * 1024 * 1024;
+const MESSAGE_FOLLOW_VERSION = 1;
+const INSTANCE_ROUTE_VERSION = 1;
+const INSTANCE_ACTIVATION_VERSION = 2;
+const PREFIX_SIZE = service_wire_binary_primitives_1.SERVICE_WIRE_PREFIX_SIZE;
 const MAGIC_0 = service_wire_constants_generated_1.SERVICE_WIRE_MAGIC[0];
 const MAGIC_1 = service_wire_constants_generated_1.SERVICE_WIRE_MAGIC[1];
 const MAJOR = service_wire_constants_generated_1.SERVICE_WIRE_MAJOR;
@@ -52,7 +58,8 @@ exports.M6bServiceWireCommand = service_wire_constants_generated_1.ServiceWireCo
 /** Shared CRC-32C wire bounds for the direct relocation payload transfer. */
 exports.RELOCATION_PAYLOAD_TOTAL_LENGTH_MAX = 274877906944n;
 exports.RELOCATION_PAYLOAD_CHUNK_COUNT_MAX = 4096;
-exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = 67_108_864;
+var InternalDefaults_2 = require("../../contracts/Configuration/InternalDefaults");
+Object.defineProperty(exports, "RELOCATION_STATE_CHUNK_DATA_MAX_BYTES", { enumerable: true, get: function () { return InternalDefaults_2.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES; } });
 exports.M6bServiceWireFlag = service_wire_constants_generated_1.ServiceWireFlag;
 function serviceSessionRelocationIdentityKey(value) {
     const actor = 'targetNodeGeneration' in value.actor ? value.actor.actor : value.actor;
@@ -498,7 +505,7 @@ const STATEFUL_MESSAGE_CONTEXT = {
 };
 const STATEFUL_HEADER_PAYLOAD = {
     packetName: 'wire',
-    contentType: 'application/json',
+    contentType: stream_wire_1.ZlinkStreamContentType.Json,
     payload: Buffer.from('{}')
 };
 function generatedSpotFence(target) {
@@ -615,8 +622,21 @@ function encodeSessionRelocationRoute(value) {
 function decodeSessionRelocationRoute(frame) {
     return fromGeneratedSessionRelocationRoute((0, service_wire_pilot_codec_generated_1.decodeSessionRelocationRoute44)(frame));
 }
-function encodeInstanceSpotHeader(route, sourceNodeGeneration, sourceNodeRid, sourceSpotId, operationKind, operation, replyRouteId, hasMetadata = false) {
-    const routeBody = concat(rid(route.targetNodeRid, 'targetNodeRid'), u64(route.targetNodeGeneration), rid(route.targetSpotId, 'targetSpotId'), u64(route.objectGeneration), text8(route.ownerId, 'ownerId'), u64(route.authorityOwnerGeneration), u64(route.leaseGeneration), text16(route.storeVersion, 'storeVersion'));
+function encodeInstanceSpotHeader(route, sourceNodeGeneration, sourceNodeRid, sourceSpotId, operationKind, operation, replyRouteId, hasMetadata = false, instanceIntent = false) {
+    const encodedRoute = (0, service_wire_codec_generated_1.encodeInstanceRouteV1)({
+        routeKind: 'ready',
+        targetNodeRid: toGeneratedRoutingId(route.targetNodeRid, 'targetNodeRid'),
+        targetNodeGeneration: route.targetNodeGeneration,
+        targetSpotId: route.targetSpotId,
+        authority: {
+            objectGeneration: route.objectGeneration,
+            ownerId: route.ownerId,
+            authorityOwnerGeneration: route.authorityOwnerGeneration,
+            leaseGeneration: route.leaseGeneration,
+            storeVersion: route.storeVersion
+        },
+        instanceIntent: instanceIntent ? 'true' : 'false'
+    }, STATEFUL_MESSAGE_CONTEXT);
     if (operationKind === 'send' &&
         (operation.high !== 0n || operation.low !== 0n || replyRouteId !== undefined)) {
         throw new RangeError('Instance Spot send must not carry an operation or reply route.');
@@ -624,7 +644,7 @@ function encodeInstanceSpotHeader(route, sourceNodeGeneration, sourceNodeRid, so
     if (operationKind === 'request' && operation.high === 0n && operation.low === 0n) {
         throw new RangeError('Instance Spot request requires a non-zero operation.');
     }
-    return concat(prefix(exports.M6bServiceWireCommand.instanceSpot, hasMetadata ? exports.M6bServiceWireFlag.metadata : 0), Buffer.of(1), u16(routeBody.byteLength), routeBody, u64Any(sourceNodeGeneration), rid(sourceNodeRid, 'sourceNodeRid'), optionalRid(sourceSpotId), Buffer.of(operationKind === 'send' ? 1 : 2), u64Any(operation.high), u64Any(operation.low), ...(operationKind === 'request' ? [u64(requirePositive(replyRouteId, 'replyRouteId'))] : []));
+    return concat(prefix(exports.M6bServiceWireCommand.instanceSpot, hasMetadata ? exports.M6bServiceWireFlag.metadata : 0), encodedRoute, u64Any(sourceNodeGeneration), rid(sourceNodeRid, 'sourceNodeRid'), optionalRid(sourceSpotId), Buffer.of(operationKind === 'send' ? 1 : 2), u64Any(operation.high), u64Any(operation.low), ...(operationKind === 'request' ? [u64(requirePositive(replyRouteId, 'replyRouteId'))] : []));
 }
 function encodeInstanceSpotActivationHeader(target, sourceNodeGeneration, sourceNodeRid, sourceSpotId, operationKind, operation, deadlineUnixMs, replyRouteId, hasMetadata = false) {
     if (operation.high === 0n && operation.low === 0n) {
@@ -637,7 +657,7 @@ function encodeInstanceSpotActivationHeader(target, sourceNodeGeneration, source
         throw new RangeError('Instance Spot send must not carry a reply route.');
     }
     const targetBody = concat(rid(target.targetNodeRid, 'targetNodeRid'), u64(target.targetNodeGeneration), rid(target.targetSpotId, 'targetSpotId'), text16(target.stableType, 'stableType'), text16(target.descriptorVersion, 'descriptorVersion'));
-    return concat(prefix(exports.M6bServiceWireCommand.instanceSpot, hasMetadata ? exports.M6bServiceWireFlag.metadata : 0), Buffer.of(2), u16(targetBody.byteLength), targetBody, u64Any(sourceNodeGeneration), rid(sourceNodeRid, 'sourceNodeRid'), optionalRid(sourceSpotId), Buffer.of(operationKind === 'send' ? 1 : 2), u64Any(operation.high), u64Any(operation.low), u64(deadlineUnixMs), ...(operationKind === 'request' ? [u64(requirePositive(replyRouteId, 'replyRouteId'))] : []));
+    return concat(prefix(exports.M6bServiceWireCommand.instanceSpot, hasMetadata ? exports.M6bServiceWireFlag.metadata : 0), Buffer.of(INSTANCE_ACTIVATION_VERSION), u16(targetBody.byteLength), targetBody, u64Any(sourceNodeGeneration), rid(sourceNodeRid, 'sourceNodeRid'), optionalRid(sourceSpotId), Buffer.of(operationKind === 'send' ? 1 : 2), u64Any(operation.high), u64Any(operation.low), u64(deadlineUnixMs), ...(operationKind === 'request' ? [u64(requirePositive(replyRouteId, 'replyRouteId'))] : []));
 }
 function encodeUserSpotCreateHeader(record) {
     return Buffer.from((0, service_wire_pilot_codec_generated_1.encodeUserSpotCreate47)(toGeneratedUserSpotCreate(record)));
@@ -651,10 +671,10 @@ function encodeUserSpotCloseHeader(record) {
 function encodeMessageFollowHeader(record) {
     validateMessageFollowRecord(record);
     const body = concat(messageFollowRoute(record.source), messageFollowRoute(record.target), Buffer.of(record.hopCount), u32(record.queuedMessages, 'queuedMessages'), u32(record.queuedBytes, 'queuedBytes'), u64Any(record.originalOperation.high), u64Any(record.originalOperation.low), u64Any(record.originalReplyRouteId));
-    if (body.byteLength > 16 * 1024 * 1024) {
-        throw new RangeError('Message Follow body exceeds 16 MiB.');
+    if (body.byteLength > MESSAGE_FOLLOW_MAX_BODY_BYTES) {
+        throw new RangeError(`Message Follow body exceeds ${MESSAGE_FOLLOW_MAX_BODY_BYTES / (1024 * 1024)} MiB.`);
     }
-    return concat(prefix(exports.M6bServiceWireCommand.messageFollow), Buffer.of(1), u32(body.byteLength, 'messageFollow.length'), body);
+    return concat(prefix(exports.M6bServiceWireCommand.messageFollow), Buffer.of(MESSAGE_FOLLOW_VERSION), u32(body.byteLength, 'messageFollow.length'), body);
 }
 function decodeStatefulHeader(frame, payloadFrame, metadataFrame) {
     switch (frame[3]) {
@@ -860,33 +880,44 @@ function decodeStatefulHeader(frame, payloadFrame, metadataFrame) {
             if ((command.flags & ~exports.M6bServiceWireFlag.metadata) !== 0) {
                 fail(`Invalid command flags '${command.flags}'.`);
             }
+            const routeStart = reader.offset;
             const version = reader.u8('instanceRoute.version');
-            if (version !== 1 && version !== 2)
+            if (version !== INSTANCE_ROUTE_VERSION && version !== INSTANCE_ACTIVATION_VERSION)
                 fail('Unsupported Instance route version.');
             const routeLength = reader.u16('instanceRoute.length');
             const routeEnd = reader.offset + routeLength;
-            const commonTarget = {
-                targetNodeRid: reader.rid('targetNodeRid'),
-                targetNodeGeneration: reader.nonZeroU64('targetNodeGeneration'),
-                targetSpotId: reader.rid('targetSpotId')
-            };
-            const route = version === 1
+            const generatedReadyRoute = version === INSTANCE_ROUTE_VERSION
+                ? (0, service_wire_codec_generated_1.decodeInstanceRouteV1)(reader.bytes.subarray(routeStart, routeEnd), STATEFUL_MESSAGE_CONTEXT)
+                : undefined;
+            if (generatedReadyRoute !== undefined && generatedReadyRoute.routeKind !== 'ready') {
+                fail('Invalid Ready Instance route kind.');
+            }
+            const commonTarget = generatedReadyRoute?.routeKind === 'ready'
+                ? {
+                    targetNodeRid: fromGeneratedRoutingId(generatedReadyRoute.targetNodeRid, 'targetNodeRid'),
+                    targetNodeGeneration: generatedReadyRoute.targetNodeGeneration,
+                    targetSpotId: generatedReadyRoute.targetSpotId
+                }
+                : {
+                    targetNodeRid: reader.rid('targetNodeRid'),
+                    targetNodeGeneration: reader.nonZeroU64('targetNodeGeneration'),
+                    targetSpotId: reader.rid('targetSpotId')
+                };
+            const route = generatedReadyRoute?.routeKind === 'ready'
                 ? {
                     ...commonTarget,
-                    objectGeneration: reader.nonZeroU64('objectGeneration'),
-                    ownerId: reader.text8('ownerId'),
-                    authorityOwnerGeneration: reader.nonZeroU64('authorityOwnerGeneration'),
-                    leaseGeneration: reader.nonZeroU64('leaseGeneration'),
-                    storeVersion: reader.text16('storeVersion')
+                    ...generatedReadyRoute.authority
                 }
                 : undefined;
-            const target = version === 2
+            const target = version === INSTANCE_ACTIVATION_VERSION
                 ? {
                     ...commonTarget,
                     stableType: reader.text16('stableType'),
                     descriptorVersion: reader.text16('descriptorVersion')
                 }
                 : undefined;
+            if (generatedReadyRoute !== undefined)
+                reader.offset = routeEnd;
             if (reader.offset !== routeEnd)
                 fail('Invalid Instance route body length.');
             const sourceNodeGeneration = reader.nonZeroU64('sourceNodeGeneration');
@@ -900,15 +931,17 @@ function decodeStatefulHeader(frame, payloadFrame, metadataFrame) {
                 low: reader.u64('operation.low')
             };
             const operationKind = operationValue === 1 ? 'send' : 'request';
-            if (version === 1 &&
+            if (version === INSTANCE_ROUTE_VERSION &&
                 ((operationKind === 'send' && (operation.high !== 0n || operation.low !== 0n)) ||
                     (operationKind === 'request' && operation.high === 0n && operation.low === 0n))) {
                 fail('Invalid Instance operation identity.');
             }
-            if (version === 2 && operation.high === 0n && operation.low === 0n) {
+            if (version === INSTANCE_ACTIVATION_VERSION &&
+                operation.high === 0n &&
+                operation.low === 0n) {
                 fail('Instance activation requires a non-zero operation identity.');
             }
-            const deadlineUnixMs = version === 2 ? reader.nonZeroU64('deadlineUnixMs') : undefined;
+            const deadlineUnixMs = version === INSTANCE_ACTIVATION_VERSION ? reader.nonZeroU64('deadlineUnixMs') : undefined;
             const replyRouteId = operationKind === 'request' ? reader.nonZeroU64('replyRouteId') : undefined;
             reader.end();
             const common = {
@@ -920,8 +953,13 @@ function decodeStatefulHeader(frame, payloadFrame, metadataFrame) {
                 operation,
                 ...(replyRouteId === undefined ? {} : { replyRouteId })
             };
-            return version === 1
-                ? { ...common, activation: 'ready', route: route }
+            return version === INSTANCE_ROUTE_VERSION
+                ? {
+                    ...common,
+                    activation: 'ready',
+                    route: route,
+                    instanceIntent: generatedReadyRoute.instanceIntent === 'true'
+                }
                 : {
                     ...common,
                     activation: 'missing',
@@ -931,12 +969,12 @@ function decodeStatefulHeader(frame, payloadFrame, metadataFrame) {
         }
         case exports.M6bServiceWireCommand.messageFollow: {
             requireFlags(command.flags, 0);
-            if (reader.u8('messageFollow.version') !== 1) {
+            if (reader.u8('messageFollow.version') !== MESSAGE_FOLLOW_VERSION) {
                 fail('Unsupported Message Follow version.');
             }
             const length = reader.u32('messageFollow.length');
             const end = reader.offset + length;
-            if (length > 16 * 1024 * 1024 || end > reader.bytes.byteLength) {
+            if (length > MESSAGE_FOLLOW_MAX_BODY_BYTES || end > reader.bytes.byteLength) {
                 fail('Invalid Message Follow body length.');
             }
             const record = {
@@ -1110,7 +1148,7 @@ function decodeStatefulReply(frame, expectedCorrelation, operationKind, hasPaylo
                     ? 0
                     : (() => {
                         const value = reader.u32('receiveChunkLimitBytes');
-                        if (value > exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES) {
+                        if (value > InternalDefaults_1.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES) {
                             fail('receiveChunkLimitBytes exceeds the relocation state chunk data bound.');
                         }
                         return value;
@@ -1214,7 +1252,7 @@ function encodeReplyTail(tail) {
                 }
                 const receiveChunkLimitBytes = tail.receiveChunkLimitBytes ?? 0;
                 if (receiveChunkLimitBytes < 0 ||
-                    receiveChunkLimitBytes > exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES) {
+                    receiveChunkLimitBytes > InternalDefaults_1.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES) {
                     fail('receiveChunkLimitBytes exceeds the relocation state chunk data bound.');
                 }
                 const body = concat(spotRef(tail.spot), u64(tail.membershipEpoch), u32(receiveChunkLimitBytes, 'receiveChunkLimitBytes'));
@@ -1275,7 +1313,7 @@ function validateRelocationPhase(value) {
 }
 function applicationPayload(value) {
     const body = concat(text8(value.packetName, 'packetName'), text8(value.contentType, 'contentType'), u32(value.bytes.byteLength, 'payload.length'), value.bytes);
-    return concat(Buffer.of(1), u32(body.byteLength, 'applicationPayload.length'), body);
+    return concat(Buffer.of(service_wire_m6a_codec_1.APPLICATION_PAYLOAD_VERSION), u32(body.byteLength, 'applicationPayload.length'), body);
 }
 function prefix(command, flags = 0) {
     return Buffer.from([MAGIC_0, MAGIC_1, MAJOR, command, flags]);
@@ -1323,7 +1361,7 @@ function validateMessageFollowRecord(value, invalid = (message) => {
     if (value.originalOperation.high === 0n && value.originalOperation.low === 0n) {
         invalid('Message Follow originalOperation must not be zero.');
     }
-    if (value.originalReplyRouteId < 0n || value.originalReplyRouteId > 0xffffffffffffffffn) {
+    if (value.originalReplyRouteId < 0n || value.originalReplyRouteId > stream_wire_1.UINT64_MAX) {
         invalid('Message Follow originalReplyRouteId must be a u64.');
     }
 }
@@ -1373,7 +1411,7 @@ function u64(value) {
     return result;
 }
 function u64Any(value) {
-    if (value < 0n || value > 0xffffffffffffffffn) {
+    if (value < 0n || value > stream_wire_1.UINT64_MAX) {
         throw new RangeError('u64 value is out of range.');
     }
     const result = Buffer.alloc(8);
@@ -1381,7 +1419,7 @@ function u64Any(value) {
     return result;
 }
 function requirePositive(value, name) {
-    if (value === undefined || value < 1n || value > 0xffffffffffffffffn) {
+    if (value === undefined || value < 1n || value > stream_wire_1.UINT64_MAX) {
         throw new RangeError(`${name} must be a non-zero u64.`);
     }
     return value;
@@ -1828,7 +1866,7 @@ class FrozenReader {
         return new FrozenReader(body);
     }
     applicationPayload() {
-        if (this.u8('applicationPayload.version') !== 1) {
+        if (this.u8('applicationPayload.version') !== service_wire_m6a_codec_1.APPLICATION_PAYLOAD_VERSION) {
             fail('Application payload envelope version must be one.');
         }
         const body = this.body32('application payload');
@@ -1992,26 +2030,22 @@ class FrozenReader {
         body.end('send-ready destination');
     }
     instanceRoute() {
+        const start = this.offset;
         const kind = this.u8('instanceRouteKind');
         if (kind < 1 || kind > 2)
             fail('Invalid Instance route kind.');
         const body = this.body16('Instance route');
+        if (kind === INSTANCE_ROUTE_VERSION) {
+            (0, service_wire_codec_generated_1.decodeInstanceRouteV1)(this.bytes.subarray(start, this.offset), STATEFUL_MESSAGE_CONTEXT);
+            return;
+        }
         body.rid8('targetNodeRid');
         body.nonZeroU64('targetNodeGeneration');
         body.text8('targetSpotId');
-        if (kind === 1) {
-            body.nonZeroU64('objectGeneration');
-            body.text8('ownerId');
-            body.nonZeroU64('authorityOwnerGeneration');
-            body.nonZeroU64('leaseGeneration');
-            body.text16('storeVersion');
-        }
-        else {
-            body.text8('targetMeshName');
-            body.text8('stableType');
-            body.text8('targetDescriptorVersion');
-            body.nonZeroU64('deadlineUnixMs');
-        }
+        body.text8('targetMeshName');
+        body.text8('stableType');
+        body.text8('targetDescriptorVersion');
+        body.nonZeroU64('deadlineUnixMs');
         body.end('Instance route');
     }
     relocationObject() {

package/dist/runtime/foundation/service-topology-registry.d.ts

@@ -51,7 +51,6 @@ export declare class ServiceTopologyRegistry {
     private peersCore;
     notRequiredPeers(): readonly ServiceNodeDescriptor[];
     replaceDiscoveredNotRequired(descriptors: readonly ServiceNodeDescriptor[]): void;
-    markNotRequired(descriptor: ServiceNodeDescriptor): void;
     forgetNotRequired(nodeRoutingId: string): void;
     knownDescriptor(nodeRoutingId: string): ServiceNodeDescriptor | undefined;
     hasKnownChannelTarget(channelName: string): boolean;

package/dist/runtime/foundation/service-topology-registry.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceTopologyRegistry = void 0;
 exports.validateDescriptor = validateDescriptor;
 exports.sameServiceNodeDescriptor = sameServiceNodeDescriptor;
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
+const RegistrationBuilderPolicy_1 = require("../../contracts/Configuration/RegistrationBuilderPolicy");
 const route_mesh_connection_policy_1 = require("./route-mesh-connection-policy");
 const service_weighted_selection_1 = require("./service-weighted-selection");
 const service_wire_constants_generated_1 = require("./service-wire-constants.generated");
 const REQUIRED_CAPABILITY = service_wire_constants_generated_1.SERVICE_WIRE_REQUIRED_CAPABILITY;
-const MAX_CAPACITY = 0x7fff_ffff;
-const MAX_PUBLIC_WEIGHT = 10_000;
 /** Owns immutable peer snapshots and fences late physical-connection events. */
 class ServiceTopologyRegistry {
     local;
@@ -134,18 +134,6 @@ class ServiceTopologyRegistry {
         }
         this.rebuildSelections();
     }
-    markNotRequired(descriptor) {
-        validateDescriptor(descriptor);
-        if (descriptor.meshName !== this.local.meshName ||
-            descriptor.nodeRoutingId === this.local.nodeRoutingId ||
-            !(0, route_mesh_connection_policy_1.descriptorConnectionNotRequired)(this.local, descriptor)) {
-            return;
-        }
-        this.peersByRid.delete(descriptor.nodeRoutingId);
-        this.remember(descriptor);
-        this.notRequiredByRid.set(descriptor.nodeRoutingId, cloneDescriptor(descriptor));
-        this.rebuildSelections();
-    }
     forgetNotRequired(nodeRoutingId) {
         if (this.notRequiredByRid.delete(nodeRoutingId))
             this.rebuildSelections();
@@ -157,7 +145,10 @@ class ServiceTopologyRegistry {
     }
     hasKnownChannelTarget(channelName) {
         requireText(channelName, 'channelName');
-        return [this.local, ...this.knownByRid.values()].some((descriptor) => selectableChannel(descriptor, channelName) !== undefined);
+        return [...this.knownByRid.values()].some((descriptor) => (descriptor.state === 'serving' ||
+            descriptor.state === 'retiring' ||
+            descriptor.state === 'draining') &&
+            findChannel(descriptor, channelName) !== undefined);
     }
     remember(descriptor) {
         const current = this.knownByRid.get(descriptor.nodeRoutingId);
@@ -170,18 +161,12 @@ class ServiceTopologyRegistry {
     }
     selectChannel(channelName, isReady = () => true) {
         requireText(channelName, 'channelName');
-        return this.selectWeightedCycle(`channel:${channelName}`, () => {
-            const local = {
-                descriptor: cloneDescriptor(this.local),
-                connectionId: 'local'
-            };
-            return [local, ...this.peersByRid.values()]
-                .map((peer) => ({
-                peer: clonePeer(peer),
-                channel: selectableChannel(peer.descriptor, channelName)
-            }))
-                .filter((value) => value.channel !== undefined);
-        }, (value) => value.channel.weight, (value) => value.peer.descriptor.nodeRoutingId, (left, right) => compareOrdinal(left.peer.descriptor.nodeRoutingId, right.peer.descriptor.nodeRoutingId), (value) => isReady(value.peer))?.peer;
+        return this.selectWeightedCycle(`channel:${channelName}`, () => [...this.peersByRid.values()]
+            .map((peer) => ({
+            peer: clonePeer(peer),
+            channel: selectableChannel(peer.descriptor, channelName)
+        }))
+            .filter((value) => value.channel !== undefined), (value) => value.channel.weight, (value) => value.peer.descriptor.nodeRoutingId, (left, right) => compareOrdinal(left.peer.descriptor.nodeRoutingId, right.peer.descriptor.nodeRoutingId), (value) => isReady(value.peer))?.peer;
     }
     selectPlacement(isReady = () => true) {
         return this.selectWeightedCycle('placement', () => [...this.peersByRid.values()]
@@ -275,8 +260,8 @@ function validateDescriptor(descriptor) {
     }
     if (descriptor.maintenanceWave !== undefined) {
         requireText(descriptor.maintenanceWave, 'maintenanceWave');
-        if (Buffer.byteLength(descriptor.maintenanceWave, 'utf8') > 255) {
-            throw new RangeError('maintenanceWave must not exceed 255 UTF-8 bytes.');
+        if (Buffer.byteLength(descriptor.maintenanceWave, 'utf8') > CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES) {
+            throw new RangeError(`maintenanceWave must not exceed ${CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES} UTF-8 bytes.`);
         }
     }
     validatePublicWeight(descriptor.placementWeight, 'placementWeight');
@@ -302,13 +287,13 @@ function validateDescriptor(descriptor) {
     }
 }
 function validateCapacity(value, allowZero, field) {
-    if (!Number.isInteger(value) || value < (allowZero ? 0 : 1) || value > MAX_CAPACITY) {
+    if (!(allowZero ? (0, RegistrationBuilderPolicy_1.isValidCapacity)(value) : (0, RegistrationBuilderPolicy_1.isValidPositiveCapacity)(value))) {
         throw new RangeError(`${field} is outside its supported range.`);
     }
 }
 function validatePublicWeight(value, field) {
-    if (!Number.isInteger(value) || value < 0 || value > MAX_PUBLIC_WEIGHT) {
-        throw new RangeError(`${field} must be an integer in 0..10000.`);
+    if (!(0, RegistrationBuilderPolicy_1.isValidPublicWeight)(value)) {
+        throw new RangeError(`${field} must be an integer in 0..${RegistrationBuilderPolicy_1.ZLINK_MAX_PUBLIC_WEIGHT}.`);
     }
 }
 function validateSortedUnique(values, key, field) {

package/dist/runtime/foundation/service-wire-binary-primitives.d.ts

@@ -1,4 +1,9 @@
 import type { RoutingId } from '../../contracts';
+export declare const SERVICE_WIRE_MAJOR_OFFSET = 2;
+export declare const SERVICE_WIRE_COMMAND_OFFSET: number;
+export declare const SERVICE_WIRE_FLAGS_OFFSET: number;
+export declare const SERVICE_WIRE_PREFIX_SIZE: number;
+export declare const SERVICE_WIRE_TEXT8_MAX_BYTES = 255;
 export type ServiceWireInvalid = (message: string) => never;
 /** Encodes text without silently replacing an unpaired UTF-16 surrogate. */
 export declare function encodeCanonicalServiceWireText(value: string, field: string, maximumBytes: number, invalid: ServiceWireInvalid): Buffer;

package/dist/runtime/foundation/service-wire-binary-primitives.js

@@ -1,10 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICE_WIRE_TEXT8_MAX_BYTES = exports.SERVICE_WIRE_PREFIX_SIZE = exports.SERVICE_WIRE_FLAGS_OFFSET = exports.SERVICE_WIRE_COMMAND_OFFSET = exports.SERVICE_WIRE_MAJOR_OFFSET = void 0;
 exports.encodeCanonicalServiceWireText = encodeCanonicalServiceWireText;
 exports.decodeCanonicalServiceWireText = decodeCanonicalServiceWireText;
 exports.encodeServiceWireRoutingId = encodeServiceWireRoutingId;
 exports.decodeServiceWireRoutingId = decodeServiceWireRoutingId;
 const routing_id_1 = require("../routing-id");
+exports.SERVICE_WIRE_MAJOR_OFFSET = 2;
+exports.SERVICE_WIRE_COMMAND_OFFSET = exports.SERVICE_WIRE_MAJOR_OFFSET + 1;
+exports.SERVICE_WIRE_FLAGS_OFFSET = exports.SERVICE_WIRE_COMMAND_OFFSET + 1;
+exports.SERVICE_WIRE_PREFIX_SIZE = exports.SERVICE_WIRE_FLAGS_OFFSET + 1;
+exports.SERVICE_WIRE_TEXT8_MAX_BYTES = 255;
 /** Encodes text without silently replacing an unpaired UTF-16 surrogate. */
 function encodeCanonicalServiceWireText(value, field, maximumBytes, invalid) {
     const bytes = Buffer.from(value, 'utf8');

package/dist/runtime/foundation/service-wire-codec.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceWireDecodeError = void 0;
 exports.createServiceWireCodec = createServiceWireCodec;
-const PREFIX_SIZE = 5;
+const stream_wire_1 = require("@zlink-systems/stream-wire");
+const service_wire_binary_primitives_1 = require("./service-wire-binary-primitives");
+const PREFIX_SIZE = service_wire_binary_primitives_1.SERVICE_WIRE_PREFIX_SIZE;
 const LIVENESS_FRAME_SIZE = PREFIX_SIZE + 8;
 class ServiceWireDecodeError extends Error {
     code;
@@ -21,15 +23,15 @@ function createServiceWireCodec(definition) {
                 record.command !== definition.commands.livenessAck) {
                 throw new RangeError('command must be a liveness command.');
             }
-            if (record.probeId <= 0n || record.probeId > 0xffffffffffffffffn) {
+            if (record.probeId <= 0n || record.probeId > stream_wire_1.UINT64_MAX) {
                 throw new RangeError('probeId must be a non-zero unsigned 64-bit integer.');
             }
             const frame = Buffer.allocUnsafe(LIVENESS_FRAME_SIZE);
             frame[0] = definition.magic[0];
             frame[1] = definition.magic[1];
-            frame[2] = definition.major;
-            frame[3] = record.command;
-            frame[4] = 0;
+            frame[service_wire_binary_primitives_1.SERVICE_WIRE_MAJOR_OFFSET] = definition.major;
+            frame[service_wire_binary_primitives_1.SERVICE_WIRE_COMMAND_OFFSET] = record.command;
+            frame[service_wire_binary_primitives_1.SERVICE_WIRE_FLAGS_OFFSET] = 0;
             frame.writeBigUInt64BE(record.probeId, PREFIX_SIZE);
             return frame;
         },
@@ -39,16 +41,16 @@ function createServiceWireCodec(definition) {
             if (frame[0] !== definition.magic[0] || frame[1] !== definition.magic[1]) {
                 fail('invalid-magic');
             }
-            if (frame[2] !== definition.major)
+            if (frame[service_wire_binary_primitives_1.SERVICE_WIRE_MAJOR_OFFSET] !== definition.major)
                 fail('unsupported-major');
-            const command = frame[3];
+            const command = frame[service_wire_binary_primitives_1.SERVICE_WIRE_COMMAND_OFFSET];
             if (!knownCommands.has(command))
                 fail('unknown-command');
             if (command !== definition.commands.livenessProbe &&
                 command !== definition.commands.livenessAck) {
                 fail('unknown-command');
             }
-            if (frame[4] !== 0)
+            if (frame[service_wire_binary_primitives_1.SERVICE_WIRE_FLAGS_OFFSET] !== 0)
                 fail('forbidden-flag');
             if (frame.byteLength < LIVENESS_FRAME_SIZE)
                 fail('truncated-field');

package/dist/runtime/foundation/service-wire-constants.generated.d.ts

@@ -1,5 +1,6 @@
 export declare const SERVICE_WIRE_MAGIC: readonly [90, 77];
 export declare const SERVICE_WIRE_MAJOR: 1;
+export declare const SERVICE_WIRE_METADATA_BYTES: 1024;
 export declare const SERVICE_WIRE_REQUIRED_CAPABILITY: "framework-service-v13";
 export declare const SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME: "ZLinkFrameworkMultipart";
 export declare const SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE: "application/x-zlink-multipart";

package/dist/runtime/foundation/service-wire-constants.generated.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidServiceWireTerminalFailure = exports.ServiceWireExactTerminalByFailureCode = exports.ServiceWireBoundaryTerminalResults = exports.ServiceWireFrameworkErrorCode = exports.ServiceWireFlag = exports.ServiceWireCommand = exports.SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE = exports.SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME = exports.SERVICE_WIRE_REQUIRED_CAPABILITY = exports.SERVICE_WIRE_MAJOR = exports.SERVICE_WIRE_MAGIC = void 0;
+exports.isValidServiceWireTerminalFailure = exports.ServiceWireExactTerminalByFailureCode = exports.ServiceWireBoundaryTerminalResults = exports.ServiceWireFrameworkErrorCode = exports.ServiceWireFlag = exports.ServiceWireCommand = exports.SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE = exports.SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME = exports.SERVICE_WIRE_REQUIRED_CAPABILITY = exports.SERVICE_WIRE_METADATA_BYTES = exports.SERVICE_WIRE_MAJOR = exports.SERVICE_WIRE_MAGIC = void 0;
 // Generated from service-wire-v1.schema.json. Do not edit.
 exports.SERVICE_WIRE_MAGIC = [90, 77];
 exports.SERVICE_WIRE_MAJOR = 1;
+exports.SERVICE_WIRE_METADATA_BYTES = 1024;
 exports.SERVICE_WIRE_REQUIRED_CAPABILITY = "framework-service-v13";
 exports.SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME = "ZLinkFrameworkMultipart";
 exports.SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE = "application/x-zlink-multipart";

package/dist/runtime/foundation/service-wire-m6a-codec.d.ts

@@ -1,4 +1,6 @@
 import { type ServiceNodeDescriptor } from './service-topology-registry';
+export declare const APPLICATION_PAYLOAD_VERSION = 1;
+export declare const APPLICATION_PAYLOAD_MINIMUM_FIELD_BYTES: number;
 export declare const M6A_SERVICE_WIRE_MAGIC: readonly [90, 77];
 export declare const M6A_SERVICE_WIRE_MAJOR: 1;
 export declare const M6A_SERVICE_WIRE_REQUIRED_CAPABILITY: "framework-service-v13";