@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/spots/spot-timer.js

@@ -17,7 +17,7 @@ const systemTimerClock = {
     now: () => performance.now(),
     utcNow: () => Date.now(),
     setTimeout: (callback, delayMs) => setTimeout(callback, delayMs),
-    clearTimeout: handle => clearTimeout(handle)
+    clearTimeout: (handle) => clearTimeout(handle)
 };
 class ZLinkSpotTimerRegistry {
     flowCreationEnabled;
@@ -55,17 +55,19 @@ class ZLinkSpotTimerRegistry {
         if (prepared.previous !== undefined)
             await prepared.previous.timer.cancel(signal);
         const executionSerial = this.executeTimer === undefined
-            ? this.executionSerialForTimer?.(name, serial) ?? serial
+            ? (this.executionSerialForTimer?.(name, serial) ?? serial)
             : undefined;
         if (this.executionBarrier !== undefined)
             executionSerial?.setExecutionBarrier(this.executionBarrier);
         let callbackStarted = false;
         const timer = startOutsideStateLane(() => new ZLinkManagedTimer(name, periodMs, normalizeTimerOptions(options), async (tick) => {
             callbackStarted = false;
-            const timerFlow = (0, flow_context_1.createInboundFlow)(undefined, 'Timer', this.flowCreationEnabled());
+            const timerFlow = (0, flow_context_1.createInboundFlow)(undefined, 'Timer', this.flowCreationEnabled(), undefined);
             const operation = () => {
                 const current = this.timers.get(name);
-                if (current === undefined || current.generation !== prepared.generation || current.timer !== timer) {
+                if (current === undefined ||
+                    current.generation !== prepared.generation ||
+                    current.timer !== timer) {
                     return undefined;
                 }
                 if (!this.executionAllowed())
@@ -90,9 +92,7 @@ class ZLinkSpotTimerRegistry {
             const active = [...this.timers.entries()].map(([name, entry]) => ({
                 name,
                 timer: entry.timer,
-                wait: this.executeTimer === undefined
-                    ? true
-                    : this.isTimerExecuting?.(name) !== true
+                wait: this.executeTimer === undefined ? true : this.isTimerExecuting?.(name) !== true
             }));
             this.timers.clear();
             return active;
@@ -112,7 +112,7 @@ class ZLinkSpotTimerRegistry {
         return states;
     }
     restoreRelocation(states) {
-        const byName = new Map(states.map(state => [state.name, state]));
+        const byName = new Map(states.map((state) => [state.name, state]));
         if (byName.size !== states.length || byName.size !== this.timers.size) {
             throw new Error('Timer relocation inventory does not match registered handlers.');
         }
@@ -234,7 +234,7 @@ class ZLinkManagedTimer {
         this.finalization = finalization;
         try {
             const preparation = this.lane.run(() => this.cancelCore());
-            void preparation.then(start => {
+            void preparation.then((start) => {
                 void this.completeFinalization(start, finalization).then(undefined, reject);
             }, reject);
         }
@@ -266,19 +266,19 @@ class ZLinkManagedTimer {
     restoreRelocation(state, handlerType = '') {
         if (this.disposed)
             throw new Error(`Timer '${this.name}' is disposed.`);
-        if (state.name !== this.name
-            || state.handlerType !== handlerType
-            || state.periodMs !== this.periodMs
-            || state.overrunPolicy !== this.options.overrunPolicy
-            || state.maxCatchUpTicks !== this.options.maxCatchUpTicks
-            || state.stopOnUnhandledException !== this.options.stopOnUnhandledException
-            || !Number.isSafeInteger(state.startedAtUnixMs)
-            || state.deliveryIndex < 0n
-            || state.lastScheduledIndex < 0n
-            || !Number.isSafeInteger(state.nextDueAtUnixMs)
-            || state.nextDueAtUnixMs !== state.startedAtUnixMs
-                + Number(state.lastScheduledIndex + 1n) * state.periodMs
-            || state.pendingTicks.length !== 0) {
+        if (state.name !== this.name ||
+            state.handlerType !== handlerType ||
+            state.periodMs !== this.periodMs ||
+            state.overrunPolicy !== this.options.overrunPolicy ||
+            state.maxCatchUpTicks !== this.options.maxCatchUpTicks ||
+            state.stopOnUnhandledException !== this.options.stopOnUnhandledException ||
+            !Number.isSafeInteger(state.startedAtUnixMs) ||
+            state.deliveryIndex < 0n ||
+            state.lastScheduledIndex < 0n ||
+            !Number.isSafeInteger(state.nextDueAtUnixMs) ||
+            state.nextDueAtUnixMs !==
+                state.startedAtUnixMs + Number(state.lastScheduledIndex + 1n) * state.periodMs ||
+            state.pendingTicks.length !== 0) {
             throw new Error(`Timer '${this.name}' relocation contract does not match its registration.`);
         }
         if (this.timeout !== undefined)
@@ -301,7 +301,7 @@ class ZLinkManagedTimer {
         this.timeout = this.clock.setTimeout(() => {
             this.timeout = undefined;
             const execution = startOutsideStateLane(() => this.fire());
-            this.running = execution.then(() => undefined, cause => this.lane.run(() => {
+            this.running = execution.then(() => undefined, (cause) => this.lane.run(() => {
                 this.dispatchFailure ??= { cause };
             }));
         }, delayMs);
@@ -328,9 +328,7 @@ class ZLinkManagedTimer {
         this.timeout = undefined;
         return {
             timeout,
-            running: this.shouldWaitForRunningOnCancel()
-                ? this.running
-                : Promise.resolve()
+            running: this.shouldWaitForRunningOnCancel() ? this.running : Promise.resolve()
         };
     }
     async completeFinalization(start, finalization) {
@@ -454,8 +452,7 @@ function createTimerDiagnostics(sourceName, spotId, isEntrySpot, timerName, hand
                 }
             });
         }
-        catch {
-        }
+        catch { }
     };
 }
 async function addEntrySpotTimerRegistrations(timers, entrySpotType, entrySpot, serial, registrations, options) {
@@ -467,8 +464,7 @@ async function addEntrySpotTimerRegistrations(timers, entrySpotType, entrySpot,
 }
 async function addSpotTimerRegistrations(timers, spotType, spotId, spot, serial, registrations, options) {
     for (const handler of registrations.timerHandlers ?? []) {
-        if (handler.spotType === spotType
-            || spotType.prototype instanceof handler.spotType) {
+        if (handler.spotType === spotType || spotType.prototype instanceof handler.spotType) {
             await timers.add(handler.name, handler.periodMs, handler.options, handler.handlerType, serial, spot, options.providerResolver, options.signal, createTimerDiagnostics(String(spotId), spotId, false, handler.name, handler.handlerType, options.runtimeEventPublisher));
         }
     }

package/dist/runtime/streams/actor-session-binding-registry.d.ts

@@ -4,13 +4,18 @@ export interface ZLinkActorSessionBindingActor {
 }
 export interface ZLinkActorSessionBindingContext<TActor extends ZLinkActorSessionBindingActor> {
     readonly routingId?: unknown;
-    bindLocal(actor: TActor, bindingToken: string): void;
+    readonly actorSlotControls?: {
+        enqueueBound(actorSlot: number, actorId: string): Promise<void>;
+        enqueueUnbound(actorSlot: number): Promise<void>;
+    };
+    bindLocal(actor: TActor, bindingToken: string, actorSlot?: number): void;
     unbindLocal(actorId: string, bindingToken: string): void;
 }
 export interface ZLinkActorSessionRoute<TContext extends ZLinkActorSessionBindingContext<TActor>, TActor extends ZLinkActorSessionBindingActor> {
     readonly context: TContext;
     readonly actor: TActor;
     readonly bindingToken: string;
+    readonly actorSlot?: number;
     readonly sessionIdentity?: string;
     readonly activeFrames: ZLinkActorSessionActiveFrames;
     sealId?: string;
@@ -68,22 +73,30 @@ export interface ZLinkActorSessionAuthorityFence {
     readonly authorityStoreVersion?: string;
     readonly actorType?: string;
 }
+export declare enum ZLinkActorSessionBindingTermination {
+    BindingEnd = 0,
+    PhysicalDisconnect = 1
+}
 export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActorSessionBindingContext<TActor>, TActor extends ZLinkActorSessionBindingActor> {
     private readonly terminalRelocationCapacity;
     private readonly outboundCapacity;
     private readonly sealWaitTimeoutMs;
+    private readonly errorSink?;
     private readonly lane;
     private readonly routes;
+    private readonly nextActorSlots;
     private readonly sealWaiters;
     private readonly activeFrameWaiters;
     private readonly relocations;
     private readonly terminalRelocations;
-    constructor(terminalRelocationCapacity?: number, outboundCapacity?: number, sealWaitTimeoutMs?: number);
-    bind(context: TContext, actor: TActor, bindingToken: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string): Promise<void>;
-    private bindCore;
-    replace(previous: ZLinkActorSessionRoute<TContext, TActor>, context: TContext, actor: TActor, bindingToken: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string): Promise<void>;
-    private replaceCore;
-    replaceAndReleaseSeal(previous: ZLinkActorSessionRoute<TContext, TActor>, context: TContext, actor: TActor, bindingToken: string, sealId: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string): Promise<void>;
+    constructor(terminalRelocationCapacity?: number, outboundCapacity?: number, sealWaitTimeoutMs?: number, errorSink?: (() => {
+        reportRuntimeTaskException(taskName: string, error: unknown): void;
+    } | undefined) | undefined);
+    bind(context: TContext, actor: TActor, bindingToken: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string, commitActor?: () => void): Promise<void>;
+    private commitCore;
+    private issueActorSlot;
+    replace(previous: ZLinkActorSessionRoute<TContext, TActor>, context: TContext, actor: TActor, bindingToken: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string, commitActor?: () => void): Promise<void>;
+    replaceAndReleaseSeal(previous: ZLinkActorSessionRoute<TContext, TActor>, context: TContext, actor: TActor, bindingToken: string, sealId: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string, commitActor?: () => void): Promise<void>;
     private replaceAndReleaseSealCore;
     find(actorId: string): Promise<TActor | undefined>;
     private findCore;
@@ -93,7 +106,7 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
         readonly context: TContext;
     } | undefined>;
     private capturePendingReplyClaimCore;
-    unbind(actorId: string, context: TContext, bindingToken: string): Promise<void>;
+    unbind(actorId: string, context: TContext, bindingToken: string, termination?: ZLinkActorSessionBindingTermination): Promise<void>;
     private unbindCore;
     unbindActor(actorId: string): Promise<void>;
     private unbindActorCore;