posthog-ruby 3.3.2 → 3.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9df507c0722b4e1f6d12810813f6f8d37d24473a034ef067889d83edc3106dcc
-  data.tar.gz: c576573a7eef9476b9d16905b7bf26f249ed10ef4cb12691746de161dec9277d
+  metadata.gz: 9a8d4402eef3a161a1c76c7e7e2349356741011cc6ead4acde7bd31ef437e568
+  data.tar.gz: b9ad05adb1b5e3aea9849bf0bbceceef0d22f9724561e8f3a4a3e39f4ed104e8
 SHA512:
-  metadata.gz: a2b8b07133cef4a959d79db0ec354fa8437f72b7e312240a41af44820e6663f7595da661c6b3e172885b7766f8f5f07ba35ee21d1795c564c09838358647d1cc
-  data.tar.gz: af0218271ebf8de7d45e289176e941d0e72e7871df5d3438f2c30d4f423170125d3b54e89ae4bf05ba63d80fbb9981b0e4a7acf02dfeb2fa17d7891dcf29d02e
+  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]
 
@@ -747,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.2'
+  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.2
+  version: 3.3.3
 platform: ruby
 authors:
 - ''
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-09-26 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.0.3.1
-signing_key: 
+rubygems_version: 3.6.6
 specification_version: 4
 summary: PostHog library
 test_files: []