smart_message 0.0.12 → 0.0.16

data/examples/memory/00_run_all_demos.rb

@@ -0,0 +1,317 @@
+#!/usr/bin/env ruby
+# examples/memory/00_run_all_demos.rb
+#
+# Master Demo Runner - Executes All SmartMessage Memory Transport Examples
+#
+# This script runs all the demo programs in the examples/memory directory
+# in sequence, with clear banners to show which demo is currently running.
+
+require 'fileutils'
+require 'pathname'
+
+class SmartMessageDemoRunner
+  DEMO_PROGRAMS = [
+    {
+      file: "01_message_deduplication_demo.rb",
+      title: "Message Deduplication with DDQ",
+      description: "Demonstrates message deduplication patterns and duplicate message prevention",
+      duration: "~10 seconds"
+    },
+    {
+      file: "02_dead_letter_queue_demo.rb", 
+      title: "Dead Letter Queue & Error Handling",
+      description: "Shows DLQ pattern implementation with circuit breakers and error recovery",
+      duration: "~15 seconds"
+    },
+    {
+      file: "03_point_to_point_orders.rb",
+      title: "Point-to-Point Order Processing",
+      description: "Order processing system with 1:1 messaging between OrderService and PaymentService",
+      duration: "~8 seconds"
+    },
+    {
+      file: "04_publish_subscribe_events.rb",
+      title: "Publish-Subscribe Event Broadcasting",
+      description: "Event-driven architecture with multiple subscribers (Email, SMS, Audit)",
+      duration: "~10 seconds"
+    },
+    {
+      file: "05_many_to_many_chat.rb",
+      title: "Many-to-Many Chat System",
+      description: "Interactive chat system with rooms, bots, and human agents",
+      duration: "~12 seconds"
+    },
+    {
+      file: "06_stdout_publish_only.rb",
+      title: "STDOUT Transport (Publish-Only)",
+      description: "Demonstrates STDOUT transport for logging and external tool integration",
+      duration: "~5 seconds"
+    },
+    {
+      file: "07_proc_handlers_demo.rb",
+      title: "Proc-Based Message Handlers",
+      description: "Flexible message handlers using blocks, procs, lambdas, and methods",
+      duration: "~8 seconds"
+    },
+    {
+      file: "08_custom_logger_demo.rb",
+      title: "Custom Logging Implementations",
+      description: "Advanced logging with multiple loggers and custom formatting",
+      duration: "~12 seconds"
+    },
+    {
+      file: "09_error_handling_demo.rb",
+      title: "Comprehensive Error Handling",
+      description: "Error handling strategies, validation failures, and graceful degradation",
+      duration: "~10 seconds"
+    },
+    {
+      file: "10_entity_addressing_basic.rb",
+      title: "Entity Addressing Basics",
+      description: "Message routing by entity addresses with FROM/TO/REPLY_TO patterns",
+      duration: "~8 seconds"
+    },
+    {
+      file: "11_entity_addressing_with_filtering.rb",
+      title: "Advanced Entity Addressing & Filtering",
+      description: "Complex filtering patterns with regex-based address matching",
+      duration: "~10 seconds"
+    },
+    {
+      file: "12_regex_filtering_microservices.rb",
+      title: "Microservices with Regex Filtering",
+      description: "Service-to-service communication with environment-based filtering",
+      duration: "~8 seconds"
+    },
+    {
+      file: "13_header_block_configuration.rb",
+      title: "Header Block Configuration",
+      description: "Dynamic header configuration with block-based modification",
+      duration: "~6 seconds"
+    },
+    {
+      file: "14_global_configuration_demo.rb",
+      title: "Global Configuration Management",
+      description: "Global transport settings and configuration inheritance",
+      duration: "~8 seconds"
+    },
+    {
+      file: "15_logger_demo.rb",
+      title: "Advanced Logger Configuration",
+      description: "Logger configuration, log levels, and SmartMessage lifecycle integration",
+      duration: "~10 seconds"
+    },
+    {
+      file: "16_pretty_print_demo.rb",
+      title: "Message Pretty-Printing",
+      description: "Message inspection and debugging with pretty-print formatting",
+      duration: "~5 seconds"
+    }
+  ].freeze
+
+  def initialize
+    @base_dir = File.dirname(__FILE__)
+    @total_demos = DEMO_PROGRAMS.length
+    @start_time = Time.now
+  end
+
+  def run_all
+    print_main_banner
+    print_overview
+    
+    DEMO_PROGRAMS.each_with_index do |demo, index|
+      run_demo(demo, index + 1)
+    end
+    
+    print_completion_summary
+  end
+
+  private
+
+  # Helper method to calculate visual width of string accounting for emoji
+  def visual_width(str)
+    # Remove ANSI escape sequences if any
+    clean_str = str.gsub(/\e\[[0-9;]*m/, '')
+    
+    # Count emoji and other wide characters
+    emoji_count = clean_str.scan(/[\u{1F600}-\u{1F64F}]|[\u{1F300}-\u{1F5FF}]|[\u{1F680}-\u{1F6FF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]/).length
+    
+    # Each emoji takes up 2 visual columns but counts as 1 character
+    # So we add the emoji_count to get the actual visual width
+    clean_str.length + emoji_count
+  end
+
+  # Helper method to pad string to exact visual width
+  def pad_to_width(str, target_width)
+    current_width = visual_width(str)
+    if current_width <= target_width
+      str + (" " * (target_width - current_width))
+    else
+      # Truncate if too long, being careful about emoji
+      str[0...(target_width - current_width)]
+    end
+  end
+
+  def print_main_banner
+    puts "\n"
+    puts "█" * 100
+    puts "█" + " " * 98 + "█"
+    puts "█" + pad_to_width("        🚀 SMARTMESSAGE COMPREHENSIVE DEMO SUITE 🚀        ", 98) + "█"
+    puts "█" + " " * 98 + "█"
+    puts "█" + pad_to_width("  Running all #{@total_demos} demo programs to showcase SmartMessage capabilities  ", 98) + "█"
+    puts "█" + " " * 98 + "█"
+    puts "█" * 100
+    puts "\n"
+  end
+
+  def print_overview
+    puts "📋 DEMO OVERVIEW:"
+    puts "=" * 80
+    
+    DEMO_PROGRAMS.each_with_index do |demo, index|
+      printf "  %2d. %-35s %s\n", 
+             index + 1, 
+             demo[:title], 
+             "(#{demo[:duration]})"
+    end
+    
+    total_time = DEMO_PROGRAMS.sum { |demo| 
+      demo[:duration].scan(/\d+/).first.to_i 
+    }
+    
+    puts "=" * 80
+    puts "📊 Total estimated time: ~#{total_time} seconds (~#{(total_time/60.0).round(1)} minutes)"
+    puts "🎯 Each demo runs independently with clear separation"
+    puts "⏸️  Press Ctrl+C at any time to stop the demo suite"
+    puts "\n"
+  end
+
+  def run_demo(demo, demo_number)
+    file_path = File.join(@base_dir, demo[:file])
+    
+    unless File.exist?(file_path)
+      print_error_banner(demo_number, demo[:title], "File not found: #{demo[:file]}")
+      return
+    end
+
+    print_demo_banner(demo_number, demo)
+    
+    start_time = Time.now
+    begin
+      # Execute the demo program
+      success = system("cd #{@base_dir} && ruby #{demo[:file]}")
+      end_time = Time.now
+      
+      if success
+        print_demo_completion(demo_number, demo[:title], end_time - start_time)
+      else
+        print_demo_error(demo_number, demo[:title], "Demo exited with error code")
+      end
+      
+    rescue Interrupt
+      puts "\n"
+      puts "🛑 DEMO SUITE INTERRUPTED BY USER"
+      puts "   Completed #{demo_number - 1} of #{@total_demos} demos"
+      exit(0)
+    rescue => e
+      print_demo_error(demo_number, demo[:title], e.message)
+    end
+    
+    print_demo_separator
+  end
+
+  def print_demo_banner(demo_number, demo)
+    puts "┌" + "─" * 98 + "┐"
+    puts "│" + " " * 98 + "│"
+    puts "│" + pad_to_width("🔥 DEMO #{demo_number.to_s.rjust(2, '0')}/#{@total_demos.to_s.rjust(2, '0')}: #{demo[:title]}", 98) + "│"
+    puts "│" + " " * 98 + "│"
+    puts "│" + pad_to_width("📝 #{demo[:description]}", 98) + "│"
+    puts "│" + pad_to_width("⏱️  Expected duration: #{demo[:duration]}", 98) + "│"
+    puts "│" + pad_to_width("📁 File: #{demo[:file]}", 98) + "│"
+    puts "│" + " " * 98 + "│"
+    puts "└" + "─" * 98 + "┘"
+    puts "\n"
+  end
+
+  def print_demo_completion(demo_number, title, actual_time)
+    puts "\n"
+    puts "✅ DEMO #{demo_number.to_s.rjust(2, '0')} COMPLETED: #{title}"
+    puts "   ⏱️  Actual execution time: #{actual_time.round(2)} seconds"
+    puts "\n"
+  end
+
+  def print_demo_error(demo_number, title, error_message)
+    puts "\n"
+    puts "❌ DEMO #{demo_number.to_s.rjust(2, '0')} FAILED: #{title}"
+    puts "   🚨 Error: #{error_message}"
+    puts "   ⏭️  Continuing with next demo..."
+    puts "\n"
+  end
+
+  def print_error_banner(demo_number, title, error_message)
+    puts "┌" + "─" * 98 + "┐"
+    puts "│" + pad_to_width("❌ DEMO #{demo_number.to_s.rjust(2, '0')}/#{@total_demos.to_s.rjust(2, '0')} ERROR: #{title}", 98) + "│"
+    puts "│" + " " * 98 + "│"
+    puts "│" + pad_to_width("🚨 #{error_message}", 98) + "│"
+    puts "│" + " " * 98 + "│"
+    puts "└" + "─" * 98 + "┘"
+    puts "\n"
+  end
+
+  def print_demo_separator
+    puts "═" * 100
+    puts "\n"
+    sleep(1) # Brief pause between demos for readability
+  end
+
+  def print_completion_summary
+    total_time = Time.now - @start_time
+    
+    puts "\n"
+    puts "🏁" * 50
+    puts "🏁" + " " * 96 + "🏁"
+    puts "🏁" + pad_to_width("         🎉 ALL DEMOS COMPLETED SUCCESSFULLY! 🎉         ", 96) + "🏁"
+    puts "🏁" + " " * 96 + "🏁"
+    puts "🏁" + pad_to_width("  Total execution time: #{total_time.round(2)} seconds (#{(total_time/60.0).round(2)} minutes)  ", 96) + "🏁"
+    puts "🏁" + pad_to_width("  Demos completed: #{@total_demos}  ", 96) + "🏁"
+    puts "🏁" + " " * 96 + "🏁"
+    puts "🏁" * 50
+    puts "\n"
+    
+    puts "📋 WHAT YOU'VE SEEN:"
+    puts "=" * 80
+    puts "✅ Message deduplication and Dead Letter Queue patterns"
+    puts "✅ Point-to-point, publish-subscribe, and many-to-many messaging"  
+    puts "✅ STDOUT transport for debugging and external integration"
+    puts "✅ Advanced message handlers (procs, blocks, lambdas)"
+    puts "✅ Comprehensive logging and error handling strategies"
+    puts "✅ Entity addressing and advanced message filtering"
+    puts "✅ Microservices communication patterns"
+    puts "✅ Configuration management and message inspection"
+    puts "\n"
+    
+    puts "🚀 NEXT STEPS:"
+    puts "=" * 80
+    puts "• Explore individual demos: ruby examples/memory/<demo_file>"
+    puts "• Check out Redis Queue examples: examples/redis_queue/"
+    puts "• View comprehensive documentation: docs/"
+    puts "• Start building with SmartMessage in your projects!"
+    puts "\n"
+    
+    puts "💡 For more information:"
+    puts "   📖 README.md - Getting started guide"
+    puts "   🔧 examples/memory/README.md - Detailed example descriptions"
+    puts "   📚 https://github.com/MadBomber/smart_message - Full documentation"
+    puts "\n"
+  end
+end
+
+# Allow running directly or requiring as a library
+if __FILE__ == $0
+  puts "Starting SmartMessage Demo Suite..."
+  puts "Press Ctrl+C to interrupt at any time."
+  puts "\n"
+  
+  runner = SmartMessageDemoRunner.new
+  runner.run_all
+end

data/examples/memory/01_message_deduplication_demo.rb

@@ -64,11 +64,9 @@ def demonstrate_deduplication
   transport = SmartMessage::Transport::MemoryTransport.new
   
   OrderMessage.transport(transport)
-  OrderMessage.serializer(SmartMessage::Serializer::Json.new)
   OrderMessage.subscribe('OrderMessage.process')
   
   NotificationMessage.transport(transport)
-  NotificationMessage.serializer(SmartMessage::Serializer::Json.new)
   NotificationMessage.subscribe('NotificationMessage.process')
   
   # Clear any previous state
@@ -91,21 +89,13 @@ def demonstrate_deduplication
   # Test 1: OrderMessage with deduplication
   puts "--- Test 1: OrderMessage (with deduplication) ---"
   
-  # Create header with specific UUID
-  header = SmartMessage::Header.new(
-    uuid: uuid,
-    message_class: "OrderMessage",
-    published_at: Time.now,
-    publisher_pid: Process.pid,
-    version: 1,
-    from: "order-service"
-  )
-  
-  # First message
+  # First message (create normally, then set UUID for testing)
   order1 = OrderMessage.new(
-    _sm_header: header,
-    _sm_payload: { order_id: "ORD-001", amount: 99.99 }
+    order_id: "ORD-001", 
+    amount: 99.99
   )
+  # Override UUID for deduplication testing
+  order1._sm_header.uuid = uuid
   
   puts "Publishing first order message..."
   order1.publish
@@ -113,9 +103,11 @@ def demonstrate_deduplication
   
   # Second message with SAME UUID (should be deduplicated)
   order2 = OrderMessage.new(
-    _sm_header: header,
-    _sm_payload: { order_id: "ORD-002", amount: 149.99 }
+    order_id: "ORD-002", 
+    amount: 149.99
   )
+  # Use same UUID to test deduplication
+  order2._sm_header.uuid = uuid
   
   puts "Publishing duplicate order message (same UUID)..."
   order2.publish
@@ -129,21 +121,13 @@ def demonstrate_deduplication
   # Test 2: NotificationMessage without deduplication
   puts "--- Test 2: NotificationMessage (no deduplication) ---"
   
-  # Create header with same UUID
-  notification_header = SmartMessage::Header.new(
-    uuid: uuid,  # Same UUID as orders!
-    message_class: "NotificationMessage",
-    published_at: Time.now,
-    publisher_pid: Process.pid,
-    version: 1,
-    from: "notification-service"
-  )
-  
-  # First notification
+  # First notification (create normally, then set UUID)
   notif1 = NotificationMessage.new(
-    _sm_header: notification_header,
-    _sm_payload: { message: "Order confirmed", recipient: "customer@example.com" }
+    message: "Order confirmed", 
+    recipient: "customer@example.com"
   )
+  # Use same UUID as orders to show deduplication is per-message-class
+  notif1._sm_header.uuid = uuid
   
   puts "Publishing first notification..."
   notif1.publish
@@ -151,9 +135,11 @@ def demonstrate_deduplication
   
   # Second notification with same UUID (should NOT be deduplicated)
   notif2 = NotificationMessage.new(
-    _sm_header: notification_header,
-    _sm_payload: { message: "Order shipped", recipient: "customer@example.com" }
+    message: "Order shipped", 
+    recipient: "customer@example.com"
   )
+  # Use same UUID - NotificationMessage doesn't have deduplication enabled
+  notif2._sm_header.uuid = uuid
   
   puts "Publishing duplicate notification (same UUID)..."
   notif2.publish

data/examples/memory/02_dead_letter_queue_demo.rb

@@ -45,12 +45,11 @@ class PaymentMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:memory)
-    serializer SmartMessage::Serializer::Json.new
   end
   
-  def self.process(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload, symbolize_names: true)
     puts "  💳 Processing payment #{data[:payment_id]} for $#{data[:amount]}"
   end
@@ -68,12 +67,11 @@ class OrderMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:memory)
-    serializer SmartMessage::Serializer::Json.new
   end
   
-  def self.process(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload, symbolize_names: true)
     puts "  📦 Processing order #{data[:order_id]} with #{data[:items].size} items"
   end
@@ -90,12 +88,11 @@ class NotificationMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:memory)
-    serializer SmartMessage::Serializer::Json.new
   end
   
-  def self.process(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload, symbolize_names: true)
     puts "  📧 Sending #{data[:channel]} to user #{data[:user_id]}: #{data[:message]}"
   end

data/examples/memory/03_point_to_point_orders.rb

@@ -35,8 +35,7 @@ class OrderMessage < SmartMessage::Base
 
   # Configure to use memory transport for this example
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
   # Default processing - just logs the order
@@ -61,8 +60,7 @@ class PaymentResponseMessage < SmartMessage::Base
     description: "ISO8601 timestamp when the payment was processed"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
   def self.process(message)
@@ -208,7 +206,7 @@ class OrderProcessingDemo
     puts "• Point-to-point messaging between OrderService and PaymentService"
     puts "• Bidirectional communication with request/response pattern"
     puts "• JSON serialization of complex message data"
-    puts "• STDOUT transport with loopback for local demonstration"
+    puts "• Memory transport for local demonstration"
   end
 end
 

data/examples/memory/04_publish_subscribe_events.rb

@@ -31,13 +31,12 @@ class UserEventMessage < SmartMessage::Base
     description: "Additional event-specific data (source, location, IP, etc.)"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
   # Default processor - just logs the event
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     event_data = JSON.parse(message_payload)
     puts "📡 Event broadcasted: #{event_data['event_type']} for user #{event_data['user_id']}"
   end
@@ -51,13 +50,13 @@ class EmailService
     UserEventMessage.subscribe('EmailService.handle_user_event')
   end
 
-  def self.handle_user_event(wrapper)
+  def handle_event(message)
     service = new
-    service.process_event(wrapper)
+    service.process_event(message)
   end
 
-  def process_event(wrapper)
-    message_header, message_payload = wrapper.split
+  def process_event(message)
+    message_header, message_payload = message
     event_data = JSON.parse(message_payload)
     
     case event_data['event_type']
@@ -107,13 +106,13 @@ class SMSService
     UserEventMessage.subscribe('SMSService.handle_user_event')
   end
 
-  def self.handle_user_event(wrapper)
+  def handle_event(message)
     service = new
-    service.process_event(wrapper)
+    service.process_event(message)
   end
 
-  def process_event(wrapper)
-    message_header, message_payload = wrapper.split
+  def process_event(message)
+    message_header, message_payload = message
     event_data = JSON.parse(message_payload)
     
     case event_data['event_type']
@@ -173,18 +172,18 @@ class AuditService
     UserEventMessage.subscribe('AuditService.handle_user_event')
   end
 
-  def self.handle_user_event(wrapper)
+  def handle_event(message)
     # Use a singleton pattern for persistent audit log
     @@instance ||= new
-    @@instance.process_event(wrapper)
+    @@instance.process_event(message)
   end
 
   def self.get_summary
     @@instance&.get_audit_summary || {}
   end
 
-  def process_event(wrapper)
-    message_header, message_payload = wrapper.split
+  def process_event(message)
+    message_header, message_payload = message
     event_data = JSON.parse(message_payload)
     
     audit_entry = {

data/examples/memory/05_many_to_many_chat.rb

@@ -36,12 +36,11 @@ class ChatMessage < SmartMessage::Base
     description: "Additional message data (reactions, edit history, etc.)"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     chat_data = JSON.parse(message_payload)
     puts "💬 Chat message in #{chat_data['room_id']}: #{chat_data['content']}"
   end
@@ -65,12 +64,11 @@ class BotCommandMessage < SmartMessage::Base
     description: "ISO8601 timestamp when command was issued"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     command_data = JSON.parse(message_payload)
     puts "🤖 Bot command: #{command_data['command']} in #{command_data['room_id']}"
   end
@@ -94,12 +92,11 @@ class SystemNotificationMessage < SmartMessage::Base
     description: "Additional system event data and context"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     notif_data = JSON.parse(message_payload)
     puts "🔔 System: #{notif_data['content']} in #{notif_data['room_id']}"
   end
@@ -195,8 +192,8 @@ class HumanChatAgent
     @@agents[agent.user_id] = agent
   end
 
-  def handle_chat_message(wrapper)
-    message_header, message_payload = wrapper.split
+  def handle_message(message)
+    message_header, message_payload = message
     chat_data = JSON.parse(message_payload)
     
     # Only process messages from rooms we're in and not our own messages
@@ -211,8 +208,8 @@ class HumanChatAgent
     end
   end
 
-  def handle_system_notification(wrapper)
-    message_header, message_payload = wrapper.split
+  def handle_system_notification(message)
+    message_header, message_payload = message
     notif_data = JSON.parse(message_payload)
     
     # Only process notifications from rooms we're in
@@ -307,8 +304,8 @@ class BotAgent
     )
   end
 
-  def self.handle_bot_command(wrapper)
-    message_header, message_payload = wrapper.split
+  def handle_command(message)
+    message_header, message_payload = message
     command_data = JSON.parse(message_payload)
     @@bots ||= []
     
@@ -321,8 +318,8 @@ class BotAgent
     capable_bot&.process_command(command_data)
   end
 
-  def self.handle_chat_message(wrapper)
-    message_header, message_payload = wrapper.split
+  def handle_message(message)
+    message_header, message_payload = message
     chat_data = JSON.parse(message_payload)
     @@bots ||= []
     
@@ -498,8 +495,8 @@ class RoomManager
     notification.publish
   end
 
-  def self.handle_system_notification(wrapper)
-    message_header, message_payload = wrapper.split
+  def handle_system_notification(message)
+    message_header, message_payload = message
     @@instance ||= new
     @@instance.process_system_notification(message_header, message_payload)
   end