@onlineapps/service-wrapper 2.0.48 → 2.0.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/service-wrapper",
-  "version": "2.0.48",
+  "version": "2.0.50",
   "description": "Thin orchestration layer for microservices - delegates all infrastructure concerns to specialized connectors",
   "main": "src/index.js",
   "scripts": {

package/src/ServiceWrapper.js

@@ -485,6 +485,11 @@ class ServiceWrapper {
           console.warn('Monitoring initialization failed (non-critical):', error.message);
         }
       }
+      
+      // Register MQ channel close hooks and health monitoring AFTER monitoring is initialized
+      if (this.mqClient) {
+        await this._registerMQHooks();
+      }
 
       // Initialize cache if configured
       if (this.config.wrapper?.cache?.enabled === true) {
@@ -557,6 +562,68 @@ class ServiceWrapper {
     }
   }
 
+  /**
+   * Register MQ channel close hooks and health monitoring
+   * Must be called AFTER monitoring is initialized
+   * @private
+   */
+  async _registerMQHooks() {
+    if (!this.mqClient || !this.mqClient._transport) {
+      return;
+    }
+    
+    // Access the underlying transport (RabbitMQClient) to register hooks
+    const transport = this.mqClient._transport;
+    
+    if (typeof transport.onChannelClose === 'function') {
+      // Register hook for all channel types
+      transport.onChannelClose('all', (details) => {
+        const logData = {
+          type: details.type,
+          reason: details.reason,
+          error: details.error ? {
+            message: details.error.message,
+            code: details.error.code,
+            stack: details.error.stack
+          } : null,
+          timestamp: details.timestamp,
+          connectionState: details.connectionState,
+          channelCreatedAt: details.channelCreatedAt,
+          lastOperation: details.lastOperation
+        };
+        
+        if (this.monitoring && this.monitoring.error) {
+          this.monitoring.error(`MQ Channel Closed: ${details.type}`, logData);
+        }
+        console.error(`[ServiceWrapper] [MQ] Channel closed: ${details.type} - ${details.reason}`);
+      });
+      
+      this.logger?.info('MQ channel close hooks registered');
+    }
+    
+    // Register health shutdown handler
+    if (typeof transport.on === 'function') {
+      transport.on('health:shutdown', (health) => {
+        console.error('[ServiceWrapper] [MQ] Health shutdown triggered - shutting down service');
+        if (this.monitoring && this.monitoring.error) {
+          this.monitoring.error('MQ Health Shutdown', {
+            issues: health.issues,
+            timestamp: health.timestamp
+          });
+        }
+        // Graceful shutdown
+        this.shutdown().then(() => {
+          process.exit(1);
+        }).catch((err) => {
+          console.error('[ServiceWrapper] Shutdown error:', err);
+          process.exit(1);
+        });
+      });
+      
+      this.logger?.info('MQ health shutdown handler registered');
+    }
+  }
+
   /**
    * Initialize MQ connection
    * @private
@@ -569,6 +636,39 @@ class ServiceWrapper {
 
     const serviceName = this.config.service?.name || 'unnamed-service';
 
+    // Health monitoring and channel close hooks configuration
+    const healthCheckConfig = {
+      healthCheckInterval: this.config.wrapper?.mq?.healthCheckInterval || 30000, // 30s
+      healthCheckEnabled: this.config.wrapper?.mq?.healthCheckEnabled !== false, // Default: true
+      criticalHealthShutdown: this.config.wrapper?.mq?.criticalHealthShutdown !== false, // Default: true
+      criticalHealthShutdownDelay: this.config.wrapper?.mq?.criticalHealthShutdownDelay || 60000, // 60s
+      // Health reporting callbacks
+      healthReportCallback: async (health) => {
+        if (this.monitoring && this.monitoring.info) {
+          this.monitoring.info('MQ Health Check', {
+            healthy: health.healthy,
+            issues: health.issues,
+            consumers: health.consumers,
+            queues: health.queues,
+            channels: health.channels
+          });
+        }
+      },
+      healthCriticalCallback: async (health) => {
+        if (this.monitoring && this.monitoring.error) {
+          this.monitoring.error('MQ CRITICAL HEALTH', {
+            issues: health.issues,
+            consumers: health.consumers,
+            queues: health.queues,
+            channels: health.channels,
+            timestamp: health.timestamp
+          });
+        }
+        // Also log to console for visibility
+        console.error('[ServiceWrapper] [MQ] CRITICAL HEALTH:', health.issues);
+      }
+    };
+
     this.mqClient = new MQConnector({
       type: 'rabbitmq',
       host: mqUrl,
@@ -578,12 +678,19 @@ class ServiceWrapper {
       prefetch: this.config.wrapper?.mq?.prefetch || 10,
       durable: true,
       noAck: false,
-      logger: this.logger || console
+      logger: this.logger || console,
+      ...healthCheckConfig
     });
 
+    // Register channel close hooks AFTER mqClient is created but BEFORE connect
+    // Access the underlying transport (RabbitMQClient) to register hooks
+    // Note: transport is created during connect(), so we need to register hooks after connect
+    // We'll do this in a separate method called after connect
+
     try {
       await this.mqClient.connect();
       this.logger?.info('MQ connector initialized');
+      
     } catch (error) {
       const message = `[MQConnector] Unable to connect to RabbitMQ at ${mqUrl}. ` +
         'Verify that api_services_queuer is running and accessible. ' +