@kronos-ts/axon-server 0.4.0 → 0.5.0

package/src/connection.ts

@@ -7,7 +7,8 @@ import {
 } from "nice-grpc"
 import { ChannelCredentials as GrpcChannelCredentials } from "@grpc/grpc-js"
 import { readFileSync } from "node:fs"
-import { withRetry, healthCheck, type ResilienceConfig, type Serializer } from "@kronos-ts/core"
+import type { Serializer } from "@kronos-ts/core"
+import { withRetry, healthCheck, type ResilienceConfig } from "./resilience.js"
 import { PlatformServiceDefinition } from "./generated/control.js"
 import { CommandServiceDefinition } from "./generated/command.js"
 import { QueryServiceDefinition } from "./generated/query.js"
@@ -22,7 +23,7 @@ import {
 /**
  * Configuration for connecting to Axon Server.
  */
-export interface AxonServerConnectionConfig {
+export type AxonServerConnectionConfig = {
   /**
    * Host of the Axon Server. Defaults to "localhost".
    * For single-server setups.
@@ -107,7 +108,7 @@ export type ConnectionState =
  * An active connection to Axon Server, providing typed gRPC clients
  * for all services. Supports reconnection on failure.
  */
-export interface AxonServerConnection {
+export type AxonServerConnection = {
   /** The underlying gRPC channel. */
   readonly channel: Channel
   /** Platform service — connection management, topology. */
@@ -321,10 +322,10 @@ export function connectToAxonServer(config: AxonServerConnectionConfig): AxonSer
  * of a bus. Every event, snapshot, command payload and query result this
  * process exchanges with Axon Server goes through the same codec, so it is
  * named once, here — which is also what leaves
- * `axonServerEventStore(conn, context)` and `axonServerCommandBus(conn, local)`
+ * `axonServerEventStore(conn, context)` and `axonServerCommandBus(local, conn)`
  * their honest two-argument shapes.
  */
-export interface AxonServerConnectionOptions extends AxonServerConnectionConfig {
+export type AxonServerConnectionOptions = AxonServerConnectionConfig & {
   /** Payload codec for every message this client exchanges with Axon Server. */
   serializer: Serializer
   /** Retry / health-check policy for the initial connect and stream re-establishment. */
@@ -350,13 +351,13 @@ export interface AxonServerConnectionOptions extends AxonServerConnectionConfig
  * the codec. Narrower than the handle on purpose — a test can drive a store
  * with a fake `connection` and nothing else.
  */
-export interface AxonServerStoreSource {
+export type AxonServerStoreSource = {
   readonly connection: AxonServerConnection
   readonly serializer: Serializer
 }
 
 /** What a BUS borrows: a store's two, plus the drain latch and the retry policy. */
-export interface AxonServerBusSource extends AxonServerStoreSource {
+export type AxonServerBusSource = AxonServerStoreSource & {
   /**
    * The connection-wide drain latch. In-flight dispatches register on it and
    * `close()` waits for them, so a bus never has the transport pulled out from
@@ -367,7 +368,7 @@ export interface AxonServerBusSource extends AxonServerStoreSource {
 }
 
 /** What the CONTROL PLANE borrows: the platform stream, and only that. */
-export interface AxonServerPlatformSource {
+export type AxonServerPlatformSource = {
   readonly platform: PlatformConnection
 }
 
@@ -376,12 +377,12 @@ export interface AxonServerPlatformSource {
  * stream riding on it, and the lifecycle pair.
  *
  * The stores and buses are NOT on it — `axonServerEventStore(conn, context)`,
- * `axonServerCommandBus(conn, local)` and friends are plain functions over
+ * `axonServerCommandBus(local, conn)` and friends are plain functions over
  * this, and a caller who wants only commands builds only that one. Multiple
  * contexts share this ONE channel: the per-call `AxonIQ-Context` header is what
  * separates them.
  */
-export interface AxonServerConnectionHandle extends AxonServerBusSource, AxonServerPlatformSource {
+export type AxonServerConnectionHandle = AxonServerBusSource & AxonServerPlatformSource & {
   /** Config after defaults — the resolved host, context, client id. */
   readonly config: AxonServerConnection["config"]
   /**
@@ -410,13 +411,14 @@ export interface AxonServerConnectionHandle extends AxonServerBusSource, AxonSer
  *   serializer: jsonSerializer(),
  * })
  * const eventStore    = axonServerEventStore(axon, "default")
- * const snapshotStore = axonServerSnapshotStore(axon, "default")
+ * const eventStore = axonServerSnapshottingEventStore(
+ *   axonServerEventStore(axon, "default"), axon, "default")
  * const commandBus = interceptingCommandBus(
- *   axonServerCommandBus(axon, simpleCommandBus(unitOfWork)), lineage)
+ *   axonServerCommandBus(localCommandBus(unitOfWork), axon), correlation)
  * const queryBus = interceptingQueryBus(
- *   axonServerQueryBus(axon, simpleQueryBus(unitOfWork)), lineage)
+ *   axonServerQueryBus(localQueryBus(unitOfWork), axon), correlation)
  *
- * const app = kronos({ states, commandHandlers, queryHandlers })
+ * const app = kronos({ commandHandlers, queryHandlers })
  * await axon.start()                  // readiness barrier: the server can route to us
  * // opt in to remote administration
  * const control = await axonServerControlPlane(axon, app.processors.values())

package/src/context-view.ts

@@ -12,7 +12,7 @@ import type { AxonServerStoreSource } from "./connection.js"
  * channel, the codec or the drain latch differs between them; only this header
  * does, which is why the whole difference fits in one small record.
  */
-export interface AxonServerContextView extends AxonServerStoreSource {
+export type AxonServerContextView = AxonServerStoreSource & {
   /** The Axon Server context every call through this view addresses. */
   readonly context: string
   /**

package/src/control-plane.ts

@@ -19,7 +19,7 @@
  *
  * ```ts
  * const axon = await axonServerConnection({ ... })
- * const app  = kronos({ states, commandHandlers, queryHandlers, eventHandlers })
+ * const app  = kronos({ commandHandlers, queryHandlers, eventHandlers })
  * await axon.start()                                  // data path only
  *
  * // opt in to remote administration
@@ -53,7 +53,7 @@ import type { ProcessorStatus, SegmentStatus } from "./event-processor-info.js"
  * may not implement (a subscribing processor has no segments), and the
  * instruction handler simply skips what is absent.
  */
-export interface ManagedEventProcessor {
+export type ManagedEventProcessor = {
   readonly name: string
   readonly running?: boolean
   readonly replaying?: boolean
@@ -79,7 +79,7 @@ export interface ManagedEventProcessor {
  * A running control plane. The platform stream is live; instructions are being
  * routed and status is being reported until `close()`.
  */
-export interface AxonServerControlPlane {
+export type AxonServerControlPlane = {
   /**
    * The processors this control plane addresses, keyed by name — the snapshot
    * taken at construction. Exposed for introspection and tests.

package/src/event-processor-info.ts

@@ -4,7 +4,7 @@ import type { EventProcessorInfo, EventProcessorInfo_SegmentStatus } from "./gen
  * Status of a single event processor, reported to Axon Server.
  * Aligned with Java's EventProcessorInfo proto message.
  */
-export interface ProcessorStatus {
+export type ProcessorStatus = {
   readonly name: string
   readonly running: boolean
   readonly mode: "Tracking" | "Subscribing"
@@ -17,7 +17,7 @@ export interface ProcessorStatus {
   readonly segments: SegmentStatus[]
 }
 
-export interface SegmentStatus {
+export type SegmentStatus = {
   readonly segmentId: number
   readonly caughtUp: boolean
   readonly replaying: boolean

package/src/flow-controlled-sender.ts

@@ -7,7 +7,7 @@
  *
  * Aligned with Java's `FlowControlledResponseSender`.
  */
-export interface FlowControlledSender<T> {
+export type FlowControlledSender<T> = {
   /** Send an update. Buffers if no permits available. */
   offer(value: T): boolean
   /** Grant additional permits to the sender. */

package/src/generated/command.ts

@@ -19,7 +19,7 @@ import {
 export const protobufPackage = "io.axoniq.axonserver.grpc.command";
 
 /** An instruction from the components that provides the Command Handler towards AxonServer. */
-export interface CommandProviderOutbound {
+export type CommandProviderOutbound = {
   /** Instruction to subscribe this component as handler of a specific type of command */
   subscribe?:
     | CommandSubscription
@@ -45,7 +45,7 @@ export interface CommandProviderOutbound {
 }
 
 /** An instruction or confirmation from AxonServer towards the component that provides the Command Handler */
-export interface CommandProviderInbound {
+export type CommandProviderInbound = {
   /** Acknowledgement of previously sent instruction via outbound stream */
   ack?:
     | InstructionAck
@@ -59,7 +59,7 @@ export interface CommandProviderInbound {
 }
 
 /** A message representing a Command that needs to be routed to a component capable of handling it */
-export interface Command {
+export type Command = {
   /** The unique identifier of the Command Message */
   messageIdentifier: string;
   /** The name of the command, used for routing it to a destination capable of handling it */
@@ -80,13 +80,13 @@ export interface Command {
   componentName: string;
 }
 
-export interface Command_MetaDataEntry {
+export type Command_MetaDataEntry = {
   key: string;
   value: MetaDataValue | undefined;
 }
 
 /** Message representing the result of Command Handler execution */
-export interface CommandResponse {
+export type CommandResponse = {
   /** The unique identifier of the response message */
   messageIdentifier: string;
   /** An error code describing the error, if any */
@@ -107,13 +107,13 @@ export interface CommandResponse {
   requestIdentifier: string;
 }
 
-export interface CommandResponse_MetaDataEntry {
+export type CommandResponse_MetaDataEntry = {
   key: string;
   value: MetaDataValue | undefined;
 }
 
 /** Message describing a component's capability of handling a command type */
-export interface CommandSubscription {
+export type CommandSubscription = {
   /**
    * A unique identifier for this subscription. This identifier is returned in Acknowledgements to allow
    * pipelining of subscription messages
@@ -1183,7 +1183,7 @@ export const CommandServiceDefinition = {
   },
 } as const;
 
-export interface CommandServiceImplementation<CallContextExt = {}> {
+export type CommandServiceImplementation<CallContextExt = {}> = {
   /** Opens a stream allowing clients to register command handlers and receive commands. */
   openStream(
     request: AsyncIterable<CommandProviderOutbound>,
@@ -1193,7 +1193,7 @@ export interface CommandServiceImplementation<CallContextExt = {}> {
   dispatch(request: Command, context: CallContext & CallContextExt): Promise<DeepPartial<CommandResponse>>;
 }
 
-export interface CommandServiceClient<CallOptionsExt = {}> {
+export type CommandServiceClient<CallOptionsExt = {}> = {
   /** Opens a stream allowing clients to register command handlers and receive commands. */
   openStream(
     request: AsyncIterable<DeepPartial<CommandProviderOutbound>>,
@@ -1221,7 +1221,7 @@ function isSet(value: any): boolean {
 
 export type ServerStreamingMethodResult<Response> = { [Symbol.asyncIterator](): AsyncIterator<Response, void> };
 
-export interface MessageFns<T> {
+export type MessageFns<T> = {
   encode(message: T, writer?: BinaryWriter): BinaryWriter;
   decode(input: BinaryReader | Uint8Array, length?: number): T;
   fromJSON(object: any): T;

package/src/generated/common.ts

@@ -131,7 +131,7 @@ export function taskStatusToJSON(object: TaskStatus): string {
 }
 
 /** Describes a serialized object */
-export interface SerializedObject {
+export type SerializedObject = {
   /** The type identifier of the serialized object. */
   type: string;
   /** The revision of the serialized form of the given type. */
@@ -141,7 +141,7 @@ export interface SerializedObject {
 }
 
 /** The value of a MetaData entry. */
-export interface MetaDataValue {
+export type MetaDataValue = {
   /** The text value of the Meta Data entry. */
   textValue?:
     | string
@@ -163,7 +163,7 @@ export interface MetaDataValue {
 }
 
 /** An instruction for routing components when routing or processing a message. */
-export interface ProcessingInstruction {
+export type ProcessingInstruction = {
   /** The type of processing message. */
   key: ProcessingKey;
   /** The value associated with the processing key. */
@@ -171,7 +171,7 @@ export interface ProcessingInstruction {
 }
 
 /** Message containing details of an error */
-export interface ErrorMessage {
+export type ErrorMessage = {
   /** A human readable message explaining the error */
   message: string;
   /** A description of the location (client component, server) where the error occurred */
@@ -183,7 +183,7 @@ export interface ErrorMessage {
 }
 
 /** Message used for Flow Control instruction, providing the counterpart with additional permits for sending messages */
-export interface FlowControl {
+export type FlowControl = {
   /** The ClientID of the component providing additional permits */
   clientId: string;
   /** The number of permits to provide */
@@ -191,7 +191,7 @@ export interface FlowControl {
 }
 
 /** Message describing instruction acknowledgement */
-export interface InstructionAck {
+export type InstructionAck = {
   /** The identifier of the instruction */
   instructionId: string;
   /** Indicator whether the instruction was acknowledged successfully */
@@ -201,7 +201,7 @@ export interface InstructionAck {
 }
 
 /** Message describing the result of the execution of an instruction */
-export interface InstructionResult {
+export type InstructionResult = {
   /** The identifier of the instruction */
   instructionId: string;
   /** Indicator whether the instruction was processed successfully */
@@ -210,11 +210,11 @@ export interface InstructionResult {
   error: ErrorMessage | undefined;
 }
 
-export interface Component {
+export type Component = {
   component: string;
 }
 
-export interface Principal {
+export type Principal = {
   user: string;
 }
 
@@ -1087,7 +1087,7 @@ function isSet(value: any): boolean {
   return value !== null && value !== undefined;
 }
 
-export interface MessageFns<T> {
+export type MessageFns<T> = {
   encode(message: T, writer?: BinaryWriter): BinaryWriter;
   decode(input: BinaryReader | Uint8Array, length?: number): T;
   fromJSON(object: any): T;

package/src/generated/control.ts

@@ -68,7 +68,7 @@ export function updateTypeToJSON(object: UpdateType): string {
 }
 
 /** An instruction from Application Node to the AxonServer platform */
-export interface PlatformInboundInstruction {
+export type PlatformInboundInstruction = {
   /**
    * Information about the client being connected.
    * This information is used by AxonServer to monitor the topology of connected applications.
@@ -111,15 +111,15 @@ export interface PlatformInboundInstruction {
 }
 
 /** Message to subscribe to topology changes within the control channel's context */
-export interface SubscribeTopologyChanges {
+export type SubscribeTopologyChanges = {
 }
 
 /** Message to unsubscribe from topology changes within the control channel's context */
-export interface UnsubscribeTopologyChanges {
+export type UnsubscribeTopologyChanges = {
 }
 
 /** An instruction or information from the AxonServer Platform to the Application Node */
-export interface PlatformOutboundInstruction {
+export type PlatformOutboundInstruction = {
   /** Information provided by AxonServer which provides information about the AxonServer node the application is connected with */
   nodeNotification?:
     | NodeInfo
@@ -176,11 +176,11 @@ export interface PlatformOutboundInstruction {
 }
 
 /** Message send when AxonServer requests the client to re-establish its connection with the Platform */
-export interface RequestReconnect {
+export type RequestReconnect = {
 }
 
 /** Message containing connection information of the node to Connect with */
-export interface PlatformInfo {
+export type PlatformInfo = {
   /** The connection details of the node the client should connect with */
   primary:
     | NodeInfo
@@ -193,7 +193,7 @@ export interface PlatformInfo {
 }
 
 /** Message containing connection information for an AxonServer Node */
-export interface NodeInfo {
+export type NodeInfo = {
   /** The host name to use when connecting to this node */
   hostName: string;
   /** The port number for gRPC connections */
@@ -207,7 +207,7 @@ export interface NodeInfo {
 }
 
 /** Message containing details about the Client Application */
-export interface ClientIdentification {
+export type ClientIdentification = {
   /** A unique identifier for this client instance. Is used to distinguish different instances of the same component */
   clientId: string;
   /** The name of the component. Several instances of the same component should share this name */
@@ -218,13 +218,13 @@ export interface ClientIdentification {
   version: string;
 }
 
-export interface ClientIdentification_TagsEntry {
+export type ClientIdentification_TagsEntry = {
   key: string;
   value: string;
 }
 
 /** Message containing information about the status of an Event Processor */
-export interface EventProcessorInfo {
+export type EventProcessorInfo = {
   /** The logical name of this processor. */
   processorName: string;
   /** The mode in which this processor is reading Events, for example: 'Tracking' or 'Subscribing' */
@@ -257,7 +257,7 @@ export interface EventProcessorInfo {
 }
 
 /** Message containing information about the status of a Segment of a Streaming Event Processor */
-export interface EventProcessorInfo_SegmentStatus {
+export type EventProcessorInfo_SegmentStatus = {
   /** The ID of the Segment for which the status is reported */
   segmentId: number;
   /** Indicates whether the Segment has "Caught Up" with the Head of the Event Stream */
@@ -273,23 +273,23 @@ export interface EventProcessorInfo_SegmentStatus {
 }
 
 /** Message providing reference to an Event Processor */
-export interface EventProcessorReference {
+export type EventProcessorReference = {
   /** The name of the Event Processor */
   processorName: string;
 }
 
 /** Message providing reference to a Segment of an Event Processor */
-export interface EventProcessorSegmentReference {
+export type EventProcessorSegmentReference = {
   /** The name of the Event Processor */
   processorName: string;
   /** The identifier of the Segment */
   segmentIdentifier: number;
 }
 
-export interface Heartbeat {
+export type Heartbeat = {
 }
 
-export interface TopologyChange {
+export type TopologyChange = {
   updateType: UpdateType;
   context: string;
   /** The client ID of the component requesting the update */
@@ -306,14 +306,14 @@ export interface TopologyChange {
   query?: QuerySubscription | undefined;
 }
 
-export interface CommandSubscription {
+export type CommandSubscription = {
   /** The subscription ID to add or remove */
   name: string;
   /** The load factor for the subscription */
   loadFactor: number;
 }
 
-export interface QuerySubscription {
+export type QuerySubscription = {
   /** The subscription ID to add or remove */
   name: string;
 }
@@ -2365,7 +2365,7 @@ export const PlatformServiceDefinition = {
   },
 } as const;
 
-export interface PlatformServiceImplementation<CallContextExt = {}> {
+export type PlatformServiceImplementation<CallContextExt = {}> = {
   /** Obtains connection information for the Server that a Client should use for its connections. */
   getPlatformServer(
     request: ClientIdentification,
@@ -2378,7 +2378,7 @@ export interface PlatformServiceImplementation<CallContextExt = {}> {
   ): ServerStreamingMethodResult<DeepPartial<PlatformOutboundInstruction>>;
 }
 
-export interface PlatformServiceClient<CallOptionsExt = {}> {
+export type PlatformServiceClient<CallOptionsExt = {}> = {
   /** Obtains connection information for the Server that a Client should use for its connections. */
   getPlatformServer(
     request: DeepPartial<ClientIdentification>,
@@ -2409,7 +2409,7 @@ function isSet(value: any): boolean {
 
 export type ServerStreamingMethodResult<Response> = { [Symbol.asyncIterator](): AsyncIterator<Response, void> };
 
-export interface MessageFns<T> {
+export type MessageFns<T> = {
   encode(message: T, writer?: BinaryWriter): BinaryWriter;
   decode(input: BinaryReader | Uint8Array, length?: number): T;
   fromJSON(object: any): T;