@zlink-systems/framework 0.26.0 → 0.27.0

package/dist/runtime/locations/lease-tracker.js

@@ -40,6 +40,9 @@ class ZLinkOwnerLeaseTracker {
             snapshot.result.storeNow.getTime() -
             (this.monotonicNowMs() - snapshot.fetchedAtMs));
     }
+    async isOwnerTokenLive(owner, signal) {
+        return (await this.remainingOwnerTokenLeaseMs(owner, signal)) > 0;
+    }
     async getLiveOwnerSetVersion(signal) {
         const owners = await this.lane.run(() => [...this.snapshots.keys()]);
         const refreshed = await Promise.all(owners.map((ownerId) => this.getSnapshot(ownerId, signal)));
@@ -128,27 +131,20 @@ class ZLinkOwnerLeaseTracker {
 }
 exports.ZLinkOwnerLeaseTracker = ZLinkOwnerLeaseTracker;
 class ZLinkLiveRowFilter {
-    leaseTracker;
-    constructor(leaseTracker) {
-        this.leaseTracker = leaseTracker;
-    }
-    async filter(rows, ownerIdOf, signal, include) {
+    async filter(rows, isLive, signal, include) {
         const live = [];
         for (const row of rows) {
-            if ((include === undefined || include(row)) && (await this.isLive(row, ownerIdOf, signal))) {
+            if ((include === undefined || include(row)) && (await isLive(row, signal))) {
                 live.push(row);
             }
         }
         return live;
     }
-    async resolve(row, ownerIdOf, signal, include) {
+    async resolve(row, isLive, signal, include) {
         if (row === undefined || (include !== undefined && !include(row))) {
             return undefined;
         }
-        return (await this.isLive(row, ownerIdOf, signal)) ? row : undefined;
-    }
-    async isLive(row, ownerIdOf, signal) {
-        return await this.leaseTracker.isOwnerLive(ownerIdOf(row), signal);
+        return (await isLive(row, signal)) ? row : undefined;
     }
 }
 exports.ZLinkLiveRowFilter = ZLinkLiveRowFilter;

package/dist/runtime/locations/lifecycle.d.ts

@@ -1,20 +1,17 @@
 import type { ActorRef, RoutingId } from '../../contracts/Common';
-import type { ZLinkActorLocation, ZLinkLocationWriteStatus } from './internal-location-contracts';
-import type { ZLinkActorLocationStore, ZLinkSpotLocationStore } from './internal-store-contracts';
 import { ZLinkSpotKind } from '../../contracts/Spots';
 import { type ZLinkActorClaimActivation, type ZLinkActorClaimResult } from './actor-location-claims';
-export { ZLinkActorClaimStatus, type ZLinkActorClaimActivation, type ZLinkActorClaimResult } from './actor-location-claims';
-import type { ZLinkInstanceClosingAuthority, ZLinkTrackedInstanceAuthority } from './spot-location-claims';
-import type { ZLinkAuthorityStore } from './internal-store-contracts';
+import type { ZLinkActorLocation, ZLinkLocationWriteStatus } from './internal-location-contracts';
+import type { ZLinkActorLocationStore, ZLinkAuthorityStore, ZLinkSpotLocationStore } from './internal-store-contracts';
 import type { IZLinkLocationLifecycleRuntime } from './lifecycle-runtime';
+import { type ZLinkInstanceClosingAuthority, type ZLinkTrackedInstanceAuthority } from './spot-location-claims';
+export { ZLinkActorClaimStatus, type ZLinkActorClaimActivation, type ZLinkActorClaimResult } from './actor-location-claims';
 export type { IZLinkLocationLifecycleRuntime, ZLinkOwnershipLostEvent } from './lifecycle-runtime';
 export declare class ZLinkLocationLifecycle {
     private readonly runtime;
     private readonly actorClaims;
-    private readonly actorCleanupTasks;
     private readonly spotClaims;
     private readonly actorSessionRoutes;
-    private disposed;
     private readonly ownershipLostHandler;
     constructor(runtime: IZLinkLocationLifecycleRuntime, actorStore: ZLinkActorLocationStore, entryMeshName?: string, authorityStore?: ZLinkAuthorityStore, spotStore?: ZLinkSpotLocationStore, invalidateSpotRoute?: (spotId: RoutingId) => void);
     dispose(): void;
@@ -25,10 +22,8 @@ export declare class ZLinkLocationLifecycle {
     notifyActorJoinedSpot(actorType: string, actorId: string, spotMeshName: string, spotId: RoutingId, spotGeneration: bigint, membershipEpoch: bigint, ownerNodeGeneration: bigint): Promise<void>;
     notifyActorLeftSpot(actorType: string, actorId: string, entrySpotId: RoutingId, entrySpotGeneration: bigint, membershipEpoch: bigint, ownerNodeGeneration: bigint): Promise<void>;
     releaseActor(actorType: string, actorId: string, actorRef?: ActorRef): Promise<void>;
-    releaseActorEventually(actorType: string, actorId: string): Promise<void>;
     ownsActor(actorType: string, actorId: string): boolean;
     actorLocationSnapshot(actorId: string): ZLinkActorLocation | undefined;
-    private retryActorRelease;
     claimSpot(meshName: string, spotId: RoutingId, spotType: string, nodeRid: RoutingId, spotKind: ZLinkSpotKind, spotGeneration: bigint, ownerNodeGeneration: bigint, deactivate?: () => Promise<void>): Promise<ZLinkLocationWriteStatus>;
     releaseSpot(meshName: string, spotId: RoutingId, expectedObjectGeneration?: bigint): Promise<void>;
     beginInstanceSpotClosing(meshName: string, spotId: RoutingId, onCommitted: () => void): Promise<ZLinkInstanceClosingAuthority | undefined>;

package/dist/runtime/locations/lifecycle.js

@@ -2,17 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkLocationLifecycle = exports.ZLinkActorClaimStatus = void 0;
 const actor_location_claims_1 = require("./actor-location-claims");
-var actor_location_claims_2 = require("./actor-location-claims");
-Object.defineProperty(exports, "ZLinkActorClaimStatus", { enumerable: true, get: function () { return actor_location_claims_2.ZLinkActorClaimStatus; } });
 const actor_session_route_claims_1 = require("./actor-session-route-claims");
 const spot_location_claims_1 = require("./spot-location-claims");
+var actor_location_claims_2 = require("./actor-location-claims");
+Object.defineProperty(exports, "ZLinkActorClaimStatus", { enumerable: true, get: function () { return actor_location_claims_2.ZLinkActorClaimStatus; } });
 class ZLinkLocationLifecycle {
     runtime;
     actorClaims;
-    actorCleanupTasks = new Map();
     spotClaims;
     actorSessionRoutes;
-    disposed = false;
     ownershipLostHandler = (event) => this.onOwnershipLost(event);
     constructor(runtime, actorStore, entryMeshName = '', authorityStore, spotStore, invalidateSpotRoute) {
         this.runtime = runtime;
@@ -22,7 +20,6 @@ class ZLinkLocationLifecycle {
         this.runtime.addOwnershipLostHandler(this.ownershipLostHandler);
     }
     dispose() {
-        this.disposed = true;
         this.runtime.removeOwnershipLostHandler(this.ownershipLostHandler);
     }
     async executeActorClaimThenActivate(actorType, actorId, nodeRid, deactivate, activate) {
@@ -46,35 +43,12 @@ class ZLinkLocationLifecycle {
     async releaseActor(actorType, actorId, actorRef) {
         await this.actorClaims.release(actorType, actorId, actorRef);
     }
-    releaseActorEventually(actorType, actorId) {
-        const existing = this.actorCleanupTasks.get(actorId);
-        if (existing !== undefined) {
-            return existing;
-        }
-        const cleanup = this.retryActorRelease(actorType, actorId).finally(() => this.actorCleanupTasks.delete(actorId));
-        this.actorCleanupTasks.set(actorId, cleanup);
-        return cleanup;
-    }
     ownsActor(actorType, actorId) {
         return this.actorClaims.owns(actorType, actorId);
     }
     actorLocationSnapshot(actorId) {
         return this.actorClaims.snapshot(actorId);
     }
-    async retryActorRelease(actorType, actorId) {
-        let retryDelayMs = 50;
-        while (!this.disposed) {
-            try {
-                await this.actorClaims.release(actorType, actorId);
-                return;
-            }
-            catch {
-                await waitForRetry(retryDelayMs);
-                retryDelayMs = Math.min(retryDelayMs * 2, 1_000);
-            }
-        }
-        return;
-    }
     async claimSpot(meshName, spotId, spotType, nodeRid, spotKind, spotGeneration, ownerNodeGeneration, deactivate) {
         return await this.spotClaims.claim(meshName, spotId, spotType, nodeRid, spotKind, spotGeneration, ownerNodeGeneration, deactivate);
     }
@@ -114,6 +88,3 @@ function inferSpotStore(actorStore) {
     }
     return undefined;
 }
-function waitForRetry(delayMs) {
-    return new Promise((resolve) => setTimeout(resolve, delayMs));
-}

package/dist/runtime/locations/location-store-failure.d.ts

@@ -0,0 +1,2 @@
+/** Location Store §6: caller validation is terminal; provider failures may lose a result. */
+export declare function isIndeterminateLocationStoreFailure(error: unknown, signal?: AbortSignal): boolean;

package/dist/runtime/locations/location-store-failure.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isIndeterminateLocationStoreFailure = isIndeterminateLocationStoreFailure;
+/** Location Store §6: caller validation is terminal; provider failures may lose a result. */
+function isIndeterminateLocationStoreFailure(error, signal) {
+    return !(error instanceof TypeError || error instanceof RangeError) && signal?.aborted !== true;
+}

package/dist/runtime/locations/location-store-pages.d.ts

@@ -0,0 +1,3 @@
+import type { ZLinkMeshNodeDescriptor } from '../../contracts/Locations/Models';
+import type { ZLinkMeshNodeLocationStore } from './internal-store-contracts';
+export declare function listAllMeshNodeDescriptors(store: ZLinkMeshNodeLocationStore, meshName: string, signal?: AbortSignal, pageSize?: number): Promise<readonly ZLinkMeshNodeDescriptor[]>;

package/dist/runtime/locations/location-store-pages.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listAllMeshNodeDescriptors = listAllMeshNodeDescriptors;
+async function listAllMeshNodeDescriptors(store, meshName, signal, pageSize) {
+    const rows = [];
+    let continuationToken;
+    do {
+        const result = await store.listMeshNodes(meshName, { pageSize, continuationToken }, signal);
+        rows.push(...result.items);
+        continuationToken = result.continuationToken;
+    } while (continuationToken !== undefined);
+    return rows;
+}

package/dist/runtime/locations/location-store-repository.d.ts

@@ -1,8 +1,6 @@
-import type { ZLinkLocationStore, ZLinkLocationPage, ZLinkClientServerServerDescriptor, ZLinkClientServerServerDescriptorKey, ZLinkFanoutPublisherDescriptor, ZLinkFanoutPublisherDescriptorKey, ZLinkMeshNodeDescriptor, ZLinkMeshNodeDescriptorKey, ZLinkPageRequest } from '../../contracts';
-import type { ZLinkAggregateAbortResult, ZLinkAggregateCommitResult, ZLinkAggregateFence, ZLinkAggregatePrepareRequest, ZLinkAggregatePrepareResult, ZLinkAuthorityCompareExchangeResult, ZLinkAuthorityKey, ZLinkAuthorityMutation, ZLinkAuthorityReadResult, ZLinkAuthorityScanCursor, ZLinkAuthorityScanResult, ZLinkAuthorityStoreVersion, ZLinkCreationOperationIdentity, ZLinkCreationTerminalReadResult, ZLinkLocationOwnerToken, ZLinkLocationWriteResult, ZLinkLocationWriteStatus, ZLinkObjectCommitRequest, ZLinkObjectCommitResult, ZLinkObjectAbortRequest, ZLinkObjectAbortResult, ZLinkObjectCreationCompleteRequest, ZLinkObjectCreationCompleteResult, ZLinkObjectReserveRequest, ZLinkObjectReserveResult, ZLinkOwnerLeaseClaimResult, ZLinkOwnerLeaseReadResult, ZLinkOwnerLeaseReleaseResult, ZLinkOwnerLeaseRenewResult } from './internal-location-contracts';
-import { ZLinkLocationWriteIntent } from './internal-location-contracts';
-import type { ZLinkActorLocation, ZLinkActorLocationFilter, ZLinkActorLocationKey, ZLinkRouteLocation, ZLinkRouteLocationFilter, ZLinkRouteLocationKey, ZLinkSpotLocation, ZLinkSpotLocationFilter, ZLinkSpotLocationKey } from './internal-location-contracts';
+import { type ZLinkClientServerServerDescriptor, type ZLinkClientServerServerDescriptorKey, type ZLinkFanoutPublisherDescriptor, type ZLinkFanoutPublisherDescriptorKey, type ZLinkLocationPage, type ZLinkLocationStore, type ZLinkMeshNodeDescriptor, type ZLinkMeshNodeDescriptorKey, type ZLinkPageRequest } from '../../contracts';
 import { ZLinkInMemoryLocationStore } from './in-memory-location-store';
+import { type ZLinkActorLocation, type ZLinkActorLocationFilter, type ZLinkActorLocationKey, type ZLinkAggregateAbortResult, type ZLinkAggregateCommitResult, type ZLinkAggregateFence, type ZLinkAggregatePrepareRequest, type ZLinkAggregatePrepareResult, type ZLinkAuthorityCompareExchangeResult, type ZLinkAuthorityKey, type ZLinkAuthorityMutation, type ZLinkAuthorityReadResult, type ZLinkAuthorityScanCursor, type ZLinkAuthorityScanResult, type ZLinkAuthorityStoreVersion, type ZLinkCreationOperationIdentity, type ZLinkCreationTerminalReadResult, type ZLinkLocationOwnerToken, type ZLinkLocationWriteResult, type ZLinkLocationWriteStatus, type ZLinkObjectAbortRequest, type ZLinkObjectAbortResult, type ZLinkObjectCommitRequest, type ZLinkObjectCommitResult, type ZLinkObjectCreationCompleteRequest, type ZLinkObjectCreationCompleteResult, type ZLinkObjectReserveRequest, type ZLinkObjectReserveResult, type ZLinkOwnerLeaseClaimResult, type ZLinkOwnerLeaseReadResult, type ZLinkOwnerLeaseReleaseResult, type ZLinkOwnerLeaseRenewResult, type ZLinkRouteLocation, type ZLinkRouteLocationFilter, type ZLinkRouteLocationKey, type ZLinkSpotLocation, type ZLinkSpotLocationFilter, type ZLinkSpotLocationKey, ZLinkLocationWriteIntent } from './internal-location-contracts';
 /**
  * Maps framework domain records to the minimal provider SPI.
  *
@@ -22,9 +20,9 @@ export declare class ZLinkLocationStoreRepository extends ZLinkInMemoryLocationS
     commitAggregate(fence: ZLinkAggregateFence, signal?: AbortSignal): Promise<ZLinkAggregateCommitResult>;
     private commitAggregateCore;
     abortAggregate(fence: ZLinkAggregateFence, signal?: AbortSignal): Promise<ZLinkAggregateAbortResult>;
-    reserve(request: ZLinkObjectReserveRequest, signal?: AbortSignal): Promise<ZLinkObjectReserveResult>;
-    commit(request: ZLinkObjectCommitRequest, signal?: AbortSignal): Promise<ZLinkObjectCommitResult>;
-    abort(request: ZLinkObjectAbortRequest, signal?: AbortSignal): Promise<ZLinkObjectAbortResult>;
+    reserve(request: ZLinkObjectReserveRequest, signal?: AbortSignal, deadlineUnixMs?: bigint): Promise<ZLinkObjectReserveResult>;
+    commit(request: ZLinkObjectCommitRequest, signal?: AbortSignal, deadlineUnixMs?: bigint): Promise<ZLinkObjectCommitResult>;
+    abort(request: ZLinkObjectAbortRequest, signal?: AbortSignal, deadlineUnixMs?: bigint): Promise<ZLinkObjectAbortResult>;
     completeCreation(request: ZLinkObjectCreationCompleteRequest, signal?: AbortSignal): Promise<ZLinkObjectCreationCompleteResult>;
     readCreationTerminal(operation: ZLinkCreationOperationIdentity, signal?: AbortSignal): Promise<ZLinkCreationTerminalReadResult>;
     claimOwnerLease(ownerId: string, leaseTtlMs: number, signal?: AbortSignal): Promise<ZLinkOwnerLeaseClaimResult>;