@zlink-systems/framework 0.20.0 → 0.22.0

package/src/runtime/protocol/service_wire_pilot_codec.generated.ts

@@ -1,4 +1,4 @@
-// <auto-generated> DO NOT EDIT. schema-sha256: 64df96e0f18120191975a9b2196986ffbb6ad7040e1e8328530cd754cbc66a1b
+// <auto-generated> DO NOT EDIT. schema-sha256: 5099b874cd4e2fbff7fea9b821dd8fd670e0de676c6e409ba6e30455dc457e44
 export interface ServiceWireRouteFence { readonly id: string; readonly generation: bigint; readonly targetNodeRid: Uint8Array; readonly targetNodeGeneration: bigint; readonly expectedAuthorityOwnerGeneration: bigint; readonly expectedOwnerLeaseGeneration: bigint; }
 	export interface ApplicationPayloadEnvelopeV1 { readonly packetName: string; readonly contentType: string; readonly payload: Uint8Array; }
 	export interface ActorJoin28 { readonly correlation: bigint; readonly actor: ServiceWireRouteFence; readonly entry: boolean; readonly targetSpot: ServiceWireRouteFence; readonly payload?: ApplicationPayloadEnvelopeV1; }

package/src/runtime/routing-id.ts

@@ -53,8 +53,8 @@ export function decodeRoutingId(text: string, hex: unknown): RoutingId {
   const bytes = Buffer.from(normalizedHex, 'hex');
   const decoded = bytes.toString('utf8');
   if (
-    Buffer.from(decoded, 'utf8').toString('hex') === normalizedHex
-    && !/[\u0000-\u001f\u007f-\u009f]/u.test(decoded)
+    Buffer.from(decoded, 'utf8').toString('hex') === normalizedHex &&
+    !/[\u0000-\u001f\u007f-\u009f]/u.test(decoded)
   ) {
     return normalizeRoutingId(decoded);
   }
@@ -63,9 +63,7 @@ export function decodeRoutingId(text: string, hex: unknown): RoutingId {
 
 export function routingIdWireHex(routingId: RoutingId): string | undefined {
   const value = routingId as unknown as { toHex?: () => string };
-  return typeof value.toHex === 'function'
-    ? value.toHex.call(routingId).toLowerCase()
-    : undefined;
+  return typeof value.toHex === 'function' ? value.toHex.call(routingId).toLowerCase() : undefined;
 }
 
 export function encodeRoutingIdStorageHex(routingId: RoutingId): string {
@@ -92,7 +90,10 @@ export function toBackendRoutingId(routingId: unknown): RoutingId {
   };
   if (typeof value.toBytes === 'function') {
     const bytes = value.toBytes.call(routingId);
-    return new ZLinkOpaqueRoutingId(String(routingId), Buffer.from(bytes).toString('hex')) as unknown as RoutingId;
+    return new ZLinkOpaqueRoutingId(
+      String(routingId),
+      Buffer.from(bytes).toString('hex')
+    ) as unknown as RoutingId;
   }
   if (typeof value.toHex === 'function') {
     return new ZLinkOpaqueRoutingId(
@@ -107,7 +108,9 @@ export function toBackendRoutingId(routingId: unknown): RoutingId {
 function normalizeRoutingIdHex(value: string): string {
   const hex = value.toLowerCase();
   if (hex.length === 0 || hex.length % 2 !== 0 || !/^[0-9a-f]+$/.test(hex)) {
-    throw new TypeError('RoutingId hex must contain a non-empty, even number of hexadecimal digits.');
+    throw new TypeError(
+      'RoutingId hex must contain a non-empty, even number of hexadecimal digits.'
+    );
   }
   return hex;
 }

package/src/runtime/spots/formal-remote-actor-admission-registry.ts

@@ -1,9 +1,4 @@
-import type {
-  ActorRef,
-  RoutingId,
-  ZLinkActor,
-  ZLinkActorJoinOperationId
-} from '../../contracts';
+import type { ActorRef, RoutingId, ZLinkActor, ZLinkActorJoinOperationId } from '../../contracts';
 import type { ZLinkRemoteBoundSessionTarget } from '../actors/actor-runtime-state';
 import type { ZLinkDeferredJoinAcceptedRoot } from '../actors/deferred-join-accepted-journal';
 import type { ZLinkActorRequestTerminal } from './spot-actor-packet-dispatch';
@@ -36,13 +31,7 @@ function objectKey(actorId: string, objectGeneration: bigint): string {
 }
 
 export type ZLinkFormalRemoteActorAdmissionState =
-  | 'provisional'
-  | 'admitting'
-  | 'admitted'
-  | 'rejected'
-  | 'committed'
-  | 'aborted'
-  | 'failed';
+  'provisional' | 'admitting' | 'admitted' | 'rejected' | 'committed' | 'aborted' | 'failed';
 
 export interface ZLinkFormalRemoteActorAdmission {
   readonly actorId: string;
@@ -76,8 +65,7 @@ export interface ZLinkFormalRemoteActorAdmissionFailure {
 }
 
 export type ZLinkFormalRemoteActorAdmissionResult =
-  | ZLinkFormalRemoteActorAdmissionOutcome
-  | ZLinkFormalRemoteActorAdmissionFailure;
+  ZLinkFormalRemoteActorAdmissionOutcome | ZLinkFormalRemoteActorAdmissionFailure;
 
 export interface ZLinkFormalRemoteActorAdmissionRecord {
   readonly admission: ZLinkFormalRemoteActorAdmission;
@@ -124,7 +112,9 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     const existing = this.admissions.get(input.transferId);
     if (existing !== undefined) {
       if (!sameAdmission(existing.admission, input)) {
-        throw new Error(`Remote actor admission '${input.transferId}' does not match the original request.`);
+        throw new Error(
+          `Remote actor admission '${input.transferId}' does not match the original request.`
+        );
       }
       return { record: existing, created: false };
     }
@@ -144,7 +134,9 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     const existing = this.admissions.get(input.transferId);
     if (existing !== undefined) {
       if (!sameProvisionalAdmission(existing.admission, input)) {
-        throw new Error(`Remote actor admission '${input.transferId}' does not match the original request.`);
+        throw new Error(
+          `Remote actor admission '${input.transferId}' does not match the original request.`
+        );
       }
       return { record: existing, created: false };
     }
@@ -225,11 +217,11 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     if (transferId === undefined) return 'not-found';
     const entry = this.admissions.get(transferId);
     if (
-      entry === undefined
-      || entry.migrated
-      || entry.state === 'rejected'
-      || entry.state === 'aborted'
-      || entry.state === 'failed'
+      entry === undefined ||
+      entry.migrated ||
+      entry.state === 'rejected' ||
+      entry.state === 'aborted' ||
+      entry.state === 'failed'
     ) {
       return 'not-found';
     }
@@ -265,25 +257,21 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     this.delete(transferId);
   }
 
-  private failParked(
-    entry: ZLinkFormalRemoteActorAdmissionEntry,
-    reason?: unknown
-  ): void {
+  private failParked(entry: ZLinkFormalRemoteActorAdmissionEntry, reason?: unknown): void {
     if (entry.parked.length === 0) return;
     const parked = entry.parked;
     entry.parked = [];
-    const aborted = reason ?? new Error(
-      `Actor Join relocation temporary queue for '${entry.admission.actorId}' was aborted.`
-    );
+    const aborted =
+      reason ??
+      new Error(
+        `Actor Join relocation temporary queue for '${entry.admission.actorId}' was aborted.`
+      );
     for (const message of parked) {
       message.reject(aborted);
     }
   }
 
-  complete(
-    transferId: string,
-    outcome: ZLinkFormalRemoteActorAdmissionOutcome
-  ): void {
+  complete(transferId: string, outcome: ZLinkFormalRemoteActorAdmissionOutcome): void {
     const entry = this.admissions.get(transferId);
     if (entry === undefined || entry.state === 'aborted' || entry.state === 'committed') return;
     entry.state = outcome.accepted ? 'admitted' : 'rejected';
@@ -326,13 +314,15 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     entry.actor = actor;
   }
 
-  attachDeferredJoinRoot(
-    transferId: string,
-    root: ZLinkDeferredJoinAcceptedRoot
-  ): void {
+  attachDeferredJoinRoot(transferId: string, root: ZLinkDeferredJoinAcceptedRoot): void {
     const entry = this.admissions.get(transferId);
-    if (entry === undefined || entry.state !== 'admitted'
-      || entry.result === undefined || 'error' in entry.result || !entry.result.accepted) {
+    if (
+      entry === undefined ||
+      entry.state !== 'admitted' ||
+      entry.result === undefined ||
+      'error' in entry.result ||
+      !entry.result.accepted
+    ) {
       throw new Error(`Remote actor admission '${transferId}' cannot attach deferred recovery.`);
     }
     entry.result = { ...entry.result, deferredJoinRoot: root };
@@ -377,35 +367,39 @@ function sameAdmission(
   left: ZLinkFormalRemoteActorAdmission,
   right: ZLinkFormalRemoteActorAdmission
 ): boolean {
-  return left.actorId === right.actorId
-    && left.actorType === right.actorType
-    && String(left.spotId) === String(right.spotId)
-    && left.targetSpotGeneration === right.targetSpotGeneration
-    && left.expectedMembershipEpoch === right.expectedMembershipEpoch
-    && left.requestFingerprint === right.requestFingerprint
-    && sameOperationId(left.completionOperationId, right.completionOperationId)
-    && String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '')
-    && String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '')
-    && left.actorRef.actorId === right.actorRef.actorId
-    && String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid)
-    && left.actorRef.objectGeneration === right.actorRef.objectGeneration;
+  return (
+    left.actorId === right.actorId &&
+    left.actorType === right.actorType &&
+    String(left.spotId) === String(right.spotId) &&
+    left.targetSpotGeneration === right.targetSpotGeneration &&
+    left.expectedMembershipEpoch === right.expectedMembershipEpoch &&
+    left.requestFingerprint === right.requestFingerprint &&
+    sameOperationId(left.completionOperationId, right.completionOperationId) &&
+    String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '') &&
+    String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '') &&
+    left.actorRef.actorId === right.actorRef.actorId &&
+    String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid) &&
+    left.actorRef.objectGeneration === right.actorRef.objectGeneration
+  );
 }
 
 function sameProvisionalAdmission(
   left: ZLinkFormalRemoteActorAdmission,
   right: ZLinkProvisionalRemoteActorAdmission
 ): boolean {
-  return left.actorId === right.actorId
-    && String(left.spotId) === String(right.spotId)
-    && left.targetSpotGeneration === right.targetSpotGeneration
-    && left.expectedMembershipEpoch === right.expectedMembershipEpoch
-    && left.requestFingerprint === right.requestFingerprint
-    && sameOperationId(left.completionOperationId, right.completionOperationId)
-    && String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '')
-    && String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '')
-    && left.actorRef.actorId === right.actorRef.actorId
-    && String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid)
-    && left.actorRef.objectGeneration === right.actorRef.objectGeneration;
+  return (
+    left.actorId === right.actorId &&
+    String(left.spotId) === String(right.spotId) &&
+    left.targetSpotGeneration === right.targetSpotGeneration &&
+    left.expectedMembershipEpoch === right.expectedMembershipEpoch &&
+    left.requestFingerprint === right.requestFingerprint &&
+    sameOperationId(left.completionOperationId, right.completionOperationId) &&
+    String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '') &&
+    String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '') &&
+    left.actorRef.actorId === right.actorRef.actorId &&
+    String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid) &&
+    left.actorRef.objectGeneration === right.actorRef.objectGeneration
+  );
 }
 
 function sameOperationId(

package/src/runtime/spots/formal-remote-actor-transfer-registry.ts

@@ -16,11 +16,14 @@ export interface ZLinkFormalRemoteActorTransfer {
 /** Keeps the source-leave fence attached to one admitted formal transfer. */
 export class ZLinkFormalRemoteActorTransferRegistry {
   private readonly lane = new ZLinkStateLane();
-  private readonly transfers = new Map<string, {
-    readonly transfer: ZLinkFormalRemoteActorTransfer;
-    readonly resolveTargetLifecycleCompleted: () => void;
-    readonly resolveSourceLeaveTerminal: (succeeded: boolean) => void;
-  }>();
+  private readonly transfers = new Map<
+    string,
+    {
+      readonly transfer: ZLinkFormalRemoteActorTransfer;
+      readonly resolveTargetLifecycleCompleted: () => void;
+      readonly resolveSourceLeaveTerminal: (succeeded: boolean) => void;
+    }
+  >();
   private readonly transfersById = new Map<string, ZLinkFormalRemoteActorTransfer>();
 
   has(actorId: string): boolean {
@@ -108,19 +111,21 @@ export class ZLinkFormalRemoteActorTransferRegistry {
     const pending = this.completeSourceLeaveTerminalStartCore(actorId, transferId);
     if (pending === undefined) return false;
     await pending.transfer.targetLifecycleCompleted;
-    return await this.lane.run(() => this.completeSourceLeaveTerminalCore(
-      actorId,
-      transferId,
-      pending,
-      succeeded
-    ));
+    return await this.lane.run(() =>
+      this.completeSourceLeaveTerminalCore(actorId, transferId, pending, succeeded)
+    );
   }
 
-  private completeSourceLeaveTerminalStartCore(actorId: string, transferId: string): {
-    readonly transfer: ZLinkFormalRemoteActorTransfer;
-    readonly resolveTargetLifecycleCompleted: () => void;
-    readonly resolveSourceLeaveTerminal: (succeeded: boolean) => void;
-  } | undefined {
+  private completeSourceLeaveTerminalStartCore(
+    actorId: string,
+    transferId: string
+  ):
+    | {
+        readonly transfer: ZLinkFormalRemoteActorTransfer;
+        readonly resolveTargetLifecycleCompleted: () => void;
+        readonly resolveSourceLeaveTerminal: (succeeded: boolean) => void;
+      }
+    | undefined {
     const pending = this.transfers.get(actorId);
     return pending === undefined || pending.transfer.transferId !== transferId
       ? undefined
@@ -137,10 +142,8 @@ export class ZLinkFormalRemoteActorTransferRegistry {
     },
     succeeded: boolean
   ): boolean {
-    if (
-      pending.transfer.transferId !== transferId
-      || this.transfers.get(actorId) !== pending
-    ) return false;
+    if (pending.transfer.transferId !== transferId || this.transfers.get(actorId) !== pending)
+      return false;
     pending.resolveSourceLeaveTerminal(succeeded);
     return true;
   }