@zlink-systems/framework 0.30.0 → 0.30.2

package/dist/runtime/spots/index.d.ts

@@ -15,7 +15,7 @@ import { type ReadyRecord, type ReceiveRecord } from '../foundation/service-runt
 import type { ZLinkBackendSpot, ZLinkBackendSpotNode } from '../backend/contracts';
 import { ZLinkDispatchErrorReporter } from '../channels';
 import { ZLinkWorkerRuntime } from '../workers';
-import { type ZLinkRemoteBoundSessionTarget } from '../actors';
+import { type ZLinkActorHandoffPrefixAdmission, type ZLinkActorHandoffPrefixRecord, type ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkLocationLifecycle } from '../locations';
 import { type ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 import type { CanonicalActorJoinRecovery } from '../foundation/actor-join-recovery-codec';
@@ -27,16 +27,17 @@ import { type ZLinkSpotRoutedTransport } from './spot-outbound';
 export { DefaultZLinkSpotHandlerRegistry, type ZLinkSpotHandlerRegistration } from './spot-handler-registry';
 export { ZLinkRuntimeSpotPublisherTransport } from './spot-publisher-transport';
 import type { ZLinkSpotActivation } from './spot-activation-state';
+import type { ZLinkSpotPreparationCompletion } from './spot-serial-executor';
 import { type ZLinkNativeSpotAuthority } from './spot-activation';
 import type { ZLinkSpotActorHandoffRuntime, ZLinkSpotActorTransferRuntime, ZLinkSpotBoundSessionRuntime } from './spot-runtime-ports';
-import type { ZLinkRuntimeAdmissionGate } from '../admission';
+import type { ZLinkRuntimeAdmissionGate, ZLinkMeshDispatchAdmission } from '../admission';
 import type { ZLinkActivationAdmission } from '../activation-admission';
 import type { ZLinkDetachedTaskRunner } from './spot-actor-join-dispatch';
 import type { ZLinkLocalSpotCreateResult } from './spot-manager-internal-contracts';
 export type { ZLinkLocalSpotCreateResult } from './spot-manager-internal-contracts';
 export type { ZLinkDetachedTaskRunner } from './spot-actor-join-dispatch';
 export { ZLinkEntrySpotActivation } from './spot-entry-activation';
-export { createFrameworkEntrySpotId, ZLinkSpotNodeRuntimeManager, type ZLinkSpotNodeRuntimeManagerOptions } from './spot-node-runtime-manager';
+export { createFrameworkEntrySpotId, registrationAcceptsNewActor, ZLinkSpotNodeRuntimeManager, type ZLinkSpotNodeRuntimeManagerOptions } from './spot-node-runtime-manager';
 export { ZLinkPublicSpotManager, type ZLinkPublicSpotManagerOptions } from './spot-manager-public';
 export interface ZLinkSpotManagerOptions {
     readonly spotFactories: readonly Type<ZLinkSpot>[];
@@ -62,8 +63,10 @@ export interface ZLinkSpotManagerOptions {
      * stateful reply has committed Core membership.
      */
     readonly dispatchEntryActorJoin?: (meshName: string, actor: ZLinkActor, handoffBacklog?: readonly ZLinkActorHandoffPacket[]) => Promise<void>;
+    readonly admitEntryActorPacketPrefix?: (meshName: string, actorId: string, records: readonly ZLinkActorHandoffPrefixRecord[]) => ZLinkActorHandoffPrefixAdmission;
     readonly executeEntryActor?: <T>(meshName: string, actorId: string, operation: () => Promise<T>) => Promise<T>;
     readonly actorCountProvider?: (spotId: RoutingId) => number;
+    readonly releaseActorMembers?: (meshName: string, spotId: RoutingId) => Promise<void>;
     readonly userSpotExecutionMode?: (meshName: string, spotType: Type<ZLinkSpot>) => import('../../contracts').ZLinkUserSpotExecutionMode;
     readonly userSpotRelocationCoordinationMode?: (meshName: string, spotType: Type<ZLinkSpot>) => import('../../contracts').ZLinkSpotRelocationCoordinationMode;
     readonly actorDispatchOwnerResolver?: (actorId: string) => {
@@ -145,11 +148,11 @@ export declare class DefaultZLinkSpotManager {
     relocationActivations(meshName: string): readonly ZLinkSpotActivation[];
     activeSpotCount(meshName: string): number;
     resolveRelocationActivation(meshName: string, spotId: RoutingId): ZLinkSpotActivation | undefined;
-    prepareRelocationSpot(meshName: string, objectKind: 'user_spot' | 'instance_spot', stableType: string, implementation: Type<ZLinkSpot | ZLinkInstanceSpot>, spotId: RoutingId, objectGeneration: bigint, authorityOwnerGeneration: bigint, signal?: AbortSignal): Promise<ZLinkSpotActivation>;
+    prepareRelocationSpot(meshName: string, objectKind: 'user_spot' | 'instance_spot', stableType: string, implementation: Type<ZLinkSpot | ZLinkInstanceSpot>, spotId: RoutingId, objectGeneration: bigint, authorityOwnerGeneration: bigint, restoredTimers: readonly import('./spot-timer').ZLinkTimerRelocationState[], signal?: AbortSignal): Promise<ZLinkSpotActivation>;
     publishRelocationSpot(activation: ZLinkSpotActivation, beforeAdmission?: () => Promise<void>): Promise<void>;
     abortRelocationSpot(activation: ZLinkSpotActivation): Promise<void>;
     completeRelocationSource(activation: ZLinkSpotActivation): Promise<void>;
-    materializeInstance(meshName: string, instanceType: string, spotId: RoutingId, objectGeneration: bigint, signal?: AbortSignal): Promise<void>;
+    materializeInstance(meshName: string, instanceType: string, spotId: RoutingId, objectGeneration: bigint, signal?: AbortSignal, completion?: ZLinkSpotPreparationCompletion): Promise<void>;
     private materializeInstanceCore;
     isInstanceMaterialized(meshName: string, instanceType: string, spotId: RoutingId): boolean;
     private resolveApplicationActivation;
@@ -161,6 +164,10 @@ export declare class DefaultZLinkSpotManager {
     beginInstanceSpotIdleEviction(meshName: string, spotId: RoutingId): boolean;
     completeInstanceTerminal(meshName: string, spotId: RoutingId, objectGeneration: bigint): Promise<boolean>;
     beginInstanceTerminal(meshName: string, spotId: RoutingId, objectGeneration: bigint): void;
+    publishInstance(target: {
+        readonly targetSpotId: string;
+        readonly objectGeneration: bigint;
+    }, meshName: string): void;
     private deferInstanceAuthorityRelease;
     private removeDeferredInstanceAuthorityRelease;
     private removePendingInstanceTerminalGeneration;
@@ -188,8 +195,8 @@ export declare class DefaultZLinkSpotManager {
     executeOnSpot<TSpot extends ZLinkSpot, TResult>(spotType: Type<TSpot>, spotId: RoutingId, operation: (spot: TSpot) => Promise<TResult> | TResult, signal?: AbortSignal): Promise<TResult>;
     hasActiveSpot(spotId: RoutingId): boolean;
     beginUserSpotPublication(meshName: string, spotId: RoutingId): void;
-    publishUserSpot(meshName: string, spotId: RoutingId): void;
-    abortUserSpotPublication(meshName: string, spotId: RoutingId): void;
+    publishUserSpot(meshName: string, spotId: RoutingId): Promise<void>;
+    abortUserSpotPublication(meshName: string, spotId: RoutingId): Promise<void>;
     resolveLocalSpotRoute(spotId: RoutingId): ZLinkSpotRouteTarget | undefined;
     admitActorJoin(spotId: RoutingId, actor: ZLinkActor, request: Message, commit: (spot: ZLinkSpot) => Promise<void> | void, signal?: AbortSignal, leaveSource?: () => Promise<void>, contentType?: string): Promise<ZLinkSpotActorJoinResult>;
     leaveActor(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
@@ -197,11 +204,12 @@ export declare class DefaultZLinkSpotManager {
     notifyActorLeftAfterTransfer(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
     prepareActorLeaveForTransfer(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
     commitActorLeaveAfterTransfer(spotId: RoutingId, actorId: string): Promise<void>;
-    restoreActorAfterFailedTransfer(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
     beginActorTransfer(spotId: RoutingId, actorId: string): Promise<void>;
     cancelActorTransfer(spotId: RoutingId, actorId: string): Promise<void>;
     notifyJoinedSpotActorDisconnected(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<boolean>;
     dispatchRoutedActorPacket(origin: ApplicationJobOrigin, spotId: RoutingId, actorId: string, parts: readonly Message[], returnResponse?: boolean, remoteBoundSessionTarget?: ZLinkRemoteBoundSessionTarget, fallbackActorRef?: ActorRef): Promise<unknown>;
+    /** Resolves the current Actor FIFO owner for both Entry and User membership. */
+    admitSourceActorPacketPrefix(actorId: string, records: readonly ZLinkActorHandoffPrefixRecord[]): ZLinkActorHandoffPrefixAdmission;
     dispatchRoutedSpotSend(spotId: RoutingId, packetName: string | undefined, message: unknown, context: {
         readonly channelName: string;
         readonly contentType?: string;
@@ -215,19 +223,21 @@ export declare class DefaultZLinkSpotManager {
         readonly workOptions?: import('../execution/serial-execution-queue').ZLinkSerialWorkOptions;
         readonly admissionTimeoutMs?: number;
         readonly signal?: AbortSignal;
+        readonly onAdmitted?: () => void;
     }): Promise<TReply>;
-    dispatchMeshSpot(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    dispatchMeshSpot(meshName: string, owner: ReadyRecord, record: ReceiveRecord, admit?: ZLinkMeshDispatchAdmission): Promise<void>;
     private ensureInstanceApplicationActivation;
-    dispatchMeshInstance(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    dispatchMeshInstance(meshName: string, owner: ReadyRecord, record: ReceiveRecord, admit?: ZLinkMeshDispatchAdmission): Promise<void>;
     private reportInstanceDispatchFailure;
     private traceInstanceMessage;
-    dispatchMeshActor(origin: ApplicationJobOrigin, meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    dispatchMeshActor(origin: ApplicationJobOrigin, meshName: string, owner: ReadyRecord, record: ReceiveRecord, admit?: ZLinkMeshDispatchAdmission): Promise<void>;
     dispatchMeshActorJoin(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
     private dispatchMeshActorJoinCore;
     dispatchMeshSpotControl(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
     private dispatchMeshSpotControlCore;
     completeFormalSourceLeaveTerminal(actorId: string, transferId: string, succeeded: boolean): Promise<boolean>;
     finalizeActorJoinRelocation(meshName: string, relocationId: string, actor: ZLinkActor, actorRef: ActorRef, submitSourceLeave: (sourceNodeRid: RoutingId) => Promise<void>, signal?: AbortSignal): Promise<boolean>;
+    beginActorJoinRelocation(relocationId: string): () => void;
     restoreCanonicalActorJoinRecovery(recovery: CanonicalActorJoinRecovery, signal?: AbortSignal): Promise<void>;
     private encodeMeshActorReply;
     private createActivation;