smart_message 0.0.10 → 0.0.12

data/examples/redis_enhanced/enhanced_02_fluent_api.rb

@@ -0,0 +1,331 @@
+#!/usr/bin/env ruby
+# examples/redis_queue/enhanced_02_fluent_api.rb
+# Redis Enhanced Transport - Fluent API Demonstration
+
+require_relative '../../lib/smart_message'
+require 'smart_message/transport/redis_enhanced_transport'
+
+puts "🚀 Redis Enhanced Transport - Fluent API Demo"
+puts "=" * 50
+
+# Create enhanced Redis transport instance
+transport = SmartMessage::Transport::RedisEnhancedTransport.new(
+  url: 'redis://localhost:6379',
+  db: 3,  # Use database 3 for fluent API examples
+  auto_subscribe: true
+)
+
+#==============================================================================
+# Define Message Classes for Microservices Architecture
+#==============================================================================
+
+class UserRegistrationMessage < SmartMessage::Base
+  from 'web-app'
+  to 'user-service'
+  
+  transport transport
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :user_id, required: true
+  property :email, required: true
+  property :name, required: true
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "👤 [USER SERVICE] New user registration: #{data['name']} (#{data['email']})"
+    puts "   User ID: #{data['user_id']}"
+    puts
+  end
+end
+
+class EmailNotificationMessage < SmartMessage::Base
+  from 'user-service'
+  to 'notification-service'
+  
+  transport transport
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :recipient, required: true
+  property :subject, required: true
+  property :body, required: true
+  property :template, default: 'default'
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "📧 [NOTIFICATION SERVICE] Sending email to #{data['recipient']}"
+    puts "   Subject: #{data['subject']}"
+    puts "   Template: #{data['template']}"
+    puts
+  end
+end
+
+class AnalyticsEventMessage < SmartMessage::Base
+  from 'various-services'
+  to 'analytics-service'
+  
+  transport transport
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :event_type, required: true
+  property :user_id
+  property :metadata, default: {}
+  property :timestamp, default: -> { Time.now.iso8601 }
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "📊 [ANALYTICS] Event: #{data['event_type']}"
+    puts "   User: #{data['user_id'] || 'anonymous'}"
+    puts "   Timestamp: #{data['timestamp']}"
+    puts "   Metadata: #{data['metadata']}"
+    puts
+  end
+end
+
+class AdminAlertMessage < SmartMessage::Base
+  from 'monitoring'
+  to 'admin-panel'
+  
+  transport transport
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :severity, required: true
+  property :message, required: true
+  property :service, required: true
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "⚠️  [ADMIN PANEL] #{data['severity'].upcase} from #{data['service']}"
+    puts "   #{data['message']}"
+    puts
+  end
+end
+
+#==============================================================================
+# Fluent API Demonstration Functions
+#==============================================================================
+
+def demo_basic_fluent_subscriptions(transport)
+  puts "🔗 Setting up fluent API subscriptions..."
+  puts
+  
+  # Basic fluent subscriptions
+  transport.where.from('web-app').subscribe
+  puts "✅ Subscribed to all messages FROM 'web-app'"
+  
+  transport.where.to('user-service').subscribe  
+  puts "✅ Subscribed to all messages TO 'user-service'"
+  
+  transport.where.type('EmailNotificationMessage').subscribe
+  puts "✅ Subscribed to all 'EmailNotificationMessage' messages"
+  puts
+end
+
+def demo_combined_fluent_subscriptions(transport)
+  puts "🎯 Setting up combined fluent API subscriptions..."
+  puts
+  
+  # Combined conditions
+  transport.where
+    .from('user-service')
+    .to('notification-service')
+    .subscribe
+  puts "✅ Subscribed to messages FROM 'user-service' TO 'notification-service'"
+  
+  transport.where
+    .type('AnalyticsEventMessage')
+    .from('web-app')
+    .subscribe
+  puts "✅ Subscribed to 'AnalyticsEventMessage' FROM 'web-app'"
+  
+  # Three-way combination
+  transport.where
+    .type('AdminAlertMessage')
+    .from('monitoring')
+    .to('admin-panel')
+    .subscribe
+  puts "✅ Subscribed to 'AdminAlertMessage' FROM 'monitoring' TO 'admin-panel'"
+  puts
+end
+
+def demo_wildcard_subscriptions(transport)
+  puts "🌟 Setting up wildcard pattern subscriptions..."
+  puts
+  
+  # Service-specific patterns
+  transport.where.from('analytics-service').subscribe
+  puts "✅ Subscribed to all messages from analytics service"
+  
+  transport.where.to('notification-service').subscribe  
+  puts "✅ Subscribed to all messages to notification service"
+  
+  # Catch-all analytics events
+  transport.where.type('AnalyticsEventMessage').subscribe
+  puts "✅ Subscribed to all analytics events regardless of source/destination"
+  puts
+end
+
+def publish_sample_workflow
+  puts "📤 Publishing sample microservices workflow..."
+  puts
+  
+  # 1. User registration from web app
+  registration = UserRegistrationMessage.new(
+    user_id: 'user_12345',
+    email: 'john.doe@example.com',
+    name: 'John Doe'
+  )
+  registration.publish
+  
+  sleep 0.1 # Small delay to see message processing order
+  
+  # 2. Welcome email notification
+  welcome_email = EmailNotificationMessage.new(
+    recipient: 'john.doe@example.com',
+    subject: 'Welcome to Our Platform!',
+    body: 'Thank you for joining us, John!',
+    template: 'welcome'
+  )
+  welcome_email.publish
+  
+  sleep 0.1
+  
+  # 3. Analytics event from user service
+  analytics = AnalyticsEventMessage.new(
+    event_type: 'user_registered',
+    user_id: 'user_12345',
+    metadata: { 
+      source: 'web_signup',
+      referrer: 'google_ads',
+      campaign: 'spring_2024'
+    }
+  )
+  analytics.from('user-service')  # Override default 'from'
+  analytics.publish
+  
+  sleep 0.1
+  
+  # 4. Another analytics event from web-app
+  web_analytics = AnalyticsEventMessage.new(
+    event_type: 'signup_completed',
+    user_id: 'user_12345',
+    metadata: { 
+      page: '/signup/complete',
+      time_spent: 45
+    }
+  )
+  web_analytics.from('web-app')
+  web_analytics.publish
+  
+  sleep 0.1
+  
+  # 5. Admin alert from monitoring
+  admin_alert = AdminAlertMessage.new(
+    severity: 'info',
+    message: 'New user registration completed successfully',
+    service: 'user-service'
+  )
+  admin_alert.publish
+  
+  puts "✅ Published complete user registration workflow (5 messages)"
+  puts
+end
+
+def demonstrate_pattern_building(transport)
+  puts "🔨 Demonstrating pattern building..."
+  puts
+  
+  # Show how patterns are built
+  builder = transport.where.from('web-app').to('user-service').type('UserRegistrationMessage')
+  pattern = builder.build
+  puts "Pattern for web-app → user-service UserRegistrationMessage:"
+  puts "   #{pattern}"
+  puts
+  
+  builder2 = transport.where.type('AnalyticsEventMessage')
+  pattern2 = builder2.build
+  puts "Pattern for any AnalyticsEventMessage:"
+  puts "   #{pattern2}"
+  puts
+  
+  builder3 = transport.where.from('monitoring')
+  pattern3 = builder3.build
+  puts "Pattern for any message from monitoring:"
+  puts "   #{pattern3}"
+  puts
+end
+
+#==============================================================================
+# Main Demonstration
+#==============================================================================
+
+begin
+  puts "🔧 Checking Redis connection..."
+  unless transport.connected?
+    puts "❌ Redis not available. Please start Redis server:"
+    puts "   brew services start redis  # macOS"
+    puts "   sudo service redis start   # Linux"
+    exit 1
+  end
+  puts "✅ Connected to Redis"
+  puts
+  
+  # Demonstrate pattern building first
+  demonstrate_pattern_building(transport)
+  
+  # Set up various fluent API subscriptions
+  demo_basic_fluent_subscriptions(transport)
+  demo_combined_fluent_subscriptions(transport)
+  demo_wildcard_subscriptions(transport)
+  
+  # Subscribe message classes to their handlers
+  UserRegistrationMessage.subscribe
+  EmailNotificationMessage.subscribe
+  AnalyticsEventMessage.subscribe
+  AdminAlertMessage.subscribe
+  
+  puts "⏳ Waiting for subscriptions to be established..."
+  sleep 1
+  
+  # Publish sample workflow
+  publish_sample_workflow
+  
+  puts "⏳ Processing messages (waiting 3 seconds)..."
+  sleep 3
+  
+  # Show active patterns
+  puts "📋 Active Pattern Subscriptions:"
+  pattern_subscriptions = transport.instance_variable_get(:@pattern_subscriptions)
+  if pattern_subscriptions && pattern_subscriptions.any?
+    pattern_subscriptions.each_with_index do |pattern, i|
+      puts "   #{i + 1}. #{pattern}"
+    end
+  else
+    puts "   No pattern subscriptions found"
+  end
+  puts
+  
+  puts "🎉 Fluent API Demo completed!"
+  puts "💡 Key takeaways:"
+  puts "   • Fluent API makes complex subscriptions readable"
+  puts "   • Combine .from(), .to(), and .type() for precise routing"
+  puts "   • Patterns are built as: type.from.to with wildcards (*)"
+  puts "   • Each .subscribe() call adds a new pattern to the transport"
+  
+rescue Interrupt
+  puts "\n👋 Demo interrupted by user"
+rescue => e
+  puts "💥 Error: #{e.message}"
+  puts e.backtrace[0..3]
+ensure
+  puts "\n🧹 Cleaning up..."
+  transport&.disconnect
+  puts "✅ Disconnected from Redis"
+end

data/examples/redis_enhanced/enhanced_03_dual_publishing.rb

@@ -0,0 +1,281 @@
+#!/usr/bin/env ruby
+# examples/redis_queue/enhanced_03_dual_publishing.rb
+# Redis Enhanced Transport - Dual Channel Publishing Demo
+
+require_relative '../../lib/smart_message'
+require 'smart_message/transport/redis_enhanced_transport'
+
+puts "🚀 Redis Enhanced Transport - Dual Channel Publishing Demo"
+puts "=" * 58
+
+# Create both enhanced and basic Redis transports to demonstrate compatibility
+enhanced_transport = SmartMessage::Transport::RedisEnhancedTransport.new(
+  url: 'redis://localhost:6379',
+  db: 4,  # Use database 4 for dual publishing examples
+  auto_subscribe: true
+)
+
+basic_transport = SmartMessage::Transport::RedisTransport.new(
+  url: 'redis://localhost:6379',
+  db: 4,  # Same database to show cross-transport communication
+  auto_subscribe: true
+)
+
+#==============================================================================
+# Define Message Classes for Both Transports
+#==============================================================================
+
+class OrderStatusMessage < SmartMessage::Base
+  from 'order-service'
+  to 'customer-notification'
+  
+  transport enhanced_transport
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :order_id, required: true
+  property :status, required: true
+  property :customer_email, required: true
+  property :updated_at, default: -> { Time.now.iso8601 }
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "📋 [ENHANCED] Order #{data['order_id']} status: #{data['status']}"
+    puts "   Customer: #{data['customer_email']}"
+    puts "   Channel: Enhanced (dual publishing)"
+    puts "   From: #{header.from} → To: #{header.to}"
+    puts
+  end
+end
+
+# Same message class but using basic transport
+class LegacyOrderMessage < SmartMessage::Base
+  from 'legacy-system'
+  
+  transport basic_transport
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :order_id, required: true
+  property :action, required: true
+  property :details, default: {}
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "🔄 [BASIC] Legacy order #{data['order_id']} - #{data['action']}"
+    puts "   Channel: Basic (single channel)"
+    puts "   From: #{header.from}"
+    puts
+  end
+end
+
+# Message that demonstrates backwards compatibility
+class CompatibilityTestMessage < SmartMessage::Base
+  from 'test-service'
+  to 'compatibility-test'
+  
+  # Will be configured dynamically to test both transports
+  serializer SmartMessage::Serializer::Json.new
+  
+  property :test_id, required: true
+  property :transport_type, required: true
+  property :message_content, required: true
+  
+  def self.process(wrapper)
+    header, payload = wrapper.split
+    data = JSON.parse(payload)
+    
+    puts "🧪 [#{data['transport_type'].upcase}] Test #{data['test_id']}"
+    puts "   Content: #{data['message_content']}"
+    puts "   From: #{header.from} → To: #{header.to}"
+    puts
+  end
+end
+
+#==============================================================================
+# Demonstration Functions
+#==============================================================================
+
+def demonstrate_dual_publishing
+  puts "🔄 Demonstrating dual channel publishing..."
+  puts "Enhanced transport publishes to BOTH channels:"
+  puts "  1. Original channel: 'OrderStatusMessage'"
+  puts "  2. Enhanced channel: 'orderstatusmessage.order_service.customer_notification'"
+  puts
+  
+  # Publish enhanced message
+  order_status = OrderStatusMessage.new(
+    order_id: 'ORD-2024-001',
+    status: 'shipped',
+    customer_email: 'customer@example.com'
+  )
+  
+  puts "📤 Publishing OrderStatusMessage (enhanced transport)..."
+  order_status.publish
+  puts "✅ Message published to both original and enhanced channels"
+  puts
+end
+
+def demonstrate_backwards_compatibility
+  puts "🔙 Demonstrating backwards compatibility..."
+  puts "Enhanced transport should receive messages from basic transport"
+  puts
+  
+  # Publish from basic transport
+  legacy_message = LegacyOrderMessage.new(
+    order_id: 'ORD-LEGACY-001',
+    action: 'processed',
+    details: { processor: 'legacy_v1.2', timestamp: Time.now.to_i }
+  )
+  
+  puts "📤 Publishing from basic Redis transport..."
+  legacy_message.publish
+  puts "✅ Basic transport message published"
+  puts
+end
+
+def demonstrate_cross_transport_subscriptions(enhanced_transport)
+  puts "🌉 Setting up cross-transport subscriptions..."
+  puts
+  
+  # Enhanced transport subscribes to basic transport patterns
+  enhanced_transport.subscribe_pattern("LegacyOrderMessage")  # Basic channel name
+  enhanced_transport.subscribe_pattern("*.legacy_system.*")    # Enhanced pattern that won't match basic
+  
+  puts "✅ Enhanced transport subscribed to:"
+  puts "   • 'LegacyOrderMessage' (basic channel)"
+  puts "   • '*.legacy_system.*' (enhanced pattern)"
+  puts
+end
+
+def test_transport_compatibility
+  puts "🧪 Testing transport compatibility..."
+  puts
+  
+  # Test 1: Enhanced message with enhanced transport
+  CompatibilityTestMessage.config { transport enhanced_transport }
+  
+  enhanced_test = CompatibilityTestMessage.new(
+    test_id: 'TEST-001',
+    transport_type: 'enhanced',
+    message_content: 'Testing dual channel publishing'
+  )
+  
+  puts "📤 Test 1: Enhanced transport with enhanced message..."
+  enhanced_test.publish
+  
+  # Test 2: Basic message with basic transport
+  CompatibilityTestMessage.config { transport basic_transport }
+  
+  basic_test = CompatibilityTestMessage.new(
+    test_id: 'TEST-002', 
+    transport_type: 'basic',
+    message_content: 'Testing single channel publishing'
+  )
+  
+  puts "📤 Test 2: Basic transport with basic message..."
+  basic_test.publish
+  puts
+end
+
+def show_channel_comparison
+  puts "📊 Channel Comparison:"
+  puts "┌─────────────────┬───────────────────────┬────────────────────────────────────┐"
+  puts "│ Transport Type  │ Original Channel      │ Enhanced Channel                   │"
+  puts "├─────────────────┼───────────────────────┼────────────────────────────────────┤"
+  puts "│ Basic           │ MessageClassName      │ (none)                             │"
+  puts "│ Enhanced        │ MessageClassName      │ messageclassname.from.to           │"
+  puts "└─────────────────┴───────────────────────┴────────────────────────────────────┘"
+  puts
+  
+  puts "📋 Pattern Matching Examples:"
+  puts "• Basic pattern:    'OrderStatusMessage'"
+  puts "• Enhanced pattern: 'orderstatusmessage.order_service.customer_notification'"
+  puts "• Wildcard pattern: '*.order_service.*' (matches all from order-service)"
+  puts "• Type pattern:     'orderstatusmessage.*.*' (matches all order status messages)"
+  puts
+end
+
+def monitor_redis_channels
+  puts "👀 Monitoring Redis channels (simulation)..."
+  puts "If you were monitoring Redis, you would see:"
+  puts
+  puts "BASIC TRANSPORT publishes to:"
+  puts "  ├─ 'LegacyOrderMessage'"
+  puts "  └─ 'CompatibilityTestMessage'"
+  puts
+  puts "ENHANCED TRANSPORT publishes to:"
+  puts "  ├─ 'OrderStatusMessage' (backwards compatibility)"
+  puts "  ├─ 'orderstatusmessage.order_service.customer_notification' (enhanced)"
+  puts "  ├─ 'CompatibilityTestMessage' (backwards compatibility)"  
+  puts "  └─ 'compatibilitytestmessage.test_service.compatibility_test' (enhanced)"
+  puts
+end
+
+#==============================================================================
+# Main Demonstration
+#==============================================================================
+
+begin
+  puts "🔧 Checking Redis connections..."
+  unless enhanced_transport.connected? && basic_transport.connected?
+    puts "❌ Redis not available. Please start Redis server:"
+    puts "   brew services start redis  # macOS"
+    puts "   sudo service redis start   # Linux"
+    exit 1
+  end
+  puts "✅ Connected to Redis (both transports)"
+  puts
+  
+  # Show channel comparison
+  show_channel_comparison
+  
+  # Set up cross-transport subscriptions
+  demonstrate_cross_transport_subscriptions(enhanced_transport)
+  
+  # Subscribe message classes
+  OrderStatusMessage.subscribe
+  LegacyOrderMessage.subscribe
+  CompatibilityTestMessage.subscribe
+  
+  puts "⏳ Waiting for subscriptions to be established..."
+  sleep 1
+  
+  # Run demonstrations
+  demonstrate_dual_publishing
+  sleep 0.5
+  
+  demonstrate_backwards_compatibility  
+  sleep 0.5
+  
+  test_transport_compatibility
+  sleep 1
+  
+  puts "⏳ Processing messages (waiting 3 seconds)..."
+  sleep 3
+  
+  # Show monitoring simulation
+  monitor_redis_channels
+  
+  puts "🎉 Dual Publishing Demo completed!"
+  puts
+  puts "💡 Key Insights:"
+  puts "   • Enhanced transport publishes to BOTH original and enhanced channels"
+  puts "   • This provides backwards compatibility with basic Redis transport"
+  puts "   • Enhanced patterns allow more sophisticated routing"
+  puts "   • Basic transport only publishes to original channels"
+  puts "   • Both transports can coexist and communicate"
+  
+rescue Interrupt
+  puts "\n👋 Demo interrupted by user"
+rescue => e
+  puts "💥 Error: #{e.message}"
+  puts e.backtrace[0..3]
+ensure
+  puts "\n🧹 Cleaning up..."
+  enhanced_transport&.disconnect
+  basic_transport&.disconnect
+  puts "✅ Disconnected from Redis (both transports)"
+end