@kronos-ts/rabbitmq 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-ts/rabbitmq",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "RabbitMQ extension for Kronos — distributed command and query transport.",
   "license": "Apache-2.0",
   "type": "module",
@@ -52,11 +52,11 @@
     }
   },
   "dependencies": {
-    "@kronos-ts/common": "0.1.0",
-    "@kronos-ts/app": "0.1.0",
-    "@kronos-ts/eventsourcing": "0.1.0",
-    "@kronos-ts/messaging": "0.1.0",
-    "@kronos-ts/modelling": "0.1.0"
+    "@kronos-ts/common": "0.1.1",
+    "@kronos-ts/app": "0.3.3",
+    "@kronos-ts/eventsourcing": "0.2.0",
+    "@kronos-ts/messaging": "0.5.0",
+    "@kronos-ts/modelling": "0.2.3"
   },
   "peerDependencies": {
     "amqplib": ">=0.10.0"

package/dist/amqp-query-updates-transport.d.ts

@@ -1,75 +0,0 @@
-import type { AmqpConnection } from "./connection.js";
-import type { RabbitMqResolvedConfig } from "./rabbitmq.js";
-/**
- * Wire envelope for subscription-query update broadcasts.
- *
- * `kind: "update"` carries a payload to deliver to all matching local subscribers.
- * `kind: "complete"` / `"completeExceptionally"` signal end-of-stream for all
- * subscribers of the given query name on every process.
- *
- * `senderId` identifies the publishing instance so a process can drop its own
- * loopback messages (the local query bus has already fanned out locally).
- */
-export interface RabbitMqQueryUpdateEnvelope {
-    readonly kind: "update" | "complete" | "completeExceptionally";
-    readonly senderId: string;
-    readonly queryName: string;
-    readonly update?: unknown;
-    readonly error?: {
-        readonly name?: string;
-        readonly message: string;
-        readonly stack?: string;
-    };
-    /**
-     * Serialized form of a structured `payloadEquals` filter. When present,
-     * receivers apply it against each local subscriber's stored query payload
-     * before delivering. Function filters do not serialize and therefore arrive
-     * without this field, causing the receiver to deliver to all local
-     * subscribers of {@link queryName}.
-     */
-    readonly payloadEquals?: Record<string, unknown>;
-}
-export interface RabbitMqQueryUpdatesTransport {
-    /** Publish an update / complete envelope to every subscribed instance. */
-    publish(envelope: RabbitMqQueryUpdateEnvelope): Promise<void>;
-    /** Bind this instance's queue to the routing key for the query name. Idempotent. */
-    bindQueryName(queryName: string): Promise<void>;
-    /** Unbind this instance's queue from the routing key. Idempotent. */
-    unbindQueryName(queryName: string): Promise<void>;
-    /** Set the in-process handler invoked when an inbound update arrives. */
-    setHandler(handler: (envelope: RabbitMqQueryUpdateEnvelope) => void): void;
-    /** Stable identifier for this publisher; appears as `senderId` on outbound envelopes. */
-    readonly senderId: string;
-}
-/**
- * AMQP broadcast transport for subscription-query updates.
- *
- * Topology: a topic exchange (`<prefix>.query-updates`) and one exclusive
- * auto-delete queue per instance (`<prefix>.query-updates.<service>.<instance>`).
- * The bus dynamically binds the queue to a routing key per active query name.
- *
- * Consume mode is no-ack: updates are best-effort. Losing one update means a
- * subscriber will see a stale view until the next emit — same recovery model
- * as Axon Server when a broker round-trip is dropped.
- */
-export declare class AmqpRabbitMqQueryUpdatesTransport implements RabbitMqQueryUpdatesTransport {
-    private readonly config;
-    private readonly connection;
-    private channel;
-    private connectPromise;
-    private closed;
-    private handler;
-    private readonly boundKeys;
-    readonly senderId: string;
-    constructor(config: RabbitMqResolvedConfig, connection: AmqpConnection);
-    connect(): Promise<void>;
-    private doConnect;
-    close(): Promise<void>;
-    publish(envelope: RabbitMqQueryUpdateEnvelope): Promise<void>;
-    bindQueryName(queryName: string): Promise<void>;
-    unbindQueryName(queryName: string): Promise<void>;
-    setHandler(handler: (envelope: RabbitMqQueryUpdateEnvelope) => void): void;
-    private handleInbound;
-    private requireChannel;
-}
-//# sourceMappingURL=amqp-query-updates-transport.d.ts.map

package/dist/amqp-query-updates-transport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"amqp-query-updates-transport.d.ts","sourceRoot":"","sources":["../src/amqp-query-updates-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAE3D;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,uBAAuB,CAAA;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KACxB,CAAA;IACD;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,6BAA6B;IAC5C,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,oFAAoF;IACpF,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,qEAAqE;IACrE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,yEAAyE;IACzE,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,GAAG,IAAI,CAAA;IAC1E,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iCAAkC,YAAW,6BAA6B;IAUnF,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAV7B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAA+D;IAC9E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAGN,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,cAAc;IAKvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAMhB,SAAS;IA6BjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvD,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,GAAG,IAAI;IAI1E,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,cAAc;CAIvB"}

package/dist/amqp-query-updates-transport.js

@@ -1,105 +0,0 @@
-/**
- * AMQP broadcast transport for subscription-query updates.
- *
- * Topology: a topic exchange (`<prefix>.query-updates`) and one exclusive
- * auto-delete queue per instance (`<prefix>.query-updates.<service>.<instance>`).
- * The bus dynamically binds the queue to a routing key per active query name.
- *
- * Consume mode is no-ack: updates are best-effort. Losing one update means a
- * subscriber will see a stale view until the next emit — same recovery model
- * as Axon Server when a broker round-trip is dropped.
- */
-export class AmqpRabbitMqQueryUpdatesTransport {
-    config;
-    connection;
-    channel;
-    connectPromise;
-    closed = false;
-    handler;
-    boundKeys = new Set();
-    senderId;
-    constructor(config, connection) {
-        this.config = config;
-        this.connection = connection;
-        this.senderId = `${config.identity.serviceName}.${config.identity.instanceId}`;
-    }
-    async connect() {
-        if (this.connectPromise)
-            return this.connectPromise;
-        this.connectPromise = this.doConnect();
-        return this.connectPromise;
-    }
-    async doConnect() {
-        this.channel = await this.connection.channel();
-        await this.channel.assertExchange(this.config.topology.queryUpdatesExchange, "topic", {
-            durable: true,
-        });
-        await this.channel.assertQueue(this.config.topology.queryUpdatesQueue(), {
-            durable: false,
-            exclusive: true,
-            autoDelete: true,
-        });
-        await this.channel.consume(this.config.topology.queryUpdatesQueue(), (msg) => this.handleInbound(msg), { noAck: true });
-        // Rebind any routing keys requested before connect resolved.
-        for (const key of this.boundKeys) {
-            await this.channel.bindQueue(this.config.topology.queryUpdatesQueue(), this.config.topology.queryUpdatesExchange, key);
-        }
-    }
-    async close() {
-        this.closed = true;
-        await this.channel?.close().catch(() => { });
-    }
-    async publish(envelope) {
-        await this.connect();
-        if (this.closed)
-            return;
-        const channel = this.requireChannel();
-        const routingKey = this.config.topology.queryUpdatesRoutingKey(envelope.queryName);
-        channel.publish(this.config.topology.queryUpdatesExchange, routingKey, Buffer.from(JSON.stringify(envelope)), { contentType: "application/json", persistent: false });
-    }
-    async bindQueryName(queryName) {
-        const routingKey = this.config.topology.queryUpdatesRoutingKey(queryName);
-        if (this.boundKeys.has(routingKey))
-            return;
-        this.boundKeys.add(routingKey);
-        await this.connect();
-        if (this.closed)
-            return;
-        const channel = this.requireChannel();
-        await channel.bindQueue(this.config.topology.queryUpdatesQueue(), this.config.topology.queryUpdatesExchange, routingKey);
-    }
-    async unbindQueryName(queryName) {
-        const routingKey = this.config.topology.queryUpdatesRoutingKey(queryName);
-        if (!this.boundKeys.has(routingKey))
-            return;
-        this.boundKeys.delete(routingKey);
-        if (this.closed)
-            return;
-        const channel = this.channel;
-        if (!channel)
-            return;
-        await channel.unbindQueue(this.config.topology.queryUpdatesQueue(), this.config.topology.queryUpdatesExchange, routingKey);
-    }
-    setHandler(handler) {
-        this.handler = handler;
-    }
-    handleInbound(msg) {
-        if (!msg)
-            return;
-        if (!this.handler)
-            return;
-        try {
-            const envelope = JSON.parse(msg.content.toString("utf8"));
-            this.handler(envelope);
-        }
-        catch {
-            // Malformed envelopes are dropped — broadcast is best-effort.
-        }
-    }
-    requireChannel() {
-        if (!this.channel)
-            throw new Error("RabbitMQ query-updates transport is not connected");
-        return this.channel;
-    }
-}
-//# sourceMappingURL=amqp-query-updates-transport.js.map

package/dist/amqp-query-updates-transport.js.map

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