@kronos-ts/axon-server 0.1.0

package/dist/platform-service.js

@@ -0,0 +1,250 @@
+import { createOutboundStream } from "./outbound-stream.js";
+import { Metadata } from "nice-grpc";
+import { toEventProcessorInfo } from "./event-processor-info.js";
+/**
+ * Creates a PlatformService connection to Axon Server.
+ *
+ * The platform stream is the control plane — it:
+ * 1. Registers this client with Axon Server
+ * 2. Sends periodic heartbeats to verify connectivity
+ * 3. Receives instructions from Axon Server (split, merge, pause, resume)
+ */
+export function createPlatformConnection(connection, options) {
+    const heartbeatIntervalMs = options?.heartbeatIntervalMs ?? 10000;
+    const heartbeatTimeoutMs = options?.heartbeatTimeoutMs ?? 7500;
+    const processorsNotificationRateMs = options?.processorsNotificationRateMs ?? 500;
+    const processorsNotificationInitialDelayMs = options?.processorsNotificationInitialDelayMs ?? 5000;
+    const instructionHandlers = [];
+    const processorStatusSuppliers = [];
+    let isConnected = false;
+    let heartbeatTimer = null;
+    let heartbeatTimeoutTimer = null;
+    let processorStatusTimer = null;
+    let lastHeartbeatResponse = Date.now();
+    let outbound = null;
+    /**
+     * Latches once Axon Server sends its first inbound message after
+     * registration — the earliest observable signal that the platform stream
+     * is fully wired (mirror of kronosdb Plan 09-03 / D-102, replaces the
+     * legacy 1-second sleep). Reset on every `start()` so a stop/start cycle
+     * re-arms the latch correctly.
+     */
+    let acked = false;
+    const grpcMetadata = new Metadata();
+    grpcMetadata.set("AxonIQ-Context", connection.config.context);
+    if (connection.config.token) {
+        grpcMetadata.set("AxonIQ-Access-Token", connection.config.token);
+    }
+    async function processInboundInstructions(inbound) {
+        try {
+            for await (const message of inbound) {
+                // 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;
+                // Parse instruction type
+                const instruction = parseInstruction(message);
+                if (instruction) {
+                    for (const handler of instructionHandlers) {
+                        try {
+                            await handler(instruction);
+                        }
+                        catch (err) {
+                            console.error("Platform instruction handler error:", err);
+                        }
+                    }
+                }
+                // Handle heartbeat response — track last response time for timeout detection
+                if (message.heartbeat) {
+                    lastHeartbeatResponse = Date.now();
+                }
+            }
+        }
+        catch (err) {
+            if (isConnected) {
+                console.error("Platform stream error:", err);
+                isConnected = false;
+            }
+        }
+    }
+    function parseInstruction(message) {
+        if (message.requestReconnect) {
+            return { kind: "reconnect-request" };
+        }
+        // Processor control instructions
+        const ctrl = message.eventProcessorControl;
+        if (ctrl) {
+            const processorName = ctrl.processorName ?? "";
+            if (ctrl.pauseEventProcessor) {
+                return { kind: "pause-processor", processorName };
+            }
+            if (ctrl.startEventProcessor) {
+                return { kind: "start-processor", processorName };
+            }
+            if (ctrl.releaseSegment !== undefined) {
+                return { kind: "release-segment", processorName, segmentId: ctrl.releaseSegment.segmentId ?? 0 };
+            }
+            if (ctrl.splitEventProcessor !== undefined) {
+                return { kind: "split-segment", processorName, segmentId: ctrl.splitEventProcessor.segmentId ?? 0 };
+            }
+            if (ctrl.mergeEventProcessor !== undefined) {
+                return { kind: "merge-segment", processorName, segmentId: ctrl.mergeEventProcessor.segmentId ?? 0 };
+            }
+        }
+        // Topology change instructions
+        const topo = message.topologyChange;
+        if (topo) {
+            const componentName = topo.componentName ?? "";
+            if (topo.commandHandlerAdded) {
+                return { kind: "command-handler-added", componentName, commandName: topo.commandHandlerAdded.commandName ?? "" };
+            }
+            if (topo.commandHandlerRemoved) {
+                return { kind: "command-handler-removed", componentName, commandName: topo.commandHandlerRemoved.commandName ?? "" };
+            }
+            if (topo.queryHandlerAdded) {
+                return { kind: "query-handler-added", componentName, queryName: topo.queryHandlerAdded.queryName ?? "" };
+            }
+            if (topo.queryHandlerRemoved) {
+                return { kind: "query-handler-removed", componentName, queryName: topo.queryHandlerRemoved.queryName ?? "" };
+            }
+        }
+        return null;
+    }
+    function startHeartbeat() {
+        if (heartbeatTimer)
+            clearInterval(heartbeatTimer);
+        lastHeartbeatResponse = Date.now();
+        heartbeatTimer = setInterval(() => {
+            if (!isConnected || !outbound)
+                return;
+            // Check if last heartbeat response was too long ago
+            const timeSinceLastResponse = Date.now() - lastHeartbeatResponse;
+            if (timeSinceLastResponse > heartbeatTimeoutMs) {
+                console.warn(`Platform heartbeat timeout: no response in ${timeSinceLastResponse}ms ` +
+                    `(threshold: ${heartbeatTimeoutMs}ms). Marking connection as lost.`);
+                isConnected = false;
+                connection.reconnect().catch((err) => {
+                    console.error("Failed to reconnect after heartbeat timeout:", err);
+                });
+                return;
+            }
+            outbound.send({
+                heartbeat: {
+                    clientId: connection.config.clientId,
+                },
+                instructionId: "",
+            });
+        }, heartbeatIntervalMs);
+    }
+    function startProcessorStatusReporting() {
+        if (processorStatusTimer)
+            clearInterval(processorStatusTimer);
+        // Initial delay before first report
+        setTimeout(() => {
+            if (!isConnected)
+                return;
+            reportProcessorStatus();
+            // Then report at the configured rate
+            processorStatusTimer = setInterval(() => {
+                if (!isConnected || !outbound)
+                    return;
+                reportProcessorStatus();
+            }, processorsNotificationRateMs);
+        }, processorsNotificationInitialDelayMs);
+    }
+    function reportProcessorStatus() {
+        if (!outbound || processorStatusSuppliers.length === 0)
+            return;
+        for (const supplier of processorStatusSuppliers) {
+            try {
+                const statuses = supplier();
+                for (const status of statuses) {
+                    outbound.send({
+                        eventProcessorInfo: toEventProcessorInfo(status),
+                        instructionId: "",
+                    });
+                }
+            }
+            catch (err) {
+                console.warn("Failed to report processor status:", err);
+            }
+        }
+    }
+    return {
+        async start() {
+            if (isConnected)
+                return;
+            // Re-arm the ack latch so a stop/start cycle correctly re-waits.
+            acked = false;
+            outbound = createOutboundStream();
+            // Register with Axon Server
+            outbound.send({
+                register: {
+                    clientId: connection.config.clientId,
+                    componentName: connection.config.componentName,
+                    version: "1.0.0",
+                    tags: {},
+                },
+                instructionId: "",
+            });
+            // Open bidirectional stream
+            const inbound = connection.platform.openStream(outbound.iterable, {
+                metadata: grpcMetadata,
+            });
+            isConnected = true;
+            startHeartbeat();
+            startProcessorStatusReporting();
+            processInboundInstructions(inbound);
+            // 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,
+            // or (b) one of our heartbeat pings round-trips back. That means the
+            // first-inbound-frame ack signal used by kronosdb (Plan 09-03 / D-102)
+            // doesn't fire deterministically here, and the processors-stage
+            // `withRetry({event: "per-operation"})` poll would otherwise hang.
+            //
+            // Axon-specific ack derivation: latch `acked = true` immediately once
+            // the outbound `register` frame has been flushed to the gRPC layer.
+            // Bus subscriptions (sent on the command/query streams, NOT the
+            // platform stream) are an orthogonal concern handled by the
+            // command/query bus reconnect path — the legacy 1-second sleep that
+            // we replaced was always covering register processing, not bus-side
+            // routability. Structurally this is the Axon Server equivalent of
+            // D-102: drop the magic-number wait, use the earliest deterministic
+            // observable signal that fits the underlying protocol.
+            acked = true;
+        },
+        stop() {
+            isConnected = false;
+            if (heartbeatTimer) {
+                clearInterval(heartbeatTimer);
+                heartbeatTimer = null;
+            }
+            if (heartbeatTimeoutTimer) {
+                clearTimeout(heartbeatTimeoutTimer);
+                heartbeatTimeoutTimer = null;
+            }
+            if (processorStatusTimer) {
+                clearInterval(processorStatusTimer);
+                processorStatusTimer = null;
+            }
+            if (outbound) {
+                outbound.close();
+                outbound = null;
+            }
+        },
+        onInstruction(handler) {
+            instructionHandlers.push(handler);
+        },
+        registerProcessorStatusSupplier(supplier) {
+            processorStatusSuppliers.push(supplier);
+        },
+        get connected() {
+            return isConnected;
+        },
+        async subscriptionsAcked() {
+            return isConnected && acked;
+        },
+    };
+}
+//# sourceMappingURL=platform-service.js.map

package/dist/platform-service.js.map

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

package/dist/shutdown-latch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A shutdown latch that tracks in-flight operations and enables
+ * graceful shutdown by draining pending work.
+ *
+ * Usage:
+ * - `registerActivity()` before starting a dispatch — returns a handle
+ * - `handle.end()` when the dispatch completes
+ * - `initiateShutdown()` prevents new activities and returns a promise
+ *   that resolves when all in-flight operations complete
+ *
+ * This is the TypeScript equivalent of AF5's ShutdownLatch pattern.
+ */
+export interface ShutdownLatch {
+    /**
+     * Register an in-flight activity. Throws if shutdown is in progress.
+     * Call `end()` on the returned handle when the activity completes.
+     */
+    registerActivity(): ActivityHandle;
+    /**
+     * Begin graceful shutdown. Returns a promise that resolves when
+     * all in-flight activities have completed.
+     * New calls to `registerActivity()` will throw after this.
+     */
+    initiateShutdown(): Promise<void>;
+    /** Whether shutdown has been initiated. */
+    readonly shuttingDown: boolean;
+    /** Number of currently in-flight activities. */
+    readonly activeCount: number;
+}
+export interface ActivityHandle {
+    /** Mark this activity as complete. */
+    end(): void;
+}
+export declare class ShutdownInProgressError extends Error {
+    constructor(message?: string);
+}
+export declare function createShutdownLatch(): ShutdownLatch;
+//# sourceMappingURL=shutdown-latch.d.ts.map

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

@@ -0,0 +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;gBACpC,OAAO,GAAE,MAA+B;CAIrD;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAmDnD"}

package/dist/shutdown-latch.js

@@ -0,0 +1,51 @@
+export class ShutdownInProgressError extends Error {
+    constructor(message = "Shutdown in progress") {
+        super(message);
+        this.name = "ShutdownInProgressError";
+    }
+}
+export function createShutdownLatch() {
+    let activeCount = 0;
+    let shuttingDown = false;
+    let drainResolve = null;
+    function checkDrained() {
+        if (shuttingDown && activeCount === 0 && drainResolve) {
+            drainResolve();
+            drainResolve = null;
+        }
+    }
+    return {
+        registerActivity() {
+            if (shuttingDown) {
+                throw new ShutdownInProgressError();
+            }
+            activeCount++;
+            let ended = false;
+            return {
+                end() {
+                    if (ended)
+                        return;
+                    ended = true;
+                    activeCount--;
+                    checkDrained();
+                },
+            };
+        },
+        initiateShutdown() {
+            shuttingDown = true;
+            if (activeCount === 0) {
+                return Promise.resolve();
+            }
+            return new Promise((resolve) => {
+                drainResolve = resolve;
+            });
+        },
+        get shuttingDown() {
+            return shuttingDown;
+        },
+        get activeCount() {
+            return activeCount;
+        },
+    };
+}
+//# sourceMappingURL=shutdown-latch.js.map

package/dist/shutdown-latch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-latch.js","sourceRoot":"","sources":["../src/shutdown-latch.ts"],"names":[],"mappings":"AAsCA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,UAAkB,sBAAsB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB;IACjC,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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@kronos-ts/axon-server",
+  "version": "0.1.0",
+  "description": "Axon Server extension for Kronos — event store and command bus over Axon Server.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "author": "Theo Emanuelsson",
+  "homepage": "https://github.com/KronosDB/kronos-ts/tree/main/packages/extensions/axon-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KronosDB/kronos-ts.git",
+    "directory": "packages/extensions/axon-server"
+  },
+  "bugs": {
+    "url": "https://github.com/KronosDB/kronos-ts/issues"
+  },
+  "keywords": [
+    "kronos",
+    "event-sourcing",
+    "cqrs",
+    "dcb",
+    "typescript",
+    "axon-server"
+  ],
+  "sideEffects": false,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "dist",
+    "src",
+    "!src/**/__tests__",
+    "!src/**/*.test.ts",
+    "!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",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@kronos-ts/common": "workspace:*",
+    "@kronos-ts/app": "workspace:*",
+    "@kronos-ts/eventsourcing": "workspace:*",
+    "@kronos-ts/messaging": "workspace:*",
+    "@kronos-ts/modelling": "workspace:*",
+    "@bufbuild/protobuf": "^2.3",
+    "@grpc/grpc-js": "^1.12",
+    "nice-grpc": "^2.1",
+    "nice-grpc-common": "^2.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "grpc-tools": "^1.12",
+    "grpc_tools_node_protoc_ts": "^5.3",
+    "testcontainers": "^11.13.0",
+    "ts-proto": "^2.6"
+  }
+}