devcycle-ruby-server-sdk 3.6.2 → 3.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 914b4bf9e916b2796dcd6ce88be3ecf784b074fd30784bf8f28e2156b0bd8c66
-  data.tar.gz: dc4a335584b6618b4664203460530bc4421232dfdcc6362399694d7278f34bee
+  metadata.gz: 5b3044307e6ee4e30c1a53aeac3d62eceaaac8ea86fc380b1a41bbf15294ce98
+  data.tar.gz: 3fdb48a7217e4390bfe4f53f2e438324803cd9bc8b32a2f91c31a7e7783a32bf
 SHA512:
-  metadata.gz: 6ca7f4b518dfa6bbd6ffa817263df4f625e7583a2ea61ad6b6ead5cd10ce12f2f586e205e457c39dc9d86831aadfd8e1ce7f1346c02362b1427bce7768a9fac0
-  data.tar.gz: 2d35f58deaa7a1309d8cb1aa6c5e7002e96e957f920d64d49d14a11e03a108051c679fc521acb451c1cd90a5dc32e9caa1754c92f308efecf592cd87da8cb78b
+  metadata.gz: af96f97ff9a13800b415f59777446ea075535e24959939e737b845599201c6b1d8ddce1d170b099837ee2d2b91dee7039b8354298f009df0e2e0eeb0d731c071
+  data.tar.gz: 021bfd22df2c904f03e4e089387a8914b078e9b70d237f12551cfd036665120cba7df2ba3f09b1df62177b6fd9e1b576f7e75c23415880da4c54c8705445eee8

data/Gemfile

@@ -15,4 +15,5 @@ group :development, :test do
   gem 'rake', '~> 13.0.1'
   gem 'pry-byebug'
   gem 'rubocop', '~> 1.57.1'
+  gem 'webmock'
 end

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Taplytics Inc.
+Copyright (c) 2025 Taplytics Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/devcycle-ruby-server-sdk.gemspec

@@ -24,13 +24,13 @@ Gem::Specification.new do |s|
   s.required_ruby_version = ">= 3.2"
 
   s.add_runtime_dependency 'typhoeus', '~> 1.0', '>= 1.0.1'
-  s.add_runtime_dependency 'wasmtime', '20.0.2'
+  s.add_runtime_dependency 'wasmtime', '39.0.1'
   s.add_runtime_dependency 'concurrent-ruby', '~> 1.2.0'
   s.add_runtime_dependency 'sorbet-runtime', '>= 0.5.11481'
   s.add_runtime_dependency 'oj', '~> 3.0'
   s.add_runtime_dependency 'google-protobuf', '~> 3.22'
   s.add_runtime_dependency 'ld-eventsource', '~> 2.2.3'
-  s.add_runtime_dependency 'openfeature-sdk', '~> 0.4.0'
+  s.add_runtime_dependency 'openfeature-sdk', '~> 0.4.1'
 
   s.add_development_dependency 'rspec', '~> 3.6', '>= 3.6.0'
 

data/lib/devcycle-ruby-server-sdk/api/client.rb

@@ -195,6 +195,7 @@ module DevCycle
           value = default
           type = determine_variable_type(default)
           defaulted = true
+          eval = { reason: DevCycle::EVAL_REASONS::DEFAULT, details: DevCycle::DEFAULT_REASON_DETAILS::USER_NOT_TARGETED }
           if local_bucketing_initialized? && @local_bucketing.has_config
             type_code = variable_type_code_from_type(type)
             variable_pb = variable_for_user_pb(user, key, type_code)
@@ -202,9 +203,11 @@ module DevCycle
               value = get_variable_value(variable_pb)
               defaulted = false
             end
+            eval = get_eval_reason(variable_pb)
           else
+            eval = { reason: DevCycle::EVAL_REASONS::DEFAULT, details: DevCycle::DEFAULT_REASON_DETAILS::MISSING_CONFIG }
             @logger.warn("Local bucketing not initialized, returning default value for variable #{key}")
-            variable_event = Event.new({ type: DevCycle::EventTypes[:agg_variable_defaulted], target: key })
+            variable_event = Event.new({ type: DevCycle::EventTypes[:agg_variable_defaulted], target: key, metaData: { evalReason: DevCycle::EVAL_REASONS::DEFAULT }})
             bucketed_config = BucketedUserConfig.new({}, {}, {}, {}, {}, {}, [])
             @event_queue.queue_aggregate_event(variable_event, bucketed_config)
           end
@@ -214,7 +217,8 @@ module DevCycle
             value: value,
             type: type,
             defaultValue: default,
-            isDefaulted: defaulted
+            isDefaulted: defaulted,
+            eval: eval
           })
         end
 
@@ -321,14 +325,27 @@ module DevCycle
         if @api_client.config.debugging
           @api_client.config.logger.debug "API called: DevCycle::Client#variable\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
         end
+        if default && data.type
+          api_type_to_ruby_class = {
+            'Boolean' => [TrueClass, FalseClass],
+            'Number' => [Integer, Float],
+            'String' => [String],
+            'JSON' => [Hash]
+          }
+          ruby_classes = api_type_to_ruby_class[data.type.to_s]
+          unless ruby_classes && ruby_classes.any? { |klass| default.is_a?(klass) }
+            eval = { reason: DevCycle::EVAL_REASONS::DEFAULT, details: DevCycle::DEFAULT_REASON_DETAILS::TYPE_MISMATCH }
+            return Variable.new(key: key, value: default, isDefaulted: true, eval: eval)
+          end
+        end
         return data
       rescue ApiError => error
         if error.code != 404
           @api_client.config.logger.error("Failed to retrieve variable value: #{error.message}")
         end
 
-        return Variable.new(key: key, value: default, isDefaulted: true)
-      end
+        return Variable.new(key: key, value: default, isDefaulted: true, eval: { reason: DevCycle::EVAL_REASONS::DEFAULT, details: DevCycle::DEFAULT_REASON_DETAILS::ERROR })
+      end 
     end
 
     # Get all variables by key for user data
@@ -574,6 +591,18 @@ module DevCycle
       end
     end
 
+    def get_eval_reason(variable_pb)
+      if variable_pb.nil?
+        { reason: DevCycle::EVAL_REASONS::DEFAULT, details: DevCycle::DEFAULT_REASON_DETAILS::USER_NOT_TARGETED}
+      else
+        if variable_pb.eval.nil?
+          { reason: DevCycle::EVAL_REASONS::DEFAULT, details: DevCycle::DEFAULT_REASON_DETAILS::USER_NOT_TARGETED }
+        else
+          { reason: variable_pb.eval.reason, details: variable_pb.eval.details, target_id: variable_pb.eval.target_id }
+        end
+      end
+    end
+
     # Adds an eval hook to the client
     # @param [EvalHook] eval_hook The eval hook to add
     # @return [void]

data/lib/devcycle-ruby-server-sdk/api/dev_cycle_provider.rb

@@ -32,7 +32,16 @@ module DevCycle
     end
 
     def fetch_integer_value(flag_key:, default_value:, evaluation_context: nil)
-      @client.variable(Provider.user_from_openfeature_context(evaluation_context), flag_key, default_value)
+      variable = @client.variable(Provider.user_from_openfeature_context(evaluation_context), flag_key, default_value)
+
+      Variable.new(
+        key: variable.key,
+        type: variable.type,
+        value: variable.value.to_i,
+        defaultValue: variable.defaultValue,
+        isDefaulted: variable.isDefaulted,
+        eval: variable.eval
+      )
     end
 
     def fetch_float_value(flag_key:, default_value:, evaluation_context: nil)

data/lib/devcycle-ruby-server-sdk/eval_reasons.rb

@@ -0,0 +1,16 @@
+module DevCycle
+  # Evaluation reasons for successful evaluations
+  module EVAL_REASONS
+    DEFAULT = 'DEFAULT'
+    ERROR = 'ERROR'
+  end
+
+  # Default reason details
+  module DEFAULT_REASON_DETAILS
+    MISSING_CONFIG = 'Missing Config'
+    USER_NOT_TARGETED = 'User Not Targeted'
+    TYPE_MISMATCH = 'Variable Type Mismatch'
+    MISSING_VARIABLE = 'Missing Variable'
+    ERROR = 'Error'
+  end
+end

data/lib/devcycle-ruby-server-sdk/localbucketing/local_bucketing.rb

@@ -27,14 +27,14 @@ module DevCycle
     # added to ensure that there is no processes deadlock when compiling wasm before forking
 
     @@wasmmodule = Wasmtime::Module.from_file(@@engine, "#{__dir__}/bucketing-lib.release.wasm")
-    @@wasi_ctx = Wasmtime::WasiCtxBuilder.new
-                                         .inherit_stdout
-                                         .inherit_stderr
-                                         .set_argv(ARGV)
-                                         .set_env(ENV)
-                                         .build
-    @@store = Wasmtime::Store.new(@@engine, wasi_ctx: @@wasi_ctx)
-    @@linker = Wasmtime::Linker.new(@@engine, wasi: true)
+    @@wasi_config = Wasmtime::WasiConfig.new
+                                        .inherit_stdout
+                                        .inherit_stderr
+                                        .set_argv(ARGV)
+                                        .set_env(ENV)
+    @@store = Wasmtime::Store.new(@@engine, wasi_p1_config: @@wasi_config)
+    @@linker = Wasmtime::Linker.new(@@engine)
+    Wasmtime::WASI::P1.add_to_linker_sync(@@linker)
 
     @@linker.func_new("env", "Date.now", [], [:f64]) do |_caller|
       DateTime.now.strftime("%Q").to_i

data/lib/devcycle-ruby-server-sdk/localbucketing/proto/variableForUserParams.proto

@@ -66,4 +66,12 @@ message SDKVariable_PB {
   double doubleValue = 5;
   string stringValue = 6;
   NullableString evalReason = 7;
+  NullableString _feature = 8; 
+  EvalReason_PB eval = 9;
 }
+
+message EvalReason_PB {
+  string reason = 1;
+  string details = 2;
+  string target_id = 3;
+}

data/lib/devcycle-ruby-server-sdk/localbucketing/proto/variableForUserParams_pb.rb

@@ -1,69 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: variableForUserParams.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("variableForUserParams.proto", :syntax => :proto3) do
-    add_message "proto.NullableString" do
-      optional :value, :string, 1
-      optional :isNull, :bool, 2
-    end
-    add_message "proto.NullableDouble" do
-      optional :value, :double, 1
-      optional :isNull, :bool, 2
-    end
-    add_message "proto.CustomDataValue" do
-      optional :type, :enum, 1, "proto.CustomDataType"
-      optional :boolValue, :bool, 2
-      optional :doubleValue, :double, 3
-      optional :stringValue, :string, 4
-    end
-    add_message "proto.NullableCustomData" do
-      map :value, :string, :message, 1, "proto.CustomDataValue"
-      optional :isNull, :bool, 2
-    end
-    add_message "proto.VariableForUserParams_PB" do
-      optional :sdkKey, :string, 1
-      optional :variableKey, :string, 2
-      optional :variableType, :enum, 3, "proto.VariableType_PB"
-      optional :user, :message, 4, "proto.DVCUser_PB"
-      optional :shouldTrackEvent, :bool, 5
-    end
-    add_message "proto.DVCUser_PB" do
-      optional :user_id, :string, 1
-      optional :email, :message, 2, "proto.NullableString"
-      optional :name, :message, 3, "proto.NullableString"
-      optional :language, :message, 4, "proto.NullableString"
-      optional :country, :message, 5, "proto.NullableString"
-      optional :appBuild, :message, 6, "proto.NullableDouble"
-      optional :appVersion, :message, 7, "proto.NullableString"
-      optional :deviceModel, :message, 8, "proto.NullableString"
-      optional :customData, :message, 9, "proto.NullableCustomData"
-      optional :privateCustomData, :message, 10, "proto.NullableCustomData"
-    end
-    add_message "proto.SDKVariable_PB" do
-      optional :_id, :string, 1
-      optional :type, :enum, 2, "proto.VariableType_PB"
-      optional :key, :string, 3
-      optional :boolValue, :bool, 4
-      optional :doubleValue, :double, 5
-      optional :stringValue, :string, 6
-      optional :evalReason, :message, 7, "proto.NullableString"
-    end
-    add_enum "proto.VariableType_PB" do
-      value :Boolean, 0
-      value :Number, 1
-      value :String, 2
-      value :JSON, 3
-    end
-    add_enum "proto.CustomDataType" do
-      value :Bool, 0
-      value :Num, 1
-      value :Str, 2
-      value :Null, 3
+
+descriptor_data = "\n\x1bvariableForUserParams.proto\x12\x05proto\"/\n\x0eNullableString\x12\r\n\x05value\x18\x01 \x01(\t\x12\x0e\n\x06isNull\x18\x02 \x01(\x08\"/\n\x0eNullableDouble\x12\r\n\x05value\x18\x01 \x01(\x01\x12\x0e\n\x06isNull\x18\x02 \x01(\x08\"s\n\x0f\x43ustomDataValue\x12#\n\x04type\x18\x01 \x01(\x0e\x32\x15.proto.CustomDataType\x12\x11\n\tboolValue\x18\x02 \x01(\x08\x12\x13\n\x0b\x64oubleValue\x18\x03 \x01(\x01\x12\x13\n\x0bstringValue\x18\x04 \x01(\t\"\x9f\x01\n\x12NullableCustomData\x12\x33\n\x05value\x18\x01 \x03(\x0b\x32$.proto.NullableCustomData.ValueEntry\x12\x0e\n\x06isNull\x18\x02 \x01(\x08\x1a\x44\n\nValueEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.proto.CustomDataValue:\x02\x38\x01\"\xa8\x01\n\x18VariableForUserParams_PB\x12\x0e\n\x06sdkKey\x18\x01 \x01(\t\x12\x13\n\x0bvariableKey\x18\x02 \x01(\t\x12,\n\x0cvariableType\x18\x03 \x01(\x0e\x32\x16.proto.VariableType_PB\x12\x1f\n\x04user\x18\x04 \x01(\x0b\x32\x11.proto.DVCUser_PB\x12\x18\n\x10shouldTrackEvent\x18\x05 \x01(\x08\"\x9e\x03\n\nDVCUser_PB\x12\x0f\n\x07user_id\x18\x01 \x01(\t\x12$\n\x05\x65mail\x18\x02 \x01(\x0b\x32\x15.proto.NullableString\x12#\n\x04name\x18\x03 \x01(\x0b\x32\x15.proto.NullableString\x12\'\n\x08language\x18\x04 \x01(\x0b\x32\x15.proto.NullableString\x12&\n\x07\x63ountry\x18\x05 \x01(\x0b\x32\x15.proto.NullableString\x12\'\n\x08\x61ppBuild\x18\x06 \x01(\x0b\x32\x15.proto.NullableDouble\x12)\n\nappVersion\x18\x07 \x01(\x0b\x32\x15.proto.NullableString\x12*\n\x0b\x64\x65viceModel\x18\x08 \x01(\x0b\x32\x15.proto.NullableString\x12-\n\ncustomData\x18\t \x01(\x0b\x32\x19.proto.NullableCustomData\x12\x34\n\x11privateCustomData\x18\n \x01(\x0b\x32\x19.proto.NullableCustomData\"\x85\x02\n\x0eSDKVariable_PB\x12\x0b\n\x03_id\x18\x01 \x01(\t\x12$\n\x04type\x18\x02 \x01(\x0e\x32\x16.proto.VariableType_PB\x12\x0b\n\x03key\x18\x03 \x01(\t\x12\x11\n\tboolValue\x18\x04 \x01(\x08\x12\x13\n\x0b\x64oubleValue\x18\x05 \x01(\x01\x12\x13\n\x0bstringValue\x18\x06 \x01(\t\x12)\n\nevalReason\x18\x07 \x01(\x0b\x32\x15.proto.NullableString\x12\'\n\x08_feature\x18\x08 \x01(\x0b\x32\x15.proto.NullableString\x12\"\n\x04\x65val\x18\t \x01(\x0b\x32\x14.proto.EvalReason_PB\"C\n\rEvalReason_PB\x12\x0e\n\x06reason\x18\x01 \x01(\t\x12\x0f\n\x07\x64\x65tails\x18\x02 \x01(\t\x12\x11\n\ttarget_id\x18\x03 \x01(\t*@\n\x0fVariableType_PB\x12\x0b\n\x07\x42oolean\x10\x00\x12\n\n\x06Number\x10\x01\x12\n\n\x06String\x10\x02\x12\x08\n\x04JSON\x10\x03*6\n\x0e\x43ustomDataType\x12\x08\n\x04\x42ool\x10\x00\x12\x07\n\x03Num\x10\x01\x12\x07\n\x03Str\x10\x02\x12\x08\n\x04Null\x10\x03\x62\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Proto
@@ -74,6 +39,7 @@ module Proto
   VariableForUserParams_PB = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("proto.VariableForUserParams_PB").msgclass
   DVCUser_PB = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("proto.DVCUser_PB").msgclass
   SDKVariable_PB = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("proto.SDKVariable_PB").msgclass
+  EvalReason_PB = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("proto.EvalReason_PB").msgclass
   VariableType_PB = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("proto.VariableType_PB").enummodule
   CustomDataType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("proto.CustomDataType").enummodule
 end

data/lib/devcycle-ruby-server-sdk/localbucketing/update_wasm.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-BUCKETING_LIB_VERSION="1.35.1"
+BUCKETING_LIB_VERSION="1.41.0"
 WAT_DOWNLOAD=0
 rm bucketing-lib.release.wasm
-wget "https://unpkg.com/@devcycle/bucketing-assembly-script@$BUCKETING_LIB_VERSION/build/bucketing-lib.release.wasm"
+wget "https://unpkg.com/@devcycle/bucketing-assembly-script@$BUCKETING_LIB_VERSION/build/bucketing-lib.release.wasm"

data/lib/devcycle-ruby-server-sdk/models/variable.rb

@@ -29,6 +29,9 @@ module DevCycle
 
     attr_accessor :defaultValue
 
+    # Variable evaluation details
+    attr_accessor :eval
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -58,7 +61,8 @@ module DevCycle
         :'type' => :'type',
         :'value' => :'value',
         :'defaultValue' => :'defaultValue',
-        :'isDefaulted' => :'isDefaulted'
+        :'isDefaulted' => :'isDefaulted',
+        :'eval' => :'eval'
       }
     end
 
@@ -74,7 +78,8 @@ module DevCycle
         :'type' => :'String',
         :'value' => :'Object',
         :'defaultValue' => :'Object',
-        :'isDefaulted' => :'Boolean'
+        :'isDefaulted' => :'Boolean',
+        :'eval' => :'Object'
       }
     end
 
@@ -120,6 +125,10 @@ module DevCycle
       if attributes.key?(:'defaultValue')
         self.defaultValue = attributes[:'defaultValue']
       end
+
+      if attributes.key?(:'eval')
+        self.eval = attributes[:'eval']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?

data/lib/devcycle-ruby-server-sdk/version.rb

@@ -1,3 +1,3 @@
 module DevCycle
-  VERSION = '3.6.2'
+  VERSION = '3.8.0'
 end

data/lib/devcycle-ruby-server-sdk.rb

@@ -29,6 +29,7 @@ require 'devcycle-ruby-server-sdk/models/variable'
 require 'devcycle-ruby-server-sdk/eval_hooks_runner'
 require 'devcycle-ruby-server-sdk/models/eval_hook'
 require 'devcycle-ruby-server-sdk/models/eval_hook_context'
+require 'devcycle-ruby-server-sdk/eval_reasons'
 
 # APIs
 require 'devcycle-ruby-server-sdk/api/client'

data/spec/api/devcycle_api_spec.rb

@@ -12,6 +12,9 @@ OpenAPI Generator version: 5.3.0
 
 require 'spec_helper'
 require 'json'
+require 'webmock'
+
+include WebMock::API
 
 # Unit tests for DevCycle::Client
 # Automatically generated by openapi-generator (https://openapi-generator.tech)
@@ -21,16 +24,18 @@ describe 'DevCycle::Client' do
     sdk_key = ENV["DEVCYCLE_SERVER_SDK_KEY"]
     if sdk_key.nil?
       puts("SDK KEY NOT SET - SKIPPING INIT")
-      return
+      @skip_tests = true
+    else
+      # run before each test
+      options = DevCycle::Options.new(enable_cloud_bucketing: true)
+      @api_instance = DevCycle::Client.new(sdk_key, options)
+      
+      @user = DevCycle::User.new({
+          user_id: 'test-user',
+          appVersion: '1.2.3'
+      })
+      @skip_tests = false
     end
-    # run before each test
-    options = DevCycle::Options.new(enable_cloud_bucketing: true)
-    @api_instance = DevCycle::Client.new(sdk_key, options)
-    
-    @user = DevCycle::User.new({
-        user_id: 'test-user',
-        appVersion: '1.2.3'
-    })
   end
 
   after do
@@ -66,6 +71,8 @@ describe 'DevCycle::Client' do
     it 'should work' do
       result = @api_instance.variable(@user, "ruby-example-tests-default", false)
       expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Error"
 
       result = @api_instance.variable_value(@user, "ruby-example-tests-default", true)
       expect(result).to eq true
@@ -86,6 +93,51 @@ describe 'DevCycle::Client' do
 
       result = @api_instance.variable_value(@user, "test", true)
       expect(result).to eq true
+
+      result = @api_instance.variable(@user, "test-number-variable", 0)
+      expect(result.isDefaulted).to eq false
+      expect(result.value).to eq 123
+
+      result = @api_instance.variable(@user, "test-number-variable", 0)
+      expect(result.isDefaulted).to eq false
+      expect(result.value).to eq 123
+
+      result = @api_instance.variable(@user, "test-float-variable", 0.0)
+      expect(result.isDefaulted).to eq false
+      expect(result.value).to eq 4.56
+
+      result = @api_instance.variable(@user, "test-string-variable", "")
+      expect(result.isDefaulted).to eq false
+      expect(result.value).to eq "on"
+
+      result = @api_instance.variable(@user, "test-json-variable", {})
+      expect(result.isDefaulted).to eq false
+      expect(result.value).to eq({:message => "a"})
+
+      result = @api_instance.variable(@user, "test", "false")
+      expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Variable Type Mismatch"
+
+      result = @api_instance.variable(@user, "test-number-variable", "123")
+      expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Variable Type Mismatch"
+
+      result = @api_instance.variable(@user, "test-number-variable", true)
+      expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Variable Type Mismatch"
+
+      result = @api_instance.variable(@user, "test-string-variable", true)
+      expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Variable Type Mismatch"
+
+      result = @api_instance.variable(@user, "test-json-variable", "on")
+      expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Variable Type Mismatch" 
     end
   end
 
@@ -102,4 +154,37 @@ describe 'DevCycle::Client' do
     end
   end
 
+  describe 'get_variable_by_key test' do
+    before do
+      WebMock.disable_net_connect!(allow_localhost: true)
+    end
+    
+    after do
+      WebMock.allow_net_connect!
+    end
+    
+    it 'should work with mocked response' do
+      stub_request(:post, "https://bucketing-api.devcycle.com/v1/variables/mocked_variable").
+        to_return(status: 200, body: "{\"isDefaulted\": false, \"value\": true, \"eval\": {\"reason\": \"SPLIT\", \"details\": \"Random Distribution | All Users\", \"target_id\": \"621642332ea68943c8833c4d\"}}", headers: {})
+
+      result = @api_instance.variable(@user, "mocked_variable", false)
+      expect(result.isDefaulted).to eq false
+      expect(result.value).to eq true
+      # Use Hash syntax since eval is deserialized as a Hash
+      expect(result.eval[:reason]).to eq "SPLIT"
+      expect(result.eval[:details]).to eq "Random Distribution | All Users"
+      expect(result.eval[:target_id]).to eq "621642332ea68943c8833c4d"
+    end
+
+    it 'should return error details' do
+      stub_request(:post, "https://bucketing-api.devcycle.com/v1/variables/test").
+        to_return(status: 500, body: "{\"isDefaulted\": true, \"value\": false, \"eval\": {\"reason\": \"DEFAULT\", \"details\": \"Error\"}}", headers: {})
+
+      result = @api_instance.variable(@user, "test", false)
+      expect(result.isDefaulted).to eq true
+      expect(result.eval[:reason]).to eq "DEFAULT"
+      expect(result.eval[:details]).to eq "Error"
+    end
+  end
+
 end

data/spec/spec_helper.rb

@@ -12,6 +12,10 @@ OpenAPI Generator version: 5.3.0
 
 # load the gem
 require 'devcycle-ruby-server-sdk'
+require 'webmock/rspec'
+
+# Configure WebMock to allow real HTTP requests by default, but enable it for specific tests
+WebMock.allow_net_connect!
 
 # The following  was generated by the `rspec --init` command. Conventionally, all
 # specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: devcycle-ruby-server-sdk
 version: !ruby/object:Gem::Version
-  version: 3.6.2
+  version: 3.8.0
 platform: ruby
 authors:
 - DevCycleHQ
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 20.0.2
+        version: 39.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 20.0.2
+        version: 39.0.1
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -119,14 +119,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -166,6 +166,7 @@ files:
 - lib/devcycle-ruby-server-sdk/api_error.rb
 - lib/devcycle-ruby-server-sdk/configuration.rb
 - lib/devcycle-ruby-server-sdk/eval_hooks_runner.rb
+- lib/devcycle-ruby-server-sdk/eval_reasons.rb
 - lib/devcycle-ruby-server-sdk/localbucketing/bucketed_user_config.rb
 - lib/devcycle-ruby-server-sdk/localbucketing/bucketing-lib.release.wasm
 - lib/devcycle-ruby-server-sdk/localbucketing/config_manager.rb