growthbook 1.1.1 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d90d8442599a6a64a434b33a4a2c094cc13e3deff03d4d0a19f8701a9672f772
-  data.tar.gz: b5dd4a070d27bfabd3400fc10f88c500c581308397437089710e9a67e1bc8b4a
+  metadata.gz: cba2938ec675b1626d643fb7493223a54d0faf1ffc37c2bacb5a06637c0a75cd
+  data.tar.gz: bce59918f346b53182450ec2fdd92776767954712334bc5b7c0bd48d952c05ce
 SHA512:
-  metadata.gz: d43c5699fcc64b29c7805f08047bb430aac85a76f79bdc6163970b8993e2a307979e427621603c9481d10b508915a7ebf484c389a2414f6a05e5420d3b9295e8
-  data.tar.gz: 52ff8761dc58407af265eb3f956393ccfc717be0856b3e89620cf43d8e993cf2ed723b25c2d557e6ee80309202b6286742850928576a2ee4188e9454da95f691
+  metadata.gz: 0c4ac9f40b23c8719b9cb585d92f089144df5441c787321fd0083ae72ff954f5f8027615cc3d226dcdb7c2bfdc3dc5911ef1abd472904c026a3e24c1dd81230c
+  data.tar.gz: 735bfc1c4b82432a4a9b0664282062f43ab644309933afcddb43c9dc53cd32a278d1cf14221ad9b298a0bbdb0e2a12a8e77c4aa814d8ba3719e7840c62a4d09a

data/lib/growthbook/context.rb

@@ -15,6 +15,9 @@ module Growthbook
     # @return [Growthbook::TrackingCallback] An object that responds to `on_experiment_viewed(GrowthBook::InlineExperiment, GrowthBook::InlineExperimentResult)`
     attr_accessor :listener
 
+    # @return [Growthbook::FeatureUsageCallback] An object that responds to `on_feature_usage(String, Growthbook::FeatureResult)`
+    attr_accessor :on_feature_usage
+
     # @return [Hash] Map of user attributes that are used to assign variations
     attr_reader :attributes
 
@@ -61,6 +64,8 @@ module Growthbook
           @qa_mode = value
         when :listener
           @listener = value
+        when :on_feature_usage
+          @on_feature_usage = value
         else
           warn("Unknown context option: #{key}")
         end
@@ -94,11 +99,11 @@ module Growthbook
 
     def eval_feature(key)
       # Forced in the context
-      return get_feature_result(@forced_features[key.to_s], 'override', nil, nil) if @forced_features.key?(key.to_s)
+      return get_feature_result(key.to_s, @forced_features[key.to_s], 'override', nil, nil) if @forced_features.key?(key.to_s)
 
       # Return if we can't find the feature definition
       feature = get_feature(key)
-      return get_feature_result(nil, 'unknownFeature', nil, nil) unless feature
+      return get_feature_result(key.to_s, nil, 'unknownFeature', nil, nil) unless feature
 
       feature.rules.each do |rule|
         # Targeting condition
@@ -120,7 +125,7 @@ module Growthbook
           )
           next unless included_in_rollout
 
-          return get_feature_result(rule.force, 'force', nil, nil)
+          return get_feature_result(key.to_s, rule.force, 'force', nil, nil)
         end
         # Experiment rule
         next unless rule.experiment?
@@ -132,11 +137,11 @@ module Growthbook
 
         next unless result.in_experiment && !result.passthrough
 
-        return get_feature_result(result.value, 'experiment', exp, result)
+        return get_feature_result(key.to_s, result.value, 'experiment', exp, result)
       end
 
       # Fallback
-      get_feature_result(feature.default_value.nil? ? nil : feature.default_value, 'defaultValue', nil, nil)
+      get_feature_result(key.to_s, feature.default_value.nil? ? nil : feature.default_value, 'defaultValue', nil, nil)
     end
 
     def run(exp)
@@ -285,8 +290,19 @@ module Growthbook
       result
     end
 
-    def get_feature_result(value, source, experiment, experiment_result)
-      Growthbook::FeatureResult.new(value, source, experiment, experiment_result)
+    def get_feature_result(key, value, source, experiment, experiment_result)
+      res = Growthbook::FeatureResult.new(value, source, experiment, experiment_result)
+
+      track_feature_usage(key, res)
+
+      res
+    end
+
+    def track_feature_usage(key, feature_result)
+      return unless on_feature_usage.respond_to?(:on_feature_usage)
+      return if feature_result.source == 'override'
+
+      on_feature_usage.on_feature_usage(key, feature_result)
     end
 
     def get_feature(key)

data/lib/growthbook/feature_usage_callback.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Growthbook
+  # Extendable class that can be used as the feature usage callback
+  class FeatureUsageCallback
+    def on_feature_usage(_feature_key, _result); end
+  end
+end

data/lib/growthbook.rb

@@ -16,3 +16,4 @@ require 'growthbook/inline_experiment'
 require 'growthbook/inline_experiment_result'
 require 'growthbook/tracking_callback'
 require 'growthbook/util'
+require 'growthbook/feature_usage_callback'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: growthbook
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.1
 platform: ruby
 authors:
 - GrowthBook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-21 00:00:00.000000000 Z
+date: 2023-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -94,6 +94,7 @@ files:
 - lib/growthbook/feature_repository.rb
 - lib/growthbook/feature_result.rb
 - lib/growthbook/feature_rule.rb
+- lib/growthbook/feature_usage_callback.rb
 - lib/growthbook/fnv.rb
 - lib/growthbook/inline_experiment.rb
 - lib/growthbook/inline_experiment_result.rb