smart_message 0.0.10 → 0.0.12

data/docs/assets/images/ddq_architecture.svg

@@ -0,0 +1,130 @@
+<?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; }
+      .handler-a-group { fill: #1a2a3a; stroke: #4a9eff; stroke-width: 2; rx: 10; }
+      .handler-b-group { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 2; rx: 10; }
+      .dispatcher-group { fill: #3a1a1a; stroke: #ff4a4a; stroke-width: 2; rx: 10; }
+      .component { fill: #2a2a2a; stroke: #ffffff; stroke-width: 1; rx: 5; }
+      .message { fill: #1a3a2a; stroke: #4aff4a; stroke-width: 2; rx: 8; }
+      .process-flow { stroke: #4aff4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead-green); }
+      .check-flow { stroke: #ffaa4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-orange); }
+      .success-flow { stroke: #4aff4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+      .skip-flow { stroke: #ff4a4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-red); stroke-dasharray: 5,5; }
+      .add-flow { stroke: #4a9eff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-blue); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .group-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 13px; font-weight: bold; }
+      .component-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 12px; font-weight: bold; }
+      .note { fill: #aaaaaa; font-family: 'Arial', sans-serif; font-size: 10px; }
+    </style>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+    <marker id="arrowhead-orange" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ffaa4a" />
+    </marker>
+    <marker id="arrowhead-red" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ff4a4a" />
+    </marker>
+    <marker id="arrowhead-blue" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4a9eff" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="500"/>
+  
+  <!-- Title -->
+  <text x="400" y="25" text-anchor="middle" class="title">DDQ Architecture - Handler-Scoped Deduplication</text>
+  
+  <!-- Handler A DDQ Group -->
+  <rect x="50" y="80" width="200" height="180" class="handler-a-group"/>
+  <text x="150" y="100" text-anchor="middle" class="group-title">Handler A DDQ</text>
+  
+  <rect x="70" y="120" width="160" height="40" class="component"/>
+  <text x="150" y="135" text-anchor="middle" class="component-title">Circular Array</text>
+  <text x="150" y="150" text-anchor="middle" class="text">FIFO UUID Storage</text>
+  
+  <rect x="70" y="170" width="160" height="40" class="component"/>
+  <text x="150" y="185" text-anchor="middle" class="component-title">Lookup Set</text>
+  <text x="150" y="200" text-anchor="middle" class="text">O(1) Duplicate Check</text>
+  
+  <rect x="70" y="220" width="160" height="30" class="component"/>
+  <text x="150" y="240" text-anchor="middle" class="component-title">Mutex Lock</text>
+  
+  <!-- Handler B DDQ Group -->
+  <rect x="300" y="80" width="200" height="180" class="handler-b-group"/>
+  <text x="400" y="100" text-anchor="middle" class="group-title">Handler B DDQ</text>
+  
+  <rect x="320" y="120" width="160" height="40" class="component"/>
+  <text x="400" y="135" text-anchor="middle" class="component-title">Circular Array</text>
+  <text x="400" y="150" text-anchor="middle" class="text">FIFO UUID Storage</text>
+  
+  <rect x="320" y="170" width="160" height="40" class="component"/>
+  <text x="400" y="185" text-anchor="middle" class="component-title">Lookup Set</text>
+  <text x="400" y="200" text-anchor="middle" class="text">O(1) Duplicate Check</text>
+  
+  <rect x="320" y="220" width="160" height="30" class="component"/>
+  <text x="400" y="240" text-anchor="middle" class="component-title">Mutex Lock</text>
+  
+  <!-- Message and Dispatcher -->
+  <rect x="50" y="300" width="180" height="60" class="message"/>
+  <text x="140" y="320" text-anchor="middle" class="component-title">Incoming Message</text>
+  <text x="140" y="335" text-anchor="middle" class="text">UUID: abc-123</text>
+  <text x="140" y="350" text-anchor="middle" class="text">Data: { order_id: "123" }</text>
+  
+  <rect x="300" y="300" width="120" height="60" class="dispatcher-group"/>
+  <text x="360" y="325" text-anchor="middle" class="component-title">Dispatcher</text>
+  <text x="360" y="340" text-anchor="middle" class="text">Route to handlers</text>
+  <text x="360" y="355" text-anchor="middle" class="text">Check DDQ per handler</text>
+  
+  <!-- Process Results -->
+  <rect x="520" y="120" width="140" height="40" class="component"/>
+  <text x="590" y="135" text-anchor="middle" class="component-title">Process with Handler A</text>
+  <text x="590" y="150" text-anchor="middle" class="text">✅ UUID Not Found - Process</text>
+  
+  <rect x="520" y="180" width="140" height="40" class="component"/>
+  <text x="590" y="195" text-anchor="middle" class="component-title">Skip Handler B</text>
+  <text x="590" y="210" text-anchor="middle" class="text">❌ UUID Found - Duplicate</text>
+  
+  <!-- Flow arrows -->
+  <!-- Message to Dispatcher -->
+  <path d="M 230 330 L 300 330" class="process-flow"/>
+  
+  <!-- Dispatcher to DDQ checks -->
+  <path d="M 360 300 L 150 210" class="check-flow"/>
+  <path d="M 360 300 L 400 210" class="check-flow"/>
+  
+  <!-- DDQ A to Process (Not Found) -->
+  <path d="M 250 190 L 520 140" class="success-flow"/>
+  
+  <!-- DDQ B to Skip (Found) -->
+  <path d="M 500 190 L 520 200" class="skip-flow"/>
+  
+  <!-- Process A to add UUID back to DDQ A -->
+  <path d="M 590 160 L 590 280 L 150 280 L 150 160" class="add-flow"/>
+  <text x="480" y="275" class="note">Add UUID to Array &amp; Set</text>
+  
+  <!-- Labels -->
+  <text x="280" y="125" class="note">Check Handler A</text>
+  <text x="280" y="195" class="note">Check Handler B</text>
+  <text x="370" y="125" class="note">Not Found</text>
+  <text x="420" y="195" class="note">Found</text>
+  
+  <!-- Architecture Details -->
+  <rect x="50" y="400" width="700" height="80" fill="#1a1a1a" stroke="#4a9eff" rx="8"/>
+  <text x="70" y="425" class="component-title">Key Features:</text>
+  <text x="90" y="440" class="text">• Handler Isolation: Each subscription gets its own DDQ instance</text>
+  <text x="90" y="455" class="text">• O(1) Performance: Hybrid Array + Set data structure for optimal speed</text>
+  <text x="90" y="470" class="text">• Thread Safety: Mutex locks prevent race conditions in concurrent processing</text>
+  
+  <text x="420" y="440" class="text">• Memory Efficient: Circular buffer prevents unbounded growth</text>
+  <text x="420" y="455" class="text">• Storage Backends: Memory (default) or Redis for persistence</text>
+  <text x="420" y="470" class="text">• Automatic Cleanup: UUIDs are automatically evicted via circular buffer</text>
+</svg>

data/docs/assets/images/dlq_architecture.svg

@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="700" height="400" viewBox="0 0 700 400" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .publish-group { fill: #1a3a2a; stroke: #4aff4a; stroke-width: 2; rx: 8; }
+      .circuit-group { fill: #3a2a1a; stroke: #ffaa4a; stroke-width: 2; rx: 8; }
+      .transport-group { fill: #1a2a3a; stroke: #4a9eff; stroke-width: 2; rx: 8; }
+      .dlq-group { fill: #3a1a1a; stroke: #ff4a4a; stroke-width: 2; rx: 8; }
+      .replay-group { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 2; rx: 8; }
+      .success-flow { stroke: #4aff4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead-green); }
+      .failure-flow { stroke: #ff4a4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead-red); }
+      .retry-flow { stroke: #aa4aff; stroke-width: 3; fill: none; marker-end: url(#arrowhead-purple); stroke-dasharray: 6,6; }
+      .monitor-flow { stroke: #ffaa4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-orange); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .component-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 13px; font-weight: bold; }
+      .note { fill: #aaaaaa; font-family: 'Arial', sans-serif; font-size: 10px; }
+    </style>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+    <marker id="arrowhead-red" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ff4a4a" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#aa4aff" />
+    </marker>
+    <marker id="arrowhead-orange" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ffaa4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="700" height="400"/>
+  
+  <!-- Title -->
+  <text x="350" y="25" text-anchor="middle" class="title">Dead Letter Queue Architecture</text>
+  
+  <!-- Message Publishing -->
+  <rect x="50" y="70" width="120" height="50" class="publish-group"/>
+  <text x="110" y="90" text-anchor="middle" class="component-title">Message</text>
+  <text x="110" y="105" text-anchor="middle" class="component-title">Publishing</text>
+  
+  <!-- Circuit Breaker Monitoring -->
+  <rect x="220" y="70" width="120" height="50" class="circuit-group"/>
+  <text x="280" y="85" text-anchor="middle" class="component-title">Circuit Breaker</text>
+  <text x="280" y="100" text-anchor="middle" class="component-title">Monitoring</text>
+  <text x="280" y="115" text-anchor="middle" class="text">Failure Detection</text>
+  
+  <!-- Transport Success -->
+  <rect x="390" y="50" width="120" height="50" class="transport-group"/>
+  <text x="450" y="70" text-anchor="middle" class="component-title">Transport</text>
+  <text x="450" y="85" text-anchor="middle" class="component-title">Success</text>
+  <text x="450" y="100" text-anchor="middle" class="text">Message Delivered</text>
+  
+  <!-- Dead Letter Queue -->
+  <rect x="390" y="140" width="120" height="60" class="dlq-group"/>
+  <text x="450" y="160" text-anchor="middle" class="component-title">Dead Letter Queue</text>
+  <text x="450" y="175" text-anchor="middle" class="component-title">Failure Storage</text>
+  <text x="450" y="190" text-anchor="middle" class="text">JSON Lines Format</text>
+  
+  <!-- Replay Mechanism -->
+  <rect x="220" y="180" width="120" height="60" class="replay-group"/>
+  <text x="280" y="200" text-anchor="middle" class="component-title">Replay Mechanism</text>
+  <text x="280" y="215" text-anchor="middle" class="text">Manual/Automated</text>
+  <text x="280" y="230" text-anchor="middle" class="text">Transport Override</text>
+  
+  <!-- Flow arrows -->
+  <!-- Publishing to Circuit Breaker -->
+  <path d="M 170 95 L 220 95" class="monitor-flow"/>
+  
+  <!-- Circuit Breaker Success -->
+  <path d="M 340 85 L 390 75" class="success-flow"/>
+  <text x="345" y="75" class="text">Success</text>
+  
+  <!-- Circuit Breaker Failure -->
+  <path d="M 340 105 L 390 170" class="failure-flow"/>
+  <text x="345" y="140" class="text">Failure</text>
+  
+  <!-- DLQ to Replay -->
+  <path d="M 390 190 L 340 210" class="retry-flow"/>
+  
+  <!-- Replay to Publishing (Retry) -->
+  <path d="M 220 210 L 110 210 L 110 120" class="retry-flow"/>
+  <text x="120" y="205" class="text">Retry</text>
+  
+  <!-- DLQ Features -->
+  <rect x="50" y="280" width="600" height="100" fill="#1a1a1a" stroke="#4a9eff" rx="8"/>
+  <text x="70" y="305" class="component-title">DLQ Features:</text>
+  
+  <text x="70" y="325" class="text">• JSON Lines Format: Efficient append operations with one message per line</text>
+  <text x="70" y="340" class="text">• FIFO Queue Operations: First-in, first-out processing with thread safety</text>
+  <text x="70" y="355" class="text">• Replay Capabilities: Manual and automated retry with transport override support</text>
+  <text x="70" y="370" class="text">• Administrative Tools: Message filtering, analysis, and selective replay functionality</text>
+  
+  <!-- Circuit Breaker States -->
+  <rect x="550" y="70" width="120" height="140" fill="#2a2a2a" stroke="#ffaa4a" rx="8"/>
+  <text x="610" y="90" text-anchor="middle" class="component-title">Circuit States</text>
+  
+  <rect x="560" y="100" width="100" height="25" fill="#1a3a1a" stroke="#4aff4a" rx="3"/>
+  <text x="610" y="117" text-anchor="middle" class="text">CLOSED: Normal</text>
+  
+  <rect x="560" y="130" width="100" height="25" fill="#3a1a1a" stroke="#ff4a4a" rx="3"/>
+  <text x="610" y="147" text-anchor="middle" class="text">OPEN: Failing</text>
+  
+  <rect x="560" y="160" width="100" height="25" fill="#3a2a1a" stroke="#ffaa4a" rx="3"/>
+  <text x="610" y="177" text-anchor="middle" class="text">HALF-OPEN: Test</text>
+  
+  <text x="610" y="200" text-anchor="middle" class="note">Automatic state transitions</text>
+</svg>

data/docs/assets/images/enhanced-dual-publishing.svg

@@ -0,0 +1,136 @@
+<svg width="900" height="600" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; text-anchor: middle; }
+      .code-label { font: 11px monospace; fill: #f0f6fc; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .enhanced-box { fill: #0d1117; stroke: #a5a5ff; stroke-width: 2; rx: 8; }
+      .basic-box { fill: #161b22; stroke: #56d364; stroke-width: 2; rx: 8; }
+      .channel-box { fill: #1a1d2e; stroke: #ffa657; stroke-width: 2; rx: 6; }
+      .subscriber-box { fill: #0d1117; stroke: #f85149; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .dual-arrow { stroke: #a5a5ff; stroke-width: 3; fill: none; marker-end: url(#arrowhead-purple); }
+      .basic-arrow { stroke: #56d364; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#a5a5ff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#56d364" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Enhanced Transport: Dual Publishing</text>
+  
+  <!-- Publisher Section -->
+  <rect x="50" y="60" width="160" height="80" class="enhanced-box"/>
+  <text x="130" y="85" class="label">Enhanced Publisher</text>
+  <text x="130" y="105" class="small-label">OrderMessage</text>
+  <text x="130" y="120" class="code-label">from: 'api-gateway'</text>
+  <text x="130" y="135" class="code-label">to: 'order-service'</text>
+  
+  <!-- Dual Channel Publishing -->
+  <text x="450" y="70" class="label">Dual Channel Publishing</text>
+  
+  <!-- Original Channel -->
+  <rect x="300" y="100" width="300" height="40" class="channel-box"/>
+  <text x="320" y="115" class="small-label">Original Channel (Basic Compatible):</text>
+  <text x="320" y="130" class="code-label">"OrderMessage"</text>
+  
+  <!-- Enhanced Channel -->
+  <rect x="300" y="150" width="300" height="40" class="channel-box"/>
+  <text x="320" y="165" class="small-label">Enhanced Channel (Pattern-based):</text>
+  <text x="320" y="180" class="code-label">"ordermessage.api_gateway.order_service"</text>
+  
+  <!-- Arrows from publisher to channels -->
+  <line x1="210" y1="95" x2="300" y2="120" class="dual-arrow"/>
+  <line x1="210" y1="125" x2="300" y2="170" class="dual-arrow"/>
+  
+  <!-- Subscribers Section -->
+  <text x="750" y="70" class="label">Subscribers</text>
+  
+  <!-- Basic Subscriber -->
+  <rect x="650" y="100" width="160" height="40" class="basic-box"/>
+  <text x="730" y="115" class="small-label">Basic Subscriber</text>
+  <text x="730" y="130" class="code-label">subscribe("OrderMessage")</text>
+  
+  <!-- Enhanced Subscriber -->
+  <rect x="650" y="150" width="160" height="40" class="enhanced-box"/>
+  <text x="730" y="165" class="small-label">Enhanced Subscriber</text>
+  <text x="730" y="180" class="code-label">pattern: "ordermessage.*.*"</text>
+  
+  <!-- Arrows from channels to subscribers -->
+  <line x1="600" y1="120" x2="650" y2="120" class="basic-arrow"/>
+  <line x1="600" y1="170" x2="650" y2="170" class="dual-arrow"/>
+  
+  <!-- Compatibility Matrix -->
+  <rect x="50" y="240" width="800" height="200" class="box"/>
+  <text x="450" y="265" class="label">Transport Compatibility Matrix</text>
+  
+  <!-- Headers -->
+  <rect x="70" y="280" width="150" height="30" class="enhanced-box"/>
+  <text x="145" y="300" class="small-label">Publisher Type</text>
+  
+  <rect x="220" y="280" width="150" height="30" class="basic-box"/>
+  <text x="295" y="300" class="small-label">Basic Subscriber</text>
+  
+  <rect x="370" y="280" width="150" height="30" class="enhanced-box"/>
+  <text x="445" y="300" class="small-label">Enhanced Subscriber</text>
+  
+  <rect x="520" y="280" width="300" height="30" class="channel-box"/>
+  <text x="670" y="300" class="small-label">Channels Used</text>
+  
+  <!-- Basic Publisher Row -->
+  <rect x="70" y="310" width="150" height="40" class="basic-box"/>
+  <text x="145" y="325" class="small-label">Basic Publisher</text>
+  <text x="145" y="340" class="code-label">publish(message)</text>
+  
+  <rect x="220" y="310" width="150" height="40" class="subscriber-box"/>
+  <text x="295" y="325" class="small-label">✅ Receives</text>
+  <text x="295" y="340" class="code-label">Direct match</text>
+  
+  <rect x="370" y="310" width="150" height="40" class="subscriber-box"/>
+  <text x="445" y="325" class="small-label">❌ No Match</text>
+  <text x="445" y="340" class="code-label">Pattern mismatch</text>
+  
+  <rect x="520" y="310" width="300" height="40" class="channel-box"/>
+  <text x="670" y="325" class="code-label">["OrderMessage"]</text>
+  <text x="670" y="340" class="small-label">Original channel only</text>
+  
+  <!-- Enhanced Publisher Row -->
+  <rect x="70" y="350" width="150" height="40" class="enhanced-box"/>
+  <text x="145" y="365" class="small-label">Enhanced Publisher</text>
+  <text x="145" y="380" class="code-label">publish(message)</text>
+  
+  <rect x="220" y="350" width="150" height="40" class="subscriber-box"/>
+  <text x="295" y="365" class="small-label">✅ Receives</text>
+  <text x="295" y="380" class="code-label">Original channel</text>
+  
+  <rect x="370" y="350" width="150" height="40" class="subscriber-box"/>
+  <text x="445" y="365" class="small-label">✅ Receives</text>
+  <text x="445" y="380" class="code-label">Enhanced channel</text>
+  
+  <rect x="520" y="350" width="300" height="40" class="channel-box"/>
+  <text x="670" y="365" class="code-label">["OrderMessage",</text>
+  <text x="670" y="380" class="code-label">"ordermessage.api.order"]</text>
+  
+  <!-- Migration Benefits -->
+  <rect x="50" y="460" width="800" height="120" class="box"/>
+  <text x="450" y="485" class="label">Migration &amp; Compatibility Benefits</text>
+  
+  <text x="200" y="510" class="small-label">🔄 Gradual Migration</text>
+  <text x="70" y="530" class="code-label">• Upgrade publishers to Enhanced without breaking existing subscribers</text>
+  <text x="70" y="545" class="code-label">• Legacy Basic subscribers continue to work unchanged</text>
+  <text x="70" y="560" class="code-label">• New Enhanced subscribers get pattern-matching benefits</text>
+  
+  <text x="650" y="510" class="small-label">⚡ Performance</text>
+  <text x="520" y="530" class="code-label">• No performance penalty for dual publishing</text>
+  <text x="520" y="545" class="code-label">• Redis handles both channels efficiently</text>
+  <text x="520" y="560" class="code-label">• Pattern matching happens at subscriber</text>
+</svg>

data/docs/assets/images/enhanced-fluent-api.svg

@@ -0,0 +1,149 @@
+<svg width="900" height="600" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; }
+      .code-label { font: 11px monospace; fill: #f0f6fc; }
+      .keyword { font: 11px monospace; fill: #ff7b72; font-weight: bold; }
+      .string { font: 11px monospace; fill: #a5d6ff; }
+      .comment { font: 11px monospace; fill: #8b949e; font-style: italic; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .code-box { fill: #0d1117; stroke: #a5a5ff; stroke-width: 2; rx: 6; }
+      .result-box { fill: #161b22; stroke: #56d364; stroke-width: 2; rx: 6; }
+      .chain-box { fill: #1a1d2e; stroke: #ffa657; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .chain-arrow { stroke: #ffa657; stroke-width: 2; fill: none; marker-end: url(#arrowhead-orange); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-orange" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#ffa657" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Enhanced Transport: Fluent API</text>
+  
+  <!-- Basic Fluent API Examples -->
+  <text x="450" y="65" class="label">Fluent API Pattern Building</text>
+  
+  <!-- Example 1: Simple from() -->
+  <rect x="50" y="80" width="350" height="40" class="code-box"/>
+  <text x="60" y="100" class="code-label">transport.</text>
+  <text x="130" y="100" class="keyword">where</text>
+  <text x="170" y="100" class="code-label">.</text>
+  <text x="180" y="100" class="keyword">from</text>
+  <text x="210" y="100" class="code-label">(</text>
+  <text x="220" y="100" class="string">'web-app'</text>
+  <text x="280" y="100" class="code-label">).</text>
+  <text x="300" y="100" class="keyword">subscribe</text>
+  <text x="60" y="115" class="comment"># Pattern: *.web-app.*</text>
+  
+  <rect x="450" y="80" width="200" height="40" class="result-box"/>
+  <text x="460" y="100" class="small-label">Generated Pattern:</text>
+  <text x="460" y="115" class="code-label">*.web-app.*</text>
+  
+  <!-- Arrow -->
+  <line x1="400" y1="100" x2="450" y2="100" class="arrow"/>
+  
+  <!-- Example 2: Combined from() and to() -->
+  <rect x="50" y="140" width="350" height="40" class="code-box"/>
+  <text x="60" y="160" class="code-label">transport.</text>
+  <text x="130" y="160" class="keyword">where</text>
+  <text x="170" y="160" class="code-label">.</text>
+  <text x="180" y="160" class="keyword">from</text>
+  <text x="210" y="160" class="code-label">(</text>
+  <text x="220" y="160" class="string">'api'</text>
+  <text x="250" y="160" class="code-label">).</text>
+  <text x="270" y="160" class="keyword">to</text>
+  <text x="290" y="160" class="code-label">(</text>
+  <text x="300" y="160" class="string">'db'</text>
+  <text x="320" y="160" class="code-label">).</text>
+  <text x="340" y="160" class="keyword">subscribe</text>
+  <text x="60" y="175" class="comment"># Pattern: *.api.db</text>
+  
+  <rect x="450" y="140" width="200" height="40" class="result-box"/>
+  <text x="460" y="160" class="small-label">Generated Pattern:</text>
+  <text x="460" y="175" class="code-label">*.api.db</text>
+  
+  <!-- Arrow -->
+  <line x1="400" y1="160" x2="450" y2="160" class="arrow"/>
+  
+  <!-- Example 3: Complex type, from, to -->
+  <rect x="50" y="200" width="400" height="40" class="code-box"/>
+  <text x="60" y="220" class="code-label">transport.</text>
+  <text x="130" y="220" class="keyword">where</text>
+  <text x="170" y="220" class="code-label">.</text>
+  <text x="180" y="220" class="keyword">type</text>
+  <text x="210" y="220" class="code-label">(</text>
+  <text x="220" y="220" class="string">'Order'</text>
+  <text x="260" y="220" class="code-label">).</text>
+  <text x="280" y="220" class="keyword">from</text>
+  <text x="310" y="220" class="code-label">(</text>
+  <text x="320" y="220" class="string">'web'</text>
+  <text x="350" y="220" class="code-label">).</text>
+  <text x="370" y="220" class="keyword">subscribe</text>
+  <text x="60" y="235" class="comment"># Pattern: order.web.*</text>
+  
+  <rect x="500" y="200" width="200" height="40" class="result-box"/>
+  <text x="510" y="220" class="small-label">Generated Pattern:</text>
+  <text x="510" y="235" class="code-label">order.web.*</text>
+  
+  <!-- Arrow -->
+  <line x1="450" y1="220" x2="500" y2="220" class="arrow"/>
+  
+  <!-- Chaining Visualization -->
+  <rect x="50" y="280" width="800" height="160" class="box"/>
+  <text x="450" y="305" class="label">Method Chaining Visualization</text>
+  
+  <!-- Step-by-step chain -->
+  <rect x="70" y="320" width="100" height="30" class="chain-box"/>
+  <text x="120" y="340" class="code-label">transport</text>
+  
+  <rect x="200" y="320" width="80" height="30" class="chain-box"/>
+  <text x="240" y="340" class="keyword">.where</text>
+  
+  <rect x="310" y="320" width="110" height="30" class="chain-box"/>
+  <text x="365" y="340" class="code-label">.from('api')</text>
+  
+  <rect x="450" y="320" width="100" height="30" class="chain-box"/>
+  <text x="500" y="340" class="code-label">.to('db')</text>
+  
+  <rect x="580" y="320" width="100" height="30" class="chain-box"/>
+  <text x="630" y="340" class="keyword">.subscribe</text>
+  
+  <!-- Chain arrows -->
+  <line x1="170" y1="335" x2="200" y2="335" class="chain-arrow"/>
+  <line x1="280" y1="335" x2="310" y2="335" class="chain-arrow"/>
+  <line x1="420" y1="335" x2="450" y2="335" class="chain-arrow"/>
+  <line x1="550" y1="335" x2="580" y2="335" class="chain-arrow"/>
+  
+  <!-- Builder state progression -->
+  <text x="120" y="365" class="small-label">Start</text>
+  <text x="240" y="365" class="small-label">Builder</text>
+  <text x="365" y="365" class="small-label">+ from</text>
+  <text x="500" y="365" class="small-label">+ to</text>
+  <text x="630" y="365" class="small-label">Execute</text>
+  
+  <text x="120" y="380" class="comment">Initial state</text>
+  <text x="240" y="380" class="comment">Pattern: *.*.*</text>
+  <text x="365" y="380" class="comment">*.api.*</text>
+  <text x="500" y="380" class="comment">*.api.db</text>
+  <text x="630" y="380" class="comment">Subscribe!</text>
+  
+  <!-- Advanced Examples -->
+  <rect x="50" y="460" width="800" height="120" class="box"/>
+  <text x="450" y="485" class="label">Advanced Fluent API Patterns</text>
+  
+  <!-- Multi-condition example -->
+  <text x="70" y="510" class="small-label">Multi-condition Routing:</text>
+  <text x="70" y="530" class="code-label">transport.where.from('monitoring').to('admin-panel').type('AdminAlert').subscribe</text>
+  <text x="70" y="545" class="comment"># Matches: adminalert.monitoring.admin-panel</text>
+  
+  <!-- Broadcasting example -->
+  <text x="70" y="565" class="small-label">Broadcasting Pattern:</text>
+  <text x="70" y="585" class="code-label">transport.where.to('broadcast').subscribe</text>
+  <text x="70" y="560" class="comment"># Matches all broadcast messages: *.*.broadcast</text>
+</svg>