@zlink-systems/framework 0.21.0 → 0.22.0

package/src/runtime/streams/stream-binding-runtime-ports.ts

@@ -6,15 +6,21 @@ import type { ZLinkBoundSessionResponseTarget } from './bound-session-response-t
 
 export interface ZLinkStreamActorLookupPort {
   find(actorId: string): Promise<DefaultZLinkSessionActor | undefined>;
-  authorityFence(actorId: string): Promise<{
-    readonly authorityOwnerGeneration: bigint;
-    readonly ownerLeaseGeneration: bigint;
-  } | undefined>;
-  sessionRouteFence(actorId: string): Promise<{
-    readonly actor: ActorRef;
-    readonly sessionRid: ActorRef['nodeRid'];
-    readonly bindingGeneration: bigint;
-  } | undefined>;
+  authorityFence(actorId: string): Promise<
+    | {
+        readonly authorityOwnerGeneration: bigint;
+        readonly ownerLeaseGeneration: bigint;
+      }
+    | undefined
+  >;
+  sessionRouteFence(actorId: string): Promise<
+    | {
+        readonly actor: ActorRef;
+        readonly sessionRid: ActorRef['nodeRid'];
+        readonly bindingGeneration: bigint;
+      }
+    | undefined
+  >;
 }
 
 export interface ZLinkStreamActorLifecyclePort {
@@ -48,13 +54,22 @@ export interface ZLinkActorRouteCommitOptions {
 }
 
 export interface ZLinkBoundSessionResponsePort {
-  captureBoundSessionResponseTarget(actor: ZLinkSessionActor): Promise<ZLinkBoundSessionResponseTarget | undefined>;
+  captureBoundSessionResponseTarget(
+    actor: ZLinkSessionActor
+  ): Promise<ZLinkBoundSessionResponseTarget | undefined>;
   sendLocalBoundSessionResponse(
-    actorId: string, packetName: string, requestSeq: bigint, message: unknown,
-    metadata: ReadonlyMap<string, string>, compressPayload: boolean
+    actorId: string,
+    packetName: string,
+    requestSeq: bigint,
+    message: unknown,
+    metadata: ReadonlyMap<string, string>,
+    compressPayload: boolean
   ): Promise<boolean>;
   sendLocalBoundSessionError(
-    actorId: string, packetName: string, requestSeq: bigint, error: unknown,
+    actorId: string,
+    packetName: string,
+    requestSeq: bigint,
+    error: unknown,
     metadata: ReadonlyMap<string, string>
   ): Promise<boolean>;
 }
@@ -62,45 +77,80 @@ export interface ZLinkBoundSessionResponsePort {
 export interface ZLinkRemoteBoundSessionPort extends ZLinkStreamActorLifecyclePort {
   disconnectBoundSession(actorId: string, signal?: AbortSignal): Promise<void>;
   sendLocalBoundSession(
-    actorId: string, message: unknown, packetName: string | undefined,
+    actorId: string,
+    message: unknown,
+    packetName: string | undefined,
     metadata: ReadonlyMap<string, string>
   ): Promise<boolean>;
   sendLocalBoundSessionResponse(
-    actorId: string, packetName: string, requestSeq: bigint, message: unknown,
-    metadata: ReadonlyMap<string, string>, compressPayload: boolean
+    actorId: string,
+    packetName: string,
+    requestSeq: bigint,
+    message: unknown,
+    metadata: ReadonlyMap<string, string>,
+    compressPayload: boolean
   ): Promise<boolean>;
   sendLocalBoundSessionError(
-    actorId: string, packetName: string, requestSeq: bigint, error: unknown,
+    actorId: string,
+    packetName: string,
+    requestSeq: bigint,
+    error: unknown,
     metadata: ReadonlyMap<string, string>
   ): Promise<boolean>;
   sendNativeBoundSessionResponse(
-    node: ZLinkBackendActorSessionNode, actorRef: ActorRef, packetName: string, requestSeq: bigint,
-    message: unknown, metadata: ReadonlyMap<string, string>, compressPayload: boolean,
+    node: ZLinkBackendActorSessionNode,
+    actorRef: ActorRef,
+    packetName: string,
+    requestSeq: bigint,
+    message: unknown,
+    metadata: ReadonlyMap<string, string>,
+    compressPayload: boolean,
     signal?: AbortSignal
   ): Promise<void>;
   sendNativeBoundSessionError(
-    node: ZLinkBackendActorSessionNode, actorRef: ActorRef, packetName: string, requestSeq: bigint,
-    error: unknown, metadata: ReadonlyMap<string, string>, signal?: AbortSignal
+    node: ZLinkBackendActorSessionNode,
+    actorRef: ActorRef,
+    packetName: string,
+    requestSeq: bigint,
+    error: unknown,
+    metadata: ReadonlyMap<string, string>,
+    signal?: AbortSignal
   ): Promise<void>;
 }
 
 export interface ZLinkNativeFallbackBoundSessionPort {
-  disconnectNativeBoundSession(node: ZLinkBackendActorSessionNode, actorRef: ActorRef, signal?: AbortSignal): Promise<void>;
+  disconnectNativeBoundSession(
+    node: ZLinkBackendActorSessionNode,
+    actorRef: ActorRef,
+    signal?: AbortSignal
+  ): Promise<void>;
   disconnectBoundSession(actorId: string, signal?: AbortSignal): Promise<void>;
   sendLocalBoundSession(
-    actorId: string, message: unknown, packetName: string | undefined,
+    actorId: string,
+    message: unknown,
+    packetName: string | undefined,
     metadata: ReadonlyMap<string, string>
   ): Promise<boolean>;
   submitLocalBoundSession(
-    actorId: string, message: unknown, packetName: string | undefined,
-    metadata: ReadonlyMap<string, string>, signal?: AbortSignal
+    actorId: string,
+    message: unknown,
+    packetName: string | undefined,
+    metadata: ReadonlyMap<string, string>,
+    signal?: AbortSignal
   ): Promise<ZLinkSubmitResult>;
   sendNativeBoundSession(
-    node: ZLinkBackendActorSessionNode, actorRef: ActorRef, message: unknown, packetName: string | undefined,
-    metadata: ReadonlyMap<string, string>, signal?: AbortSignal
+    node: ZLinkBackendActorSessionNode,
+    actorRef: ActorRef,
+    message: unknown,
+    packetName: string | undefined,
+    metadata: ReadonlyMap<string, string>,
+    signal?: AbortSignal
   ): Promise<ZLinkSubmitResult>;
   sendBoundSession(
-    actorId: string, message: unknown, packetName: string | undefined,
-    metadata: ReadonlyMap<string, string>, signal?: AbortSignal
+    actorId: string,
+    message: unknown,
+    packetName: string | undefined,
+    metadata: ReadonlyMap<string, string>,
+    signal?: AbortSignal
   ): Promise<ZLinkSubmitResult>;
 }

package/src/runtime/streams/stream-frame-factory.ts

@@ -1,7 +1,4 @@
-import type {
-  ZLinkStreamCompressionCodec,
-  ZLinkStreamCompressionOptions
-} from '../../contracts';
+import type { ZLinkStreamCompressionCodec, ZLinkStreamCompressionOptions } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
 import { ZLinkBufferMessage as ZLinkBindingMessage } from '../backend/runtime-message';
 import { currentOrCreateFlow } from '../diagnostics/flow-context';
@@ -24,11 +21,16 @@ import {
 const DEFAULT_MAX_DECOMPRESSED_STREAM_PAYLOAD_SIZE = 64 * 1024;
 
 export interface ZLinkStreamFramePayloadCodec {
-  encode(payload: unknown, context?: {
-    readonly messageType?: Function;
-    readonly packetName?: string;
-    readonly direction: 'Request' | 'Response' | 'Error' | 'Send';
-  } | Function): {
+  encode(
+    payload: unknown,
+    context?:
+      | {
+          readonly messageType?: Function;
+          readonly packetName?: string;
+          readonly direction: 'Request' | 'Response' | 'Error' | 'Send';
+        }
+      | Function
+  ): {
     readonly codec: ZLinkStreamCodec;
     readonly payload: Uint8Array;
   };
@@ -74,9 +76,10 @@ export class ZLinkStreamFrameMessageFactory {
     payload: unknown,
     correlationId?: string
   ): Message {
-    const flow = (this.options.flowCreationEnabled?.() ?? true)
-      ? currentOrCreateFlow('Application')
-      : undefined;
+    const flow =
+      (this.options.flowCreationEnabled?.() ?? true)
+        ? currentOrCreateFlow('Application')
+        : undefined;
     return this.createJsonFrameMessageWithHeader(
       payload,
       compressed,
@@ -87,9 +90,10 @@ export class ZLinkStreamFrameMessageFactory {
         codec,
         flags,
         requestSeq,
-        name: kind === ZLinkStreamMessageKind.Response || kind === ZLinkStreamMessageKind.Error
-          ? ''
-          : packetName,
+        name:
+          kind === ZLinkStreamMessageKind.Response || kind === ZLinkStreamMessageKind.Error
+            ? ''
+            : packetName,
         metadata,
         correlationId,
         flowId: flow?.flowId,
@@ -110,14 +114,15 @@ export class ZLinkStreamFrameMessageFactory {
       compressed,
       requestHeader.name,
       streamDirection(kind),
-      (codec, flags) => createStreamReplyHeader(
-        requestHeader,
-        kind,
-        codec,
-        flags,
-        metadata,
-        this.options.flowCreationEnabled?.() ?? true
-      )
+      (codec, flags) =>
+        createStreamReplyHeader(
+          requestHeader,
+          kind,
+          codec,
+          flags,
+          metadata,
+          this.options.flowCreationEnabled?.() ?? true
+        )
     );
   }
 
@@ -133,7 +138,9 @@ export class ZLinkStreamFrameMessageFactory {
     if (compressed) {
       body = compressStreamPayload(body, this.compressionCodec);
     }
-    const flags = compressed ? ZLinkStreamHeaderFlags.PayloadCompressed : ZLinkStreamHeaderFlags.None;
+    const flags = compressed
+      ? ZLinkStreamHeaderFlags.PayloadCompressed
+      : ZLinkStreamHeaderFlags.None;
     const frame = encodeStreamFrame(createHeader(encoded.codec, flags), body);
     return this.createOwnedFrameMessage(frame);
   }
@@ -168,14 +175,16 @@ export class ZLinkStreamFrameMessageFactory {
     }
     return {
       codec: ZLinkStreamCodec.Json,
-      payload: utf8Encode(stringifyFrameworkJsonV1(
-        payload,
-        direction === 'Error'
-          ? undefined
-          : readZLinkPacketJsonContract(packetName)?.[
-              direction === 'Response' ? 'reply' : 'payload'
-            ]
-      ))
+      payload: utf8Encode(
+        stringifyFrameworkJsonV1(
+          payload,
+          direction === 'Error'
+            ? undefined
+            : readZLinkPacketJsonContract(packetName)?.[
+                direction === 'Response' ? 'reply' : 'payload'
+              ]
+        )
+      )
     };
   }
 
@@ -186,10 +195,14 @@ export class ZLinkStreamFrameMessageFactory {
 
 function streamDirection(kind: ZLinkStreamMessageKind): 'Request' | 'Response' | 'Error' | 'Send' {
   switch (kind) {
-    case ZLinkStreamMessageKind.Request: return 'Request';
-    case ZLinkStreamMessageKind.Response: return 'Response';
-    case ZLinkStreamMessageKind.Error: return 'Error';
-    default: return 'Send';
+    case ZLinkStreamMessageKind.Request:
+      return 'Request';
+    case ZLinkStreamMessageKind.Response:
+      return 'Response';
+    case ZLinkStreamMessageKind.Error:
+      return 'Error';
+    default:
+      return 'Send';
   }
 }
 
@@ -221,7 +234,9 @@ function compressStreamPayload(
   try {
     return codec.compress(payload);
   } catch (error) {
-    throw new Error(`Compression failed: ${error instanceof Error ? error.message : String(error)}`);
+    throw new Error(
+      `Compression failed: ${error instanceof Error ? error.message : String(error)}`
+    );
   }
 }
 
@@ -237,7 +252,9 @@ export function decompressStreamPayload(
   try {
     decompressed = codec.decompress(payload, maxDecompressedSize);
   } catch (error) {
-    throw new Error(`Decompression failed: ${error instanceof Error ? error.message : String(error)}`);
+    throw new Error(
+      `Decompression failed: ${error instanceof Error ? error.message : String(error)}`
+    );
   }
   if (decompressed.length > maxDecompressedSize) {
     throw new Error('Decompressed stream payload exceeds maximum stream payload size.');