growthbook 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d90d8442599a6a64a434b33a4a2c094cc13e3deff03d4d0a19f8701a9672f772
-  data.tar.gz: b5dd4a070d27bfabd3400fc10f88c500c581308397437089710e9a67e1bc8b4a
+  metadata.gz: 2d8ce0f8ecb79cd594b5b6e820410acb3abc3773c8a3012f8cf39df388d94acb
+  data.tar.gz: 0f9030d6c3db6fdcc7821e28fe18379967ed20aa88661d946ec67c56af3c6ef1
 SHA512:
-  metadata.gz: d43c5699fcc64b29c7805f08047bb430aac85a76f79bdc6163970b8993e2a307979e427621603c9481d10b508915a7ebf484c389a2414f6a05e5420d3b9295e8
-  data.tar.gz: 52ff8761dc58407af265eb3f956393ccfc717be0856b3e89620cf43d8e993cf2ed723b25c2d557e6ee80309202b6286742850928576a2ee4188e9454da95f691
+  metadata.gz: 963c831c370739516b95dcecfb1ba321202a53ab053316f1e715df452b599fb0213b04355b5bd31d3f5c6c5b54100307f5ca2231321e4f04375a68774e8752c2
+  data.tar.gz: 4858df411e5cf01bf35d08e1ea77bf588f04e7d6b49d99d750f0280c0bc0513486604e574bf580b005c2d0eb703ce52ffe507221b8aa83e184d29123cacac7ed

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: growthbook
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 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