@kronos-ts/axon-server 0.4.0 → 0.6.0

package/dist/platform-service.js

@@ -10,7 +10,7 @@ import { toEventProcessorInfo } from "./event-processor-info.js";
  * 3. Receives instructions from Axon Server (split, merge, pause, resume)
  */
 export function platformConnection(connection, options) {
-    const heartbeatIntervalMs = options?.heartbeatIntervalMs ?? 10000;
+    const heartbeatIntervalMs = options?.heartbeatIntervalMs ?? 2500;
     const heartbeatTimeoutMs = options?.heartbeatTimeoutMs ?? 7500;
     const processorsNotificationRateMs = options?.processorsNotificationRateMs ?? 500;
     const processorsNotificationInitialDelayMs = options?.processorsNotificationInitialDelayMs ?? 5000;
@@ -30,12 +30,22 @@ export function platformConnection(connection, options) {
      */
     const pendingInstructions = [];
     let isConnected = false;
+    let monitoringArmed = false;
+    let recoveryTimer;
     let heartbeatTimer = null;
     let heartbeatTimeoutTimer = null;
+    let processorStatusInitialTimer;
     let processorStatusTimer = null;
     /** Guards against arming the status-report timer twice — see `startProcessorStatusReporting`. */
     let processorStatusArmed = false;
     let lastHeartbeatResponse = Date.now();
+    // Whether this server has EVER sent a heartbeat. Axon Server only beats at
+    // clients whose registered framework version it recognises (4.2.1+); a client
+    // it does not beat at cannot be judged by the silence — that judgement fell
+    // every window and tore down a healthy stream, every 10 s, in production.
+    // Dead-channel detection for a server that never beats is gRPC keepalive's
+    // job (see `connection.ts`), not this timer's.
+    let serverBeats = false;
     let outbound = null;
     /**
      * Latches once Axon Server sends its first inbound message after
@@ -50,13 +60,39 @@ export function platformConnection(connection, options) {
     if (connection.config.token) {
         grpcMetadata.set("AxonIQ-Access-Token", connection.config.token);
     }
-    async function processInboundInstructions(inbound) {
+    function scheduleRecovery() {
+        if (!monitoringArmed || recoveryTimer || connection.state === "closed" || connection.state === "reconnecting")
+            return;
+        recoveryTimer = setTimeout(() => {
+            recoveryTimer = undefined;
+            if (!monitoringArmed || connection.state === "closed")
+                return;
+            void connection.reconnect().catch((error) => console.error("Platform recovery failed", error));
+        }, connection.config.reconnectIntervalMs ?? 2000);
+    }
+    connection.onDisconnect?.(() => {
+        isConnected = false;
+        outbound?.close();
+    });
+    connection.onReconnect(() => {
+        if (!monitoringArmed)
+            return;
+        clearTimeout(recoveryTimer);
+        recoveryTimer = undefined;
+        isConnected = false;
+        openPlatformStream();
+    });
+    async function processInboundInstructions(inbound, stream) {
         try {
             for await (const message of inbound) {
+                if (stream !== outbound || !monitoringArmed)
+                    return;
                 // First inbound message after start() = the platform has accepted our
                 // registration and is talking back. Latch the ack flag (mirror of
                 // kronosdb Plan 09-03 / D-102 — replaces the legacy 1s sleep).
                 acked = true;
+                if (message.requestReconnect)
+                    scheduleRecovery();
                 // Parse instruction type
                 const instruction = parseInstruction(message);
                 if (instruction) {
@@ -74,18 +110,30 @@ export function platformConnection(connection, options) {
                         }
                     }
                 }
-                // Handle heartbeat response — track last response time for timeout detection
+                // A heartbeat from the server is BOTH the liveness signal this side
+                // tracks and a request: Axon Server measures client inactivity by the
+                // heartbeats it receives, so every one it sends is answered at once
+                // (what Axon Framework's connector does). Without the echo, the only
+                // activity the server ever sees is the periodic beat below.
                 if (message.heartbeat) {
+                    serverBeats = true;
                     lastHeartbeatResponse = Date.now();
+                    outbound?.send({ heartbeat: { clientId: connection.config.clientId }, instructionId: "" });
                 }
             }
         }
         catch (err) {
-            if (isConnected) {
+            if (stream === outbound && monitoringArmed && isConnected) {
                 console.error("Platform stream error:", err);
                 isConnected = false;
             }
         }
+        finally {
+            if (stream === outbound && monitoringArmed) {
+                isConnected = false;
+                scheduleRecovery();
+            }
+        }
     }
     function parseInstruction(message) {
         if (message.requestReconnect) {
@@ -137,9 +185,13 @@ export function platformConnection(connection, options) {
         heartbeatTimer = setInterval(() => {
             if (!isConnected || !outbound)
                 return;
-            // Check if last heartbeat response was too long ago
+            // Not before the server has acknowledged the registration: a heartbeat
+            // from a stream it has not filed yet is an error on its side, not a beat.
+            if (!acked)
+                return;
+            // Judge silence only from a server that has beaten before.
             const timeSinceLastResponse = Date.now() - lastHeartbeatResponse;
-            if (timeSinceLastResponse > heartbeatTimeoutMs) {
+            if (serverBeats && timeSinceLastResponse > heartbeatTimeoutMs) {
                 console.warn(`Platform heartbeat timeout: no response in ${timeSinceLastResponse}ms ` +
                     `(threshold: ${heartbeatTimeoutMs}ms). Marking connection as lost.`);
                 isConnected = false;
@@ -169,10 +221,11 @@ export function platformConnection(connection, options) {
         if (processorStatusTimer)
             clearInterval(processorStatusTimer);
         // Initial delay before first report
-        setTimeout(() => {
-            if (!isConnected)
+        processorStatusInitialTimer = setTimeout(() => {
+            if (!monitoringArmed)
                 return;
-            reportProcessorStatus();
+            if (isConnected)
+                void reportProcessorStatus();
             // Then report at the configured rate
             processorStatusTimer = setInterval(() => {
                 if (!isConnected || !outbound)
@@ -218,6 +271,7 @@ export function platformConnection(connection, options) {
         }
         // Re-arm the ack latch so a stop/start cycle correctly re-waits.
         acked = false;
+        serverBeats = false;
         outbound = outboundStream();
         // Register with Axon Server
         outbound.send({
@@ -238,7 +292,7 @@ export function platformConnection(connection, options) {
         // timeout, which is what the command/query buses hang their stream
         // re-establishment off. It belongs to every service, administered or not.
         startHeartbeat();
-        processInboundInstructions(inbound);
+        void processInboundInstructions(inbound, outbound);
         // Axon Server's PlatformService does NOT proactively emit an inbound
         // frame in response to `register` — the stream is held open silently
         // until either (a) the server pushes a topology / instruction event,
@@ -260,13 +314,19 @@ export function platformConnection(connection, options) {
     }
     return {
         async armConnectionMonitoring() {
+            monitoringArmed = true;
             openPlatformStream();
         },
         async start() {
+            monitoringArmed = true;
             openPlatformStream();
             startProcessorStatusReporting();
         },
         stop() {
+            monitoringArmed = false;
+            clearTimeout(processorStatusInitialTimer);
+            clearTimeout(recoveryTimer);
+            recoveryTimer = undefined;
             isConnected = false;
             // A stopped stream's un-routed backlog is stale — do not replay it if a
             // handler registers later.

package/dist/platform-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform-service.js","sourceRoot":"","sources":["../src/platform-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"platform-service.js","sourceRoot":"","sources":["../src/platform-service.ts"],"names":[],"mappings":"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"}

package/dist/resilience.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Connection resilience — PACKAGE-PRIVATE.
+ *
+ * Exponential backoff with full jitter, per-event attempt caps, terminal-error
+ * short-circuit, and a warn-then-continue health probe. Nothing here is
+ * exported from this package's barrel.
+ *
+ * It used to live in `@kronos-ts/core`, and it does not belong there. Core is
+ * only what cannot be a helper, and this is a helper by every test: it touches
+ * no core shape, no message, no unit of work — it is `setTimeout` and a loop
+ * over a function anybody could have written. Its only consumers were the
+ * transports and the pool, core's own `src/` never called it, and a helper
+ * lives with its users. Same reasoning that moved each persistence package's
+ * transaction glue out of core, applied one folder up.
+ *
+ * Each consuming package keeps its own copy, carrying only what it uses, so
+ * each can also state its own retry policy without negotiating with the others.
+ */
+/** Classified retry sites used by transport extensions (D-97). */
+export type RetryEvent = "initial-connect" | "reconnect" | "per-operation" | "health-check";
+export type ResilienceConfig = {
+    /** Initial backoff delay (ms). Default: 100. */
+    initialDelayMs: number;
+    /** Cap for backoff (ms). Default: 30_000. */
+    maxDelayMs: number;
+    /** Max retry attempts before giving up. Per-event defaults applied if not provided. */
+    maxAttempts: number;
+    /** Base for exponential growth. Default: 2. */
+    multiplier: number;
+    /** Health-check threshold (ms) before warn-then-continue. Default: 5000. */
+    healthCheckThresholdMs: number;
+    /** Optional logger. Defaults to console.warn. */
+    log?: (msg: string) => void;
+    /** Per-attempt classification: returns false to short-circuit (terminal error). */
+    isRetryable?: (err: unknown) => boolean;
+};
+/**
+ * Run `fn` with exponential-backoff full-jitter retries.
+ *
+ * Resolves with the first successful result, or rejects with the last error
+ * after `maxAttempts` exhausted. If `isRetryable(err)` returns false on any
+ * attempt, the error is rethrown immediately (terminal error short-circuit).
+ *
+ * D-101: opts may carry caller-supplied resilience overrides — this is the
+ * per-extension knob path (`kronosDbConnection({ resilience: { ... } })`).
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts: {
+    event: RetryEvent;
+} & Partial<ResilienceConfig>): Promise<T>;
+/**
+ * Run a health-check probe with warn-then-continue semantics (D-100).
+ *
+ * Resolves WITHOUT throwing on success OR after `thresholdMs` elapses with
+ * the probe still pending — production loops should NEVER stall on a flaky
+ * health probe. Failures (rejection or threshold breach) emit a single warn
+ * via `log` and otherwise resolve normally.
+ */
+export declare function healthCheck(fn: () => Promise<void>, opts?: {
+    thresholdMs?: number;
+    log?: (msg: string) => void;
+}): Promise<void>;
+//# sourceMappingURL=resilience.d.ts.map

package/dist/resilience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../src/resilience.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,WAAW,GACX,eAAe,GACf,cAAc,CAAA;AAElB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAA;IACtB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,sBAAsB,EAAE,MAAM,CAAA;IAC9B,iDAAiD;IACjD,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,mFAAmF;IACnF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CACxC,CAAA;AAoCD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,GACtD,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC/D,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/resilience.js

@@ -0,0 +1,103 @@
+/**
+ * Connection resilience — PACKAGE-PRIVATE.
+ *
+ * Exponential backoff with full jitter, per-event attempt caps, terminal-error
+ * short-circuit, and a warn-then-continue health probe. Nothing here is
+ * exported from this package's barrel.
+ *
+ * It used to live in `@kronos-ts/core`, and it does not belong there. Core is
+ * only what cannot be a helper, and this is a helper by every test: it touches
+ * no core shape, no message, no unit of work — it is `setTimeout` and a loop
+ * over a function anybody could have written. Its only consumers were the
+ * transports and the pool, core's own `src/` never called it, and a helper
+ * lives with its users. Same reasoning that moved each persistence package's
+ * transaction glue out of core, applied one folder up.
+ *
+ * Each consuming package keeps its own copy, carrying only what it uses, so
+ * each can also state its own retry policy without negotiating with the others.
+ */
+const DEFAULTS = {
+    initialDelayMs: 100,
+    maxDelayMs: 30_000,
+    maxAttempts: 10,
+    multiplier: 2,
+    healthCheckThresholdMs: 5_000,
+};
+const ATTEMPTS_BY_EVENT = {
+    "initial-connect": 10,
+    "reconnect": 30,
+    "per-operation": 5,
+    "health-check": 3,
+};
+function resolveConfig(event, partial) {
+    return {
+        ...DEFAULTS,
+        maxAttempts: ATTEMPTS_BY_EVENT[event],
+        ...partial,
+    };
+}
+function fullJitterDelay(attempt, cfg) {
+    const exponential = Math.min(cfg.initialDelayMs * Math.pow(cfg.multiplier, attempt), cfg.maxDelayMs);
+    return Math.random() * exponential;
+}
+/**
+ * Run `fn` with exponential-backoff full-jitter retries.
+ *
+ * Resolves with the first successful result, or rejects with the last error
+ * after `maxAttempts` exhausted. If `isRetryable(err)` returns false on any
+ * attempt, the error is rethrown immediately (terminal error short-circuit).
+ *
+ * D-101: opts may carry caller-supplied resilience overrides — this is the
+ * per-extension knob path (`kronosDbConnection({ resilience: { ... } })`).
+ */
+export async function withRetry(fn, opts) {
+    const cfg = resolveConfig(opts.event, opts);
+    let lastErr;
+    for (let attempt = 0; attempt < cfg.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+            if (cfg.isRetryable && !cfg.isRetryable(err))
+                throw err;
+            if (attempt === cfg.maxAttempts - 1)
+                break;
+            const delay = fullJitterDelay(attempt, cfg);
+            cfg.log?.(`[kronos:resilience] ${opts.event} attempt ${attempt + 1}/${cfg.maxAttempts} ` +
+                `failed; retrying in ${Math.round(delay)}ms — ${err?.message ?? String(err)}`);
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+    throw lastErr;
+}
+/**
+ * Run a health-check probe with warn-then-continue semantics (D-100).
+ *
+ * Resolves WITHOUT throwing on success OR after `thresholdMs` elapses with
+ * the probe still pending — production loops should NEVER stall on a flaky
+ * health probe. Failures (rejection or threshold breach) emit a single warn
+ * via `log` and otherwise resolve normally.
+ */
+export async function healthCheck(fn, opts = {}) {
+    const threshold = opts.thresholdMs ?? DEFAULTS.healthCheckThresholdMs;
+    const log = opts.log ?? ((m) => console.warn(m));
+    let timer;
+    try {
+        await Promise.race([
+            fn(),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error("health-check threshold exceeded")), threshold);
+            }),
+        ]);
+    }
+    catch (err) {
+        log(`[kronos:resilience] health-check soft-failed (${err?.message ?? String(err)}); continuing`);
+        // warn-then-continue: do NOT rethrow.
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=resilience.js.map

package/dist/resilience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.js","sourceRoot":"","sources":["../src/resilience.ts"],"names":[],"mappings":"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"}

package/dist/shutdown-latch.d.ts

@@ -10,11 +10,12 @@
  *
  * This is the TypeScript equivalent of AF5's ShutdownLatch pattern.
  */
-export interface ShutdownLatch {
+export type ShutdownLatch = {
     /**
      * Register an in-flight activity. Throws if shutdown is in progress.
      * Call `end()` on the returned handle when the activity completes.
      */
+    onShutdown(callback: () => void): () => void;
     registerActivity(): ActivityHandle;
     /**
      * Begin graceful shutdown. Returns a promise that resolves when
@@ -26,11 +27,11 @@ export interface ShutdownLatch {
     readonly shuttingDown: boolean;
     /** Number of currently in-flight activities. */
     readonly activeCount: number;
-}
-export interface ActivityHandle {
+};
+export type ActivityHandle = {
     /** Mark this activity as complete. */
     end(): void;
-}
+};
 export declare class ShutdownInProgressError extends Error {
     constructor(message?: string);
 }

package/dist/shutdown-latch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown-latch.d.ts","sourceRoot":"","sources":["../src/shutdown-latch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,gBAAgB,IAAI,cAAc,CAAA;IAElC;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjC,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAE9B,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,GAAG,IAAI,IAAI,CAAA;CACZ;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,GAAE,MAA+B,EAGnD;CACF;AAED,wBAAgB,aAAa,IAAI,aAAa,CAmD7C"}
+{"version":3,"file":"shutdown-latch.d.ts","sourceRoot":"","sources":["../src/shutdown-latch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAC5C,gBAAgB,IAAI,cAAc,CAAA;IAElC;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjC,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAE9B,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,sCAAsC;IACtC,GAAG,IAAI,IAAI,CAAA;CACZ,CAAA;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,GAAE,MAA+B,EAGnD;CACF;AAED,wBAAgB,aAAa,IAAI,aAAa,CA+D7C"}

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.4.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",
@@ -33,7 +33,7 @@
     "!src/**/*.bench.ts"
   ],
   "scripts": {
-    "generate-proto": "grpc_tools_node_protoc --ts_proto_out=./src/generated --ts_proto_opt=outputServices=nice-grpc,outputServices=generic-definitions,useExactTypes=false,esModuleInterop=true --proto_path=./proto ./proto/*.proto",
+    "generate-proto": "grpc_tools_node_protoc --ts_proto_out=./src/generated --ts_proto_opt=outputServices=nice-grpc,outputServices=generic-definitions,useExactTypes=false,esModuleInterop=true --proto_path=./proto ./proto/*.proto && bun ../../scripts/interface-to-type/convert.ts ./src/generated",
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist *.tsbuildinfo"
   },
@@ -49,7 +49,7 @@
     }
   },
   "dependencies": {
-    "@kronos-ts/core": "0.2.0",
+    "@kronos-ts/core": "0.4.0",
     "@bufbuild/protobuf": "^2.3",
     "@grpc/grpc-js": "^1.12",
     "nice-grpc": "^2.1",