@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/host/spot-address-transport.js

@@ -54,8 +54,8 @@ class ZLinkHostSpotAddressTransport {
                     else {
                         this.traceInstanceAddress(submitResultFlowOutcome(result.status), ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send, spotId, message, existing.routerChannelId, existing.stableType, existing.targetNodeRid, submitResultReason(result.status));
                     }
-                    if (result.status === submission_result_1.ZLinkSubmitStatus.TargetNotFound
-                        || result.status === submission_result_1.ZLinkSubmitStatus.RouteNotConnected) {
+                    if (result.status === submission_result_1.ZLinkSubmitStatus.TargetNotFound ||
+                        result.status === submission_result_1.ZLinkSubmitStatus.RouteNotConnected) {
                         this.options.resolver()?.invalidate?.(spotId);
                     }
                     return result;
@@ -90,11 +90,11 @@ class ZLinkHostSpotAddressTransport {
             }
             deadline.setOwnerTimeout(this.sendTimeoutMsForMesh(selected.meshName));
             const encoded = this.encode(3 /* ZLinkChannelMessageKind.Command */, selected.meshName, message);
-            const sourceSpotId = call.sourceSpot === undefined
-                ? undefined
-                : String(call.sourceSpot.routingId);
+            const sourceSpotId = call.sourceSpot === undefined ? undefined : String(call.sourceSpot.routingId);
             const mapped = mapSubmitResult(await (0, abort_1.awaitWithAbort)(selected.node.sendToMissingInstanceSpot(selected.target, encoded, BigInt(deadline.deadlineUnixMs), sourceSpotId, call.metadata), deadline.signal));
-            this.traceInstanceAddress(submitResultFlowOutcome(mapped.status), ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send, spotId, message, selected.meshName, selected.target.stableType, selected.target.targetNodeRid, mapped.status === submission_result_1.ZLinkSubmitStatus.Submitted ? undefined : submitResultReason(mapped.status));
+            this.traceInstanceAddress(submitResultFlowOutcome(mapped.status), ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send, spotId, message, selected.meshName, selected.target.stableType, selected.target.targetNodeRid, mapped.status === submission_result_1.ZLinkSubmitStatus.Submitted
+                ? undefined
+                : submitResultReason(mapped.status));
             return mapped;
         }
         catch (error) {
@@ -155,9 +155,10 @@ class ZLinkHostSpotAddressTransport {
             }
         }
         catch (error) {
-            if (deadline.expired()
-                && !(error instanceof contracts_1.ZLinkFrameworkException
-                    && (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound)) {
+            if (deadline.expired() &&
+                !(error instanceof contracts_1.ZLinkFrameworkException &&
+                    (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) ===
+                        framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound)) {
                 throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded, `Spot request for '${String(spotId)}' exceeded its end-to-end deadline.`, true, error);
             }
             throw error;
@@ -205,8 +206,8 @@ class ZLinkHostSpotAddressTransport {
             completionPromise = table.submit(() => selected.node.requestToMissingInstanceSpot(selected.target, encoded, deadlineUnixMs, call.sourceSpot === undefined ? undefined : String(call.sourceSpot.routingId), call.metadata), deadline.signal);
         }
         catch (error) {
-            if (error instanceof contracts_1.ZLinkFrameworkException
-                && (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound) {
+            if (error instanceof contracts_1.ZLinkFrameworkException &&
+                (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound) {
                 PRE_ADMISSION_MISSING_INSTANCE_ERRORS.add(error);
             }
             throw error;
@@ -266,17 +267,17 @@ class ZLinkHostSpotAddressTransport {
             return await (0, abort_1.awaitWithAbort)(resolver.resolve(spotId, signal), signal);
         }
         catch (error) {
-            if (error instanceof contracts_1.ZLinkFrameworkException
-                && (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound) {
+            if (error instanceof contracts_1.ZLinkFrameworkException &&
+                (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound) {
                 return undefined;
             }
             throw error;
         }
     }
     async recoverStaleInstanceRoute(spotId, call, deadline, error, staleRoute) {
-        if (!call.instanceSpot
-            || !(error instanceof contracts_1.ZLinkFrameworkException)
-            || !isInstanceRouteStaleError(error)) {
+        if (!call.instanceSpot ||
+            !(error instanceof contracts_1.ZLinkFrameworkException) ||
+            !isInstanceRouteStaleError(error)) {
             return { kind: 'fail' };
         }
         for (;;) {
@@ -292,8 +293,8 @@ class ZLinkHostSpotAddressTransport {
     }
     selectMissingTarget(spotId, call) {
         const configuredMeshes = this.options.meshNames();
-        if (call.initialMeshName !== undefined
-            && this.options.isMeshConfigured?.(call.initialMeshName) === false) {
+        if (call.initialMeshName !== undefined &&
+            this.options.isMeshConfigured?.(call.initialMeshName) === false) {
             throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.MeshNotFound, `RouteMesh '${call.initialMeshName}' is not configured.`);
         }
         if (call.initialMeshName !== undefined && !configuredMeshes.includes(call.initialMeshName)) {
@@ -305,13 +306,12 @@ class ZLinkHostSpotAddressTransport {
         if (call.initialMeshName === undefined && configuredMeshes.length > 1) {
             throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.MeshSelectionRequired, 'Multiple object-client RouteMeshes are configured; call inMesh(...).');
         }
-        const meshNames = call.initialMeshName === undefined
-            ? configuredMeshes
-            : [call.initialMeshName];
-        const distinctTypes = [...new Set(meshNames.flatMap(meshName => this.options.meshNode(meshName)?.instanceSpotPlacementTypes?.() ?? []))];
-        const canInspectPlacementTypes = meshNames.some(meshName => typeof this.options.meshNode(meshName)?.instanceSpotPlacementTypes === 'function');
-        const stableType = call.instanceSpotType
-            ?? (distinctTypes.length === 1 ? distinctTypes[0] : undefined);
+        const meshNames = call.initialMeshName === undefined ? configuredMeshes : [call.initialMeshName];
+        const distinctTypes = [
+            ...new Set(meshNames.flatMap((meshName) => this.options.meshNode(meshName)?.instanceSpotPlacementTypes?.() ?? []))
+        ];
+        const canInspectPlacementTypes = meshNames.some((meshName) => typeof this.options.meshNode(meshName)?.instanceSpotPlacementTypes === 'function');
+        const stableType = call.instanceSpotType ?? (distinctTypes.length === 1 ? distinctTypes[0] : undefined);
         if (stableType === undefined) {
             if (distinctTypes.length === 0)
                 return { kind: 'unsupported' };
@@ -358,21 +358,20 @@ class ZLinkHostSpotAddressTransport {
         return { kind: 'unavailable' };
     }
     sendTimeoutMsForMesh(meshName) {
-        return this.options.sendTimeoutMsForMesh?.(meshName)
-            ?? this.options.defaultSendTimeoutMs
-            ?? this.options.defaultRequestTimeoutMs;
+        return (this.options.sendTimeoutMsForMesh?.(meshName) ??
+            this.options.defaultSendTimeoutMs ??
+            this.options.defaultRequestTimeoutMs);
     }
     sendTimeoutMsForRouteChannel(routeChannelId) {
-        return this.options.sendTimeoutMsForRouteChannel?.(routeChannelId)
-            ?? this.options.defaultSendTimeoutMs
-            ?? this.options.defaultRequestTimeoutMs;
+        return (this.options.sendTimeoutMsForRouteChannel?.(routeChannelId) ??
+            this.options.defaultSendTimeoutMs ??
+            this.options.defaultRequestTimeoutMs);
     }
     validateExisting(target, call) {
         if (!call.instanceSpot)
             return;
-        if (target.spotKind !== contracts_2.ZLinkSpotKind.Instance
-            || (call.instanceSpotType !== undefined
-                && target.stableType !== call.instanceSpotType)) {
+        if (target.spotKind !== contracts_2.ZLinkSpotKind.Instance ||
+            (call.instanceSpotType !== undefined && target.stableType !== call.instanceSpotType)) {
             throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotTypeMismatch, `Spot '${String(target.spotId)}' is not the requested Instance Spot type.`);
         }
     }
@@ -399,8 +398,7 @@ function isInstanceRouteStaleError(error) {
     return false;
 }
 function isMissingInstanceRetryError(error) {
-    return error instanceof contracts_1.ZLinkFrameworkException
-        && PRE_ADMISSION_MISSING_INSTANCE_ERRORS.has(error);
+    return (error instanceof contracts_1.ZLinkFrameworkException && PRE_ADMISSION_MISSING_INSTANCE_ERRORS.has(error));
 }
 function missingInstanceRequestFailure(result, nativeErrno) {
     const canonical = (0, framework_errors_internal_1.isCanonicalWireReplyTerminal)(result, nativeErrno);
@@ -416,12 +414,12 @@ function missingInstanceRequestFailure(result, nativeErrno) {
                 : result === runtime_values_1.RequestResult.Terminated
                     ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RuntimeShutdown
                     : result === runtime_values_1.RequestResult.Backpressured
-                        //  Spec 32-framework-error-model:104-108 — the bounded admission
-                        //  terminal is target placement capacity: Unavailable.
-                        ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted
+                        ? //  Spec 32-framework-error-model:104-108 — the bounded admission
+                            //  terminal is target placement capacity: Unavailable.
+                            framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted
                         : result === runtime_values_1.RequestResult.NotConnected
                             ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected
-                            : wireKind ?? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestFailed;
+                            : (wireKind ?? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestFailed);
     return (0, framework_errors_internal_1.createInternalFrameworkException)(kind, `Instance Spot request failed with result ${result} and errno ${nativeErrno}.`);
 }
 function mapSubmitResult(result) {
@@ -453,25 +451,25 @@ function isSpotRouteRefreshError(error) {
     if (!(error instanceof contracts_1.ZLinkFrameworkException))
         return false;
     const kind = (0, framework_errors_internal_1.internalFrameworkErrorKind)(error);
-    return kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound
-        || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale
-        || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotMoving
-        || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound
-        || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale
-        || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected;
+    return (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound ||
+        kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale ||
+        kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotMoving ||
+        kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound ||
+        kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale ||
+        kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected);
 }
 function sameSpotRouteSnapshot(left, right) {
-    return String(left.targetNodeRid) === String(right.targetNodeRid)
-        && String(left.spotId) === String(right.spotId)
-        && left.routerChannelId === right.routerChannelId
-        && left.spotKind === right.spotKind
-        && left.stableType === right.stableType
-        && left.targetSpotGeneration === right.targetSpotGeneration
-        && left.targetNodeGeneration === right.targetNodeGeneration
-        && left.authorityOwnerGeneration === right.authorityOwnerGeneration
-        && left.targetOwnerId === right.targetOwnerId
-        && left.ownerLeaseGeneration === right.ownerLeaseGeneration
-        && left.authorityStoreVersion === right.authorityStoreVersion;
+    return (String(left.targetNodeRid) === String(right.targetNodeRid) &&
+        String(left.spotId) === String(right.spotId) &&
+        left.routerChannelId === right.routerChannelId &&
+        left.spotKind === right.spotKind &&
+        left.stableType === right.stableType &&
+        left.targetSpotGeneration === right.targetSpotGeneration &&
+        left.targetNodeGeneration === right.targetNodeGeneration &&
+        left.authorityOwnerGeneration === right.authorityOwnerGeneration &&
+        left.targetOwnerId === right.targetOwnerId &&
+        left.ownerLeaseGeneration === right.ownerLeaseGeneration &&
+        left.authorityStoreVersion === right.authorityStoreVersion);
 }
 function waitForSpotRouteRefresh(delayMs, signal) {
     return new Promise((resolve, reject) => {
@@ -520,21 +518,21 @@ function submitResultFlowOutcome(status) {
 function addressedInstanceErrorReason(error) {
     if (error instanceof contracts_1.ZLinkFrameworkException) {
         const kind = (0, framework_errors_internal_1.internalFrameworkErrorKind)(error);
-        if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotMoving
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected) {
+        if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotMoving ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected) {
             return ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.StaleTarget;
         }
         if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RuntimeShutdown) {
             return ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.Shutdown;
         }
-        if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.WorkerQueueFull
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.WorkerTimedOut
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded) {
+        if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.WorkerQueueFull ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.WorkerTimedOut ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded) {
             return ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.Backpressure;
         }
     }
@@ -542,10 +540,10 @@ function addressedInstanceErrorReason(error) {
 }
 function initialSendTimeoutMs(options, call) {
     return call.initialMeshName === undefined
-        ? options.defaultSendTimeoutMs ?? options.defaultRequestTimeoutMs
-        : options.sendTimeoutMsForMesh?.(call.initialMeshName)
-            ?? options.defaultSendTimeoutMs
-            ?? options.defaultRequestTimeoutMs;
+        ? (options.defaultSendTimeoutMs ?? options.defaultRequestTimeoutMs)
+        : (options.sendTimeoutMsForMesh?.(call.initialMeshName) ??
+            options.defaultSendTimeoutMs ??
+            options.defaultRequestTimeoutMs);
 }
 function createSpotAddressDeadline(timeoutMs, parent) {
     const startedAtMs = performance.now();

package/dist/runtime/host/spot-runtime-options-factory.js

@@ -17,9 +17,12 @@ class ZLinkSpotRuntimeOptionsFactory {
             nodeGenerationProvider: (meshName) => this.options.spotNodeRuntime()?.meshNode(meshName)?.status().lifecycleGeneration,
             entryNodeRid: undefined,
             entryNodeRidProvider: () => this.primaryNodeRoutingId(),
-            entrySpotIdProvider: meshName => this.options.spotNodeRuntime()?.entrySpotIdForMesh(meshName),
+            entrySpotIdProvider: (meshName) => this.options.spotNodeRuntime()?.entrySpotIdForMesh(meshName),
             entrySpotCallbacks: {
-                onLeaveActor: (actor, signal, actorRef, membershipEpoch) => this.options.spotNodeRuntime()?.notifyPrimaryEntrySpotActorLeft(actor, signal, actorRef, membershipEpoch) ?? Promise.resolve()
+                onLeaveActor: (actor, signal, actorRef, membershipEpoch) => this.options
+                    .spotNodeRuntime()
+                    ?.notifyPrimaryEntrySpotActorLeft(actor, signal, actorRef, membershipEpoch) ??
+                    Promise.resolve()
             },
             dispatchEntryActorPacket: (actorId, parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef, requestTerminal, messageFollowOrigin) => {
                 const runtime = this.options.spotNodeRuntime();
@@ -54,13 +57,14 @@ class ZLinkSpotRuntimeOptionsFactory {
             releaseInstanceAuthority: (meshName, spotId, objectGeneration) => this.options.releaseInstanceAuthority(meshName, String(spotId), objectGeneration),
             beginInstanceIdleClosingAuthority: (meshName, spotId) => this.options.beginInstanceIdleClosingAuthority(meshName, String(spotId)),
             beginInstanceClosingAuthority: (meshName, spotId) => this.options.beginInstanceClosingAuthority(meshName, String(spotId)),
-            instanceSpotApplicationTargetProvider: (meshName, spotId) => this.options.spotNodeRuntime()
+            instanceSpotApplicationTargetProvider: (meshName, spotId) => this.options
+                .spotNodeRuntime()
                 ?.meshNode(meshName)
                 ?.instanceSpotApplicationTarget?.(String(spotId)),
-            instanceSpotApplicationQuiescenceProvider: (meshName, spotId, signal) => this.options.spotNodeRuntime()
+            instanceSpotApplicationQuiescenceProvider: (meshName, spotId, signal) => this.options
+                .spotNodeRuntime()
                 ?.meshNode(meshName)
-                ?.waitForInstanceApplicationQuiescence?.(String(spotId), signal)
-                ?? Promise.resolve(),
+                ?.waitForInstanceApplicationQuiescence?.(String(spotId), signal) ?? Promise.resolve(),
             createNativeSpot: (meshName, spotId, authority) => {
                 const node = this.options.spotNodeRuntime()?.meshNode(meshName);
                 if (node === undefined) {
@@ -68,10 +72,9 @@ class ZLinkSpotRuntimeOptionsFactory {
                 }
                 const restored = authority === undefined
                     ? undefined
-                    : node.restoreSpotAuthority?.(String(spotId), authority.objectKind ?? 'user_spot', authority.stableType, authority.objectGeneration, authority.authorityOwnerGeneration) ?? node.restoreUserSpotAuthority?.(String(spotId), authority.stableType, authority.objectGeneration, authority.authorityOwnerGeneration);
-                const result = restored === undefined
-                    ? node.getOrCreateSpot(spotId)
-                    : { spot: restored, created: true };
+                    : (node.restoreSpotAuthority?.(String(spotId), authority.objectKind ?? 'user_spot', authority.stableType, authority.objectGeneration, authority.authorityOwnerGeneration) ??
+                        node.restoreUserSpotAuthority?.(String(spotId), authority.stableType, authority.objectGeneration, authority.authorityOwnerGeneration));
+                const result = restored === undefined ? node.getOrCreateSpot(spotId) : { spot: restored, created: true };
                 return {
                     routingId: spotId,
                     lifecycleGeneration: result.spot.status().lifecycleGeneration,
@@ -115,12 +118,12 @@ class ZLinkSpotRuntimeOptionsFactory {
                     ? undefined
                     : (0, actors_1.toFrameworkActorRef)(state.nativeActorRef, state.meshName ?? '');
                 const localNodeRid = this.primaryNodeRoutingId();
-                if (state?.actor === undefined
-                    || state.spot === undefined
-                    || state.remoteActorPacketTarget !== undefined
-                    || actorRef === undefined
-                    || localNodeRid === undefined
-                    || String(actorRef.nodeRid) !== localNodeRid) {
+                if (state?.actor === undefined ||
+                    state.spot === undefined ||
+                    state.remoteActorPacketTarget !== undefined ||
+                    actorRef === undefined ||
+                    localNodeRid === undefined ||
+                    String(actorRef.nodeRid) !== localNodeRid) {
                     return {};
                 }
                 return {
@@ -129,22 +132,20 @@ class ZLinkSpotRuntimeOptionsFactory {
                 };
             },
             userSpotExecutionMode: (meshName, spotType) => {
-                const registrations = this.options.registration.spotNodes.get(meshName)
-                    ?.spotFactoryRegistrations ?? {};
-                const registration = Object.values(registrations)
-                    .find(candidate => candidate.implementation === spotType);
-                return registration?.options?.executionMode
-                    ?? contracts_1.ZLinkUserSpotExecutionMode.SpotWide;
+                const registrations = this.options.registration.spotNodes.get(meshName)?.spotFactoryRegistrations ?? {};
+                const registration = Object.values(registrations).find((candidate) => candidate.implementation === spotType);
+                return registration?.options?.executionMode ?? contracts_1.ZLinkUserSpotExecutionMode.SpotWide;
             },
             userSpotRelocationCoordinationMode: (meshName, spotType) => {
-                const registrations = this.options.registration.spotNodes.get(meshName)
-                    ?.spotFactoryRegistrations ?? {};
-                const registration = Object.values(registrations)
-                    .find(candidate => candidate.implementation === spotType);
-                return registration?.options?.relocationCoordinationMode
-                    ?? contracts_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged;
+                const registrations = this.options.registration.spotNodes.get(meshName)?.spotFactoryRegistrations ?? {};
+                const registration = Object.values(registrations).find((candidate) => candidate.implementation === spotType);
+                return (registration?.options?.relocationCoordinationMode ??
+                    contracts_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged);
             },
-            actorBindingGenerationObserver: (actorId, generation) => this.options.actorManager()?.getState(actorId)?.setBoundSessionBindingGeneration(generation),
+            actorBindingGenerationObserver: (actorId, generation) => this.options
+                .actorManager()
+                ?.getState(actorId)
+                ?.setBoundSessionBindingGeneration(generation),
             actorTransferRuntime,
             boundSessionRuntime: this.options.boundSessionRelay.boundSessions,
             actorHandoffRuntime: this.options.actorHandoff,

package/dist/runtime/host/stateful-authority-route-runtime.js

@@ -65,9 +65,9 @@ class ZLinkStatefulAuthorityRouteRuntime {
             const previous = this.appliedByMesh.get(meshName) ?? new Map();
             const status = sink.status();
             for (const pending of snapshot.pending) {
-                if (pending.targetMeshName === meshName
-                    && (0, routing_id_1.routingIdsEqual)(status.routingId, pending.targetNodeRid)
-                    && status.lifecycleGeneration === pending.targetNodeGeneration) {
+                if (pending.targetMeshName === meshName &&
+                    (0, routing_id_1.routingIdsEqual)(status.routingId, pending.targetNodeRid) &&
+                    status.lifecycleGeneration === pending.targetNodeGeneration) {
                     await this.recoverPendingInstanceActivation(sink, pending, signal);
                 }
             }
@@ -76,17 +76,14 @@ class ZLinkStatefulAuthorityRouteRuntime {
                     continue;
                 const previousRoute = previous.get(key);
                 const expectedSpotRoute = previousRoute?.spotRoute ?? null;
-                const expectedInstanceRoute = previousRoute?.kind === 'instance_spot'
-                    ? previousRoute.instanceRoute
-                    : null;
+                const expectedInstanceRoute = previousRoute?.kind === 'instance_spot' ? previousRoute.instanceRoute : null;
                 sink.rememberSpotRoute(route.spotRoute, expectedSpotRoute);
                 if (route.kind === 'instance_spot') {
                     const status = sink.status();
-                    if ((0, routing_id_1.routingIdsEqual)(status.routingId, route.instanceRoute.targetNodeRid)
-                        && status.lifecycleGeneration === route.instanceRoute.targetNodeGeneration) {
+                    if ((0, routing_id_1.routingIdsEqual)(status.routingId, route.instanceRoute.targetNodeRid) &&
+                        status.lifecycleGeneration === route.instanceRoute.targetNodeGeneration) {
                         if (route.activationRecovery !== undefined) {
-                            if (route.activationRecovery.replayCursor
-                                === route.activationRecovery.inboxSequence) {
+                            if (route.activationRecovery.replayCursor === route.activationRecovery.inboxSequence) {
                                 const released = await sink.completeRecoveredInstanceActivation({
                                     targetSpotId: route.instanceRoute.targetSpotId,
                                     stableType: route.stableType,
@@ -164,16 +161,16 @@ class ZLinkStatefulAuthorityRouteRuntime {
     async recoverInstanceActivation(sink, route, recovery, expectedCurrentRoute, signal) {
         const envelope = await this.readRecoveryEnvelope(recovery, signal);
         const status = sink.status();
-        if (envelope.targetMeshName !== route.meshName
-            || envelope.target.stableType !== route.stableType
-            || envelope.target.targetSpotId !== route.instanceRoute.targetSpotId
-            || envelope.target.targetNodeRid !== route.instanceRoute.targetNodeRid
-            || envelope.target.targetNodeGeneration !== route.instanceRoute.targetNodeGeneration
-            || envelope.target.descriptorVersion !== status.descriptorRevision.toString()) {
+        if (envelope.targetMeshName !== route.meshName ||
+            envelope.target.stableType !== route.stableType ||
+            envelope.target.targetSpotId !== route.instanceRoute.targetSpotId ||
+            envelope.target.targetNodeRid !== route.instanceRoute.targetNodeRid ||
+            envelope.target.targetNodeGeneration !== route.instanceRoute.targetNodeGeneration ||
+            envelope.target.descriptorVersion !== status.descriptorRevision.toString()) {
             this.options.reportError(new Error('Instance activation recovery envelope does not match Ready authority.'));
             return false;
         }
-        return (await sink.recoverInstanceActivation(envelope, route.instanceRoute, expectedCurrentRoute)) !== false;
+        return ((await sink.recoverInstanceActivation(envelope, route.instanceRoute, expectedCurrentRoute)) !== false);
     }
     async recoverPendingInstanceActivation(sink, recovery, signal) {
         const envelope = await this.readRecoveryEnvelope({
@@ -184,12 +181,12 @@ class ZLinkStatefulAuthorityRouteRuntime {
             replayCursor: 0n
         }, signal);
         const status = sink.status();
-        if (envelope.targetMeshName !== recovery.targetMeshName
-            || envelope.target.stableType !== recovery.stableType
-            || envelope.target.targetSpotId !== recovery.spotId
-            || envelope.target.targetNodeRid !== recovery.targetNodeRid
-            || envelope.target.targetNodeGeneration !== recovery.targetNodeGeneration
-            || envelope.target.descriptorVersion !== status.descriptorRevision.toString()) {
+        if (envelope.targetMeshName !== recovery.targetMeshName ||
+            envelope.target.stableType !== recovery.stableType ||
+            envelope.target.targetSpotId !== recovery.spotId ||
+            envelope.target.targetNodeRid !== recovery.targetNodeRid ||
+            envelope.target.targetNodeGeneration !== recovery.targetNodeGeneration ||
+            envelope.target.descriptorVersion !== status.descriptorRevision.toString()) {
             const creationStore = this.options.creationStore;
             if (creationStore === undefined) {
                 this.options.reportError(new Error('Pending Instance activation mismatch requires an object creation store.'));
@@ -234,8 +231,8 @@ class ZLinkStatefulAuthorityRouteRuntime {
         }
         const payload = Buffer.from(result.bytes);
         const sha256 = (0, node_crypto_1.createHash)('sha256').update(payload).digest();
-        if (payload.byteLength !== recovery.encodedSize
-            || !sha256.equals(Buffer.from(recovery.sha256))) {
+        if (payload.byteLength !== recovery.encodedSize ||
+            !sha256.equals(Buffer.from(recovery.sha256))) {
             throw new Error(`Instance activation recovery payload '${recovery.reference}' failed integrity validation.`);
         }
         return (0, service_instance_activation_recovery_codec_1.decodeInstanceActivationRecoveryEnvelope)(payload);
@@ -283,9 +280,9 @@ class ZLinkStatefulAuthorityRouteRuntime {
             const route = authorityRoute(current);
             if (route !== undefined)
                 result.set(authorityRouteKey(route), route);
-            if (current.allocation.state === 'active'
-                && current.allocation.objectKind === 'actor'
-                && (0, actors_1.decodeActorAuthorityIdentity)((0, service_relocation_runtime_1.serviceRelocationAuthorityApplicationPayload)(current.payload), current.objectGeneration) !== undefined) {
+            if (current.allocation.state === 'active' &&
+                current.allocation.objectKind === 'actor' &&
+                (0, actors_1.decodeActorAuthorityIdentity)((0, service_relocation_runtime_1.serviceRelocationAuthorityApplicationPayload)(current.payload), current.objectGeneration) !== undefined) {
                 actors.push(current);
             }
             const pendingRecovery = pendingInstanceActivation(current);
@@ -301,27 +298,28 @@ function authorityNeedsExactRead(snapshot, relocationCodec) {
         return true;
     if (relocationCodec.read(snapshot.payload) !== undefined)
         return true;
-    if ((0, service_authority_payload_codec_1.decodeServiceReadySpotAuthority)((0, service_relocation_runtime_1.serviceRelocationAuthorityApplicationPayload)(snapshot.payload))?.activationRecovery !== undefined) {
+    if ((0, service_authority_payload_codec_1.decodeServiceReadySpotAuthority)((0, service_relocation_runtime_1.serviceRelocationAuthorityApplicationPayload)(snapshot.payload))
+        ?.activationRecovery !== undefined) {
         return true;
     }
-    return snapshot.allocation.state === 'active'
-        && snapshot.allocation.objectKind === 'actor'
-        && (0, actors_1.decodeActorAuthorityIdentity)(snapshot.payload, snapshot.objectGeneration) !== undefined;
+    return (snapshot.allocation.state === 'active' &&
+        snapshot.allocation.objectKind === 'actor' &&
+        (0, actors_1.decodeActorAuthorityIdentity)(snapshot.payload, snapshot.objectGeneration) !== undefined);
 }
 function pendingInstanceActivation(snapshot) {
     const allocation = snapshot.allocation;
     const projection = snapshot.pendingCreation;
     const decoded = (0, service_authority_payload_codec_1.decodeServiceInstanceAuthorityPayload)(snapshot.payload);
-    if (allocation.state !== 'reserved'
-        || allocation.objectKind !== 'instance_spot'
-        || projection === undefined
-        || decoded?.state !== 'coldActivating'
-        || decoded.stableType !== allocation.stableType
-        || decoded.ownerId !== snapshot.ownerId
-        || decoded.ownerLeaseGeneration !== snapshot.ownerLeaseGeneration
-        || decoded.ownerMeshName !== allocation.descriptor.meshName
-        || decoded.ownerNodeGeneration !== allocation.descriptorLifecycleGeneration
-        || !(0, routing_id_1.routingIdsEqual)(decoded.ownerNodeRid, allocation.descriptor.rid)) {
+    if (allocation.state !== 'reserved' ||
+        allocation.objectKind !== 'instance_spot' ||
+        projection === undefined ||
+        decoded?.state !== 'coldActivating' ||
+        decoded.stableType !== allocation.stableType ||
+        decoded.ownerId !== snapshot.ownerId ||
+        decoded.ownerLeaseGeneration !== snapshot.ownerLeaseGeneration ||
+        decoded.ownerMeshName !== allocation.descriptor.meshName ||
+        decoded.ownerNodeGeneration !== allocation.descriptorLifecycleGeneration ||
+        !(0, routing_id_1.routingIdsEqual)(decoded.ownerNodeRid, allocation.descriptor.rid)) {
         return undefined;
     }
     return {
@@ -349,17 +347,17 @@ function pendingInstanceActivation(snapshot) {
 function authorityRoute(snapshot) {
     const allocation = snapshot.allocation;
     const decoded = (0, service_authority_payload_codec_1.decodeServiceReadySpotAuthority)((0, service_relocation_runtime_1.serviceRelocationAuthorityApplicationPayload)(snapshot.payload));
-    if (allocation.state !== 'active'
-        || allocation.objectKind === 'actor'
-        || allocation.descriptor.meshName.length === 0
-        || decoded === undefined
-        || decoded.kind !== allocation.objectKind
-        || decoded.stableType !== allocation.stableType
-        || decoded.ownerId !== snapshot.ownerId
-        || decoded.ownerLeaseGeneration !== snapshot.ownerLeaseGeneration
-        || decoded.ownerMeshName !== allocation.descriptor.meshName
-        || decoded.ownerNodeGeneration !== allocation.descriptorLifecycleGeneration
-        || !(0, routing_id_1.routingIdsEqual)(decoded.ownerNodeRid, allocation.descriptor.rid)) {
+    if (allocation.state !== 'active' ||
+        allocation.objectKind === 'actor' ||
+        allocation.descriptor.meshName.length === 0 ||
+        decoded === undefined ||
+        decoded.kind !== allocation.objectKind ||
+        decoded.stableType !== allocation.stableType ||
+        decoded.ownerId !== snapshot.ownerId ||
+        decoded.ownerLeaseGeneration !== snapshot.ownerLeaseGeneration ||
+        decoded.ownerMeshName !== allocation.descriptor.meshName ||
+        decoded.ownerNodeGeneration !== allocation.descriptorLifecycleGeneration ||
+        !(0, routing_id_1.routingIdsEqual)(decoded.ownerNodeRid, allocation.descriptor.rid)) {
         return undefined;
     }
     const spotId = decoded.spotId;
@@ -393,28 +391,27 @@ function authorityRoute(snapshot) {
     };
 }
 function authorityRouteKey(route) {
-    return `${route.meshName}\0${route.spotRoute.spot.spotId}\0`
-        + `${route.spotRoute.spot.generation}`;
+    return (`${route.meshName}\0${route.spotRoute.spot.spotId}\0` + `${route.spotRoute.spot.generation}`);
 }
 function sameAppliedRoute(left, right) {
     if (right === undefined)
         return false;
-    return left.kind === right.kind
-        && left.stableType === right.stableType
-        && left.meshName === right.meshName
-        && left.instanceRoute.targetNodeRid === right.instanceRoute.targetNodeRid
-        && left.instanceRoute.targetNodeGeneration === right.instanceRoute.targetNodeGeneration
-        && left.instanceRoute.authorityOwnerGeneration === right.instanceRoute.authorityOwnerGeneration
-        && left.instanceRoute.storeVersion === right.instanceRoute.storeVersion;
+    return (left.kind === right.kind &&
+        left.stableType === right.stableType &&
+        left.meshName === right.meshName &&
+        left.instanceRoute.targetNodeRid === right.instanceRoute.targetNodeRid &&
+        left.instanceRoute.targetNodeGeneration === right.instanceRoute.targetNodeGeneration &&
+        left.instanceRoute.authorityOwnerGeneration === right.instanceRoute.authorityOwnerGeneration &&
+        left.instanceRoute.storeVersion === right.instanceRoute.storeVersion);
 }
 function asStatefulAuthorityRouteSink(node) {
     const candidate = node;
-    return typeof candidate.rememberSpotRoute === 'function'
-        && typeof candidate.forgetSpotRoute === 'function'
-        && typeof candidate.registerInstanceIntent === 'function'
-        && typeof candidate.forgetInstanceIntent === 'function'
-        && typeof candidate.recoverInstanceActivation === 'function'
-        && typeof candidate.completeRecoveredInstanceActivation === 'function'
+    return typeof candidate.rememberSpotRoute === 'function' &&
+        typeof candidate.forgetSpotRoute === 'function' &&
+        typeof candidate.registerInstanceIntent === 'function' &&
+        typeof candidate.forgetInstanceIntent === 'function' &&
+        typeof candidate.recoverInstanceActivation === 'function' &&
+        typeof candidate.completeRecoveredInstanceActivation === 'function'
         ? candidate
         : undefined;
 }