posthog-ruby 3.9.5 → 3.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26f691859b23fd8a734457d5210bcfe633213c352c7362b375cf0107c169fce6
-  data.tar.gz: b4b3803c627bf7f2f680e26ea986c40a5c36ec73ec87ef197b4d4fa702e5cb77
+  metadata.gz: 334d837a2faf144afce1125f198607af7d4078b34329c394df8e4e221bf1ab89
+  data.tar.gz: 62c48db3c45c0a962294546c06b485ace4e4d6f40bd5178f6c393f61e4243344
 SHA512:
-  metadata.gz: 4163a8b03c807016df84525b4adf6aa4a55af22c5354e4710dd82d2fc5222015c242a22ad5e9564614686527c0ff97e72cd0b40d18b3bace964bcb68d3fe8c7c
-  data.tar.gz: 5ad637fd4df58d0d296b30c820c7017957ed4eae7488e639402504b4d477a97d30e9533a2fe14373ae5806ee515eab21522a2c6ef81222de4ce9e43dd1042a18
+  metadata.gz: 2e23767920c9f2169e45dfae59515e15bb17df9d6c69d08caaea786b4ee3a84f2e47aac6ac0f677b9193862eaf571c6657f1975142b749d8766fb49fcbf4c2c4
+  data.tar.gz: 7e51f30ec5ff951e639ce97efba159fa63a419897b12b5ca6418149323fd7a2ae469bbca2ba13eb9fa02cf8071cf0e39453cd96282eaadf4bdf1331e4269ae6e

data/lib/posthog/client.rb

@@ -73,6 +73,9 @@ module PostHog
     #   Intended only for local development or custom deployments.
     # @option opts [Object] :flag_definition_cache_provider An object implementing the {FlagDefinitionCacheProvider}
     #   interface for distributed flag definition caching.
+    # @option opts [Boolean] :is_server +true+ to stamp captured events with `$is_server => true` so PostHog
+    #   attributes them as server-side. Defaults to +true+. Set to +false+ when running posthog-ruby as a
+    #   client/CLI so the device OS is attributed normally and `$is_server` is omitted.
     def initialize(opts = {})
       symbolize_keys!(opts)
 
@@ -141,6 +144,7 @@ module PostHog
       end
 
       @before_send = opts[:before_send]
+      @is_server = opts.fetch(:is_server, true) != false
       @deprecation_emitted_for = Concurrent::Set.new
     end
 
@@ -272,6 +276,7 @@ module PostHog
         attrs[:feature_variants] = feature_variants if feature_variants
       end
 
+      attrs[:is_server] = @is_server
       enqueue(FieldParser.parse_for_capture(attrs))
     end
 
@@ -317,6 +322,7 @@ module PostHog
       return false if @disabled
 
       symbolize_keys! attrs
+      attrs[:is_server] = @is_server
       enqueue(FieldParser.parse_for_identify(attrs))
     end
 
@@ -334,6 +340,7 @@ module PostHog
       return false if @disabled
 
       symbolize_keys! attrs
+      attrs[:is_server] = @is_server
       enqueue(FieldParser.parse_for_group_identify(attrs))
     end
 
@@ -348,6 +355,7 @@ module PostHog
       return false if @disabled
 
       symbolize_keys! attrs
+      attrs[:is_server] = @is_server
       enqueue(FieldParser.parse_for_alias(attrs))
     end
 

data/lib/posthog/exception_capture.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
-# Portions of this file are derived from getsentry/sentry-ruby by Software, Inc. dba Sentry
-# Licensed under the MIT License
+# Portions of this file are derived from getsentry/sentry-ruby
+# Copyright (c) 2020 Sentry
+# Licensed under the MIT License: https://github.com/getsentry/sentry-ruby/blob/master/LICENSE
 # - sentry-ruby/lib/sentry/interfaces/single_exception.rb
 # - sentry-ruby/lib/sentry/interfaces/stacktrace_builder.rb
 # - sentry-ruby/lib/sentry/backtrace.rb

data/lib/posthog/feature_flags.rb

@@ -961,6 +961,7 @@ module PostHog
 
       flag_conditions = flag_filters[:groups] || []
       flag_aggregation = flag_filters[:aggregation_group_type_index]
+      early_exit = flag_filters[:early_exit] == true
       is_inconclusive = false
       result = nil
 
@@ -997,8 +998,9 @@ module PostHog
           end
         end
 
-        if condition_match(flag, effective_bucketing, condition, effective_properties, evaluation_cache,
-                           cohort_properties)
+        case condition_match_outcome(flag, effective_bucketing, condition, effective_properties, evaluation_cache,
+                                     cohort_properties)
+        when :match
           variant_override = condition[:variant]
           flag_multivariate = flag_filters[:multivariate] || {}
           flag_variants = flag_multivariate[:variants] || []
@@ -1009,6 +1011,8 @@ module PostHog
                     end
           result = variant || true
           break
+        when :out_of_rollout_bound
+          break if early_exit
         end
       rescue RequiresServerEvaluation
         # Static cohort or other missing server-side data - must fallback to API
@@ -1030,6 +1034,18 @@ module PostHog
     end
 
     def condition_match(flag, distinct_id, condition, properties, evaluation_cache, cohort_properties = {})
+      condition_match_outcome(flag, distinct_id, condition, properties, evaluation_cache,
+                              cohort_properties) == :match
+    end
+
+    # Evaluates a single condition group and returns a tri-state outcome:
+    #   :match                 - property filters matched AND the rollout included the user
+    #   :no_match              - a property filter did NOT match
+    #   :out_of_rollout_bound  - property filters matched (or there were none) but the
+    #                            rollout percentage excluded the user
+    # Distinguishing :no_match from :out_of_rollout_bound lets the caller implement the
+    # early_exit behavior (mirrors the server-side Rust evaluation engine).
+    def condition_match_outcome(flag, distinct_id, condition, properties, evaluation_cache, cohort_properties = {})
       rollout_percentage = condition[:rollout_percentage]
 
       unless (condition[:properties] || []).empty?
@@ -1040,15 +1056,17 @@ module PostHog
             FeatureFlagsPoller.match_property(prop, properties, cohort_properties)
           end
         end
-          return false
+          return :no_match
         end
 
-        return true if rollout_percentage.nil?
+        return :match if rollout_percentage.nil?
       end
 
-      return false if !rollout_percentage.nil? && (_hash(flag[:key], distinct_id) > (rollout_percentage.to_f / 100))
+      if !rollout_percentage.nil? && (_hash(flag[:key], distinct_id) > (rollout_percentage.to_f / 100))
+        return :out_of_rollout_bound
+      end
 
-      true
+      :match
     end
 
     # This function takes a distinct_id and a feature flag key and returns a float between 0 and 1.

data/lib/posthog/field_parser.rb

@@ -89,11 +89,11 @@ module PostHog
         common.merge(
           {
             event: '$groupidentify',
-            properties: {
+            properties: (common[:properties] || {}).merge(
               '$group_type': group_type,
               '$group_key': group_key,
-              '$group_set': properties.merge(common[:properties] || {})
-            }
+              '$group_set': properties
+            )
           }
         )
       end
@@ -141,16 +141,21 @@ module PostHog
         check_timestamp! timestamp
         check_presence! distinct_id, 'distinct_id'
 
+        is_server = fields.fetch(:is_server, true) != false
+
+        properties = {
+          '$lib' => 'posthog-ruby',
+          '$lib_version' => PostHog::VERSION.to_s
+        }
+        properties['$is_server'] = true if is_server
+
         parsed = {
           timestamp: datetime_in_iso8601(timestamp),
           library: 'posthog-ruby',
           library_version: PostHog::VERSION.to_s,
           messageId: message_id,
           distinct_id: distinct_id,
-          properties: {
-            '$lib' => 'posthog-ruby',
-            '$lib_version' => PostHog::VERSION.to_s
-          }
+          properties: properties
         }
 
         if send_feature_flags && fields[:feature_variants]

data/lib/posthog/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: posthog-ruby
 version: !ruby/object:Gem::Version
-  version: 3.9.5
+  version: 3.11.0
 platform: ruby
 authors:
 - ''