@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/foundation/service-relocation-runtime.js

@@ -27,14 +27,11 @@ class ServiceRelocationAuthorityPayloadCodec {
         return encodeAuthorityEnvelope(Buffer.from(currentPayload), publication);
     }
     read(payload) {
-        return decodeCanonicalAuthorityPublication(payload)
-            ?? decodeAuthorityEnvelope(payload)?.publication;
+        return (decodeCanonicalAuthorityPublication(payload) ?? decodeAuthorityEnvelope(payload)?.publication);
     }
     clear(currentPayload, expectedReference) {
         const canonical = decodeCanonicalAuthorityLayout(currentPayload);
-        const canonicalPublication = canonical === undefined
-            ? undefined
-            : decodeCanonicalRelocationSlot(canonical.slot);
+        const canonicalPublication = canonical === undefined ? undefined : decodeCanonicalRelocationSlot(canonical.slot);
         if (canonical !== undefined && canonicalPublication?.reference !== undefined) {
             if (canonicalPublication.reference !== requireText(expectedReference, 'relocation reference')) {
                 throw new TypeError('Location authority relocation reference changed.');
@@ -42,8 +39,8 @@ class ServiceRelocationAuthorityPayloadCodec {
             return replaceCanonicalRelocationSlot(canonical, Buffer.alloc(0));
         }
         const current = decodeAuthorityEnvelope(currentPayload);
-        if (current === undefined
-            || current.publication.reference !== requireText(expectedReference, 'relocation reference')) {
+        if (current === undefined ||
+            current.publication.reference !== requireText(expectedReference, 'relocation reference')) {
             throw new TypeError('Location authority relocation reference changed.');
         }
         return Buffer.from(current.base);
@@ -224,25 +221,25 @@ function decodeCanonicalRelocationSlot(payload, rootAggregateGeneration) {
         const phase = reader.u8();
         const applicationVersion = reader.i64();
         const sourceCleanupState = reader.u8();
-        if (!reader.done
-            || aggregateGeneration > 0x7ffffffffffffffen
-            || (aggregateGeneration === 0n && phase !== 1)
-            || (rootAggregateGeneration !== undefined
-                && aggregateGeneration !== rootAggregateGeneration)
-            || targetAttemptGeneration > 0x7fffffffffffffffn
-            || sourceNodeGeneration === 0n
-            || sourceNodeGeneration > 0x7fffffffffffffffn
-            || sourceOwnerLeaseGeneration === 0n
-            || sourceOwnerLeaseGeneration > 0x7fffffffffffffffn
-            || targetNodeGeneration > 0x7fffffffffffffffn
-            || targetOwnerLeaseGeneration > 0x7fffffffffffffffn
-            || coordinatorLeaseGeneration === 0n
-            || coordinatorLeaseGeneration > 0x7fffffffffffffffn
-            || coordinatorNodeGeneration === 0n
-            || coordinatorNodeGeneration > 0x7fffffffffffffffn
-            || phase < 1 || phase > 9
-            || applicationVersion < 0n
-            || sourceCleanupState > 2)
+        if (!reader.done ||
+            aggregateGeneration > 0x7ffffffffffffffen ||
+            (aggregateGeneration === 0n && phase !== 1) ||
+            (rootAggregateGeneration !== undefined && aggregateGeneration !== rootAggregateGeneration) ||
+            targetAttemptGeneration > 0x7fffffffffffffffn ||
+            sourceNodeGeneration === 0n ||
+            sourceNodeGeneration > 0x7fffffffffffffffn ||
+            sourceOwnerLeaseGeneration === 0n ||
+            sourceOwnerLeaseGeneration > 0x7fffffffffffffffn ||
+            targetNodeGeneration > 0x7fffffffffffffffn ||
+            targetOwnerLeaseGeneration > 0x7fffffffffffffffn ||
+            coordinatorLeaseGeneration === 0n ||
+            coordinatorLeaseGeneration > 0x7fffffffffffffffn ||
+            coordinatorNodeGeneration === 0n ||
+            coordinatorNodeGeneration > 0x7fffffffffffffffn ||
+            phase < 1 ||
+            phase > 9 ||
+            applicationVersion < 0n ||
+            sourceCleanupState > 2)
             return undefined;
         return {
             aggregateId,
@@ -294,23 +291,33 @@ function encodeCanonicalRelocationSlot(value) {
     if (!Number.isInteger(value.phase) || value.phase < 1 || value.phase > 9) {
         throw new TypeError('Canonical relocation phase is invalid.');
     }
-    if (!Number.isInteger(value.sourceCleanupState)
-        || value.sourceCleanupState < 0
-        || value.sourceCleanupState > 2) {
+    if (!Number.isInteger(value.sourceCleanupState) ||
+        value.sourceCleanupState < 0 ||
+        value.sourceCleanupState > 2) {
         throw new TypeError('Canonical source cleanup state is invalid.');
     }
     return Buffer.concat([
-        canonicalU64(id.high), canonicalU64(id.low),
-        canonicalU64(aggregateGeneration), canonicalU64(targetAttemptGeneration),
-        canonicalText16(value.reference), canonicalU32(value.checksumCrc32c),
-        canonicalText8(value.sourceNodeRid), canonicalU64(sourceNodeGeneration),
-        canonicalText8(value.sourceOwnerId), canonicalU64(sourceOwnerLeaseGeneration),
-        canonicalOptionalText8(value.targetNodeRid), canonicalU64(targetNodeGeneration),
-        canonicalOptionalText8(value.targetOwnerId), canonicalU64(targetOwnerLeaseGeneration),
-        canonicalText8(value.coordinatorOwnerId), canonicalU64(coordinatorLeaseGeneration),
-        canonicalText8(value.coordinatorNodeRid), canonicalU64(coordinatorNodeGeneration),
+        canonicalU64(id.high),
+        canonicalU64(id.low),
+        canonicalU64(aggregateGeneration),
+        canonicalU64(targetAttemptGeneration),
+        canonicalText16(value.reference),
+        canonicalU32(value.checksumCrc32c),
+        canonicalText8(value.sourceNodeRid),
+        canonicalU64(sourceNodeGeneration),
+        canonicalText8(value.sourceOwnerId),
+        canonicalU64(sourceOwnerLeaseGeneration),
+        canonicalOptionalText8(value.targetNodeRid),
+        canonicalU64(targetNodeGeneration),
+        canonicalOptionalText8(value.targetOwnerId),
+        canonicalU64(targetOwnerLeaseGeneration),
+        canonicalText8(value.coordinatorOwnerId),
+        canonicalU64(coordinatorLeaseGeneration),
+        canonicalText8(value.coordinatorNodeRid),
+        canonicalU64(coordinatorNodeGeneration),
         canonicalOptionalText8(value.coordinatorExpectedStoreVersion),
-        Buffer.of(value.phase), canonicalI64(value.applicationVersion),
+        Buffer.of(value.phase),
+        canonicalI64(value.applicationVersion),
         Buffer.of(value.sourceCleanupState)
     ]);
 }
@@ -356,8 +363,11 @@ function replaceCanonicalRelocationSlot(layout, slot) {
         layout.body.subarray(layout.slotEnd)
     ]);
     const envelope = Buffer.concat([
-        Buffer.from('ZLAU'), Buffer.of(1), canonicalU16(layout.flags),
-        canonicalU32(body.byteLength), body
+        Buffer.from('ZLAU'),
+        Buffer.of(1),
+        canonicalU16(layout.flags),
+        canonicalU32(body.byteLength),
+        body
     ]);
     const result = Buffer.concat([envelope, canonicalU32(crc32c(envelope))]);
     if (result.byteLength > 1024 * 1024) {
@@ -380,9 +390,9 @@ function encodeServiceRelocationEnvelope(envelope, applicationVersion) {
     const aggregate = relocationId(canonicalUuid(envelope.aggregateId, 'aggregate id'));
     const encodedApplicationVersion = nonNegativeBigInt(applicationVersion, 'application version');
     const participants = canonicalParticipants(envelope.participants);
-    const root = participants.find(value => value.rootSpotId !== undefined)
-        ?? participants.find(value => value.objectKind !== 'actor')
-        ?? participants[0];
+    const root = participants.find((value) => value.rootSpotId !== undefined) ??
+        participants.find((value) => value.objectKind !== 'actor') ??
+        participants[0];
     const rootObjectKind = root.rootObjectKind ?? root.objectKind;
     if (rootObjectKind === 'actor' && participants.length !== 1) {
         throw new TypeError('Standalone Actor relocation requires one participant.');
@@ -398,23 +408,29 @@ function encodeServiceRelocationEnvelope(envelope, applicationVersion) {
             payload: Buffer.from(participant.applicationState)
         };
     });
-    const saved = participants.flatMap((participant, index) => participant.queuedMessages.map(message => ({
+    const saved = participants
+        .flatMap((participant, index) => participant.queuedMessages.map((message) => ({
         participantId: BigInt(index + 1),
         order: positiveBigInt(message.sequence, 'queue sequence'),
         frozenRecord: Buffer.from(message.payload)
-    }))).sort(compareParticipantOrder);
-    if (saved.some((value, index) => index > 0
-        && compareParticipantOrder(saved[index - 1], value) === 0)) {
+    })))
+        .sort(compareParticipantOrder);
+    if (saved.some((value, index) => index > 0 && compareParticipantOrder(saved[index - 1], value) === 0)) {
         throw new TypeError('Relocation queue sequences must be unique per participant.');
     }
-    const timers = participants.flatMap((participant, index) => participant.timers.map(timer => ({
-        participantId: BigInt(index + 1), timer
-    }))).sort((a, b) => a.participantId === b.participantId
+    const timers = participants
+        .flatMap((participant, index) => participant.timers.map((timer) => ({
+        participantId: BigInt(index + 1),
+        timer
+    })))
+        .sort((a, b) => a.participantId === b.participantId
         ? Buffer.compare(Buffer.from(a.timer.timerId), Buffer.from(b.timer.timerId))
-        : a.participantId < b.participantId ? -1 : 1);
-    if (timers.some((value, index) => index > 0
-        && timers[index - 1].participantId === value.participantId
-        && timers[index - 1].timer.timerId === value.timer.timerId)) {
+        : a.participantId < b.participantId
+            ? -1
+            : 1);
+    if (timers.some((value, index) => index > 0 &&
+        timers[index - 1].participantId === value.participantId &&
+        timers[index - 1].timer.timerId === value.timer.timerId)) {
         throw new TypeError('Relocation timer ids must be unique per participant.');
     }
     const nextOrder = new Map();
@@ -423,7 +439,8 @@ function encodeServiceRelocationEnvelope(envelope, applicationVersion) {
         if (value.order > current)
             nextOrder.set(value.participantId, value.order);
     }
-    const pending = timers.flatMap(({ participantId, timer }) => timer.pendingTicks.map(tick => {
+    const pending = timers
+        .flatMap(({ participantId, timer }) => timer.pendingTicks.map((tick) => {
         const current = nextOrder.get(participantId) ?? 0n;
         const order = tick.order === undefined
             ? current + 1n
@@ -431,7 +448,8 @@ function encodeServiceRelocationEnvelope(envelope, applicationVersion) {
         if (order > current)
             nextOrder.set(participantId, order);
         return { participantId, order, timerName: timer.timerId, tick };
-    })).sort(compareParticipantOrder);
+    }))
+        .sort(compareParticipantOrder);
     return Buffer.from((0, service_wire_pilot_codec_generated_1.encodeRelocationEnvelopeV1)({
         relocationHigh: aggregate.high,
         relocationLow: aggregate.low,
@@ -451,7 +469,7 @@ function encodeServiceRelocationEnvelope(envelope, applicationVersion) {
             lastCompletedScheduledIndex: nonNegativeBigInt(timer.lastScheduledIndex, 'timer scheduled index'),
             nextScheduledAtUnixMilliseconds: nonNegativeUnixMilliseconds(timer.dueAtUnixMs, 'timer due time')
         })),
-        pendingTimerTicks: pending.map(value => ({
+        pendingTimerTicks: pending.map((value) => ({
             participantId: value.participantId,
             order: value.order,
             timerName: value.timerName,
@@ -487,7 +505,7 @@ function decodeServiceRelocationEnvelope(payload, aggregateGeneration) {
         }
         return wireParticipant(state.participantId, state.hasState, Buffer.from(state.payload));
     });
-    const byId = new Map(participants.map(value => [value.participantId, value]));
+    const byId = new Map(participants.map((value) => [value.participantId, value]));
     for (const work of generated.savedWork) {
         byId.get(work.participantId).queuedMessages.push({
             sequence: work.order,
@@ -510,7 +528,9 @@ function decodeServiceRelocationEnvelope(payload, aggregateGeneration) {
         });
     }
     for (const tick of generated.pendingTimerTicks) {
-        const timer = byId.get(tick.participantId).timers.find(value => value.timerId === tick.timerName);
+        const timer = byId
+            .get(tick.participantId)
+            .timers.find((value) => value.timerId === tick.timerName);
         timer.pendingTicks.push({
             order: tick.order,
             deliveryIndex: tick.deliveryIndex,
@@ -525,9 +545,7 @@ function decodeServiceRelocationEnvelope(payload, aggregateGeneration) {
         aggregateId,
         aggregateGeneration,
         applicationVersion: generated.applicationVersion,
-        participants: participants.map(value => value === rootParticipant
-            ? { ...value, ...rootProjection }
-            : value),
+        participants: participants.map((value) => value === rootParticipant ? { ...value, ...rootProjection } : value),
         memberships: []
     };
 }
@@ -585,7 +603,7 @@ function canonicalParticipants(values) {
     if (values.length === 0)
         throw new TypeError('Relocation participant count is outside its bound.');
     const participants = [...values].sort((a, b) => Buffer.compare(Buffer.from(a.key), Buffer.from(b.key)));
-    if (new Set(participants.map(value => value.key)).size !== participants.length) {
+    if (new Set(participants.map((value) => value.key)).size !== participants.length) {
         throw new TypeError('Relocation participants must have unique keys.');
     }
     return participants;
@@ -596,7 +614,9 @@ function authorityGlobalId(key) {
     }
     catch {
         const marker = key.indexOf(':');
-        return marker < 0 ? requireText(key, 'participant key') : requireText(key.slice(marker + 1), 'participant key');
+        return marker < 0
+            ? requireText(key, 'participant key')
+            : requireText(key.slice(marker + 1), 'participant key');
     }
 }
 function relocationId(value) {
@@ -611,8 +631,14 @@ function uuid(high, low) {
 }
 function compareParticipantOrder(a, b) {
     return a.participantId === b.participantId
-        ? a.order < b.order ? -1 : a.order > b.order ? 1 : 0
-        : a.participantId < b.participantId ? -1 : 1;
+        ? a.order < b.order
+            ? -1
+            : a.order > b.order
+                ? 1
+                : 0
+        : a.participantId < b.participantId
+            ? -1
+            : 1;
 }
 function timerPolicy(value) {
     if (value === 'skipLateTicks')
@@ -665,21 +691,25 @@ function objectKind(value) {
     return value;
 }
 function inventoryDigest(participants, memberships = []) {
-    const identities = participants.map(participant => ({
+    const identities = participants
+        .map((participant) => ({
         key: requireText(participant.key, 'participant key'),
         objectKind: objectKind(participant.objectKind),
         stableType: requireText(participant.stableType, 'participant stable type'),
         objectGeneration: positiveBigInt(participant.objectGeneration, 'object generation').toString(),
         authorityOwnerGeneration: positiveBigInt(participant.authorityOwnerGeneration, 'authority owner generation').toString()
-    })).sort((left, right) => left.key.localeCompare(right.key));
+    }))
+        .sort((left, right) => left.key.localeCompare(right.key));
     if (new Set(identities.map(({ key }) => key)).size !== identities.length) {
         throw new TypeError('Relocation participants must have unique keys.');
     }
     const canonicalMemberships = encodeMemberships(memberships, participants);
-    return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify({
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(JSON.stringify({
         participants: identities,
         memberships: canonicalMemberships
-    }), 'utf8').digest('hex');
+    }), 'utf8')
+        .digest('hex');
 }
 function encodeAuthorityEnvelope(base, publication) {
     const checksum = safeInteger(publication.checksumCrc32c, 'relocation checksum');
@@ -691,8 +721,8 @@ function encodeAuthorityEnvelope(base, publication) {
     }
     const aggregateGeneration = positiveBigInt(publication.aggregateGeneration, 'aggregate generation');
     const targetOwnerLeaseGeneration = positiveBigInt(publication.targetOwnerLeaseGeneration, 'target owner lease generation');
-    if (aggregateGeneration > 0x7fffffffffffffffn
-        || targetOwnerLeaseGeneration > 0x7fffffffffffffffn) {
+    if (aggregateGeneration > 0x7fffffffffffffffn ||
+        targetOwnerLeaseGeneration > 0x7fffffffffffffffn) {
         throw new TypeError('Relocation publication generations must fit signed 64-bit storage.');
     }
     const payload = Buffer.concat([
@@ -727,11 +757,11 @@ function decodeAuthorityEnvelope(payload) {
         const targetOwnerId = requireText(reader.text16(), 'target owner id');
         const targetOwnerLeaseGeneration = reader.i64();
         const base = reader.bytes32();
-        if (!reader.done
-            || aggregateGeneration === 0n
-            || aggregateGeneration > 0x7fffffffffffffffn
-            || inventoryDigestBytes.byteLength !== 32
-            || targetOwnerLeaseGeneration <= 0n) {
+        if (!reader.done ||
+            aggregateGeneration === 0n ||
+            aggregateGeneration > 0x7fffffffffffffffn ||
+            inventoryDigestBytes.byteLength !== 32 ||
+            targetOwnerLeaseGeneration <= 0n) {
             return undefined;
         }
         return {
@@ -753,15 +783,17 @@ function decodeAuthorityEnvelope(payload) {
 }
 function encodeMemberships(memberships, participants) {
     validateMemberships(memberships, participants);
-    return memberships.map(membership => ({
+    return memberships
+        .map((membership) => ({
         actorKey: requireText(membership.actorKey, 'membership actor key'),
         spotKey: requireText(membership.spotKey, 'membership spot key'),
         spotObjectGeneration: positiveBigInt(membership.spotObjectGeneration, 'membership Spot generation').toString(),
         membershipEpoch: positiveBigInt(membership.membershipEpoch, 'membership epoch').toString()
-    })).sort((left, right) => left.actorKey.localeCompare(right.actorKey));
+    }))
+        .sort((left, right) => left.actorKey.localeCompare(right.actorKey));
 }
 function validateMemberships(memberships, participants) {
-    const byKey = new Map(participants.map(participant => [participant.key, participant]));
+    const byKey = new Map(participants.map((participant) => [participant.key, participant]));
     const actorKeys = new Set();
     for (const membership of memberships) {
         const actorKey = requireText(membership.actorKey, 'membership actor key');
@@ -774,9 +806,10 @@ function validateMemberships(memberships, participants) {
             throw new TypeError('Relocation membership must reference an Actor participant.');
         }
         const spot = byKey.get(requireText(membership.spotKey, 'membership spot key'));
-        if (spot !== undefined
-            && (spot.objectKind !== 'user_spot'
-                || spot.objectGeneration !== positiveBigInt(membership.spotObjectGeneration, 'membership Spot generation'))) {
+        if (spot !== undefined &&
+            (spot.objectKind !== 'user_spot' ||
+                spot.objectGeneration !==
+                    positiveBigInt(membership.spotObjectGeneration, 'membership Spot generation'))) {
             throw new TypeError('Relocation membership Spot fence does not match its participant.');
         }
         positiveBigInt(membership.membershipEpoch, 'membership epoch');
@@ -804,8 +837,8 @@ function requireText(value, label) {
 }
 function canonicalUuid(value, label) {
     const text = requireText(value, label);
-    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u.test(text)
-        || /^0{8}-0{4}-0{4}-0{4}-0{12}$/u.test(text)) {
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u.test(text) ||
+        /^0{8}-0{4}-0{4}-0{4}-0{12}$/u.test(text)) {
         throw new TypeError(`${label} must be a lowercase non-zero 128-bit identity.`);
     }
     return text;
@@ -849,9 +882,14 @@ function i64le(value) {
 function dotnetGuidBytes(value) {
     const canonical = Buffer.from(value.replaceAll('-', ''), 'hex');
     return Buffer.from([
-        canonical[3], canonical[2], canonical[1], canonical[0],
-        canonical[5], canonical[4],
-        canonical[7], canonical[6],
+        canonical[3],
+        canonical[2],
+        canonical[1],
+        canonical[0],
+        canonical[5],
+        canonical[4],
+        canonical[7],
+        canonical[6],
         ...canonical.subarray(8)
     ]);
 }
@@ -860,13 +898,18 @@ function canonicalUuidFromDotnetBytes(value) {
     if (bytes.byteLength !== 16)
         throw new TypeError('Relocation aggregate id is invalid.');
     const canonical = Buffer.from([
-        bytes[3], bytes[2], bytes[1], bytes[0],
-        bytes[5], bytes[4],
-        bytes[7], bytes[6],
+        bytes[3],
+        bytes[2],
+        bytes[1],
+        bytes[0],
+        bytes[5],
+        bytes[4],
+        bytes[7],
+        bytes[6],
         ...bytes.subarray(8)
     ]).toString('hex');
-    return `${canonical.slice(0, 8)}-${canonical.slice(8, 12)}-${canonical.slice(12, 16)}`
-        + `-${canonical.slice(16, 20)}-${canonical.slice(20)}`;
+    return (`${canonical.slice(0, 8)}-${canonical.slice(8, 12)}-${canonical.slice(12, 16)}` +
+        `-${canonical.slice(16, 20)}-${canonical.slice(20)}`);
 }
 class CanonicalReader {
     bytes;

package/dist/runtime/foundation/service-runtime-contracts.js

@@ -43,11 +43,11 @@ exports.OperationKind = Object.freeze({
     UserSpotClose: 14
 });
 function operationRequiresReply(operationKind) {
-    return operationKind === exports.OperationKind.NodeRequest
-        || operationKind === exports.OperationKind.ChannelRequest
-        || operationKind === exports.OperationKind.SpotRequest
-        || operationKind === exports.OperationKind.ActorRequest
-        || operationKind === exports.OperationKind.InstanceSpotRequest;
+    return (operationKind === exports.OperationKind.NodeRequest ||
+        operationKind === exports.OperationKind.ChannelRequest ||
+        operationKind === exports.OperationKind.SpotRequest ||
+        operationKind === exports.OperationKind.ActorRequest ||
+        operationKind === exports.OperationKind.InstanceSpotRequest);
 }
 exports.ActorLifecycleKind = Object.freeze({
     Created: 1,

package/dist/runtime/foundation/service-session-binding-ingress-port.d.ts

@@ -16,6 +16,7 @@ export interface ServiceSessionBindingAdmissionClaim {
 }
 export type ServiceSessionBindingAdmissionResult = 'passThrough' | 'retained' | 'rejected';
 export interface ServiceSessionBindingIngressPort {
+    actorSlot(actorId: string, sessionRid: string): Promise<number | undefined>;
     retainOutbound(claim: ServiceSessionBindingAdmissionClaim, delivery: ServiceSessionBindingRetainedDelivery): Promise<ServiceSessionBindingAdmissionResult>;
     clearOutbound(actorId: string, error: unknown): Promise<void>;
 }

package/dist/runtime/foundation/service-stateful-registry.js

@@ -83,10 +83,10 @@ class ServiceStatefulRegistry {
         requirePositive(ref.generation, 'spot.generation');
         requireText(stableType, 'stableType');
         requirePositive(authorityOwnerGeneration, 'authorityOwnerGeneration');
-        if (kind === 'entry'
-            && (ref.spotId !== this.nodeRid
-                || ref.generation !== this.nodeGeneration
-                || stableType !== 'entry')) {
+        if (kind === 'entry' &&
+            (ref.spotId !== this.nodeRid ||
+                ref.generation !== this.nodeGeneration ||
+                stableType !== 'entry')) {
             throw new TypeError('Entry Spot identity is fixed by the owning node lifecycle.');
         }
         const current = this.spots.get(ref.spotId);
@@ -108,7 +108,9 @@ class ServiceStatefulRegistry {
     }
     requireSpotCore(ref) {
         const current = this.spots.get(ref.spotId);
-        if (current === undefined || current.ref.generation !== ref.generation || current.state !== 'ready') {
+        if (current === undefined ||
+            current.ref.generation !== ref.generation ||
+            current.state !== 'ready') {
             throw new ServiceStaleGenerationError('spot', ref.spotId);
         }
         return current;
@@ -118,8 +120,7 @@ class ServiceStatefulRegistry {
         if (current.kind === 'entry')
             return false;
         for (const actor of this.actors.values()) {
-            if (actor.spot.spotId === ref.spotId
-                && actor.spot.generation === ref.generation) {
+            if (actor.spot.spotId === ref.spotId && actor.spot.generation === ref.generation) {
                 return false;
             }
         }
@@ -193,9 +194,9 @@ class ServiceStatefulRegistry {
     }
     requireActorCore(ref) {
         const current = this.actors.get(ref.actorId);
-        if (current === undefined
-            || current.ref.generation !== ref.generation
-            || current.ref.nodeRid !== ref.nodeRid) {
+        if (current === undefined ||
+            current.ref.generation !== ref.generation ||
+            current.ref.nodeRid !== ref.nodeRid) {
             throw new ServiceStaleGenerationError('actor', ref.actorId);
         }
         return current;
@@ -256,12 +257,12 @@ class ServiceStatefulRegistry {
         this.requireActorCore(binding.actor);
         requirePositive(binding.bindingGeneration, 'bindingGeneration');
         const current = this.bindings.get(actorKey(binding.actor));
-        if (current !== undefined
-            && current.sessionOwnerNodeRid === binding.sessionOwnerNodeRid
-            && current.sessionOwnerNodeGeneration === binding.sessionOwnerNodeGeneration
-            && current.sessionOwnerId === binding.sessionOwnerId
-            && current.sessionOwnerLeaseGeneration === binding.sessionOwnerLeaseGeneration
-            && current.bindingGeneration >= binding.bindingGeneration) {
+        if (current !== undefined &&
+            current.sessionOwnerNodeRid === binding.sessionOwnerNodeRid &&
+            current.sessionOwnerNodeGeneration === binding.sessionOwnerNodeGeneration &&
+            current.sessionOwnerId === binding.sessionOwnerId &&
+            current.sessionOwnerLeaseGeneration === binding.sessionOwnerLeaseGeneration &&
+            current.bindingGeneration >= binding.bindingGeneration) {
             throw new ServiceStaleGenerationError('binding', binding.actor.actorId);
         }
         this.nextBindingGeneration = max(this.nextBindingGeneration, binding.bindingGeneration + 1n);
@@ -279,10 +280,10 @@ class ServiceStatefulRegistry {
         const binding = this.bindings.get(key);
         if (binding === undefined)
             return false;
-        if (binding.bindingGeneration !== expectedBindingGeneration
-            || expectedSessionRid !== undefined && binding.sessionRid !== expectedSessionRid
-            || expectedSessionOwnerNodeRid !== undefined
-                && binding.sessionOwnerNodeRid !== expectedSessionOwnerNodeRid) {
+        if (binding.bindingGeneration !== expectedBindingGeneration ||
+            (expectedSessionRid !== undefined && binding.sessionRid !== expectedSessionRid) ||
+            (expectedSessionOwnerNodeRid !== undefined &&
+                binding.sessionOwnerNodeRid !== expectedSessionOwnerNodeRid)) {
             throw new ServiceStaleGenerationError('binding', actor.actorId);
         }
         this.bindings.delete(key);
@@ -324,8 +325,8 @@ class ServiceStatefulRegistry {
                     : { kind: 'typeMismatch' };
             }
             const assigned = this.spotTypes.get(key);
-            if (assigned !== undefined
-                && (assigned.kind !== expectedKind || assigned.stableType !== stableType)) {
+            if (assigned !== undefined &&
+                (assigned.kind !== expectedKind || assigned.stableType !== stableType)) {
                 return { kind: 'typeMismatch' };
             }
         }
@@ -376,7 +377,7 @@ class ServiceStatefulRegistry {
         requireText(owner, 'owner');
         const previous = this.turns.get(owner) ?? Promise.resolve();
         let release;
-        const barrier = new Promise(resolve => {
+        const barrier = new Promise((resolve) => {
             release = resolve;
         });
         const tail = previous.then(() => barrier);

package/dist/runtime/foundation/service-stateful-runtime.d.ts

@@ -1,3 +1,4 @@
+import type { ZLinkDispatchErrorReporter } from '../channels/dispatch-error-reporter';
 import type { RawServiceMeshRuntime } from './raw-service-mesh-runtime';
 import { type ReceiveKindData, type StreamSessionActorAuthorityFence } from './service-runtime-contracts';
 import type { ServiceMailboxRecord } from './service-mailbox';
@@ -221,6 +222,8 @@ export declare class ServiceStatefulRuntime {
     private userSpotOperationHandler?;
     private messageFollowHandler?;
     private mailboxDropHandler?;
+    private dispatchErrors?;
+    private dispatchErrorMeshName?;
     private readonly admittedUserSpotOperations;
     private readonly pendingInstanceActivations;
     private closed;
@@ -229,6 +232,7 @@ export declare class ServiceStatefulRuntime {
         readonly kind: 'spot_multicast' | 'actor_control' | 'actor_binding';
         readonly owner: string;
     }) => void): void;
+    setDispatchErrorReporter(reporter: ZLinkDispatchErrorReporter, meshName: string): void;
     createSpot(routingId?: string, kind?: 'user' | 'instance', stableType?: "user" | "instance"): ServiceSpotState;
     restoreUserSpotAuthority(spotId: string, stableType: string, generation: bigint, authorityOwnerGeneration: bigint): ServiceSpotState;
     restoreSpotAuthority(spotId: string, objectKind: 'user_spot' | 'instance_spot', stableType: string, generation: bigint, authorityOwnerGeneration: bigint): ServiceSpotState;