amplitude-experiment 1.0.0.beta.6 → 1.0.0.beta.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 625ebf6baeed965a20e5b19c0b9655337523b0749edb5ca39d742c07d4421ce6
-  data.tar.gz: 83d0a1bf035e355ba94804368e44ca11efb8eb80a86288a7a8ea9d81040a30c5
+  metadata.gz: 2ca6e5960f24ff9df262ce2dabff4b487e3cf26dbd1a6a48010da199fcf0ee63
+  data.tar.gz: b368a468d27f7d739b34272f20175049e839b4ba3ba620eb2ce229a829e9fa3f
 SHA512:
-  metadata.gz: a4fa14dff27f5b8d3126df2337169a03c931d22c431b1f30e6067086839f95eff0ac4e6d3c3fcef19bdbf224df82da57f7b7726e40f23ba9656b32996814bbc7
-  data.tar.gz: b0eb2539296c79d0d1de7c9f878a73d9f1cf93d1089da33fc73989ee29c60c5c8e811550ec4fc8d120ca2187d093db6cf0f6fbac5a03ad6d58806b3d92314681
+  metadata.gz: bdb8f048df75ec0f1a55e2adb0191bd1c9c58f6c4137a0d05d5c32b141090935ceba034f6ff7f2dbd534d029c1620a800c01944ad688f2921fc265d279327d57
+  data.tar.gz: 71b1cdadbab86a9f77e3a6f4cd55064128d3194029c095473e838e77ad2bcbc5b2410065c182f05378ced43a4803d03d4856d99096b230b17ae6817fe91bc0e5

data/README.md

@@ -25,7 +25,7 @@ gem install amplitude-experiment --pre
 ```
 
 
-## Quick Start
+## Remote Evaluation Quick Start
 ```ruby
 require 'amplitude-experiment'
 
@@ -33,7 +33,7 @@ require 'amplitude-experiment'
 apiKey = 'YOUR-API-KEY'
 
 # (2) Initialize the experiment client
-experiment = AmplitudeExperiment.init(api_key)
+experiment = AmplitudeExperiment.initialize_remote(api_key)
 
 # (3) Fetch variants for a user
 user = AmplitudeExperiment::User.new(user_id: 'user@company.com', device_id: 'abcezas123', user_properties: {'premium' => true})
@@ -64,6 +64,33 @@ unless variant.nil?
 end
 ```
 
+## Local Evaluation Quick Start
+
+```ruby
+require 'amplitude-experiment'
+
+# (1) Get your deployment's API key
+apiKey = 'YOUR-API-KEY'
+
+# (2) Initialize the experiment client
+experiment = AmplitudeExperiment.initialize_local(api_key)
+
+# (3) Start the local evaluation client
+experiment.start
+
+# (4) Evaluate a user
+user = AmplitudeExperiment::User.new(user_id: 'user@company.com', device_id: 'abcezas123', user_properties: {'premium' => true})
+variants = experiment.evaluate(user)
+variant = variants['YOUR-FLAG-KEY']
+unless variant.nil?
+  if variant.value == 'on'
+    # Flag is on
+  else
+    # Flag is off
+  end
+end
+```
+
 ## More Information
 Please visit our :100:[Developer Center](https://www.docs.developers.amplitude.com/experiment/sdks/ruby-sdk/) for more instructions on using our the SDK.
 

data/lib/amplitude-experiment.rb

@@ -1,11 +1,16 @@
 require 'experiment/version'
-require 'experiment/config'
+require 'experiment/persistent_http_client'
+require 'experiment/remote/config'
 require 'experiment/cookie'
 require 'experiment/user'
 require 'experiment/variant'
 require 'experiment/factory'
-require 'experiment/persistent_http_client'
-require 'experiment/client'
+require 'experiment/remote/client'
+require 'experiment/local/client'
+require 'experiment/local/config'
+require 'experiment/local/cache'
+require 'experiment/local/fetcher'
+require 'experiment/local/poller'
 
 # Amplitude Experiment Module
 module AmplitudeExperiment

data/lib/experiment/factory.rb

@@ -1,6 +1,7 @@
 # Provides factory methods for storing singleton instance of Client
 module AmplitudeExperiment
-  @instances = {}
+  @local_instance = {}
+  @remote_instance = {}
   @default_instance = '$default_instance'
 
   # Initializes a singleton Client. This method returns a default singleton instance, subsequent calls to
@@ -8,8 +9,23 @@ module AmplitudeExperiment
   #
   # @param [String] api_key The environment API Key
   # @param [Config] config Optional Config.
-  def self.init(api_key, config = nil)
-    @instances.store(@default_instance, Client.new(api_key, config)) unless @instances.key?(@default_instance)
-    @instances.fetch(@default_instance)
+  def self.initialize_remote(api_key, config = nil)
+    unless @local_instance.key?(@default_instance)
+      @local_instance.store(@default_instance, RemoteEvaluationClient.new(api_key, config))
+    end
+    @local_instance.fetch(@default_instance)
+  end
+
+  # Initializes a local evaluation Client. A local evaluation client can evaluate local flags or experiments for a
+  # user without requiring a remote call to the amplitude evaluation server. In order to best leverage local
+  # evaluation, all flags, and experiments being evaluated server side should be configured as local.
+  #
+  # @param [String] api_key The environment API Key
+  # @param [Config] config Optional Config.
+  def self.initialize_local(api_key, config = nil)
+    unless @remote_instance.key?(@default_instance)
+      @remote_instance.store(@default_instance, LocalEvaluationClient.new(api_key, config))
+    end
+    @remote_instance.fetch(@default_instance)
   end
 end

data/lib/experiment/local/cache.rb

@@ -0,0 +1,53 @@
+require 'uri'
+require 'logger'
+
+module AmplitudeExperiment
+  # InMemoryFlagConfigCache
+  # The place to store the flag configs fetched from the server
+  class InMemoryFlagConfigCache
+    attr_accessor :cache
+
+    def initialize(flag_configs = {})
+      @semaphore = Mutex.new
+      @cache = flag_configs
+    end
+
+    def get(flag_key)
+      @semaphore.synchronize do
+        @cache.fetch(flag_key, nil)
+      end
+    end
+
+    def caches
+      @semaphore.synchronize do
+        @cache
+      end
+    end
+
+    def put(flag_key, flag_config)
+      @semaphore.synchronize do
+        @cache.store(flag_key, flag_config.clone)
+      end
+    end
+
+    def put_all(flag_configs)
+      @semaphore.synchronize do
+        flag_configs.each do |key, value|
+          @cache.store(key, value.clone) if value
+        end
+      end
+    end
+
+    def delete(flag_key)
+      @semaphore.synchronize do
+        @cache.delete(flag_key)
+      end
+    end
+
+    def clear
+      @semaphore.synchronize do
+        @cache = {}
+      end
+    end
+  end
+end

data/lib/experiment/local/client.rb

@@ -0,0 +1,84 @@
+require 'uri'
+require 'logger'
+require 'experiment/local/evaluation/evaluation'
+
+module AmplitudeExperiment
+  # Main client for fetching variant data.
+  class LocalEvaluationClient
+    # Creates a new Experiment Client instance.
+    #
+    # @param [String] api_key The environment API Key
+    # @param [LocalEvaluationConfig] config The config object
+    def initialize(api_key, config = nil)
+      @api_key = api_key
+      @config = config || LocalEvaluationConfig.new
+      @cache = InMemoryFlagConfigCache.new(@config.bootstrap)
+      @logger = Logger.new($stdout)
+      @logger.level = if @config.debug
+                        Logger::DEBUG
+                      else
+                        Logger::INFO
+                      end
+      @fetcher = LocalEvaluationFetcher.new(api_key, @config.debug, @config.server_url)
+      @poller = FlagConfigPoller.new(@fetcher, @cache, @config.debug)
+
+      raise ArgumentError, 'Experiment API key is empty' if @api_key.nil? || @api_key.empty?
+    end
+
+    # Locally evaluates flag variants for a user.
+    #
+    # @param [User] user The user to evaluate
+    # @param [String[]] flag_keys The flags to evaluate with the user. If empty, all flags from the flag cache are evaluated
+    #
+    # @return [Hash[String, Variant]] The evaluated variants
+    def evaluate(user, flag_keys = [])
+      flag_configs = []
+      if flag_keys.empty?
+        @cache.cache.each do |_, value|
+          flag_configs.push(value)
+        end
+      else
+        flag_configs = get_flag_configs(flag_keys)
+      end
+      flag_configs_str = flag_configs.to_json
+      user_str = user.to_json
+      @logger.debug("[Experiment] Evaluate: User: #{user_str} - Rules: #{flag_configs_str}") if @config.debug
+      result_json = evaluation(flag_configs_str, user_str)
+      @logger.debug(`[Experiment] evaluate - result: #{variants}`) if @config.debug
+      result = JSON.parse(result_json)
+      variants = {}
+      result.each do |key, value|
+        next if value['isDefaultVariant']
+
+        variant_key = value['variant']['key']
+        variant_payload = value['variant']['payload']
+        variants.store(key, Variant.new(variant_key, variant_payload))
+      end
+      variants
+    end
+
+    # Fetch initial flag configurations and start polling for updates.
+    # You must call this function to begin polling for flag config updates.
+    def start
+      @poller.start
+    end
+
+    # Stop polling for flag configurations. Close resource like connection pool with client
+    def stop
+      @poller.stop
+    end
+
+    private
+
+    def get_flag_configs(flag_keys = [])
+      return @cache.cache if flag_keys.empty?
+
+      flag_configs = []
+      flag_keys.each do |key|
+        flag_config = @cache.get(key)
+        flag_configs.push(flag_config) if flag_config
+      end
+      flag_configs
+    end
+  end
+end

data/lib/experiment/local/config.rb

@@ -0,0 +1,35 @@
+module AmplitudeExperiment
+  # LocalEvaluationConfig
+  class LocalEvaluationConfig
+    # Default server url
+    DEFAULT_SERVER_URL = 'https://api.lab.amplitude.com'.freeze
+
+    # Set to true to log some extra information to the console.
+    # @return [Boolean] the value of debug
+    attr_accessor :debug
+
+    # The server endpoint from which to request variants.
+    # @return [String] the value of server url
+    attr_accessor :server_url
+
+    # The server endpoint from which to request variants.
+    # @return [Hash] the value of bootstrap
+    attr_accessor :bootstrap
+
+    # The server endpoint from which to request variants.
+    # @return [long] the value of flag config polling interval in million seconds
+    attr_accessor :flag_config_polling_interval_millis
+
+    # @param [Boolean] debug Set to true to log some extra information to the console.
+    # @param [String] server_url The server endpoint from which to request variants.
+    # @param [Hash] bootstrap The value of bootstrap.
+    # @param [long] flag_config_polling_interval_millis The value of flag config polling interval in million seconds.
+    def initialize(server_url = DEFAULT_SERVER_URL, bootstrap = {},
+                   flag_config_polling_interval_millis = 30_000, debug: false)
+      @debug = debug || false
+      @server_url = server_url
+      @bootstrap = bootstrap
+      @flag_config_polling_interval_millis = flag_config_polling_interval_millis
+    end
+  end
+end

data/lib/experiment/local/evaluation/evaluation.rb

@@ -0,0 +1,48 @@
+# rubocop:disable all
+require 'ffi'
+
+# The evaluation wrapper
+module EvaluationInterop
+  extend FFI::Library
+  host_os = RbConfig::CONFIG['host_os']
+  cpu = RbConfig::CONFIG['host_cpu']
+  evaluation_dir = File.dirname(__FILE__)
+  ffi_lib ["#{evaluation_dir}/lib/macosX64/libevaluation_interop.dylib"] if host_os =~ /darwin|mac os/ && cpu =~ /x86_64/
+  ffi_lib ["#{evaluation_dir}/lib/macosArm64/libevaluation_interop.dylib"] if host_os =~ /darwin|mac os/ && cpu =~ /arm64/
+  ffi_lib ["#{evaluation_dir}/lib/linuxX64/libevaluation_interop.so"] if host_os =~ /linux/ && cpu =~ /x86_64/
+  ffi_lib ["#{evaluation_dir}/lib/linuxArm64/libevaluation_interop.so"] if host_os =~ /linux/ && cpu =~ /arm64/
+
+  class Root < FFI::Struct
+    layout :evaluate, callback([:string, :string], :pointer)
+  end
+
+  class Kotlin < FFI::Struct
+    layout :root, Root
+  end
+
+  class Libevaluation_interop_ExportedSymbols < FFI::Struct
+    layout :DisposeStablePointer, callback([:pointer], :void),
+           :DisposeString, callback([:string], :void),
+           :IsInstance, callback([:pointer, :string], :pointer),
+           :createNullableByte, callback([:string], :pointer),
+           :createNullableShort, callback([:pointer], :pointer),
+           :createNullableInt, callback([:pointer], :pointer),
+           :createNullableLong, callback([:pointer], :pointer),
+           :createNullableFloat, callback([:pointer], :pointer),
+           :createNullableDouble, callback([:pointer], :pointer),
+           :createNullableChar, callback([:pointer], :pointer),
+           :createNullableBoolean, callback([:pointer], :pointer),
+           :createNullableUnit, callback([], :pointer),
+           :kotlin, Kotlin
+  end
+
+  attach_function :libevaluation_interop_symbols, [], Libevaluation_interop_ExportedSymbols.by_ref
+end
+
+def evaluation(rule_json, user_json)
+  lib = EvaluationInterop.libevaluation_interop_symbols()
+  fn = lib[:kotlin][:root][:evaluate]
+  evaluation_result = fn.call(rule_json, user_json)
+  evaluation_result.read_string
+end
+# rubocop:disable all

data/lib/experiment/local/evaluation/lib/linuxArm64/libevaluation_interop_api.h

@@ -0,0 +1,82 @@
+#ifndef KONAN_LIBEVALUATION_INTEROP_H
+#define KONAN_LIBEVALUATION_INTEROP_H
+#ifdef __cplusplus
+extern "C" {
+#endif
+#ifdef __cplusplus
+typedef bool            libevaluation_interop_KBoolean;
+#else
+typedef _Bool           libevaluation_interop_KBoolean;
+#endif
+typedef unsigned short     libevaluation_interop_KChar;
+typedef signed char        libevaluation_interop_KByte;
+typedef short              libevaluation_interop_KShort;
+typedef int                libevaluation_interop_KInt;
+typedef long long          libevaluation_interop_KLong;
+typedef unsigned char      libevaluation_interop_KUByte;
+typedef unsigned short     libevaluation_interop_KUShort;
+typedef unsigned int       libevaluation_interop_KUInt;
+typedef unsigned long long libevaluation_interop_KULong;
+typedef float              libevaluation_interop_KFloat;
+typedef double             libevaluation_interop_KDouble;
+typedef float __attribute__ ((__vector_size__ (16))) libevaluation_interop_KVector128;
+typedef void*              libevaluation_interop_KNativePtr;
+struct libevaluation_interop_KType;
+typedef struct libevaluation_interop_KType libevaluation_interop_KType;
+
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Byte;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Short;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Int;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Long;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Float;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Double;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Char;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Boolean;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Unit;
+
+
+typedef struct {
+  /* Service functions. */
+  void (*DisposeStablePointer)(libevaluation_interop_KNativePtr ptr);
+  void (*DisposeString)(const char* string);
+  libevaluation_interop_KBoolean (*IsInstance)(libevaluation_interop_KNativePtr ref, const libevaluation_interop_KType* type);
+  libevaluation_interop_kref_kotlin_Byte (*createNullableByte)(libevaluation_interop_KByte);
+  libevaluation_interop_kref_kotlin_Short (*createNullableShort)(libevaluation_interop_KShort);
+  libevaluation_interop_kref_kotlin_Int (*createNullableInt)(libevaluation_interop_KInt);
+  libevaluation_interop_kref_kotlin_Long (*createNullableLong)(libevaluation_interop_KLong);
+  libevaluation_interop_kref_kotlin_Float (*createNullableFloat)(libevaluation_interop_KFloat);
+  libevaluation_interop_kref_kotlin_Double (*createNullableDouble)(libevaluation_interop_KDouble);
+  libevaluation_interop_kref_kotlin_Char (*createNullableChar)(libevaluation_interop_KChar);
+  libevaluation_interop_kref_kotlin_Boolean (*createNullableBoolean)(libevaluation_interop_KBoolean);
+  libevaluation_interop_kref_kotlin_Unit (*createNullableUnit)(void);
+
+  /* User functions. */
+  struct {
+    struct {
+      const char* (*evaluate)(const char* rules, const char* user);
+    } root;
+  } kotlin;
+} libevaluation_interop_ExportedSymbols;
+extern libevaluation_interop_ExportedSymbols* libevaluation_interop_symbols(void);
+#ifdef __cplusplus
+}  /* extern "C" */
+#endif
+#endif  /* KONAN_LIBEVALUATION_INTEROP_H */

data/lib/experiment/local/evaluation/lib/linuxX64/libevaluation_interop_api.h

@@ -0,0 +1,82 @@
+#ifndef KONAN_LIBEVALUATION_INTEROP_H
+#define KONAN_LIBEVALUATION_INTEROP_H
+#ifdef __cplusplus
+extern "C" {
+#endif
+#ifdef __cplusplus
+typedef bool            libevaluation_interop_KBoolean;
+#else
+typedef _Bool           libevaluation_interop_KBoolean;
+#endif
+typedef unsigned short     libevaluation_interop_KChar;
+typedef signed char        libevaluation_interop_KByte;
+typedef short              libevaluation_interop_KShort;
+typedef int                libevaluation_interop_KInt;
+typedef long long          libevaluation_interop_KLong;
+typedef unsigned char      libevaluation_interop_KUByte;
+typedef unsigned short     libevaluation_interop_KUShort;
+typedef unsigned int       libevaluation_interop_KUInt;
+typedef unsigned long long libevaluation_interop_KULong;
+typedef float              libevaluation_interop_KFloat;
+typedef double             libevaluation_interop_KDouble;
+typedef float __attribute__ ((__vector_size__ (16))) libevaluation_interop_KVector128;
+typedef void*              libevaluation_interop_KNativePtr;
+struct libevaluation_interop_KType;
+typedef struct libevaluation_interop_KType libevaluation_interop_KType;
+
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Byte;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Short;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Int;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Long;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Float;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Double;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Char;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Boolean;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Unit;
+
+
+typedef struct {
+  /* Service functions. */
+  void (*DisposeStablePointer)(libevaluation_interop_KNativePtr ptr);
+  void (*DisposeString)(const char* string);
+  libevaluation_interop_KBoolean (*IsInstance)(libevaluation_interop_KNativePtr ref, const libevaluation_interop_KType* type);
+  libevaluation_interop_kref_kotlin_Byte (*createNullableByte)(libevaluation_interop_KByte);
+  libevaluation_interop_kref_kotlin_Short (*createNullableShort)(libevaluation_interop_KShort);
+  libevaluation_interop_kref_kotlin_Int (*createNullableInt)(libevaluation_interop_KInt);
+  libevaluation_interop_kref_kotlin_Long (*createNullableLong)(libevaluation_interop_KLong);
+  libevaluation_interop_kref_kotlin_Float (*createNullableFloat)(libevaluation_interop_KFloat);
+  libevaluation_interop_kref_kotlin_Double (*createNullableDouble)(libevaluation_interop_KDouble);
+  libevaluation_interop_kref_kotlin_Char (*createNullableChar)(libevaluation_interop_KChar);
+  libevaluation_interop_kref_kotlin_Boolean (*createNullableBoolean)(libevaluation_interop_KBoolean);
+  libevaluation_interop_kref_kotlin_Unit (*createNullableUnit)(void);
+
+  /* User functions. */
+  struct {
+    struct {
+      const char* (*evaluate)(const char* rules, const char* user);
+    } root;
+  } kotlin;
+} libevaluation_interop_ExportedSymbols;
+extern libevaluation_interop_ExportedSymbols* libevaluation_interop_symbols(void);
+#ifdef __cplusplus
+}  /* extern "C" */
+#endif
+#endif  /* KONAN_LIBEVALUATION_INTEROP_H */

data/lib/experiment/local/evaluation/lib/macosArm64/libevaluation_interop_api.h

@@ -0,0 +1,82 @@
+#ifndef KONAN_LIBEVALUATION_INTEROP_H
+#define KONAN_LIBEVALUATION_INTEROP_H
+#ifdef __cplusplus
+extern "C" {
+#endif
+#ifdef __cplusplus
+typedef bool            libevaluation_interop_KBoolean;
+#else
+typedef _Bool           libevaluation_interop_KBoolean;
+#endif
+typedef unsigned short     libevaluation_interop_KChar;
+typedef signed char        libevaluation_interop_KByte;
+typedef short              libevaluation_interop_KShort;
+typedef int                libevaluation_interop_KInt;
+typedef long long          libevaluation_interop_KLong;
+typedef unsigned char      libevaluation_interop_KUByte;
+typedef unsigned short     libevaluation_interop_KUShort;
+typedef unsigned int       libevaluation_interop_KUInt;
+typedef unsigned long long libevaluation_interop_KULong;
+typedef float              libevaluation_interop_KFloat;
+typedef double             libevaluation_interop_KDouble;
+typedef float __attribute__ ((__vector_size__ (16))) libevaluation_interop_KVector128;
+typedef void*              libevaluation_interop_KNativePtr;
+struct libevaluation_interop_KType;
+typedef struct libevaluation_interop_KType libevaluation_interop_KType;
+
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Byte;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Short;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Int;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Long;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Float;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Double;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Char;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Boolean;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Unit;
+
+
+typedef struct {
+  /* Service functions. */
+  void (*DisposeStablePointer)(libevaluation_interop_KNativePtr ptr);
+  void (*DisposeString)(const char* string);
+  libevaluation_interop_KBoolean (*IsInstance)(libevaluation_interop_KNativePtr ref, const libevaluation_interop_KType* type);
+  libevaluation_interop_kref_kotlin_Byte (*createNullableByte)(libevaluation_interop_KByte);
+  libevaluation_interop_kref_kotlin_Short (*createNullableShort)(libevaluation_interop_KShort);
+  libevaluation_interop_kref_kotlin_Int (*createNullableInt)(libevaluation_interop_KInt);
+  libevaluation_interop_kref_kotlin_Long (*createNullableLong)(libevaluation_interop_KLong);
+  libevaluation_interop_kref_kotlin_Float (*createNullableFloat)(libevaluation_interop_KFloat);
+  libevaluation_interop_kref_kotlin_Double (*createNullableDouble)(libevaluation_interop_KDouble);
+  libevaluation_interop_kref_kotlin_Char (*createNullableChar)(libevaluation_interop_KChar);
+  libevaluation_interop_kref_kotlin_Boolean (*createNullableBoolean)(libevaluation_interop_KBoolean);
+  libevaluation_interop_kref_kotlin_Unit (*createNullableUnit)(void);
+
+  /* User functions. */
+  struct {
+    struct {
+      const char* (*evaluate)(const char* rules, const char* user);
+    } root;
+  } kotlin;
+} libevaluation_interop_ExportedSymbols;
+extern libevaluation_interop_ExportedSymbols* libevaluation_interop_symbols(void);
+#ifdef __cplusplus
+}  /* extern "C" */
+#endif
+#endif  /* KONAN_LIBEVALUATION_INTEROP_H */

data/lib/experiment/local/evaluation/lib/macosX64/libevaluation_interop_api.h

@@ -0,0 +1,82 @@
+#ifndef KONAN_LIBEVALUATION_INTEROP_H
+#define KONAN_LIBEVALUATION_INTEROP_H
+#ifdef __cplusplus
+extern "C" {
+#endif
+#ifdef __cplusplus
+typedef bool            libevaluation_interop_KBoolean;
+#else
+typedef _Bool           libevaluation_interop_KBoolean;
+#endif
+typedef unsigned short     libevaluation_interop_KChar;
+typedef signed char        libevaluation_interop_KByte;
+typedef short              libevaluation_interop_KShort;
+typedef int                libevaluation_interop_KInt;
+typedef long long          libevaluation_interop_KLong;
+typedef unsigned char      libevaluation_interop_KUByte;
+typedef unsigned short     libevaluation_interop_KUShort;
+typedef unsigned int       libevaluation_interop_KUInt;
+typedef unsigned long long libevaluation_interop_KULong;
+typedef float              libevaluation_interop_KFloat;
+typedef double             libevaluation_interop_KDouble;
+typedef float __attribute__ ((__vector_size__ (16))) libevaluation_interop_KVector128;
+typedef void*              libevaluation_interop_KNativePtr;
+struct libevaluation_interop_KType;
+typedef struct libevaluation_interop_KType libevaluation_interop_KType;
+
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Byte;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Short;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Int;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Long;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Float;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Double;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Char;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Boolean;
+typedef struct {
+  libevaluation_interop_KNativePtr pinned;
+} libevaluation_interop_kref_kotlin_Unit;
+
+
+typedef struct {
+  /* Service functions. */
+  void (*DisposeStablePointer)(libevaluation_interop_KNativePtr ptr);
+  void (*DisposeString)(const char* string);
+  libevaluation_interop_KBoolean (*IsInstance)(libevaluation_interop_KNativePtr ref, const libevaluation_interop_KType* type);
+  libevaluation_interop_kref_kotlin_Byte (*createNullableByte)(libevaluation_interop_KByte);
+  libevaluation_interop_kref_kotlin_Short (*createNullableShort)(libevaluation_interop_KShort);
+  libevaluation_interop_kref_kotlin_Int (*createNullableInt)(libevaluation_interop_KInt);
+  libevaluation_interop_kref_kotlin_Long (*createNullableLong)(libevaluation_interop_KLong);
+  libevaluation_interop_kref_kotlin_Float (*createNullableFloat)(libevaluation_interop_KFloat);
+  libevaluation_interop_kref_kotlin_Double (*createNullableDouble)(libevaluation_interop_KDouble);
+  libevaluation_interop_kref_kotlin_Char (*createNullableChar)(libevaluation_interop_KChar);
+  libevaluation_interop_kref_kotlin_Boolean (*createNullableBoolean)(libevaluation_interop_KBoolean);
+  libevaluation_interop_kref_kotlin_Unit (*createNullableUnit)(void);
+
+  /* User functions. */
+  struct {
+    struct {
+      const char* (*evaluate)(const char* rules, const char* user);
+    } root;
+  } kotlin;
+} libevaluation_interop_ExportedSymbols;
+extern libevaluation_interop_ExportedSymbols* libevaluation_interop_symbols(void);
+#ifdef __cplusplus
+}  /* extern "C" */
+#endif
+#endif  /* KONAN_LIBEVALUATION_INTEROP_H */

data/lib/experiment/local/fetcher.rb

@@ -0,0 +1,45 @@
+module AmplitudeExperiment
+  # LocalEvaluationFetcher
+  # Fetch local evaluation mode flag configs from the Experiment API server.
+  # These flag configs can be used to perform local evaluation.
+  class LocalEvaluationFetcher
+    FLAG_CONFIG_TIMEOUT = 5000
+
+    def initialize(api_key, debug, server_url = 'https://api.lab.amplitude.com')
+      @api_key = api_key
+      @uri = "#{server_url}/sdk/rules?eval_mode=local"
+      @debug = debug
+      @http =  PersistentHttpClient.get(@uri, { read_timeout: FLAG_CONFIG_TIMEOUT })
+    end
+
+    # Fetch local evaluation mode flag configs from the Experiment API server.
+    # These flag configs can be used to perform local evaluation.
+    #
+    # @return [Hash] The flag configs
+    def fetch
+      # fetch flag_configs
+      headers = {
+        'Authorization' => "Api-Key #{@api_key}",
+        'Content-Type' => 'application/json;charset=utf-8'
+      }
+      request = Net::HTTP::Get.new(@uri, headers)
+      response = @http.request(request)
+      raise `flagConfigs - received error response: #{response.code}: #{response.body}` unless response.is_a?(Net::HTTPOK)
+
+      flag_configs = parse(response.body)
+      @logger.debug("[Experiment] Fetch flag configs: #{request.body}") if @debug
+      flag_configs
+    end
+
+    private
+
+    def parse(flag_configs_str)
+      flag_config_obj = {}
+      flag_configs_array = JSON.parse(flag_configs_str)
+      flag_configs_array.each do |flag_config|
+        flag_config_obj.store(flag_config['flagKey'], flag_config) if flag_config.key?('flagKey')
+      end
+      flag_config_obj
+    end
+  end
+end

data/lib/experiment/local/poller.rb

@@ -0,0 +1,48 @@
+module AmplitudeExperiment
+  # FlagConfigPoller
+  # update the flag_config cache value
+  class FlagConfigPoller
+    FLAG_CONFIG_POLLING_INTERVAL_MILLIS = 30_000
+
+    def initialize(fetcher, cache, debug, poll_interval_millis: FLAG_CONFIG_POLLING_INTERVAL_MILLIS)
+      @fetcher = fetcher
+      @cache = cache
+      @poll_interval_millis = poll_interval_millis
+      @logger = Logger.new($stdout)
+      @debug = debug
+      @poller_thread = nil
+      @is_running = false
+    end
+
+    # Fetch initial flag configurations and start polling for updates.
+    # You must call this function to begin polling for flag config updates.
+    # Calling this function while the poller is already running does nothing.
+    def start
+      return if @is_running
+
+      @logger.debug('[Experiment] poller - start') if @debug
+      run
+    end
+
+    # Stop polling for flag configurations.
+    # Calling this function while the poller is not running will do nothing.
+    def stop
+      @poller_thread&.exit
+      @is_running = false
+      @poller_thread = nil
+    end
+
+    private
+
+    def run
+      @is_running = true
+      flag_configs = @fetcher.fetch
+      @cache.clear
+      @cache.put_all(flag_configs)
+      @poller_thread = Thread.new do
+        sleep @poll_interval_millis
+        run
+      end
+    end
+  end
+end

data/lib/experiment/{client.rb → remote/client.rb}

@@ -5,14 +5,14 @@ require 'logger'
 
 module AmplitudeExperiment
   # Main client for fetching variant data.
-  class Client
+  class RemoteEvaluationClient
     # Creates a new Experiment Client instance.
     #
     # @param [String] api_key The environment API Key
     # @param [Config] config
     def initialize(api_key, config = nil)
       @api_key = api_key
-      @config = config || Config.new
+      @config = config || RemoteEvaluationConfig.new
       @logger = Logger.new($stdout)
       @logger.level = if @config.debug
                         Logger::DEBUG

data/lib/experiment/{config.rb → remote/config.rb}

@@ -1,6 +1,6 @@
 module AmplitudeExperiment
   # Configuration
-  class Config
+  class RemoteEvaluationConfig
     # Default server url
     DEFAULT_SERVER_URL = 'https://api.lab.amplitude.com'.freeze
 

data/lib/experiment/version.rb

@@ -1,3 +1,3 @@
 module AmplitudeExperiment
-  VERSION = '1.0.0.beta.6'.freeze
+  VERSION = '1.0.0.beta.9'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amplitude-experiment
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta.6
+  version: 1.0.0.beta.9
 platform: ruby
 authors:
 - Amplitude
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-17 00:00:00.000000000 Z
+date: 2022-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.15.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.15.5
 description: Amplitude Experiment Ruby Server SDK
 email:
 - sdk@amplitude.com
@@ -119,11 +133,25 @@ files:
 - Gemfile
 - README.md
 - lib/amplitude-experiment.rb
-- lib/experiment/client.rb
-- lib/experiment/config.rb
 - lib/experiment/cookie.rb
 - lib/experiment/factory.rb
+- lib/experiment/local/cache.rb
+- lib/experiment/local/client.rb
+- lib/experiment/local/config.rb
+- lib/experiment/local/evaluation/evaluation.rb
+- lib/experiment/local/evaluation/lib/linuxArm64/libevaluation_interop.so
+- lib/experiment/local/evaluation/lib/linuxArm64/libevaluation_interop_api.h
+- lib/experiment/local/evaluation/lib/linuxX64/libevaluation_interop.so
+- lib/experiment/local/evaluation/lib/linuxX64/libevaluation_interop_api.h
+- lib/experiment/local/evaluation/lib/macosArm64/libevaluation_interop.dylib
+- lib/experiment/local/evaluation/lib/macosArm64/libevaluation_interop_api.h
+- lib/experiment/local/evaluation/lib/macosX64/libevaluation_interop.dylib
+- lib/experiment/local/evaluation/lib/macosX64/libevaluation_interop_api.h
+- lib/experiment/local/fetcher.rb
+- lib/experiment/local/poller.rb
 - lib/experiment/persistent_http_client.rb
+- lib/experiment/remote/client.rb
+- lib/experiment/remote/config.rb
 - lib/experiment/user.rb
 - lib/experiment/variant.rb
 - lib/experiment/version.rb