posthog-rails 3.5.3 → 3.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b7a93ce29b1528ad68c2b03e82400e3b986c6bf78fab3f3dfed6e54079d271a
-  data.tar.gz: 1c818a7ce001ab48a469a294a0f0dad6643e4e1a14975423b3a57cfe0fa9b240
+  metadata.gz: 73b3698f8394559833943f6d02e405620ee11772e92f05bfb88d1e20293d49a4
+  data.tar.gz: 3315690f7eb8c851b2c8f23179a9ed8ceb6d730177b800ddec883f5e21e7db5b
 SHA512:
-  metadata.gz: 30bbf87a63ef62bce4c0146ba49209d53bdbf3774cb45da43fcbc0ca3c20ed416f182fc811c4446300a370a39a37afb68066384c162a66c99149b4cb3112c9a7
-  data.tar.gz: 3ec3f4b8daa595bc1c22a8d043d6815d6ec9a7d0c6daa64f789aea16cc1403397a5ffd4eddd36dbdef10fa84f9e827e27997652e2eae08f2d941e1460823e399
+  metadata.gz: 0eb6a62fba135f4ff4c6b1830080d4a7272daf05d4a8b295e9e69212617cd8aa6b33ba9e0a485a4523d7e1d7c056a7f110c50abef0d59bff22cf93c4421adfed
+  data.tar.gz: 6c1ac4517141425d1b2528083cf3d8d9e97fa57ba8b73ff53913bd0c34b61735241e3e32043af932dea430441b3f8be0e2e64d99b70d9b5efeb8ce3920aacd3b

data/lib/generators/posthog/install_generator.rb

@@ -7,10 +7,10 @@ module Posthog
     class InstallGenerator < ::Rails::Generators::Base
       desc 'Creates a PostHog initializer file at config/initializers/posthog.rb'
 
-      source_root File.expand_path('../../..', __dir__)
+      source_root File.expand_path('templates', __dir__)
 
       def copy_initializer
-        copy_file 'examples/posthog.rb', 'config/initializers/posthog.rb'
+        copy_file 'posthog.rb', 'config/initializers/posthog.rb'
       end
 
       def show_readme

data/lib/generators/posthog/templates/posthog.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+# PostHog Rails Initializer
+# Place this file in config/initializers/posthog.rb
+
+# ============================================================================
+# RAILS-SPECIFIC CONFIGURATION
+# ============================================================================
+# Configure Rails-specific options via PostHog::Rails.configure
+# These settings control how PostHog integrates with Rails features.
+
+PostHog::Rails.configure do |config|
+  # Automatically capture exceptions (default: false)
+  # Set to true to enable automatic exception tracking
+  # config.auto_capture_exceptions = true
+
+  # Report exceptions that Rails rescues (e.g., with rescue_from) (default: false)
+  # Set to true to capture rescued exceptions
+  # config.report_rescued_exceptions = true
+
+  # Automatically instrument ActiveJob background jobs (default: false)
+  # Set to true to enable automatic ActiveJob exception tracking
+  # config.auto_instrument_active_job = true
+
+  # Capture user context with exceptions (default: true)
+  # config.capture_user_context = true
+
+  # Controller method name to get current user (default: :current_user)
+  # Change this if your app uses a different method name (e.g., :authenticated_user)
+  # When configured, exceptions will include user context (distinct_id, email, name),
+  # making it easier to identify affected users and debug user-specific issues.
+  # config.current_user_method = :current_user
+
+  # Additional exception classes to exclude from reporting
+  # These are added to the default excluded exceptions
+  # config.excluded_exceptions = [
+  #   # 'MyCustom404Error',
+  #   # 'MyCustomValidationError'
+  # ]
+end
+
+# You can also configure Rails options directly:
+# PostHog::Rails.config.auto_capture_exceptions = true
+
+# ============================================================================
+# CORE POSTHOG CONFIGURATION
+# ============================================================================
+# Initialize the PostHog client with core SDK options.
+
+PostHog.init do |config|
+  # ============================================================================
+  # REQUIRED CONFIGURATION
+  # ============================================================================
+
+  # Your PostHog project API key (required)
+  # Get this from: PostHog Project Settings > API Keys
+  # https://app.posthog.com/settings/project-details#variables
+  config.api_key = ENV.fetch('POSTHOG_API_KEY', nil)
+
+  # ============================================================================
+  # OPTIONAL CONFIGURATION
+  # ============================================================================
+
+  # For PostHog Cloud, use: https://us.i.posthog.com or https://eu.i.posthog.com
+  config.host = ENV.fetch('POSTHOG_HOST', 'https://us.i.posthog.com')
+
+  # Personal API key (optional, but required for local feature flag evaluation)
+  # Get this from: PostHog Settings > Personal API Keys
+  # https://app.posthog.com/settings/user-api-keys
+  config.personal_api_key = ENV.fetch('POSTHOG_PERSONAL_API_KEY', nil)
+
+  # Maximum number of events to queue before dropping (default: 10000)
+  config.max_queue_size = 10_000
+
+  # Feature flags polling interval in seconds (default: 30)
+  config.feature_flags_polling_interval = 30
+
+  # Feature flag request timeout in seconds (default: 3)
+  config.feature_flag_request_timeout_seconds = 3
+
+  # Error callback - called when PostHog encounters an error
+  # config.on_error = proc { |status, message|
+  #   Rails.logger.error("[PostHog] Error #{status}: #{message}")
+  # }
+
+  # Before send callback - modify or filter events before sending
+  # Return nil to prevent the event from being sent
+  # config.before_send = proc { |event|
+  #   # Filter out test users
+  #   return nil if event[:properties]&.dig('$user_email')&.end_with?('@test.com')
+  #
+  #   # Add custom properties to all events
+  #   event[:properties] ||= {}
+  #   event[:properties]['environment'] = Rails.env
+  #
+  #   event
+  # }
+
+  # ============================================================================
+  # ENVIRONMENT-SPECIFIC CONFIGURATION
+  # ============================================================================
+
+  # Disable in test environment
+  config.test_mode = true if Rails.env.test?
+
+  # Optional: Disable in development
+  # config.test_mode = true if Rails.env.test? || Rails.env.development?
+end
+
+# ============================================================================
+# DEFAULT EXCLUDED EXCEPTIONS
+# ============================================================================
+# The following exceptions are excluded by default:
+#
+# - AbstractController::ActionNotFound
+# - ActionController::BadRequest
+# - ActionController::InvalidAuthenticityToken
+# - ActionController::InvalidCrossOriginRequest
+# - ActionController::MethodNotAllowed
+# - ActionController::NotImplemented
+# - ActionController::ParameterMissing
+# - ActionController::RoutingError
+# - ActionController::UnknownFormat
+# - ActionController::UnknownHttpMethod
+# - ActionDispatch::Http::Parameters::ParseError
+# - ActiveRecord::RecordNotFound
+# - ActiveRecord::RecordNotUnique
+#
+# These can be re-enabled by removing them from the exclusion list if needed.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: posthog-rails
 version: !ruby/object:Gem::Version
-  version: 3.5.3
+  version: 3.5.4
 platform: ruby
 authors:
 - PostHog
@@ -45,6 +45,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/generators/posthog/install_generator.rb
+- lib/generators/posthog/templates/posthog.rb
 - lib/posthog-rails.rb
 - lib/posthog/rails.rb
 - lib/posthog/rails/active_job.rb