smart_message 0.0.13 → 0.0.16

data/examples/memory/09_error_handling_demo.rb

@@ -49,11 +49,11 @@ class UserRegistrationMessage < SmartMessage::Base
     description: "Timestamp when user account was created"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     user_data = JSON.parse(message_payload)
     puts "✅ User registration processed: #{user_data['username']} (#{user_data['email']})"
   end
@@ -97,11 +97,11 @@ class UserRegistrationMessageV2 < SmartMessage::Base
     description: "Timestamp when user account was created"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     user_data = JSON.parse(message_payload)
     puts "✅ User registration V2 processed: #{user_data['username']} (#{user_data['email']}, #{user_data['phone_number']})"
   end
@@ -118,7 +118,7 @@ class MultiRequiredMessage < SmartMessage::Base
   property :optional_field, description: "Optional field for comparison"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 end
 

data/examples/memory/10_entity_addressing_basic.rb

@@ -14,7 +14,7 @@ puts "🎯 SmartMessage Entity Addressing Demo"
 puts "=" * 50
 
 # Configure transport for demo
-transport = SmartMessage::Transport.create(:stdout, loopback: true)
+transport = SmartMessage::Transport::MemoryTransport.new
 serializer = SmartMessage::Serializer::Json.new
 
 # =============================================================================
@@ -39,12 +39,12 @@ class OrderMessage < SmartMessage::Base
   property :total_amount, required: true
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.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)
     puts "   🎯 FULFILLMENT SERVICE received order:"
     puts "      Order ID: #{data['order_id']}"
@@ -91,12 +91,12 @@ class SystemAnnouncementMessage < SmartMessage::Base
   property :effective_time, required: true
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.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)
     priority_icon = data['priority'] == 'high' ? '🚨' : '📢'
     puts "   #{priority_icon} ALL SERVICES received announcement:"
@@ -142,12 +142,12 @@ class UserLookupRequest < SmartMessage::Base
   property :requested_fields, default: ['name', 'email']
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.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)
     puts "   🔍 USER SERVICE received lookup request:"
     puts "      Request ID: #{data['request_id']}"
@@ -175,12 +175,12 @@ class UserLookupResponse < SmartMessage::Base
   property :error_message
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.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)
     puts "   ✅ WEB SERVICE received lookup response:"
     puts "      Request ID: #{data['request_id']}"
@@ -246,12 +246,12 @@ class PaymentMessage < SmartMessage::Base
   property :payment_method, default: 'credit_card'
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.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)
     gateway_icon = header.to.include?('backup') ? '🔄' : '🏦'
     puts "   #{gateway_icon} #{header.to.upcase} received payment:"
@@ -320,12 +320,12 @@ class ExternalAPIMessage < SmartMessage::Base
   property :partner_id, required: true
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.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)
     puts "   🌐 EXTERNAL PARTNER received API call:"
     puts "      API Call: #{data['api_call']}"

data/examples/memory/11_entity_addressing_with_filtering.rb

@@ -15,7 +15,7 @@ puts "🎯 SmartMessage Entity Addressing & Filtering Demo"
 puts "=" * 50
 
 # Configure transport for demo
-transport = SmartMessage::Transport.create(:stdout, loopback: true)
+transport = SmartMessage::Transport::MemoryTransport.new
 serializer = SmartMessage::Serializer::Json.new
 
 # =============================================================================
@@ -36,13 +36,13 @@ class ServiceMessage < SmartMessage::Base
   property :timestamp, default: -> { Time.now.to_s }
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
   
   # Different handlers for different subscription filters
-  def self.process_broadcast(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_broadcast(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   📻 BROADCAST HANDLER received:"
     puts "      Type: #{data['message_type']}"
@@ -50,9 +50,9 @@ class ServiceMessage < SmartMessage::Base
     puts "      Data: #{data['data']}"
   end
   
-  def self.process_directed(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_directed(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   🎯 DIRECTED HANDLER received:"
     puts "      Type: #{data['message_type']}"
@@ -60,9 +60,9 @@ class ServiceMessage < SmartMessage::Base
     puts "      Data: #{data['data']}"
   end
   
-  def self.process_from_admin(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_from_admin(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   👮 ADMIN HANDLER received:"
     puts "      Type: #{data['message_type']}"
@@ -152,12 +152,12 @@ class AlertMessage < SmartMessage::Base
   property :source_system
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
   
-  def self.process_critical_or_broadcast(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_broadcast(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     icon = data['severity'] == 'critical' ? '🚨' : '📢'
     puts "   #{icon} ALERT MONITOR received:"
@@ -166,9 +166,9 @@ class AlertMessage < SmartMessage::Base
     puts "      Alert: #{data['alert_text']}"
   end
   
-  def self.process_from_monitoring(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_from_monitoring(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   📊 MONITORING TEAM received:"
     puts "      From: #{header.from} (monitoring system)"
@@ -259,12 +259,12 @@ class OrderMessage < SmartMessage::Base
   property :total_amount, required: true
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
   
-  def self.process_high_priority(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_high_priority(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   🚀 HIGH PRIORITY ORDER HANDLER:"
     puts "      Order ID: #{data['order_id']} (PRIORITY: #{data['priority'].upcase})"
@@ -272,9 +272,9 @@ class OrderMessage < SmartMessage::Base
     puts "      Total: $#{data['total_amount']}"
   end
   
-  def self.process_normal(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_normal(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   📦 NORMAL ORDER HANDLER:"
     puts "      Order ID: #{data['order_id']}"
@@ -353,12 +353,12 @@ class ServiceRequest < SmartMessage::Base
   property :data
   
   config do
-    transport SmartMessage::Transport.create(:stdout, loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
   
-  def self.process_api_requests(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_api_requests(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   🌐 API SERVICE received request:"
     puts "      Request ID: #{data['request_id']}"
@@ -367,9 +367,9 @@ class ServiceRequest < SmartMessage::Base
     puts "      Reply To: #{header.reply_to}"
   end
   
-  def self.process_data_requests(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process_data_requests(message)
+    header = message._sm_header
+    payload = message
     data = JSON.parse(payload)
     puts "   💾 DATA SERVICE received request:"
     puts "      Request ID: #{data['request_id']}"

data/examples/memory/12_regex_filtering_microservices.rb

@@ -30,7 +30,7 @@ class MicroserviceMessage < SmartMessage::Base
 
   # Configure with STDOUT transport for demo visibility
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 end
 
@@ -42,9 +42,9 @@ class PaymentMessage < MicroserviceMessage
   property :amount, required: true
   property :currency, default: 'USD'
   
-  def self.process(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process(message)
+    header = message._sm_header
+    payload = message
     msg_data = JSON.parse(payload)
     puts "💳 PaymentMessage processed by #{self.name}"
     puts "   From: #{header.from} → To: #{header.to}"
@@ -61,9 +61,9 @@ class OrderMessage < MicroserviceMessage
   property :customer_id, required: true
   property :status, default: 'pending'
   
-  def self.process(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process(message)
+    header = message._sm_header
+    payload = message
     msg_data = JSON.parse(payload)
     puts "📦 OrderMessage processed by #{self.name}"
     puts "   From: #{header.from} → To: #{header.to}"
@@ -80,9 +80,9 @@ class AlertMessage < MicroserviceMessage
   property :component, required: true
   property :description, required: true
   
-  def self.process(wrapper)
-    header = wrapper._sm_header
-    payload = wrapper._sm_payload
+  def process(message)
+    header = message._sm_header
+    payload = message
     msg_data = JSON.parse(payload)
     puts "🚨 AlertMessage processed by #{self.name}"
     puts "   From: #{header.from} → To: #{header.to}"

data/examples/memory/14_global_configuration_demo.rb

@@ -24,14 +24,14 @@ puts
 puts "2. Configuring Logging with String Path:"
 SmartMessage.configure do |config|
   config.logger = "log/my_application.log"  # String = Lumberjack logger with this path
-  config.transport = SmartMessage::Transport::StdoutTransport.new(loopback: true)
-  config.serializer = SmartMessage::Serializer::Json.new
+  config.transport = SmartMessage::Transport::MemoryTransport.new
+  # Note: Serializers are configured per transport, not globally
 end
 
 puts "   Configured Logger: #{SmartMessage::Logger.default.class}"
 puts "   Log File: #{SmartMessage::Logger.default.log_file rescue 'N/A'}"
 puts "   Configured Transport: #{SmartMessage::Transport.default.class}"
-puts "   Configured Serializer: #{SmartMessage::Serializer.default.class}"
+puts "   Framework Default Serializer: #{SmartMessage::Serializer.default.class}"
 puts
 
 # Reset for next example
@@ -41,14 +41,14 @@ SmartMessage.reset_configuration!
 puts "3. Configuring with :default Symbol:"
 SmartMessage.configure do |config|
   config.logger = :default  # Use Lumberjack with default settings
-  config.transport = SmartMessage::Transport::StdoutTransport.new(loopback: true)
-  config.serializer = SmartMessage::Serializer::Json.new
+  config.transport = SmartMessage::Transport::MemoryTransport.new
+  # Note: Serializers are configured per transport, not globally
 end
 
 puts "   Configured Logger: #{SmartMessage::Logger.default.class}"
 puts "   Log File: #{SmartMessage::Logger.default.log_file rescue 'N/A'}"
 puts "   Configured Transport: #{SmartMessage::Transport.default.class}"
-puts "   Configured Serializer: #{SmartMessage::Serializer.default.class}"
+puts "   Framework Default Serializer: #{SmartMessage::Serializer.default.class}"
 puts
 
 # Example 4: Message classes automatically use global configuration
@@ -65,8 +65,8 @@ class NotificationMessage < SmartMessage::Base
     logger SmartMessage::Logger.default
   end
   
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     data = JSON.parse(message_payload)
     
     priority_emoji = case data['priority']
@@ -90,8 +90,8 @@ class OrderStatusMessage < SmartMessage::Base
     logger SmartMessage::Logger.default
   end
   
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     data = JSON.parse(message_payload)
     
     status_emoji = case data['status']
@@ -152,8 +152,8 @@ class SpecialMessage < SmartMessage::Base
     # transport and serializer still use global configuration
   end
   
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     data = JSON.parse(message_payload)
     puts "⭐ Special processing: #{data['content']}"
   end

data/examples/memory/README.md

@@ -1,16 +1,25 @@
 # Memory Transport Examples
 
-This directory contains demonstration programs that use SmartMessage's **Memory Transport** and **Stdout Transport** (with loopback). These examples show the fundamentals of SmartMessage without requiring external dependencies like Redis or message queues.
+This directory contains demonstration programs that use SmartMessage's **Memory Transport** and **STDOUT Transport**. These examples show the fundamentals of SmartMessage without requiring external dependencies like Redis or message queues.
 
 ## Transport Overview
 
-The Memory and Stdout (with loopback) transports are ideal for:
+### Memory Transport
+Perfect for local development with message processing:
 - **Learning SmartMessage fundamentals**
-- **Rapid prototyping and testing**
+- **Rapid prototyping and testing** 
 - **Single-process applications**
 - **Development and debugging**
+- **Local message processing**
 
-These transports keep all message routing in-memory within the current Ruby process.
+### STDOUT Transport
+Publish-only transport for debugging and integration:
+- **Debugging and logging**
+- **Integration with external tools**
+- **Development monitoring**
+- **One-way message output**
+
+The Memory transport keeps all message routing in-memory within the current Ruby process, while STDOUT transport outputs messages for external processing.
 
 ## Example Programs
 
@@ -32,7 +41,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 🛍️ 03_point_to_point_orders.rb
 **Demonstrates:** Point-to-point messaging (1:1)
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Order processing system between OrderService and PaymentService
 - Request/response message pattern
 - Automatic serialization of complex order data by transport
@@ -40,7 +49,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 📢 04_publish_subscribe_events.rb
 **Demonstrates:** Publish-subscribe messaging (1:many)
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - User event notification system
 - Multiple subscribers (EmailService, SMSService, AuditService)
 - Event-driven architecture
@@ -48,13 +57,21 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 💬 05_many_to_many_chat.rb  
 **Demonstrates:** Many-to-many messaging patterns
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Multi-user chat room system
 - Message broadcasting to multiple participants
 - User presence and room management
 - Complex message routing scenarios
 
-### 🎨 06_pretty_print_demo.rb
+### 📤 06_stdout_publish_only.rb
+**Demonstrates:** STDOUT transport publish-only usage
+**Transport:** StdoutTransport (publish-only)
+- Log message publishing to STDOUT
+- Metrics publishing in JSON format
+- Perfect for debugging and external tool integration
+- Shows pretty-print vs JSON formatting options
+
+### 🎨 16_pretty_print_demo.rb
 **Demonstrates:** Message pretty-printing and debugging
 **Transport:** None (utility demo)
 - Shows SmartMessage's `pretty_print` method
@@ -64,7 +81,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### ⚡ 07_proc_handlers_demo.rb
 **Demonstrates:** Proc-based message handlers
-**Transport:** StdoutTransport with loopback  
+**Transport:** MemoryTransport
 - Custom Proc handlers for message processing
 - Dynamic message routing
 - Flexible handler assignment
@@ -72,7 +89,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 📊 08_custom_logger_demo.rb
 **Demonstrates:** Custom logging implementations
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Multiple logger types and configurations
 - Custom logger classes
 - Log filtering and formatting
@@ -80,7 +97,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### ❌ 09_error_handling_demo.rb
 **Demonstrates:** Error handling strategies
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Various error scenarios and recovery patterns
 - Exception handling in message processors
 - Error propagation and logging
@@ -88,7 +105,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 🎯 10_entity_addressing_basic.rb
 **Demonstrates:** Basic entity addressing
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Message routing by entity addresses
 - Order processing with specific routing
 - Customer and payment entity handling
@@ -96,7 +113,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 🔍 11_entity_addressing_with_filtering.rb  
 **Demonstrates:** Advanced entity addressing with filters
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Complex filtering patterns
 - Regex-based address matching
 - Multiple entity types and routing rules
@@ -104,7 +121,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 🏢 12_regex_filtering_microservices.rb
 **Demonstrates:** Microservices with regex filtering
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Service-to-service communication patterns
 - Regular expression-based routing
 - Environment-based filtering (dev/staging/prod)
@@ -112,7 +129,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 📝 13_header_block_configuration.rb
 **Demonstrates:** Header configuration with blocks
-**Transport:** StdoutTransport
+**Transport:** StdoutTransport (publish-only)
 - Dynamic header configuration
 - Block-based header modification
 - Custom header fields
@@ -120,7 +137,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 🌍 14_global_configuration_demo.rb  
 **Demonstrates:** Global SmartMessage configuration
-**Transport:** StdoutTransport with loopback
+**Transport:** MemoryTransport
 - Global transport settings
 - Configuration inheritance (serialization handled by transport)
 - Default settings management
@@ -128,7 +145,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 
 ### 📋 15_logger_demo.rb
 **Demonstrates:** Logger configuration and usage
-**Transport:** StdoutTransport
+**Transport:** StdoutTransport (publish-only)
 - Various logger configurations
 - Log level management
 - Custom log formatting