kapso-client-ruby 1.0.1 → 1.0.2

data/lib/kapso_client_ruby/rails/generators/install_generator.rb

@@ -1,76 +1,76 @@
-# frozen_string_literal: true
-
-require 'rails/generators'
-
-module KapsoClientRuby
-  module Rails
-    module Generators
-      class InstallGenerator < ::Rails::Generators::Base
-        source_root File.expand_path('templates', __dir__)
-
-        desc 'Install KapsoClientRuby in a Rails application'
-
-        def create_initializer
-          template 'initializer.rb.erb', 'config/initializers/kapso_client_ruby.rb'
-        end
-
-        def create_env_example
-          template 'env.erb', '.env.example'
-        end
-
-        def create_webhook_controller
-          template 'webhook_controller.rb.erb', 'app/controllers/kapso_webhooks_controller.rb'
-        end
-
-        def create_service_example
-          template 'message_service.rb.erb', 'app/services/kapso_message_service.rb'
-        end
-
-        def add_routes
-          route <<~RUBY
-            # Kapso webhook endpoint
-            post '/webhooks/kapso', to: 'kapso_webhooks#create'
-            get '/webhooks/kapso', to: 'kapso_webhooks#verify' # For webhook verification
-          RUBY
-        end
-
-        def show_readme
-          say <<~MESSAGE
-
-            KapsoClientRuby has been successfully installed!
-
-            Next steps:
-            1. Add your Kapso credentials to your environment variables:
-               - KAPSO_API_KEY
-               - KAPSO_PHONE_NUMBER_ID
-               - KAPSO_BUSINESS_ACCOUNT_ID
-
-            2. Review and customize the generated files:
-               - config/initializers/kapso_client_ruby.rb
-               - app/controllers/kapso_webhooks_controller.rb
-               - app/services/kapso_message_service.rb
-
-            3. Set up your webhook URL in the Kapso dashboard:
-               https://yourapp.com/webhooks/kapso
-
-            4. Test the integration:
-               rails runner "KapsoMessageService.new.send_test_message"
-
-            For more information, see: https://github.com/PabloB07/kapso-client-ruby
-
-          MESSAGE
-        end
-
-        private
-
-        def application_name
-          if defined?(Rails) && Rails.application
-            Rails.application.class.name.split('::').first
-          else
-            'YourApp'
-          end
-        end
-      end
-    end
-  end
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module KapsoClientRuby
+  module Rails
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
+        source_root File.expand_path('templates', __dir__)
+
+        desc 'Install KapsoClientRuby in a Rails application'
+
+        def create_initializer
+          template 'initializer.rb.erb', 'config/initializers/kapso_client_ruby.rb'
+        end
+
+        def create_env_example
+          template 'env.erb', '.env.example'
+        end
+
+        def create_webhook_controller
+          template 'webhook_controller.rb.erb', 'app/controllers/kapso_webhooks_controller.rb'
+        end
+
+        def create_service_example
+          template 'message_service.rb.erb', 'app/services/kapso_message_service.rb'
+        end
+
+        def add_routes
+          route <<~RUBY
+            # Kapso webhook endpoint
+            post '/webhooks/kapso', to: 'kapso_webhooks#create'
+            get '/webhooks/kapso', to: 'kapso_webhooks#verify' # For webhook verification
+          RUBY
+        end
+
+        def show_readme
+          say <<~MESSAGE
+
+            KapsoClientRuby has been successfully installed!
+
+            Next steps:
+            1. Add your Kapso credentials to your environment variables:
+               - KAPSO_API_KEY
+               - KAPSO_PHONE_NUMBER_ID
+               - KAPSO_BUSINESS_ACCOUNT_ID
+
+            2. Review and customize the generated files:
+               - config/initializers/kapso_client_ruby.rb
+               - app/controllers/kapso_webhooks_controller.rb
+               - app/services/kapso_message_service.rb
+
+            3. Set up your webhook URL in the Kapso dashboard:
+               https://yourapp.com/webhooks/kapso
+
+            4. Test the integration:
+               rails runner "KapsoMessageService.new.send_test_message"
+
+            For more information, see: https://github.com/PabloB07/kapso-client-ruby
+
+          MESSAGE
+        end
+
+        private
+
+        def application_name
+          if defined?(Rails) && Rails.application
+            Rails.application.class.name.split('::').first
+          else
+            'YourApp'
+          end
+        end
+      end
+    end
+  end
 end

data/lib/kapso_client_ruby/rails/generators/templates/env.erb

@@ -1,21 +1,21 @@
-# Kapso API Configuration
-# Add these to your actual .env file (don't commit API keys to version control)
-
-# Required: Your Kapso API access token
-KAPSO_API_KEY=your_api_key_here
-
-# Required: Your WhatsApp Business phone number ID
-KAPSO_PHONE_NUMBER_ID=your_phone_number_id_here
-
-# Required: Your WhatsApp Business account ID
-KAPSO_BUSINESS_ACCOUNT_ID=your_business_account_id_here
-
-# Optional: API configuration
-KAPSO_API_HOST=https://graph.facebook.com
-KAPSO_API_VERSION=v18.0
-KAPSO_TIMEOUT=30
-
-# Optional: Debug and retry settings
-KAPSO_DEBUG=false
-KAPSO_RETRY_ON_FAILURE=true
+# Kapso API Configuration
+# Add these to your actual .env file (don't commit API keys to version control)
+
+# Required: Your Kapso API access token
+KAPSO_API_KEY=your_api_key_here
+
+# Required: Your WhatsApp Business phone number ID
+KAPSO_PHONE_NUMBER_ID=your_phone_number_id_here
+
+# Required: Your WhatsApp Business account ID
+KAPSO_BUSINESS_ACCOUNT_ID=your_business_account_id_here
+
+# Optional: API configuration
+KAPSO_API_HOST=https://graph.facebook.com
+KAPSO_API_VERSION=v23.0
+KAPSO_TIMEOUT=30
+
+# Optional: Debug and retry settings
+KAPSO_DEBUG=false
+KAPSO_RETRY_ON_FAILURE=true
 KAPSO_MAX_RETRIES=3

data/lib/kapso_client_ruby/rails/generators/templates/initializer.rb.erb

@@ -1,33 +1,33 @@
-# frozen_string_literal: true
-
-# KapsoClientRuby configuration for Rails
-KapsoClientRuby.configure do |config|
-  # API credentials - set these in your environment variables
-  config.api_key = ENV['KAPSO_API_KEY']
-  config.phone_number_id = ENV['KAPSO_PHONE_NUMBER_ID']
-  config.business_account_id = ENV['KAPSO_BUSINESS_ACCOUNT_ID']
-
-  # API configuration
-  config.api_host = ENV.fetch('KAPSO_API_HOST', 'https://graph.facebook.com')
-  config.api_version = ENV.fetch('KAPSO_API_VERSION', 'v18.0')
-  config.timeout = ENV.fetch('KAPSO_TIMEOUT', 30).to_i
-
-  # Development/Debug settings
-  config.debug = Rails.env.development? || ENV.fetch('KAPSO_DEBUG', 'false') == 'true'
-  config.logger = Rails.logger
-
-  # Retry configuration
-  config.retry_on_failure = ENV.fetch('KAPSO_RETRY_ON_FAILURE', 'true') == 'true'
-  config.max_retries = ENV.fetch('KAPSO_MAX_RETRIES', 3).to_i
-end
-
-# Subscribe to Kapso events (optional)
-# ActiveSupport::Notifications.subscribe('kapso.message_received') do |name, start, finish, id, payload|
-#   Rails.logger.info "Received WhatsApp message: #{payload[:message]['id']}"
-#   # Handle incoming message
-# end
-
-# ActiveSupport::Notifications.subscribe('kapso.message_status_updated') do |name, start, finish, id, payload|
-#   Rails.logger.info "Message status updated: #{payload[:status]['id']} -> #{payload[:status]['status']}"
-#   # Handle message status update
+# frozen_string_literal: true
+
+# KapsoClientRuby configuration for Rails
+KapsoClientRuby.configure do |config|
+  # API credentials - set these in your environment variables
+  config.api_key = ENV['KAPSO_API_KEY']
+  config.phone_number_id = ENV['KAPSO_PHONE_NUMBER_ID']
+  config.business_account_id = ENV['KAPSO_BUSINESS_ACCOUNT_ID']
+
+  # API configuration
+  config.api_host = ENV.fetch('KAPSO_API_HOST', 'https://graph.facebook.com')
+  config.api_version = ENV.fetch('KAPSO_API_VERSION', 'v18.0')
+  config.timeout = ENV.fetch('KAPSO_TIMEOUT', 30).to_i
+
+  # Development/Debug settings
+  config.debug = Rails.env.development? || ENV.fetch('KAPSO_DEBUG', 'false') == 'true'
+  config.logger = Rails.logger
+
+  # Retry configuration
+  config.retry_on_failure = ENV.fetch('KAPSO_RETRY_ON_FAILURE', 'true') == 'true'
+  config.max_retries = ENV.fetch('KAPSO_MAX_RETRIES', 3).to_i
+end
+
+# Subscribe to Kapso events (optional)
+# ActiveSupport::Notifications.subscribe('kapso.message_received') do |name, start, finish, id, payload|
+#   Rails.logger.info "Received WhatsApp message: #{payload[:message]['id']}"
+#   # Handle incoming message
+# end
+
+# ActiveSupport::Notifications.subscribe('kapso.message_status_updated') do |name, start, finish, id, payload|
+#   Rails.logger.info "Message status updated: #{payload[:status]['id']} -> #{payload[:status]['status']}"
+#   # Handle message status update
 # end

data/lib/kapso_client_ruby/rails/generators/templates/message_service.rb.erb

@@ -1,138 +1,138 @@
-# frozen_string_literal: true
-
-# Example service class for sending WhatsApp messages in a Rails application
-# This wraps the KapsoClientRuby functionality with Rails-specific features
-class KapsoMessageService
-  include ActiveModel::Model
-  include ActiveModel::Attributes
-
-  # Initialize with optional custom client
-  def initialize(client: nil)
-    @kapso_service = KapsoClientRuby::Rails::Service.new(client)
-  end
-
-  # Send a welcome message to a new user
-  # @param user [User] The user to send the message to
-  # @return [Hash] API response
-  def send_welcome_message(user)
-    return unless user.phone_number.present?
-
-    @kapso_service.send_template_message(
-      to: user.phone_number,
-      template_name: 'welcome_message',
-      language: user.preferred_language || 'en',
-      components: [
-        {
-          type: 'body',
-          parameters: [
-            { type: 'text', text: user.first_name || 'there' }
-          ]
-        }
-      ]
-    )
-  rescue KapsoClientRuby::Error => e
-    Rails.logger.error "Failed to send welcome message to user #{user.id}: #{e.message}"
-    # You might want to queue for retry or notify admins
-    nil
-  end
-
-  # Send order confirmation
-  # @param order [Order] The order to confirm
-  # @return [Hash] API response
-  def send_order_confirmation(order)
-    user = order.user
-    return unless user.phone_number.present?
-
-    @kapso_service.send_template_message(
-      to: user.phone_number,
-      template_name: 'order_confirmation',
-      language: user.preferred_language || 'en',
-      components: [
-        {
-          type: 'body',
-          parameters: [
-            { type: 'text', text: order.id.to_s },
-            { type: 'currency', currency: order.currency, amount_1000: order.total_cents }
-          ]
-        }
-      ]
-    )
-  rescue KapsoClientRuby::Error => e
-    Rails.logger.error "Failed to send order confirmation for order #{order.id}: #{e.message}"
-    nil
-  end
-
-  # Send a custom text message
-  # @param phone_number [String] Recipient's phone number
-  # @param message [String] The message text
-  # @return [Hash] API response
-  def send_text(phone_number:, message:)
-    @kapso_service.send_text_message(to: phone_number, text: message)
-  rescue KapsoClientRuby::Error => e
-    Rails.logger.error "Failed to send text message to #{phone_number}: #{e.message}"
-    nil
-  end
-
-  # Send a document
-  # @param phone_number [String] Recipient's phone number
-  # @param document_url [String] URL of the document
-  # @param filename [String] Optional filename
-  # @param caption [String] Optional caption
-  # @return [Hash] API response
-  def send_document(phone_number:, document_url:, filename: nil, caption: nil)
-    @kapso_service.send_media_message(
-      to: phone_number,
-      media_type: 'document',
-      media_url: document_url,
-      filename: filename,
-      caption: caption
-    )
-  rescue KapsoClientRuby::Error => e
-    Rails.logger.error "Failed to send document to #{phone_number}: #{e.message}"
-    nil
-  end
-
-  # Send test message (for development/testing)
-  def send_test_message
-    test_number = ENV['KAPSO_TEST_PHONE_NUMBER']
-    
-    unless test_number
-      puts "Set KAPSO_TEST_PHONE_NUMBER environment variable to test messaging"
-      return
-    end
-
-    result = send_text(
-      phone_number: test_number,
-      message: "Hello from <%= application_name %>! This is a test message sent at #{Time.current}."
-    )
-
-    if result
-      puts "✅ Test message sent successfully! Message ID: #{result.dig('messages', 0, 'id')}"
-    else
-      puts "❌ Failed to send test message"
-    end
-  end
-
-  # Get message delivery status
-  # @param message_id [String] The message ID
-  # @return [Hash] Status information
-  def get_message_status(message_id)
-    @kapso_service.get_message_status(message_id)
-  rescue KapsoClientRuby::Error => e
-    Rails.logger.error "Failed to get message status for #{message_id}: #{e.message}"
-    nil
-  end
-
-  # List available templates
-  # @return [Array] List of templates
-  def list_templates
-    @kapso_service.get_templates
-  rescue KapsoClientRuby::Error => e
-    Rails.logger.error "Failed to fetch templates: #{e.message}"
-    nil
-  end
-
-  private
-
-  attr_reader :kapso_service
+# frozen_string_literal: true
+
+# Example service class for sending WhatsApp messages in a Rails application
+# This wraps the KapsoClientRuby functionality with Rails-specific features
+class KapsoMessageService
+  include ActiveModel::Model
+  include ActiveModel::Attributes
+
+  # Initialize with optional custom client
+  def initialize(client: nil)
+    @kapso_service = KapsoClientRuby::Rails::Service.new(client)
+  end
+
+  # Send a welcome message to a new user
+  # @param user [User] The user to send the message to
+  # @return [Hash] API response
+  def send_welcome_message(user)
+    return unless user.phone_number.present?
+
+    @kapso_service.send_template_message(
+      to: user.phone_number,
+      template_name: 'welcome_message',
+      language: user.preferred_language || 'en',
+      components: [
+        {
+          type: 'body',
+          parameters: [
+            { type: 'text', text: user.first_name || 'there' }
+          ]
+        }
+      ]
+    )
+  rescue KapsoClientRuby::Error => e
+    Rails.logger.error "Failed to send welcome message to user #{user.id}: #{e.message}"
+    # You might want to queue for retry or notify admins
+    nil
+  end
+
+  # Send order confirmation
+  # @param order [Order] The order to confirm
+  # @return [Hash] API response
+  def send_order_confirmation(order)
+    user = order.user
+    return unless user.phone_number.present?
+
+    @kapso_service.send_template_message(
+      to: user.phone_number,
+      template_name: 'order_confirmation',
+      language: user.preferred_language || 'en',
+      components: [
+        {
+          type: 'body',
+          parameters: [
+            { type: 'text', text: order.id.to_s },
+            { type: 'currency', currency: order.currency, amount_1000: order.total_cents }
+          ]
+        }
+      ]
+    )
+  rescue KapsoClientRuby::Error => e
+    Rails.logger.error "Failed to send order confirmation for order #{order.id}: #{e.message}"
+    nil
+  end
+
+  # Send a custom text message
+  # @param phone_number [String] Recipient's phone number
+  # @param message [String] The message text
+  # @return [Hash] API response
+  def send_text(phone_number:, message:)
+    @kapso_service.send_text_message(to: phone_number, text: message)
+  rescue KapsoClientRuby::Error => e
+    Rails.logger.error "Failed to send text message to #{phone_number}: #{e.message}"
+    nil
+  end
+
+  # Send a document
+  # @param phone_number [String] Recipient's phone number
+  # @param document_url [String] URL of the document
+  # @param filename [String] Optional filename
+  # @param caption [String] Optional caption
+  # @return [Hash] API response
+  def send_document(phone_number:, document_url:, filename: nil, caption: nil)
+    @kapso_service.send_media_message(
+      to: phone_number,
+      media_type: 'document',
+      media_url: document_url,
+      filename: filename,
+      caption: caption
+    )
+  rescue KapsoClientRuby::Error => e
+    Rails.logger.error "Failed to send document to #{phone_number}: #{e.message}"
+    nil
+  end
+
+  # Send test message (for development/testing)
+  def send_test_message
+    test_number = ENV['KAPSO_TEST_PHONE_NUMBER']
+    
+    unless test_number
+      puts "Set KAPSO_TEST_PHONE_NUMBER environment variable to test messaging"
+      return
+    end
+
+    result = send_text(
+      phone_number: test_number,
+      message: "Hello from <%= application_name %>! This is a test message sent at #{Time.current}."
+    )
+
+    if result
+      puts "✅ Test message sent successfully! Message ID: #{result.dig('messages', 0, 'id')}"
+    else
+      puts "❌ Failed to send test message"
+    end
+  end
+
+  # Get message delivery status
+  # @param message_id [String] The message ID
+  # @return [Hash] Status information
+  def get_message_status(message_id)
+    @kapso_service.get_message_status(message_id)
+  rescue KapsoClientRuby::Error => e
+    Rails.logger.error "Failed to get message status for #{message_id}: #{e.message}"
+    nil
+  end
+
+  # List available templates
+  # @return [Array] List of templates
+  def list_templates
+    @kapso_service.get_templates
+  rescue KapsoClientRuby::Error => e
+    Rails.logger.error "Failed to fetch templates: #{e.message}"
+    nil
+  end
+
+  private
+
+  attr_reader :kapso_service
 end

data/lib/kapso_client_ruby/rails/generators/templates/webhook_controller.rb.erb

@@ -1,62 +1,62 @@
-# frozen_string_literal: true
-
-class KapsoWebhooksController < ApplicationController
-  # Skip CSRF token verification for webhook endpoints
-  skip_before_action :verify_authenticity_token
-
-  # Webhook verification endpoint (GET)
-  # WhatsApp sends a GET request to verify your webhook URL
-  def verify
-    challenge = params['hub.challenge']
-    verify_token = params['hub.verify_token']
-    
-    # Set your verification token in environment variables
-    expected_token = ENV['KAPSO_WEBHOOK_VERIFY_TOKEN']
-    
-    if verify_token == expected_token
-      render plain: challenge, status: :ok
-    else
-      render plain: 'Forbidden', status: :forbidden
-    end
-  end
-
-  # Webhook payload endpoint (POST)
-  # WhatsApp sends webhook events here
-  def create
-    begin
-      # Verify webhook signature (optional but recommended)
-      verify_webhook_signature if ENV['KAPSO_WEBHOOK_SECRET'].present?
-      
-      # Process the webhook using the Kapso Rails service
-      service = KapsoClientRuby::Rails::Service.new
-      result = service.process_webhook(webhook_params.to_h)
-      
-      render json: { status: 'ok' }, status: :ok
-    rescue => e
-      Rails.logger.error "Webhook processing error: #{e.message}"
-      render json: { error: 'Internal server error' }, status: :internal_server_error
-    end
-  end
-
-  private
-
-  def webhook_params
-    params.permit!
-  end
-
-  def verify_webhook_signature
-    signature = request.headers['X-Hub-Signature-256']
-    return unless signature
-
-    expected_signature = calculate_signature(request.raw_post)
-    
-    unless Rack::Utils.secure_compare(signature, expected_signature)
-      raise 'Invalid webhook signature'
-    end
-  end
-
-  def calculate_signature(payload)
-    secret = ENV['KAPSO_WEBHOOK_SECRET']
-    'sha256=' + OpenSSL::HMAC.hexdigest('sha256', secret, payload)
-  end
+# frozen_string_literal: true
+
+class KapsoWebhooksController < ApplicationController
+  # Skip CSRF token verification for webhook endpoints
+  skip_before_action :verify_authenticity_token
+
+  # Webhook verification endpoint (GET)
+  # WhatsApp sends a GET request to verify your webhook URL
+  def verify
+    challenge = params['hub.challenge']
+    verify_token = params['hub.verify_token']
+    
+    # Set your verification token in environment variables
+    expected_token = ENV['KAPSO_WEBHOOK_VERIFY_TOKEN']
+    
+    if verify_token == expected_token
+      render plain: challenge, status: :ok
+    else
+      render plain: 'Forbidden', status: :forbidden
+    end
+  end
+
+  # Webhook payload endpoint (POST)
+  # WhatsApp sends webhook events here
+  def create
+    begin
+      # Verify webhook signature (optional but recommended)
+      verify_webhook_signature if ENV['KAPSO_WEBHOOK_SECRET'].present?
+      
+      # Process the webhook using the Kapso Rails service
+      service = KapsoClientRuby::Rails::Service.new
+      result = service.process_webhook(webhook_params.to_h)
+      
+      render json: { status: 'ok' }, status: :ok
+    rescue => e
+      Rails.logger.error "Webhook processing error: #{e.message}"
+      render json: { error: 'Internal server error' }, status: :internal_server_error
+    end
+  end
+
+  private
+
+  def webhook_params
+    params.permit!
+  end
+
+  def verify_webhook_signature
+    signature = request.headers['X-Hub-Signature-256']
+    return unless signature
+
+    expected_signature = calculate_signature(request.raw_post)
+    
+    unless Rack::Utils.secure_compare(signature, expected_signature)
+      raise 'Invalid webhook signature'
+    end
+  end
+
+  def calculate_signature(payload)
+    secret = ENV['KAPSO_WEBHOOK_SECRET']
+    'sha256=' + OpenSSL::HMAC.hexdigest('sha256', secret, payload)
+  end
 end