posthog-ruby 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4e71138d169f5c226e194b90e5a0d9e0243389eb98bd32e9da67b2b5bf45c57
-  data.tar.gz: c814fc65c03770c4ac056b4ab74d0b39efb268e1b7b778a29d06120158b20533
+  metadata.gz: 2c7c88ed8541cb75a430abfde7ec41a1df10253839b5bfaf4f92eb838b677860
+  data.tar.gz: 6d4549bb4e56e3d95a28ed0f70b75c275d45a30a40b8aa09756a5bcef0edfd5b
 SHA512:
-  metadata.gz: 9b8950767de513e3aeae1487b7eacf1e272af98689d6906d1e04837c4bd8a7b7e7aba4c9cdb2d5eae8503b7e83d7d7e0c59e0d9952076da769500abb8839d51f
-  data.tar.gz: 7ce785b37aeda279b27b8fde71592561c8854133a91a70f316b415487e601bd5646cb857b909c473eb30fd8767a50678b9c2ba5b43041827b1232775ccd2efe6
+  metadata.gz: eae21f85d2fd42612fc5aa7488db52cb7280f68a9bdb58bac1ead90f3c871ecb30d0195e2f211413fb2b6858846c0c5521da2e1c14d9833baf8128b5784370fb
+  data.tar.gz: 1329afd21f70e229b2126dddbae1d19a69fef99494c073a0d01cffb6160ae6a79f0471e56f3886bfe5a80432415c0e3901f98c5d327f68f65a0f9ea6c18197f0

data/lib/posthog/client.rb

@@ -8,6 +8,7 @@ require 'posthog/utils'
 require 'posthog/send_worker'
 require 'posthog/noop_worker'
 require 'posthog/feature_flags'
+require 'posthog/send_feature_flags_options'
 
 module PostHog
   class Client
@@ -96,7 +97,8 @@ module PostHog
     #
     # @option attrs [String] :event Event name
     # @option attrs [Hash] :properties Event properties (optional)
-    # @option attrs [Bool] :send_feature_flags Whether to send feature flags with this event (optional)
+    # @option attrs [Bool, Hash, SendFeatureFlagsOptions] :send_feature_flags
+    #   Whether to send feature flags with this event, or configuration for feature flag evaluation (optional)
     # @option attrs [String] :uuid ID that uniquely identifies an event;
     #                             events in PostHog are deduplicated by the
     #                             combination of teamId, timestamp date,
@@ -105,10 +107,38 @@ module PostHog
     def capture(attrs)
       symbolize_keys! attrs
 
-      if attrs[:send_feature_flags]
-        feature_variants = @feature_flags_poller.get_feature_variants(attrs[:distinct_id], attrs[:groups] || {})
+      send_feature_flags_param = attrs[:send_feature_flags]
+      if send_feature_flags_param
+        # Handle different types of send_feature_flags parameter
+        case send_feature_flags_param
+        when true
+          # Backward compatibility: simple boolean
+          feature_variants = @feature_flags_poller.get_feature_variants(attrs[:distinct_id], attrs[:groups] || {})
+        when Hash
+          # Hash with options
+          options = SendFeatureFlagsOptions.from_hash(send_feature_flags_param)
+          feature_variants = @feature_flags_poller.get_feature_variants(
+            attrs[:distinct_id],
+            attrs[:groups] || {},
+            options ? options.person_properties : {},
+            options ? options.group_properties : {},
+            options ? options.only_evaluate_locally : false
+          )
+        when SendFeatureFlagsOptions
+          # SendFeatureFlagsOptions object
+          feature_variants = @feature_flags_poller.get_feature_variants(
+            attrs[:distinct_id],
+            attrs[:groups] || {},
+            send_feature_flags_param.person_properties,
+            send_feature_flags_param.group_properties,
+            send_feature_flags_param.only_evaluate_locally || false
+          )
+        else
+          # Invalid type, treat as false
+          feature_variants = nil
+        end
 
-        attrs[:feature_variants] = feature_variants
+        attrs[:feature_variants] = feature_variants if feature_variants
       end
 
       enqueue(FieldParser.parse_for_capture(attrs))

data/lib/posthog/feature_flags.rb

@@ -62,6 +62,7 @@ module PostHog
       groups = {},
       person_properties = {},
       group_properties = {},
+      only_evaluate_locally = false,
       raise_on_error = false
     )
       # TODO: Convert to options hash for easier argument passing
@@ -70,7 +71,7 @@ module PostHog
         groups,
         person_properties,
         group_properties,
-        false,
+        only_evaluate_locally,
         raise_on_error
       )
 
@@ -537,6 +538,14 @@ module PostHog
 
       unless (condition[:properties] || []).empty?
         if !condition[:properties].all? do |prop|
+          # Skip flag dependencies as they are not supported in local evaluation
+          if prop[:type] == 'flag'
+            logger.warn(
+              '[FEATURE FLAGS] Flag dependency filters are not supported in local evaluation. ' \
+              "Skipping condition for flag '#{flag[:key]}' with dependency on flag '#{prop[:key]}'"
+            )
+            next true
+          end
           FeatureFlagsPoller.match_property(prop, properties)
         end
           return false

data/lib/posthog/field_parser.rb

@@ -142,7 +142,7 @@ module PostHog
           }
         }
 
-        if send_feature_flags
+        if send_feature_flags && fields[:feature_variants]
           feature_variants = fields[:feature_variants]
           active_feature_variants = {}
           feature_variants.each do |key, value|

data/lib/posthog/send_feature_flags_options.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'posthog/utils'
+
+module PostHog
+  # Options for configuring feature flag behavior in capture calls
+  class SendFeatureFlagsOptions
+    attr_reader :only_evaluate_locally, :person_properties, :group_properties
+
+    def initialize(only_evaluate_locally: nil, person_properties: nil, group_properties: nil)
+      @only_evaluate_locally = only_evaluate_locally
+      @person_properties = person_properties || {}
+      @group_properties = group_properties || {}
+    end
+
+    def to_h
+      {
+        only_evaluate_locally: @only_evaluate_locally,
+        person_properties: @person_properties,
+        group_properties: @group_properties
+      }
+    end
+
+    def self.from_hash(hash)
+      return nil unless hash.is_a?(Hash)
+
+      new(
+        only_evaluate_locally: PostHog::Utils.get_by_symbol_or_string_key(hash, :only_evaluate_locally),
+        person_properties: PostHog::Utils.get_by_symbol_or_string_key(hash, :person_properties),
+        group_properties: PostHog::Utils.get_by_symbol_or_string_key(hash, :group_properties)
+      )
+    end
+  end
+end

data/lib/posthog/utils.rb

@@ -112,6 +112,24 @@ module PostHog
       false
     end
 
+    # public: Get value from hash by symbol key first, then string key
+    #         Handles falsy values correctly (unlike ||)
+    #
+    # hash - Hash to lookup value in
+    # key  - Symbol or String key to lookup
+    #
+    # Returns the value if found, nil otherwise
+    def get_by_symbol_or_string_key(hash, key)
+      symbol_key = key.to_sym
+      string_key = key.to_s
+
+      if hash.key?(symbol_key)
+        hash[symbol_key]
+      else
+        hash[string_key]
+      end
+    end
+
     class SizeLimitedHash < Hash
       def initialize(max_length, ...)
         super(...)

data/lib/posthog/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PostHog
-  VERSION = '3.0.1'
+  VERSION = '3.1.0'
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: posthog-ruby
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - ''
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -44,6 +45,7 @@ files:
 - lib/posthog/message_batch.rb
 - lib/posthog/noop_worker.rb
 - lib/posthog/response.rb
+- lib/posthog/send_feature_flags_options.rb
 - lib/posthog/send_worker.rb
 - lib/posthog/transport.rb
 - lib/posthog/utils.rb
@@ -53,6 +55,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -67,7 +70,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.10
+signing_key:
 specification_version: 4
 summary: PostHog library
 test_files: []