flow_chat 0.3.0 → 0.4.1

data/lib/flow_chat/base_processor.rb

@@ -0,0 +1,67 @@
+require "middleware"
+
+module FlowChat
+  class BaseProcessor
+    attr_reader :middleware
+
+    def initialize(controller)
+      @context = FlowChat::Context.new
+      @context["controller"] = controller
+      @middleware = ::Middleware::Builder.new(name: middleware_name)
+
+      yield self if block_given?
+    end
+
+    def use_gateway(gateway_class, *args)
+      @gateway_class = gateway_class
+      @gateway_args = args
+      self
+    end
+
+    def use_session_store(session_store)
+      @context["session.store"] = session_store
+      self
+    end
+
+    def use_middleware(middleware)
+      @middleware.use middleware
+      self
+    end
+
+    def run(flow_class, action)
+      @context["flow.name"] = flow_class.name.underscore
+      @context["flow.class"] = flow_class
+      @context["flow.action"] = action
+
+      stack = build_middleware_stack
+      yield stack if block_given?
+
+      stack.call(@context)
+    end
+
+    protected
+
+    # Subclasses should override these methods
+    def middleware_name
+      raise NotImplementedError, "Subclasses must implement middleware_name"
+    end
+
+    def build_middleware_stack
+      raise NotImplementedError, "Subclasses must implement build_middleware_stack"
+    end
+
+    # Helper method for building stacks
+    def create_middleware_stack(name)
+      raise ArgumentError, "Gateway is required. Call use_gateway(gateway_class, *args) before running." unless @gateway_class
+
+      ::Middleware::Builder.new(name: name) do |b|
+        b.use @gateway_class, *@gateway_args
+        configure_middleware_stack(b)
+      end.inject_logger(Rails.logger)
+    end
+
+    def configure_middleware_stack(builder)
+      raise NotImplementedError, "Subclasses must implement configure_middleware_stack"
+    end
+  end
+end 

data/lib/flow_chat/config.rb

@@ -9,6 +9,11 @@ module FlowChat
       @ussd ||= UssdConfig.new
     end
 
+    # WhatsApp-specific configuration object
+    def self.whatsapp
+      @whatsapp ||= WhatsappConfig.new
+    end
+
     class UssdConfig
       attr_accessor :pagination_page_size, :pagination_back_option, :pagination_back_text,
         :pagination_next_option, :pagination_next_text,
@@ -25,5 +30,36 @@ module FlowChat
         @resumable_sessions_timeout_seconds = 300
       end
     end
+
+    class WhatsappConfig
+      attr_accessor :message_handling_mode, :background_job_class
+
+      def initialize
+        @message_handling_mode = :inline
+        @background_job_class = 'WhatsappMessageJob'
+      end
+
+      # Validate message handling mode
+      def message_handling_mode=(mode)
+        valid_modes = [:inline, :background, :simulator]
+        unless valid_modes.include?(mode.to_sym)
+          raise ArgumentError, "Invalid message handling mode: #{mode}. Valid modes: #{valid_modes.join(', ')}"
+        end
+        @message_handling_mode = mode.to_sym
+      end
+
+      # Helper methods for mode checking
+      def inline_mode?
+        @message_handling_mode == :inline
+      end
+
+      def background_mode?
+        @message_handling_mode == :background
+      end
+
+      def simulator_mode?
+        @message_handling_mode == :simulator
+      end
+    end
   end
 end

data/lib/flow_chat/session/cache_session_store.rb

@@ -0,0 +1,84 @@
+module FlowChat
+  module Session
+    class CacheSessionStore
+      def initialize(context, cache = nil)
+        @context = context
+        @cache = cache || FlowChat::Config.cache
+        
+        raise ArgumentError, "Cache is required. Set FlowChat::Config.cache or pass a cache instance." unless @cache
+      end
+
+      def get(key)
+        return nil unless @context
+
+        data = @cache.read(session_key)
+        return nil unless data
+
+        data[key.to_s]
+      end
+
+      def set(key, value)
+        return unless @context
+
+        data = @cache.read(session_key) || {}
+        data[key.to_s] = value
+        
+        @cache.write(session_key, data, expires_in: session_ttl)
+        value
+      end
+
+      def delete(key)
+        return unless @context
+
+        data = @cache.read(session_key)
+        return unless data
+
+        data.delete(key.to_s)
+        @cache.write(session_key, data, expires_in: session_ttl)
+      end
+
+      def clear
+        return unless @context
+
+        @cache.delete(session_key)
+      end
+
+      # Alias for compatibility
+      alias_method :destroy, :clear
+
+      def exists?
+        @cache.exist?(session_key)
+      end
+
+      private
+
+      def session_key
+        gateway = @context["request.gateway"]
+        msisdn = @context["request.msisdn"]
+        
+        case gateway
+        when :whatsapp_cloud_api
+          "flow_chat:session:whatsapp:#{msisdn}"
+        when :nalo, :nsano
+          session_id = @context["request.id"]
+          "flow_chat:session:ussd:#{session_id}:#{msisdn}"
+        else
+          "flow_chat:session:unknown:#{msisdn}"
+        end
+      end
+
+      def session_ttl
+        gateway = @context["request.gateway"]
+        
+        case gateway
+        when :whatsapp_cloud_api
+          7.days  # WhatsApp conversations can be long-lived
+        when :nalo, :nsano
+          1.hour  # USSD sessions are typically short
+        else
+          1.day   # Default
+        end
+      end
+    end
+  end
+end 

data/lib/flow_chat/session/middleware.rb

@@ -14,12 +14,20 @@ module FlowChat
       private
 
       def session_id(context)
-        context["request.id"]
-        # File.join(
-        #   context["PATH_INFO"],
-        #   (Config.resumable_sessions_enabled && Config.resumable_sessions_global) ? "global" : context["ussd.request"][:provider].to_s,
-        #   context["ussd.request"][:msisdn]
-        # )
+        gateway = context["request.gateway"]
+        flow_name = context["flow.name"]
+        case gateway
+        when :whatsapp_cloud_api
+          # For WhatsApp, use phone number + flow name for consistent sessions
+          phone = context["request.msisdn"]
+          "#{gateway}:#{flow_name}:#{phone}"
+        # when :nalo, :nsano
+        #   # For USSD, use the request ID from the gateway
+        #   "#{gateway}:#{flow_name}:#{context["request.id"]}"
+        else
+          # Fallback to request ID
+          "#{gateway}:#{flow_name}:#{context["request.id"]}"
+        end
       end
     end
   end

data/lib/flow_chat/simulator/controller.rb

@@ -0,0 +1,78 @@
+module FlowChat
+  module Simulator
+    module Controller
+      def flowchat_simulator
+        respond_to do |format|
+          format.html do
+            render inline: simulator_view_template, layout: false, locals: simulator_locals
+          end
+        end
+      end
+
+      protected
+
+      def default_phone_number
+        "+233244123456"
+      end
+
+      def default_contact_name
+        "John Doe"
+      end
+
+      def default_config_key
+        "ussd"
+      end
+
+      def simulator_configurations
+        {
+          "ussd" => {
+            name: "USSD (Nalo)",
+            description: "Local development USSD testing",
+            processor_type: "ussd",
+            provider: "nalo",
+            endpoint: "/ussd",
+            icon: "📱",
+            color: "#28a745",
+            settings: {
+              phone_number: default_phone_number,
+              session_timeout: 300
+            }
+          },
+          "whatsapp" => {
+            name: "WhatsApp",
+            description: "Local development WhatsApp testing",
+            processor_type: "whatsapp",
+            provider: "cloud_api",
+            endpoint: "/whatsapp/webhook",
+            icon: "💬",
+            color: "#25D366",
+            settings: {
+              phone_number: default_phone_number,
+              contact_name: default_contact_name,
+              verify_token: "local_verify_token",
+              webhook_url: "http://localhost:3000/whatsapp/webhook"
+            }
+          }
+        }
+      end
+
+      def simulator_view_template
+        File.read simulator_view_path
+      end
+
+      def simulator_view_path
+        File.join FlowChat.root.join("flow_chat", "simulator", "views", "simulator.html.erb")
+      end
+
+      def simulator_locals
+        {
+          pagesize: FlowChat::Config.ussd.pagination_page_size,
+          default_phone_number: default_phone_number,
+          default_contact_name: default_contact_name,
+          default_config_key: default_config_key,
+          configurations: simulator_configurations
+        }
+      end
+    end
+  end
+end