flow_chat 0.4.0 → 0.4.2

data/lib/flow_chat/ussd/gateway/nsano.rb

@@ -14,7 +14,7 @@ module FlowChat
 
           # Add timestamp for all requests
           context["request.timestamp"] = Time.current.iso8601
-          
+
           # Set a basic message_id (can be enhanced based on actual Nsano implementation)
           context["request.message_id"] = SecureRandom.uuid
 

data/lib/flow_chat/ussd/processor.rb

@@ -17,7 +17,6 @@ module FlowChat
       end
 
       def configure_middleware_stack(builder)
-        builder.use gateway
         builder.use FlowChat::Session::Middleware
         builder.use FlowChat::Ussd::Middleware::Pagination
         builder.use middleware
@@ -25,4 +24,4 @@ module FlowChat
       end
     end
   end
-end 
+end

data/lib/flow_chat/ussd/prompt.rb

@@ -7,23 +7,31 @@ module FlowChat
         @user_input = input
       end
 
-      def ask(msg, choices: nil, convert: nil, validate: nil, transform: nil)
+      def ask(msg, choices: nil, convert: nil, validate: nil, transform: nil, media: nil)
         if user_input.present?
           input = user_input
           input = convert.call(input) if convert.present?
           validation_error = validate.call(input) if validate.present?
 
-          prompt!([validation_error, msg].join("\n\n"), choices:) if validation_error.present?
+          if validation_error.present?
+            # Include media URL in validation error message
+            original_message_with_media = build_message_with_media(msg, media)
+            prompt!([validation_error, original_message_with_media].join("\n\n"), choices:)
+          end
 
           input = transform.call(input) if transform.present?
           return input
         end
 
-        prompt! msg, choices:
+        # Include media URL in the message for USSD
+        final_message = build_message_with_media(msg, media)
+        prompt! final_message, choices:
       end
 
-      def say(message)
-        terminate! message
+      def say(message, media: nil)
+        # Include media URL in the message for USSD
+        final_message = build_message_with_media(message, media)
+        terminate! final_message
       end
 
       def select(msg, choices)
@@ -43,6 +51,32 @@ module FlowChat
 
       private
 
+      def build_message_with_media(message, media)
+        return message unless media
+
+        media_url = media[:url] || media[:path]
+        media_type = media[:type] || :image
+
+        # For USSD, we append the media URL to the message
+        media_text = case media_type.to_sym
+        when :image
+          "📷 Image: #{media_url}"
+        when :document
+          "📄 Document: #{media_url}"
+        when :audio
+          "🎵 Audio: #{media_url}"
+        when :video
+          "🎥 Video: #{media_url}"
+        when :sticker
+          "😊 Sticker: #{media_url}"
+        else
+          "📎 Media: #{media_url}"
+        end
+
+        # Combine message with media information
+        "#{message}\n\n#{media_text}"
+      end
+
       def build_select_choices(choices)
         case choices
         when Array

data/lib/flow_chat/version.rb

@@ -1,3 +1,3 @@
 module FlowChat
-  VERSION = "0.4.0"
+  VERSION = "0.4.2"
 end

data/lib/flow_chat/whatsapp/app.rb

@@ -17,7 +17,13 @@ module FlowChat
         navigation_stack << key
         return session.get(key) if session.get(key).present?
 
-        prompt = FlowChat::Whatsapp::Prompt.new input
+        user_input = input
+        if session.get("$started_at$").nil?
+          session.set("$started_at$", Time.current.iso8601)
+          user_input = nil
+        end
+
+        prompt = FlowChat::Whatsapp::Prompt.new user_input
         @input = nil # input is being submitted to prompt so we clear it
 
         value = yield prompt
@@ -55,4 +61,4 @@ module FlowChat
       end
     end
   end
-end 
+end

data/lib/flow_chat/whatsapp/client.rb

@@ -0,0 +1,435 @@
+require "net/http"
+require "json"
+require "uri"
+require "tempfile"
+require "securerandom"
+
+module FlowChat
+  module Whatsapp
+    class Client
+      WHATSAPP_API_URL = "https://graph.facebook.com/v18.0"
+
+      def initialize(config)
+        @config = config
+      end
+
+      # Send a message to a WhatsApp number
+      # @param to [String] Phone number in E.164 format
+      # @param response [Array] FlowChat response array [type, content, options]
+      # @return [Hash] API response or nil on error
+      def send_message(to, response)
+        message_data = build_message_payload(response, to)
+        send_message_payload(message_data)
+      end
+
+      # Send a text message
+      # @param to [String] Phone number in E.164 format
+      # @param text [String] Message text
+      # @return [Hash] API response or nil on error
+      def send_text(to, text)
+        send_message(to, [:text, text, {}])
+      end
+
+      # Send interactive buttons
+      # @param to [String] Phone number in E.164 format
+      # @param text [String] Message text
+      # @param buttons [Array] Array of button hashes with :id and :title
+      # @return [Hash] API response or nil on error
+      def send_buttons(to, text, buttons)
+        send_message(to, [:interactive_buttons, text, {buttons: buttons}])
+      end
+
+      # Send interactive list
+      # @param to [String] Phone number in E.164 format
+      # @param text [String] Message text
+      # @param sections [Array] List sections
+      # @param button_text [String] Button text (default: "Choose")
+      # @return [Hash] API response or nil on error
+      def send_list(to, text, sections, button_text = "Choose")
+        send_message(to, [:interactive_list, text, {sections: sections, button_text: button_text}])
+      end
+
+      # Send a template message
+      # @param to [String] Phone number in E.164 format
+      # @param template_name [String] Template name
+      # @param components [Array] Template components
+      # @param language [String] Language code (default: "en_US")
+      # @return [Hash] API response or nil on error
+      def send_template(to, template_name, components = [], language = "en_US")
+        send_message(to, [:template, "", {
+          template_name: template_name,
+          components: components,
+          language: language
+        }])
+      end
+
+      # Send image message
+      # @param to [String] Phone number in E.164 format
+      # @param image_url_or_id [String] Image URL or WhatsApp media ID
+      # @param caption [String] Optional caption
+      # @param mime_type [String] Optional MIME type for URLs (e.g., 'image/jpeg')
+      # @return [Hash] API response
+      def send_image(to, image_url_or_id, caption = nil, mime_type = nil)
+        send_media_message(to, :image, image_url_or_id, caption: caption, mime_type: mime_type)
+      end
+
+      # Send document message
+      # @param to [String] Phone number in E.164 format
+      # @param document_url_or_id [String] Document URL or WhatsApp media ID
+      # @param caption [String] Optional caption
+      # @param filename [String] Optional filename
+      # @param mime_type [String] Optional MIME type for URLs (e.g., 'application/pdf')
+      # @return [Hash] API response
+      def send_document(to, document_url_or_id, caption = nil, filename = nil, mime_type = nil)
+        filename ||= extract_filename_from_url(document_url_or_id) if url?(document_url_or_id)
+        send_media_message(to, :document, document_url_or_id, caption: caption, filename: filename, mime_type: mime_type)
+      end
+
+      # Send video message
+      # @param to [String] Phone number in E.164 format
+      # @param video_url_or_id [String] Video URL or WhatsApp media ID
+      # @param caption [String] Optional caption
+      # @param mime_type [String] Optional MIME type for URLs (e.g., 'video/mp4')
+      # @return [Hash] API response
+      def send_video(to, video_url_or_id, caption = nil, mime_type = nil)
+        send_media_message(to, :video, video_url_or_id, caption: caption, mime_type: mime_type)
+      end
+
+      # Send audio message
+      # @param to [String] Phone number in E.164 format
+      # @param audio_url_or_id [String] Audio URL or WhatsApp media ID
+      # @param mime_type [String] Optional MIME type for URLs (e.g., 'audio/mpeg')
+      # @return [Hash] API response
+      def send_audio(to, audio_url_or_id, mime_type = nil)
+        send_media_message(to, :audio, audio_url_or_id, mime_type: mime_type)
+      end
+
+      # Send sticker message
+      # @param to [String] Phone number in E.164 format
+      # @param sticker_url_or_id [String] Sticker URL or WhatsApp media ID
+      # @param mime_type [String] Optional MIME type for URLs (e.g., 'image/webp')
+      # @return [Hash] API response
+      def send_sticker(to, sticker_url_or_id, mime_type = nil)
+        send_media_message(to, :sticker, sticker_url_or_id, mime_type: mime_type)
+      end
+
+      # Upload media file and return media ID
+      # @param file_path_or_io [String, IO] File path or IO object
+      # @param mime_type [String] MIME type of the file (required)
+      # @param filename [String] Optional filename for the upload
+      # @return [String] Media ID
+      # @raise [StandardError] If upload fails
+      def upload_media(file_path_or_io, mime_type, filename = nil)
+        raise ArgumentError, "mime_type is required" if mime_type.nil? || mime_type.empty?
+
+        if file_path_or_io.is_a?(String)
+          # File path
+          raise ArgumentError, "File not found: #{file_path_or_io}" unless File.exist?(file_path_or_io)
+          filename ||= File.basename(file_path_or_io)
+          file = File.open(file_path_or_io, "rb")
+        else
+          # IO object
+          file = file_path_or_io
+          filename ||= "upload"
+        end
+
+        # Upload directly via HTTP
+        uri = URI("#{WHATSAPP_API_URL}/#{@config.phone_number_id}/media")
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        # Prepare multipart form data
+        boundary = "----WebKitFormBoundary#{SecureRandom.hex(16)}"
+
+        form_data = []
+        form_data << "--#{boundary}"
+        form_data << 'Content-Disposition: form-data; name="messaging_product"'
+        form_data << ""
+        form_data << "whatsapp"
+
+        form_data << "--#{boundary}"
+        form_data << "Content-Disposition: form-data; name=\"file\"; filename=\"#{filename}\""
+        form_data << "Content-Type: #{mime_type}"
+        form_data << ""
+        form_data << file.read
+
+        form_data << "--#{boundary}"
+        form_data << 'Content-Disposition: form-data; name="type"'
+        form_data << ""
+        form_data << mime_type
+
+        form_data << "--#{boundary}--"
+
+        body = form_data.join("\r\n")
+
+        request = Net::HTTP::Post.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+        request["Content-Type"] = "multipart/form-data; boundary=#{boundary}"
+        request.body = body
+
+        response = http.request(request)
+
+        if response.is_a?(Net::HTTPSuccess)
+          data = JSON.parse(response.body)
+          data["id"] || raise(StandardError, "Failed to upload media: #{data}")
+        else
+          Rails.logger.error "WhatsApp Media Upload error: #{response.body}"
+          raise StandardError, "Media upload failed: #{response.body}"
+        end
+      ensure
+        file&.close if file_path_or_io.is_a?(String)
+      end
+
+      # Build message payload for WhatsApp API
+      # This method is exposed so the gateway can use it for simulator mode
+      def build_message_payload(response, to)
+        type, content, options = response
+
+        case type
+        when :text
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "text",
+            text: {body: content}
+          }
+        when :interactive_buttons
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "interactive",
+            interactive: {
+              type: "button",
+              body: {text: content},
+              action: {
+                buttons: options[:buttons].map.with_index do |button, index|
+                  {
+                    type: "reply",
+                    reply: {
+                      id: button[:id] || index.to_s,
+                      title: button[:title]
+                    }
+                  }
+                end
+              }
+            }
+          }
+        when :interactive_list
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "interactive",
+            interactive: {
+              type: "list",
+              body: {text: content},
+              action: {
+                button: options[:button_text] || "Choose",
+                sections: options[:sections]
+              }
+            }
+          }
+        when :template
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "template",
+            template: {
+              name: options[:template_name],
+              language: {code: options[:language] || "en_US"},
+              components: options[:components] || []
+            }
+          }
+        when :media_image
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "image",
+            image: build_media_object(options)
+          }
+        when :media_document
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "document",
+            document: build_media_object(options)
+          }
+        when :media_audio
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "audio",
+            audio: build_media_object(options)
+          }
+        when :media_video
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "video",
+            video: build_media_object(options)
+          }
+        when :media_sticker
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "sticker",
+            sticker: build_media_object(options)
+          }
+        else
+          # Default to text message
+          {
+            messaging_product: "whatsapp",
+            to: to,
+            type: "text",
+            text: {body: content.to_s}
+          }
+        end
+      end
+
+      # Get media URL from media ID
+      # @param media_id [String] Media ID from WhatsApp
+      # @return [String] Media URL or nil on error
+      def get_media_url(media_id)
+        uri = URI("#{WHATSAPP_API_URL}/#{media_id}")
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Get.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+
+        response = http.request(request)
+
+        if response.is_a?(Net::HTTPSuccess)
+          data = JSON.parse(response.body)
+          data["url"]
+        else
+          Rails.logger.error "WhatsApp Media API error: #{response.body}"
+          nil
+        end
+      end
+
+      # Download media content
+      # @param media_id [String] Media ID from WhatsApp
+      # @return [String] Media content or nil on error
+      def download_media(media_id)
+        media_url = get_media_url(media_id)
+        return nil unless media_url
+
+        uri = URI(media_url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Get.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+
+        response = http.request(request)
+
+        if response.is_a?(Net::HTTPSuccess)
+          response.body
+        else
+          Rails.logger.error "WhatsApp Media download error: #{response.body}"
+          nil
+        end
+      end
+
+      # Get MIME type from URL without downloading (HEAD request)
+      def get_media_mime_type(url)
+        require "net/http"
+
+        uri = URI(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = (uri.scheme == "https")
+
+        # Use HEAD request to get headers without downloading content
+        response = http.head(uri.path)
+        response["content-type"]
+      rescue => e
+        Rails.logger.warn "Could not detect MIME type for #{url}: #{e.message}"
+        nil
+      end
+
+      private
+
+      # Build media object for WhatsApp API, handling both URLs and media IDs
+      # @param options [Hash] Options containing url/id, caption, filename
+      # @return [Hash] Media object for WhatsApp API
+      def build_media_object(options)
+        media_obj = {}
+
+        # Handle URL or ID
+        if options[:url]
+          # Use URL directly
+          media_obj[:link] = options[:url]
+        elsif options[:id]
+          # Use provided media ID directly
+          media_obj[:id] = options[:id]
+        end
+
+        # Add optional fields
+        media_obj[:caption] = options[:caption] if options[:caption]
+        media_obj[:filename] = options[:filename] if options[:filename]
+
+        media_obj
+      end
+
+      # Check if input is a URL or file path/media ID
+      def url?(input)
+        input.to_s.start_with?("http://", "https://")
+      end
+
+      # Extract filename from URL
+      def extract_filename_from_url(url)
+        uri = URI(url)
+        filename = File.basename(uri.path)
+        filename.empty? ? "document" : filename
+      rescue
+        "document"
+      end
+
+      # Send message payload to WhatsApp API
+      # @param message_data [Hash] Message payload
+      # @return [Hash] API response or nil on error
+      def send_message_payload(message_data)
+        uri = URI("#{WHATSAPP_API_URL}/#{@config.phone_number_id}/messages")
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Post.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+        request["Content-Type"] = "application/json"
+        request.body = message_data.to_json
+
+        response = http.request(request)
+
+        if response.is_a?(Net::HTTPSuccess)
+          JSON.parse(response.body)
+        else
+          Rails.logger.error "WhatsApp API error: #{response.body}"
+          nil
+        end
+      end
+
+      def send_media_message(to, media_type, url_or_id, caption: nil, filename: nil, mime_type: nil)
+        media_object = if url?(url_or_id)
+          {link: url_or_id}
+        else
+          {id: url_or_id}
+        end
+
+        # Add caption if provided (stickers don't support captions)
+        media_object[:caption] = caption if caption && media_type != :sticker
+
+        # Add filename for documents
+        media_object[:filename] = filename if filename && media_type == :document
+
+        message = {
+          :messaging_product => "whatsapp",
+          :to => to,
+          :type => media_type.to_s,
+          media_type.to_s => media_object
+        }
+
+        send_message_payload(message)
+      end
+    end
+  end
+end

data/lib/flow_chat/whatsapp/configuration.rb

@@ -2,9 +2,13 @@ module FlowChat
   module Whatsapp
     class Configuration
       attr_accessor :access_token, :phone_number_id, :verify_token, :app_id, :app_secret,
-                    :webhook_url, :webhook_verify_token, :business_account_id
+        :webhook_url, :webhook_verify_token, :business_account_id, :name
 
-      def initialize
+      # Class-level storage for named configurations
+      @@configurations = {}
+
+      def initialize(name)
+        @name = name
         @access_token = nil
         @phone_number_id = nil
         @verify_token = nil
@@ -13,12 +17,14 @@ module FlowChat
         @webhook_url = nil
         @webhook_verify_token = nil
         @business_account_id = nil
+
+        register_as(name) if name.present?
       end
 
       # Load configuration from Rails credentials or environment variables
       def self.from_credentials
-        config = new
-        
+        config = new(nil)
+
         if defined?(Rails) && Rails.application.credentials.whatsapp
           credentials = Rails.application.credentials.whatsapp
           config.access_token = credentials[:access_token]
@@ -30,18 +36,50 @@ module FlowChat
           config.business_account_id = credentials[:business_account_id]
         else
           # Fallback to environment variables
-          config.access_token = ENV['WHATSAPP_ACCESS_TOKEN']
-          config.phone_number_id = ENV['WHATSAPP_PHONE_NUMBER_ID']
-          config.verify_token = ENV['WHATSAPP_VERIFY_TOKEN']
-          config.app_id = ENV['WHATSAPP_APP_ID']
-          config.app_secret = ENV['WHATSAPP_APP_SECRET']
-          config.webhook_url = ENV['WHATSAPP_WEBHOOK_URL']
-          config.business_account_id = ENV['WHATSAPP_BUSINESS_ACCOUNT_ID']
+          config.access_token = ENV["WHATSAPP_ACCESS_TOKEN"]
+          config.phone_number_id = ENV["WHATSAPP_PHONE_NUMBER_ID"]
+          config.verify_token = ENV["WHATSAPP_VERIFY_TOKEN"]
+          config.app_id = ENV["WHATSAPP_APP_ID"]
+          config.app_secret = ENV["WHATSAPP_APP_SECRET"]
+          config.webhook_url = ENV["WHATSAPP_WEBHOOK_URL"]
+          config.business_account_id = ENV["WHATSAPP_BUSINESS_ACCOUNT_ID"]
         end
 
         config
       end
 
+      # Register a named configuration
+      def self.register(name, config)
+        @@configurations[name.to_sym] = config
+      end
+
+      # Get a named configuration
+      def self.get(name)
+        @@configurations[name.to_sym] || raise(ArgumentError, "WhatsApp configuration '#{name}' not found")
+      end
+
+      # Check if a named configuration exists
+      def self.exists?(name)
+        @@configurations.key?(name.to_sym)
+      end
+
+      # Get all configuration names
+      def self.configuration_names
+        @@configurations.keys
+      end
+
+      # Clear all registered configurations (useful for testing)
+      def self.clear_all!
+        @@configurations.clear
+      end
+
+      # Register this configuration with a name
+      def register_as(name)
+        @name = name.to_sym
+        self.class.register(@name, self)
+        self
+      end
+
       def valid?
         access_token.present? && phone_number_id.present? && verify_token.present?
       end
@@ -72,4 +110,4 @@ module FlowChat
       end
     end
   end
-end 
+end