posthog-ruby 3.3.0 → 3.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e895ef67d6f423e89151951d6868fa464c1efe64cee6dd37be8923351bf88467
-  data.tar.gz: 7bf79b2a93e79c8717e52ed2a6ca3261f0d3933859e05e0cee1c9c22aaaa77db
+  metadata.gz: 9a8d4402eef3a161a1c76c7e7e2349356741011cc6ead4acde7bd31ef437e568
+  data.tar.gz: b9ad05adb1b5e3aea9849bf0bbceceef0d22f9724561e8f3a4a3e39f4ed104e8
 SHA512:
-  metadata.gz: 881cd65e3634adc8fe539fad751591876ffd070ed712b4de8533fdf38e231ba15fd126daa0afece1b1f06b27306c3afa00c1129e37c98202391593f439cfa886
-  data.tar.gz: 2333ef174f7f08858cf518d66ac60bd6c5fa8246d06b61c73c89c5e7d08cf2986b5b45bc952d6d18476b3b73257402ee5838a362da100da1b64d7c72f4ae38eb
+  metadata.gz: 055501a8e3ea62cfd321adee64297023338deb455ed59746632c0051179e3b3f6e733f1f7126eb612e5c381aa8bf8653b51ae2d15a1be938d80d05f8e0b06e3f
+  data.tar.gz: c4dd9ae85bafbec60209c8aff9329f79585b99deb8ffe1624397df73d930d54c40ab5fefaac2de9b75adee80c242f98d26428b61f4155206ce7632517303241b

data/lib/posthog/feature_flags.rb

@@ -12,6 +12,13 @@ module PostHog
   class InconclusiveMatchError < StandardError
   end
 
+  # RequiresServerEvaluation is raised when feature flag evaluation requires
+  # server-side data that is not available locally (e.g., static cohorts,
+  # experience continuity). This error should propagate immediately to trigger
+  # API fallback, unlike InconclusiveMatchError which allows trying other conditions.
+  class RequiresServerEvaluation < StandardError
+  end
+
   class FeatureFlagsPoller
     include PostHog::Logging
     include PostHog::Utils
@@ -173,7 +180,7 @@ module PostHog
         begin
           response = _compute_flag_locally(feature_flag, distinct_id, groups, person_properties, group_properties)
           logger.debug "Successfully computed flag locally: #{key} -> #{response}"
-        rescue InconclusiveMatchError => e
+        rescue RequiresServerEvaluation, InconclusiveMatchError => e
           logger.debug "Failed to compute flag #{key} locally: #{e}"
         rescue StandardError => e
           @on_error.call(-1, "Error computing flag locally: #{e}. #{e.backtrace.join("\n")}")
@@ -251,7 +258,7 @@ module PostHog
         flags[flag[:key]] = match_value
         match_payload = _compute_flag_payload_locally(flag[:key], match_value)
         payloads[flag[:key]] = match_payload if match_payload
-      rescue InconclusiveMatchError
+      rescue RequiresServerEvaluation, InconclusiveMatchError
         fallback_to_server = true
       rescue StandardError => e
         @on_error.call(-1, "Error computing flag locally: #{e}. #{e.backtrace.join("\n")} ")
@@ -461,7 +468,10 @@ module PostHog
       cohort_id = extract_value(property, :value).to_s
       property_group = find_cohort_property(cohort_properties, cohort_id)
 
-      raise InconclusiveMatchError, "can't match cohort without a given cohort property value" unless property_group
+      unless property_group
+        raise RequiresServerEvaluation,
+              "cohort #{cohort_id} not found in local cohorts - likely a static cohort that requires server evaluation"
+      end
 
       match_property_group(property_group, property_values, cohort_properties)
     end
@@ -539,6 +549,9 @@ module PostHog
         elsif final_result # group_type == 'OR'
           return true
         end
+      rescue RequiresServerEvaluation
+        # Immediately propagate - this condition requires server-side data
+        raise
       rescue InconclusiveMatchError => e
         PostHog::Logging.logger&.debug("Failed to compute property #{prop} locally: #{e}")
         error_matching_locally = true
@@ -676,7 +689,7 @@ module PostHog
                          :match_nested_property_group, :match_regular_property_group
 
     def _compute_flag_locally(flag, distinct_id, groups = {}, person_properties = {}, group_properties = {})
-      raise InconclusiveMatchError, 'Flag has experience continuity enabled' if flag[:ensure_experience_continuity]
+      raise RequiresServerEvaluation, 'Flag has experience continuity enabled' if flag[:ensure_experience_continuity]
 
       return false unless flag[:active]
 
@@ -733,15 +746,8 @@ module PostHog
       is_inconclusive = false
       result = nil
 
-      # Stable sort conditions with variant overrides to the top. This ensures that if overrides are present, they are
-      # evaluated first, and the variant override is applied to the first matching condition.
-      sorted_flag_conditions = flag_conditions.each_with_index.sort_by do |condition, idx|
-        [condition[:variant].nil? ? 1 : -1, idx]
-      end
-
       # NOTE: This NEEDS to be `each` because `each_key` breaks
-      # This is not a hash, it's just an array with 2 entries
-      sorted_flag_conditions.each do |condition, _idx| # rubocop:disable Style/HashEachMethods
+      flag_conditions.each do |condition|
         if condition_match(flag, distinct_id, condition, properties, evaluation_cache, cohort_properties)
           variant_override = condition[:variant]
           flag_multivariate = flag_filters[:multivariate] || {}
@@ -754,7 +760,12 @@ module PostHog
           result = variant || true
           break
         end
+      rescue RequiresServerEvaluation
+        # Static cohort or other missing server-side data - must fallback to API
+        raise
       rescue InconclusiveMatchError
+        # Evaluation error (bad regex, invalid date, missing property, etc.)
+        # Track that we had an inconclusive match, but try other conditions
         is_inconclusive = true
       end
 

data/lib/posthog/version.rb

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

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: posthog-ruby
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.3.3
 platform: ruby
 authors:
 - ''
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-23 00:00:00.000000000 Z
+date: 2025-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -57,7 +56,6 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -72,8 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 3.6.6
 specification_version: 4
 summary: PostHog library
 test_files: []