smart_message 0.0.7 → 0.0.9

data/examples/show_me.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/env ruby
+# show_me.rb - Demonstrates the pretty_print method on SmartMessage instances
+
+require_relative '../lib/smart_message'
+
+# Define a sample order message
+class OrderMessage < SmartMessage::Base
+  version 1
+  description "A message representing an e-commerce order"
+
+  from 'e-commerce-api'
+  to 'order-processor'
+
+  property :order_id, required: true
+  property :customer_name, required: true
+  property :customer_email
+  property :items, required: true
+  property :total_amount, required: true
+  property :shipping_address
+  property :payment_info
+  property :order_date
+end
+
+# Define a sample user notification message
+class UserNotificationMessage < SmartMessage::Base
+  version 2
+  description "A notification message for users"
+
+  from 'notification-service'
+  to 'user-app'
+
+  property :user_id, required: true
+  property :notification_type, required: true
+  property :title, required: true
+  property :message_body, required: true
+  property :metadata
+  property :priority
+  property :expires_at
+end
+
+puts "=" * 60
+puts "SmartMessage pretty_print Method Demonstration"
+puts "=" * 60
+
+# Create an order message with complex nested data
+puts "\n1. Order Message Example:"
+puts "-" * 30
+
+order = OrderMessage.new(
+  order_id: "ORD-2024-001",
+  customer_name: "Jane Smith",
+  customer_email: "jane.smith@example.com",
+  items: [
+    {
+      product_id: "PROD-123",
+      name: "Wireless Headphones",
+      quantity: 2,
+      unit_price: 99.99,
+      subtotal: 199.98
+    },
+    {
+      product_id: "PROD-456",
+      name: "Phone Case",
+      quantity: 1,
+      unit_price: 24.99,
+      subtotal: 24.99
+    }
+  ],
+  total_amount: 224.97,
+  shipping_address: {
+    street: "123 Main St",
+    city: "Anytown",
+    state: "CA",
+    zip: "90210",
+    country: "USA"
+  },
+  payment_info: {
+    method: "credit_card",
+    last_four: "1234",
+    status: "authorized"
+  },
+  order_date: Time.now
+)
+
+puts ">"*22
+ap order.to_h
+puts "<"*22
+
+order.pretty_print
+
+# Create a user notification message
+puts "\n\n2. User Notification Message Example:"
+puts "-" * 40
+
+notification = UserNotificationMessage.new(
+  user_id: "user_789",
+  notification_type: "order_update",
+  title: "Your Order Has Shipped!",
+  message_body: "Great news! Your order #ORD-2024-001 has been shipped and is on its way.",
+  metadata: {
+    tracking_number: "1Z999AA1234567890",
+    carrier: "UPS",
+    estimated_delivery: "2024-08-21",
+    order_id: "ORD-2024-001",
+    push_notification: true,
+    email_notification: true
+  },
+  priority: "high",
+  expires_at: Time.now + (7 * 24 * 60 * 60) # 7 days from now
+)
+
+notification.pretty_print
+
+# Create a simple message to show minimal data
+puts "\n\n3. Simple Message Example (Content Only):"
+puts "-" * 40
+
+class SimpleMessage < SmartMessage::Base
+  from 'greeting-service'
+  
+  property :greeting, required: true
+  property :recipient
+end
+
+simple = SimpleMessage.new(
+  greeting: "Hello, World!",
+  recipient: "Everyone"
+)
+
+simple.pretty_print
+
+puts "\n\n4. Message with Header Information:"
+puts "-" * 40
+puts "Using pretty_print(include_header: true) to show both header and content:\n"
+
+simple.pretty_print(include_header: true)
+
+puts "\n" + "=" * 60
+puts "Demonstration Complete!"
+puts "=" * 60
+puts "\nThe pretty_print method has two modes:"
+puts "• pretty_print() - Shows only message content (default)"
+puts "• pretty_print(include_header: true) - Shows header + content"
+puts "\nThis filters out internal SmartMessage properties and presents"
+puts "the data in a beautifully formatted, readable way using amazing_print."

data/examples/temp.txt

@@ -0,0 +1,94 @@
+=== SmartMessage Example: Point-to-Point Order Processing ===
+
+🚀 Starting Order Processing Demo
+🏪 OrderService: Starting up...
+💳 PaymentService: Starting up...
+
+============================================================
+Processing Sample Orders
+============================================================
+
+--- Order 1 ---
+
+🏪 OrderService: Creating order ORD-1001
+🏪 OrderService: Sending order to payment processing...
+
+===================================================
+== SmartMessage Published via STDOUT Transport
+== Single-Tier Serialization:
+== Message Class: OrderMessage
+== Serialized Message: {"_sm_header":{"uuid":"d9a7f410-b902-4a67-9e22-694d3bf01b5f","message_class":"OrderMessage","published_at":"2025-08-20 12:02:21 -0500","publisher_pid":50033,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1001","customer_id":"CUST-001","amount":99.99,"currency":"USD","payment_method":"credit_card","items":["Widget A","Widget B"]}}
+===================================================
+
+💳 PaymentService: Starting up...
+💳 PaymentService: Processing payment for order ORD-1001
+💳 PaymentService: Sending payment response...
+
+===================================================
+== SmartMessage Published via STDOUT Transport
+== Single-Tier Serialization:
+== Message Class: PaymentResponseMessage
+== Serialized Message: {"_sm_header":{"uuid":"ca09a331-d5b9-4250-ab4c-542a1b1db9c7","message_class":"PaymentResponseMessage","published_at":"2025-08-20 12:02:21 -0500","publisher_pid":50033,"version":1,"from":"PaymentService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1001","payment_id":"PAY-5001","status":"success","message":"Payment processed successfully","processed_at":"2025-08-20T12:02:21-05:00"}}
+===================================================
+
+✅ Payment success: Order ORD-1001 - Payment processed successfully
+
+--- Order 2 ---
+
+🏪 OrderService: Creating order ORD-1002
+🏪 OrderService: Sending order to payment processing...
+
+===================================================
+== SmartMessage Published via STDOUT Transport
+== Single-Tier Serialization:
+== Message Class: OrderMessage
+== Serialized Message: {"_sm_header":{"uuid":"85ee7a93-ad19-48b3-9366-b6ed6dbb9e0e","message_class":"OrderMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1002","customer_id":"CUST-002","amount":1299.99,"currency":"USD","payment_method":"debit_card","items":["Premium Widget","Extended Warranty"]}}
+===================================================
+
+💳 PaymentService: Starting up...
+💳 PaymentService: Processing payment for order ORD-1002
+💳 PaymentService: Sending payment response...
+
+===================================================
+== SmartMessage Published via STDOUT Transport
+== Single-Tier Serialization:
+== Message Class: PaymentResponseMessage
+== Serialized Message: {"_sm_header":{"uuid":"773c1dc9-5ee2-4866-a5d0-95701f436250","message_class":"PaymentResponseMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"PaymentService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1002","payment_id":"PAY-5001","status":"failed","message":"Insufficient funds","processed_at":"2025-08-20T12:02:22-05:00"}}
+===================================================
+
+❌ Payment failed: Order ORD-1002 - Insufficient funds
+
+--- Order 3 ---
+
+🏪 OrderService: Creating order ORD-1003
+🏪 OrderService: Sending order to payment processing...
+
+===================================================
+== SmartMessage Published via STDOUT Transport
+== Single-Tier Serialization:
+== Message Class: OrderMessage
+== Serialized Message: {"_sm_header":{"uuid":"5b3cb763-8c3e-470f-b6f9-dd5e0929f926","message_class":"OrderMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"OrderService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1003","customer_id":"CUST-003","amount":45.5,"currency":"USD","payment_method":"paypal","items":["Small Widget"]}}
+===================================================
+
+💳 PaymentService: Starting up...
+💳 PaymentService: Processing payment for order ORD-1003
+💳 PaymentService: Sending payment response...
+
+===================================================
+== SmartMessage Published via STDOUT Transport
+== Single-Tier Serialization:
+== Message Class: PaymentResponseMessage
+== Serialized Message: {"_sm_header":{"uuid":"dc35ea12-28a5-4926-854a-d2cc52f6c91b","message_class":"PaymentResponseMessage","published_at":"2025-08-20 12:02:22 -0500","publisher_pid":50033,"version":1,"from":"PaymentService","serializer":"SmartMessage::Serializer::Json"},"_sm_payload":{"order_id":"ORD-1003","payment_id":"PAY-5001","status":"success","message":"Payment processed successfully","processed_at":"2025-08-20T12:02:22-05:00"}}
+===================================================
+
+✅ Payment success: Order ORD-1003 - Payment processed successfully
+
+⏳ Waiting for all payments to process...
+
+✨ Demo completed!
+
+This example demonstrated:
+• Point-to-point messaging between OrderService and PaymentService
+• Bidirectional communication with request/response pattern
+• JSON serialization of complex message data
+• STDOUT transport with loopback for local demonstration

data/examples/tmux_chat/bot_agent.rb

@@ -53,7 +53,8 @@ class BotChatAgent < BaseAgent
     end
   end
 
-  def handle_bot_command(message_header, message_payload)
+  def handle_bot_command(wrapper)
+    message_header, message_payload = wrapper.split
     command_data = JSON.parse(message_payload)
     
     # Only handle commands in rooms we're in and commands we can handle
@@ -66,7 +67,8 @@ class BotChatAgent < BaseAgent
     process_command(command_data)
   end
 
-  def handle_chat_message(message_header, message_payload)
+  def handle_chat_message(wrapper)
+    message_header, message_payload = wrapper.split
     chat_data = JSON.parse(message_payload)
     
     # Only process messages from rooms we're in and not our own messages

data/examples/tmux_chat/human_agent.rb

@@ -69,7 +69,8 @@ class HumanChatAgent < BaseAgent
     end
   end
 
-  def handle_chat_message(message_header, message_payload)
+  def handle_chat_message(wrapper)
+    message_header, message_payload = wrapper.split
     chat_data = JSON.parse(message_payload)
     
     # Only process messages from rooms we're in and not our own messages
@@ -90,7 +91,8 @@ class HumanChatAgent < BaseAgent
     end
   end
 
-  def handle_system_notification(message_header, message_payload)
+  def handle_system_notification(wrapper)
+    message_header, message_payload = wrapper.split
     notif_data = JSON.parse(message_payload)
     
     # Only process notifications from rooms we're in

data/examples/tmux_chat/room_monitor.rb

@@ -62,7 +62,8 @@ class RoomMonitor < BaseAgent
     end
   end
 
-  def handle_chat_message(message_header, message_payload)
+  def handle_chat_message(wrapper)
+    message_header, message_payload = wrapper.split
     chat_data = JSON.parse(message_payload)
     
     return unless chat_data['room_id'] == @room_id
@@ -93,7 +94,8 @@ class RoomMonitor < BaseAgent
     end
   end
 
-  def handle_system_notification(message_header, message_payload)
+  def handle_system_notification(wrapper)
+    message_header, message_payload = wrapper.split
     notif_data = JSON.parse(message_payload)
     
     return unless notif_data['room_id'] == @room_id

data/examples/tmux_chat/shared_chat_system.rb

@@ -128,7 +128,8 @@ class ChatMessage < SmartMessage::Base
     serializer SmartMessage::Serializer::JSON.new
   end
 
-  def self.process(message_header, message_payload)
+  def self.process(wrapper)
+    message_header, message_payload = wrapper.split
     # Default processing - agents will override this
   end
 end
@@ -157,7 +158,8 @@ class BotCommandMessage < SmartMessage::Base
     serializer SmartMessage::Serializer::JSON.new
   end
 
-  def self.process(message_header, message_payload)
+  def self.process(wrapper)
+    message_header, message_payload = wrapper.split
     # Default processing - bots will override this
   end
 end
@@ -184,7 +186,8 @@ class SystemNotificationMessage < SmartMessage::Base
     serializer SmartMessage::Serializer::JSON.new
   end
 
-  def self.process(message_header, message_payload)
+  def self.process(wrapper)
+    message_header, message_payload = wrapper.split
     # Default processing
   end
 end

data/lib/smart_message/addressing.rb

@@ -0,0 +1,259 @@
+# lib/smart_message/addressing.rb
+# encoding: utf-8
+# frozen_string_literal: true
+
+module SmartMessage
+  # Addressing configuration module for SmartMessage::Base
+  # Handles from, to, and reply_to addressing at both class and instance levels
+  module Addressing
+    
+    # DSL context for header block processing
+    class HeaderDSL
+      def initialize(message_class)
+        @message_class = message_class
+      end
+
+      # Set default from value for this message class
+      def from(entity_id)
+        @message_class.from(entity_id)
+      end
+
+      # Set default to value for this message class
+      def to(entity_id)
+        @message_class.to(entity_id)
+      end
+
+      # Set default reply_to value for this message class
+      def reply_to(entity_id)
+        @message_class.reply_to(entity_id)
+      end
+    end
+    def self.included(base)
+      base.extend(ClassMethods)
+      base.class_eval do
+        # Class-level addressing configuration - use a registry for per-class isolation
+        class_variable_set(:@@addressing_registry, {}) unless class_variable_defined?(:@@addressing_registry)
+      end
+    end
+
+    #########################################################
+    ## instance-level addressing configuration
+
+    def from(entity_id = nil)
+      if entity_id.nil?
+        @from || self.class.from
+      else
+        @from = entity_id
+        # Update the header with the new value
+        _sm_header.from = entity_id if _sm_header
+        self  # Return self for method chaining
+      end
+    end
+    
+    # Setter shortcut for cleaner assignment syntax
+    def from=(entity_id)
+      @from = entity_id
+      _sm_header.from = entity_id if _sm_header
+    end
+    
+    def from_configured?; !from.nil?; end
+    def from_missing?;     from.nil?; end
+    def reset_from;       
+      @from = nil
+      _sm_header.from = nil if _sm_header
+    end
+
+    def to(entity_id = nil)
+      if entity_id.nil?
+        @to || self.class.to
+      else
+        @to = entity_id
+        # Update the header with the new value
+        _sm_header.to = entity_id if _sm_header
+        self  # Return self for method chaining
+      end
+    end
+    
+    # Setter shortcut for cleaner assignment syntax
+    def to=(entity_id)
+      @to = entity_id
+      _sm_header.to = entity_id if _sm_header
+    end
+    
+    def to_configured?;   !to.nil?; end
+    def to_missing?;       to.nil?; end
+    def reset_to;         
+      @to = nil
+      _sm_header.to = nil if _sm_header
+    end
+
+    def reply_to(entity_id = nil)
+      if entity_id.nil?
+        @reply_to || self.class.reply_to
+      else
+        @reply_to = entity_id
+        # Update the header with the new value
+        _sm_header.reply_to = entity_id if _sm_header
+        self  # Return self for method chaining
+      end
+    end
+    
+    # Setter shortcut for cleaner assignment syntax
+    def reply_to=(entity_id)
+      @reply_to = entity_id
+      _sm_header.reply_to = entity_id if _sm_header
+    end
+    
+    def reply_to_configured?; !reply_to.nil?; end
+    def reply_to_missing?;     reply_to.nil?; end
+    def reset_reply_to;       
+      @reply_to = nil
+      _sm_header.reply_to = nil if _sm_header
+    end
+
+    module ClassMethods
+      #########################################################
+      ## Header DSL support
+      
+      # Header DSL block processor  
+      # Allows: header do; from "service"; to "target"; end
+      def header(*args, &block)
+        # Handle the case where this might be called with unexpected arguments
+        # This helps with IRB compatibility issues
+        if args.length > 0
+          # If called with arguments, this might be an IRB inspection issue
+          # Try to delegate gracefully or return nil
+          return nil
+        end
+        
+        if block_given?
+          # Create a DSL context to capture header configuration
+          dsl = HeaderDSL.new(self)
+          dsl.instance_eval(&block)
+        else
+          # No block provided - this is an error for class-level usage
+          raise ArgumentError, "header() at class level requires a block. Use: header do; from 'value'; end"
+        end
+      end
+
+      #########################################################
+      ## class-level addressing configuration
+      
+      # Helper method to normalize filter values (string -> array, nil -> nil)
+      private def normalize_filter_value(value)
+        case value
+        when nil
+          nil
+        when String, Regexp
+          [value]
+        when Array
+          # Validate that array contains only Strings and Regexps
+          value.each do |item|
+            unless item.is_a?(String) || item.is_a?(Regexp)
+              raise ArgumentError, "Array filter values must be Strings or Regexps, got: #{item.class}"
+            end
+          end
+          value
+        else
+          raise ArgumentError, "Filter value must be a String, Regexp, Array, or nil, got: #{value.class}"
+        end
+      end
+      
+      # Helper method to find addressing values in the inheritance chain
+      private def find_addressing_value(field)
+        # Start with current class
+        current_class = self
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        
+        while current_class && current_class.respond_to?(:name)
+          class_name = current_class.name || current_class.to_s
+          
+          # Check registry for this class
+          result = addressing_registry.dig(class_name, field)
+          return result if result
+          
+          # If we have a proper name but no result, also check the to_s version
+          if current_class.name
+            alternative_key = current_class.to_s
+            result = addressing_registry.dig(alternative_key, field)
+            return result if result
+          end
+          
+          # Move up the inheritance chain
+          current_class = current_class.superclass
+          
+          # Stop if we reach SmartMessage::Base or above
+          break if current_class == SmartMessage::Base || current_class.nil?
+        end
+        
+        nil
+      end
+
+      def from(entity_id = nil)
+        class_name = self.name || self.to_s
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        if entity_id.nil?
+          # Try to find the value, checking inheritance chain
+          result = find_addressing_value(:from)
+          result
+        else
+          addressing_registry[class_name] ||= {}
+          addressing_registry[class_name][:from] = entity_id
+        end
+      end
+      
+      def from_configured?; !from.nil?; end
+      def from_missing?;     from.nil?; end
+      def reset_from; 
+        class_name = self.name || self.to_s
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        addressing_registry[class_name] ||= {}
+        addressing_registry[class_name][:from] = nil
+      end
+
+      def to(entity_id = nil)
+        class_name = self.name || self.to_s
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        if entity_id.nil?
+          # Try to find the value, checking inheritance chain
+          result = find_addressing_value(:to)
+          result
+        else
+          addressing_registry[class_name] ||= {}
+          addressing_registry[class_name][:to] = entity_id
+        end
+      end
+      
+      def to_configured?;   !to.nil?; end
+      def to_missing?;       to.nil?; end
+      def reset_to; 
+        class_name = self.name || self.to_s
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        addressing_registry[class_name] ||= {}
+        addressing_registry[class_name][:to] = nil
+      end
+
+      def reply_to(entity_id = nil)
+        class_name = self.name || self.to_s
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        if entity_id.nil?
+          # Try to find the value, checking inheritance chain
+          result = find_addressing_value(:reply_to)
+          result
+        else
+          addressing_registry[class_name] ||= {}
+          addressing_registry[class_name][:reply_to] = entity_id
+        end
+      end
+      
+      def reply_to_configured?; !reply_to.nil?; end
+      def reply_to_missing?;     reply_to.nil?; end
+      def reset_reply_to; 
+        class_name = self.name || self.to_s
+        addressing_registry = class_variable_get(:@@addressing_registry)
+        addressing_registry[class_name] ||= {}
+        addressing_registry[class_name][:reply_to] = nil
+      end
+    end
+  end
+end