@zlink-systems/framework 0.26.0 → 0.28.0

package/dist/runtime/host/user-spot-creation-coordinator.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkUserSpotCreationCoordinator = void 0;
 exports.encodeLocationCreationContent = encodeLocationCreationContent;
 exports.decodeLocationCreationContent = decodeLocationCreationContent;
-const framework_errors_internal_1 = require("../framework-errors-internal");
 const node_crypto_1 = require("node:crypto");
 const contracts_1 = require("../../contracts");
 const service_authority_payload_codec_1 = require("../foundation/service-authority-payload-codec");
+const framework_errors_internal_1 = require("../framework-errors-internal");
 const authority_key_codec_1 = require("../locations/authority-key-codec");
+const DEFAULT_USER_SPOT_CLEANUP_TIMEOUT_MS = 1_000;
+const DEFAULT_USER_SPOT_POLL_INTERVAL_MS = 10;
 /**
  * Makes generic Location Store reservation the only visibility barrier for a
  * User Spot. Only the reservation winner invokes application lifecycle code.
@@ -20,9 +22,10 @@ class ZLinkUserSpotCreationCoordinator {
         this.options = options;
     }
     async getOrCreate(request, materialize, discard) {
-        const deadline = createDeadline(request.timeoutMs, request.signal);
-        const deadlineMs = performance.now() + request.timeoutMs;
         const deadlineUnixMs = Date.now() + request.timeoutMs;
+        const remainingMs = Math.max(0, deadlineUnixMs - Date.now());
+        const deadline = createDeadline(remainingMs, request.signal);
+        const deadlineMs = performance.now() + remainingMs;
         const signal = deadline.signal;
         signal.throwIfAborted();
         const sha256 = (0, node_crypto_1.createHash)('sha256').update(request.requestPayload).digest();
@@ -85,7 +88,7 @@ class ZLinkUserSpotCreationCoordinator {
                             count: 1
                         }
                     }
-                }, signal);
+                }, signal, BigInt(deadlineUnixMs));
             }
             catch (error) {
                 deadline.close();
@@ -323,7 +326,7 @@ class ZLinkUserSpotCreationCoordinator {
                             leaseGeneration: current.ownerLeaseGeneration
                         }
                     }
-                }, signal);
+                }, signal, record.deadlineUnixMs);
                 await discard?.(signal);
                 return {
                     result: { spot, state: local.state, reply: local.reply },
@@ -355,7 +358,7 @@ class ZLinkUserSpotCreationCoordinator {
                         ownerNodeRid: String(current.allocation.descriptor.rid),
                         ownerNodeGeneration: current.allocation.descriptorLifecycleGeneration
                     })
-                }, signal);
+                }, signal, record.deadlineUnixMs);
             }
             catch (error) {
                 throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestFailed, 'User Spot Ready commit Store operation failed.', false, error);
@@ -376,7 +379,7 @@ class ZLinkUserSpotCreationCoordinator {
         }
         catch (error) {
             local?.publication?.abort();
-            const cleanupDeadline = createDeadline(this.options.cleanupTimeoutMs ?? 1_000);
+            const cleanupDeadline = createDeadline(this.options.cleanupTimeoutMs ?? DEFAULT_USER_SPOT_CLEANUP_TIMEOUT_MS);
             const cleanupSignal = cleanupDeadline.signal;
             const cleanup = await Promise.allSettled([
                 waitForAbort(this.options.store.abort({
@@ -474,7 +477,7 @@ class ZLinkUserSpotCreationCoordinator {
             if (current.kind === 'snapshot' && current.allocation.state === 'active') {
                 return spotRef(current, request);
             }
-            await wait(this.options.pollIntervalMs ?? 10, signal);
+            await wait(this.options.pollIntervalMs ?? DEFAULT_USER_SPOT_POLL_INTERVAL_MS, signal);
         }
     }
     async remoteCreate(request, snapshot, targetNodeRid, targetNodeGeneration, deadlineUnixMs, deadlineMs) {

package/dist/runtime/locations/aggregate-inventory-store.js

@@ -2,8 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkAggregateInventoryStore = void 0;
 const node_crypto_1 = require("node:crypto");
+const actor_join_recovery_codec_1 = require("../foundation/actor-join-recovery-codec");
 const in_memory_provider_location_store_1 = require("./in-memory-provider-location-store");
-const PREFIX = 'zlink:v11:aggregate-inventory:';
+const INVENTORY_PAGE_KIND = 'aggregate-inventory-page-v1';
+const INVENTORY_ROOT_KIND = 'aggregate-inventory-root-v1';
+const PREFIX = `${in_memory_provider_location_store_1.PROVIDER_STORAGE_NAMESPACE_PREFIX}aggregate-inventory:`;
 const MAX_PAGE_ENTRIES = 1_024;
 const MAX_PAGE_BYTES = 1_024 * 1_024;
 const MAX_TREE_LEVELS = 32;
@@ -135,8 +138,8 @@ function buildTree(request) {
     if (request.participants.length < 1) {
         throw new RangeError('Aggregate inventory requires at least one participant.');
     }
-    if (request.inventoryDigest.byteLength !== 32) {
-        throw new TypeError('Aggregate inventory digest must contain 32 bytes.');
+    if (request.inventoryDigest.byteLength !== actor_join_recovery_codec_1.SHA256_DIGEST_BYTES) {
+        throw new TypeError(`Aggregate inventory digest must contain ${actor_join_recovery_codec_1.SHA256_DIGEST_BYTES} bytes.`);
     }
     const entries = request.participants.map((participant, index) => ({
         index,
@@ -162,7 +165,7 @@ function buildTree(request) {
             MAX_PAGE_BYTES) {
         level++;
         if (level >= MAX_TREE_LEVELS) {
-            throw new RangeError('Aggregate inventory tree exceeds 32 levels.');
+            throw new RangeError(`Aggregate inventory tree exceeds ${MAX_TREE_LEVELS} levels.`);
         }
         references = packIndexPages(level, references, pages);
     }
@@ -180,7 +183,7 @@ function packLeafPages(entries, pages) {
         let bytes;
         do {
             page = {
-                kind: 'aggregate-inventory-page-v1',
+                kind: INVENTORY_PAGE_KIND,
                 level: 0,
                 index: references.length,
                 startIndex: offset,
@@ -211,7 +214,7 @@ function packIndexPages(level, children, pages) {
         do {
             const selected = children.slice(offset, offset + count);
             page = {
-                kind: 'aggregate-inventory-page-v1',
+                kind: INVENTORY_PAGE_KIND,
                 level,
                 index: references.length,
                 startIndex: selected[0].startIndex,
@@ -240,7 +243,7 @@ function rootCandidate(totalCount, topLevel, topPages, pages, digest, declaredDi
             pageCountsByLevel[page.level]++;
     }
     return {
-        kind: 'aggregate-inventory-root-v1',
+        kind: INVENTORY_ROOT_KIND,
         totalCount,
         digest,
         declaredDigest,
@@ -325,7 +328,7 @@ function decodeRoot(bytes) {
     if (value === null ||
         typeof value !== 'object' ||
         !('kind' in value) ||
-        value.kind !== 'aggregate-inventory-root-v1') {
+        value.kind !== INVENTORY_ROOT_KIND) {
         throw new Error('Invalid inventory root.');
     }
     return value;
@@ -335,7 +338,7 @@ function decodePage(bytes) {
     if (value === null ||
         typeof value !== 'object' ||
         !('kind' in value) ||
-        value.kind !== 'aggregate-inventory-page-v1' ||
+        value.kind !== INVENTORY_PAGE_KIND ||
         !('entries' in value) ||
         !Array.isArray(value.entries) ||
         !('children' in value) ||
@@ -379,7 +382,7 @@ function isSha256(value) {
 }
 function sameHash(expected, actual) {
     return (isSha256(expected) &&
-        actual.byteLength === 32 &&
+        actual.byteLength === actor_join_recovery_codec_1.SHA256_DIGEST_BYTES &&
         (0, node_crypto_1.timingSafeEqual)(Buffer.from(expected, 'hex'), Buffer.from(actual)));
 }
 function dataLost(fence, reason) {

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

@@ -2,10 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encodeAuthorityKey = encodeAuthorityKey;
 exports.decodeAuthorityKey = decodeAuthorityKey;
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
 function encodeAuthorityKey(kind, globalId) {
     const bytes = Buffer.from(globalId);
-    if (bytes.byteLength < 1 || bytes.byteLength > 255) {
-        throw new RangeError('Authority identity must contain 1..255 UTF-8 bytes.');
+    if (bytes.byteLength < 1 || bytes.byteLength > CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES) {
+        throw new RangeError(`Authority identity must contain 1..${CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES} UTF-8 bytes.`);
     }
     const discriminator = kind === 'actor' ? 'a' : 's';
     return {
@@ -20,7 +21,7 @@ function decodeAuthorityKey(key) {
     if (match === null)
         throw new TypeError('Authority key is not canonical.');
     const declaredLength = Number(match[2]);
-    if (declaredLength > 255)
+    if (declaredLength > CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES)
         throw new TypeError('Authority key identity exceeds the byte limit.');
     const encoded = match[3];
     const bytes = [];

package/dist/runtime/locations/auto-connect-reconciler.d.ts

@@ -1,6 +1,7 @@
 import { type ZLinkLocationOptionOverrides } from '../../contracts/Locations/Options';
 import type { RoutingId } from '../../contracts/Common';
 import { type ZLinkPeerLocationResolver, type ZLinkPeerLocation } from './internal-location-contracts';
+import type { ZLinkDispatchErrorSink } from '../diagnostics/dispatch-error-port';
 import type { IZLinkAutoConnectExecutor, IZLinkAutoConnectPeerPublisher, ZLinkAutoConnectEventSink, ZLinkAutoConnectLocal, ZLinkAutoConnectTarget } from './auto-connect-types';
 export interface ZLinkAutoConnectReconcilerOptions {
     readonly local: ZLinkAutoConnectLocal;
@@ -12,6 +13,7 @@ export interface ZLinkAutoConnectReconcilerOptions {
     readonly events?: ZLinkAutoConnectEventSink;
     readonly options?: ZLinkLocationOptionOverrides;
     readonly monotonicNowMs?: () => number;
+    readonly errorSink: ZLinkDispatchErrorSink;
 }
 export declare class ZLinkAutoConnectReconciler {
     private readonly lane;
@@ -24,6 +26,7 @@ export declare class ZLinkAutoConnectReconciler {
     private readonly events?;
     private readonly options;
     private readonly monotonicNowMs;
+    private readonly errorSink;
     private readonly active;
     private readonly pendingDisconnects;
     private readonly failedEndpoints;
@@ -50,6 +53,7 @@ export declare class ZLinkAutoConnectReconciler {
     private completePublishClaimCore;
     private preparePublishRenewalCore;
     private recordStoreFailure;
+    private connectTarget;
     private beginStoreFailureCore;
     private completeStoreFailureConnectCore;
     private recordDisconnectedEndpoint;

package/dist/runtime/locations/auto-connect-reconciler.js

@@ -7,6 +7,7 @@ const key_codec_1 = require("./key-codec");
 const EndpointNotation_1 = require("../../contracts/Configuration/EndpointNotation");
 const auto_connect_planner_1 = require("./auto-connect-planner");
 const state_lane_1 = require("../execution/state-lane");
+const zlink_1 = require("@zlink-systems/zlink");
 const encodeRoutingIdHex = key_codec_1.ZLinkLocationKeyCodec.encodeRoutingIdHex;
 class ZLinkAutoConnectReconciler {
     lane = new state_lane_1.ZLinkStateLane();
@@ -19,6 +20,7 @@ class ZLinkAutoConnectReconciler {
     events;
     options;
     monotonicNowMs;
+    errorSink;
     active = new Map();
     pendingDisconnects = new Map();
     failedEndpoints = new Set();
@@ -45,6 +47,7 @@ class ZLinkAutoConnectReconciler {
         this.events = options.events;
         this.options = { ...Options_1.zlinkRuntimeDefaultLocationOptions, ...options.options };
         this.monotonicNowMs = options.monotonicNowMs ?? (() => performance.now());
+        this.errorSink = options.errorSink;
         this.executor.onDisconnected?.((endpoint) => this.recordDisconnectedEndpoint(endpoint));
     }
     get storeFailed() {
@@ -116,13 +119,6 @@ class ZLinkAutoConnectReconciler {
             await this.lane.run(() => {
                 this.storeFailedValue = false;
                 this.storeFailureStartedAtMs = undefined;
-                // After a store restart, owners may need one full lease interval to
-                // reclaim their token and republish a descriptor. Do not interpret the
-                // incomplete post-restart scan as a definitive removal.
-                // Keep the existing transport set through one lease interval while
-                // owners reclaim their tokens and republish descriptors. This deferral
-                // applies only after a Store operation failed; a successful empty scan
-                // is authoritative and must remove stale peers promptly.
                 this.recoveryDeferUntilMs = this.monotonicNowMs() + this.options.ownerLeaseTtlMs;
             });
         }
@@ -133,7 +129,6 @@ class ZLinkAutoConnectReconciler {
                 .map((nodeRid) => encodeRoutingIdHex(nodeRid)));
         });
         const candidates = auto_connect_planner_1.ZLinkAutoConnectPlanner.computeCandidates(this.local, rows);
-        const nowMs = this.monotonicNowMs();
         this.executor.expectPeers?.([...candidates.values()]);
         this.executor.replaceNotRequired?.(auto_connect_planner_1.ZLinkAutoConnectPlanner.computeNotRequired(this.local, rows));
         const desired = new Map(auto_connect_planner_1.ZLinkAutoConnectPlanner.computeDesired(this.local, rows));
@@ -152,6 +147,19 @@ class ZLinkAutoConnectReconciler {
             if (activeKeys.has(key))
                 desired.set(key, target);
         }
+        const deferringMissingTargets = this.monotonicNowMs() < (await this.lane.run(() => this.recoveryDeferUntilMs));
+        let staleCandidates = candidates;
+        if (deferringMissingTargets) {
+            const retainedCandidates = new Map(candidates);
+            const lastDesired = await this.lane.run(() => [...this.lastDesired]);
+            for (const [key, target] of lastDesired) {
+                if (!desired.has(key))
+                    desired.set(key, target);
+                if (!retainedCandidates.has(key))
+                    retainedCandidates.set(key, target);
+            }
+            staleCandidates = retainedCandidates;
+        }
         await this.lane.run(() => {
             this.lastDesired = new Map(desired);
         });
@@ -178,14 +186,13 @@ class ZLinkAutoConnectReconciler {
                 await this.lane.run(() => {
                     this.pendingDisconnects.delete(key);
                 });
-                const connected = await this.executor.connect(target);
-                if (connected) {
+                await this.connectTarget(target, async () => {
                     connectedEndpoints.push(target.endpoint);
                     await this.lane.run(() => {
                         this.active.set(key, target);
                         this.failedEndpoints.delete(target.endpoint);
                     });
-                }
+                });
                 continue;
             }
             if (current.endpoint !== target.endpoint || current.ownerId !== target.ownerId) {
@@ -203,25 +210,16 @@ class ZLinkAutoConnectReconciler {
                 await this.lane.run(() => {
                     this.pendingDisconnects.delete(key);
                 });
-                const connected = await this.executor.connect(target);
-                if (connected) {
+                await this.connectTarget(target, async () => {
                     connectedEndpoints.push(target.endpoint);
                     await this.lane.run(() => {
                         this.active.set(key, target);
                         this.failedEndpoints.delete(target.endpoint);
                     });
-                }
+                });
             }
         }
-        if (nowMs < (await this.lane.run(() => this.recoveryDeferUntilMs))) {
-            this.publishDesiredSetChange(connectedEndpoints, disconnectedEndpoints);
-            return;
-        }
-        // A store restart can expose an incomplete descriptor set while peers are
-        // reclaiming their owner leases. Preserve existing transport connections
-        // during that recovery window; stale-peer cleanup is safe after the
-        // deferred reconciliation has completed.
-        this.executor.disconnectStalePeers?.([...candidates.values()]);
+        this.executor.disconnectStalePeers?.([...staleCandidates.values()]);
         const activeTargets = await this.lane.run(() => [...this.active]);
         for (const [key, target] of activeTargets) {
             if (!desired.has(key)) {
@@ -330,10 +328,24 @@ class ZLinkAutoConnectReconciler {
         if (retryTargets === undefined)
             return;
         for (const [key, target] of retryTargets) {
-            if (await this.executor.connect(target)) {
+            await this.connectTarget(target, async () => {
                 await this.lane.run(() => this.completeStoreFailureConnectCore(key, target));
-            }
+            });
+        }
+    }
+    async connectTarget(target, accept) {
+        let accepted;
+        try {
+            accepted = await this.executor.connect(target);
+        }
+        catch (error) {
+            if (!(error instanceof zlink_1.ConnectError))
+                throw error;
+            this.errorSink.reportRuntimeTaskException('auto-connect', error);
+            return;
         }
+        if (accepted)
+            await accept();
     }
     beginStoreFailureCore() {
         const nowMs = this.monotonicNowMs();

package/dist/runtime/locations/creation-operation-id.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.randomOperationId = randomOperationId;
+const stream_wire_1 = require("@zlink-systems/stream-wire");
+const operation_identity_1 = require("../foundation/operation-identity");
 const node_crypto_1 = require("node:crypto");
-function randomOperationId(entropy = (0, node_crypto_1.randomBytes)(16)) {
-    if (entropy.byteLength !== 16)
-        throw new RangeError('Operation ID entropy must be 16 bytes.');
+function randomOperationId(entropy = (0, node_crypto_1.randomBytes)(operation_identity_1.OPERATION_IDENTITY_BYTES)) {
+    if (entropy.byteLength !== operation_identity_1.OPERATION_IDENTITY_BYTES)
+        throw new RangeError(`Operation ID entropy must be ${operation_identity_1.OPERATION_IDENTITY_BYTES} bytes.`);
     const bytes = Buffer.from(entropy);
     const high = bytes.readBigUInt64BE(0);
-    const low = bytes.readBigUInt64BE(8);
+    const low = bytes.readBigUInt64BE(stream_wire_1.UINT64_BYTES);
     return high === 0n && low === 0n ? { high, low: 1n } : { high, low };
 }

package/dist/runtime/locations/domain-store-contract.d.ts

@@ -22,10 +22,10 @@ export interface ZLinkDomainLocationStore {
     compareExchangeAuthority(key: ZLinkAuthorityKey, expectedStoreVersion: ZLinkAuthorityStoreVersion, mutation: ZLinkAuthorityMutation, signal?: AbortSignal): Promise<ZLinkAuthorityCompareExchangeResult>;
     listAuthorities(prefix: string, cursor: ZLinkAuthorityScanCursor | undefined, limit: number, signal?: AbortSignal): Promise<ZLinkAuthorityScanResult>;
     readCreationTerminal(operation: ZLinkCreationOperationIdentity, signal?: AbortSignal): Promise<ZLinkCreationTerminalReadResult>;
-    reserve(request: ZLinkObjectReserveRequest, signal?: AbortSignal): Promise<ZLinkObjectReserveResult>;
-    commit(request: ZLinkObjectCommitRequest, signal?: AbortSignal): Promise<ZLinkObjectCommitResult>;
+    reserve(request: ZLinkObjectReserveRequest, signal?: AbortSignal, deadlineUnixMs?: bigint): Promise<ZLinkObjectReserveResult>;
+    commit(request: ZLinkObjectCommitRequest, signal?: AbortSignal, deadlineUnixMs?: bigint): Promise<ZLinkObjectCommitResult>;
     completeCreation(request: ZLinkObjectCreationCompleteRequest, signal?: AbortSignal): Promise<ZLinkObjectCreationCompleteResult>;
-    abort(request: ZLinkObjectAbortRequest, signal?: AbortSignal): Promise<ZLinkObjectAbortResult>;
+    abort(request: ZLinkObjectAbortRequest, signal?: AbortSignal, deadlineUnixMs?: bigint): Promise<ZLinkObjectAbortResult>;
     prepareAggregate(request: ZLinkAggregatePrepareRequest, signal?: AbortSignal): Promise<ZLinkAggregatePrepareResult>;
     commitAggregate(fence: ZLinkAggregateFence, signal?: AbortSignal): Promise<ZLinkAggregateCommitResult>;
     abortAggregate(fence: ZLinkAggregateFence, signal?: AbortSignal): Promise<ZLinkAggregateAbortResult>;

package/dist/runtime/locations/in-memory-authority-store.js

@@ -1,13 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkInMemoryAuthorityStore = void 0;
+const InternalDefaults_1 = require("../../contracts/Configuration/InternalDefaults");
+const stream_wire_1 = require("@zlink-systems/stream-wire");
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
+const Stores_1 = require("../../contracts/Locations/Stores");
 const node_crypto_1 = require("node:crypto");
+const actor_join_recovery_codec_1 = require("../foundation/actor-join-recovery-codec");
 const authority_key_codec_1 = require("./authority-key-codec");
 const opaque_record_key_1 = require("./opaque-record-key");
 const MAX_GENERATION = 0x7fffffffffffffffn;
-const MAX_PAYLOAD_BYTES = 1024 * 1024;
 const CREATION_TERMINAL_RETENTION_MS = 5 * 60 * 1000;
-const MAX_U64 = 0xffffffffffffffffn;
+const MAX_U64 = stream_wire_1.UINT64_MAX;
 /**
  * In-memory reference provider for the provider-owned authority state machine.
  * Opaque payload bytes are copied but never parsed.
@@ -101,11 +105,21 @@ class ZLinkInMemoryAuthorityStore {
         if (!this.isOwnerLive(row.snapshot)) {
             return { kind: 'conflict', current: this.read(keyValue) };
         }
+        if (mutation.generationTransition === 'reincarnate' &&
+            (this.objectGeneration >= MAX_GENERATION || this.ownerGeneration >= MAX_GENERATION)) {
+            return { kind: 'generationExhausted' };
+        }
         const nextVersion = this.tryNextStoreVersion();
         if (nextVersion === undefined)
             return { kind: 'generationExhausted' };
         row.snapshot = {
             ...row.snapshot,
+            ...(mutation.generationTransition === 'reincarnate'
+                ? {
+                    objectGeneration: ++this.objectGeneration,
+                    authorityOwnerGeneration: ++this.ownerGeneration
+                }
+                : {}),
             storeVersion: version(nextVersion),
             payload: Buffer.from(mutation.payload)
         };
@@ -114,8 +128,8 @@ class ZLinkInMemoryAuthorityStore {
     }
     async listAuthorities(prefix, cursor, limit, signal) {
         signal?.throwIfAborted();
-        if (!Number.isInteger(limit) || limit < 1 || limit > 1000) {
-            throw new RangeError('Authority scan limit must be in 1..1000.');
+        if (!Number.isInteger(limit) || limit < 1 || limit > Stores_1.ZLINK_PROVIDER_MAX_PAGE_SIZE) {
+            throw new RangeError(`Authority scan limit must be in 1..${Stores_1.ZLINK_PROVIDER_MAX_PAGE_SIZE}.`);
         }
         const decoded = cursor === undefined
             ? { revision: this.scanRevision, offset: 0, prefix }
@@ -611,7 +625,7 @@ function validateAuthorityMutation(mutation) {
     }
     const generationTransition = mutation
         .generationTransition;
-    if (generationTransition !== 'preserve') {
+    if (generationTransition !== 'preserve' && generationTransition !== 'reincarnate') {
         throw new TypeError('Authority owner transitions require an aggregate CAS.');
     }
 }
@@ -621,17 +635,19 @@ function validateReserve(request) {
     requireText(request.intent.requestContentReference, 'creation content reference');
     validatePayload(request.creatingPayload);
     validateCapacityVector(request.capacity);
-    if (request.intent.requestSha256.byteLength !== 32 ||
+    if (request.intent.requestSha256.byteLength !== actor_join_recovery_codec_1.SHA256_DIGEST_BYTES ||
         request.intent.requestEncodedSize < 0n ||
-        request.intent.requestEncodedSize > BigInt(MAX_PAYLOAD_BYTES)) {
+        request.intent.requestEncodedSize > BigInt(InternalDefaults_1.CREATION_INTENT_MAX_BYTES)) {
         throw new TypeError('Object creation content receipt is invalid.');
     }
 }
 function validateCreationOperation(operation) {
     const sourceRid = String(operation.sourceNodeRid);
     const sourceRidBytes = Buffer.byteLength(sourceRid, 'utf8');
-    if (sourceRidBytes < 1 || sourceRidBytes > 255 || sourceRid.includes('\0')) {
-        throw new TypeError('Creation terminal source node RID must contain 1..255 UTF-8 bytes without NUL.');
+    if (sourceRidBytes < 1 ||
+        sourceRidBytes > CoreTypes_1.ZLINK_MAX_ROUTING_ID_BYTES ||
+        sourceRid.includes('\0')) {
+        throw new TypeError(`Creation terminal source node RID must contain 1..${CoreTypes_1.ZLINK_MAX_ROUTING_ID_BYTES} UTF-8 bytes without NUL.`);
     }
     if (operation.sourceNodeGeneration < 1n ||
         operation.sourceNodeGeneration > MAX_U64 ||
@@ -647,8 +663,8 @@ function validateTerminalForMutation(publication, storeNow) {
     if (publication === undefined)
         return undefined;
     validateCreationOperation(publication.operation);
-    if (publication.terminalEnvelope.byteLength > MAX_PAYLOAD_BYTES) {
-        throw new RangeError('Creation terminal envelope must not exceed 1 MiB.');
+    if (publication.terminalEnvelope.byteLength > InternalDefaults_1.CREATION_TERMINAL_ENVELOPE_MAX_BYTES) {
+        throw new RangeError(`Creation terminal envelope must not exceed ${InternalDefaults_1.CREATION_TERMINAL_ENVELOPE_MAX_BYTES / (1024 * 1024)} MiB.`);
     }
     const deadlineMs = publication.operationDeadline.getTime();
     const expiresAtMs = deadlineMs + CREATION_TERMINAL_RETENTION_MS;
@@ -691,8 +707,8 @@ function validateAggregateRequest(request) {
     if (request.aggregateGeneration < 1n || request.participants.length < 1) {
         throw new RangeError('Aggregate generation and participant count are invalid.');
     }
-    if (request.inventoryDigest.byteLength !== 32) {
-        throw new TypeError('Aggregate inventory digest must contain 32 bytes.');
+    if (request.inventoryDigest.byteLength !== actor_join_recovery_codec_1.SHA256_DIGEST_BYTES) {
+        throw new TypeError(`Aggregate inventory digest must contain ${actor_join_recovery_codec_1.SHA256_DIGEST_BYTES} bytes.`);
     }
     validateCapacityVector(request.capacity);
     const keys = request.participants.map((participant) => participant.authorityKey.value);
@@ -702,8 +718,8 @@ function validateAggregateRequest(request) {
     }
 }
 function validatePayload(payload) {
-    if (payload.byteLength > MAX_PAYLOAD_BYTES) {
-        throw new RangeError('Authority payload exceeds 1 MiB.');
+    if (payload.byteLength > InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES) {
+        throw new RangeError(`Authority payload exceeds ${InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES / (1024 * 1024)} MiB.`);
     }
 }
 function validateCapacityVector(value) {

package/dist/runtime/locations/in-memory-location-store.d.ts

@@ -1,7 +1,7 @@
-import { ZLinkLocationWriteIntent, ZLinkLocationWriteStatus, type ZLinkActorLocation, 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 ZLinkActorLocationFilter, type ZLinkActorLocationKey, type ZLinkLocationChangeStampScope, type ZLinkLocationOwnerToken, type ZLinkLocationPage, type ZLinkLocationWriteResult, type ZLinkMeshNodeDescriptor, type ZLinkMeshNodeDescriptorKey, type ZLinkClientServerServerDescriptor, type ZLinkClientServerServerDescriptorKey, type ZLinkFanoutPublisherDescriptor, type ZLinkFanoutPublisherDescriptorKey, type ZLinkOwnerLeaseClaimResult, type ZLinkOwnerLeaseReadResult, type ZLinkOwnerLeaseReleaseResult, type ZLinkOwnerLeaseRenewResult, type ZLinkObjectAbortRequest, type ZLinkObjectAbortResult, type ZLinkObjectCommitRequest, type ZLinkObjectCommitResult, type ZLinkObjectCreationCompleteRequest, type ZLinkObjectCreationCompleteResult, type ZLinkObjectReserveRequest, type ZLinkObjectReserveResult, type ZLinkCreationOperationIdentity, type ZLinkCreationTerminalReadResult, type ZLinkPageRequest, type ZLinkPeerLocation, type ZLinkPeerLocationFilter, type ZLinkPeerLocationKey, type ZLinkRouteLocation, type ZLinkRouteLocationFilter, type ZLinkRouteLocationKey, type ZLinkSpotLocation, type ZLinkSpotLocationFilter, type ZLinkSpotLocationKey } from './internal-location-contracts';
 import type { ZLinkActorTransferPrepareRequest, ZLinkActorTransferRecord, ZLinkActorTransferWriteResult } from '../../contracts/Locations/ActorTransfer';
-import type { ZLinkFanoutLocationStore } from './internal-store-contracts';
 import type { ZLinkDomainLocationStore } from './domain-store-contract';
+import { ZLinkLocationWriteIntent, ZLinkLocationWriteStatus, 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 ZLinkClientServerServerDescriptor, type ZLinkClientServerServerDescriptorKey, type ZLinkCreationOperationIdentity, type ZLinkCreationTerminalReadResult, type ZLinkFanoutPublisherDescriptor, type ZLinkFanoutPublisherDescriptorKey, type ZLinkLocationChangeStampScope, type ZLinkLocationOwnerToken, type ZLinkLocationPage, type ZLinkLocationWriteResult, type ZLinkMeshNodeDescriptor, type ZLinkMeshNodeDescriptorKey, 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 ZLinkPageRequest, type ZLinkPeerLocation, type ZLinkPeerLocationFilter, type ZLinkPeerLocationKey, type ZLinkRouteLocation, type ZLinkRouteLocationFilter, type ZLinkRouteLocationKey, type ZLinkSpotLocation, type ZLinkSpotLocationFilter, type ZLinkSpotLocationKey } from './internal-location-contracts';
+import type { ZLinkFanoutLocationStore } from './internal-store-contracts';
 export declare class ZLinkInMemoryLocationStore implements ZLinkDomainLocationStore, ZLinkFanoutLocationStore {
     private readonly now;
     private readonly leases;

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

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkInMemoryLocationStore = void 0;
-const internal_location_contracts_1 = require("./internal-location-contracts");
-const in_memory_authority_store_1 = require("./in-memory-authority-store");
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
+const RegistrationBuilderPolicy_1 = require("../../contracts/Configuration/RegistrationBuilderPolicy");
+const location_store_integration_1 = require("../../location-store-integration");
 const authority_key_codec_1 = require("./authority-key-codec");
+const in_memory_authority_store_1 = require("./in-memory-authority-store");
+const internal_location_contracts_1 = require("./internal-location-contracts");
 const key_codec_1 = require("./key-codec");
-const location_store_integration_1 = require("../../location-store-integration");
+const MAX_LOCATION_GENERATION = 0x7fffffffffffffffn;
+const MAX_DESCRIPTOR_OBJECT_CAPABILITIES = 1024;
 class ZLinkInMemoryLocationStore {
     now;
     leases = new Map();
@@ -526,7 +530,7 @@ class ZLinkInMemoryLocationStore {
         if (current !== undefined && current.leaseExpiresAt.getTime() > storeNow.getTime()) {
             return { kind: 'conflict' };
         }
-        if (this.ownerLeaseGeneration >= 0x7fffffffffffffffn) {
+        if (this.ownerLeaseGeneration >= MAX_LOCATION_GENERATION) {
             return { kind: 'generationExhausted' };
         }
         const token = { ownerId, leaseGeneration: ++this.ownerLeaseGeneration };
@@ -743,13 +747,13 @@ function validateMeshNodeDescriptor(descriptor) {
     }
     if (descriptor.objectRole === internal_location_contracts_1.ZLinkObjectRole.Server) {
         if (descriptor.entrySpotId !== undefined && !validDescriptorText(descriptor.entrySpotId)) {
-            throw new TypeError('MeshNode Entry Spot ID must contain 1..255 UTF-8 bytes.');
+            throw new TypeError(`MeshNode Entry Spot ID must contain 1..${CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES} UTF-8 bytes.`);
         }
     }
     else if (descriptor.entrySpotId !== undefined) {
         throw new TypeError('Only Object Server descriptors may publish an Entry Spot ID.');
     }
-    const maxGeneration = 0x7fffffffffffffffn;
+    const maxGeneration = MAX_LOCATION_GENERATION;
     if (descriptor.lifecycleGeneration < 1n ||
         descriptor.lifecycleGeneration > maxGeneration ||
         descriptor.descriptorRevision < 1n ||
@@ -777,9 +781,8 @@ function validateMeshNodeDescriptor(descriptor) {
         !Number.isSafeInteger(descriptor.activationConcurrency.limit) ||
         descriptor.activationConcurrency.limit < 1 ||
         descriptor.activationConcurrency.active > descriptor.activationConcurrency.limit ||
-        descriptor.placementWeight < 0 ||
-        descriptor.placementWeight > 10_000 ||
-        descriptor.objectCapabilities.length > 1024 ||
+        !(0, RegistrationBuilderPolicy_1.isValidPublicWeight)(descriptor.placementWeight) ||
+        descriptor.objectCapabilities.length > MAX_DESCRIPTOR_OBJECT_CAPABILITIES ||
         (descriptor.objectRole !== internal_location_contracts_1.ZLinkObjectRole.Server && descriptor.objectCapabilities.length !== 0)) {
         throw new RangeError('MeshNode object capacity is invalid.');
     }
@@ -804,7 +807,7 @@ function validateMeshNodeDescriptor(descriptor) {
 }
 function validDescriptorText(value) {
     const size = Buffer.byteLength(value, 'utf8');
-    return size >= 1 && size <= 255 && !value.includes('\0');
+    return size >= 1 && size <= CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES && !value.includes('\0');
 }
 function meshNodeImmutableFingerprint(descriptor) {
     const capabilities = [...descriptor.objectCapabilities].sort((left, right) => {
@@ -867,7 +870,7 @@ function validateClientServerDescriptor(descriptor) {
         !validDescriptorText(descriptor.ownerId)) {
         throw new TypeError('ClientServer descriptor identity and endpoint are required.');
     }
-    const maxGeneration = 0x7fffffffffffffffn;
+    const maxGeneration = MAX_LOCATION_GENERATION;
     if (descriptor.lifecycleGeneration < 1n ||
         descriptor.lifecycleGeneration > maxGeneration ||
         descriptor.descriptorRevision < 1n ||
@@ -876,8 +879,8 @@ function validateClientServerDescriptor(descriptor) {
         descriptor.leaseGeneration > maxGeneration) {
         throw new RangeError('ClientServer descriptor generations are invalid.');
     }
-    if (!Number.isInteger(descriptor.weight) || descriptor.weight < 0 || descriptor.weight > 10_000) {
-        throw new RangeError('ClientServer descriptor weight must be an integer in 0..10000.');
+    if (!(0, RegistrationBuilderPolicy_1.isValidPublicWeight)(descriptor.weight)) {
+        throw new RangeError(`ClientServer descriptor weight must be an integer in 0..${RegistrationBuilderPolicy_1.ZLINK_MAX_PUBLIC_WEIGHT}.`);
     }
 }
 function clientServerImmutableFingerprint(descriptor) {
@@ -907,7 +910,7 @@ function validateFanoutPublisherDescriptor(descriptor) {
         !validDescriptorText(descriptor.ownerId)) {
         throw new TypeError('Fanout publisher descriptor identity and endpoint are required.');
     }
-    const maxGeneration = 0x7fffffffffffffffn;
+    const maxGeneration = MAX_LOCATION_GENERATION;
     if (descriptor.lifecycleGeneration < 1n ||
         descriptor.lifecycleGeneration > maxGeneration ||
         descriptor.descriptorRevision < 1n ||

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

@@ -1,4 +1,5 @@
 import type { ZLinkLocationStore, ZLinkStoreKey, ZLinkStoreReadResult, ZLinkStoreScanRequest, ZLinkStoreScanResult, ZLinkStoreVersion, ZLinkStoreWriteRequest, ZLinkStoreWriteResult } from '../../contracts';
+export declare const PROVIDER_STORAGE_NAMESPACE_PREFIX = "zlink:v11:";
 /**
  * Framework-owned primitive Store used by the explicit in-memory option.
  * Domain records are encoded by ZLinkLocationStoreRepository.