devcycle-ruby-server-sdk 3.6.1 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b68b0885c55e6e3f724d839500536a7022f6ec40d691b291125aa9e3b2d09669
-  data.tar.gz: c45af7b53ca8e12b7b6d4d8f109d2f3b8c4ff67471736e952c7d8eed0aa32a08
+  metadata.gz: c3acf8324fc7606185240c3ea421048f87c8618a3944951ed71ed729ed4cde7a
+  data.tar.gz: 763e2632030ffbc90bd365614f158bc960c767e15bcf0d88afd2a2407ff56f24
 SHA512:
-  metadata.gz: a906bf6a2b314c043b765dbffacd7bd08975b7c69e89ec28a72abbb312a091c4c2a9fa4615076ffe8c400ef4f8d539fe4977fbe31247866d728ca2f33dc88eff
-  data.tar.gz: b7ba08571dba965a3af92c8188b52ce06547e298afff943387246e67565daf8070daf5fe67552c629086bfb563b4a6856d98b31b21b949792011aa580b3e1ed9
+  metadata.gz: 7830aef854188cded6ed20a3667d4fe6dbf2bcd4482e605b823c95023b7d9fb3f30a52d01543346adae4ed260290f25b71cd516a3172679e4209d54d342eac6b
+  data.tar.gz: be2f2cb6349a64b95216dd3868642284d917ea4c8db7d2991f550f9beb9e0ddb3f8dae91dc6aa5c817fbf0f2b5f562da1f95fcccee0bddceea67323b96ec783c

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

@@ -14,6 +14,7 @@ module DevCycle
       @sdkKey = sdkKey
       @dvc_options = dvc_options
       @logger = dvc_options.logger
+      @eval_hooks_runner = EvalHooksRunner.new
 
       if @dvc_options.enable_cloud_bucketing
         @api_client = ApiClient.default
@@ -172,35 +173,72 @@ module DevCycle
 
       validate_model(user)
 
-      if @dvc_options.enable_cloud_bucketing
-        data, _status_code, _headers = variable_with_http_info(key, user, default, opts)
-        return data
+      # Create hook context
+      hook_context = HookContext.new(key: key, user: user, default_value: default)
+
+      before_hook_error = nil
+      # Run before hooks
+      begin
+        hook_context = @eval_hooks_runner.run_before_hooks(hook_context)
+      rescue BeforeHookError => e
+        before_hook_error = e
+        @logger.warn("Error in before hooks: #{e.message}")
       end
 
-      value = default
-      type = determine_variable_type(default)
-      defaulted = true
-      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)
-        unless variable_pb.nil?
-          value = get_variable_value(variable_pb)
-          defaulted = false
+      variable_result = nil
+
+      begin
+        if @dvc_options.enable_cloud_bucketing
+          data, _status_code, _headers = variable_with_http_info(key, user, default, opts)
+          variable_result = data
+        else
+          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)
+            unless variable_pb.nil?
+              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, metaData: { evalReason: DevCycle::EVAL_REASONS::DEFAULT }})
+            bucketed_config = BucketedUserConfig.new({}, {}, {}, {}, {}, {}, [])
+            @event_queue.queue_aggregate_event(variable_event, bucketed_config)
+          end
+
+          variable_result = Variable.new({
+            key: key,
+            value: value,
+            type: type,
+            defaultValue: default,
+            isDefaulted: defaulted,
+            eval: eval
+          })
         end
-      else
-        @logger.warn("Local bucketing not initialized, returning default value for variable #{key}")
-        variable_event = Event.new({ type: DevCycle::EventTypes[:agg_variable_defaulted], target: key })
-        bucketed_config = BucketedUserConfig.new({}, {}, {}, {}, {}, {}, [])
-        @event_queue.queue_aggregate_event(variable_event, bucketed_config)
-      end
-
-      Variable.new({
-        key: key,
-        value: value,
-        type: type,
-        defaultValue: default,
-        isDefaulted: defaulted
-      })
+
+
+        # Run after hooks only if no before hook error occurred
+        if before_hook_error != nil
+          @logger.info("before_hook_error is not nil, skipping after hooks")
+          raise before_hook_error
+        else
+          @eval_hooks_runner.run_after_hooks(hook_context)
+        end
+      rescue => e
+        # Run error hooks
+        @eval_hooks_runner.run_error_hooks(hook_context, e)
+      ensure
+        # Run finally hooks in all cases
+        @eval_hooks_runner.run_finally_hooks(hook_context)
+      end
+
+      variable_result
     end
 
     def variable_for_user(user, key, variable_type_code)
@@ -526,6 +564,44 @@ module DevCycle
         raise ArgumentError.new("Invalid type code for variable: #{type_code}")
       end
     end
+
+    def get_variable_value(variable_pb)
+      case variable_pb.type
+      when :Boolean
+        variable_pb.boolValue
+      when :Number
+        variable_pb.doubleValue
+      when :String
+        variable_pb.stringValue
+      when :JSON
+        JSON.parse variable_pb.stringValue
+      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]
+    def add_eval_hook(eval_hook)
+      @eval_hooks_runner.add_hook(eval_hook)
+    end
+
+    # Clears all eval hooks from the client
+    # @return [void]
+    def clear_eval_hooks
+      @eval_hooks_runner.clear_hooks
+    end
   end
 
   # @deprecated Use `DevCycle::Client` instead.

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

@@ -48,15 +48,42 @@ module DevCycle
         raise ArgumentError, "Invalid context type, expected OpenFeature::SDK::EvaluationContext but got #{context.class}"
       end
       args = {}
-      if context.field('user_id')
-        args.merge!(user_id: context.field('user_id'))
-      elsif context.field('targeting_key')
-        args.merge!(user_id: context.field('targeting_key'))
+      user_id = nil
+      user_id_field = nil
+      
+      # Priority order: targeting_key -> user_id -> userId
+      if context.field('targeting_key')
+        user_id = context.field('targeting_key')
+        user_id_field = 'targeting_key'
+      elsif context.field('user_id')
+        user_id = context.field('user_id')
+        user_id_field = 'user_id'
+      elsif context.field('userId')
+        user_id = context.field('userId')
+        user_id_field = 'userId'
       end
+      
+      # Validate user_id is present and is a string
+      if user_id.nil?
+        raise ArgumentError, "User ID is required. Must provide one of: targeting_key, user_id, or userId"
+      end
+      
+      unless user_id.is_a?(String)
+        raise ArgumentError, "User ID field '#{user_id_field}' must be a string, got #{user_id.class}"
+      end
+      
+      # Check after type validation to avoid NoMethodError on non-strings
+      if user_id.empty?
+        raise ArgumentError, "User ID is required. Must provide one of: targeting_key, user_id, or userId"
+      end
+      
+      args.merge!(user_id: user_id)
+      
       customData = {}
       privateCustomData = {}
       context.fields.each do |field, value|
-        if field === 'user_id' || field === 'targeting_key'
+        # Skip all user ID fields from custom data
+        if field === 'targeting_key' || field === 'user_id' || field === 'userId'
           next
         end
         if !(field === 'privateCustomData' || field === 'customData') && value.is_a?(Hash)

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

@@ -0,0 +1,135 @@
+require 'devcycle-ruby-server-sdk/models/eval_hook'
+require 'devcycle-ruby-server-sdk/models/eval_hook_context'
+
+module DevCycle
+  # Custom error raised when a before hook fails
+  class BeforeHookError < StandardError
+    attr_reader :original_error, :hook_context
+
+    def initialize(message = nil, original_error = nil, hook_context = nil)
+      super(message || "Before hook execution failed")
+      @original_error = original_error
+      @hook_context = hook_context
+    end
+
+    def to_s
+      msg = super
+      msg += "\nOriginal error: #{@original_error.message}" if @original_error
+      msg
+    end
+  end
+
+  # Custom error raised when an after hook fails
+  class AfterHookError < StandardError
+    attr_reader :original_error, :hook_context
+
+    def initialize(message = nil, original_error = nil, hook_context = nil)
+      super(message || "After hook execution failed")
+      @original_error = original_error
+      @hook_context = hook_context
+    end
+
+    def to_s
+      msg = super
+      msg += "\nOriginal error: #{@original_error.message}" if @original_error
+      msg
+    end
+  end
+
+  class EvalHooksRunner
+    # @return [Array<EvalHook>] Array of eval hooks to run
+    attr_reader :eval_hooks
+
+    # Initializes the EvalHooksRunner with an optional array of eval hooks
+    # @param [Array<EvalHook>, nil] eval_hooks Array of eval hooks to run
+    def initialize(eval_hooks = [])
+      @eval_hooks = eval_hooks || []
+    end
+
+    # Runs all before hooks with the given context
+    # @param [HookContext] context The context to pass to the hooks
+    # @return [HookContext] The potentially modified context
+    # @raise [BeforeHookError] when a before hook fails
+    def run_before_hooks(context)
+      current_context = context
+      
+      @eval_hooks.each do |hook|
+        next unless hook.before
+
+        begin
+          result = hook.before.call(current_context)
+          # If the hook returns a new context, use it for subsequent hooks
+          current_context = result if result.is_a?(DevCycle::HookContext)
+        rescue => e
+          # Raise BeforeHookError to allow client to handle and skip after hooks
+          raise BeforeHookError.new(e.message, e, current_context)
+        end
+      end
+      
+      current_context
+    end
+
+    # Runs all after hooks with the given context
+    # @param [HookContext] context The context to pass to the hooks
+    # @return [void]
+    # @raise [AfterHookError] when an after hook fails
+    def run_after_hooks(context)
+      @eval_hooks.each do |hook|
+        next unless hook.after
+
+        begin
+          hook.after.call(context)
+        rescue => e
+          # Log error but continue with next hook
+          raise AfterHookError.new(e.message, e, context)
+        end
+      end
+    end
+
+    # Runs all finally hooks with the given context
+    # @param [HookContext] context The context to pass to the hooks
+    # @return [void]
+    def run_finally_hooks(context)
+      @eval_hooks.each do |hook|
+        next unless hook.on_finally
+
+        begin
+          hook.on_finally.call(context)
+        rescue => e
+          # Log error but don't re-raise to prevent blocking evaluation
+          warn "Error in finally hook: #{e.message}"
+        end
+      end
+    end
+
+    # Runs all error hooks with the given context and error
+    # @param [HookContext] context The context to pass to the hooks
+    # @param [Exception] error The error that occurred
+    # @return [void]
+    def run_error_hooks(context, error)
+      @eval_hooks.each do |hook|
+        next unless hook.error
+
+        begin
+          hook.error.call(context, error)
+        rescue => e
+          # Log error but don't re-raise to prevent blocking evaluation
+          warn "Error in error hook: #{e.message}"
+        end
+      end
+    end
+
+    # Adds an eval hook to the runner
+    # @param [EvalHook] eval_hook The eval hook to add
+    # @return [void]
+    def add_hook(eval_hook)
+      @eval_hooks << eval_hook
+    end
+
+    # Clears all eval hooks from the runner
+    # @return [void]
+    def clear_hooks
+      @eval_hooks.clear
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+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'
+  end
+end

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/eval_hook.rb

@@ -0,0 +1,28 @@
+module DevCycle
+  class EvalHook
+    # Callback to be executed before evaluation
+    attr_accessor :before
+
+    # Callback to be executed after evaluation
+    attr_accessor :after
+
+    # Callback to be executed finally (always runs)
+    attr_accessor :on_finally
+
+    # Callback to be executed on error
+    attr_accessor :error
+
+    # Initializes the object with optional callback functions
+    # @param [Hash] callbacks Callback functions in the form of hash
+    # @option callbacks [Proc, nil] :before Callback to execute before evaluation
+    # @option callbacks [Proc, nil] :after Callback to execute after evaluation
+    # @option callbacks [Proc, nil] :on_finally Callback to execute finally (always runs)
+    # @option callbacks [Proc, nil] :error Callback to execute on error
+    def initialize(callbacks = {})
+      @before = callbacks[:before]
+      @after = callbacks[:after]
+      @on_finally = callbacks[:on_finally]
+      @error = callbacks[:error]
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+module DevCycle
+  class HookContext
+    # The key of the variable being evaluated
+    attr_accessor :key
+
+    # The user for whom the variable is being evaluated
+    attr_accessor :user
+
+    # The default value for the variable
+    attr_accessor :default_value
+
+    # Initializes the object
+    # @param [String] key The key of the variable being evaluated
+    # @param [DevCycle::User] user The user for whom the variable is being evaluated
+    # @param [Object] default_value The default value for the variable
+    def initialize(key:, user:, default_value:)
+      @key = key
+      @user = user
+      @default_value = default_value
+    end
+  end
+end

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
 
@@ -120,6 +124,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.1'
+  VERSION = '3.7.0'
 end

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

@@ -25,6 +25,12 @@ require 'devcycle-ruby-server-sdk/models/user'
 require 'devcycle-ruby-server-sdk/models/user_data_and_events_body'
 require 'devcycle-ruby-server-sdk/models/variable'
 
+# Eval Hooks
+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'
 require 'devcycle-ruby-server-sdk/api/dev_cycle_provider'

data/spec/api/devcycle_api_spec.rb

@@ -21,16 +21,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