@zlink-systems/framework 0.26.0 → 0.28.0

package/dist/runtime/locations/in-memory-provider-location-store.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZLinkInMemoryProviderLocationStore = void 0;
+exports.ZLinkInMemoryProviderLocationStore = exports.PROVIDER_STORAGE_NAMESPACE_PREFIX = void 0;
 exports.storeKey = storeKey;
 exports.storeVersion = storeVersion;
+const Stores_1 = require("../../contracts/Locations/Stores");
+exports.PROVIDER_STORAGE_NAMESPACE_PREFIX = 'zlink:v11:';
 /**
  * Framework-owned primitive Store used by the explicit in-memory option.
  * Domain records are encoded by ZLinkLocationStoreRepository.
@@ -42,6 +44,12 @@ class ZLinkInMemoryProviderLocationStore {
                 if (current !== undefined)
                     return { kind: 'conflict', storeNow };
             }
+            else if (condition.kind === 'value') {
+                if (current === undefined ||
+                    !Buffer.from(current.bytes).equals(Buffer.from(condition.expected))) {
+                    return { kind: 'conflict', storeNow };
+                }
+            }
             else if (current?.version.value !== condition.expected.value) {
                 return { kind: 'conflict', storeNow };
             }
@@ -52,7 +60,7 @@ class ZLinkInMemoryProviderLocationStore {
                 this.values.delete(mutation.key.value);
                 continue;
             }
-            const retentionMs = requireValue(mutation.bytes, mutation.retentionMs);
+            const retentionMs = mutation.retentionMs === undefined ? undefined : Math.ceil(mutation.retentionMs);
             const version = storeVersion((++this.nextVersion).toString());
             const expiresAt = retentionMs === undefined ? undefined : new Date(storeNow.getTime() + retentionMs);
             this.values.set(mutation.key.value, {
@@ -84,13 +92,26 @@ class ZLinkInMemoryProviderLocationStore {
             this.scans.set(snapshotId, snapshot);
         }
         else {
-            [snapshotId, offset] = parseCursor(request.cursor);
+            const cursor = parseCursor(request.cursor);
+            snapshotId = cursor?.[0] ?? '';
+            offset = cursor?.[1] ?? 0;
             snapshot = this.scans.get(snapshotId);
-            if (snapshot === undefined)
+            if (snapshot === undefined || offset > snapshot.items.length)
                 return { kind: 'expired' };
         }
-        const selected = snapshot.items.slice(offset, offset + request.limit);
-        const nextOffset = offset + selected.length;
+        let nextOffset = offset;
+        let encodedBytes = 0;
+        while (nextOffset < snapshot.items.length && nextOffset - offset < request.limit) {
+            const item = snapshot.items[nextOffset];
+            const itemBytes = Buffer.byteLength(item.key.value, 'utf8') +
+                Buffer.byteLength(item.value.version.value, 'utf8') +
+                item.value.bytes.byteLength;
+            if (encodedBytes + itemBytes > Stores_1.ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES)
+                break;
+            encodedBytes += itemBytes;
+            nextOffset += 1;
+        }
+        const selected = snapshot.items.slice(offset, nextOffset);
         const nextCursor = nextOffset < snapshot.items.length ? scanCursor(`${snapshotId}:${nextOffset}`) : undefined;
         if (nextCursor === undefined)
             this.scans.delete(snapshotId);
@@ -133,9 +154,10 @@ function scanCursor(value) {
 function parseCursor(cursor) {
     const separator = cursor.value.indexOf(':');
     const snapshotId = cursor.value.slice(0, separator);
-    const offset = Number(cursor.value.slice(separator + 1));
-    if (separator < 1 || !Number.isSafeInteger(offset) || offset < 0) {
-        throw new RangeError('Location Store scan cursor is invalid.');
+    const encodedOffset = cursor.value.slice(separator + 1);
+    const offset = Number(encodedOffset);
+    if (separator < 1 || !/^(0|[1-9][0-9]*)$/.test(encodedOffset) || !Number.isSafeInteger(offset)) {
+        return undefined;
     }
     return [snapshotId, offset];
 }
@@ -145,27 +167,55 @@ function requireWriteRequest(request) {
     const keys = [...new Set([...conditionKeys, ...mutationKeys])];
     if (new Set(conditionKeys).size !== conditionKeys.length ||
         new Set(mutationKeys).size !== mutationKeys.length ||
-        keys.length > 2_048) {
-        throw new RangeError('Location Store write keys must be unique and bounded to 2,048.');
+        keys.length > Stores_1.ZLINK_PROVIDER_MAX_WRITE_KEYS) {
+        throw new RangeError(`Location Store write keys must be unique and bounded to ${Stores_1.ZLINK_PROVIDER_MAX_WRITE_KEYS.toLocaleString('en-US')}.`);
     }
     for (const key of keys)
         requireKey(key);
-    const encodedSize = request.mutations.reduce((sum, mutation) => sum + (mutation.kind === 'put' ? mutation.bytes.byteLength : 0), 0);
-    if (encodedSize > 4 * 1024 * 1024) {
-        throw new RangeError('Location Store write exceeds 4 MiB.');
+    const encodedSize = request.conditions.reduce((sum, condition) => {
+        const keyBytes = Buffer.byteLength(condition.key.value, 'utf8');
+        if (condition.kind === 'missing')
+            return sum + keyBytes;
+        if (condition.kind === 'value') {
+            requireValue(condition.expected, undefined);
+            return sum + keyBytes + condition.expected.byteLength;
+        }
+        const versionBytes = Buffer.byteLength(condition.expected.value, 'utf8');
+        if (versionBytes < 1 || versionBytes > Stores_1.ZLINK_PROVIDER_MAX_VERSION_BYTES) {
+            throw new RangeError(`Location Store version must contain 1..${Stores_1.ZLINK_PROVIDER_MAX_VERSION_BYTES.toLocaleString('en-US')} UTF-8 bytes.`);
+        }
+        return sum + keyBytes + versionBytes;
+    }, 0) +
+        request.mutations.reduce((sum, mutation) => {
+            const keyBytes = Buffer.byteLength(mutation.key.value, 'utf8');
+            if (mutation.kind !== 'put')
+                return sum + keyBytes;
+            requireValue(mutation.bytes, mutation.retentionMs);
+            return sum + keyBytes + mutation.bytes.byteLength;
+        }, 0);
+    if (encodedSize > Stores_1.ZLINK_PROVIDER_MAX_WRITE_BYTES) {
+        throw new RangeError(`Location Store write exceeds ${Stores_1.ZLINK_PROVIDER_MAX_WRITE_BYTES / (1024 * 1024)} MiB.`);
     }
 }
 function requireScanRequest(request) {
-    if (Buffer.byteLength(request.prefix, 'utf8') > 1_024) {
-        throw new RangeError('Location Store scan prefix exceeds 1,024 UTF-8 bytes.');
+    if (request.cursor !== undefined) {
+        const bytes = Buffer.byteLength(request.cursor.value, 'utf8');
+        if (bytes < 1 || bytes > Stores_1.ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES) {
+            throw new RangeError(`Location Store cursor must contain 1..${Stores_1.ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES.toLocaleString('en-US')} UTF-8 bytes.`);
+        }
+    }
+    if (Buffer.byteLength(request.prefix, 'utf8') > Stores_1.ZLINK_PROVIDER_MAX_KEY_BYTES) {
+        throw new RangeError(`Location Store scan prefix exceeds ${Stores_1.ZLINK_PROVIDER_MAX_KEY_BYTES.toLocaleString('en-US')} UTF-8 bytes.`);
     }
-    if (!Number.isSafeInteger(request.limit) || request.limit < 1 || request.limit > 1_000) {
-        throw new RangeError('Location Store scan limit must be in 1..1000.');
+    if (!Number.isSafeInteger(request.limit) ||
+        request.limit < 1 ||
+        request.limit > Stores_1.ZLINK_PROVIDER_MAX_PAGE_SIZE) {
+        throw new RangeError(`Location Store scan limit must be in 1..${Stores_1.ZLINK_PROVIDER_MAX_PAGE_SIZE}.`);
     }
 }
 function requireValue(bytes, retentionMs) {
-    if (bytes.byteLength > 1024 * 1024) {
-        throw new RangeError('Location Store value exceeds 1 MiB.');
+    if (bytes.byteLength > Stores_1.ZLINK_PROVIDER_MAX_VALUE_BYTES) {
+        throw new RangeError(`Location Store value exceeds ${Stores_1.ZLINK_PROVIDER_MAX_VALUE_BYTES / (1024 * 1024)} MiB.`);
     }
     if (retentionMs !== undefined &&
         (!Number.isFinite(retentionMs) ||
@@ -177,7 +227,7 @@ function requireValue(bytes, retentionMs) {
 }
 function requireKey(value) {
     const bytes = Buffer.byteLength(value, 'utf8');
-    if (bytes < 1 || bytes > 1_024) {
-        throw new RangeError('Location Store key must contain 1..1,024 UTF-8 bytes.');
+    if (bytes < 1 || bytes > Stores_1.ZLINK_PROVIDER_MAX_KEY_BYTES) {
+        throw new RangeError(`Location Store key must contain 1..${Stores_1.ZLINK_PROVIDER_MAX_KEY_BYTES.toLocaleString('en-US')} UTF-8 bytes.`);
     }
 }

package/dist/runtime/locations/key-codec.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkLocationKeyCodec = void 0;
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
 const canonical_codec_1 = require("./canonical-codec");
 const routing_id_1 = require("../routing-id");
 // Framework bookkeeping codec for in-memory row maps and generation guards.
@@ -31,8 +32,8 @@ function encodeSegments(...segments) {
 }
 function requireSpotId(value) {
     const bytes = Buffer.byteLength(value, 'utf8');
-    if (bytes < 1 || bytes > 255) {
-        throw new TypeError('SpotId must contain 1..255 UTF-8 bytes.');
+    if (bytes < 1 || bytes > CoreTypes_1.ZLINK_MAX_SPOT_ID_BYTES) {
+        throw new TypeError(`SpotId must contain 1..${CoreTypes_1.ZLINK_MAX_SPOT_ID_BYTES} UTF-8 bytes.`);
     }
     return value;
 }

package/dist/runtime/locations/lease-tracker.d.ts

@@ -19,6 +19,7 @@ export declare class ZLinkOwnerLeaseTracker {
     isOwnerLive(ownerId: string, signal?: AbortSignal): Promise<boolean>;
     remainingLeaseMs(ownerId: string, signal?: AbortSignal): Promise<number>;
     remainingOwnerTokenLeaseMs(owner: ZLinkLocationOwnerToken, signal?: AbortSignal): Promise<number>;
+    isOwnerTokenLive(owner: ZLinkLocationOwnerToken, signal?: AbortSignal): Promise<boolean>;
     getLiveOwnerSetVersion(signal?: AbortSignal): Promise<number>;
     private getSnapshot;
     private prepareSnapshotRefresh;
@@ -28,9 +29,6 @@ export declare class ZLinkOwnerLeaseTracker {
     private isLive;
 }
 export declare class ZLinkLiveRowFilter {
-    private readonly leaseTracker;
-    constructor(leaseTracker: ZLinkOwnerLeaseTracker);
-    filter<TRow>(rows: readonly TRow[], ownerIdOf: (row: TRow) => string, signal?: AbortSignal, include?: (row: TRow) => boolean): Promise<TRow[]>;
-    resolve<TRow>(row: TRow | undefined, ownerIdOf: (row: TRow) => string, signal?: AbortSignal, include?: (row: TRow) => boolean): Promise<TRow | undefined>;
-    private isLive;
+    filter<TRow>(rows: readonly TRow[], isLive: (row: TRow, signal?: AbortSignal) => Promise<boolean>, signal?: AbortSignal, include?: (row: TRow) => boolean): Promise<TRow[]>;
+    resolve<TRow>(row: TRow | undefined, isLive: (row: TRow, signal?: AbortSignal) => Promise<boolean>, signal?: AbortSignal, include?: (row: TRow) => boolean): Promise<TRow | undefined>;
 }

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>;