mixpanel-ruby 2.3.0 → 3.0.0

data/lib/mixpanel-ruby/flags/types.rb

@@ -0,0 +1,35 @@
+module Mixpanel
+  module Flags
+    # Selected variant returned from flag evaluation
+    class SelectedVariant
+      attr_accessor :variant_key, :variant_value, :experiment_id,
+                    :is_experiment_active, :is_qa_tester
+
+      # @param variant_key [String, nil] The variant key
+      # @param variant_value [Object] The variant value (any type)
+      # @param experiment_id [String, nil] Associated experiment ID
+      # @param is_experiment_active [Boolean, nil] Whether experiment is active
+      # @param is_qa_tester [Boolean, nil] Whether user is a QA tester
+      def initialize(variant_key: nil, variant_value: nil, experiment_id: nil,
+                     is_experiment_active: nil, is_qa_tester: nil)
+        @variant_key = variant_key
+        @variant_value = variant_value
+        @experiment_id = experiment_id
+        @is_experiment_active = is_experiment_active
+        @is_qa_tester = is_qa_tester
+      end
+
+      # Convert to hash representation
+      # @return [Hash]
+      def to_h
+        {
+          variant_key: @variant_key,
+          variant_value: @variant_value,
+          experiment_id: @experiment_id,
+          is_experiment_active: @is_experiment_active,
+          is_qa_tester: @is_qa_tester
+        }.compact
+      end
+    end
+  end
+end

data/lib/mixpanel-ruby/flags/utils.rb

@@ -0,0 +1,65 @@
+require 'securerandom'
+
+module Mixpanel
+  module Flags
+    module Utils
+      EXPOSURE_EVENT = '$experiment_started'.freeze
+
+      # FNV-1a 64-bit hash implementation
+      # Used for consistent variant assignment
+      #
+      # @param data [String] Data to hash
+      # @return [Integer] 64-bit hash value
+      def self.fnv1a_64(data)
+        fnv_prime = 0x100000001b3
+        hash_value = 0xcbf29ce484222325
+
+        data.bytes.each do |byte|
+          hash_value ^= byte
+          hash_value *= fnv_prime
+          hash_value &= 0xffffffffffffffff  # Keep 64-bit
+        end
+
+        hash_value
+      end
+
+      # Normalized hash for variant assignment
+      # Returns a float in the range [0.0, 1.0) for rollout percentage matching
+      #
+      # @param key [String] Key to hash (typically distinct_id)
+      # @param salt [String] Salt value (flag-specific)
+      # @return [Float] Value between 0.0 and 1.0 (non-inclusive upper bound)
+      def self.normalized_hash(key, salt)
+        combined = key.to_s + salt.to_s
+        hash_value = fnv1a_64(combined)
+        (hash_value % 100) / 100.0
+      end
+
+      # Prepare common query parameters for flags API
+      #
+      # @param token [String] Mixpanel project token
+      # @param $lib_version [String] SDK version
+      # @return [Hash] Query parameters
+      def self.prepare_common_query_params(token, lib_version)
+        {
+          'mp_lib' => 'ruby',
+          '$lib_version' => lib_version,
+          'token' => token
+        }
+      end
+
+      # Generate W3C traceparent header for distributed tracing
+      # Format: 00-{trace-id}-{parent-id}-{trace-flags}
+      #
+      # @return [String] traceparent header value
+      def self.generate_traceparent
+        version = '00'
+        trace_id = SecureRandom.hex(16)
+        parent_id = SecureRandom.hex(8)
+        trace_flags = '01'  # sampled
+
+        "#{version}-#{trace_id}-#{parent_id}-#{trace_flags}"
+      end
+    end
+  end
+end

data/lib/mixpanel-ruby/groups.rb

@@ -170,7 +170,7 @@ module Mixpanel
     def update(message)
       data = {
         '$token' => @token,
-        '$time' =>  Time.now.to_f,
+        '$time' =>  (Time.now.to_f * 1000).to_i,
       }.merge(message)
 
       message = {'data' => data}

data/lib/mixpanel-ruby/people.rb

@@ -223,7 +223,7 @@ module Mixpanel
     def update(message)
       data = {
         '$token' => @token,
-        '$time' =>  Time.now.to_f,
+        '$time' =>  (Time.now.to_f * 1000).to_i,
       }.merge(message)
 
       message = {'data' => data}

data/lib/mixpanel-ruby/tracker.rb

@@ -1,6 +1,8 @@
 require 'mixpanel-ruby/events.rb'
 require 'mixpanel-ruby/people.rb'
 require 'mixpanel-ruby/groups.rb'
+require 'mixpanel-ruby/flags/local_flags_provider.rb'
+require 'mixpanel-ruby/flags/remote_flags_provider.rb'
 
 module Mixpanel
   # Use Mixpanel::Tracker to track events and profile updates in your application.
@@ -33,6 +35,14 @@ module Mixpanel
     # An instance of Mixpanel::Groups. Use this to send groups updates
     attr_reader :groups
 
+    # An instance of Mixpanel::Flags::LocalFlagsProvider. Use this for
+    # client-side feature flag evaluation
+    attr_reader :local_flags
+
+    # An instance of Mixpanel::Flags::RemoteFlagsProvider. Use this for
+    # server-side feature flag evaluation
+    attr_reader :remote_flags
+
     # Takes your Mixpanel project token, as a string.
     #
     #    tracker = Mixpanel::Tracker.new(YOUR_MIXPANEL_TOKEN)
@@ -52,11 +62,31 @@ module Mixpanel
     # If a block is provided, it is passed a type (one of :event or :profile_update)
     # and a string message. This same format is accepted by Mixpanel::Consumer#send!
     # and Mixpanel::BufferedConsumer#send!
-    def initialize(token, error_handler=nil, &block)
+    def initialize(token, error_handler=nil, local_flags_config: nil, remote_flags_config: nil, &block)
       super(token, error_handler, &block)
       @token = token
       @people = People.new(token, error_handler, &block)
       @groups = Groups.new(token, error_handler, &block)
+
+      # Initialize local flags if config provided
+      if local_flags_config
+        @local_flags = Flags::LocalFlagsProvider.new(
+          token,
+          local_flags_config,
+          method(:track),  # Pass bound method as callback
+          error_handler || ErrorHandler.new
+        )
+      end
+
+      # Initialize remote flags if config provided
+      if remote_flags_config
+        @remote_flags = Flags::RemoteFlagsProvider.new(
+          token,
+          remote_flags_config,
+          method(:track),  # Pass bound method as callback
+          error_handler || ErrorHandler.new
+        )
+      end
     end
 
     # A call to #track is a report that an event has occurred.  #track
@@ -165,7 +195,7 @@ module Mixpanel
       properties = {
         'distinct_id' => distinct_id,
         'token' => @token,
-        'time' => Time.now.to_f,
+        'time' => (Time.now.to_f * 1000).to_i,
         'mp_lib' => 'ruby',
         '$lib_version' => Mixpanel::VERSION,
       }.merge(properties)

data/lib/mixpanel-ruby/version.rb

@@ -1,3 +1,3 @@
 module Mixpanel
-  VERSION = '2.3.0'
+  VERSION = '3.0.0'
 end

data/lib/mixpanel-ruby.rb

@@ -1,3 +1,8 @@
 require 'mixpanel-ruby/consumer.rb'
 require 'mixpanel-ruby/tracker.rb'
 require 'mixpanel-ruby/version.rb'
+require 'mixpanel-ruby/flags/utils.rb'
+require 'mixpanel-ruby/flags/types.rb'
+require 'mixpanel-ruby/flags/flags_provider.rb'
+require 'mixpanel-ruby/flags/local_flags_provider.rb'
+require 'mixpanel-ruby/flags/remote_flags_provider.rb'

data/mixpanel-ruby.gemspec

@@ -12,10 +12,17 @@ spec = Gem::Specification.new do |spec|
   spec.homepage = 'https://mixpanel.com/help/reference/ruby'
   spec.license = 'Apache License 2.0'
 
-  spec.required_ruby_version = '>= 2.0.0'
+  spec.required_ruby_version = '>= 3.0.0'
+  spec.add_runtime_dependency 'mutex_m'
+  spec.add_runtime_dependency "base64"
+  spec.add_runtime_dependency 'json-logic-rb', '~> 0.1.5'
 
   spec.add_development_dependency 'activesupport', '~> 4.0'
-  spec.add_development_dependency 'rake', '~> 0'
+  spec.add_development_dependency 'rake', '~> 13'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'webmock', '~> 1.18'
+  spec.add_development_dependency 'webmock', '~> 3.16.2'
+  spec.add_development_dependency 'debug'
+  spec.add_development_dependency 'ruby-lsp-rspec'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'simplecov-cobertura'
 end

data/spec/mixpanel-ruby/events_spec.rb

@@ -27,7 +27,7 @@ describe Mixpanel::Events do
             'mp_lib' => 'ruby',
             '$lib_version' => Mixpanel::VERSION,
             'token' => 'TEST TOKEN',
-            'time' => @time_now.to_i
+            'time' => @time_now.to_i * 1000
         }
     }]])
   end
@@ -46,7 +46,7 @@ describe Mixpanel::Events do
                 'mp_lib' => 'ruby',
                 '$lib_version' => Mixpanel::VERSION,
                 'token' => 'TEST TOKEN',
-                'time' => @time_now.to_i
+                'time' => @time_now.to_i * 1000
             }
         }
     } ]])