@kronos-ts/axon-server 0.5.0 → 0.6.0

package/dist/shutdown-latch.js

@@ -5,8 +5,10 @@ export class ShutdownInProgressError extends Error {
     }
 }
 export function shutdownLatch() {
+    const callbacks = new Set();
     let activeCount = 0;
     let shuttingDown = false;
+    let drainPromise;
     let drainResolve = null;
     function checkDrained() {
         if (shuttingDown && activeCount === 0 && drainResolve) {
@@ -15,6 +17,13 @@ export function shutdownLatch() {
         }
     }
     return {
+        onShutdown(callback) {
+            if (shuttingDown)
+                callback();
+            else
+                callbacks.add(callback);
+            return () => { callbacks.delete(callback); };
+        },
         registerActivity() {
             if (shuttingDown) {
                 throw new ShutdownInProgressError();
@@ -33,12 +42,22 @@ export function shutdownLatch() {
         },
         initiateShutdown() {
             shuttingDown = true;
+            for (const callback of callbacks) {
+                try {
+                    callback();
+                }
+                catch (error) {
+                    console.error("Messaging shutdown callback failed", error);
+                }
+            }
+            callbacks.clear();
             if (activeCount === 0) {
                 return Promise.resolve();
             }
-            return new Promise((resolve) => {
+            drainPromise ??= new Promise((resolve) => {
                 drainResolve = resolve;
             });
+            return drainPromise;
         },
         get shuttingDown() {
             return shuttingDown;

package/dist/shutdown-latch.js.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown-latch.js","sourceRoot":"","sources":["../src/shutdown-latch.ts"],"names":[],"mappings":"AAsCA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,GAAW,sBAAsB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,YAAY,GAAwB,IAAI,CAAA;IAE5C,SAAS,YAAY;QACnB,IAAI,YAAY,IAAI,WAAW,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;YACtD,YAAY,EAAE,CAAA;YACd,YAAY,GAAG,IAAI,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,gBAAgB;YACd,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,uBAAuB,EAAE,CAAA;YACrC,CAAC;YAED,WAAW,EAAE,CAAA;YACb,IAAI,KAAK,GAAG,KAAK,CAAA;YAEjB,OAAO;gBACL,GAAG;oBACD,IAAI,KAAK;wBAAE,OAAM;oBACjB,KAAK,GAAG,IAAI,CAAA;oBACZ,WAAW,EAAE,CAAA;oBACb,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAA;QACH,CAAC;QAED,gBAAgB;YACd,YAAY,GAAG,IAAI,CAAA;YAEnB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YAC1B,CAAC;YAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,YAAY,GAAG,OAAO,CAAA;YACxB,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,IAAI,WAAW;YACb,OAAO,WAAW,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"shutdown-latch.js","sourceRoot":"","sources":["../src/shutdown-latch.ts"],"names":[],"mappings":"AAuCA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,GAAW,sBAAsB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IACvC,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,YAAuC,CAAA;IAC3C,IAAI,YAAY,GAAwB,IAAI,CAAA;IAE5C,SAAS,YAAY;QACnB,IAAI,YAAY,IAAI,WAAW,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;YACtD,YAAY,EAAE,CAAA;YACd,YAAY,GAAG,IAAI,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,CAAC,QAAQ;YACjB,IAAI,YAAY;gBAAE,QAAQ,EAAE,CAAA;;gBACvB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC5B,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;QAC7C,CAAC;QACD,gBAAgB;YACd,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,uBAAuB,EAAE,CAAA;YACrC,CAAC;YAED,WAAW,EAAE,CAAA;YACb,IAAI,KAAK,GAAG,KAAK,CAAA;YAEjB,OAAO;gBACL,GAAG;oBACD,IAAI,KAAK;wBAAE,OAAM;oBACjB,KAAK,GAAG,IAAI,CAAA;oBACZ,WAAW,EAAE,CAAA;oBACb,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAA;QACH,CAAC;QAED,gBAAgB;YACd,YAAY,GAAG,IAAI,CAAA;YACnB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBAAC,QAAQ,EAAE,CAAA;gBAAC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAAC,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;gBAAC,CAAC;YACjG,CAAC;YACD,SAAS,CAAC,KAAK,EAAE,CAAA;YAEjB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YAC1B,CAAC;YAED,YAAY,KAAK,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBACvC,YAAY,GAAG,OAAO,CAAA;YACxB,CAAC,CAAC,CAAA;YACF,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,IAAI,WAAW;YACb,OAAO,WAAW,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/stream-recovery.d.ts

@@ -0,0 +1,9 @@
+import type { ResilienceConfig } from "./resilience.js";
+/** Retry failures of the async stream, not just synchronous stream creation. */
+export declare function streamRecovery(reopen: () => void, canReconnect: () => boolean, config?: Partial<ResilienceConfig>): {
+    failed: (error: unknown) => void;
+    received(): void;
+    restart(): void;
+    stop(): void;
+};
+//# sourceMappingURL=stream-recovery.d.ts.map

package/dist/stream-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-recovery.d.ts","sourceRoot":"","sources":["../src/stream-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,IAAI,EAClB,YAAY,EAAE,MAAM,OAAO,EAC3B,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;oBAcf,OAAO;;;;EAmD/B"}

package/dist/stream-recovery.js

@@ -0,0 +1,70 @@
+/** Retry failures of the async stream, not just synchronous stream creation. */
+export function streamRecovery(reopen, canReconnect, config = {}) {
+    const log = (message) => {
+        try {
+            ;
+            (config.log ?? console.warn)(message);
+        }
+        catch {
+            /* Diagnostics cannot prevent recovery. */
+        }
+    };
+    let timer;
+    let stopped = false;
+    let attempts = 0;
+    let openedAt = Date.now();
+    function failed(error) {
+        if (stopped || timer || !canReconnect())
+            return;
+        if (config.isRetryable?.(error) === false || attempts >= (config.maxAttempts ?? 30)) {
+            log(`Provider stream recovery exhausted: ${String(error)}`);
+            return;
+        }
+        // Keep a positive floor even when jitter is zero. An immediately-ended
+        // async generator must never create a microtask reconnect loop.
+        const cap = Math.min((config.initialDelayMs ?? 100) * (config.multiplier ?? 2) ** attempts++, config.maxDelayMs ?? 30000);
+        const delay = Math.max(1, cap * (0.5 + Math.random() * 0.5));
+        log(`Provider stream failed; reconnecting in ${Math.round(delay)}ms: ${String(error)}`);
+        timer = setTimeout(() => {
+            timer = undefined;
+            if (stopped || !canReconnect())
+                return;
+            openedAt = Date.now();
+            try {
+                reopen();
+            }
+            catch (error) {
+                failed(error);
+            }
+        }, delay);
+        timer.unref?.();
+    }
+    return {
+        failed,
+        received() {
+            // Subscription acknowledgements alone do not prove a stable connection.
+            if (Date.now() - openedAt >= 30000)
+                attempts = 0;
+        },
+        restart() {
+            if (stopped || !canReconnect())
+                return;
+            clearTimeout(timer);
+            timer = undefined;
+            attempts = 0;
+            openedAt = Date.now();
+            try {
+                reopen();
+            }
+            catch (error) {
+                failed(error);
+            }
+        },
+        stop() {
+            stopped = true;
+            clearTimeout(timer);
+            timer = undefined;
+        },
+    };
+}
+//# sourceMappingURL=stream-recovery.js.map

package/dist/stream-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-recovery.js","sourceRoot":"","sources":["../src/stream-recovery.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAC5B,MAAkB,EAClB,YAA2B,EAC3B,MAAM,GAA8B,EAAE;IAEtC,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,CAAC;YAAA,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC,CAAA;IACD,IAAI,KAAgD,CAAA;IACpD,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAEzB,SAAS,MAAM,CAAC,KAAc;QAC5B,IAAI,OAAO,IAAI,KAAK,IAAI,CAAC,YAAY,EAAE;YAAE,OAAM;QAC/C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC;YACpF,GAAG,CAAC,uCAAuC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC3D,OAAM;QACR,CAAC;QACD,uEAAuE;QACvE,gEAAgE;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAClB,CAAC,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,QAAQ,EAAE,EACvE,MAAM,CAAC,UAAU,IAAI,KAAK,CAC3B,CAAA;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;QAC5D,GAAG,CAAC,2CAA2C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACvF,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,SAAS,CAAA;YACjB,IAAI,OAAO,IAAI,CAAC,YAAY,EAAE;gBAAE,OAAM;YACtC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACrB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAA;YACV,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAA;YACf,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,CAAA;QACT,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACjB,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ;YACN,wEAAwE;YACxE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,KAAK;gBAAE,QAAQ,GAAG,CAAC,CAAA;QAClD,CAAC;QACD,OAAO;YACL,IAAI,OAAO,IAAI,CAAC,YAAY,EAAE;gBAAE,OAAM;YACtC,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,KAAK,GAAG,SAAS,CAAA;YACjB,QAAQ,GAAG,CAAC,CAAA;YACZ,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACrB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAA;YACV,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAA;YACf,CAAC;QACH,CAAC;QACD,IAAI;YACF,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,KAAK,GAAG,SAAS,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-ts/axon-server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Axon Server extension for Kronos — event store and command bus over Axon Server.",
   "license": "Apache-2.0",
   "type": "module",
@@ -49,7 +49,7 @@
     }
   },
   "dependencies": {
-    "@kronos-ts/core": "0.3.0",
+    "@kronos-ts/core": "0.4.0",
     "@bufbuild/protobuf": "^2.3",
     "@grpc/grpc-js": "^1.12",
     "nice-grpc": "^2.1",

package/src/axon-server-event-store.ts

@@ -11,7 +11,7 @@ import type {
   SequencedEvent,
   StreamingCondition,
 } from "@kronos-ts/core"
-import { messageStream, compileQuery } from "@kronos-ts/core"
+import { compileQuery } from "@kronos-ts/core"
 import type {
   EventStore,
   SourcingResult,
@@ -25,6 +25,7 @@ import { globalSequenceToken, FIRST_TOKEN } from "@kronos-ts/core"
 import { markerAt, noMarker } from "@kronos-ts/core"
 import type { AxonServerStoreSource } from "./connection.js"
 import { contextView } from "./context-view.js"
+import { boundedRead } from "./bounded-read.js"
 import type {
   Criterion,
   TagsAndNamesCriterion,
@@ -178,69 +179,59 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
   const { connection, serializer, metadata: createAxonMetadata } = contextView(conn, context)
   const { eventToProto, eventFromProto } = createEventConverters(serializer)
 
-  // Push-based subscriber registry (EventBus.subscribe contract). Axon Server's
-  // own distribution is the server-side Stream RPC (see open()); these in-process
-  // subscribers are notified best-effort on every successful local append.
-  const subscribers = new Set<(events: ReadonlyArray<EventMessage>) => Promise<void>>()
-  async function notifySubscribers(events: ReadonlyArray<EventMessage>): Promise<void> {
-    for (const sub of subscribers) {
-      try {
-        await sub(events)
-      } catch {
-        /* ignore subscriber errors */
-      }
-    }
-  }
-
-  return {
-    async source(condition: SourcingCondition): Promise<SourcingResult> {
-      const criterions = criteriaToCriterions(compileQuery(condition.query))
-      const start = condition.start ?? 0n
-
-      const request = {
-        fromSequence: start,
-        criterion: criterions,
-      }
+  async function sourceOnce(condition: SourcingCondition, signal: AbortSignal): Promise<SourcingResult> {
+    const criterions = criteriaToCriterions(compileQuery(condition.query))
+    const start = condition.start ?? 0n
 
-      const events: EventMessage[] = []
-      let marker: ConsistencyMarker = noMarker()
+    const request = {
+      fromSequence: start,
+      criterion: criterions,
+    }
 
-      try {
-        const stream = connection.eventStore.source(request, { metadata: createAxonMetadata() })
-        for await (const response of stream) {
-          if (response.event) {
-            const taggedEvent = response.event
-            const protoEvent = taggedEvent.event
-            if (protoEvent) {
-              // DCB source/stream responses carry no tags — the server indexes
-              // them write-side but does not echo them back (SequencedEvent has
-              // only sequence + event). Reconstructed events get empty tags.
-              events.push(eventFromProto(protoEvent, []))
-            }
-          }
-          if (response.consistencyMarker !== undefined) {
-            marker = markerAt(response.consistencyMarker)
+    const events: EventMessage[] = []
+    let marker: ConsistencyMarker = noMarker()
+
+    try {
+      const stream = connection.eventStore.source(request, { metadata: createAxonMetadata(), signal })
+      for await (const response of stream) {
+        if (response.event) {
+          const taggedEvent = response.event
+          const protoEvent = taggedEvent.event
+          if (protoEvent) {
+            // DCB source/stream responses carry no tags — the server indexes
+            // them write-side but does not echo them back (SequencedEvent has
+            // only sequence + event). Reconstructed events get empty tags.
+            events.push(eventFromProto(protoEvent, []))
           }
         }
-      } catch (err) {
-        // READING PAST THE HEAD IS AN EMPTY ANSWER, NOT AN ERROR — and Axon
-        // Server disagrees, so this is where the two vocabularies are
-        // reconciled. `Source` fails OUT_OF_RANGE with "Start sequence cannot
-        // be larger than end sequence" whenever `fromSequence` is beyond the
-        // global head, which is the ORDINARY STEADY STATE of a snapshotted
-        // load: an entry written at the head means the very next read resumes
-        // at head + 1 and legitimately finds nothing.
-        //
-        // The marker is `start - 1`, and it is exact rather than conservative:
-        // the caller has already accounted for everything up to there (that is
-        // what asking to start later MEANS), and nothing can exist after it or
-        // the server would not have refused. So an append conditioned on this
-        // read is checked against precisely the range that was read.
-        if (!isStartPastHead(err)) throw err
-        return { events: [], marker: start > 0n ? markerAt(start - 1n) : noMarker() }
+        if (response.consistencyMarker !== undefined) {
+          marker = markerAt(response.consistencyMarker)
+        }
       }
+    } catch (err) {
+      // READING PAST THE HEAD IS AN EMPTY ANSWER, NOT AN ERROR — and Axon
+      // Server disagrees, so this is where the two vocabularies are
+      // reconciled. `Source` fails OUT_OF_RANGE with "Start sequence cannot
+      // be larger than end sequence" whenever `fromSequence` is beyond the
+      // global head, which is the ORDINARY STEADY STATE of a snapshotted
+      // load: an entry written at the head means the very next read resumes
+      // at head + 1 and legitimately finds nothing.
+      //
+      // The marker is `start - 1`, and it is exact rather than conservative:
+      // the caller has already accounted for everything up to there (that is
+      // what asking to start later MEANS), and nothing can exist after it or
+      // the server would not have refused. So an append conditioned on this
+      // read is checked against precisely the range that was read.
+      if (!isStartPastHead(err)) throw err
+      return { events: [], marker: start > 0n ? markerAt(start - 1n) : noMarker() }
+    }
+
+    return { events, marker }
+  }
 
-      return { events, marker }
+  return {
+    source(condition: SourcingCondition): Promise<SourcingResult> {
+      return boundedRead(connection.config.readTimeoutMs, (signal) => sourceOnce(condition, signal))
     },
 
     async appendEvents(
@@ -271,7 +262,6 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
             metadata: createAxonMetadata(),
           })
           responseMarker = response.consistencyMarker
-          await notifySubscribers(newEvents)
         },
         async afterCommit() {
           return markerAt(responseMarker ?? 0n)
@@ -299,7 +289,20 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
         criterion: criterions,
       }
 
-      const grpcStream = connection.eventStore.stream(request, { metadata: createAxonMetadata() })
+      // `close()` must reach the server. This is a server-streaming call: the
+      // client sends nothing after the request, so the only way to end it from
+      // this side is to cancel it. Abandoning the async iterator does not do
+      // that — the `for await` below stays parked on the call until the next
+      // event arrives, which at the head of a quiet stream is never, and every
+      // closed stream leaves a live call behind on the server. With enough of
+      // them open, Axon Server stops answering later `source` reads (a 2-CPU
+      // container gets there after a handful): handlers never reply, and
+      // commands die at the server's own timeout.
+      const cancel = new AbortController()
+      const grpcStream = connection.eventStore.stream(request, {
+        metadata: createAxonMetadata(),
+        signal: cancel.signal,
+      })
 
       // Internal buffer for events pulled from the gRPC stream
       const buffer: SequencedEvent[] = []
@@ -328,7 +331,11 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
           completed = true
           availableCallback?.()
         } catch (err) {
-          streamError = err instanceof Error ? err : new Error(String(err))
+          // Our own cancellation surfaces here as an AbortError; that is the
+          // stream closing as asked, not a failure to report.
+          if (!completed) {
+            streamError = err instanceof Error ? err : new Error(String(err))
+          }
           completed = true
           availableCallback?.()
         }
@@ -336,7 +343,7 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
 
       startReading()
 
-      return messageStream<SequencedEvent>({
+      return {
         next() {
           return buffer.shift()
         },
@@ -364,13 +371,15 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
         close() {
           completed = true
           availableCallback = null
-          // gRPC stream will be cancelled when the async iterator is abandoned
+          cancel.abort()
         },
-      })
+      }
     },
 
     async getHeadPosition(): Promise<bigint> {
-      const response = await connection.eventStore.getHead({}, { metadata: createAxonMetadata() })
+      const response = await boundedRead(connection.config.readTimeoutMs, (signal) =>
+        connection.eventStore.getHead({}, { metadata: createAxonMetadata(), signal }),
+      )
       return response.sequence
     },
 
@@ -379,21 +388,10 @@ export function axonServerEventStore(conn: AxonServerStoreSource, context: strin
     },
 
     async latestToken(): Promise<TrackingToken> {
-      const response = await connection.eventStore.getHead({}, { metadata: createAxonMetadata() })
+      const response = await boundedRead(connection.config.readTimeoutMs, (signal) =>
+        connection.eventStore.getHead({}, { metadata: createAxonMetadata(), signal }),
+      )
       return globalSequenceToken(response.sequence)
     },
-
-    // EventBus contract — publish = append without condition, then notify
-    // in-process subscribers.
-    async publish(events: ReadonlyArray<EventMessage>): Promise<void> {
-      await this.append(events)
-    },
-
-    subscribe(handler: (events: ReadonlyArray<EventMessage>) => Promise<void>): () => void {
-      subscribers.add(handler)
-      return () => {
-        subscribers.delete(handler)
-      }
-    },
   }
 }

package/src/axon-server-snapshotting-event-store.ts

@@ -25,7 +25,7 @@
 import type {
   EventStore,
   Snapshot,
-  SnapshotCapability,
+  SnapshotStoreCapability,
   SourcingCondition,
   SourcingResult,
 } from "@kronos-ts/core"
@@ -33,6 +33,7 @@ import type { Serializer } from "@kronos-ts/core"
 import { withoutSnapshotKey } from "@kronos-ts/core"
 import type { AxonServerStoreSource } from "./connection.js"
 import { contextView } from "./context-view.js"
+import { boundedRead } from "./bounded-read.js"
 import type { Snapshot as ProtoSnapshot } from "./generated/dcb.js"
 
 // ---------------------------------------------------------------------------
@@ -92,7 +93,7 @@ function encodeKey(key: string): Uint8Array {
  * )
  * ```
  *
- * ADDITIVE, NOT COLLAPSING. It returns `E & SnapshotCapability` — the store you
+ * ADDITIVE, NOT COLLAPSING. It returns `E & SnapshotStoreCapability` — the store you
  * passed in, plus the write — so capabilities stack in either order and nothing
  * the inner store carried is laundered on the way through.
  *
@@ -111,16 +112,18 @@ export function axonServerSnapshottingEventStore<E extends EventStore>(
   next: E,
   conn: AxonServerStoreSource,
   context: string,
-): E & SnapshotCapability {
+): E & SnapshotStoreCapability {
   const { connection, serializer, metadata: createAxonMetadata } = contextView(conn, context)
   const { snapshotToProto, snapshotFromProto } = createSnapshotConverters(serializer)
 
   /** The cached fold filed under `key`, or nothing — the first of the two calls. */
   async function loadSnapshot(key: string): Promise<Snapshot | undefined> {
     try {
-      const response = await connection.snapshotStore.getLast(
-        { key: encodeKey(key) },
-        { metadata: createAxonMetadata() },
+      const response = await boundedRead(connection.config.readTimeoutMs, (signal) =>
+        connection.snapshotStore.getLast(
+          { key: encodeKey(key) },
+          { metadata: createAxonMetadata(), signal },
+        ),
       )
 
       if (!response.snapshot) {
@@ -187,5 +190,5 @@ export function axonServerSnapshottingEventStore<E extends EventStore>(
       const result = await next.source({ ...plain, start })
       return { ...result, snapshot }
     },
-  } as E & SnapshotCapability
+  } as E & SnapshotStoreCapability
 }