@zlink-systems/framework 0.20.0 → 0.22.0

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

@@ -39,9 +39,9 @@ class ZLinkInMemoryAuthorityStore {
         const keyValue = requireText(key.value, 'authority key');
         validateAuthorityMutation(mutation);
         const row = this.rows.get(keyValue);
-        if (row === undefined
-            || row.snapshot.allocation.state !== 'active'
-            || row.snapshot.storeVersion.value !== expectedStoreVersion.value) {
+        if (row === undefined ||
+            row.snapshot.allocation.state !== 'active' ||
+            row.snapshot.storeVersion.value !== expectedStoreVersion.value) {
             return { kind: 'conflict', current: this.read(keyValue) };
         }
         if (mutation.kind === 'delete') {
@@ -62,10 +62,10 @@ class ZLinkInMemoryAuthorityStore {
                 ownerId: row.snapshot.ownerId,
                 leaseGeneration: row.snapshot.ownerLeaseGeneration
             };
-            if (!sameOwner(mutation.expectedOwner, currentOwner)
-                || mutation.targetOwner.ownerId !== currentOwner.ownerId
-                || mutation.targetOwner.leaseGeneration === currentOwner.leaseGeneration
-                || !this.validation.isTargetLive(row.snapshot.allocation.descriptor, row.snapshot.allocation.descriptorLifecycleGeneration, mutation.targetOwner)) {
+            if (!sameOwner(mutation.expectedOwner, currentOwner) ||
+                mutation.targetOwner.ownerId !== currentOwner.ownerId ||
+                mutation.targetOwner.leaseGeneration === currentOwner.leaseGeneration ||
+                !this.validation.isTargetLive(row.snapshot.allocation.descriptor, row.snapshot.allocation.descriptorLifecycleGeneration, mutation.targetOwner)) {
                 return { kind: 'conflict', current: this.read(keyValue) };
             }
             const nextVersion = this.tryNextStoreVersion();
@@ -134,17 +134,15 @@ class ZLinkInMemoryAuthorityStore {
                 key: authorityKey(key),
                 snapshot: this.snapshot(row.snapshot)
             })),
-            nextCursor: nextOffset < rows.length
-                ? scanCursor(this.scanRevision, nextOffset, prefix)
-                : undefined
+            nextCursor: nextOffset < rows.length ? scanCursor(this.scanRevision, nextOffset, prefix) : undefined
         };
     }
     async removeAllByOwner(owner, signal) {
         signal?.throwIfAborted();
         let removed = 0;
         for (const [key, row] of [...this.rows.entries()]) {
-            if (row.snapshot.ownerId !== owner.ownerId
-                || row.snapshot.ownerLeaseGeneration !== owner.leaseGeneration)
+            if (row.snapshot.ownerId !== owner.ownerId ||
+                row.snapshot.ownerLeaseGeneration !== owner.leaseGeneration)
                 continue;
             if (row.snapshot.allocation.state === 'active') {
                 this.adjustCapacity(this.activeCapacity, row.snapshot.allocation, -1);
@@ -168,8 +166,8 @@ class ZLinkInMemoryAuthorityStore {
         }
         const current = this.rows.get(key);
         if (current !== undefined) {
-            if (current.snapshot.allocation.objectKind !== request.key.kind
-                || current.snapshot.allocation.stableType !== request.intent.stableType) {
+            if (current.snapshot.allocation.objectKind !== request.key.kind ||
+                current.snapshot.allocation.stableType !== request.intent.stableType) {
                 return { kind: 'typeMismatch', current: this.snapshot(current.snapshot) };
             }
             if (current.snapshot.allocation.state === 'active') {
@@ -200,9 +198,9 @@ class ZLinkInMemoryAuthorityStore {
         if (!this.hasPendingCapacity(allocation)) {
             return { kind: 'placementCapacityExhausted' };
         }
-        if (this.storeVersion >= MAX_GENERATION
-            || this.objectGeneration >= MAX_GENERATION
-            || this.ownerGeneration >= MAX_GENERATION) {
+        if (this.storeVersion >= MAX_GENERATION ||
+            this.objectGeneration >= MAX_GENERATION ||
+            this.ownerGeneration >= MAX_GENERATION) {
             return { kind: 'generationExhausted' };
         }
         const reservationId = (0, node_crypto_1.randomUUID)();
@@ -244,12 +242,12 @@ class ZLinkInMemoryAuthorityStore {
         if (terminal === 'committed' && row?.snapshot.allocation.state === 'active') {
             return { kind: 'alreadyCommitted', ready: this.snapshot(row.snapshot) };
         }
-        if (row === undefined
-            || row.snapshot.allocation.state !== 'reserved'
-            || row.creation?.reservationId !== request.reservationId
-            || row.snapshot.storeVersion.value !== request.expectedStoreVersion
-            || !sameCreationTarget(row.creation.target, request.target)
-            || !this.validation.isTargetLive(row.creation.target.descriptor, row.creation.target.lifecycleGeneration, row.creation.target.owner)) {
+        if (row === undefined ||
+            row.snapshot.allocation.state !== 'reserved' ||
+            row.creation?.reservationId !== request.reservationId ||
+            row.snapshot.storeVersion.value !== request.expectedStoreVersion ||
+            !sameCreationTarget(row.creation.target, request.target) ||
+            !this.validation.isTargetLive(row.creation.target.descriptor, row.creation.target.lifecycleGeneration, row.creation.target.owner)) {
             return { kind: 'stale' };
         }
         const nextVersion = this.tryNextStoreVersion();
@@ -281,17 +279,17 @@ class ZLinkInMemoryAuthorityStore {
         }
         const terminalRecord = validateTerminalForMutation(request.completion.terminal, this.now());
         const existingTerminal = this.operationTerminals.get(creationOperationKey(terminalRecord.operation));
-        if (existingTerminal !== undefined
-            && existingTerminal.expiresAt.getTime() > this.now().getTime()) {
+        if (existingTerminal !== undefined &&
+            existingTerminal.expiresAt.getTime() > this.now().getTime()) {
             return {
                 kind: 'alreadyCompleted',
                 terminal: copyTerminalRecord(existingTerminal)
             };
         }
         const reservationTerminal = this.creationTerminals.get(request.reservationId);
-        if (reservationTerminal === 'committed'
-            || reservationTerminal === 'rejected'
-            || reservationTerminal === 'failed') {
+        if (reservationTerminal === 'committed' ||
+            reservationTerminal === 'rejected' ||
+            reservationTerminal === 'failed') {
             const retained = this.operationTerminals.get(creationOperationKey(terminalRecord.operation));
             return retained === undefined
                 ? { kind: 'stale' }
@@ -299,12 +297,12 @@ class ZLinkInMemoryAuthorityStore {
         }
         const key = creationKey(request.key);
         const row = this.rows.get(key);
-        if (row === undefined
-            || row.snapshot.allocation.state !== 'reserved'
-            || row.creation?.reservationId !== request.reservationId
-            || row.snapshot.storeVersion.value !== request.expectedStoreVersion
-            || !sameCreationTarget(row.creation.target, request.target)
-            || !this.validation.isTargetLive(row.creation.target.descriptor, row.creation.target.lifecycleGeneration, row.creation.target.owner)) {
+        if (row === undefined ||
+            row.snapshot.allocation.state !== 'reserved' ||
+            row.creation?.reservationId !== request.reservationId ||
+            row.snapshot.storeVersion.value !== request.expectedStoreVersion ||
+            !sameCreationTarget(row.creation.target, request.target) ||
+            !this.validation.isTargetLive(row.creation.target.descriptor, row.creation.target.lifecycleGeneration, row.creation.target.owner)) {
             return { kind: 'stale' };
         }
         if (!this.creationTerminalAvailable(terminalRecord)) {
@@ -373,11 +371,11 @@ class ZLinkInMemoryAuthorityStore {
             return { kind: 'alreadyAborted' };
         const key = creationKey(request.key);
         const row = this.rows.get(key);
-        if (row === undefined
-            || row.snapshot.allocation.state !== 'reserved'
-            || row.creation?.reservationId !== request.reservationId
-            || row.snapshot.storeVersion.value !== request.expectedStoreVersion
-            || !sameCreationTarget(row.creation.target, request.target)) {
+        if (row === undefined ||
+            row.snapshot.allocation.state !== 'reserved' ||
+            row.creation?.reservationId !== request.reservationId ||
+            row.snapshot.storeVersion.value !== request.expectedStoreVersion ||
+            !sameCreationTarget(row.creation.target, request.target)) {
             return { kind: 'stale' };
         }
         this.adjustCapacity(this.pendingCapacity, row.snapshot.allocation, -1);
@@ -395,9 +393,7 @@ class ZLinkInMemoryAuthorityStore {
             if (existing.state === 'prepared' && sameAggregateRequest(existing.request, request)) {
                 return { kind: 'alreadyPrepared', fence: existing.fence };
             }
-            return existing.state === 'committed'
-                ? { kind: 'stale' }
-                : { kind: 'conflict' };
+            return existing.state === 'committed' ? { kind: 'stale' } : { kind: 'conflict' };
         }
         if (!this.validation.isTargetLive(request.targetDescriptor, request.targetDescriptorLifecycleGeneration, request.targetOwner)) {
             return { kind: 'conflict' };
@@ -409,9 +405,9 @@ class ZLinkInMemoryAuthorityStore {
         let sourceCapacity = { actors: 0, spots: 0 };
         for (const participant of request.participants) {
             const row = this.rows.get(participant.authorityKey.value);
-            if (row === undefined
-                || row.snapshot.allocation.state !== 'active'
-                || row.snapshot.storeVersion.value !== participant.expectedStoreVersion.value) {
+            if (row === undefined ||
+                row.snapshot.allocation.state !== 'active' ||
+                row.snapshot.storeVersion.value !== participant.expectedStoreVersion.value) {
                 return { kind: 'conflict' };
             }
             if (participant.ownerTransition === 'preserve') {
@@ -450,9 +446,9 @@ class ZLinkInMemoryAuthorityStore {
         const rows = [];
         for (const participant of aggregate.request.participants) {
             const row = this.rows.get(participant.authorityKey.value);
-            if (row === undefined
-                || row.snapshot.allocation.state !== 'active'
-                || row.snapshot.storeVersion.value !== participant.expectedStoreVersion.value) {
+            if (row === undefined ||
+                row.snapshot.allocation.state !== 'active' ||
+                row.snapshot.storeVersion.value !== participant.expectedStoreVersion.value) {
                 return { kind: 'stale' };
             }
             if (participant.ownerTransition === 'newOwner') {
@@ -467,8 +463,8 @@ class ZLinkInMemoryAuthorityStore {
             versionsNeeded++;
             rows.push({ participant, row, changesOwner: participant.ownerTransition === 'newOwner' });
         }
-        if (this.storeVersion + versionsNeeded > MAX_GENERATION
-            || this.ownerGeneration + ownersNeeded > MAX_GENERATION) {
+        if (this.storeVersion + versionsNeeded > MAX_GENERATION ||
+            this.ownerGeneration + ownersNeeded > MAX_GENERATION) {
             return { kind: 'generationExhausted' };
         }
         for (const entry of rows) {
@@ -552,7 +548,7 @@ class ZLinkInMemoryAuthorityStore {
         return this.validation.isTargetLive(snapshot.allocation.descriptor, snapshot.allocation.descriptorLifecycleGeneration, { ownerId: snapshot.ownerId, leaseGeneration: snapshot.ownerLeaseGeneration });
     }
     hasPendingCapacity(allocation) {
-        return this.validation.placementCapacityAvailable?.(allocation.descriptor, allocation.capacity, this.capacityVectorUsage(this.pendingCapacity, allocation), this.capacityVectorUsage(this.activeCapacity, allocation)) ?? true;
+        return (this.validation.placementCapacityAvailable?.(allocation.descriptor, allocation.capacity, this.capacityVectorUsage(this.pendingCapacity, allocation), this.capacityVectorUsage(this.activeCapacity, allocation)) ?? true);
     }
     adjustCapacity(values, allocation, multiplier) {
         for (const entry of capacityEntries(allocation.descriptor, allocation.descriptorLifecycleGeneration, allocation.capacity)) {
@@ -566,12 +562,14 @@ class ZLinkInMemoryAuthorityStore {
         return {
             actors: values.get(capacityKey(descriptor, lifecycle, 'actor', '')) ?? 0,
             spots: values.get(capacityKey(descriptor, lifecycle, 'spot', '')) ?? 0,
-            ...(spotType === undefined ? {} : {
-                spotType: {
-                    ...spotType,
-                    count: values.get(capacityKey(descriptor, lifecycle, spotType.objectKind, spotType.stableType)) ?? 0
-                }
-            })
+            ...(spotType === undefined
+                ? {}
+                : {
+                    spotType: {
+                        ...spotType,
+                        count: values.get(capacityKey(descriptor, lifecycle, spotType.objectKind, spotType.stableType)) ?? 0
+                    }
+                })
         };
     }
     adjust(values, key, delta) {
@@ -603,15 +601,16 @@ function validateAuthorityMutation(mutation) {
     if (mutation.kind === 'delete' || mutation.kind === 'restore')
         return;
     if (mutation.kind === 'rebindOwnerLease') {
-        if (mutation.expectedOwner.ownerId !== mutation.targetOwner.ownerId
-            || mutation.expectedOwner.leaseGeneration === mutation.targetOwner.leaseGeneration
-            || mutation.expectedOwner.leaseGeneration <= 0n
-            || mutation.targetOwner.leaseGeneration <= 0n) {
+        if (mutation.expectedOwner.ownerId !== mutation.targetOwner.ownerId ||
+            mutation.expectedOwner.leaseGeneration === mutation.targetOwner.leaseGeneration ||
+            mutation.expectedOwner.leaseGeneration <= 0n ||
+            mutation.targetOwner.leaseGeneration <= 0n) {
             throw new TypeError('Authority lease rebind must retain the owner and change the lease generation.');
         }
         return;
     }
-    const generationTransition = mutation.generationTransition;
+    const generationTransition = mutation
+        .generationTransition;
     if (generationTransition !== 'preserve') {
         throw new TypeError('Authority owner transitions require an aggregate CAS.');
     }
@@ -622,9 +621,9 @@ function validateReserve(request) {
     requireText(request.intent.requestContentReference, 'creation content reference');
     validatePayload(request.creatingPayload);
     validateCapacityVector(request.capacity);
-    if (request.intent.requestSha256.byteLength !== 32
-        || request.intent.requestEncodedSize < 0n
-        || request.intent.requestEncodedSize > BigInt(MAX_PAYLOAD_BYTES)) {
+    if (request.intent.requestSha256.byteLength !== 32 ||
+        request.intent.requestEncodedSize < 0n ||
+        request.intent.requestEncodedSize > BigInt(MAX_PAYLOAD_BYTES)) {
         throw new TypeError('Object creation content receipt is invalid.');
     }
 }
@@ -634,13 +633,13 @@ function validateCreationOperation(operation) {
     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 (operation.sourceNodeGeneration < 1n
-        || operation.sourceNodeGeneration > MAX_U64
-        || operation.operationId.high < 0n
-        || operation.operationId.high > MAX_U64
-        || operation.operationId.low < 0n
-        || operation.operationId.low > MAX_U64
-        || (operation.operationId.high === 0n && operation.operationId.low === 0n)) {
+    if (operation.sourceNodeGeneration < 1n ||
+        operation.sourceNodeGeneration > MAX_U64 ||
+        operation.operationId.high < 0n ||
+        operation.operationId.high > MAX_U64 ||
+        operation.operationId.low < 0n ||
+        operation.operationId.low > MAX_U64 ||
+        (operation.operationId.high === 0n && operation.operationId.low === 0n)) {
         throw new RangeError('Creation terminal source generation and operation ID are invalid.');
     }
 }
@@ -653,9 +652,9 @@ function validateTerminalForMutation(publication, storeNow) {
     }
     const deadlineMs = publication.operationDeadline.getTime();
     const expiresAtMs = deadlineMs + CREATION_TERMINAL_RETENTION_MS;
-    if (!Number.isSafeInteger(deadlineMs)
-        || !Number.isSafeInteger(expiresAtMs)
-        || expiresAtMs <= storeNow.getTime()) {
+    if (!Number.isSafeInteger(deadlineMs) ||
+        !Number.isSafeInteger(expiresAtMs) ||
+        expiresAtMs <= storeNow.getTime()) {
         throw new RangeError('Creation terminal expiry must be the live operation deadline plus five minutes.');
     }
     return {
@@ -696,7 +695,7 @@ function validateAggregateRequest(request) {
         throw new TypeError('Aggregate inventory digest must contain 32 bytes.');
     }
     validateCapacityVector(request.capacity);
-    const keys = request.participants.map(participant => participant.authorityKey.value);
+    const keys = request.participants.map((participant) => participant.authorityKey.value);
     const sorted = [...keys].sort();
     if (new Set(keys).size !== keys.length || keys.some((key, index) => key !== sorted[index])) {
         throw new TypeError('Aggregate participants must be unique and canonically sorted.');
@@ -709,9 +708,9 @@ function validatePayload(payload) {
 }
 function validateCapacityVector(value) {
     const counts = [value.actors, value.spots, value.spotType?.count ?? 0];
-    if (counts.some(count => !Number.isInteger(count) || count < 0 || count > 0x7fff_ffff)
-        || counts.every(count => count === 0)
-        || value.spotType !== undefined && value.spotType.count === 0) {
+    if (counts.some((count) => !Number.isInteger(count) || count < 0 || count > 0x7fff_ffff) ||
+        counts.every((count) => count === 0) ||
+        (value.spotType !== undefined && value.spotType.count === 0)) {
         throw new RangeError('Placement capacity vector is invalid.');
     }
 }
@@ -728,9 +727,9 @@ function aggregateTargetAllocation(request) {
 function addCapacity(left, right) {
     let spotType = left.spotType;
     if (right.spotType !== undefined) {
-        if (spotType !== undefined
-            && (spotType.objectKind !== right.spotType.objectKind
-                || spotType.stableType !== right.spotType.stableType)) {
+        if (spotType !== undefined &&
+            (spotType.objectKind !== right.spotType.objectKind ||
+                spotType.stableType !== right.spotType.stableType)) {
             throw new TypeError('Aggregate capacity contains more than one Spot type.');
         }
         spotType = {
@@ -759,10 +758,10 @@ function creationTarget(request) {
     };
 }
 function sameCreationTarget(target, actual) {
-    return target.descriptor.meshName === actual.meshName
-        && sameRid(target.descriptor.rid, actual.nodeRid)
-        && target.lifecycleGeneration === actual.nodeLifecycleGeneration
-        && sameOwner(target.owner, actual.owner);
+    return (target.descriptor.meshName === actual.meshName &&
+        sameRid(target.descriptor.rid, actual.nodeRid) &&
+        target.lifecycleGeneration === actual.nodeLifecycleGeneration &&
+        sameOwner(target.owner, actual.owner));
 }
 function sameOwner(left, right) {
     return left.ownerId === right.ownerId && left.leaseGeneration === right.leaseGeneration;
@@ -775,18 +774,30 @@ function sameRid(left, right) {
 }
 function capacityEntries(descriptor, lifecycle, capacity) {
     return [
-        ...(capacity.actors === 0 ? [] : [{
-                key: capacityKey(descriptor, lifecycle, 'actor', ''),
-                count: capacity.actors
-            }]),
-        ...(capacity.spots === 0 ? [] : [{
-                key: capacityKey(descriptor, lifecycle, 'spot', ''),
-                count: capacity.spots
-            }]),
-        ...(capacity.spotType === undefined ? [] : [{
-                key: capacityKey(descriptor, lifecycle, capacity.spotType.objectKind, capacity.spotType.stableType),
-                count: capacity.spotType.count
-            }])
+        ...(capacity.actors === 0
+            ? []
+            : [
+                {
+                    key: capacityKey(descriptor, lifecycle, 'actor', ''),
+                    count: capacity.actors
+                }
+            ]),
+        ...(capacity.spots === 0
+            ? []
+            : [
+                {
+                    key: capacityKey(descriptor, lifecycle, 'spot', ''),
+                    count: capacity.spots
+                }
+            ]),
+        ...(capacity.spotType === undefined
+            ? []
+            : [
+                {
+                    key: capacityKey(descriptor, lifecycle, capacity.spotType.objectKind, capacity.spotType.stableType),
+                    count: capacity.spotType.count
+                }
+            ])
     ];
 }
 function cloneCapacity(value) {
@@ -797,11 +808,11 @@ function cloneCapacity(value) {
     };
 }
 function sameCapacity(left, right) {
-    return left.actors === right.actors
-        && left.spots === right.spots
-        && left.spotType?.objectKind === right.spotType?.objectKind
-        && left.spotType?.stableType === right.spotType?.stableType
-        && left.spotType?.count === right.spotType?.count;
+    return (left.actors === right.actors &&
+        left.spots === right.spots &&
+        left.spotType?.objectKind === right.spotType?.objectKind &&
+        left.spotType?.stableType === right.spotType?.stableType &&
+        left.spotType?.count === right.spotType?.count);
 }
 function capacityKey(descriptor, lifecycle, kind, stableType) {
     return `${descriptor.meshName}\0${String(descriptor.rid)}\0${lifecycle}\0${kind}\0${stableType}`;
@@ -844,24 +855,23 @@ function aggregateRecordKey(id, generation) {
     return `${id}\0${generation}`;
 }
 function sameAggregateRequest(left, right) {
-    if (left.aggregateId.value !== right.aggregateId.value
-        || left.aggregateGeneration !== right.aggregateGeneration
-        || !sameOwner(left.targetOwner, right.targetOwner)
-        || !Buffer.from(left.inventoryDigest).equals(Buffer.from(right.inventoryDigest))
-        || left.participants.length !== right.participants.length
-        || !sameDescriptor(left.targetDescriptor, right.targetDescriptor)
-        || left.targetDescriptorLifecycleGeneration
-            !== right.targetDescriptorLifecycleGeneration
-        || !sameCapacity(left.capacity, right.capacity)) {
+    if (left.aggregateId.value !== right.aggregateId.value ||
+        left.aggregateGeneration !== right.aggregateGeneration ||
+        !sameOwner(left.targetOwner, right.targetOwner) ||
+        !Buffer.from(left.inventoryDigest).equals(Buffer.from(right.inventoryDigest)) ||
+        left.participants.length !== right.participants.length ||
+        !sameDescriptor(left.targetDescriptor, right.targetDescriptor) ||
+        left.targetDescriptorLifecycleGeneration !== right.targetDescriptorLifecycleGeneration ||
+        !sameCapacity(left.capacity, right.capacity)) {
         return false;
     }
     return left.participants.every((participant, index) => {
         const other = right.participants[index];
-        return participant.authorityKey.value === other.authorityKey.value
-            && participant.expectedStoreVersion.value === other.expectedStoreVersion.value
-            && participant.ownerTransition === other.ownerTransition
-            && Buffer.from(participant.authorityPayload).equals(Buffer.from(other.authorityPayload))
-            && Buffer.from(participant.membershipMutation).equals(Buffer.from(other.membershipMutation));
+        return (participant.authorityKey.value === other.authorityKey.value &&
+            participant.expectedStoreVersion.value === other.expectedStoreVersion.value &&
+            participant.ownerTransition === other.ownerTransition &&
+            Buffer.from(participant.authorityPayload).equals(Buffer.from(other.authorityPayload)) &&
+            Buffer.from(participant.membershipMutation).equals(Buffer.from(other.membershipMutation)));
     });
 }
 function cloneAggregateRequest(request) {
@@ -872,7 +882,7 @@ function cloneAggregateRequest(request) {
         targetDescriptor: { ...request.targetDescriptor },
         capacity: cloneCapacity(request.capacity),
         inventoryDigest: Buffer.from(request.inventoryDigest),
-        participants: request.participants.map(participant => ({
+        participants: request.participants.map((participant) => ({
             ...participant,
             authorityKey: { ...participant.authorityKey },
             expectedStoreVersion: { ...participant.expectedStoreVersion },