smart_message 0.0.12 → 0.0.13

data/docs/transports/redis-transport.md

@@ -430,24 +430,6 @@ All subscribers receive all messages:
 # No load balancing between subscribers
 ```
 
-## Migration to Enhanced Transport
-
-When you need advanced routing, consider upgrading to Enhanced Transport:
-
-```ruby
-# From Redis Transport
-SmartMessage.configure do |config|
-  config.default_transport = SmartMessage::Transport::RedisTransport.new
-end
-
-# To Enhanced Transport (with backward compatibility)
-SmartMessage.configure do |config|
-  config.default_transport = SmartMessage::Transport::RedisEnhancedTransport.new
-end
-
-# All existing messages continue to work
-# New messages gain pattern-matching capabilities
-```
 
 ## Examples
 
@@ -503,7 +485,6 @@ For more Redis Transport examples and patterns, also see:
 
 ## Related Documentation
 
-- [Redis Enhanced Transport](redis-enhanced-transport.md) - Advanced routing with patterns
-- [Redis Queue Transport](redis-queue-transport.md) - Persistent queues with load balancing  
-- [Transport Comparison](redis-transport-comparison.md) - Compare all Redis transports
-- [Transport Overview](../reference/transports.md) - All available transports
+- [Transport Overview](../reference/transports.md) - All available transports
+- [Examples & Use Cases](../getting-started/examples.md) - Practical usage patterns
+- [Architecture Overview](../core-concepts/architecture.md) - How SmartMessage works

data/examples/README.md

@@ -40,7 +40,7 @@ cd city_scenario
 **Key Features:**
 - Request-response messaging pattern
 - Error handling and payment validation
-- JSON serialization of complex business objects
+- Automatic serialization of complex business objects by transport
 - Service-to-service communication
 
 **Messages Used:**
@@ -393,7 +393,6 @@ Most examples use `StdoutTransport` with loopback enabled for demonstration purp
 ```ruby
 config do
   transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-  serializer SmartMessage::Serializer::JSON.new
 end
 ```
 
@@ -406,13 +405,12 @@ config do
     db: 1,
     auto_subscribe: true
   )
-  serializer SmartMessage::Serializer::JSON.new
 end
 ```
 
 **For Production Use:**
 - Use production transports like Redis (see example #4), RabbitMQ, or Kafka
-- Configure appropriate serializers for your data needs
+- Transports handle serialization automatically
 - Add proper error handling and logging
 - Implement monitoring and metrics
 
@@ -547,7 +545,6 @@ class MyCustomMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::JSON.new
   end
 end
 ```
@@ -676,9 +673,9 @@ When adapting these examples for production:
    - Implement proper error handling
 
 2. **Serialization:**
-   - Choose appropriate serializers for your data
-   - Consider performance and compatibility requirements
-   - Handle schema evolution
+   - Transports handle serialization automatically
+   - Choose transports based on serialization requirements
+   - Handle schema evolution at the message level
 
 3. **Monitoring:**
    - Add logging and metrics
@@ -699,7 +696,7 @@ When adapting these examples for production:
 
 - [SmartMessage Documentation](../docs/README.md)
 - [Transport Layer Guide](../docs/transports.md)
-- [Serialization Guide](../docs/serializers.md)
+- [Serialization Guide](../docs/serializers.md) (Note: Serialization is now handled by transports)
 - [Architecture Overview](../docs/architecture.md)
 
 ## Questions and Contributions

data/examples/city_scenario/README.md

@@ -372,7 +372,7 @@ All messages include comprehensive headers:
     "publisher_pid": 12345,
     "version": 1,
     "from": "house-sensor-01",
-    "serializer": "SmartMessage::Serializer::Json"
+    "transport": "SmartMessage::Transport::RedisTransport"
   },
   "_sm_payload": {
     "location": "123 Oak Street",

data/examples/city_scenario/messages/emergency_911_message.rb

@@ -10,7 +10,6 @@ module Messages
     description 'Emergency 911 call for reporting fires, crimes, accidents, medical emergencies, or other urgent situations requiring police, fire, or medical response'
 
     transport  SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     VALID_EMERGENCY_TYPES = %w[fire medical crime accident hazmat rescue other]
     VALID_SEVERITY = %w[critical high medium low]

data/examples/city_scenario/messages/emergency_resolved_message.rb

@@ -14,7 +14,6 @@ module Messages
     description 'Emergency incident closure notification message broadcast by emergency services when incidents are successfully resolved, providing completion status, response duration, outcome details, and unit deployment information to all city services for operational awareness and incident tracking'
 
     transport  SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     property :incident_id, required: true,
                            description: 'Unique identifier of the emergency incident that was resolved'

data/examples/city_scenario/messages/fire_dispatch_message.rb

@@ -13,7 +13,6 @@ module Messages
     description 'Emergency fire suppression dispatch coordination message sent by the Fire Department in response to fire emergencies, containing fire engine assignments, specialized equipment deployment, and tactical response information for various fire types, rescue operations, and hazardous material incidents'
 
     transport  SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     property :dispatch_id, required: true,
                            description: 'Unique hexadecimal identifier for this fire department dispatch operation'

data/examples/city_scenario/messages/fire_emergency_message.rb

@@ -13,7 +13,6 @@ module Messages
     description "Critical fire emergency alert message sent by residential monitoring systems to the Fire Department when smoke, heat, or fire is detected, triggering immediate emergency response with fire engine dispatch, specialized equipment deployment, and rescue operations based on fire type, severity, and occupant safety status"
 
     transport SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     VALID_FIRE_TYPES = %w[fire kitchen electrical basement garage wildfire]
     VALID_SEVERITY = %w[small medium large out_of_control]

data/examples/city_scenario/messages/health_check_message.rb

@@ -14,7 +14,6 @@ module Messages
     description "Health monitoring message broadcast by the Health Department every 5 seconds to verify operational status of all city services including police, fire, banks, and residential monitoring systems"
 
     transport SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     property :check_id, required: true,
       description: "Unique identifier for this health check request (UUID format)"

data/examples/city_scenario/messages/health_status_message.rb

@@ -16,7 +16,6 @@ module Messages
     VALID_STATUS = %w[healthy warning critical failed]
 
     transport  SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     property :service_name, required: true,
       description: "Name of the city service reporting its status (e.g., 'police-department', 'fire-department')"

data/examples/city_scenario/messages/police_dispatch_message.rb

@@ -16,7 +16,6 @@ module Messages
     DESC
 
     transport  SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     VALID_PRIORITY = %w[low medium high emergency]
 

data/examples/city_scenario/messages/silent_alarm_message.rb

@@ -17,7 +17,6 @@ module Messages
     DESC
 
     transport  SmartMessage::Transport::RedisTransport.new
-    serializer SmartMessage::Serializer::Json.new
 
     VALID_ALARM_TYPES = %w[robbery vault_breach suspicious_activity]
     VALID_SEVERITY = %w[low medium high critical]

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

data/examples/memory/02_dead_letter_queue_demo.rb

@@ -45,7 +45,6 @@ class PaymentMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:memory)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -68,7 +67,6 @@ class OrderMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:memory)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -90,7 +88,6 @@ class NotificationMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:memory)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)

data/examples/memory/03_point_to_point_orders.rb

@@ -36,7 +36,6 @@ 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
   end
 
   # Default processing - just logs the order
@@ -62,7 +61,6 @@ class PaymentResponseMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(message)

data/examples/memory/04_publish_subscribe_events.rb

@@ -32,7 +32,6 @@ class UserEventMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   # Default processor - just logs the event

data/examples/memory/05_many_to_many_chat.rb

@@ -37,7 +37,6 @@ class ChatMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -66,7 +65,6 @@ class BotCommandMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -95,7 +93,6 @@ class SystemNotificationMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)

data/examples/memory/07_proc_handlers_demo.rb

@@ -29,7 +29,6 @@ class NotificationMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   # Default handler

data/examples/memory/08_custom_logger_demo.rb

@@ -293,7 +293,6 @@ class OrderProcessingMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
     
     # Configure multi-logger to demonstrate different logging approaches
     logger SmartMessage::Logger::MultiLogger.new(
@@ -364,7 +363,6 @@ class NotificationMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
     
     # Use only file logger for notifications
     logger SmartMessage::Logger::FileLogger.new('logs/notifications.log', level: Logger::WARN)
@@ -401,7 +399,6 @@ class StandardLoggerMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
     
     # Example 1: Using Ruby's standard Logger directly
     # Create a standard Ruby logger that logs to STDOUT
@@ -439,7 +436,6 @@ class DefaultLoggerMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
     
     # Use the built-in default logger - simplest option!
     logger SmartMessage::Logger::Default.new

data/examples/memory/09_error_handling_demo.rb

@@ -50,7 +50,6 @@ class UserRegistrationMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -99,7 +98,6 @@ class UserRegistrationMessageV2 < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -121,7 +119,6 @@ class MultiRequiredMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 

data/examples/memory/10_entity_addressing_basic.rb

@@ -40,7 +40,6 @@ class OrderMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -93,7 +92,6 @@ class SystemAnnouncementMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -145,7 +143,6 @@ class UserLookupRequest < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -179,7 +176,6 @@ class UserLookupResponse < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -251,7 +247,6 @@ class PaymentMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)
@@ -326,7 +321,6 @@ class ExternalAPIMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process(wrapper)

data/examples/memory/11_entity_addressing_with_filtering.rb

@@ -37,7 +37,6 @@ class ServiceMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   # Different handlers for different subscription filters
@@ -154,7 +153,6 @@ class AlertMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process_critical_or_broadcast(wrapper)
@@ -262,7 +260,6 @@ class OrderMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process_high_priority(wrapper)
@@ -357,7 +354,6 @@ class ServiceRequest < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout, loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
   
   def self.process_api_requests(wrapper)

data/examples/memory/12_regex_filtering_microservices.rb

@@ -31,7 +31,6 @@ class MicroserviceMessage < SmartMessage::Base
   # Configure with STDOUT transport for demo visibility
   config do
     transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 

data/examples/memory/13_header_block_configuration.rb

@@ -32,7 +32,6 @@ class DirectMethodMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 
@@ -63,7 +62,6 @@ class HeaderBlockMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 
@@ -96,7 +94,6 @@ class MixedConfigMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 
@@ -127,7 +124,6 @@ class FlexibleMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 
@@ -234,7 +230,6 @@ class CheckableMessage < SmartMessage::Base
   
   config do
     transport SmartMessage::Transport.create(:stdout)
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 

data/examples/memory/14_global_configuration_demo.rb

@@ -62,7 +62,6 @@ class NotificationMessage < SmartMessage::Base
   # Explicitly use global configuration for demonstration
   config do
     transport SmartMessage::Transport.default
-    serializer SmartMessage::Serializer.default
     logger SmartMessage::Logger.default
   end
   
@@ -88,7 +87,6 @@ class OrderStatusMessage < SmartMessage::Base
   # Explicitly use global configuration for demonstration
   config do
     transport SmartMessage::Transport.default
-    serializer SmartMessage::Serializer.default
     logger SmartMessage::Logger.default
   end
   

data/examples/memory/15_logger_demo.rb

@@ -273,7 +273,6 @@ class DemoMessage < SmartMessage::Base
 
   config do
     transport SmartMessage::Transport::StdoutTransport.new
-    serializer SmartMessage::Serializer::Json.new
     from 'demo-logger-app'
   end
 

data/examples/memory/README.md

@@ -35,7 +35,7 @@ These transports keep all message routing in-memory within the current Ruby proc
 **Transport:** StdoutTransport with loopback
 - Order processing system between OrderService and PaymentService
 - Request/response message pattern
-- JSON serialization of complex order data
+- Automatic serialization of complex order data by transport
 - Bidirectional communication flow
 
 ### 📢 04_publish_subscribe_events.rb
@@ -121,8 +121,8 @@ 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
-- Global transport and serializer settings
-- Configuration inheritance
+- Global transport settings
+- Configuration inheritance (serialization handled by transport)
 - Default settings management
 - Application-wide configuration patterns
 

data/examples/redis/01_smart_home_iot_demo.rb

@@ -79,7 +79,6 @@ class SensorDataMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -114,7 +113,6 @@ class DeviceCommandMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -147,7 +145,6 @@ class AlertMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -176,7 +173,6 @@ class DashboardStatusMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)

data/examples/redis/README.md

@@ -135,7 +135,6 @@ SmartMessage.configure do |config|
     url: 'redis://localhost:6379',
     db: 1  # Optional: use specific Redis database
   )
-  config.serializer = SmartMessage::Serializer::Json.new
 end
 ```
 
@@ -147,7 +146,6 @@ class MyMessage < SmartMessage::Base
       url: 'redis://localhost:6379',
       db: 2
     )
-    serializer SmartMessage::Serializer::Json.new
   end
 end
 ```

data/lib/smart_message/base.rb

@@ -50,7 +50,6 @@ module SmartMessage
       # instance-level override of class plugins  
       # Don't use fallback defaults here - let the methods handle fallbacks when actually used
       @transport   = (self.class.class_variable_get(:@@transport) rescue nil)
-      @serializer  = (self.class.class_variable_get(:@@serializer) rescue nil)
 
       # Check if we're reconstructing from serialized data (complete header provided)
       if props[:_sm_header]
@@ -71,8 +70,8 @@ module SmartMessage
         @to = header.to
         @reply_to = header.reply_to
         
-        # Extract payload properties
-        payload_props = props[:_sm_payload] || {}
+        # Extract payload properties directly from props (flat structure)
+        payload_props = props.except(:_sm_header)
         
         attributes = {
           _sm_header: header
@@ -132,7 +131,7 @@ module SmartMessage
       # Extract payload properties (non-header properties)
       payload_props = self.class.properties.each_with_object({}) do |prop, hash|
         next if prop == :_sm_header
-        hash[prop.to_s] = self[prop]  # Use string keys to match old format
+        hash[prop.to_s] = self[prop]  # Access property value
       end
       
       JSON.generate(payload_props)
@@ -154,29 +153,39 @@ module SmartMessage
 
 
 
+    # Convert message to hash for serialization
+    def to_hash
+      # Get all properties and their values
+      hash = {}
+      self.class.properties.each do |prop|
+        hash[prop] = self[prop]
+      end
+      hash
+    end
+
     ###########################################################
     ## class methods
 
     class << self
       # Decode a complete serialized message back to a message instance
+      # Note: This method is no longer used with transport-based serialization
+      # Transports handle decoding and create message instances directly
       # @param serialized_message [String] The serialized message content
       # @return [SmartMessage::Base] The decoded message instance
       def decode(serialized_message)
         begin
           (self.logger || SmartMessage::Logger.default).info { "[SmartMessage] Received: #{self.name} (#{serialized_message.bytesize} bytes)" }
 
-          # Use the class's configured serializer to decode the message
-          serializer = self.serializer || SmartMessage::Serializer.default
-          
-          # Deserialize the complete message
-          deserialized_data = serializer.decode(serialized_message)
+          # This method is deprecated - transports now handle serialization
+          # For backward compatibility, try to decode as JSON
+          require 'json'
+          deserialized_data = JSON.parse(serialized_message)
 
           # Create new message instance with the complete deserialized data
           if deserialized_data.is_a?(Hash)
             # Convert string keys to symbols for compatibility with keyword arguments
             symbol_props = deserialized_data.transform_keys(&:to_sym)
             
-            # With single-tier serialization, use the complete deserialized message structure
             message = self.new(**symbol_props)
 
             (self.logger || SmartMessage::Logger.default).debug { "[SmartMessage] Deserialized message: #{self.name}" }