flow_chat 0.6.0 → 0.7.0

data/config/routes_demo.rb

@@ -1,59 +0,0 @@
-# Demo Routes Configuration for FlowChat Comprehensive Demo
-# 
-# Add these routes to your config/routes.rb file to enable the demo endpoints
-# 
-# Example integration:
-# Rails.application.routes.draw do
-#   # Your existing routes...
-#   
-#   # FlowChat Demo Routes
-#   scope :demo do
-#     post 'ussd' => 'demo#ussd_demo'
-#     match 'whatsapp' => 'demo#whatsapp_demo', via: [:get, :post]
-#     match 'whatsapp_custom' => 'demo#whatsapp_custom_demo', via: [:get, :post]
-#     match 'whatsapp_background' => 'demo#whatsapp_background_demo', via: [:get, :post]
-#     match 'whatsapp_simulator' => 'demo#whatsapp_simulator_demo', via: [:get, :post]
-#   end
-# end
-
-Rails.application.routes.draw do
-  # FlowChat Comprehensive Demo Routes
-  scope :demo do
-    # USSD Demo
-    # Endpoint: POST /demo/ussd
-    # Purpose: Demonstrates USSD integration with all features
-    # Features: Pagination, session management, complex workflows
-    post 'ussd' => 'demo#ussd_demo'
-
-    # WhatsApp Demo (Standard)
-    # Endpoint: GET/POST /demo/whatsapp  
-    # Purpose: Standard WhatsApp integration with media support
-    # Features: Rich media, interactive elements, buttons/lists
-    match 'whatsapp' => 'demo#whatsapp_demo', via: [:get, :post]
-
-    # WhatsApp Demo (Custom Configuration)
-    # Endpoint: GET/POST /demo/whatsapp_custom
-    # Purpose: Shows multi-tenant configuration capabilities
-    # Features: Custom credentials, per-endpoint configuration
-    match 'whatsapp_custom' => 'demo#whatsapp_custom_demo', via: [:get, :post]
-
-    # WhatsApp Demo (Background Processing)
-    # Endpoint: GET/POST /demo/whatsapp_background
-    # Purpose: Demonstrates background job integration
-    # Features: Asynchronous response delivery, job queuing
-    match 'whatsapp_background' => 'demo#whatsapp_background_demo', via: [:get, :post]
-
-    # WhatsApp Demo (Simulator Mode)
-    # Endpoint: GET/POST /demo/whatsapp_simulator
-    # Purpose: Testing mode that returns response data as JSON
-    # Features: No actual WhatsApp API calls, perfect for testing
-    match 'whatsapp_simulator' => 'demo#whatsapp_simulator_demo', via: [:get, :post]
-  end
-
-  # Optional: Simulator interface for testing
-  # Uncomment if you want to add the simulator UI
-  # get '/simulator' => 'simulator#index'
-  
-  # Optional: API documentation endpoint
-  # get '/demo' => 'demo#index'
-end 

data/examples/initializer.rb

@@ -1,86 +0,0 @@
-# Example FlowChat Initializer
-# Add this to your Rails application as config/initializers/flow_chat.rb
-
-# Configure cache for session storage
-# This is required when using FlowChat::Session::CacheSessionStore
-FlowChat::Config.cache = Rails.cache
-
-# Alternative cache configurations:
-
-# Use a specific cache store
-# FlowChat::Config.cache = ActiveSupport::Cache::MemoryStore.new
-
-# Use Redis (requires redis gem)
-# FlowChat::Config.cache = ActiveSupport::Cache::RedisCacheStore.new(url: "redis://localhost:6379/1")
-
-# Use Memcached (requires dalli gem)
-# FlowChat::Config.cache = ActiveSupport::Cache::MemCacheStore.new("localhost:11211")
-
-# Configure logger (optional)
-FlowChat::Config.logger = Rails.logger
-
-# Configure simulator security (REQUIRED for simulator mode)
-# This secret is used to authenticate simulator requests via signed cookies
-case Rails.env
-when 'development', 'test'
-  # Use Rails secret key with environment suffix for development
-  FlowChat::Config.simulator_secret = Rails.application.secret_key_base + "_#{Rails.env}"
-when 'staging', 'production'
-  # Use environment variable for production security
-  FlowChat::Config.simulator_secret = ENV['FLOWCHAT_SIMULATOR_SECRET']
-  
-  # Fail fast if simulator secret is not configured but might be needed
-  if FlowChat::Config.simulator_secret.blank?
-    Rails.logger.warn "FLOWCHAT_SIMULATOR_SECRET not configured. Simulator mode will be unavailable."
-  end
-end
-
-# Configure USSD pagination (optional)
-FlowChat::Config.ussd.pagination_page_size = 140
-FlowChat::Config.ussd.pagination_back_option = "0"
-FlowChat::Config.ussd.pagination_back_text = "Back"
-FlowChat::Config.ussd.pagination_next_option = "#"
-FlowChat::Config.ussd.pagination_next_text = "More"
-
-# Configure resumable sessions (optional)
-FlowChat::Config.ussd.resumable_sessions_enabled = true
-FlowChat::Config.ussd.resumable_sessions_timeout_seconds = 300 # 5 minutes
-
-# Configure WhatsApp message handling mode based on environment
-case Rails.env
-when 'development'
-  # Development: Use simulator mode for easy testing
-  FlowChat::Config.whatsapp.message_handling_mode = :simulator
-  
-when 'test'
-  # Test: Use simulator mode for deterministic testing
-  FlowChat::Config.whatsapp.message_handling_mode = :simulator
-  
-when 'staging'
-  # Staging: Use inline mode for real WhatsApp testing
-  FlowChat::Config.whatsapp.message_handling_mode = :inline
-  
-when 'production'
-  # Production: Use background mode for high volume
-  FlowChat::Config.whatsapp.message_handling_mode = :background
-  FlowChat::Config.whatsapp.background_job_class = 'WhatsappMessageJob'
-end
-
-# Configure per-environment WhatsApp security
-# Note: These are global defaults. You can override per-configuration in your controllers.
-
-# Example of per-environment WhatsApp security configuration:
-# 
-# For development/test: You might want to disable signature validation for easier testing
-# For staging: Enable validation to match production behavior  
-# For production: Always enable validation for security
-#
-# Individual WhatsApp configurations can override these settings:
-#
-# config = FlowChat::Whatsapp::Configuration.new
-# config.access_token = "your_token"
-# config.app_secret = "your_app_secret"              # Required for webhook validation
-# config.skip_signature_validation = false           # false = validate signatures (recommended)
-#
-# Development override example:
-# config.skip_signature_validation = Rails.env.development? # Only skip in development

data/examples/media_prompts_examples.rb

@@ -1,27 +0,0 @@
-# Media Prompts Examples
-# This file demonstrates how to attach media to prompts in FlowChat
-
-# ============================================================================
-# BASIC MEDIA PROMPTS
-# ============================================================================
-
-class MediaPromptFlow < FlowChat::Flow
-  def main_page
-    # ✅ Simple text input with attached image
-    # The prompt text becomes the image caption
-    app.screen(:feedback) do |prompt|
-      prompt.ask "What do you think of our new product?",
-        media: {
-          type: :image,
-          url: "https://cdn.example.com/products/new_product.jpg"
-        }
-    end
-
-    # ✅ Send media message with say
-    app.say "Thank you for your feedback! Here's what's coming next:",
-      media: {
-        type: :video,
-        url: "https://videos.example.com/roadmap.mp4"
-      }
-  end
-end