@zlink-systems/framework 0.21.0 → 0.22.0

package/src/runtime/spots/spot-outbound.ts

@@ -27,9 +27,7 @@ import { normalizeOpaqueRoutingId } from '../routing-id';
 import { ZLinkConfigurationException } from '../configuration';
 import type { ZLinkBackendSpot } from '../backend/contracts';
 import { deliverOnSerial } from '../workers';
-import {
-  requireZLinkYieldTurn
-} from '../execution';
+import { requireZLinkYieldTurn } from '../execution';
 import { resolveFrameworkPacketName } from '../messaging/packet-name';
 import type { ZLinkSpotRouteTarget } from './spot-routing-internal';
 import { ZLinkSpotSerialTurnExecutor } from './spot-serial-turn-executor';
@@ -66,8 +64,8 @@ export class DefaultZLinkSpotOutbound implements ZLinkSpotOutbound {
     this.channelClient = options.channelClient;
     this.spotPublisherClient = options.spotPublisherClient;
     this.routedTransport = options.routedTransport;
-    this.spotRouterChannelIdForMesh = options.spotRouterChannelIdForMesh
-      ?? ((meshName) => meshName);
+    this.spotRouterChannelIdForMesh =
+      options.spotRouterChannelIdForMesh ?? ((meshName) => meshName);
     this.sourceSpotProvider = options.sourceSpotProvider;
     this.meshName = options.meshName;
     this.addressTransport = options.addressTransport;
@@ -99,7 +97,10 @@ export class DefaultZLinkSpotOutbound implements ZLinkSpotOutbound {
   requestToSpot(spotId: RoutingId, request: unknown): ZLinkSpotRequestCall;
   /** @internal Compatibility path for an already resolved handle. */
   requestToSpot(spot: SpotHandle, request: unknown): ZLinkRequestCall;
-  requestToSpot(spot: RoutingId | SpotHandle, request: unknown): ZLinkSpotRequestCall | ZLinkRequestCall {
+  requestToSpot(
+    spot: RoutingId | SpotHandle,
+    request: unknown
+  ): ZLinkSpotRequestCall | ZLinkRequestCall {
     if (typeof spot !== 'object') {
       return createAddressedSpotRequestCall(
         this.serial,
@@ -126,7 +127,9 @@ export class DefaultZLinkSpotOutbound implements ZLinkSpotOutbound {
         this.spotPublisherClient.publish(this.requireMeshName(), channelName, topic, event)
       );
     }
-    throw new ZLinkConfigurationException('Spot outbound publish requires a configured Spot publisher client.');
+    throw new ZLinkConfigurationException(
+      'Spot outbound publish requires a configured Spot publisher client.'
+    );
   }
 
   sendToChannel(channelName: string, message: unknown): ZLinkSendCall {
@@ -264,11 +267,7 @@ function createAddressedSpotSendCall(
       selectOnce(options, 'instanceSpot');
       options.instanceSpot = true;
       if (instanceSpotType !== undefined) {
-        options.instanceSpotType = requireAddressValue(
-          instanceSpotType,
-          'Instance Spot type',
-          255
-        );
+        options.instanceSpotType = requireAddressValue(instanceSpotType, 'Instance Spot type', 255);
       }
       return this;
     },
@@ -324,11 +323,7 @@ function createAddressedSpotRequestCall(
       selectOnce(options, 'instanceSpot');
       options.instanceSpot = true;
       if (instanceSpotType !== undefined) {
-        options.instanceSpotType = requireAddressValue(
-          instanceSpotType,
-          'Instance Spot type',
-          255
-        );
+        options.instanceSpotType = requireAddressValue(instanceSpotType, 'Instance Spot type', 255);
       }
       return this;
     },
@@ -340,7 +335,9 @@ function createAddressedSpotRequestCall(
     timeout(timeoutMs: number) {
       selectOnce(options, 'timeout');
       if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
-        throw new ZLinkConfigurationException('Spot request timeout must be a positive safe integer.');
+        throw new ZLinkConfigurationException(
+          'Spot request timeout must be a positive safe integer.'
+        );
       }
       options.timeoutMs = timeoutMs;
       return this;
@@ -399,13 +396,11 @@ function markSubmitted(options: MutableAddressCallOptions): void {
   if (options.submitted) {
     throwAlreadySubmitted('Spot call');
   }
-  if (!options.instanceSpot && (
-    options.instanceSpotType !== undefined
-    || options.initialMeshName !== undefined
-  )) {
-    throw new ZLinkConfigurationException(
-      'Mesh selection requires an Instance Spot intent.'
-    );
+  if (
+    !options.instanceSpot &&
+    (options.instanceSpotType !== undefined || options.initialMeshName !== undefined)
+  ) {
+    throw new ZLinkConfigurationException('Mesh selection requires an Instance Spot intent.');
   }
   options.submitted = true;
 }
@@ -450,7 +445,10 @@ function wrapSendCall(serial: ZLinkSpotSerialTurnExecutor, inner: ZLinkSendCall)
   };
 }
 
-function wrapPublishCall(serial: ZLinkSpotSerialTurnExecutor, inner: ZLinkPublishCall): ZLinkPublishCall {
+function wrapPublishCall(
+  serial: ZLinkSpotSerialTurnExecutor,
+  inner: ZLinkPublishCall
+): ZLinkPublishCall {
   return {
     metadata(key: string | ZLinkMessageMetadata, value?: string) {
       if (typeof key === 'string') inner.metadata(key, value!);
@@ -501,8 +499,7 @@ function startRequestOnSerial<TReply>(
   serial: ZLinkSpotSerialTurnExecutor,
   begin: () => Promise<{ pending: Promise<TReply> }> | { pending: Promise<TReply> }
 ): Promise<TReply> {
-  return runInternalTransportStart(serial, begin)
-    .then((startedRequest) => startedRequest.pending);
+  return runInternalTransportStart(serial, begin).then((startedRequest) => startedRequest.pending);
 }
 
 /**
@@ -513,9 +510,7 @@ function runInternalTransportStart<T>(
   serial: ZLinkSpotSerialTurnExecutor,
   begin: () => Promise<T> | T
 ): Promise<T> {
-  return serial.isCurrentTurn
-    ? Promise.resolve().then(begin)
-    : serial.post(begin);
+  return serial.isCurrentTurn ? Promise.resolve().then(begin) : serial.post(begin);
 }
 
 function wrapRoutedSpotSendCall(
@@ -540,17 +535,12 @@ function wrapRoutedSpotSendCall(
     },
     async submit(signal?: AbortSignal): Promise<void> {
       const pending = startRequestOnSerial(serial, () => ({
-        pending: sendToSpotHandle(
-          transport,
-          spot,
-          message,
-          {
-            metadata,
-            signal,
-            spotRouterChannelIdForMesh,
-            sourceSpot: sourceSpotProvider?.()
-          }
-        )
+        pending: sendToSpotHandle(transport, spot, message, {
+          metadata,
+          signal,
+          spotRouterChannelIdForMesh,
+          sourceSpot: sourceSpotProvider?.()
+        })
       }));
       const result = await (serial.isCurrentTurn ? pending : deliverOnSerial(serial, pending));
       requireOneWayCompletion(
@@ -644,10 +634,7 @@ export async function sendToSpotHandle(
 ): Promise<ZLinkSubmitResult> {
   const packetName = resolveFrameworkPacketName(message, undefined, 'SPOT');
   const sendResolved = async (resolved: ResolvedSpotHandle): Promise<ZLinkSubmitResult> => {
-    const target = spotRefToSpotRouteTarget(
-      resolved,
-      options.spotRouterChannelIdForMesh
-    );
+    const target = spotRefToSpotRouteTarget(resolved, options.spotRouterChannelIdForMesh);
     if (options.sourceSpot !== undefined && transport.sendFromSpotToSpot !== undefined) {
       return transport.sendFromSpotToSpot(options.sourceSpot, target, message, {
         packetName,
@@ -718,7 +705,10 @@ export async function requestToSpotHandle<TReply = unknown>(
   }
 }
 
-async function requireSpotRef(handle: SpotHandle, signal?: AbortSignal): Promise<ResolvedSpotHandle> {
+async function requireSpotRef(
+  handle: SpotHandle,
+  signal?: AbortSignal
+): Promise<ResolvedSpotHandle> {
   const resolved = await resolveSpotHandle(handle, signal);
   if (resolved === undefined) {
     throw new ZLinkConfigurationException(`Spot '${handle.spotId}' has no live location.`);
@@ -740,20 +730,18 @@ function spotRefToSpotRouteTarget(
   };
 }
 
-function shouldRefreshAfterRouteDisconnect(
-  target: ResolvedSpotHandle,
-  error: unknown
-): boolean {
-  return target.targetNodeState === ZLinkFrameworkRuntimeState.Serving
-    && error instanceof ZLinkFrameworkException
-    && internalFrameworkErrorKind(error) === ZLinkFrameworkInternalErrorKind.RouteNotConnected;
+function shouldRefreshAfterRouteDisconnect(target: ResolvedSpotHandle, error: unknown): boolean {
+  return (
+    target.targetNodeState === ZLinkFrameworkRuntimeState.Serving &&
+    error instanceof ZLinkFrameworkException &&
+    internalFrameworkErrorKind(error) === ZLinkFrameworkInternalErrorKind.RouteNotConnected
+  );
 }
 
-function isShutdownTargetState(
-  state: ResolvedSpotHandle['targetNodeState']
-): boolean {
-  return state === ZLinkFrameworkRuntimeState.Draining
-    || state === ZLinkFrameworkRuntimeState.Stopped;
+function isShutdownTargetState(state: ResolvedSpotHandle['targetNodeState']): boolean {
+  return (
+    state === ZLinkFrameworkRuntimeState.Draining || state === ZLinkFrameworkRuntimeState.Stopped
+  );
 }
 
 function normalizeSpotRefRoutingId(routingId: RoutingId): RoutingId {

package/src/runtime/spots/spot-publisher-transport.ts

@@ -1,8 +1,9 @@
-import { ZLinkFrameworkInternalErrorKind, createInternalFrameworkException  } from '../framework-errors-internal';
-import type { Message } from '../../contracts/Common/Message';
 import {
-  ZLinkFrameworkException
-} from '../../contracts';
+  ZLinkFrameworkInternalErrorKind,
+  createInternalFrameworkException
+} from '../framework-errors-internal';
+import type { Message } from '../../contracts/Common/Message';
+import { ZLinkFrameworkException } from '../../contracts';
 import type { ZLinkSpotPublisherClientTransport } from '../channels';
 import type { ZLinkSubmitResult } from '../messaging/submission-result';
 

package/src/runtime/spots/spot-remote-codec.ts

@@ -1,8 +1,5 @@
 import type { ZLinkBackendActorRef } from '../backend/contracts';
-import {
-  decodeActorMessageFollowContext,
-  type ZLinkRemoteBoundSessionTarget
-} from '../actors';
+import { decodeActorMessageFollowContext, type ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { RoutingId, ZLinkActor } from '../../contracts';
 import type { ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 import type { Message } from '../../contracts/Common/Message';
@@ -75,10 +72,7 @@ export function isRemoteActorJoinPayload(
   readonly actorType: string;
   readonly request: string;
 } {
-  return (
-    hasRemoteActorJoinIdentity(value) &&
-    typeof value.request === 'string'
-  );
+  return hasRemoteActorJoinIdentity(value) && typeof value.request === 'string';
 }
 
 export function decodeRemoteActorJoinPayload(
@@ -91,9 +85,8 @@ export function decodeRemoteActorJoinPayload(
   raw: boolean,
   envelope?: ReturnType<typeof decodeChannelEnvelope>
 ): ZLinkDecodedRemoteActorJoinRequest {
-  const phase = payload.phase === 'admission' || payload.phase === 'commit'
-    ? payload.phase
-    : undefined;
+  const phase =
+    payload.phase === 'admission' || payload.phase === 'commit' ? payload.phase : undefined;
   const transferProtocol = phase !== undefined;
   return {
     envelope,
@@ -106,37 +99,39 @@ export function decodeRemoteActorJoinPayload(
       payload.actorId,
       payload.actorGeneration
     ),
-    expectedMembershipEpoch: typeof payload.expectedMembershipEpoch === 'string'
-      ? BigInt(payload.expectedMembershipEpoch)
-      : 0n,
-    actorEntryNodeRid: typeof payload.actorEntryNodeRid === 'string'
-      ? decodeWireRoutingId(payload.actorEntryNodeRid, payload.actorEntryNodeRidHex)
-      : undefined,
-    actorCreateRequest: typeof payload.actorCreateRequest === 'string'
-      ? RuntimeMessage.from(Buffer.from(payload.actorCreateRequest, 'base64'))
-      : undefined,
+    expectedMembershipEpoch:
+      typeof payload.expectedMembershipEpoch === 'string'
+        ? BigInt(payload.expectedMembershipEpoch)
+        : 0n,
+    actorEntryNodeRid:
+      typeof payload.actorEntryNodeRid === 'string'
+        ? decodeWireRoutingId(payload.actorEntryNodeRid, payload.actorEntryNodeRidHex)
+        : undefined,
+    actorCreateRequest:
+      typeof payload.actorCreateRequest === 'string'
+        ? RuntimeMessage.from(Buffer.from(payload.actorCreateRequest, 'base64'))
+        : undefined,
     phase,
     transferId: typeof payload.transferId === 'string' ? payload.transferId : undefined,
-    transferAdapterKey: typeof payload.transferAdapterKey === 'string'
-      ? payload.transferAdapterKey
-      : undefined,
-    transferState: typeof payload.transferState === 'string'
-      ? RuntimeMessage.from(Buffer.from(payload.transferState, 'base64'))
-      : undefined,
+    transferAdapterKey:
+      typeof payload.transferAdapterKey === 'string' ? payload.transferAdapterKey : undefined,
+    transferState:
+      typeof payload.transferState === 'string'
+        ? RuntimeMessage.from(Buffer.from(payload.transferState, 'base64'))
+        : undefined,
     handoffBacklog: decodeHandoffBacklog(payload.handoffBacklog),
     remoteBoundSessionTarget: decodeRemoteBoundSessionTarget(
-      transferProtocol ? payload.boundSessionRouterChannelId : payload.boundSessionRouterChannelId ?? payload.routerChannelId,
+      transferProtocol
+        ? payload.boundSessionRouterChannelId
+        : (payload.boundSessionRouterChannelId ?? payload.routerChannelId),
       transferProtocol
         ? payload.boundSessionTargetNodeRid
-        : payload.boundSessionTargetNodeRid ?? (
-            received.routingId === null
-              ? payload.actorNodeRid
-              : String(received.routingId)
-          ),
+        : (payload.boundSessionTargetNodeRid ??
+            (received.routingId === null ? payload.actorNodeRid : String(received.routingId))),
       payload.boundSessionTargetNodeRidHex,
       transferProtocol
         ? payload.boundSessionSpotId
-        : payload.boundSessionSpotId ?? payload.sourceSpotId,
+        : (payload.boundSessionSpotId ?? payload.sourceSpotId),
       payload.boundSessionNodeRid,
       payload.boundSessionNodeRidHex,
       payload.boundSessionRid,
@@ -148,9 +143,10 @@ export function decodeRemoteActorJoinPayload(
       payload.boundSessionServiceWireRelocation
     ),
     request,
-    requestContentType: typeof payload.requestContentType === 'string'
-      ? payload.requestContentType
-      : 'application/json'
+    requestContentType:
+      typeof payload.requestContentType === 'string'
+        ? payload.requestContentType
+        : 'application/json'
   };
 }
 
@@ -158,7 +154,8 @@ export function decodeHandoffBacklog(value: unknown): readonly ZLinkActorHandoff
   if (!Array.isArray(value)) return [];
   return value.map((entry, expectedIndex) => {
     if (
-      typeof entry !== 'object' || entry === null ||
+      typeof entry !== 'object' ||
+      entry === null ||
       (entry as { index?: unknown }).index !== expectedIndex ||
       typeof (entry as { header?: unknown }).header !== 'string' ||
       typeof (entry as { payload?: unknown }).payload !== 'string' ||
@@ -167,18 +164,19 @@ export function decodeHandoffBacklog(value: unknown): readonly ZLinkActorHandoff
       throw new Error('Remote actor handoff backlog is not a contiguous packet sequence.');
     }
     const packet = entry as ZLinkActorHandoffPacket;
-    const messageFollowContext = decodeActorMessageFollowContext(
-      packet.messageFollowContext
-    );
+    const messageFollowContext = decodeActorMessageFollowContext(packet.messageFollowContext);
     const source = packet.source;
-    if (messageFollowContext === undefined
-      || (packet.returnResponse && (
-        source === undefined || source.ownerId.length === 0
-        || BigInt(source.ownerLeaseGeneration) <= 0n || source.nodeRid.length === 0
-        || BigInt(source.nodeGeneration) <= 0n
-        || source.replyRouteId !== messageFollowContext.replyRouteId
-      ))
-      || (!packet.returnResponse && source !== undefined)) {
+    if (
+      messageFollowContext === undefined ||
+      (packet.returnResponse &&
+        (source === undefined ||
+          source.ownerId.length === 0 ||
+          BigInt(source.ownerLeaseGeneration) <= 0n ||
+          source.nodeRid.length === 0 ||
+          BigInt(source.nodeGeneration) <= 0n ||
+          source.replyRouteId !== messageFollowContext.replyRouteId)) ||
+      (!packet.returnResponse && source !== undefined)
+    ) {
       throw new Error('Remote actor handoff request source fence is invalid.');
     }
     return { ...packet, messageFollowContext };
@@ -228,21 +226,22 @@ export function decodeRemoteBoundSessionTarget(
     routerChannelId,
     targetNodeRid: decodeWireRoutingId(targetNodeRid, targetNodeRidHex),
     spotId: requireSpotId(String(spotId)),
-    sessionNodeRid: typeof sessionNodeRid === 'string'
-      ? decodeWireRoutingId(sessionNodeRid, sessionNodeRidHex)
-      : undefined,
-    sessionRid: typeof sessionRid === 'string'
-      ? decodeWireRoutingId(sessionRid, sessionRidHex)
-      : undefined,
-    bindingGeneration: typeof bindingGeneration === 'string'
-      ? BigInt(bindingGeneration)
-      : undefined,
-    previousAuthorityOwnerGeneration: typeof previousAuthorityOwnerGeneration === 'string'
-      ? BigInt(previousAuthorityOwnerGeneration)
-      : undefined,
-    previousOwnerLeaseGeneration: typeof previousOwnerLeaseGeneration === 'string'
-      ? BigInt(previousOwnerLeaseGeneration)
-      : undefined,
+    sessionNodeRid:
+      typeof sessionNodeRid === 'string'
+        ? decodeWireRoutingId(sessionNodeRid, sessionNodeRidHex)
+        : undefined,
+    sessionRid:
+      typeof sessionRid === 'string' ? decodeWireRoutingId(sessionRid, sessionRidHex) : undefined,
+    bindingGeneration:
+      typeof bindingGeneration === 'string' ? BigInt(bindingGeneration) : undefined,
+    previousAuthorityOwnerGeneration:
+      typeof previousAuthorityOwnerGeneration === 'string'
+        ? BigInt(previousAuthorityOwnerGeneration)
+        : undefined,
+    previousOwnerLeaseGeneration:
+      typeof previousOwnerLeaseGeneration === 'string'
+        ? BigInt(previousOwnerLeaseGeneration)
+        : undefined,
     relocationSealId: typeof relocationSealId === 'string' ? relocationSealId : undefined,
     serviceWireRelocation: decodeBoundSessionServiceWireRelocation(serviceWireRelocation)
   };
@@ -264,12 +263,14 @@ function decodeBoundSessionServiceWireRelocation(
   };
   const nonNegative = (key: string): bigint => {
     const candidate = BigInt(text(key));
-    if (candidate < 0n) throw new TypeError(`Remote bound Session service-wire '${key}' is invalid.`);
+    if (candidate < 0n)
+      throw new TypeError(`Remote bound Session service-wire '${key}' is invalid.`);
     return candidate;
   };
   const positive = (key: string): bigint => {
     const candidate = nonNegative(key);
-    if (candidate === 0n) throw new TypeError(`Remote bound Session service-wire '${key}' is invalid.`);
+    if (candidate === 0n)
+      throw new TypeError(`Remote bound Session service-wire '${key}' is invalid.`);
     return candidate;
   };
   const relocation = {

package/src/runtime/spots/spot-remote-route-codec.ts

@@ -107,10 +107,10 @@ function decodeActorRef(payload: {
   readonly actorOwnershipGeneration?: unknown;
 }): ActorRef | undefined {
   if (
-    typeof payload.actorId !== 'string'
-    || typeof payload.actorNodeRid !== 'string'
-    || typeof payload.actorGeneration !== 'string'
-    || typeof payload.actorMeshName !== 'string'
+    typeof payload.actorId !== 'string' ||
+    typeof payload.actorNodeRid !== 'string' ||
+    typeof payload.actorGeneration !== 'string' ||
+    typeof payload.actorMeshName !== 'string'
   ) {
     return undefined;
   }
@@ -134,7 +134,12 @@ export function decodeRemoteBoundSessionResponse(
   codecs?: ZLinkChannelEnvelopeCodecRegistry,
   flowEnabled = true
 ): ZLinkRemoteBoundSessionResponse | undefined {
-  const decoded = decodeRemoteBoundSessionControl(parts, ZLINK_REMOTE_BOUND_SESSION_RESPONSE_PACKET, codecs, flowEnabled);
+  const decoded = decodeRemoteBoundSessionControl(
+    parts,
+    ZLINK_REMOTE_BOUND_SESSION_RESPONSE_PACKET,
+    codecs,
+    flowEnabled
+  );
   if (decoded === undefined) {
     return undefined;
   }
@@ -154,7 +159,12 @@ export function decodeRemoteBoundSessionError(
   codecs?: ZLinkChannelEnvelopeCodecRegistry,
   flowEnabled = true
 ): ZLinkRemoteBoundSessionError | undefined {
-  const decoded = decodeRemoteBoundSessionControl(parts, ZLINK_REMOTE_BOUND_SESSION_ERROR_PACKET, codecs, flowEnabled);
+  const decoded = decodeRemoteBoundSessionControl(
+    parts,
+    ZLINK_REMOTE_BOUND_SESSION_ERROR_PACKET,
+    codecs,
+    flowEnabled
+  );
   if (decoded === undefined) {
     return undefined;
   }
@@ -179,12 +189,15 @@ export function decodeRemoteActorPacketRelay(
     const relay = decodeRemoteActorPacketRelayPayload(multipart.payload);
     return {
       ...relay,
-      actorRef: decodeForwardedActorRef({
-        actorId: relay.actorId,
-        actorNodeRid: relay.actorNodeRid,
-        actorNodeRidHex: relay.actorNodeRidHex,
-        actorGeneration: relay.actorGeneration
-      }, relay.messageFollowContext),
+      actorRef: decodeForwardedActorRef(
+        {
+          actorId: relay.actorId,
+          actorNodeRid: relay.actorNodeRid,
+          actorNodeRidHex: relay.actorNodeRidHex,
+          actorGeneration: relay.actorGeneration
+        },
+        relay.messageFollowContext
+      ),
       bindingActorRef: decodeActorRef({
         actorId: relay.actorId,
         actorNodeRid: relay.bindingActorNodeRid,
@@ -199,12 +212,15 @@ export function decodeRemoteActorPacketRelay(
   }
 }
 
-function decodeForwardedActorRef(payload: {
-  readonly actorId?: unknown;
-  readonly actorNodeRid?: unknown;
-  readonly actorNodeRidHex?: unknown;
-  readonly actorGeneration?: unknown;
-}, messageFollowContext?: import('../actors').ZLinkActorMessageFollowContext): ActorRef | undefined {
+function decodeForwardedActorRef(
+  payload: {
+    readonly actorId?: unknown;
+    readonly actorNodeRid?: unknown;
+    readonly actorNodeRidHex?: unknown;
+    readonly actorGeneration?: unknown;
+  },
+  messageFollowContext?: import('../actors').ZLinkActorMessageFollowContext
+): ActorRef | undefined {
   const actorRef = decodeActorRef(payload);
   return actorRef === undefined || messageFollowContext === undefined
     ? actorRef
@@ -216,25 +232,28 @@ function decodeRemoteBoundSessionControl(
   packetName: string,
   codecs?: ZLinkChannelEnvelopeCodecRegistry,
   flowEnabled = true
-): {
-  readonly actorId: string;
-  readonly packetName: string;
-  readonly requestSeq: bigint;
-  readonly metadata: ReadonlyMap<string, string>;
-  readonly payload: {
-    readonly message?: unknown;
-    readonly error?: unknown;
-    readonly compressPayload?: unknown;
-  };
-  readonly actorPacketTarget?: unknown;
-} | undefined {
+):
+  | {
+      readonly actorId: string;
+      readonly packetName: string;
+      readonly requestSeq: bigint;
+      readonly metadata: ReadonlyMap<string, string>;
+      readonly payload: {
+        readonly message?: unknown;
+        readonly error?: unknown;
+        readonly compressPayload?: unknown;
+      };
+      readonly actorPacketTarget?: unknown;
+    }
+  | undefined {
   try {
     const multipart = decodeMultipartPayload(parts, codecs, flowEnabled);
     if (multipart.packetName !== packetName) return undefined;
     const payload = multipart.payload as Record<string, unknown>;
-    const decoded = packetName === ZLINK_REMOTE_BOUND_SESSION_RESPONSE_PACKET
-      ? decodeRemoteBoundSessionResponsePayload(payload)
-      : decodeRemoteBoundSessionErrorPayload(payload);
+    const decoded =
+      packetName === ZLINK_REMOTE_BOUND_SESSION_RESPONSE_PACKET
+        ? decodeRemoteBoundSessionResponsePayload(payload)
+        : decodeRemoteBoundSessionErrorPayload(payload);
     return {
       actorId: decoded.actorId,
       packetName: decoded.boundPacketName,
@@ -268,17 +287,18 @@ function decodeMultipartPayload(
   const decodedPayload = decodeChannelPayload(envelope, codecs);
   return {
     packetName: envelope.packetName,
-    payload: typeof decodedPayload === 'object' && decodedPayload !== null
-      ? { ...decodedPayload, packetName: envelope.packetName }
-      : decodedPayload,
+    payload:
+      typeof decodedPayload === 'object' && decodedPayload !== null
+        ? { ...decodedPayload, packetName: envelope.packetName }
+        : decodedPayload,
     envelope
   };
 }
 
 function metadataOf(value: unknown): ReadonlyMap<string, string> {
-  return new Map(Object.entries(
-    typeof value === 'object' && value !== null
-      ? value as Record<string, string>
-      : {}
-  ));
+  return new Map(
+    Object.entries(
+      typeof value === 'object' && value !== null ? (value as Record<string, string>) : {}
+    )
+  );
 }