@zlink-systems/framework 0.20.0 → 0.22.0

package/src/runtime/host/actor-runtime-options-factory.ts

@@ -1,9 +1,4 @@
-import type {
-  ActorRef,
-  RoutingId,
-  ZLinkActor,
-  ZLinkMessage
-} from '../../contracts';
+import type { ActorRef, RoutingId, ZLinkActor, ZLinkMessage } from '../../contracts';
 import type { ZLinkProviderResolver } from '../../contracts/Common/ZLinkProviderResolver';
 import type { Type } from '../../contracts/Common/CoreTypes';
 import {
@@ -45,7 +40,8 @@ export interface ZLinkActorRuntimeOptionsFactoryOptions {
   readonly messageFlow?: () =>
     import('../diagnostics/message-flow').ZLinkMessageFlowTracer | undefined;
   readonly routeTransport: ZLinkActorRoutedJoinTransport;
-  readonly streamBindingRuntime: ZLinkStreamActorLifecyclePort & ZLinkNativeFallbackBoundSessionPort;
+  readonly streamBindingRuntime: ZLinkStreamActorLifecyclePort &
+    ZLinkNativeFallbackBoundSessionPort;
   readonly providerResolver?: ZLinkProviderResolver;
   readonly spotManager: () => DefaultZLinkSpotManager | undefined;
   readonly actorManager: () => DefaultZLinkActorManager | undefined;
@@ -73,9 +69,7 @@ export interface ZLinkActorRuntimeOptionsFactoryOptions {
    * positive route cache must not bridge the two incarnations.
    */
   readonly invalidateActorRoute: (actorId: string) => void;
-  readonly publishActorAuthority: NonNullable<
-    ZLinkActorManagerOptions['publishActorAuthority']
-  >;
+  readonly publishActorAuthority: NonNullable<ZLinkActorManagerOptions['publishActorAuthority']>;
   readonly reportPostCommitError: (error: unknown) => void;
   readonly reportBoundSessionSendError: (error: unknown) => void;
   readonly actorHandoff: ZLinkActorHandoffCoordinator;
@@ -133,7 +127,7 @@ export class ZLinkActorRuntimeOptionsFactory {
         postCommitErrorReporter: this.options.reportPostCommitError,
         sourceTransfer: this.options.actorTransferRuntime,
         actorJoinRelocation: this.options.actorJoinRelocation,
-        entrySpotIdProvider: meshName => {
+        entrySpotIdProvider: (meshName) => {
           const resolvedMeshName = meshName ?? this.options.primaryMeshName();
           return resolvedMeshName === undefined
             ? undefined
@@ -153,62 +147,67 @@ export class ZLinkActorRuntimeOptionsFactory {
       nativeActorNodeProvider: this.options.primaryMeshNodeOrUndefined,
       nativeActorCompletionTableProvider: this.options.primaryMeshCompletions,
       locationLifecycle: this.options.locationLifecycle(),
-      boundSessionFactory: (actorId) => new ZLinkNativeFallbackBoundSession({
-        runtime: this.options.streamBindingRuntime,
-        routedTransport: this.options.routeTransport,
-        actorRefProvider: () => {
-          const state = this.options.actorManager()?.getState(actorId);
-          const actorRef = state?.nativeActorRef;
-          const meshName = state?.meshName
-            ?? (state?.actorType === undefined
+      boundSessionFactory: (actorId) =>
+        new ZLinkNativeFallbackBoundSession({
+          runtime: this.options.streamBindingRuntime,
+          routedTransport: this.options.routeTransport,
+          actorRefProvider: () => {
+            const state = this.options.actorManager()?.getState(actorId);
+            const actorRef = state?.nativeActorRef;
+            const meshName =
+              state?.meshName ??
+              (state?.actorType === undefined
+                ? undefined
+                : this.options.actorMeshName(state.actorType));
+            const objectGeneration =
+              actorRef?.generation ??
+              (actorRef as unknown as { readonly objectGeneration?: bigint } | undefined)
+                ?.objectGeneration;
+            return actorRef === undefined || objectGeneration === undefined
               ? undefined
-              : this.options.actorMeshName(state.actorType));
-          const objectGeneration = actorRef?.generation
-            ?? (actorRef as unknown as { readonly objectGeneration?: bigint } | undefined)
-              ?.objectGeneration;
-          return actorRef === undefined || objectGeneration === undefined
-            ? undefined
-            : {
-                actorId: actorRef.actorId,
-                objectGeneration,
-                meshName: meshName ?? this.options.primaryMeshName() ?? '',
-                nodeRid: actorRef.nodeRid,
-                ownershipGeneration: state?.locationGeneration,
-                ownerLeaseGeneration: state?.ownerLeaseGeneration,
-                bindingGeneration: state?.boundSessionBindingGeneration
-              } as ActorRef;
-        },
-        nativeActorNodeProvider: () => {
-          const state = this.options.actorManager()?.getState(actorId);
-          const meshName = state?.meshName
-            ?? (state?.actorType === undefined
-              ? undefined
-              : this.options.actorMeshName(state.actorType));
-          const node = meshName === undefined
-            ? this.options.primaryMeshNodeOrUndefined()
-            : this.options.meshNode(meshName);
-          const completions = meshName === undefined
-            ? this.options.primaryMeshCompletions()
-            : this.options.meshCompletions(meshName);
-          return node === undefined
-            ? undefined
-            : meshActorSessionNodeAdapter(node, completions);
-        },
-        localActorProvider: () => this.options.actorManager()?.getState(actorId)?.actor !== undefined,
-        remoteBoundSessionTargetProvider: () => {
-          const state = this.options.actorManager()?.getState(actorId);
-          return preferredRemoteBoundSessionTarget(
-            state?.remoteBoundSessionTarget,
-            state?.boundSessionTransferTarget
-          );
-        },
-        remoteActorPacketTargetProvider: () => this.options.actorPacketTargetForState(actorId),
-        requestTimeoutMs: this.options.registration.requestTimeoutMs,
-        actorId,
-        onSend: this.options.traceBoundSessionSend,
-        reportError: this.options.reportBoundSessionSendError,
-        flowCreationEnabled: this.options.flowCreationEnabled
-      }),
+              : ({
+                  actorId: actorRef.actorId,
+                  objectGeneration,
+                  meshName: meshName ?? this.options.primaryMeshName() ?? '',
+                  nodeRid: actorRef.nodeRid,
+                  ownershipGeneration: state?.locationGeneration,
+                  ownerLeaseGeneration: state?.ownerLeaseGeneration,
+                  bindingGeneration: state?.boundSessionBindingGeneration
+                } as ActorRef);
+          },
+          nativeActorNodeProvider: () => {
+            const state = this.options.actorManager()?.getState(actorId);
+            const meshName =
+              state?.meshName ??
+              (state?.actorType === undefined
+                ? undefined
+                : this.options.actorMeshName(state.actorType));
+            const node =
+              meshName === undefined
+                ? this.options.primaryMeshNodeOrUndefined()
+                : this.options.meshNode(meshName);
+            const completions =
+              meshName === undefined
+                ? this.options.primaryMeshCompletions()
+                : this.options.meshCompletions(meshName);
+            return node === undefined ? undefined : meshActorSessionNodeAdapter(node, completions);
+          },
+          localActorProvider: () =>
+            this.options.actorManager()?.getState(actorId)?.actor !== undefined,
+          remoteBoundSessionTargetProvider: () => {
+            const state = this.options.actorManager()?.getState(actorId);
+            return preferredRemoteBoundSessionTarget(
+              state?.remoteBoundSessionTarget,
+              state?.boundSessionTransferTarget
+            );
+          },
+          remoteActorPacketTargetProvider: () => this.options.actorPacketTargetForState(actorId),
+          requestTimeoutMs: this.options.registration.requestTimeoutMs,
+          actorId,
+          onSend: this.options.traceBoundSessionSend,
+          reportError: this.options.reportBoundSessionSendError,
+          flowCreationEnabled: this.options.flowCreationEnabled
+        }),
       actorCreatedNodeRidProvider: () => {
         const node = this.options.primaryMeshNodeOrUndefined();
         return node === undefined ? undefined : String(node.status().routingId);
@@ -223,7 +222,8 @@ export class ZLinkActorRuntimeOptionsFactory {
       },
       actorDestroyedCleanup: (actorId) => {
         this.options.invalidateActorRoute(actorId);
-        const actorRef = this.options.actorManager()?.getState(actorId)?.nativeActorRef as ActorRef | undefined;
+        const actorRef = this.options.actorManager()?.getState(actorId)?.nativeActorRef as
+          ActorRef | undefined;
         if (actorRef !== undefined) {
           this.options.rememberDestroyedActorRef(actorId, actorRef);
         }
@@ -240,27 +240,28 @@ export class ZLinkActorRuntimeOptionsFactory {
       completionTableProvider: this.options.meshCompletions,
       locationResolver: () => locationResolver,
       routeTransport: this.options.routeTransport,
-      transportDeliveryGate: () => this.options.providerResolver?.get?.(
-        ZLINK_INTERNAL_ACTOR_TRANSPORT_DELIVERY_GATE as unknown as
-          Type<ZLinkInternalActorTransportDeliveryGate>
-      ),
+      transportDeliveryGate: () =>
+        this.options.providerResolver?.get?.(
+          ZLINK_INTERNAL_ACTOR_TRANSPORT_DELIVERY_GATE as unknown as Type<ZLinkInternalActorTransportDeliveryGate>
+        ),
       messageSerializers: this.options.registration.messageSerializers,
       defaultRequestTimeoutMs: this.options.registration.requestTimeoutMs,
-      staleActorRefReporter: (_meshName, actorId) => this.options.actorHandoff.recordStaleFailure(actorId),
+      staleActorRefReporter: (_meshName, actorId) =>
+        this.options.actorHandoff.recordStaleFailure(actorId),
       staleActorRefPredicate: (meshName, actor) =>
-        this.actorBelongsToMesh(meshName, actor.actorId)
-        && this.options.actorHandoff.isKnownStale(actor),
+        this.actorBelongsToMesh(meshName, actor.actorId) &&
+        this.options.actorHandoff.isKnownStale(actor),
       handoffCapture: (meshName, actorId, parts, returnResponse, actor, deadlineUnixMs) =>
-        this.actorBelongsToMesh(meshName, actorId)
-          && !this.options.actorHandoff.isProvisional(actorId)
+        this.actorBelongsToMesh(meshName, actorId) &&
+        !this.options.actorHandoff.isProvisional(actorId)
           ? this.options.actorHandoff.capture(
-            actorId,
-            parts,
-            returnResponse,
-            undefined,
-            actor,
-            deadlineUnixMs
-          )
+              actorId,
+              parts,
+              returnResponse,
+              undefined,
+              actor,
+              deadlineUnixMs
+            )
           : undefined,
       sendErrorReporter: this.options.reportPostCommitError
     };
@@ -272,11 +273,12 @@ export class ZLinkActorRuntimeOptionsFactory {
       return this.options.actorMeshName(actorType) === meshName;
     }
     const actorMeshes = [...this.options.registration.spotNodes.entries()]
-      .filter(([, node]) => node.actorFactories instanceof Map
-        ? node.actorFactories.size > 0
-        : Object.keys(node.actorFactories ?? {}).length > 0)
+      .filter(([, node]) =>
+        node.actorFactories instanceof Map
+          ? node.actorFactories.size > 0
+          : Object.keys(node.actorFactories ?? {}).length > 0
+      )
       .map(([name]) => name);
     return actorMeshes.length === 1 && actorMeshes[0] === meshName;
   }
-
 }

package/src/runtime/host/actor-transfer-authority-runtime.ts

@@ -4,10 +4,7 @@ import {
   type ActorTransferControlPayload
 } from '../foundation/service-runtime-contracts';
 import type { ServiceActorRef } from '../foundation/service-stateful-registry';
-import type {
-  ActorRef,
-  RoutingId
-} from '../../contracts';
+import type { ActorRef, RoutingId } from '../../contracts';
 import type { ZLinkActorLocation } from '../../contracts/Locations/Rows';
 import type { ZLinkActorLocationStore } from '../locations/internal-store-contracts';
 import type {
@@ -16,8 +13,7 @@ import type {
 } from '../../contracts/Locations/ActorTransfer';
 import { toFrameworkActorRef } from '../actors';
 
-export type ZLinkActorTransferAuthorityStore =
-  ZLinkActorTransferStore & ZLinkActorLocationStore;
+export type ZLinkActorTransferAuthorityStore = ZLinkActorTransferStore & ZLinkActorLocationStore;
 
 export interface ZLinkActorTransferAuthorityRuntimeOptions {
   readonly store: () => ZLinkActorTransferAuthorityStore | undefined;
@@ -52,8 +48,9 @@ export class ZLinkActorTransferAuthorityRuntime {
     const transferId = transferIdString(control.transferId.high, control.transferId.low);
 
     if (
-      control.role === ActorTransferRole.Target
-      && (control.phase === ActorTransferPhase.Preparing || control.phase === ActorTransferPhase.Fenced)
+      control.role === ActorTransferRole.Target &&
+      (control.phase === ActorTransferPhase.Preparing ||
+        control.phase === ActorTransferPhase.Fenced)
     ) {
       await this.prepare(
         store,
@@ -97,23 +94,25 @@ export class ZLinkActorTransferAuthorityRuntime {
     }
     const target = toFrameworkActorRef(nativeTarget as never, meshName);
     validateTarget(location, target, membershipEpoch, transferId);
-    const result = await store.prepareActorTransfer({
-      meshName,
-      actorId,
-      transferId,
-      source: location.actorRef,
-      target,
-      expectedActorGeneration: location.actorRef.objectGeneration,
-      expectedMembershipEpoch: location.membershipEpoch,
-      participants: new Set<RoutingId>([
-        location.actorRef.nodeRid,
-        target.nodeRid
-      ]),
-      recoveryOwnerId: ownerId,
-      recoveryLeaseTtlMs: this.options.recoveryLeaseTtlMs
-    }, signal);
+    const result = await store.prepareActorTransfer(
+      {
+        meshName,
+        actorId,
+        transferId,
+        source: location.actorRef,
+        target,
+        expectedActorGeneration: location.actorRef.objectGeneration,
+        expectedMembershipEpoch: location.membershipEpoch,
+        participants: new Set<RoutingId>([location.actorRef.nodeRid, target.nodeRid]),
+        recoveryOwnerId: ownerId,
+        recoveryLeaseTtlMs: this.options.recoveryLeaseTtlMs
+      },
+      signal
+    );
     if (result.status !== 'stored') {
-      throw new Error(`Actor transfer '${transferId}' prepare was rejected with status '${result.status}'.`);
+      throw new Error(
+        `Actor transfer '${transferId}' prepare was rejected with status '${result.status}'.`
+      );
     }
   }
 
@@ -146,21 +145,26 @@ export class ZLinkActorTransferAuthorityRuntime {
         signal
       );
       if (takeover.status !== 'stored' || takeover.record === undefined) {
-        throw new Error(`Actor transfer '${transferId}' recovery takeover failed with status '${takeover.status}'.`);
+        throw new Error(
+          `Actor transfer '${transferId}' recovery takeover failed with status '${takeover.status}'.`
+        );
       }
       record = takeover.record;
     }
 
     if (targetState === 'activated' && record.state === 'prepared') {
-      record = requireStored(await store.commitActorTransfer(
-        meshName, actorId, transferId, ownerId, signal
-      ), transferId, 'commit');
+      record = requireStored(
+        await store.commitActorTransfer(meshName, actorId, transferId, ownerId, signal),
+        transferId,
+        'commit'
+      );
     }
-    const result = targetState === 'committed'
-      ? await store.commitActorTransfer(meshName, actorId, transferId, ownerId, signal)
-      : targetState === 'activated'
-        ? await store.activateActorTransfer(meshName, actorId, transferId, ownerId, signal)
-        : await store.abortActorTransfer(meshName, actorId, transferId, ownerId, signal);
+    const result =
+      targetState === 'committed'
+        ? await store.commitActorTransfer(meshName, actorId, transferId, ownerId, signal)
+        : targetState === 'activated'
+          ? await store.activateActorTransfer(meshName, actorId, transferId, ownerId, signal)
+          : await store.abortActorTransfer(meshName, actorId, transferId, ownerId, signal);
     requireStored(result, transferId, targetState);
   }
 
@@ -188,11 +192,13 @@ function validateTarget(
   transferId: string
 ): void {
   if (
-    target.actorId !== location.actorId
-    || target.objectGeneration !== location.actorRef.objectGeneration
-    || membershipEpoch !== location.membershipEpoch
+    target.actorId !== location.actorId ||
+    target.objectGeneration !== location.actorRef.objectGeneration ||
+    membershipEpoch !== location.membershipEpoch
   ) {
-    throw new Error(`Actor transfer '${transferId}' does not match the source Actor generation and membership epoch.`);
+    throw new Error(
+      `Actor transfer '${transferId}' does not match the source Actor generation and membership epoch.`
+    );
   }
 }
 
@@ -202,7 +208,9 @@ function requireStored(
   operation: string
 ): ZLinkActorTransferRecord {
   if (result.status !== 'stored' || result.record === undefined) {
-    throw new Error(`Actor transfer '${transferId}' ${operation} failed with status '${result.status}'.`);
+    throw new Error(
+      `Actor transfer '${transferId}' ${operation} failed with status '${result.status}'.`
+    );
   }
   return result.record;
 }