smart_message 0.0.10 → 0.0.12

data/examples/memory/README.md

@@ -0,0 +1,163 @@
+# 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.
+
+## Transport Overview
+
+The Memory and Stdout (with loopback) transports are ideal for:
+- **Learning SmartMessage fundamentals**
+- **Rapid prototyping and testing**
+- **Single-process applications**
+- **Development and debugging**
+
+These transports keep all message routing in-memory within the current Ruby process.
+
+## Example Programs
+
+### 📋 01_message_deduplication_demo.rb
+**Demonstrates:** Message deduplication patterns
+**Transport:** MemoryTransport
+- Shows how to prevent duplicate message processing
+- Implements deduplication based on message IDs
+- Tracks processed messages to avoid reprocessing
+- Useful for ensuring idempotent message handling
+
+### 🚨 02_dead_letter_queue_demo.rb  
+**Demonstrates:** Dead letter queue error handling
+**Transport:** Custom failing transport (extends Base)
+- Simulates transport failures and message retry logic
+- Shows dead letter queue pattern implementation
+- Handles various failure scenarios (connection errors, timeouts)
+- Demonstrates message recovery and error reporting
+
+### 🛍️ 03_point_to_point_orders.rb
+**Demonstrates:** Point-to-point messaging (1:1)
+**Transport:** StdoutTransport with loopback
+- Order processing system between OrderService and PaymentService
+- Request/response message pattern
+- JSON serialization of complex order data
+- Bidirectional communication flow
+
+### 📢 04_publish_subscribe_events.rb
+**Demonstrates:** Publish-subscribe messaging (1:many)
+**Transport:** StdoutTransport with loopback
+- User event notification system
+- Multiple subscribers (EmailService, SMSService, AuditService)
+- Event-driven architecture
+- Different services handling same events differently
+
+### 💬 05_many_to_many_chat.rb  
+**Demonstrates:** Many-to-many messaging patterns
+**Transport:** StdoutTransport with loopback
+- Multi-user chat room system
+- Message broadcasting to multiple participants
+- User presence and room management
+- Complex message routing scenarios
+
+### 🎨 06_pretty_print_demo.rb
+**Demonstrates:** Message pretty-printing and debugging
+**Transport:** None (utility demo)
+- Shows SmartMessage's `pretty_print` method
+- Formats complex nested message data
+- Header and content display modes
+- Useful for development and troubleshooting
+
+### ⚡ 07_proc_handlers_demo.rb
+**Demonstrates:** Proc-based message handlers
+**Transport:** StdoutTransport with loopback  
+- Custom Proc handlers for message processing
+- Dynamic message routing
+- Flexible handler assignment
+- Lambda and block-based processors
+
+### 📊 08_custom_logger_demo.rb
+**Demonstrates:** Custom logging implementations
+**Transport:** StdoutTransport with loopback
+- Multiple logger types and configurations
+- Custom logger classes
+- Log filtering and formatting
+- Integration with external logging systems
+
+### ❌ 09_error_handling_demo.rb
+**Demonstrates:** Error handling strategies
+**Transport:** StdoutTransport with loopback
+- Various error scenarios and recovery patterns
+- Exception handling in message processors
+- Error propagation and logging
+- Graceful degradation techniques
+
+### 🎯 10_entity_addressing_basic.rb
+**Demonstrates:** Basic entity addressing
+**Transport:** StdoutTransport with loopback
+- Message routing by entity addresses
+- Order processing with specific routing
+- Customer and payment entity handling
+- Address-based message filtering
+
+### 🔍 11_entity_addressing_with_filtering.rb  
+**Demonstrates:** Advanced entity addressing with filters
+**Transport:** StdoutTransport with loopback
+- Complex filtering patterns
+- Regex-based address matching
+- Multiple entity types and routing rules
+- Advanced subscription filtering
+
+### 🏢 12_regex_filtering_microservices.rb
+**Demonstrates:** Microservices with regex filtering
+**Transport:** StdoutTransport with loopback
+- Service-to-service communication patterns
+- Regular expression-based routing
+- Environment-based filtering (dev/staging/prod)
+- Microservices architecture simulation
+
+### 📝 13_header_block_configuration.rb
+**Demonstrates:** Header configuration with blocks
+**Transport:** StdoutTransport
+- Dynamic header configuration
+- Block-based header modification
+- Custom header fields
+- Header inheritance patterns
+
+### 🌍 14_global_configuration_demo.rb  
+**Demonstrates:** Global SmartMessage configuration
+**Transport:** StdoutTransport with loopback
+- Global transport and serializer settings
+- Configuration inheritance
+- Default settings management
+- Application-wide configuration patterns
+
+### 📋 15_logger_demo.rb
+**Demonstrates:** Logger configuration and usage
+**Transport:** StdoutTransport
+- Various logger configurations
+- Log level management
+- Custom log formatting
+- Integration with SmartMessage lifecycle
+
+## Getting Started
+
+To run any example:
+
+```bash
+cd examples/memory
+ruby 01_message_deduplication_demo.rb
+```
+
+Most examples are self-contained and will demonstrate their concepts through console output.
+
+## Key Learning Points
+
+1. **In-Memory Processing**: All examples run within a single Ruby process
+2. **No External Dependencies**: No Redis, database, or message broker required  
+3. **Immediate Feedback**: Console output shows message flow in real-time
+4. **Development Friendly**: Perfect for learning and experimentation
+5. **Pattern Foundation**: Concepts apply to all SmartMessage transports
+
+## Next Steps
+
+After mastering these memory-based examples, explore:
+- **[Redis Examples](../redis/)** - For distributed messaging
+- **[Redis Queue Examples](../redis_queue/)** - For reliable message queuing
+- **[Redis Enhanced Examples](../redis_enhanced/)** - For advanced Redis patterns
+
+These memory examples provide the foundation for understanding SmartMessage's core concepts before moving to production-ready transports.

data/examples/memory/memory_transport_architecture.svg

@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800" height="600" viewBox="0 0 800 600" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .box { fill: #2a2a2a; stroke: #4a9eff; stroke-width: 2; rx: 8; }
+      .memory-box { fill: #1a3a1a; stroke: #4aff4a; stroke-width: 2; rx: 8; }
+      .arrow { stroke: #ffaa4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 14px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .process { fill: #3a2a4a; stroke: #aa4aff; stroke-width: 2; rx: 6; }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" 
+            refX="10" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#ffaa4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="600"/>
+  
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" class="title">SmartMessage Memory Transport Architecture</text>
+  <text x="400" y="50" text-anchor="middle" class="subtitle">Single Process - In-Memory Message Routing</text>
+  
+  <!-- Ruby Process Container -->
+  <rect x="50" y="80" width="700" height="480" class="box"/>
+  <text x="70" y="105" class="text">Ruby Process (Single JVM/Interpreter)</text>
+  
+  <!-- Publisher Components -->
+  <rect x="80" y="140" width="150" height="80" class="process"/>
+  <text x="155" y="165" text-anchor="middle" class="text">Order Service</text>
+  <text x="155" y="185" text-anchor="middle" class="subtitle">(Publisher)</text>
+  <text x="155" y="205" text-anchor="middle" class="subtitle">Creates Messages</text>
+  
+  <rect x="80" y="250" width="150" height="80" class="process"/>
+  <text x="155" y="275" text-anchor="middle" class="text">User Manager</text>
+  <text x="155" y="295" text-anchor="middle" class="subtitle">(Publisher)</text>
+  <text x="155" y="315" text-anchor="middle" class="subtitle">Publishes Events</text>
+  
+  <!-- Memory Transport Core -->
+  <rect x="300" y="180" width="200" height="120" class="memory-box"/>
+  <text x="400" y="205" text-anchor="middle" class="title">Memory Transport</text>
+  <text x="400" y="225" text-anchor="middle" class="text">In-Process Routing</text>
+  <text x="400" y="245" text-anchor="middle" class="subtitle">• Message Dispatcher</text>
+  <text x="400" y="265" text-anchor="middle" class="subtitle">• Thread Pool</text>
+  <text x="400" y="285" text-anchor="middle" class="subtitle">• Subscription Registry</text>
+  
+  <!-- Subscriber Components -->
+  <rect x="570" y="140" width="150" height="80" class="process"/>
+  <text x="645" y="165" text-anchor="middle" class="text">Payment Service</text>
+  <text x="645" y="185" text-anchor="middle" class="subtitle">(Subscriber)</text>
+  <text x="645" y="205" text-anchor="middle" class="subtitle">Processes Orders</text>
+  
+  <rect x="570" y="250" width="150" height="80" class="process"/>
+  <text x="645" y="275" text-anchor="middle" class="text">Email Service</text>
+  <text x="645" y="295" text-anchor="middle" class="subtitle">(Subscriber)</text>
+  <text x="645" y="315" text-anchor="middle" class="subtitle">Sends Notifications</text>
+  
+  <rect x="570" y="360" width="150" height="80" class="process"/>
+  <text x="645" y="385" text-anchor="middle" class="text">Audit Service</text>
+  <text x="645" y="405" text-anchor="middle" class="subtitle">(Subscriber)</text>
+  <text x="645" y="425" text-anchor="middle" class="subtitle">Logs Events</text>
+  
+  <!-- Message Flow Arrows -->
+  <!-- Publishers to Transport -->
+  <path d="M 230 180 L 300 220" class="arrow"/>
+  <path d="M 230 290 L 300 260" class="arrow"/>
+  
+  <!-- Transport to Subscribers -->
+  <path d="M 500 220 L 570 180" class="arrow"/>
+  <path d="M 500 240 L 570 280" class="arrow"/>
+  <path d="M 500 260 L 570 380" class="arrow"/>
+  
+  <!-- Key Features Box -->
+  <rect x="80" y="380" width="640" height="160" class="box"/>
+  <text x="100" y="405" class="title">Key Characteristics</text>
+  
+  <text x="100" y="430" class="text">✓ Single Process: All components run in same Ruby process</text>
+  <text x="100" y="450" class="text">✓ No External Dependencies: No Redis, databases, or message brokers required</text>
+  <text x="100" y="470" class="text">✓ Immediate Routing: Messages routed instantly through in-memory dispatcher</text>
+  <text x="100" y="490" class="text">✓ Thread-Safe: Concurrent message processing with thread pool</text>
+  <text x="100" y="510" class="text">✓ Development Friendly: Perfect for learning, testing, and rapid prototyping</text>
+  
+  <!-- Usage Note -->
+  <text x="400" y="580" text-anchor="middle" class="subtitle">
+    Ideal for: Development • Testing • Single-Process Applications • Learning SmartMessage Fundamentals
+  </text>
+</svg>

data/examples/memory/point_to_point_pattern.svg

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800" height="500" viewBox="0 0 800 500" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .service { fill: #2a2a2a; stroke: #4a9eff; stroke-width: 2; rx: 10; }
+      .message { fill: #4a2a4a; stroke: #ff4a9e; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #ffaa4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead); }
+      .arrow-response { stroke: #4aff4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead-green); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 14px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 20px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .step { fill: #ff4a9e; font-family: 'Arial', sans-serif; font-size: 13px; font-weight: bold; }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" 
+            refX="10" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#ffaa4a" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="10" markerHeight="7" 
+            refX="10" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#4aff4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="500"/>
+  
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" class="title">Point-to-Point Messaging Pattern</text>
+  <text x="400" y="50" text-anchor="middle" class="subtitle">Order Processing System Example (03_point_to_point_orders.rb)</text>
+  
+  <!-- Order Service -->
+  <rect x="50" y="100" width="180" height="100" class="service"/>
+  <text x="140" y="130" text-anchor="middle" class="text">Order Service</text>
+  <text x="140" y="150" text-anchor="middle" class="subtitle">• Creates orders</text>
+  <text x="140" y="170" text-anchor="middle" class="subtitle">• Publishes OrderMessage</text>
+  <text x="140" y="190" text-anchor="middle" class="subtitle">• Receives PaymentResponse</text>
+  
+  <!-- Payment Service -->
+  <rect x="570" y="100" width="180" height="100" class="service"/>
+  <text x="660" y="130" text-anchor="middle" class="text">Payment Service</text>
+  <text x="660" y="150" text-anchor="middle" class="subtitle">• Processes payments</text>
+  <text x="660" y="170" text-anchor="middle" class="subtitle">• Subscribes to OrderMessage</text>
+  <text x="660" y="190" text-anchor="middle" class="subtitle">• Sends PaymentResponse</text>
+  
+  <!-- Message Flow -->
+  <!-- Step 1: Order Message -->
+  <rect x="280" y="120" width="240" height="60" class="message"/>
+  <text x="400" y="145" text-anchor="middle" class="step">1. OrderMessage</text>
+  <text x="400" y="165" text-anchor="middle" class="subtitle">order_id, amount, customer_id</text>
+  
+  <path d="M 230 150 L 280 150" class="arrow"/>
+  <path d="M 520 150 L 570 150" class="arrow"/>
+  
+  <!-- Step 2: Response Message -->
+  <rect x="280" y="260" width="240" height="60" class="message"/>
+  <text x="400" y="285" text-anchor="middle" class="step">2. PaymentResponseMessage</text>
+  <text x="400" y="305" text-anchor="middle" class="subtitle">payment_id, status, message</text>
+  
+  <path d="M 520 290 L 570 290" class="arrow-response"/>
+  <path d="M 280 290 L 230 290" class="arrow-response"/>
+  
+  <!-- Curved arrows for message flow -->
+  <path d="M 660 200 Q 400 240 140 200" stroke="#4aff4a" stroke-width="2" fill="none" 
+        marker-end="url(#arrowhead-green)" stroke-dasharray="5,5"/>
+  
+  <!-- Process Steps -->
+  <rect x="50" y="350" width="700" height="120" class="service"/>
+  <text x="70" y="375" class="title">Message Flow Process</text>
+  
+  <circle cx="90" cy="400" r="15" fill="#ff4a9e"/>
+  <text x="90" y="405" text-anchor="middle" class="text">1</text>
+  <text x="115" y="405" class="text">OrderService creates order and publishes OrderMessage</text>
+  
+  <circle cx="90" cy="425" r="15" fill="#ff4a9e"/>
+  <text x="90" y="430" text-anchor="middle" class="text">2</text>
+  <text x="115" y="430" class="text">Memory transport routes message to PaymentService subscriber</text>
+  
+  <circle cx="90" cy="450" r="15" fill="#ff4a9e"/>
+  <text x="90" y="455" text-anchor="middle" class="text">3</text>
+  <text x="115" y="455" class="text">PaymentService processes payment and publishes PaymentResponseMessage</text>
+  
+  <circle cx="400" cy="400" r="15" fill="#4aff4a"/>
+  <text x="400" y="405" text-anchor="middle" class="text">4</text>
+  <text x="425" y="405" class="text">Response message routed back to OrderService</text>
+  
+  <circle cx="400" cy="425" r="15" fill="#4aff4a"/>
+  <text x="400" y="430" text-anchor="middle" class="text">5</text>
+  <text x="425" y="430" class="text">OrderService receives confirmation of payment status</text>
+  
+  <circle cx="400" cy="450" r="15" fill="#4aff4a"/>
+  <text x="400" y="455" text-anchor="middle" class="text">6</text>
+  <text x="425" y="455" class="text">Complete request-response cycle with reliable delivery</text>
+</svg>

data/examples/memory/publish_subscribe_pattern.svg

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800" height="600" viewBox="0 0 800 600" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .publisher { fill: #3a2a1a; stroke: #ffaa4a; stroke-width: 2; rx: 10; }
+      .subscriber { fill: #1a2a3a; stroke: #4a9eff; stroke-width: 2; rx: 8; }
+      .dispatcher { fill: #2a3a2a; stroke: #4aff4a; stroke-width: 3; rx: 12; }
+      .event { fill: #4a1a2a; stroke: #ff4aaa; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #ffaa4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .fan-arrow { stroke: #4aff4a; stroke-width: 2; fill: none; marker-end: url(#fan-arrowhead); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .event-text { fill: #ff4aaa; font-family: 'Arial', sans-serif; font-size: 11px; }
+    </style>
+    <marker id="arrowhead" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ffaa4a" />
+    </marker>
+    <marker id="fan-arrowhead" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="600"/>
+  
+  <!-- Title -->
+  <text x="400" y="25" text-anchor="middle" class="title">Publish-Subscribe Pattern (1-to-Many)</text>
+  <text x="400" y="45" text-anchor="middle" class="subtitle">User Event Notification System (04_publish_subscribe_events.rb)</text>
+  
+  <!-- Publisher -->
+  <rect x="50" y="280" width="180" height="80" class="publisher"/>
+  <text x="140" y="305" text-anchor="middle" class="title">User Manager</text>
+  <text x="140" y="325" text-anchor="middle" class="subtitle">(Publisher)</text>
+  <text x="140" y="345" text-anchor="middle" class="text">• User registration</text>
+  <text x="140" y="360" text-anchor="middle" class="text">• Password changes</text>
+  
+  <!-- Memory Dispatcher -->
+  <rect x="320" y="270" width="160" height="100" class="dispatcher"/>
+  <text x="400" y="295" text-anchor="middle" class="title">Memory</text>
+  <text x="400" y="315" text-anchor="middle" class="title">Dispatcher</text>
+  <text x="400" y="335" text-anchor="middle" class="text">Message Router</text>
+  <text x="400" y="355" text-anchor="middle" class="subtitle">Thread Pool</text>
+  
+  <!-- Event Message -->
+  <rect x="300" y="120" width="200" height="60" class="event"/>
+  <text x="400" y="145" text-anchor="middle" class="event-text">UserEventMessage</text>
+  <text x="400" y="165" text-anchor="middle" class="subtitle">event_type: "user_registered"</text>
+  
+  <!-- Subscribers -->
+  <rect x="570" y="150" width="180" height="80" class="subscriber"/>
+  <text x="660" y="175" text-anchor="middle" class="title">Email Service</text>
+  <text x="660" y="195" text-anchor="middle" class="subtitle">(Subscriber)</text>
+  <text x="660" y="215" text-anchor="middle" class="text">• Welcome emails</text>
+  <text x="660" y="230" text-anchor="middle" class="text">• Security alerts</text>
+  
+  <rect x="570" y="280" width="180" height="80" class="subscriber"/>
+  <text x="660" y="305" text-anchor="middle" class="title">SMS Service</text>
+  <text x="660" y="325" text-anchor="middle" class="subtitle">(Subscriber)</text>
+  <text x="660" y="345" text-anchor="middle" class="text">• Security SMS</text>
+  <text x="660" y="360" text-anchor="middle" class="text">• Login alerts</text>
+  
+  <rect x="570" y="410" width="180" height="80" class="subscriber"/>
+  <text x="660" y="435" text-anchor="middle" class="title">Audit Service</text>
+  <text x="660" y="455" text-anchor="middle" class="subtitle">(Subscriber)</text>
+  <text x="660" y="475" text-anchor="middle" class="text">• Event logging</text>
+  <text x="660" y="490" text-anchor="middle" class="text">• Activity tracking</text>
+  
+  <!-- Message Flow -->
+  <!-- Publisher to Dispatcher -->
+  <path d="M 230 320 L 320 320" class="arrow"/>
+  
+  <!-- Event flow -->
+  <path d="M 230 300 L 350 180" class="arrow"/>
+  
+  <!-- Dispatcher to Subscribers (Fan-out) -->
+  <path d="M 480 300 L 570 190" class="fan-arrow"/>
+  <path d="M 480 320 L 570 320" class="fan-arrow"/>
+  <path d="M 480 340 L 570 450" class="fan-arrow"/>
+  
+  <!-- Event Types Examples -->
+  <rect x="50" y="400" width="480" height="180" class="dispatcher"/>
+  <text x="70" y="425" class="title">Event Processing Examples</text>
+  
+  <!-- User Registration Event -->
+  <rect x="70" y="440" width="140" height="60" class="event"/>
+  <text x="140" y="460" text-anchor="middle" class="event-text">user_registered</text>
+  <text x="140" y="480" text-anchor="middle" class="subtitle">→ Welcome email</text>
+  <text x="140" y="495" text-anchor="middle" class="subtitle">→ Audit log</text>
+  
+  <!-- Password Change Event -->
+  <rect x="230" y="440" width="140" height="60" class="event"/>
+  <text x="300" y="460" text-anchor="middle" class="event-text">password_changed</text>
+  <text x="300" y="480" text-anchor="middle" class="subtitle">→ Security email</text>
+  <text x="300" y="495" text-anchor="middle" class="subtitle">→ Security SMS</text>
+  
+  <!-- Login Event -->
+  <rect x="390" y="440" width="140" height="60" class="event"/>
+  <text x="460" y="460" text-anchor="middle" class="event-text">suspicious_login</text>
+  <text x="460" y="480" text-anchor="middle" class="subtitle">→ Login alert SMS</text>
+  <text x="460" y="495" text-anchor="middle" class="subtitle">→ Audit log</text>
+  
+  <!-- Processing Flow -->
+  <text x="70" y="530" class="title">Message Processing Flow:</text>
+  
+  <circle cx="90" cy="550" r="12" fill="#ffaa4a"/>
+  <text x="90" y="555" text-anchor="middle" class="text">1</text>
+  <text x="110" y="555" class="text">UserManager publishes event to all subscribers</text>
+  
+  <circle cx="350" cy="550" r="12" fill="#4aff4a"/>
+  <text x="350" y="555" text-anchor="middle" class="text">2</text>
+  <text x="370" y="555" class="text">Memory Dispatcher routes to all registered subscribers</text>
+  
+  <circle cx="90" cy="570" r="12" fill="#4a9eff"/>
+  <text x="90" y="575" text-anchor="middle" class="text">3</text>
+  <text x="110" y="575" class="text">Each service processes event according to its business logic</text>
+  
+  <!-- Pattern Benefits -->
+  <text x="570" y="530" class="title">Pattern Benefits:</text>
+  <text x="590" y="550" class="text">✓ Loose Coupling</text>
+  <text x="590" y="570" class="text">✓ Scalable Architecture</text>
+</svg>

data/examples/{04_redis_smart_home_iot.rb → redis/01_smart_home_iot_demo.rb}

@@ -8,7 +8,7 @@
 # through Redis channels. Each message type gets its own Redis channel for
 # efficient routing and scaling.
 
-require_relative '../lib/smart_message'
+require_relative '../../lib/smart_message'
 
 begin
   require 'redis'
@@ -79,7 +79,7 @@ class SensorDataMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::JSON.new
+    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -114,7 +114,7 @@ class DeviceCommandMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::JSON.new
+    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -147,7 +147,7 @@ class AlertMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::JSON.new
+    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)
@@ -176,7 +176,7 @@ class DashboardStatusMessage < SmartMessage::Base
 
   config do
     transport SHARED_TRANSPORT
-    serializer SmartMessage::Serializer::JSON.new
+    serializer SmartMessage::Serializer::Json.new
   end
 
   def self.process(wrapper)