nats_wave 1.1.5 → 1.1.7

data/lib/generators/nats_wave/templates/initializer.rb

@@ -4,53 +4,110 @@ begin
     Rails.logger.info "Initializing NATS Wave with URL: #{ENV['NATS_URL']}"
     
     NatsWave.configure do |config|
+        # === CORE CONNECTION SETTINGS ===
         config.nats_url = ENV.fetch('NATS_URL', 'nats://localhost:4222')
         config.service_name = ENV.fetch('NATS_SERVICE_NAME',
-                                 Rails.application.class.name.deconstantize.underscore)
+                                        Rails.application.class.name.deconstantize.underscore)
         config.connection_pool_size = 10
         config.reconnect_attempts = 3
         
         Rails.logger.info "NATS URL: #{config.nats_url}"
         Rails.logger.info "Service Name: #{config.service_name}"
         
-        # Publishing
-        config.publishing_enabled = !Rails.env.test?
-        config.async_publishing = Rails.env.production?
-        config.default_subject_prefix = config.service_name
+        # === PUBLISHING CONFIGURATION ===
+        config.publishing_enabled = !Rails.env.test?        # Disable in test environment
+        config.async_publishing = Rails.env.production?     # Async only in production
+        config.default_subject_prefix = config.service_name # Use service name as prefix
         
-        # Subscription
-        config.subscription_enabled = !Rails.env.test?
-        config.queue_group = "#{config.service_name}_consumers"
+        # === SUBSCRIPTION CONFIGURATION ===
+        config.subscription_enabled = !Rails.env.test?      # Disable in test environment
+        config.queue_group = "#{config.service_name}_consumers" # Queue group for load balancing
         
-        # Error Handling
-        config.max_retries = 3
-        config.retry_delay = 5
-        config.dead_letter_queue = "failed_messages"
+        # === ERROR HANDLING ===
+        config.max_retries = 3                              # Max retry attempts
+        config.retry_delay = 5                              # Base retry delay in seconds
+        config.dead_letter_queue = "failed_messages"        # Failed message storage
         
-        # Authentication (optional)
-        # config.middleware_authentication_enabled = true
-        # config.auth_secret_key = ENV['NATS_AUTH_SECRET']
+        # === AUTHENTICATION (Optional) ===
+        if ENV['NATS_AUTH_SECRET'].present?
+            config.middleware_authentication_enabled = true
+            config.auth_secret_key = ENV['NATS_AUTH_SECRET']
+        end
+        
+        # === VALIDATION (Optional) ===
+        if ENV['SCHEMA_REGISTRY_URL'].present?
+            config.middleware_validation_enabled = true
+            config.schema_registry_url = ENV['SCHEMA_REGISTRY_URL']
+        end
         
-        # Validation (optional)
-        # config.middleware_validation_enabled = true
-        # config.schema_registry_url = ENV['SCHEMA_REGISTRY_URL']
+        # === LOGGING ===
+        config.middleware_logging_enabled = true
+        config.log_level = Rails.env.production? ? 'info' : 'debug'
     end
     
     Rails.logger.info "NATS Wave configuration completed successfully"
 rescue => e
     Rails.logger.error "Failed to configure NATS Wave: #{e.message}"
     Rails.logger.error e.backtrace.join("\n")
+    
+    # Optional: Re-raise in development to catch configuration issues early
+    raise e if Rails.env.development?
 end
 
+# === AUTOMATIC SUBSCRIBER STARTUP ===
 Rails.application.config.after_initialize do
     Thread.new do
-        sleep 2 # Give Rails time to boot
+        sleep 2 # Give Rails time to boot and load all models
         begin
+            # Start subscriber - this will automatically process all registered model subscriptions
             NatsWave.start_subscriber
             Rails.logger.info "✅ NatsWave subscriber started successfully"
+            
+            # Optional: Log subscription statistics
+            stats = NatsWave::ModelRegistry.subscription_stats
+            Rails.logger.info "📊 Active subscriptions: #{stats[:total_subscriptions]} across #{stats[:models_with_subscriptions]} models"
+        
         rescue StandardError => e
             Rails.logger.error "Failed to start NatsWave subscriber: #{e.message}"
             Rails.logger.error e.backtrace.join("\n")
+            
+            # Optional: Alert monitoring systems
+            if defined?(Sentry)
+                Sentry.capture_exception(e, tags: { component: 'nats_wave_startup' })
+            end
+        end
+    end
+end
+
+# === DATADOG METRICS INTEGRATION (Optional) ===
+if defined?(Datadog::Statsd) && !Rails.env.test?
+    # Get application version safely
+    app_version = begin
+                      Rails.application.config.version
+                  rescue
+                      'unknown'
+                  end
+    
+    NatsWave::Metrics.configure_datadog(
+            namespace: "#{Rails.application.class.name.deconstantize.underscore}.nats_wave",
+            tags: {
+                    service: NatsWave.configuration.service_name,
+                    environment: Rails.env,
+                    version: app_version
+            }
+    )
+    Rails.logger.info "📈 Datadog metrics integration enabled"
+end
+
+# === GRACEFUL SHUTDOWN (Optional) ===
+at_exit do
+    begin
+        if defined?(NatsWave) && NatsWave.client
+            Rails.logger.info "🛑 Shutting down NatsWave connections..."
+            NatsWave.client.disconnect!
+            Rails.logger.info "✅ NatsWave shutdown complete"
         end
+    rescue => e
+        Rails.logger.error "Error during NatsWave shutdown: #{e.message}"
     end
 end

data/lib/nats_wave/adapters/datadog_metrics.rb

@@ -77,7 +77,7 @@ module NatsWave
                 {
                         service: @service_name,
                         environment: ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'unknown',
-                        version: ENV['APP_VERSION'] || '1.1.5'
+                        version: ENV['APP_VERSION'] || '1.1.7'
                 }
             end