queen-mq 0.12.2 → 0.12.3

package/client-v2/Queen.js

@@ -34,10 +34,12 @@ export class Queen {
     // Create buffer manager
     this.#bufferManager = new BufferManager(this.#httpClient)
 
-    // Setup graceful shutdown
-    this.#setupGracefulShutdown()
+    // Setup graceful shutdown (opt-out via handleSignals: false)
+    if (this.#config.handleSignals) {
+      this.#setupGracefulShutdown()
+    }
     
-    logger.log('Queen.constructor', { status: 'initialized', urls: this.#config.urls.length })
+    logger.log('Queen.constructor', { status: 'initialized', urls: this.#config.urls.length, handleSignals: this.#config.handleSignals })
   }
 
   #normalizeConfig(config) {
@@ -454,6 +456,28 @@ export class Queen {
   // Graceful Shutdown
   // ===========================
 
+  /**
+   * Register SIGINT/SIGTERM handlers so the client flushes buffers before exit.
+   * Called automatically unless handleSignals is set to false.
+   */
+  enableGracefulShutdown() {
+    if (this.#shutdownHandlers.length > 0) return this
+    this.#setupGracefulShutdown()
+    return this
+  }
+
+  /**
+   * Remove previously registered SIGINT/SIGTERM handlers.
+   * Use this when Queen is embedded in a larger application that manages its own lifecycle.
+   */
+  disableGracefulShutdown() {
+    for (const cleanup of this.#shutdownHandlers) {
+      cleanup()
+    }
+    this.#shutdownHandlers = []
+    return this
+  }
+
   async close() {
     logger.log('Queen.close', 'Starting shutdown')
     console.log('Closing Queen client...')

package/client-v2/utils/defaults.js

@@ -15,7 +15,8 @@ export const CLIENT_DEFAULTS = {
   enableFailover: true,                // Auto-failover to other servers
   healthRetryAfterMillis: 5000,        // Retry unhealthy backends after 5 seconds
   bearerToken: null,                   // Bearer token for proxy authentication
-  headers: {}                          // Custom headers to include in every request
+  headers: {},                         // Custom headers to include in every request
+  handleSignals: true                  // Register SIGINT/SIGTERM handlers (disable when used as a library)
 }
 
 export const QUEUE_DEFAULTS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "queen-mq",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "type": "module",
   "description": "High-performance C++ message queue backed by PostgreSQL",
   "main": "client-v2/index.js",