kameleoon-client-ruby 3.18.0 → 3.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 916619df3b6cdccaf7999889e5f646bcbbfcba29eb6960bbf3374607100c1efe
-  data.tar.gz: d38b503e8cbf9d6df0a0639292b8b5436a59b4544ea53b45ab4d738a5b556dec
+  metadata.gz: dde5f6ebb9e6779b9bf8d4edbdded4e11b82aa642ec046bd2493306e0b2a7ad8
+  data.tar.gz: 5a15f627b2832ec10f001ef7ee061fa31c6dbd618b02ec55ff9d1d66ee17d5a8
 SHA512:
-  metadata.gz: 1d154b47a9375184a1e2375cce4654b7615f51f37f656db8124228e0cce3f83414185f0ae53b40d704432c3d2ae1abb05d6700af504ce015b77df22d46caa02e
-  data.tar.gz: 730008de9284005e1401352e48bf2707ae8707456f04e8131cfda0e6b666ba59cf5399f541d01b0b5a5baba83ac7acd78a79e82920a191bc7c49fa6dab5e4dd3
+  metadata.gz: 91d3f34ab6855ed62d571fa5d40b85a04504926f2d38650c9b62f052bd9f0b79b0ce95ece6636fa37ecc5062020f2361bc5e0e8af80383b0d2b377dffd5919e7
+  data.tar.gz: c2e5efd80b73d5f8ce9c48a6f069aadda0fc7d1a6bc390a2d98af4a8a69b36928bac0188c77406bd793d8db6c4701df24838c67efc89b98d4d0e6b7e425b9c68

data/lib/kameleoon/configuration/data_file.rb

@@ -13,12 +13,13 @@ module Kameleoon
     class DataFile
       attr_reader :last_modified, :settings, :segments, :audience_tracking_segments, :feature_flags, :me_groups,
                   :has_any_targeted_delivery_rule, :feature_flag_by_id, :rule_info_by_exp_id, :variation_by_id,
-                  :custom_data_info, :experiment_ids_with_js_css_variable, :holdout
+                  :custom_data_info, :experiment_ids_with_js_css_variable, :holdout, :date_modified
 
       def to_s
         'DataFile{' \
           "environment:#{@environment}," \
           "last_modified:#{@last_modified}," \
+          "date_modified:#{@date_modified}," \
           "feature_flags:#{@feature_flags.size}," \
           "settings:#{@settings}" \
           '}'
@@ -46,13 +47,15 @@ module Kameleoon
       def get_feature_flag(feature_key)
         ff = @feature_flags[feature_key]
         raise Exception::FeatureNotFound, feature_key if ff.nil?
+        ff
+      end
 
-        unless ff.environment_enabled
+      def ensure_environment_enabled(feature_flag)
+        unless feature_flag.environment_enabled
           env = @environment.nil? ? 'default' : "'#{@environment}'"
-          msg = "Feature '#{feature_key}' is disabled for #{env} environment'"
+          msg = "Feature '#{feature_flag.feature_key}' is disabled for #{env} environment'"
           raise Exception::FeatureEnvironmentDisabled, msg
         end
-        ff
       end
 
       def experiment_js_css_variable?(experiment_id)
@@ -63,6 +66,7 @@ module Kameleoon
 
       def init_default
         Logging::KameleoonLogger.debug('CALL: DataFile.init_default')
+        @date_modified = 0
         @settings = Settings.new
         @feature_flags = {}
         @me_groups = {}
@@ -73,6 +77,7 @@ module Kameleoon
 
       def init(configuration)
         Logging::KameleoonLogger.debug('CALL: DataFile.init(configuration: %s)', configuration)
+        @date_modified = configuration['dateModified'] || 0
         @settings = Settings.new(configuration['configuration'])
         @segments, @audience_tracking_segments = parse_segments(configuration)
         @custom_data_info = CustomDataInfo.new(configuration['customData'])

data/lib/kameleoon/configuration/variable.rb

@@ -16,6 +16,18 @@ module Kameleoon
         @type = hash['type']
         @value = hash['value']
       end
+
+      def get_value
+        case @type
+        when 'BOOLEAN', 'STRING', 'NUMBER', 'JS', 'CSS'
+          @value
+        when 'JSON'
+          JSON.parse(@value)
+        else
+          Logging::KameleoonLogger.error("Unknown type '#{@type}' for feature variable")
+          @value
+        end
+      end
     end
   end
 end

data/lib/kameleoon/configuration/variation.rb

@@ -19,7 +19,7 @@ module Kameleoon
       end
 
       def initialize(hash)
-        @key = hash['key']
+        @key = hash['key'] || ''
         @variables = Variable.create_from_array(hash['variables'])
         @name = hash['name'] || ''
       end

data/lib/kameleoon/data/manager/visitor_manager.rb

@@ -64,6 +64,16 @@ module Kameleoon
         visitor
       end
 
+      def peek_visitor(visitor_code)
+        Logging::KameleoonLogger.debug("CALL: VisitorManager.peek_visitor(visitor_code: '%s')", visitor_code)
+
+        visitor = @visitors[visitor_code]
+
+        Logging::KameleoonLogger.debug("RETURN: VisitorManager.peek_visitor(visitor_code: '%s') -> (visitor: %s)",
+                              visitor_code, visitor)
+        visitor
+      end
+
       def enumerate(&blk)
         @visitors.each_pair { |vc, v| blk.call(vc, v) }
       end

data/lib/kameleoon/kameleoon_client.rb

@@ -369,8 +369,6 @@ module Kameleoon
       Utils::VisitorCode.validate(visitor_code)
       variations = {}
       @data_manager.data_file.feature_flags.each_value do |feature_flag|
-        next unless feature_flag.environment_enabled
-
         begin
           variation_key, eval_exp = get_variation_info(visitor_code, feature_flag, track)
         rescue Exception::FeatureEnvironmentDisabled
@@ -468,7 +466,7 @@ module Kameleoon
         raise Exception::FeatureVariableNotFound.new(variable_name),
               "Feature variable #{variable_name} not found"
       end
-      value = _parse_feature_variable(variable)
+      value = variable.get_value
       Logging::KameleoonLogger.info(
         "RETURN: KameleoonClient.get_feature_variable(visitor_code: '%s', feature_key: '%s', variable_name: '%s', " \
           'is_unique_identifier: %s) -> (variable: %s)',
@@ -503,12 +501,13 @@ module Kameleoon
       )
       feature_flag = @data_manager.data_file.get_feature_flag(feature_key)
       variation = feature_flag.get_variation_by_key(variation_key)
+      @data_manager.data_file.ensure_environment_enabled(feature_flag)
       if variation.nil?
         raise Exception::FeatureVariationNotFound.new(variation_key),
               "Variation key #{variation_key} not found"
       end
       variables = {}
-      variation.variables.each { |var| variables[var.key] = _parse_feature_variable(var) }
+      variation.variables.each { |var| variables[var.key] = var.get_value }
       Logging::KameleoonLogger.info(
         "RETURN: KameleoonClient.get_feature_variation_variables(feature_key: '%s', variation_key: '%s') " \
           '-> (variables: %s)', feature_key, variation_key, variables
@@ -607,12 +606,16 @@ module Kameleoon
       )
       warehouse_audience
     end
-
     ##
-    # Returns a list of all feature flag keys
+    # Returns a list of all feature flag keys.
     #
     # @return [Array] array of all feature flag keys
+    #
+    # DEPRECATED. Please use `get_data_file` instead.
     def get_feature_list # rubocop:disable Naming/AccessorMethodName
+      Logging::KameleoonLogger.info(
+        '[DEPRECATION] `get_feature_list` is deprecated. Please use `get_data_file` instead.'
+      )
       Logging::KameleoonLogger.info('CALL: KameleoonClient.get_feature_list')
       features = @data_manager.data_file.feature_flags.keys
       Logging::KameleoonLogger.info('RETURN: KameleoonClient.get_feature_list -> (features: %s)', features)
@@ -638,8 +641,6 @@ module Kameleoon
       visitor = @visitor_manager.get_visitor(visitor_code)
       list_keys = []
       @data_manager.data_file.feature_flags.each do |feature_key, feature_flag|
-        next unless feature_flag.environment_enabled
-
         begin
           eval_exp = evaluate(visitor, visitor_code, feature_flag, false, false)
         rescue Exception::FeatureEnvironmentDisabled
@@ -677,8 +678,6 @@ module Kameleoon
       map_active_features = {}
 
       @data_manager.data_file.feature_flags.each_value do |feature_flag|
-        next unless feature_flag.environment_enabled
-
         begin
           eval_exp = evaluate(visitor, visitor_code, feature_flag, false, false)
         rescue Exception::FeatureEnvironmentDisabled
@@ -803,41 +802,7 @@ module Kameleoon
     # @return [Kameleoon::Types::DataFile] The current DataFile instance.
     def get_data_file
       Logging::KameleoonLogger.info('CALL: KameleoonClient.get_data_file')
-
-      feature_flags_map = @data_manager.data_file.feature_flags.transform_values do |source_feature_flag|
-        # Collect variations
-        variations_map = source_feature_flag.variations.each_with_object({}) do |variation, variations_map|
-          variables_map = variation.variables.each_with_object({}) do |var, variables_map|
-            variables_map[var.key] = Types::Variable.new(var.key, var.type, _parse_feature_variable(var))
-          end
-          variations_map[variation.key] = Types::Variation.new(variation.key, nil, nil, variables_map, variation.name)
-        end
-
-        # Collect rules
-        rules = source_feature_flag.rules.map do |rule|
-          rule_variations = rule.experiment.variations_by_exposition.each_with_object({}) do |var_by_exp, rule_variations|
-            base_variation = variations_map[var_by_exp.variation_key]
-            next unless base_variation
-            rule_variations[base_variation.key] = Types::Variation.new(
-              base_variation.key,
-              var_by_exp.variation_id,
-              rule.experiment.id,
-              base_variation.variables,
-              base_variation.name
-            )
-          end
-          Types::Rule.new(rule_variations)
-        end
-
-        Types::FeatureFlag.new(
-          variations_map,
-          source_feature_flag.environment_enabled,
-          rules,
-          source_feature_flag.default_variation_key
-        )
-      end
-
-      data_file = Types::DataFile.new(feature_flags_map)
+      data_file = @data_manager.external_data_file
       Logging::KameleoonLogger.info('RETURN: KameleoonClient.get_data_file -> (data_file: %s)', data_file)
       data_file
     end
@@ -1015,6 +980,11 @@ module Kameleoon
       )
       eval_exp = nil
       forced_variation = visitor&.get_forced_feature_variation(feature_flag.feature_key)
+
+      unless forced_variation&.simulated
+        @data_manager.data_file.ensure_environment_enabled(feature_flag)
+      end
+
       if forced_variation
         eval_exp = EvaluatedExperiment.from_forced_variation(forced_variation)
       elsif visitor_not_in_holdout?(visitor, visitor_code, track, save, feature_flag.bucketing_custom_data_index) && \
@@ -1276,21 +1246,10 @@ module Kameleoon
       Logging::KameleoonLogger.debug(
         'CALL: KameleoonClient.create_external_variation(variation: %s, eval_exp: %s)', variation, eval_exp
       )
-      ext_variables = {}
-      variation&.variables&.each do |variable|
-        ext_variables[variable.key] = Types::Variable.new(
-          variable.key,
-          variable.type,
-          _parse_feature_variable(variable)
-        )
-      end
-      ext_variables.freeze
-      ext_variation = Types::Variation.new(
-        variation&.key || '',
+      ext_variation = Types::Variation._build_from_internal(
+        variation,
         eval_exp&.var_by_exp&.variation_id,
-        eval_exp&.experiment&.id,
-        ext_variables,
-        variation&.name || ''
+        eval_exp&.experiment&.id
       )
       Logging::KameleoonLogger.debug(
         'RETURN: KameleoonClient.create_external_variation(variation: %s, eval_exp: %s) -> (ext_variation: %s)',
@@ -1301,18 +1260,6 @@ module Kameleoon
 
     ##
     # helper method for fetching values from a Variable
-    def _parse_feature_variable(variable)
-      case variable.type
-      when 'BOOLEAN', 'STRING', 'NUMBER', 'JS', 'CSS'
-        variable.value
-      when 'JSON'
-        JSON.parse(variable.value)
-      else
-        Logging::KameleoonLogger.error("Unknown type '#{variable.type}' for feature variable")
-        variable.value
-      end
-    end
-
     def set_unique_identifier(visitor_code, is_unique_identifier)
       Logging::KameleoonLogger.info(
         "The 'isUniqueIdentifier' parameter is deprecated. Please, add 'UniqueIdentifier' to a visitor instead."

data/lib/kameleoon/managers/data/data_manager.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'kameleoon/types/data_file'
+
 module Kameleoon
   module Managers
     module Data
@@ -13,7 +15,11 @@ module Kameleoon
         end
 
         def data_file=(value)
-          @container = Container.new(value)
+          @container = Container.new(value, create_external_data_file(value))
+        end
+
+        def external_data_file
+          @container.external_data_file
         end
 
         def visitor_code_managed?
@@ -22,14 +28,22 @@ module Kameleoon
 
         class Container
           attr_reader :data_file, :visitor_code_managed
+          attr_reader :external_data_file
 
-          def initialize(data_file)
+          def initialize(data_file, external_data_file)
             @data_file = data_file
+            @external_data_file = external_data_file
             # Regarding GDPR policy we should set visitorCode if legal consent isn't required or we have at
             # least one Targeted Delivery rule in datafile
             @visitor_code_managed = data_file.settings.is_consent_required && !data_file.has_any_targeted_delivery_rule
           end
         end
+
+        private
+
+        def create_external_data_file(source_data_file)
+          Types::DataFile._build_from_internal(source_data_file)
+        end
       end
     end
   end

data/lib/kameleoon/managers/tracking/tracking_builder.rb

@@ -32,7 +32,7 @@ module Kameleoon
 
           @visitor_codes.each do |visitor_code|
             if @total_size <= @request_size_limit
-              visitor = @visitor_manager.get_visitor(visitor_code)
+              visitor = @visitor_manager.peek_visitor(visitor_code)
               is_consent_given = consent_given?(visitor)
               data = collect_tracking_data(visitor_code, visitor, is_consent_given)
               if !data.empty?

data/lib/kameleoon/network/access_token_source.rb

@@ -5,6 +5,7 @@ require 'net/http'
 require 'time'
 require 'kameleoon/utils'
 require 'kameleoon/logging/kameleoon_logger'
+require 'base64'
 
 module Kameleoon
   module Network
@@ -13,6 +14,7 @@ module Kameleoon
       TOKEN_OBSOLESCENCE_GAP = 1800 # in seconds
       JWT_ACCESS_TOKEN_FIELD = 'access_token'
       JWT_EXPIRES_IN_FIELD = 'expires_in'
+      BASIC_AUTHORIZATION_PREFIX = 'Basic '
 
       def initialize(network_manager, client_id, client_secret)
         Logging::KameleoonLogger.debug(lambda {
@@ -23,12 +25,18 @@ module Kameleoon
         @client_id = client_id
         @client_secret = client_secret
         @fetching = false
+        @basic_auth_token = AccessTokenSource.construct_basic_token(client_id, client_secret)
         Logging::KameleoonLogger.debug(lambda {
           format("RETURN: AccessTokenSource.new(network_manager, client_id: '%s', client_secret: '%s')",
                  Utils::Strval.secret(client_id), Utils::Strval.secret(client_secret))
         })
       end
 
+      def self.construct_basic_token(client_id, client_secret)
+        basic_token_content = "#{client_id}:#{client_secret}"
+        "#{BASIC_AUTHORIZATION_PREFIX}#{Base64.strict_encode64(basic_token_content)}"
+      end
+
       def get_token(timeout = nil)
         Logging::KameleoonLogger.debug('CALL: AccessTokenSource.getToken(timeout: %s)', timeout)
         now = Time.new.to_i
@@ -70,7 +78,7 @@ module Kameleoon
 
       def fetch_token(timeout = nil)
         Logging::KameleoonLogger.debug('CALL: AccessTokenSource.fetch_token(timeout: %s)', timeout)
-        response_content = @network_manager.fetch_access_jwtoken(@client_id, @client_secret, timeout)
+        response_content = @network_manager.fetch_access_jwtoken(@basic_auth_token, timeout)
         unless response_content
           Logging::KameleoonLogger.error('Failed to fetch access JWT')
           return nil

data/lib/kameleoon/network/net_provider.rb

@@ -17,7 +17,10 @@ module Kameleoon
       def collect_headers(request)
         headers = { 'Content-Type' => request.content_type }
         headers.merge!(request.extra_headers) unless request.extra_headers.nil?
-        headers['Authorization'] = "Bearer #{request.access_token}" unless request.access_token.nil?
+        unless request.access_token.nil? || request.access_token.empty?
+          token_prefix = request.access_token.start_with?('Basic') ? '' : 'Bearer '
+          headers['Authorization'] = "#{token_prefix}#{request.access_token}"
+        end
         headers
       end
 

data/lib/kameleoon/network/network_manager.rb

@@ -70,16 +70,15 @@ module Kameleoon
         unwrap_response(*make_call(request, true, TRACKING_CALL_ATTEMPT_NUMBER - 1, TRACKING_CALL_RETRY_DELAY))
       end
 
-      def fetch_access_jwtoken(client_id, client_secret, timeout = nil)
+      def fetch_access_jwtoken(basic_auth_token, timeout = nil)
         url = @url_provider.make_access_token_url
         timeout = ensure_timeout(timeout)
         data_map = {
           grant_type: ACCESS_TOKEN_GRANT_TYPE,
-          client_id: client_id,
-          client_secret: client_secret
         }
         data = UriHelper.encode_query(data_map).encode('UTF-8')
         request = Request.new(Method::POST, url, ContentType::FORM, timeout, data: data)
+        request.authorize(basic_auth_token)
         unwrap_response(*make_call(request, false))
       end
 

data/lib/kameleoon/network/request.rb

@@ -11,12 +11,15 @@ module Kameleoon
         body = 'null'
         unless @data.nil?
           if @data.is_a?(String)
-            body = @data.start_with?('grant_type=client_credentials') ? '****' : @data
-          else
             body = @data
           end
         end
-        "Request{method:'#{@method}',url:'#{@url}',headers:#{@extra_headers},body:'#{body}'}"
+
+        headers = ''
+        headers += 'Authorization: ***' unless access_token.nil?
+        headers += @extra_headers.to_s unless @extra_headers.nil?
+
+        "Request{method:'#{@method}',url:'#{@url}',headers:#{headers},body:'#{body}'}"
       end
 
       def initialize(method, url, content_type, timeout, extra_headers: nil, data: nil)

data/lib/kameleoon/network/url_provider.rb

@@ -22,7 +22,7 @@ module Kameleoon
       CONFIGURATION_API_URL_FORMAT = 'https://%s/v3/%s'
       DATA_API_URL_FORMAT = 'https://%s%s?%s'
       RT_CONFIGURATION_URL_FORMAT = 'https://%s:8110/sse?%s'
-      ACCESS_TOKEN_URL_FORMAT = 'https://%s/oauth/token'
+      ACCESS_TOKEN_URL_FORMAT = 'https://%s/oauth/token?%s'
 
       TEST_DATA_API_DOMAIN = 'data.kameleoon.net'
       TEST_AUTOMATION_API_DOMAIN = 'api.kameleoon.net'
@@ -39,6 +39,15 @@ module Kameleoon
         @configuration_domain = DEFAULT_CONFIGURATION_DOMAIN
         @access_token_domain = DEFAULT_ACCESS_TOKEN_DOMAIN
         @is_custom_domain = false
+
+        url_params = {
+          sdkName: SDK_NAME,
+          sdkVersion: SDK_VERSION,
+          siteCode: @site_code
+        }
+        @access_token_url_params = UriHelper.encode_query(url_params)
+        url_params[:bodyUa] = true
+        @tracking_url_params = UriHelper.encode_query(url_params)
         update_domains(network_domain)
       end
 
@@ -60,7 +69,7 @@ module Kameleoon
           siteCode: @site_code,
           bodyUa: true
         }
-        format(DATA_API_URL_FORMAT, @data_api_domain, TRACKING_PATH, UriHelper.encode_query(params))
+        format(DATA_API_URL_FORMAT, @data_api_domain, TRACKING_PATH, @tracking_url_params)
       end
 
       def make_visitor_data_get_url(visitor_code, filter, is_unique_identifier = false)
@@ -104,11 +113,20 @@ module Kameleoon
       end
 
       def make_access_token_url
-        format(ACCESS_TOKEN_URL_FORMAT, @access_token_domain)
+        format(ACCESS_TOKEN_URL_FORMAT, @access_token_domain, @access_token_url_params)
       end
 
       private
 
+      def make_post_query_base(site_code)
+        data_map = {
+          "sdkName": Kameleoon::SDK_NAME,
+          "sdkVersion": Kameleoon::SDK_VERSION,
+          "siteCode": site_code
+        }
+        data = UriHelper.encode_query(data_map).encode('UTF-8')
+      end
+
       def update_domains(network_domain)
         return if network_domain.nil? || network_domain.empty?
 

data/lib/kameleoon/targeting/conditions/unknown_condition.rb

@@ -8,6 +8,7 @@ module Kameleoon
     # UnknownCondition represents not defined condition, always returns that visitor is targeted (true)
     class UnknownCondition < Condition
       def check(_data)
+        Logging::KameleoonLogger.warning('Condition of unknown type \'%s\' evaluated as true', type)
         true
       end
     end

data/lib/kameleoon/types/data_file.rb

@@ -1,18 +1,29 @@
 # frozen_string_literal: true
 
+require 'kameleoon/types/feature_flag'
+
 module Kameleoon
   module Types
     # DataFile
     class DataFile
-      attr_reader :feature_flags
+      attr_reader :feature_flags, :date_modified
 
       # @api private
-      def initialize(feature_flags)
+      def initialize(feature_flags, date_modified)
         @feature_flags = feature_flags
+        @date_modified = date_modified
+      end
+
+      # @api private
+      def self._build_from_internal(source_data_file)
+        feature_flags = (source_data_file.feature_flags || {}).transform_values do |feature_flag|
+          FeatureFlag._build_from_internal(feature_flag)
+        end
+        DataFile.new(feature_flags, source_data_file.date_modified)
       end
 
       def to_s
-        "DataFile{feature_flags:#{@feature_flags}}"
+        "DataFile{feature_flags:#{@feature_flags},date_modified:#{@date_modified}}"
       end
     end
   end

data/lib/kameleoon/types/feature_flag.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'kameleoon/types/rule'
+require 'kameleoon/types/variation'
+
 module Kameleoon
   module Types
     # FeatureFlag
@@ -18,6 +21,25 @@ module Kameleoon
         @variations[@default_variation_key]
       end
 
+      # @api private
+      def self._build_from_internal(source_feature_flag)
+        variations = (source_feature_flag.variations || []).each_with_object({}) do |variation, result|
+          ext_variation = Variation._build_from_internal(variation)
+          result[ext_variation.key] = ext_variation
+        end
+
+        rules = (source_feature_flag.rules || []).map do |rule|
+          Rule._build_from_internal(rule, variations)
+        end
+
+        FeatureFlag.new(
+          variations,
+          source_feature_flag.environment_enabled,
+          rules,
+          source_feature_flag.default_variation_key
+        )
+      end
+
       def to_s
         "FeatureFlag{variations:#{@variations},environment_enabled:#{@environment_enabled},rules:#{@rules},default_variation_key:#{@default_variation_key}}"
       end

data/lib/kameleoon/types/rule.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'kameleoon/types/variation'
+
 module Kameleoon
   module Types
     # Rule
@@ -11,6 +13,25 @@ module Kameleoon
         @variations = variations
       end
 
+      # @api private
+      def self._build_from_internal(internal_rule, variations)
+        rule_variations = {}
+        vars_by_exposition = internal_rule.experiment&.variations_by_exposition || []
+        vars_by_exposition.each do |var_by_exp|
+          base_variation = variations[var_by_exp.variation_key]
+          next if base_variation.nil?
+
+          rule_variations[base_variation.key] = Variation.new(
+            base_variation.key,
+            var_by_exp.variation_id,
+            internal_rule.experiment&.id,
+            base_variation.variables,
+            base_variation.name
+          )
+        end
+        Rule.new(rule_variations)
+      end
+
       def to_s
         "Rule{variations:#{@variations}}"
       end

data/lib/kameleoon/types/variable.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'json'
+require 'kameleoon/logging/kameleoon_logger'
+
 module Kameleoon
   module Types
     # Variable
@@ -16,6 +19,11 @@ module Kameleoon
         @type = type
         @value = value
       end
+
+      # @api private
+      def self._build_from_internal(source_variable)
+        Variable.new(source_variable.key, source_variable.type, source_variable.get_value)
+      end
     end
   end
 end

data/lib/kameleoon/types/variation.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'kameleoon/configuration/variation'
+require 'kameleoon/types/variable'
 
 module Kameleoon
   module Types
@@ -21,6 +22,17 @@ module Kameleoon
         @name = name
       end
 
+      # @api private
+      def self._build_from_internal(source_variation, variation_id = nil, experiment_id = nil)
+        variables = (source_variation&.variables || []).each_with_object({}) do |variable, result|
+          ext_variable = Variable._build_from_internal(variable)
+          result[ext_variable.key] = ext_variable
+        end
+        key = source_variation&.key || ''
+        name = source_variation&.name || ''
+        Variation.new(key, variation_id, experiment_id, variables, name)
+      end
+
       def active?
         @key != Configuration::VariationType::VARIATION_OFF
       end

data/lib/kameleoon/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Kameleoon
-  SDK_VERSION = '3.18.0'
+  SDK_VERSION = '3.19.0'
   SDK_NAME = 'RUBY'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kameleoon-client-ruby
 version: !ruby/object:Gem::Version
-  version: 3.18.0
+  version: 3.19.0
 platform: ruby
 authors:
 - Kameleoon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-02-13 00:00:00.000000000 Z
+date: 2026-04-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request