posthog-rails 3.12.2 → 3.12.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62ff8f270eaa05f59e416c798a1788f8ce3baa16c1dcba8b09f58039a4ac52c6
-  data.tar.gz: 4bc7f6753ef7bd80fca9418c679085ae894441b5efcb06bd4d31348a30ec2ef7
+  metadata.gz: 499457f4cdb3d65001ca2052dcce6231b7f56879333a5dd5c957376460a70992
+  data.tar.gz: e06c59907254de2d57373a167b20c21d5e54df9aca89b59bda2f138cd81e731b
 SHA512:
-  metadata.gz: 849ca061d5d4ce429e2361f22b89c95b1ee9e8f4ce2fb1462e841a5deaef896f38b4095335fa6aafa4a70d92a5b53218d08fb0772c4089d4117cb1639a4f0dcb
-  data.tar.gz: 2f117183afbf4ec5cce029afe3e4170739b1f52707c4465a2a3312891bf10cc2a0d0202c37622ea32e6ccae6d4e2e211057b8fdbe1851cdf66d33414de086a8e
+  metadata.gz: 6c51cd064c094fc7df538a348a3faf842a873597e527eadb65e341850649beb09e18159d191b32bce744077ed54afa6c791479c74045ed018007cb647b666a05
+  data.tar.gz: c61468861d957d4a5cc41276fdae05ce4f00d621af51320dbb05c8f9571df28aa1d89524600f25ce71e2bfe1b9864678b5340583888e7682a9da7b1cc514a847

data/lib/posthog/rails/facade.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module PostHog
+  module Rails
+    # Install the Rails singleton-style PostHog facade at load time so Rails app
+    # initializers can call PostHog.init before Railtie initializers run.
+    #
+    # @api private
+    # @return [void]
+    def self.install_posthog_facade!
+      return if @posthog_facade_installed
+
+      PostHog.class_eval do
+        class << self
+          attr_accessor :client
+
+          # Initialize the singleton PostHog client used by Rails delegators.
+          #
+          # @param options [Hash] Core {PostHog::Client} options.
+          # @yieldparam config [PostHog::Rails::InitConfig] Block-based core SDK configuration.
+          # @return [PostHog::Client]
+          def init(options = {})
+            # If block given, yield to configuration
+            if block_given?
+              config = PostHog::Rails::InitConfig.new(options)
+              yield config
+              options = config.to_client_options
+            end
+
+            # Let the PostHog Logs pipeline reuse the same api_key/host without
+            # the core client exposing public readers.
+            PostHog::Rails::Logs::Setup.remember_client_options(options) if defined?(PostHog::Rails::Logs::Setup)
+
+            # Create the PostHog client. If a client already exists, shut it down
+            # after replacement so repeated init calls do not leave background
+            # resources from the previous instance running.
+            previous_client = @client
+            @client = PostHog::Client.new(options)
+            begin
+              previous_client&.shutdown
+            rescue StandardError => e
+              PostHog::Logging.logger.warn("Failed to shut down previous PostHog client: #{e.message}")
+            end
+            @client
+          end
+
+          # @return [Boolean] Whether {PostHog.init} has created a client.
+          def initialized?
+            !@client.nil?
+          end
+
+          # Fallback for any client methods not explicitly defined.
+          #
+          # @api private
+          def method_missing(method_name, ...)
+            ensure_initialized!
+
+            if client.respond_to?(method_name)
+              client.public_send(method_name, ...)
+            else
+              super
+            end
+          end
+
+          # @api private
+          def respond_to_missing?(method_name, include_private = false)
+            ensure_initialized!
+            client.respond_to?(method_name, include_private) || super
+          end
+
+          private
+
+          def ensure_initialized!
+            return if initialized?
+
+            @client = PostHog::Client.new(api_key: nil, silence_disabled_client_error: true)
+          end
+        end
+      end
+
+      %i[
+        capture
+        capture_exception
+        identify
+        alias
+        group_identify
+        is_feature_enabled
+        get_feature_flag
+        get_all_flags
+      ].each do |method_name|
+        PostHog.define_singleton_method(method_name) do |*args, **kwargs, &block|
+          ensure_initialized!
+          client.public_send(method_name, *args, **kwargs, &block)
+        end
+      end
+
+      @posthog_facade_installed = true
+    end
+  end
+end

data/lib/posthog/rails/railtie.rb

@@ -1,97 +1,14 @@
 # frozen_string_literal: true
 
+require 'posthog/rails/facade'
+
 module PostHog
   module Rails
     class Railtie < ::Rails::Railtie
-      # Add PostHog module methods for accessing Rails-specific client
+      # Keep the historical Railtie initializer name, but install the facade at
+      # load time so application initializers can call PostHog.init.
       initializer 'posthog.set_configs' do |_app|
-        PostHog.class_eval do
-          class << self
-            attr_accessor :client
-
-            # Methods explicitly delegated to the client
-            DELEGATED_METHODS = %i[
-              capture
-              capture_exception
-              identify
-              alias
-              group_identify
-              is_feature_enabled
-              get_feature_flag
-              get_all_flags
-            ].freeze
-
-            # Initialize the singleton PostHog client used by Rails delegators.
-            #
-            # @param options [Hash] Core {PostHog::Client} options.
-            # @yieldparam config [PostHog::Rails::InitConfig] Block-based core SDK configuration.
-            # @return [PostHog::Client]
-            def init(options = {})
-              # If block given, yield to configuration
-              if block_given?
-                config = PostHog::Rails::InitConfig.new(options)
-                yield config
-                options = config.to_client_options
-              end
-
-              # Let the PostHog Logs pipeline reuse the same api_key/host without
-              # the core client exposing public readers.
-              PostHog::Rails::Logs::Setup.remember_client_options(options) if defined?(PostHog::Rails::Logs::Setup)
-
-              # Create the PostHog client. If a client already exists, shut it down
-              # after replacement so repeated init calls do not leave background
-              # resources from the previous instance running.
-              previous_client = @client
-              @client = PostHog::Client.new(options)
-              begin
-                previous_client&.shutdown
-              rescue StandardError => e
-                PostHog::Logging.logger.warn("Failed to shut down previous PostHog client: #{e.message}")
-              end
-              @client
-            end
-
-            # Define delegated methods using metaprogramming
-            DELEGATED_METHODS.each do |method_name|
-              define_method(method_name) do |*args, **kwargs, &block|
-                ensure_initialized!
-                client.public_send(method_name, *args, **kwargs, &block)
-              end
-            end
-
-            # @return [Boolean] Whether {PostHog.init} has created a client.
-            def initialized?
-              !@client.nil?
-            end
-
-            # Fallback for any client methods not explicitly defined.
-            #
-            # @api private
-            def method_missing(method_name, ...)
-              ensure_initialized!
-
-              if client.respond_to?(method_name)
-                client.public_send(method_name, ...)
-              else
-                super
-              end
-            end
-
-            # @api private
-            def respond_to_missing?(method_name, include_private = false)
-              ensure_initialized!
-              client.respond_to?(method_name, include_private) || super
-            end
-
-            private
-
-            def ensure_initialized!
-              return if initialized?
-
-              @client = PostHog::Client.new(api_key: nil, silence_disabled_client_error: true)
-            end
-          end
-        end
+        PostHog::Rails.install_posthog_facade!
       end
 
       # Insert middleware for request context and exception capturing

data/lib/posthog/rails.rb

@@ -12,6 +12,7 @@ require 'posthog/rails/logs/severity'
 require 'posthog/rails/logs/rate_limiter'
 require 'posthog/rails/logs/appender'
 require 'posthog/rails/logs/setup'
+require 'posthog/rails/facade'
 require 'posthog/rails/railtie'
 
 module PostHog
@@ -63,3 +64,5 @@ module PostHog
     end
   end
 end
+
+PostHog::Rails.install_posthog_facade!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: posthog-rails
 version: !ruby/object:Gem::Version
-  version: 3.12.2
+  version: 3.12.3
 platform: ruby
 authors:
 - PostHog
@@ -52,6 +52,7 @@ files:
 - lib/posthog/rails/capture_exceptions.rb
 - lib/posthog/rails/configuration.rb
 - lib/posthog/rails/error_subscriber.rb
+- lib/posthog/rails/facade.rb
 - lib/posthog/rails/logs/appender.rb
 - lib/posthog/rails/logs/rate_limiter.rb
 - lib/posthog/rails/logs/setup.rb