@zlink-systems/framework 0.21.0 → 0.23.0

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

@@ -54,9 +54,7 @@ exports.RELOCATION_PAYLOAD_CHUNK_COUNT_MAX = 4096;
 exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = 67_108_864;
 exports.M6bServiceWireFlag = service_wire_constants_generated_1.ServiceWireFlag;
 function serviceSessionRelocationIdentityKey(value) {
-    const actor = 'targetNodeGeneration' in value.actor
-        ? value.actor.actor
-        : value.actor;
+    const actor = 'targetNodeGeneration' in value.actor ? value.actor.actor : value.actor;
     //  Session owner가 seal을 대조할 때 쓰는 값만 넣는다 — Session과 Actor binding
     //  §8.1 "Session owner는 다음 값만 검증한다". coordinator identity는 transport가
     //  검증하는 wire fence이므로 여기서 다시 대조하지 않는다.
@@ -457,13 +455,15 @@ function toGeneratedReplyRelay(value) {
         },
         terminalResult: value.terminalResult,
         failureCode: value.failureCode,
-        ...(value.payload === undefined ? {} : {
-            payload: {
-                packetName: value.payload.packetName,
-                contentType: value.payload.contentType,
-                payload: value.payload.bytes
-            }
-        })
+        ...(value.payload === undefined
+            ? {}
+            : {
+                payload: {
+                    packetName: value.payload.packetName,
+                    contentType: value.payload.contentType,
+                    payload: value.payload.bytes
+                }
+            })
     };
 }
 function fromGeneratedReplyRelay(value) {
@@ -480,27 +480,25 @@ function fromGeneratedReplyRelay(value) {
         sequence: value.context.sequence,
         terminalResult: value.terminalResult,
         failureCode: value.failureCode,
-        ...(value.payload === undefined ? {} : {
-            payload: {
-                packetName: value.payload.packetName,
-                contentType: value.payload.contentType,
-                bytes: Buffer.from(value.payload.payload)
-            }
-        })
+        ...(value.payload === undefined
+            ? {}
+            : {
+                payload: {
+                    packetName: value.payload.packetName,
+                    contentType: value.payload.contentType,
+                    bytes: Buffer.from(value.payload.payload)
+                }
+            })
     };
 }
 function encodeSpotHeader(kind, sourceSpotId, target, correlation) {
-    return concat(prefix(kind === 'spotSend'
-        ? exports.M6bServiceWireCommand.spotSend
-        : exports.M6bServiceWireCommand.spotRequest), ...(kind === 'spotRequest' ? [u64(requirePositive(correlation, 'correlation'))] : []), rid(sourceSpotId, 'sourceSpotId'), directSpotFence(target));
+    return concat(prefix(kind === 'spotSend' ? exports.M6bServiceWireCommand.spotSend : exports.M6bServiceWireCommand.spotRequest), ...(kind === 'spotRequest' ? [u64(requirePositive(correlation, 'correlation'))] : []), rid(sourceSpotId, 'sourceSpotId'), directSpotFence(target));
 }
 function encodeActorHeader(kind, target, correlation, sourceActor, boundSession) {
     const flags = boundSession === undefined
         ? 0
         : exports.M6bServiceWireFlag.boundSession | exports.M6bServiceWireFlag.sourceSpotId;
-    return concat(prefix(kind === 'actorSend'
-        ? exports.M6bServiceWireCommand.actorSend
-        : exports.M6bServiceWireCommand.actorRequest, flags), ...(kind === 'actorRequest' ? [u64(requirePositive(correlation, 'correlation'))] : []), optionalActor(sourceActor), actorFence(target), ...(boundSession === undefined
+    return concat(prefix(kind === 'actorSend' ? exports.M6bServiceWireCommand.actorSend : exports.M6bServiceWireCommand.actorRequest, flags), ...(kind === 'actorRequest' ? [u64(requirePositive(correlation, 'correlation'))] : []), optionalActor(sourceActor), actorFence(target), ...(boundSession === undefined
         ? []
         : [
             rid(boundSession.sessionRid, 'sourceSessionRid'),
@@ -521,9 +519,7 @@ function encodeBoundSessionSendHeader(actor, expectedBindingGeneration) {
     return concat(prefix(exports.M6bServiceWireCommand.boundSessionSend), actorFence(actor), u64(expectedBindingGeneration));
 }
 function encodeBoundSessionBindHeader(correlation, actor, sessionRid, binding) {
-    const body = binding.state === 'active'
-        ? u64(binding.generation)
-        : u64(binding.retiredGeneration);
+    const body = binding.state === 'active' ? u64(binding.generation) : u64(binding.retiredGeneration);
     return concat(prefix(exports.M6bServiceWireCommand.boundSessionBind), u64(correlation), actorFence(actor), rid(sessionRid, 'sessionRid'), Buffer.of(binding.state === 'active' ? 1 : 2), u16(body.byteLength), body);
 }
 function encodeBoundSessionReplacedHeader(actorAuthority, retiredSession) {
@@ -555,16 +551,14 @@ function decodeSessionRelocationRoute(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'));
-    if (operationKind === 'send'
-        && (operation.high !== 0n || operation.low !== 0n || replyRouteId !== undefined)) {
+    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.');
     }
     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), 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'))] : []));
 }
 function encodeInstanceSpotActivationHeader(target, sourceNodeGeneration, sourceNodeRid, sourceSpotId, operationKind, operation, deadlineUnixMs, replyRouteId, hasMetadata = false) {
     if (operation.high === 0n && operation.low === 0n) {
@@ -577,9 +571,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(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'))] : []));
 }
 function encodeUserSpotCreateHeader(record) {
     return Buffer.from((0, service_wire_pilot_codec_generated_1.encodeUserSpotCreate47)(toGeneratedUserSpotCreate(record)));
@@ -629,9 +621,7 @@ function decodeStatefulHeader(frame) {
         case exports.M6bServiceWireCommand.actorRequest: {
             const request = command.command === exports.M6bServiceWireCommand.actorRequest;
             const hasBinding = command.flags !== 0;
-            requireFlags(command.flags, hasBinding
-                ? exports.M6bServiceWireFlag.boundSession | exports.M6bServiceWireFlag.sourceSpotId
-                : 0);
+            requireFlags(command.flags, hasBinding ? exports.M6bServiceWireFlag.boundSession | exports.M6bServiceWireFlag.sourceSpotId : 0);
             const correlation = request ? reader.nonZeroU64('correlation') : undefined;
             const sourceActor = reader.optionalActor();
             const target = reader.actorFence();
@@ -806,19 +796,16 @@ function decodeStatefulHeader(frame) {
                 low: reader.u64('operation.low')
             };
             const operationKind = operationValue === 1 ? 'send' : 'request';
-            if (version === 1 && ((operationKind === 'send' && (operation.high !== 0n || operation.low !== 0n))
-                || (operationKind === 'request' && operation.high === 0n && operation.low === 0n))) {
+            if (version === 1 &&
+                ((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) {
                 fail('Instance activation requires a non-zero operation identity.');
             }
-            const deadlineUnixMs = version === 2
-                ? reader.nonZeroU64('deadlineUnixMs')
-                : undefined;
-            const replyRouteId = operationKind === 'request'
-                ? reader.nonZeroU64('replyRouteId')
-                : undefined;
+            const deadlineUnixMs = version === 2 ? reader.nonZeroU64('deadlineUnixMs') : undefined;
+            const replyRouteId = operationKind === 'request' ? reader.nonZeroU64('replyRouteId') : undefined;
             reader.end();
             const common = {
                 kind: 'instanceSpot',
@@ -1122,8 +1109,8 @@ function encodeReplyTail(tail) {
                     fail('Accepted actor join requires a membership epoch.');
                 }
                 const receiveChunkLimitBytes = tail.receiveChunkLimitBytes ?? 0;
-                if (receiveChunkLimitBytes < 0
-                    || receiveChunkLimitBytes > exports.RELOCATION_STATE_CHUNK_DATA_MAX_BYTES) {
+                if (receiveChunkLimitBytes < 0 ||
+                    receiveChunkLimitBytes > exports.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'));
@@ -1166,8 +1153,18 @@ function validateReplyTerminal(terminalResult, failureCode, hasPayload) {
     }
 }
 function validateRelocationPhase(value) {
-    const phases = ['none', 'preparing', 'captured', 'prepared', 'committed',
-        'activating', 'activated', 'cleaning', 'completed', 'aborted'];
+    const phases = [
+        'none',
+        'preparing',
+        'captured',
+        'prepared',
+        'committed',
+        'activating',
+        'activated',
+        'cleaning',
+        'completed',
+        'aborted'
+    ];
     if (!Number.isInteger(value) || value < 0 || value >= phases.length) {
         fail('Invalid relocationData control phase.');
     }
@@ -1197,37 +1194,38 @@ function messageFollowRoute(value) {
         : concat(spotRef(value.spot), rid(value.targetNodeRid, 'targetNodeRid'), u64(value.targetNodeGeneration), u64(value.authorityOwnerGeneration), u64(value.ownerLeaseGeneration));
     return concat(Buffer.of(value.kind === 'actor' ? 1 : 2), u16(body.byteLength), body);
 }
-function validateMessageFollowRecord(value, invalid = (message) => { throw new RangeError(message); }) {
+function validateMessageFollowRecord(value, invalid = (message) => {
+    throw new RangeError(message);
+}) {
     if (value.source.kind !== value.target.kind) {
         invalid('Message Follow source and target object kinds differ.');
     }
     const sameObject = value.source.kind === 'actor' && value.target.kind === 'actor'
-        ? value.source.actor.actorId === value.target.actor.actorId
-            && value.source.actor.generation === value.target.actor.generation
+        ? value.source.actor.actorId === value.target.actor.actorId &&
+            value.source.actor.generation === value.target.actor.generation
         : value.source.kind === 'spot' && value.target.kind === 'spot'
-            ? value.source.spot.spotId === value.target.spot.spotId
-                && value.source.spot.generation === value.target.spot.generation
+            ? value.source.spot.spotId === value.target.spot.spotId &&
+                value.source.spot.generation === value.target.spot.generation
             : false;
     if (!sameObject)
         invalid('Message Follow source and target object identities differ.');
     if (!Number.isInteger(value.hopCount) || value.hopCount < 1 || value.hopCount > 8) {
         invalid('Message Follow hopCount must be in 1..8.');
     }
-    if (!Number.isInteger(value.queuedMessages)
-        || value.queuedMessages < 0
-        || value.queuedMessages > 0xffff_ffff) {
+    if (!Number.isInteger(value.queuedMessages) ||
+        value.queuedMessages < 0 ||
+        value.queuedMessages > 0xffff_ffff) {
         invalid('Message Follow queuedMessages must be a u32.');
     }
-    if (!Number.isInteger(value.queuedBytes)
-        || value.queuedBytes < 0
-        || value.queuedBytes > 0xffff_ffff) {
+    if (!Number.isInteger(value.queuedBytes) ||
+        value.queuedBytes < 0 ||
+        value.queuedBytes > 0xffff_ffff) {
         invalid('Message Follow queuedBytes must be a u32.');
     }
     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 > 0xffffffffffffffffn) {
         invalid('Message Follow originalReplyRouteId must be a u64.');
     }
 }
@@ -1300,7 +1298,7 @@ function requireFlags(actual, expected) {
         fail(`Invalid command flags '${actual}'.`);
 }
 function concat(...parts) {
-    return Buffer.concat(parts.map(part => Buffer.from(part)));
+    return Buffer.concat(parts.map((part) => Buffer.from(part)));
 }
 function fail(message) {
     throw new service_wire_m6a_codec_1.ServiceWireProtocolError(message);
@@ -1324,9 +1322,9 @@ class Reader {
     }
     prefix() {
         this.need(PREFIX_SIZE, 'prefix');
-        if (this.bytes[this.offset] !== MAGIC_0
-            || this.bytes[this.offset + 1] !== MAGIC_1
-            || this.bytes[this.offset + 2] !== MAJOR) {
+        if (this.bytes[this.offset] !== MAGIC_0 ||
+            this.bytes[this.offset + 1] !== MAGIC_1 ||
+            this.bytes[this.offset + 2] !== MAJOR) {
             fail('Invalid service wire prefix.');
         }
         const command = this.bytes[this.offset + 3];
@@ -1536,7 +1534,10 @@ function decodeServiceWireFrozenRecordPrefix(bytes, offset = 0) {
     const reader = new FrozenReader(bytes.subarray(offset));
     const record = decodeServiceWireFrozenRecordFrom(reader);
     return {
-        record: { ...record, canonicalBytes: Buffer.from(bytes.subarray(offset, offset + reader.position)) },
+        record: {
+            ...record,
+            canonicalBytes: Buffer.from(bytes.subarray(offset, offset + reader.position))
+        },
         length: reader.position
     };
 }
@@ -1579,8 +1580,10 @@ function decodeServiceWireFrozenRecordFrom(reader) {
     }
     const hasMetadata = reader.bool8('hasMetadata');
     if (hasMetadata) {
-        if (!((recordKind >= 1 && recordKind <= 7)
-            || recordKind === 9 || recordKind === 10 || recordKind === 14)) {
+        if (!((recordKind >= 1 && recordKind <= 7) ||
+            recordKind === 9 ||
+            recordKind === 10 ||
+            recordKind === 14)) {
             fail('Metadata is forbidden for this frozen record kind.');
         }
         reader.metadata();
@@ -1594,9 +1597,7 @@ function decodeServiceWireFrozenRecordFrom(reader) {
         fail('Invalid frozen operation kind.');
     const replyReader = reader.body16('frozen reply route');
     const requiresReply = (0, service_runtime_contracts_1.operationRequiresReply)(operationKind);
-    const replyRouteId = requiresReply
-        ? replyReader.nonZeroU64('replyRouteId')
-        : undefined;
+    const replyRouteId = requiresReply ? replyReader.nonZeroU64('replyRouteId') : undefined;
     replyReader.end('frozen reply route');
     const body = reader.frozenBody(recordKind);
     validateFrozenOperationMatrix(recordKind, operationKind, operationId, replyRouteId, body.instanceOperationKind);
@@ -1638,24 +1639,24 @@ function encodeServiceWireFrozenActorApplicationRecord(input) {
     return decodeServiceWireFrozenRecord(bytes);
 }
 function sameFrozenRecordSummary(left, right) {
-    return left.recordKind === right.recordKind
-        && left.sourceKind === right.sourceKind
-        && (0, routing_id_1.routingIdsEqual)(left.source.nodeRid, right.source.nodeRid)
-        && left.source.nodeGeneration === right.source.nodeGeneration
-        && left.source.ownerId === right.source.ownerId
-        && left.source.leaseGeneration === right.source.leaseGeneration
-        && left.sourceSpotId === right.sourceSpotId
-        && left.sourceActor?.actorId === right.sourceActor?.actorId
-        && left.sourceActor?.generation === right.sourceActor?.generation
-        && left.sourceSessionRid === right.sourceSessionRid
-        && left.sourceBindingGeneration === right.sourceBindingGeneration
-        && left.sourceSessionSequence === right.sourceSessionSequence
-        && left.hasMetadata === right.hasMetadata
-        && left.operationId.high === right.operationId.high
-        && left.operationId.low === right.operationId.low
-        && left.operationKind === right.operationKind
-        && left.replyRouteId === right.replyRouteId
-        && left.canonicalBytes.equals(right.canonicalBytes);
+    return (left.recordKind === right.recordKind &&
+        left.sourceKind === right.sourceKind &&
+        (0, routing_id_1.routingIdsEqual)(left.source.nodeRid, right.source.nodeRid) &&
+        left.source.nodeGeneration === right.source.nodeGeneration &&
+        left.source.ownerId === right.source.ownerId &&
+        left.source.leaseGeneration === right.source.leaseGeneration &&
+        left.sourceSpotId === right.sourceSpotId &&
+        left.sourceActor?.actorId === right.sourceActor?.actorId &&
+        left.sourceActor?.generation === right.sourceActor?.generation &&
+        left.sourceSessionRid === right.sourceSessionRid &&
+        left.sourceBindingGeneration === right.sourceBindingGeneration &&
+        left.sourceSessionSequence === right.sourceSessionSequence &&
+        left.hasMetadata === right.hasMetadata &&
+        left.operationId.high === right.operationId.high &&
+        left.operationId.low === right.operationId.low &&
+        left.operationKind === right.operationKind &&
+        left.replyRouteId === right.replyRouteId &&
+        left.canonicalBytes.equals(right.canonicalBytes));
 }
 function validateFrozenOperationMatrix(recordKind, operationKind, operationId, replyRouteId, instanceOperationKind) {
     const zero = operationId.high === 0n && operationId.low === 0n;
@@ -1673,15 +1674,13 @@ function validateFrozenOperationMatrix(recordKind, operationKind, operationId, r
     else if (recordKind === 10)
         valid = operationKind === 4 && !zero;
     else if (recordKind === 8) {
-        valid = operationKind === 0 && zero
-            || [6, 7, 8].includes(operationKind) && !zero;
+        valid = (operationKind === 0 && zero) || ([6, 7, 8].includes(operationKind) && !zero);
     }
     else if (recordKind === 11)
         valid = operationKind >= 1 && operationKind <= 15 && !zero;
     else if (recordKind === 14 && instanceOperationKind !== undefined) {
-        valid = instanceOperationKind === 1
-            ? operationKind === 0 && zero
-            : operationKind === 12 && !zero;
+        valid =
+            instanceOperationKind === 1 ? operationKind === 0 && zero : operationKind === 12 && !zero;
     }
     if (!valid)
         fail('Frozen record kind, operation kind, and operation ID do not match.');
@@ -1825,9 +1824,7 @@ class FrozenReader {
             const failureCode = this.u32('failureCode');
             const hasPayload = this.bool8('hasPayload');
             validateReplyTerminal(terminalResult, failureCode, hasPayload);
-            return hasPayload
-                ? { applicationPayload: this.applicationPayload() }
-                : {};
+            return hasPayload ? { applicationPayload: this.applicationPayload() } : {};
         }
         else if (recordKind === 12)
             this.sendReadyDestination();

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

@@ -55,6 +55,7 @@ export declare class ServiceTopologyRegistry {
     markNotRequired(descriptor: ServiceNodeDescriptor): void;
     forgetNotRequired(nodeRoutingId: string): void;
     knownDescriptor(nodeRoutingId: string): ServiceNodeDescriptor | undefined;
+    hasKnownChannelTarget(channelName: string): boolean;
     private remember;
     selectChannel(channelName: string, isReady?: (peer: AdmittedServicePeer) => boolean): AdmittedServicePeer | undefined;
     selectPlacement(isReady?: (peer: AdmittedServicePeer) => boolean): AdmittedServicePeer | undefined;