@zlink-systems/framework 0.21.0 → 0.22.0

package/dist/runtime/actors/actor-remote-joiner.js

@@ -47,7 +47,9 @@ class ZLinkActorNativeJoinCoordinator {
     async joinSpot(actor, state, spotId, request, timeoutMs, signal, completionOperationId) {
         (0, abort_1.throwIfAborted)(signal);
         const node = this.node();
-        const actorRef = state.nativeActorRef ?? (0, actor_native_lookup_1.lookupNativeActorRef)(node, actor.context.actorId) ?? node.createActor(actor.context.actorId);
+        const actorRef = state.nativeActorRef ??
+            (0, actor_native_lookup_1.lookupNativeActorRef)(node, actor.context.actorId) ??
+            node.createActor(actor.context.actorId);
         state.setNativeActorRef(actorRef);
         let target;
         target = await this.options.spotRouteResolver?.resolve(spotId, signal);
@@ -58,21 +60,24 @@ class ZLinkActorNativeJoinCoordinator {
     async joinEntrySpot(actor, state, nodeRid, request, timeoutMs, signal, completionOperationId) {
         (0, abort_1.throwIfAborted)(signal);
         const node = this.node();
-        const actorRef = state.nativeActorRef ?? (0, actor_native_lookup_1.lookupNativeActorRef)(node, actor.context.actorId) ?? node.createActor(actor.context.actorId);
+        const actorRef = state.nativeActorRef ??
+            (0, actor_native_lookup_1.lookupNativeActorRef)(node, actor.context.actorId) ??
+            node.createActor(actor.context.actorId);
         state.setNativeActorRef(actorRef);
         const meshName = state.meshName ?? actor.context.meshName;
         const entrySpotId = this.options.entrySpotIdProvider?.(meshName);
         let resolvedTarget;
-        resolvedTarget = entrySpotId === undefined
-            ? undefined
-            : await this.options.spotRouteResolver?.resolve(entrySpotId, signal);
+        resolvedTarget =
+            entrySpotId === undefined
+                ? undefined
+                : await this.options.spotRouteResolver?.resolve(entrySpotId, signal);
         // The caller may carry the Entry node from the previous membership.
         // Entry placement can change while the Actor is in a User Spot, so the
         // current authority route is the source of truth whenever it is available.
-        const selectedNodeRid = resolvedTarget?.targetNodeRid
-            ?? nodeRid
-            ?? state.entryNodeRid
-            ?? (0, actor_runtime_state_1.toFrameworkRoutingId)(node.status().routingId);
+        const selectedNodeRid = resolvedTarget?.targetNodeRid ??
+            nodeRid ??
+            state.entryNodeRid ??
+            (0, actor_runtime_state_1.toFrameworkRoutingId)(node.status().routingId);
         const target = resolvedTarget;
         const result = await this.localJoin.joinEntrySpot(node, actor, state, actorRef, selectedNodeRid, target, request, timeoutMs ?? this.options.actorTransferTimeoutMs, signal, completionOperationId);
         return this.withDeferredJoinFinalizer(actor, state, target, result, completionOperationId);
@@ -94,18 +99,16 @@ class ZLinkActorNativeJoinCoordinator {
         };
     }
     node() {
-        return typeof this.options.node === 'function'
-            ? this.options.node()
-            : this.options.node;
+        return typeof this.options.node === 'function' ? this.options.node() : this.options.node;
     }
 }
 exports.ZLinkActorNativeJoinCoordinator = ZLinkActorNativeJoinCoordinator;
 function installResolvedSpotRoute(node, target) {
-    if (target?.targetSpotGeneration === undefined
-        || target.targetNodeGeneration === undefined
-        || target.authorityOwnerGeneration === undefined
-        || target.ownerLeaseGeneration === undefined
-        || target.authorityStoreVersion === undefined) {
+    if (target?.targetSpotGeneration === undefined ||
+        target.targetNodeGeneration === undefined ||
+        target.authorityOwnerGeneration === undefined ||
+        target.ownerLeaseGeneration === undefined ||
+        target.authorityStoreVersion === undefined) {
         return;
     }
     node.rememberSpotRoute?.({

package/dist/runtime/actors/actor-remote-wire.js

@@ -19,13 +19,12 @@ function decodeRemoteActorSourceLeaveTerminal(payload) {
     catch {
         return undefined;
     }
-    if (typeof decoded !== 'object'
-        || decoded === null
-        || decoded.packetName
-            !== exports.ZLINK_REMOTE_ACTOR_SOURCE_LEAVE_TERMINAL
-        || typeof decoded.transferId !== 'string'
-        || typeof decoded.actorId !== 'string'
-        || typeof decoded.succeeded !== 'boolean') {
+    if (typeof decoded !== 'object' ||
+        decoded === null ||
+        decoded.packetName !== exports.ZLINK_REMOTE_ACTOR_SOURCE_LEAVE_TERMINAL ||
+        typeof decoded.transferId !== 'string' ||
+        typeof decoded.actorId !== 'string' ||
+        typeof decoded.succeeded !== 'boolean') {
         return undefined;
     }
     return decoded;

package/dist/runtime/actors/actor-runtime-state.js

@@ -15,12 +15,12 @@ const actor_native_lookup_1 = require("./actor-native-lookup");
  * service-wire relocation identity until command 44 releases the owner seal.
  */
 function mergeRemoteBoundSessionTarget(target, fallback) {
-    if (fallback === undefined
-        || fallback.routerChannelId !== target.routerChannelId
-        || !(0, routing_id_1.routingIdsEqual)(fallback.targetNodeRid, target.targetNodeRid)
-        || (!(0, routing_id_1.routingIdsEqual)(fallback.spotId, target.spotId)
-            && !samePhysicalRemoteSession(fallback, target))
-        || isSuccessorSessionBinding(fallback, target)) {
+    if (fallback === undefined ||
+        fallback.routerChannelId !== target.routerChannelId ||
+        !(0, routing_id_1.routingIdsEqual)(fallback.targetNodeRid, target.targetNodeRid) ||
+        (!(0, routing_id_1.routingIdsEqual)(fallback.spotId, target.spotId) &&
+            !samePhysicalRemoteSession(fallback, target)) ||
+        isSuccessorSessionBinding(fallback, target)) {
         return target;
     }
     const merged = {
@@ -58,51 +58,55 @@ function mergeRemoteBoundSessionTarget(target, fallback) {
  * session report for the STOP writeup.
  */
 function isSuccessorSessionBinding(fallback, target) {
-    return (fallback.sessionNodeRid !== undefined
-        && target.sessionNodeRid !== undefined
-        && !(0, routing_id_1.routingIdsEqual)(fallback.sessionNodeRid, target.sessionNodeRid)) || (fallback.sessionRid !== undefined
-        && target.sessionRid !== undefined
-        && !(0, routing_id_1.routingIdsEqual)(fallback.sessionRid, target.sessionRid)) || (fallback.sessionOwnerNodeGeneration !== undefined
-        && target.sessionOwnerNodeGeneration !== undefined
-        && fallback.sessionOwnerNodeGeneration !== target.sessionOwnerNodeGeneration) || (fallback.sessionOwnerId !== undefined
-        && target.sessionOwnerId !== undefined
-        && fallback.sessionOwnerId !== target.sessionOwnerId) || (fallback.sessionOwnerLeaseGeneration !== undefined
-        && target.sessionOwnerLeaseGeneration !== undefined
-        && fallback.sessionOwnerLeaseGeneration !== target.sessionOwnerLeaseGeneration);
+    return ((fallback.sessionNodeRid !== undefined &&
+        target.sessionNodeRid !== undefined &&
+        !(0, routing_id_1.routingIdsEqual)(fallback.sessionNodeRid, target.sessionNodeRid)) ||
+        (fallback.sessionRid !== undefined &&
+            target.sessionRid !== undefined &&
+            !(0, routing_id_1.routingIdsEqual)(fallback.sessionRid, target.sessionRid)) ||
+        (fallback.sessionOwnerNodeGeneration !== undefined &&
+            target.sessionOwnerNodeGeneration !== undefined &&
+            fallback.sessionOwnerNodeGeneration !== target.sessionOwnerNodeGeneration) ||
+        (fallback.sessionOwnerId !== undefined &&
+            target.sessionOwnerId !== undefined &&
+            fallback.sessionOwnerId !== target.sessionOwnerId) ||
+        (fallback.sessionOwnerLeaseGeneration !== undefined &&
+            target.sessionOwnerLeaseGeneration !== undefined &&
+            fallback.sessionOwnerLeaseGeneration !== target.sessionOwnerLeaseGeneration));
 }
 function samePhysicalRemoteSession(left, right) {
-    return left.sessionNodeRid !== undefined
-        && right.sessionNodeRid !== undefined
-        && left.sessionRid !== undefined
-        && right.sessionRid !== undefined
-        && (0, routing_id_1.routingIdsEqual)(left.sessionNodeRid, right.sessionNodeRid)
-        && (0, routing_id_1.routingIdsEqual)(left.sessionRid, right.sessionRid);
+    return (left.sessionNodeRid !== undefined &&
+        right.sessionNodeRid !== undefined &&
+        left.sessionRid !== undefined &&
+        right.sessionRid !== undefined &&
+        (0, routing_id_1.routingIdsEqual)(left.sessionNodeRid, right.sessionNodeRid) &&
+        (0, routing_id_1.routingIdsEqual)(left.sessionRid, right.sessionRid));
 }
 function sameRemoteSessionOwnerLifecycle(left, right) {
-    return left.sessionNodeRid !== undefined
-        && right.sessionNodeRid !== undefined
-        && left.sessionOwnerNodeGeneration !== undefined
-        && right.sessionOwnerNodeGeneration !== undefined
-        && left.sessionOwnerId !== undefined
-        && right.sessionOwnerId !== undefined
-        && left.sessionOwnerLeaseGeneration !== undefined
-        && right.sessionOwnerLeaseGeneration !== undefined
-        && (0, routing_id_1.routingIdsEqual)(left.sessionNodeRid, right.sessionNodeRid)
-        && left.sessionOwnerNodeGeneration === right.sessionOwnerNodeGeneration
-        && left.sessionOwnerId === right.sessionOwnerId
-        && left.sessionOwnerLeaseGeneration === right.sessionOwnerLeaseGeneration;
+    return (left.sessionNodeRid !== undefined &&
+        right.sessionNodeRid !== undefined &&
+        left.sessionOwnerNodeGeneration !== undefined &&
+        right.sessionOwnerNodeGeneration !== undefined &&
+        left.sessionOwnerId !== undefined &&
+        right.sessionOwnerId !== undefined &&
+        left.sessionOwnerLeaseGeneration !== undefined &&
+        right.sessionOwnerLeaseGeneration !== undefined &&
+        (0, routing_id_1.routingIdsEqual)(left.sessionNodeRid, right.sessionNodeRid) &&
+        left.sessionOwnerNodeGeneration === right.sessionOwnerNodeGeneration &&
+        left.sessionOwnerId === right.sessionOwnerId &&
+        left.sessionOwnerLeaseGeneration === right.sessionOwnerLeaseGeneration);
 }
 function sameRemoteSessionOwner(left, right) {
-    return left.sessionRid !== undefined
-        && right.sessionRid !== undefined
-        && (0, routing_id_1.routingIdsEqual)(left.sessionRid, right.sessionRid)
-        && sameRemoteSessionOwnerLifecycle(left, right);
+    return (left.sessionRid !== undefined &&
+        right.sessionRid !== undefined &&
+        (0, routing_id_1.routingIdsEqual)(left.sessionRid, right.sessionRid) &&
+        sameRemoteSessionOwnerLifecycle(left, right));
 }
 function sameRemoteSessionBinding(left, right) {
-    return sameRemoteSessionOwner(left, right)
-        && left.bindingGeneration !== undefined
-        && right.bindingGeneration !== undefined
-        && left.bindingGeneration === right.bindingGeneration;
+    return (sameRemoteSessionOwner(left, right) &&
+        left.bindingGeneration !== undefined &&
+        right.bindingGeneration !== undefined &&
+        left.bindingGeneration === right.bindingGeneration);
 }
 /**
  * Selects the route that still carries the relocation fence when a Core
@@ -116,8 +120,7 @@ function preferredRemoteBoundSessionTarget(remote, transfer) {
     return transfer;
 }
 function hasRelocationFence(target) {
-    return target.relocationSealId !== undefined
-        || target.serviceWireRelocation !== undefined;
+    return target.relocationSealId !== undefined || target.serviceWireRelocation !== undefined;
 }
 class ZLinkActorRuntimeState {
     actorId;
@@ -251,7 +254,8 @@ class ZLinkActorRuntimeState {
             return this.destroyTask;
         }
         const actorRef = this.nativeActorRefValue;
-        if (actorRef !== undefined && !(0, routing_id_1.routingIdsEqual)(toFrameworkRoutingId(actorRef.nodeRid), entryNodeRid)) {
+        if (actorRef !== undefined &&
+            !(0, routing_id_1.routingIdsEqual)(toFrameworkRoutingId(actorRef.nodeRid), entryNodeRid)) {
             throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorRouteNotFound, `Actor '${this.actorId}' is not owned by this Entry Spot.`);
         }
         const task = Promise.resolve().then(() => destroy(actorRef));
@@ -325,7 +329,8 @@ class ZLinkActorRuntimeState {
     ensureNativeActorRef(node, request) {
         if (this.nativeActorRefValue === undefined) {
             const existing = (0, actor_native_lookup_1.lookupNativeActorRef)(node, this.actorId);
-            const native = existing ?? node.createActor(this.actorId, request === undefined ? undefined : Buffer.from(request.data()));
+            const native = existing ??
+                node.createActor(this.actorId, request === undefined ? undefined : Buffer.from(request.data()));
             this.nativeActorRefValue = {
                 nodeRid: native.nodeRid,
                 actorId: native.actorId,
@@ -358,12 +363,12 @@ class ZLinkActorRuntimeState {
     }
     /** @internal Installs one authority-confirmed binding inside its Actor owner turn. */
     installBoundSessionBinding(target) {
-        if (target.sessionNodeRid === undefined
-            || target.sessionRid === undefined
-            || target.sessionOwnerNodeGeneration === undefined
-            || target.sessionOwnerId === undefined
-            || target.sessionOwnerLeaseGeneration === undefined
-            || target.bindingGeneration === undefined) {
+        if (target.sessionNodeRid === undefined ||
+            target.sessionRid === undefined ||
+            target.sessionOwnerNodeGeneration === undefined ||
+            target.sessionOwnerId === undefined ||
+            target.sessionOwnerLeaseGeneration === undefined ||
+            target.bindingGeneration === undefined) {
             throw new TypeError('An installed bound Session target requires its complete binding identity.');
         }
         const current = preferredRemoteBoundSessionTarget(this.remoteBoundSessionTargetValue, this.boundSessionTransferTargetValue);
@@ -373,8 +378,8 @@ class ZLinkActorRuntimeState {
             // lifecycle's generation; a late equal/lower generation is stale.
             if (sameRemoteSessionOwner(current, target))
                 return true;
-            if (current.bindingGeneration !== undefined
-                && current.bindingGeneration >= target.bindingGeneration)
+            if (current.bindingGeneration !== undefined &&
+                current.bindingGeneration >= target.bindingGeneration)
                 return false;
         }
         const installed = mergeRemoteBoundSessionTarget(target, current);
@@ -390,27 +395,28 @@ class ZLinkActorRuntimeState {
     }
     /** @internal Removes only the exact authority-confirmed Session incarnation. */
     retireBoundSessionBinding(target) {
-        if (target.sessionNodeRid === undefined
-            || target.sessionRid === undefined
-            || target.sessionOwnerNodeGeneration === undefined
-            || target.sessionOwnerId === undefined
-            || target.sessionOwnerLeaseGeneration === undefined
-            || target.bindingGeneration === undefined) {
+        if (target.sessionNodeRid === undefined ||
+            target.sessionRid === undefined ||
+            target.sessionOwnerNodeGeneration === undefined ||
+            target.sessionOwnerId === undefined ||
+            target.sessionOwnerLeaseGeneration === undefined ||
+            target.bindingGeneration === undefined) {
             throw new TypeError('A retired bound Session target requires its complete binding identity.');
         }
         let retired = false;
-        if (this.remoteBoundSessionTargetValue !== undefined
-            && sameRemoteSessionBinding(this.remoteBoundSessionTargetValue, target)) {
+        if (this.remoteBoundSessionTargetValue !== undefined &&
+            sameRemoteSessionBinding(this.remoteBoundSessionTargetValue, target)) {
             this.remoteBoundSessionTargetValue = undefined;
             retired = true;
         }
-        if (this.boundSessionTransferTargetValue !== undefined
-            && sameRemoteSessionBinding(this.boundSessionTransferTargetValue, target)) {
+        if (this.boundSessionTransferTargetValue !== undefined &&
+            sameRemoteSessionBinding(this.boundSessionTransferTargetValue, target)) {
             this.boundSessionTransferTargetValue = undefined;
             retired = true;
         }
         if (retired) {
-            this.boundSessionBindingGenerationValue = preferredRemoteBoundSessionTarget(this.remoteBoundSessionTargetValue, this.boundSessionTransferTargetValue)?.bindingGeneration ?? 0n;
+            this.boundSessionBindingGenerationValue =
+                preferredRemoteBoundSessionTarget(this.remoteBoundSessionTargetValue, this.boundSessionTransferTargetValue)?.bindingGeneration ?? 0n;
         }
         return retired;
     }
@@ -419,26 +425,26 @@ class ZLinkActorRuntimeState {
     }
     setRemoteBoundSessionTarget(target) {
         const current = preferredRemoteBoundSessionTarget(this.remoteBoundSessionTargetValue, this.boundSessionTransferTargetValue);
-        const merged = target === undefined
-            ? undefined
-            : mergeRemoteBoundSessionTarget(target, current);
+        const merged = target === undefined ? undefined : mergeRemoteBoundSessionTarget(target, current);
         const bindingGeneration = maxBindingGeneration(merged?.bindingGeneration, this.remoteBoundSessionTargetValue?.bindingGeneration, this.boundSessionBindingGenerationValue);
-        this.remoteBoundSessionTargetValue = merged === undefined
-            ? undefined
-            : bindingGeneration === undefined
-                ? merged
-                : { ...merged, bindingGeneration };
+        this.remoteBoundSessionTargetValue =
+            merged === undefined
+                ? undefined
+                : bindingGeneration === undefined
+                    ? merged
+                    : { ...merged, bindingGeneration };
     }
     setBoundSessionTransferTarget(target) {
         const merged = target === undefined
             ? undefined
             : mergeRemoteBoundSessionTarget(target, this.boundSessionTransferTargetValue);
         const bindingGeneration = maxBindingGeneration(merged?.bindingGeneration, this.boundSessionTransferTargetValue?.bindingGeneration, this.boundSessionBindingGenerationValue);
-        this.boundSessionTransferTargetValue = merged === undefined
-            ? undefined
-            : bindingGeneration === undefined
-                ? merged
-                : { ...merged, bindingGeneration };
+        this.boundSessionTransferTargetValue =
+            merged === undefined
+                ? undefined
+                : bindingGeneration === undefined
+                    ? merged
+                    : { ...merged, bindingGeneration };
     }
     setRemoteActorPacketTarget(target) {
         this.remoteActorPacketTargetValue = target;
@@ -487,8 +493,8 @@ class ZLinkActorRuntimeState {
     prepareForRemoteReentry() {
         if (this.remoteActorPacketTargetValue === undefined)
             return;
-        const relocationTransferTarget = this.boundSessionTransferTargetValue !== undefined
-            && hasRelocationFence(this.boundSessionTransferTargetValue)
+        const relocationTransferTarget = this.boundSessionTransferTargetValue !== undefined &&
+            hasRelocationFence(this.boundSessionTransferTargetValue)
             ? this.boundSessionTransferTargetValue
             : undefined;
         this.creationTask = undefined;

package/dist/runtime/actors/actor-transfer-registry.js

@@ -25,13 +25,11 @@ class ZLinkActorTransferRegistry {
     }
     async transferOut(actor, actorType, signal) {
         (0, abort_1.throwIfAborted)(signal);
-        const adapterType = actorType === undefined
-            ? undefined
-            : this.byKey.get(actorType);
+        const adapterType = actorType === undefined ? undefined : this.byKey.get(actorType);
         if (adapterType === undefined) {
             return { state: emptyTransferState(this.messageSerializers) };
         }
-        const adapter = await this.createAdapter(adapterType);
+        const adapter = (await this.createAdapter(adapterType));
         const state = await adapter.capture(actor, signal ?? new AbortController().signal);
         if (!(state instanceof Uint8Array)) {
             throw new Error(`Actor relocation adapter '${adapterType.name}' returned invalid state bytes.`);
@@ -50,7 +48,7 @@ class ZLinkActorTransferRegistry {
         if (adapterType === undefined) {
             throw new Error(`Actor relocation adapter for stable type '${adapterKey}' is not registered on the target node.`);
         }
-        const adapter = await this.createAdapter(adapterType);
+        const adapter = (await this.createAdapter(adapterType));
         await adapter.restore(actor, state.toEncodedPayload().toBytes(), signal ?? new AbortController().signal);
     }
     async createAdapter(adapterType) {

package/dist/runtime/actors/bound-session-wire.js

@@ -32,10 +32,10 @@ function isRemoteBoundSessionFenceError(error) {
     if (error.code === exports.ZLINK_REMOTE_BOUND_SESSION_FENCE_NACK_CODE)
         return true;
     // Fallback for transports that only surface the session owner's message.
-    return error.message.includes('did not match its command 42 Session seal')
-        || error.message.includes('released Session seal cannot publish a different route')
-        || error.message.includes('was fenced by its binding identity')
-        || error.message.includes('session route seal abort was fenced');
+    return (error.message.includes('did not match its command 42 Session seal') ||
+        error.message.includes('released Session seal cannot publish a different route') ||
+        error.message.includes('was fenced by its binding identity') ||
+        error.message.includes('session route seal abort was fenced'));
 }
 /** Encodes a request/reply nack for the command 42/44/45 packet family. */
 function encodeRemoteBoundSessionNack(error) {
@@ -117,11 +117,16 @@ function optionalFlowOrigin(payload) {
     // internal wire deployed atomically with this repository, so the decoder
     // accepts only the spec spelling.
     switch (payload.flowOrigin) {
-        case 'inbound': return 'Inbound';
-        case 'timer': return 'Timer';
-        case 'application': return 'Application';
-        case 'lifecycle': return 'Lifecycle';
-        default: return undefined;
+        case 'inbound':
+            return 'Inbound';
+        case 'timer':
+            return 'Timer';
+        case 'application':
+            return 'Application';
+        case 'lifecycle':
+            return 'Lifecycle';
+        default:
+            return undefined;
     }
 }
 function decodeRemoteBoundSessionResponsePayload(payload) {