@zdavison/matador 2.0.11 → 3.0.0

package/dist/core/matador.d.ts

@@ -120,6 +120,19 @@ export declare class Matador implements Dispatcher {
      * Waits for all handlers to become idle.
      */
     waitForIdle(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Stops receiving new messages without performing full shutdown.
+     * After calling this, no new messages will be delivered from RabbitMQ.
+     * The transport remains connected for later shutdown.
+     *
+     * Use this when you need to coordinate shutdown across multiple systems:
+     * 1. Call stopReceiving() to stop new message delivery
+     * 2. Wait for both Matador and your other systems to idle
+     * 3. Call shutdown() to disconnect (or let NestJS lifecycle handle it)
+     *
+     * @returns true if receiving was stopped, false if not started or already stopped
+     */
+    stopReceiving(): Promise<boolean>;
     /**
      * Gracefully shuts down Matador.
      */
@@ -128,6 +141,6 @@ export declare class Matador implements Dispatcher {
      * Checks if transport is connected.
      */
     isConnected(): boolean;
-    private stopReceiving;
+    private unsubscribeAll;
 }
 //# sourceMappingURL=matador.d.ts.map

package/dist/core/matador.d.ts.map

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

package/dist/core/matador.js

@@ -68,7 +68,7 @@ export class Matador {
             defaultQueue,
         });
         // Create shutdown manager
-        this.shutdownManager = new ShutdownManager(() => this.fanout.eventsBeingEnqueuedCount, () => this.stopReceiving(), () => this.transport.disconnect(), config.shutdownConfig);
+        this.shutdownManager = new ShutdownManager(() => this.fanout.eventsBeingEnqueuedCount, () => this.unsubscribeAll(), () => this.transport.disconnect(), config.shutdownConfig);
     }
     /**
      * Registers an event class with its subscribers.
@@ -203,6 +203,24 @@ export class Matador {
         }
         return true;
     }
+    /**
+     * Stops receiving new messages without performing full shutdown.
+     * After calling this, no new messages will be delivered from RabbitMQ.
+     * The transport remains connected for later shutdown.
+     *
+     * Use this when you need to coordinate shutdown across multiple systems:
+     * 1. Call stopReceiving() to stop new message delivery
+     * 2. Wait for both Matador and your other systems to idle
+     * 3. Call shutdown() to disconnect (or let NestJS lifecycle handle it)
+     *
+     * @returns true if receiving was stopped, false if not started or already stopped
+     */
+    async stopReceiving() {
+        if (!this.started) {
+            return false;
+        }
+        return this.shutdownManager.publicStopReceiving();
+    }
     /**
      * Gracefully shuts down Matador.
      */
@@ -219,7 +237,7 @@ export class Matador {
     isConnected() {
         return this.transport.isConnected();
     }
-    async stopReceiving() {
+    async unsubscribeAll() {
         for (const subscription of this.subscriptions) {
             await subscription.unsubscribe();
         }

package/dist/core/matador.test.js

@@ -361,6 +361,106 @@ describe('Matador', () => {
             expect(matador.send(event)).rejects.toThrow();
         });
     });
+    describe('stopReceiving', () => {
+        it('should return false when not started', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
+            };
+            matador = new Matador({ transport, topology, schema });
+            const result = await matador.stopReceiving();
+            expect(result).toBe(false);
+        });
+        it('should return true when started and stop receiving messages', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
+            };
+            matador = new Matador({ transport, topology, schema });
+            await matador.start();
+            const result = await matador.stopReceiving();
+            expect(result).toBe(true);
+            expect(matador.isConnected()).toBe(true);
+        });
+        it('should return false when called twice', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
+            };
+            matador = new Matador({ transport, topology, schema });
+            await matador.start();
+            const result1 = await matador.stopReceiving();
+            const result2 = await matador.stopReceiving();
+            expect(result1).toBe(true);
+            expect(result2).toBe(false);
+        });
+        it('should allow shutdown after stopReceiving', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
+            };
+            matador = new Matador({ transport, topology, schema });
+            await matador.start();
+            await matador.stopReceiving();
+            await matador.shutdown();
+            expect(matador.isConnected()).toBe(false);
+        });
+        it('should allow sending events after stopReceiving but before shutdown', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
+            };
+            matador = new Matador({ transport, topology, schema });
+            await matador.start();
+            await matador.stopReceiving();
+            const event = new UserCreatedEvent({
+                userId: '123',
+                email: 'test@example.com',
+            });
+            const result = await matador.send(event);
+            expect(result.subscribersSent).toBe(1);
+        });
+    });
     describe('idle state', () => {
         it('should report idle when no processing', async () => {
             const topology = TopologyBuilder.create()

package/dist/core/shutdown.d.ts

@@ -2,7 +2,7 @@ import { type Logger } from '../hooks/index.js';
 /**
  * Shutdown state.
  */
-export type ShutdownState = 'running' | 'stopping-receive' | 'waiting-handlers' | 'stopping-enqueue' | 'disconnecting' | 'stopped';
+export type ShutdownState = 'running' | 'receive-stopped' | 'stopping-receive' | 'waiting-handlers' | 'stopping-enqueue' | 'disconnecting' | 'stopped';
 /**
  * Configuration for shutdown manager.
  */
@@ -64,6 +64,17 @@ export declare class ShutdownManager {
      * Decrement processing counter.
      */
     decrementProcessing(): void;
+    /**
+     * Stops receiving new messages without performing full shutdown.
+     * After calling this, no new messages will be delivered from the transport.
+     * The transport remains connected for later shutdown.
+     *
+     * Use this when you need to stop receiving before waiting for idle,
+     * for example to coordinate waiting across multiple systems.
+     *
+     * @returns true if receiving was stopped, false if already stopped or shutting down
+     */
+    publicStopReceiving(): Promise<boolean>;
     /**
      * Performs graceful shutdown.
      */

package/dist/core/shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IAEzC,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAErC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAInC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAOxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IARtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAAQ;gBAGb,eAAe,EAAE,MAAM,MAAM,EAC7B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAClC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACzD,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAKtC;;OAEG;IACH,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,gBAAgB,IAAI,aAAa;IASjC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;YAOlB,WAAW;IAezB,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IAEzC,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAErC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAInC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAOxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IARtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAAQ;gBAGb,eAAe,EAAE,MAAM,MAAM,EAC7B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAClC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACzD,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAKtC;;OAEG;IACH,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,gBAAgB,IAAI,aAAa;IASjC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;;;;;;;;OASG;IACG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAW7C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;YAOlB,WAAW;IAezB,OAAO,CAAC,KAAK;CAGd"}

package/dist/core/shutdown.js

@@ -66,15 +66,37 @@ export class ShutdownManager {
         this.eventsBeingProcessed--;
     }
     /**
-     * Performs graceful shutdown.
+     * Stops receiving new messages without performing full shutdown.
+     * After calling this, no new messages will be delivered from the transport.
+     * The transport remains connected for later shutdown.
+     *
+     * Use this when you need to stop receiving before waiting for idle,
+     * for example to coordinate waiting across multiple systems.
+     *
+     * @returns true if receiving was stopped, false if already stopped or shutting down
      */
-    async shutdown() {
+    async publicStopReceiving() {
         if (this._state !== 'running') {
-            return;
+            return false;
         }
-        // 1. Stop receiving new messages
         this._state = 'stopping-receive';
         await this.stopReceiving();
+        this._state = 'receive-stopped';
+        return true;
+    }
+    /**
+     * Performs graceful shutdown.
+     */
+    async shutdown() {
+        // Allow shutdown from either 'running' or 'receive-stopped' states
+        if (this._state !== 'running' && this._state !== 'receive-stopped') {
+            return;
+        }
+        // 1. Stop receiving new messages (skip if already stopped)
+        if (this._state === 'running') {
+            this._state = 'stopping-receive';
+            await this.stopReceiving();
+        }
         // 2. Wait for handlers to idle
         this._state = 'waiting-handlers';
         await this.waitForIdle();

package/dist/core/shutdown.test.js

@@ -278,6 +278,81 @@ describe('ShutdownManager', () => {
             expect(stopReceiving).toHaveBeenCalledTimes(1);
         });
     });
+    describe('publicStopReceiving', () => {
+        beforeEach(() => {
+            manager = new ShutdownManager(getEnqueueCount, stopReceiving, disconnectTransport);
+        });
+        it('should return true when called from running state', async () => {
+            const result = await manager.publicStopReceiving();
+            expect(result).toBe(true);
+        });
+        it('should transition to receive-stopped state', async () => {
+            await manager.publicStopReceiving();
+            expect(manager.state).toBe('receive-stopped');
+        });
+        it('should call stopReceiving callback', async () => {
+            await manager.publicStopReceiving();
+            expect(stopReceiving).toHaveBeenCalledTimes(1);
+        });
+        it('should return false when called after already stopped receiving', async () => {
+            await manager.publicStopReceiving();
+            const result = await manager.publicStopReceiving();
+            expect(result).toBe(false);
+            expect(stopReceiving).toHaveBeenCalledTimes(1);
+        });
+        it('should return false when called after shutdown started', async () => {
+            manager.incrementProcessing();
+            const shutdownPromise = manager.shutdown();
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            const result = await manager.publicStopReceiving();
+            expect(result).toBe(false);
+            manager.decrementProcessing();
+            await shutdownPromise;
+        });
+        it('should still allow enqueue after stopReceiving', async () => {
+            await manager.publicStopReceiving();
+            expect(manager.isEnqueueAllowed).toBe(true);
+        });
+        it('should allow shutdown to complete after publicStopReceiving', async () => {
+            await manager.publicStopReceiving();
+            await manager.shutdown();
+            expect(manager.state).toBe('stopped');
+            expect(stopReceiving).toHaveBeenCalledTimes(1);
+            expect(disconnectTransport).toHaveBeenCalledTimes(1);
+        });
+        it('should skip stopReceiving during shutdown if already called', async () => {
+            await manager.publicStopReceiving();
+            expect(stopReceiving).toHaveBeenCalledTimes(1);
+            await manager.shutdown();
+            expect(stopReceiving).toHaveBeenCalledTimes(1);
+        });
+        it('should allow waiting for idle after stopReceiving', async () => {
+            manager.incrementProcessing();
+            await manager.publicStopReceiving();
+            expect(manager.state).toBe('receive-stopped');
+            expect(manager.getHandlersState().isIdle).toBe(false);
+            manager.decrementProcessing();
+            expect(manager.getHandlersState().isIdle).toBe(true);
+        });
+        it('should transition through correct states when shutdown follows publicStopReceiving', async () => {
+            const states = [];
+            disconnectTransport = mock(async () => {
+                states.push(manager.state);
+            });
+            manager = new ShutdownManager(getEnqueueCount, stopReceiving, disconnectTransport);
+            states.push(manager.state);
+            await manager.publicStopReceiving();
+            states.push(manager.state);
+            await manager.shutdown();
+            states.push(manager.state);
+            expect(states).toEqual([
+                'running',
+                'receive-stopped',
+                'disconnecting',
+                'stopped',
+            ]);
+        });
+    });
     describe('forceStop', () => {
         beforeEach(() => {
             manager = new ShutdownManager(getEnqueueCount, stopReceiving, disconnectTransport);

package/dist/index.cjs

@@ -942,14 +942,35 @@ var ShutdownManager = class {
     this.eventsBeingProcessed--;
   }
   /**
-   * Performs graceful shutdown.
+   * Stops receiving new messages without performing full shutdown.
+   * After calling this, no new messages will be delivered from the transport.
+   * The transport remains connected for later shutdown.
+   *
+   * Use this when you need to stop receiving before waiting for idle,
+   * for example to coordinate waiting across multiple systems.
+   *
+   * @returns true if receiving was stopped, false if already stopped or shutting down
    */
-  async shutdown() {
+  async publicStopReceiving() {
     if (this._state !== "running") {
-      return;
+      return false;
     }
     this._state = "stopping-receive";
     await this.stopReceiving();
+    this._state = "receive-stopped";
+    return true;
+  }
+  /**
+   * Performs graceful shutdown.
+   */
+  async shutdown() {
+    if (this._state !== "running" && this._state !== "receive-stopped") {
+      return;
+    }
+    if (this._state === "running") {
+      this._state = "stopping-receive";
+      await this.stopReceiving();
+    }
     this._state = "waiting-handlers";
     await this.waitForIdle();
     this._state = "stopping-enqueue";
@@ -1988,7 +2009,7 @@ var Matador = class {
     });
     this.shutdownManager = new ShutdownManager(
       () => this.fanout.eventsBeingEnqueuedCount,
-      () => this.stopReceiving(),
+      () => this.unsubscribeAll(),
       () => this.transport.disconnect(),
       config.shutdownConfig
     );
@@ -2127,6 +2148,24 @@ var Matador = class {
     }
     return true;
   }
+  /**
+   * Stops receiving new messages without performing full shutdown.
+   * After calling this, no new messages will be delivered from RabbitMQ.
+   * The transport remains connected for later shutdown.
+   *
+   * Use this when you need to coordinate shutdown across multiple systems:
+   * 1. Call stopReceiving() to stop new message delivery
+   * 2. Wait for both Matador and your other systems to idle
+   * 3. Call shutdown() to disconnect (or let NestJS lifecycle handle it)
+   *
+   * @returns true if receiving was stopped, false if not started or already stopped
+   */
+  async stopReceiving() {
+    if (!this.started) {
+      return false;
+    }
+    return this.shutdownManager.publicStopReceiving();
+  }
   /**
    * Gracefully shuts down Matador.
    */
@@ -2143,7 +2182,7 @@ var Matador = class {
   isConnected() {
     return this.transport.isConnected();
   }
-  async stopReceiving() {
+  async unsubscribeAll() {
     for (const subscription of this.subscriptions) {
       await subscription.unsubscribe();
     }