@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/channels/channel-envelope.js

@@ -40,7 +40,10 @@ function encodeChannelEnvelopeParts(kind, channelName, packetName, payload, time
     const encoded = encodePayload(payload, (0, channel_framework_packets_1.codecsForFrameworkPacket)(messageName, codecs), messageName, 'payload');
     const flow = createFlow ? (0, flow_context_1.currentOrCreateFlow)('Application') : undefined;
     const envelopeCorrelationId = correlationIdForOutboundKind(kind, correlationId);
-    return [encodeChannelHeader(kind, channelName, messageName, encoded.contentType, envelopeCorrelationId, timeoutMs === undefined ? null : new Date(Date.now() + timeoutMs).toISOString(), topic ?? null, null, null, undefined, applicationMetadataRecord(metadata), flow?.flowId, flow?.flowOrigin), encoded.message];
+    return [
+        encodeChannelHeader(kind, channelName, messageName, encoded.contentType, envelopeCorrelationId, timeoutMs === undefined ? null : new Date(Date.now() + timeoutMs).toISOString(), topic ?? null, null, null, undefined, applicationMetadataRecord(metadata), flow?.flowId, flow?.flowOrigin),
+        encoded.message
+    ];
 }
 /**
  * Encodes an outbound channel envelope with a deadline that was established
@@ -56,17 +59,26 @@ function encodeChannelEnvelopePartsAtDeadline(kind, channelName, packetName, pay
     const encoded = encodePayload(payload, (0, channel_framework_packets_1.codecsForFrameworkPacket)(messageName, codecs), messageName, 'payload');
     const flow = createFlow ? (0, flow_context_1.currentOrCreateFlow)('Application') : undefined;
     const envelopeCorrelationId = correlationIdForOutboundKind(kind, correlationId);
-    return [encodeChannelHeader(kind, channelName, messageName, encoded.contentType, envelopeCorrelationId, new Date(deadlineUnixMs).toISOString(), topic ?? null, null, null, undefined, applicationMetadataRecord(metadata), flow?.flowId, flow?.flowOrigin), encoded.message];
+    return [
+        encodeChannelHeader(kind, channelName, messageName, encoded.contentType, envelopeCorrelationId, new Date(deadlineUnixMs).toISOString(), topic ?? null, null, null, undefined, applicationMetadataRecord(metadata), flow?.flowId, flow?.flowOrigin),
+        encoded.message
+    ];
 }
 function encodeChannelPublishEnvelopeParts(channelName, topic, packetName, payload, codecs, createFlow = true, metadata = EMPTY_OUTBOUND_METADATA) {
     const messageName = (0, packet_name_1.resolveFrameworkPacketName)(payload, packetName, 'Channel');
     const encoded = encodePayload(payload, (0, channel_framework_packets_1.codecsForFrameworkPacket)(messageName, codecs), messageName, 'payload');
     const flow = createFlow ? (0, flow_context_1.currentOrCreateFlow)('Application') : undefined;
-    return [encodeChannelHeader(4 /* ZLinkChannelMessageKind.Publish */, channelName, messageName, encoded.contentType, null, null, topic, null, null, undefined, applicationMetadataRecord(metadata), flow?.flowId, flow?.flowOrigin), encoded.message];
+    return [
+        encodeChannelHeader(4 /* ZLinkChannelMessageKind.Publish */, channelName, messageName, encoded.contentType, null, null, topic, null, null, undefined, applicationMetadataRecord(metadata), flow?.flowId, flow?.flowOrigin),
+        encoded.message
+    ];
 }
 function encodeChannelReplyParts(request, payload, codecs) {
     const encoded = encodePayload(payload ?? Buffer.alloc(0), (0, channel_framework_packets_1.codecsForFrameworkPacket)(request.messageName, codecs), request.messageName, 'reply');
-    return [encodeChannelHeader(2 /* ZLinkChannelMessageKind.Response */, request.channelName, request.messageName, encoded.contentType, request.correlationId, null, null, undefined, undefined, undefined, EMPTY_APPLICATION_METADATA, request.flowId, request.flowOrigin), encoded.message];
+    return [
+        encodeChannelHeader(2 /* ZLinkChannelMessageKind.Response */, request.channelName, request.messageName, encoded.contentType, request.correlationId, null, null, undefined, undefined, undefined, EMPTY_APPLICATION_METADATA, request.flowId, request.flowOrigin),
+        encoded.message
+    ];
 }
 /**
  * Reply metadata marker for errors the framework generated itself (never for
@@ -101,11 +113,12 @@ function channelErrorCodeName(kind) {
     return ERROR_KIND_WIRE_NAMES[kind] ?? 'internal_failure';
 }
 function encodeChannelErrorReplyParts(request, error, metadata = {}) {
-    const errorCode = channelErrorCodeName(error instanceof contracts_1.ZLinkFrameworkException
-        ? error.kind
-        : contracts_1.ZLinkFrameworkErrorKind.InternalFailure);
+    const errorCode = channelErrorCodeName(error instanceof contracts_1.ZLinkFrameworkException ? error.kind : contracts_1.ZLinkFrameworkErrorKind.InternalFailure);
     const errorMessage = error instanceof Error ? error.message : String(error);
-    return [encodeChannelHeader(5 /* ZLinkChannelMessageKind.Error */, request.channelName, request.messageName, exports.JSON_CONTENT_TYPE, request.correlationId, null, null, errorCode, errorMessage, undefined, metadata, request.flowId, request.flowOrigin), encodeJsonBytes(null)];
+    return [
+        encodeChannelHeader(5 /* ZLinkChannelMessageKind.Error */, request.channelName, request.messageName, exports.JSON_CONTENT_TYPE, request.correlationId, null, null, errorCode, errorMessage, undefined, metadata, request.flowId, request.flowOrigin),
+        encodeJsonBytes(null)
+    ];
 }
 function decodeChannelReply(parts, codecs) {
     const header = decodeChannelHeader(parts);
@@ -119,9 +132,9 @@ function decodeChannelReply(parts, codecs) {
         throw unsupportedChannelContentType(header.contentType);
     }
     const serializer = codecs?.serializers.get(header.contentType);
-    if (serializer === undefined
-        && header.contentType !== exports.BINARY_CONTENT_TYPE
-        && header.contentType !== exports.JSON_CONTENT_TYPE) {
+    if (serializer === undefined &&
+        header.contentType !== exports.BINARY_CONTENT_TYPE &&
+        header.contentType !== exports.JSON_CONTENT_TYPE) {
         throw unsupportedChannelContentType(header.contentType);
     }
     if (parts.length < 2 || parts[1].data().length === 0) {
@@ -146,8 +159,7 @@ function decodeChannelError(header) {
         //  Cross-language contract: errorCode carries the snake_case wire name.
         //  An unknown name degrades to InternalFailure, matching the C++
         //  request_failure_mapper fallback for unrecognized codes.
-        const publicKind = ERROR_KIND_BY_WIRE_NAME.get(code)
-            ?? contracts_1.ZLinkFrameworkErrorKind.InternalFailure;
+        const publicKind = ERROR_KIND_BY_WIRE_NAME.get(code) ?? contracts_1.ZLinkFrameworkErrorKind.InternalFailure;
         failure = new contracts_1.ZLinkFrameworkException(publicKind, message);
     }
     //  Cross-language contract (.NET ZLinkErrorOriginWire.RemoteReplyOrigin /
@@ -160,10 +172,10 @@ function decodeChannelError(header) {
     //  reached for bytes that DID come back over the wire) are unaffected and
     //  stay unclassified (`origin: undefined`, i.e. "unspecified") because
     //  they never call this function at all.
-    failure.origin = header.metadata[exports.ZLINK_FRAMEWORK_ORIGIN_METADATA_KEY]
-        === exports.ZLINK_FRAMEWORK_ORIGIN_METADATA_VALUE
-        ? exports.ZLINK_FRAMEWORK_ORIGIN_METADATA_VALUE
-        : 'application';
+    failure.origin =
+        header.metadata[exports.ZLINK_FRAMEWORK_ORIGIN_METADATA_KEY] === exports.ZLINK_FRAMEWORK_ORIGIN_METADATA_VALUE
+            ? exports.ZLINK_FRAMEWORK_ORIGIN_METADATA_VALUE
+            : 'application';
     return failure;
 }
 function decodeChannelEnvelope(parts, decodedHeader, flowEnabled = true) {
@@ -226,13 +238,12 @@ function encodePayload(value, codecs, packetName, contractPart) {
             message: (0, encoded_payload_storage_1.borrowEncodedPayload)(payload) ?? payload.data()
         };
     }
-    const declaredType = (0, ZLinkMessage_1.isZLinkMessage)(value)
-        ? (0, ZLinkMessage_1.readZLinkMessageDeclaredType)(value)
-        : undefined;
+    const declaredType = (0, ZLinkMessage_1.isZLinkMessage)(value) ? (0, ZLinkMessage_1.readZLinkMessageDeclaredType)(value) : undefined;
     if ((0, ZLinkMessage_1.isZLinkMessage)(value))
         value = value.decode();
     const selected = (0, payload_codec_1.selectSerializerWithContentType)(value, codecs, declaredType);
-    if (selected !== undefined && !(Buffer.isBuffer(value) || value instanceof Uint8Array || isMessage(value))) {
+    if (selected !== undefined &&
+        !(Buffer.isBuffer(value) || value instanceof Uint8Array || isMessage(value))) {
         const payload = selected.serializer.serialize(value);
         return {
             contentType: selected.contentType,
@@ -256,7 +267,9 @@ function contentTypeOf(value) {
         : exports.JSON_CONTENT_TYPE;
 }
 function isMessage(value) {
-    return typeof value === 'object' && value !== null && typeof value.data === 'function';
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.data === 'function');
 }
 function encodeJsonBytes(value, schema) {
     return Buffer.from((0, framework_json_v1_1.stringifyFrameworkJsonV1)(value, schema));
@@ -403,10 +416,14 @@ class ChannelHeaderWriter {
 }
 function encodeFlowOrigin(origin) {
     switch (origin) {
-        case 'Inbound': return 1;
-        case 'Timer': return 2;
-        case 'Application': return 3;
-        case 'Lifecycle': return 4;
+        case 'Inbound':
+            return 1;
+        case 'Timer':
+            return 2;
+        case 'Application':
+            return 3;
+        case 'Lifecycle':
+            return 4;
     }
 }
 function decodeChannelHeader(parts, flowEnabled = true) {
@@ -534,9 +551,14 @@ class CanonicalChannelHeaderReader {
                         return undefined;
                 }
             }
-            else if (escaped !== 0x22 && escaped !== 0x5c && escaped !== 0x2f
-                && escaped !== 0x62 && escaped !== 0x66 && escaped !== 0x6e
-                && escaped !== 0x72 && escaped !== 0x74) {
+            else if (escaped !== 0x22 &&
+                escaped !== 0x5c &&
+                escaped !== 0x2f &&
+                escaped !== 0x62 &&
+                escaped !== 0x66 &&
+                escaped !== 0x6e &&
+                escaped !== 0x72 &&
+                escaped !== 0x74) {
                 return undefined;
             }
         }
@@ -576,9 +598,9 @@ class CanonicalChannelHeaderReader {
     }
 }
 function isHexDigit(value) {
-    return (value >= 0x30 && value <= 0x39)
-        || (value >= 0x41 && value <= 0x46)
-        || (value >= 0x61 && value <= 0x66);
+    return ((value >= 0x30 && value <= 0x39) ||
+        (value >= 0x41 && value <= 0x46) ||
+        (value >= 0x61 && value <= 0x66));
 }
 function schemaForInboundChannelEnvelope(header) {
     const contract = (0, Attributes_1.readZLinkPacketJsonContract)(header.messageName);
@@ -613,9 +635,14 @@ function validateChannelHeader(value, flowEnabled = true) {
     requireNullableString(header.topic, 'topic');
     // Parsing already gives this receive operation an owned object. Validate
     // and normalize it here instead of allocating a second header per record.
-    header.errorCode = header.errorCode === undefined ? null : requireNullableString(header.errorCode, 'errorCode');
-    header.errorMessage = header.errorMessage === undefined ? null : requireNullableString(header.errorMessage, 'errorMessage');
-    header.source = header.source === undefined ? undefined : requireNullableString(header.source, 'source');
+    header.errorCode =
+        header.errorCode === undefined ? null : requireNullableString(header.errorCode, 'errorCode');
+    header.errorMessage =
+        header.errorMessage === undefined
+            ? null
+            : requireNullableString(header.errorMessage, 'errorMessage');
+    header.source =
+        header.source === undefined ? undefined : requireNullableString(header.source, 'source');
     header.metadata = requireApplicationMetadata(header.metadata);
     header.flowId = flowId;
     header.flowOrigin = flowOrigin;
@@ -638,9 +665,9 @@ function correlationIdForOutboundKind(kind, correlationId) {
     return selected;
 }
 function validateCorrelationForKind(kind, correlationId) {
-    if (kind === 1 /* ZLinkChannelMessageKind.Request */
-        || kind === 2 /* ZLinkChannelMessageKind.Response */
-        || kind === 5 /* ZLinkChannelMessageKind.Error */) {
+    if (kind === 1 /* ZLinkChannelMessageKind.Request */ ||
+        kind === 2 /* ZLinkChannelMessageKind.Response */ ||
+        kind === 5 /* ZLinkChannelMessageKind.Error */) {
         if (correlationId === null) {
             throw new configuration_1.ZLinkConfigurationException(`Channel ${channelKindName(kind)} requires correlationId.`);
         }
@@ -659,11 +686,16 @@ function validateCorrelationValue(correlationId) {
 }
 function channelKindName(kind) {
     switch (kind) {
-        case 1 /* ZLinkChannelMessageKind.Request */: return 'request';
-        case 2 /* ZLinkChannelMessageKind.Response */: return 'response';
-        case 3 /* ZLinkChannelMessageKind.Command */: return 'send';
-        case 4 /* ZLinkChannelMessageKind.Publish */: return 'publish';
-        case 5 /* ZLinkChannelMessageKind.Error */: return 'error';
+        case 1 /* ZLinkChannelMessageKind.Request */:
+            return 'request';
+        case 2 /* ZLinkChannelMessageKind.Response */:
+            return 'response';
+        case 3 /* ZLinkChannelMessageKind.Command */:
+            return 'send';
+        case 4 /* ZLinkChannelMessageKind.Publish */:
+            return 'publish';
+        case 5 /* ZLinkChannelMessageKind.Error */:
+            return 'error';
     }
 }
 const EMPTY_APPLICATION_METADATA = Object.freeze({});
@@ -712,10 +744,14 @@ function requireFlowId(value) {
 }
 function requireFlowOrigin(value) {
     switch (value) {
-        case 1: return 'Inbound';
-        case 2: return 'Timer';
-        case 3: return 'Application';
-        case 4: return 'Lifecycle';
+        case 1:
+            return 'Inbound';
+        case 2:
+            return 'Timer';
+        case 3:
+            return 'Application';
+        case 4:
+            return 'Lifecycle';
     }
     throw new configuration_1.ZLinkConfigurationException('Channel envelope flowOrigin is invalid.');
 }

package/dist/runtime/channels/channel-outbound-operations.js

@@ -76,7 +76,7 @@ class ZLinkChannelOutboundOperations {
             channelRouteKind: 'client_server',
             serverRid,
             packetName,
-            correlationId: undefined,
+            correlationId: undefined
         });
     }
     request(channelName, packetName, request, timeoutMs, signal, metadata) {
@@ -287,8 +287,8 @@ class ZLinkChannelOutboundOperations {
             if (!isRemoteChannelErrorReply(error)) {
                 traceTerminal(requestTerminalResult(error, signal));
             }
-            if (this.sockets.routeMemberStatus(routerChannelId, targetNodeRid) === 'disconnected'
-                && (isSubmitDeadline(error) || error instanceof route_disconnected_error_1.ZLinkRouteDisconnectedError)) {
+            if (this.sockets.routeMemberStatus(routerChannelId, targetNodeRid) === 'disconnected' &&
+                (isSubmitDeadline(error) || error instanceof route_disconnected_error_1.ZLinkRouteDisconnectedError)) {
                 throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected, `Route channel '${routerChannelId}' member '${targetNodeRid}' is not connected.`, true, error);
             }
             throw error;
@@ -319,8 +319,8 @@ function keepChannelRequestAlive(request) {
     return request.finally(() => clearTimeout(keepalive));
 }
 function isSubmitDeadline(error) {
-    return error instanceof contracts_1.ZLinkFrameworkException
-        && (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded;
+    return (error instanceof contracts_1.ZLinkFrameworkException &&
+        (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded);
 }
 function publishResult(status) {
     return { status };
@@ -335,7 +335,7 @@ function requestTerminalResult(error, signal) {
     return 'failed';
 }
 function isRemoteChannelErrorReply(error) {
-    return error instanceof contracts_1.ZLinkFrameworkException
-        && 'origin' in error
-        && error.origin !== undefined;
+    return (error instanceof contracts_1.ZLinkFrameworkException &&
+        'origin' in error &&
+        error.origin !== undefined);
 }

package/dist/runtime/channels/channel-receive-loops.js

@@ -22,7 +22,7 @@ class ZLinkReceiveRoundRobinCoordinator {
         return token;
     }
     setReady(token, ready) {
-        const owner = this.owners.find(candidate => candidate.token === token);
+        const owner = this.owners.find((candidate) => candidate.token === token);
         if (owner !== undefined)
             owner.ready = ready;
     }
@@ -38,7 +38,7 @@ class ZLinkReceiveRoundRobinCoordinator {
     release(token) {
         if (this.active !== token)
             return;
-        const index = this.owners.findIndex(owner => owner.token === token);
+        const index = this.owners.findIndex((owner) => owner.token === token);
         this.active = undefined;
         if (this.owners.length > 0)
             this.cursor = (index + 1) % this.owners.length;
@@ -47,7 +47,7 @@ class ZLinkReceiveRoundRobinCoordinator {
         return this.rawReceiveReservations.tryAcquire();
     }
     unregister(token) {
-        const index = this.owners.findIndex(owner => owner.token === token);
+        const index = this.owners.findIndex((owner) => owner.token === token);
         if (index < 0)
             return;
         if (this.active === token)
@@ -152,7 +152,7 @@ class ZLinkChannelReceiveLoop {
                 this.roundRobin?.setReady(this.receiveOwner, false);
                 this.roundRobin?.release(this.receiveOwner);
                 batch.reset();
-                if (!await this.poller.waitForReadable(capacitySignal))
+                if (!(await this.poller.waitForReadable(capacitySignal)))
                     break;
                 continue;
             }
@@ -184,7 +184,7 @@ class ZLinkChannelReceiveLoop {
                 this.roundRobin?.setReady(this.receiveOwner, false);
                 this.roundRobin?.release(this.receiveOwner);
                 batch.reset();
-                if (!await this.poller.waitForReadable(capacitySignal))
+                if (!(await this.poller.waitForReadable(capacitySignal)))
                     break;
                 continue;
             }
@@ -277,8 +277,8 @@ class ZLinkChannelReceiveLoop {
             return { kind: 'consumed', closeReceived: true };
         }
         const decodedHeader = (0, channel_envelope_inspection_1.tryDecodeChannelHeader)(received.parts, this.dispatcher.flowEnabled?.() ?? true);
-        if (decodedHeader === undefined
-            && this.spotRouteBridge?.handleRouterReceived(this.channelName, received.routingId, 0n, received.parts) === true) {
+        if (decodedHeader === undefined &&
+            this.spotRouteBridge?.handleRouterReceived(this.channelName, received.routingId, 0n, received.parts) === true) {
             return { kind: 'consumed', closeReceived: false };
         }
         return { kind: 'application', decodedHeader };
@@ -342,7 +342,7 @@ class ZLinkSubscriberReceiveLoop {
                 this.roundRobin?.setReady(this.receiveOwner, false);
                 this.roundRobin?.release(this.receiveOwner);
                 batch.reset();
-                if (!await this.poller.waitForReadable(capacitySignal))
+                if (!(await this.poller.waitForReadable(capacitySignal)))
                     break;
                 continue;
             }
@@ -373,7 +373,7 @@ class ZLinkSubscriberReceiveLoop {
                 this.roundRobin?.setReady(this.receiveOwner, false);
                 this.roundRobin?.release(this.receiveOwner);
                 batch.reset();
-                if (!await this.poller.waitForReadable(capacitySignal))
+                if (!(await this.poller.waitForReadable(capacitySignal)))
                     break;
                 continue;
             }
@@ -454,11 +454,9 @@ class ZLinkSubscriberReceiveLoop {
     }
     classify(topicMessage) {
         const infrastructureResult = this.infrastructureHandler?.(topicMessage);
-        const decodedHeader = typeof infrastructureResult === 'object'
-            ? infrastructureResult.decodedHeader
-            : undefined;
-        if (infrastructureResult === true
-            || (typeof infrastructureResult === 'object' && infrastructureResult.consumed)) {
+        const decodedHeader = typeof infrastructureResult === 'object' ? infrastructureResult.decodedHeader : undefined;
+        if (infrastructureResult === true ||
+            (typeof infrastructureResult === 'object' && infrastructureResult.consumed)) {
             return { kind: 'consumed' };
         }
         return { kind: 'application', decodedHeader };
@@ -518,7 +516,7 @@ class ZLinkRouteReceiveLoop {
                 this.roundRobin?.setReady(this.receiveOwner, false);
                 this.roundRobin?.release(this.receiveOwner);
                 batch.reset();
-                if (!await this.poller.waitForReadable(capacitySignal))
+                if (!(await this.poller.waitForReadable(capacitySignal)))
                     break;
                 continue;
             }
@@ -542,7 +540,7 @@ class ZLinkRouteReceiveLoop {
                 this.roundRobin?.setReady(this.receiveOwner, false);
                 this.roundRobin?.release(this.receiveOwner);
                 batch.reset();
-                if (!await this.poller.waitForReadable(capacitySignal))
+                if (!(await this.poller.waitForReadable(capacitySignal)))
                     break;
                 continue;
             }
@@ -566,7 +564,7 @@ class ZLinkRouteReceiveLoop {
                     // Promise. Track that terminal without serializing the single route
                     // receiver; the held reservation bounds pending infrastructure sends.
                     this.inFlight.track(infrastructure
-                        .catch(error => {
+                        .catch((error) => {
                         received.close();
                         throw error;
                     })
@@ -656,12 +654,12 @@ class ZLinkReceiveBatchBudget {
     record(bytes) {
         this.messages += 1;
         this.bytes += bytes;
-        return this.messages >= RECEIVE_BATCH_MESSAGE_LIMIT
-            || this.bytes >= RECEIVE_BATCH_BYTE_LIMIT
-            || performance.now() - this.startedAt >= RECEIVE_BATCH_TIME_LIMIT_MS;
+        return (this.messages >= RECEIVE_BATCH_MESSAGE_LIMIT ||
+            this.bytes >= RECEIVE_BATCH_BYTE_LIMIT ||
+            performance.now() - this.startedAt >= RECEIVE_BATCH_TIME_LIMIT_MS);
     }
     async yieldAndReset() {
-        await new Promise(resolve => setImmediate(resolve));
+        await new Promise((resolve) => setImmediate(resolve));
         this.reset();
     }
     reset() {
@@ -671,7 +669,7 @@ class ZLinkReceiveBatchBudget {
     }
 }
 function waitReceiveLoopTurn() {
-    return new Promise(resolve => setImmediate(resolve));
+    return new Promise((resolve) => setImmediate(resolve));
 }
 function messageBytes(parts) {
     return parts.reduce((sum, part) => sum + messagePartBytes(part), 0);

package/dist/runtime/channels/channel-receive-task-tracker.js

@@ -15,7 +15,7 @@ class ZLinkReceiveTaskTracker {
     }
     track(task, consumeError = true) {
         this.tasks.add(task);
-        void task.then(() => this.complete(task), error => {
+        void task.then(() => this.complete(task), (error) => {
             this.complete(task);
             if (consumeError) {
                 try {