kameleoon-client-ruby 3.17.3 → 3.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0d4abc01c7fc06b5cc0b0613dde8a40e004d6d11b358092398498a2c59ee766
-  data.tar.gz: ec89564082cb1b270a9453c63741f1ae505c46dcbbc52fd583927b603a98a26f
+  metadata.gz: 916619df3b6cdccaf7999889e5f646bcbbfcba29eb6960bbf3374607100c1efe
+  data.tar.gz: d38b503e8cbf9d6df0a0639292b8b5436a59b4544ea53b45ab4d738a5b556dec
 SHA512:
-  metadata.gz: 7b1e31f65a0c314810b5e020570d52cee18bc1a6cbe41bbdc564114dd9136257e78c06fd55b07a04106d42bfa996a3f979438647105df7d18d299cdb282dbc1d
-  data.tar.gz: df793d553ff36d2e98e118fe5c2bc846417900958d81262bb9ec7fe0dc233a86420bb9c93b793b91beec097a073dba81907dee2290fa1b7b82ddf03dd297a59f
+  metadata.gz: 1d154b47a9375184a1e2375cce4654b7615f51f37f656db8124228e0cce3f83414185f0ae53b40d704432c3d2ae1abb05d6700af504ce015b77df22d46caa02e
+  data.tar.gz: 730008de9284005e1401352e48bf2707ae8707456f04e8131cfda0e6b666ba59cf5399f541d01b0b5a5baba83ac7acd78a79e82920a191bc7c49fa6dab5e4dd3

data/lib/kameleoon/data/application_version.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative 'data'
+
+module Kameleoon
+  # ApplicationVersion contains information about the application version on the visitor's device.
+  # It is used for targeting by application version.
+  class ApplicationVersion < Data
+    attr_reader :version
+
+    # @param [String] version Application version (semantic versioning: major, major.minor, or major.minor.patch)
+    def initialize(version)
+      super(DataType::APPLICATION_VERSION)
+      @version = version
+    end
+
+    def to_s
+      "ApplicationVersion{version:#{@version}}"
+    end
+  end
+end

data/lib/kameleoon/data/data.rb

@@ -20,6 +20,7 @@ module Kameleoon
     GEOLOCATION = 'GEOLOCATION'
     VISITOR_VISITS = 'VISITOR_VISITS'
     TARGETED_SEGMENT = 'TARGETED_SEGMENT'
+    APPLICATION_VERSION = 'APPLICATION_VERSION'
   end
 
   module DataState

data/lib/kameleoon/data/manager/visitor.rb

@@ -2,6 +2,7 @@
 
 require 'concurrent'
 require 'time'
+require 'kameleoon/data/application_version'
 require 'kameleoon/data/browser'
 require 'kameleoon/data/cbscores'
 require 'kameleoon/data/conversion'
@@ -103,6 +104,13 @@ module Kameleoon
         operating_system
       end
 
+      def application_version
+        application_version = @data.application_version
+        Logging::KameleoonLogger.debug('CALL/RETURN: Visitor.application_version -> (application_version: %s)',
+                                       application_version)
+        application_version
+      end
+
       def cookie
         cookie = @data.cookie
         Logging::KameleoonLogger.debug('CALL/RETURN: Visitor.cookie -> (cookie: %s)', cookie)
@@ -275,6 +283,8 @@ module Kameleoon
               @data.cookie = data
             when OperatingSystem
               @data.set_operating_system(data, overwrite)
+            when ApplicationVersion
+              @data.set_application_version(data, overwrite)
             when Geolocation
               @data.set_geolocation(data, overwrite)
             when KcsHeat
@@ -305,7 +315,8 @@ module Kameleoon
     end
 
     class VisitorData
-      attr_reader :time_started, :mutex, :device, :browser, :geolocation, :operating_system, :visitor_visits
+      attr_reader :time_started, :mutex, :device, :browser, :geolocation, :operating_system, :visitor_visits,
+                  :application_version
       attr_accessor :last_activity_time, :legal_consent, :user_agent, :cookie, :kcs_heat, :cbscores,
                     :mapping_identifier, :forced_variations, :simulated_variations
 
@@ -462,6 +473,10 @@ module Kameleoon
         @operating_system = operating_system if overwrite || @operating_system.nil?
       end
 
+      def set_application_version(application_version, overwrite)
+        @application_version = application_version if overwrite || @application_version.nil?
+      end
+
       def set_cbscores(cbs, overwrite)
         @cbscores = cbs if overwrite || @cbscores.nil?
       end

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

@@ -72,10 +72,10 @@ module Kameleoon
         @visitors.size
       end
 
-      def add_data(visitor_code, *args, overwrite: true)
+      def add_data(visitor_code, *args, overwrite: true, track: true)
         Logging::KameleoonLogger.debug(
-          "CALL: VisitorManager.add_data(visitor_code: '%s', args: %s, overwrite: %s)",
-          visitor_code, args, overwrite
+          "CALL: VisitorManager.add_data(visitor_code: '%s', args: %s, overwrite: %s, track: %s)",
+          visitor_code, args, overwrite, track
         )
         visitor = get_or_create_visitor(visitor_code)
         cdi = @data_manager.data_file.custom_data_info
@@ -87,12 +87,13 @@ module Kameleoon
           when Conversion
             data = process_conversion(data, cdi)
           end
+          data.mark_as_sent if !track && data.respond_to?(:mark_as_sent)
           args[i] = data
         end
         visitor.add_data(*args, overwrite: overwrite)
         Logging::KameleoonLogger.debug(
-          "RETURN: VisitorManager.add_data(visitor_code: '%s', args: %s, overwrite: %s) -> (visitor)",
-          visitor_code, args, overwrite
+          "RETURN: VisitorManager.add_data(visitor_code: '%s', args: %s, overwrite: %s, track: %s) -> (visitor)",
+          visitor_code, args, overwrite, track
         )
         visitor
       end

data/lib/kameleoon/kameleoon_client.rb

@@ -162,17 +162,18 @@ module Kameleoon
     #
     # @param [String] visitor_code Visitor code
     # @param [...Data] data Data to associate with the visitor code
+    # @param [Bool] track A boolean indicating whether the data should be tracked (sent to server). Default is true.
     #
     # @raise [Kameleoon::Exception::VisitorCodeInvalid] If the visitor code is empty or longer than 255 chars
     #
-    def add_data(visitor_code, *args)
-      Logging::KameleoonLogger.info("CALL: KameleoonClient.add_data(visitor_code: '%s', args: %s)",
-                                    visitor_code, args)
+    def add_data(visitor_code, *args, track: true)
+      Logging::KameleoonLogger.info("CALL: KameleoonClient.add_data(visitor_code: '%s', args: %s, track: %s)",
+                                    visitor_code, args, track)
       Utils::VisitorCode.validate(visitor_code)
-      @visitor_manager.add_data(visitor_code, *args)
+      @visitor_manager.add_data(visitor_code, *args, track: track)
       Logging::KameleoonLogger.info(
-        "RETURN: KameleoonClient.add_data(visitor_code: '%s', args: %s)",
-        visitor_code, args
+        "RETURN: KameleoonClient.add_data(visitor_code: '%s', args: %s, track: %s)",
+        visitor_code, args, track
       )
     end
 

data/lib/kameleoon/kameleoon_client_config.rb

@@ -9,8 +9,8 @@ module Kameleoon
     DEFAULT_SESSION_DURATION_MINUTES = 30
     DEFAULT_TIMEOUT_MILLISECONDS = 10_000
     DEFAULT_TRACKING_INTERVAL_MILLISECONDS = 1000
-    MIN_TRACKING_INTERVAL_MILLISECONDS = 300
-    MAX_TRACKING_INTERVAL_MILLISECONDS = 1000
+    MIN_TRACKING_INTERVAL_MILLISECONDS = 1000
+    MAX_TRACKING_INTERVAL_MILLISECONDS = 5000
 
     attr_reader :client_id, :client_secret, :refresh_interval_second, :session_duration_second,
                 :default_timeout_millisecond, :tracking_interval_second, :environment, :top_level_domain,

data/lib/kameleoon/sem_version.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'kameleoon/logging/kameleoon_logger'
+
+module Kameleoon
+  # SemVersion is a utility class for semantic version comparison
+  class SemVersion
+    include Comparable
+
+    attr_reader :major, :minor, :patch
+
+    def initialize(major = 0, minor = 0, patch = 0)
+      @major = major
+      @minor = minor
+      @patch = patch
+    end
+
+    def <=>(other)
+      return nil unless other.is_a?(SemVersion)
+
+      c = @major <=> other.major
+      return c unless c.zero?
+
+      c = @minor <=> other.minor
+      return c unless c.zero?
+
+      @patch <=> other.patch
+    end
+
+    def to_f
+      "#{@major}.#{@minor}".to_f
+    end
+
+    def self.from_string(version_string)
+      return nil unless version_string.is_a?(String)
+
+      versions = [0, 0, 0]
+      version_parts = version_string.split('.')
+      return nil unless version_parts.length >= 1
+
+      version_parts.each_with_index do |part, i|
+        break if i >= 3
+
+        begin
+          versions[i] = Integer(part)
+        rescue ArgumentError
+          Logging::KameleoonLogger.error("Invalid version component, index: %s, value: '%s'", i, part)
+          return nil
+        end
+      end
+
+      SemVersion.new(versions[0], versions[1], versions[2])
+    end
+  end
+end

data/lib/kameleoon/targeting/condition.rb

@@ -31,6 +31,7 @@ module Kameleoon
       SAME_DAY_VISITS = 'SAME_DAY_VISITS'
       NEW_VISITORS = 'NEW_VISITORS'
       HEAT_SLICE = 'HEAT_SLICE'
+      APPLICATION_VERSION = 'APPLICATION_VERSION'
     end
 
     module Operator

data/lib/kameleoon/targeting/condition_factory.rb

@@ -1,4 +1,5 @@
 require_relative 'conditions/custom_datum'
+require_relative 'conditions/version_condition'
 require_relative 'conditions/target_experiment_condition'
 require_relative 'conditions/target_feature_flag_condition'
 require_relative 'conditions/target_personalization_condition'
@@ -77,6 +78,8 @@ module Kameleoon
           TimeElapsedSinceVisitCondition.new(condition_json)
         when ConditionType::HEAT_SLICE
           KcsHeatRangeCondition.new(condition_json)
+        when ConditionType::APPLICATION_VERSION
+          VersionCondition.new(condition_json)
         else
           Logging::KameleoonLogger.info("Unexpected TargetingConditionType: '%s'", cond_type)
           UnknownCondition.new(condition_json)

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

@@ -2,7 +2,7 @@
 
 require 'kameleoon/data/browser'
 require 'kameleoon/logging/kameleoon_logger'
-require 'kameleoon/sdk_version'
+require 'kameleoon/sem_version'
 
 module Kameleoon
   # @api private
@@ -33,7 +33,7 @@ module Kameleoon
 
         return true if @version.nil?
 
-        version_number = SdkVersion.get_float_version(@version)
+        version_number = SemVersion.from_string(@version)&.to_f || Float::NAN
         return false if version_number.nan?
 
         case @version_match_type

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

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require 'kameleoon/data/data'
-require 'kameleoon/logging/kameleoon_logger'
 require 'kameleoon/version'
+require_relative 'version_condition'
 
 module Kameleoon
   # @api private
@@ -18,12 +17,10 @@ module Kameleoon
     end
 
     # SdkLanguageCondition is a condition for checking targeting sdk type and version
-    class SdkLanguageCondition < Condition
+    class SdkLanguageCondition < VersionCondition
       def initialize(json_condition)
         super(json_condition)
         @sdk_language = json_condition['sdkLanguage']
-        @version = json_condition['version']
-        @operator = json_condition['versionMatchType']
       end
 
       def check(data)
@@ -33,34 +30,9 @@ module Kameleoon
       private
 
       def check_targeting(sdk_info)
-        return false if @sdk_language != sdk_info.language
-
-        return true if @version.nil?
-
-        version_components_condition = SdkVersion.get_version_components(@version)
-        version_components_sdk_info = SdkVersion.get_version_components(sdk_info.version)
-
-        return false if version_components_condition.nil? || version_components_sdk_info.nil?
-
-        major_condition, minor_condition, patch_condition = version_components_condition
-        major_sdk, minor_sdk, patch_sdk = version_components_sdk_info
-
-        case @operator
-        when Operator::EQUAL
-          major_sdk == major_condition && minor_sdk == minor_condition && patch_sdk == patch_condition
-        when Operator::GREATER
-          major_sdk > major_condition ||
-            (major_sdk == major_condition && minor_sdk > minor_condition) ||
-            (major_sdk == major_condition && minor_sdk == minor_condition && patch_sdk > patch_condition)
-        when Operator::LOWER
-          major_sdk < major_condition ||
-            (major_sdk == major_condition && minor_sdk < minor_condition) ||
-            (major_sdk == major_condition && minor_sdk == minor_condition && patch_sdk < patch_condition)
-        else
-          Logging::KameleoonLogger.error("Unexpected comparing operation for 'SdkLanguage' condition: '#{@operator}'")
-          false
-        end
+        @sdk_language == sdk_info.language &&
+          (@version.nil? || compare_with_version(sdk_info.version))
       end
     end
   end
-end
+end

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'kameleoon/logging/kameleoon_logger'
+require 'kameleoon/sem_version'
+require 'kameleoon/targeting/condition'
+
+module Kameleoon
+  # @api private
+  module Targeting
+    # VersionCondition is a base class for conditions that compare versions.
+    # Subclasses should implement `check` method and call `compare_with_version` for version comparison.
+    class VersionCondition < Condition
+      def initialize(json_condition)
+        super(json_condition)
+        @version = json_condition['version']
+        @version_match_type = json_condition['versionMatchType']
+        @cached_version_condition = nil
+      end
+
+      def check(data)
+        data.is_a?(String) && compare_with_version(data)
+      end
+
+      protected
+
+      def compare_with_version(version)
+        @cached_version_condition ||= SemVersion.from_string(@version)
+        version_compare = SemVersion.from_string(version)
+
+        if @cached_version_condition.nil? || version_compare.nil?
+          Logging::KameleoonLogger.error(
+            "VersionCondition has unexpected values to compare, condition version: '%s', provided version: '%s'",
+            @version, version
+          )
+          return false
+        end
+
+        case @version_match_type
+        when Operator::EQUAL
+          version_compare == @cached_version_condition
+        when Operator::GREATER
+          version_compare > @cached_version_condition
+        when Operator::LOWER
+          version_compare < @cached_version_condition
+        else
+          Logging::KameleoonLogger.error(
+            "Unexpected comparing operation for '%s' condition: '%s'",
+            type, @version_match_type
+          )
+          false
+        end
+      end
+    end
+  end
+end

data/lib/kameleoon/targeting/targeting_manager.rb

@@ -92,6 +92,8 @@ module Kameleoon
           condition_data = VisitNumberTodayCondition::TargetingData.new(visitor&.time_started, visitor&.visitor_visits)
         when ConditionType::HEAT_SLICE
           condition_data = visitor&.kcs_heat
+        when ConditionType::APPLICATION_VERSION
+          condition_data = visitor&.application_version&.version
         end
         Logging::KameleoonLogger.debug(
           "RETURN: TargetingManager.get_condition_data(type: %s, visitor, visitor_code: '%s', campaign_id: %s) -> " \

data/lib/kameleoon/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Kameleoon
-  SDK_VERSION = '3.17.3'
+  SDK_VERSION = '3.18.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.17.3
+  version: 3.18.0
 platform: ruby
 authors:
 - Kameleoon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-22 00:00:00.000000000 Z
+date: 2026-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request
@@ -86,6 +86,7 @@ files:
 - lib/kameleoon/configuration/variable.rb
 - lib/kameleoon/configuration/variation.rb
 - lib/kameleoon/configuration/variation_exposition.rb
+- lib/kameleoon/data/application_version.rb
 - lib/kameleoon/data/browser.rb
 - lib/kameleoon/data/cbscores.rb
 - lib/kameleoon/data/conversion.rb
@@ -145,7 +146,7 @@ files:
 - lib/kameleoon/real_time/sse_client.rb
 - lib/kameleoon/real_time/sse_message.rb
 - lib/kameleoon/real_time/sse_request.rb
-- lib/kameleoon/sdk_version.rb
+- lib/kameleoon/sem_version.rb
 - lib/kameleoon/storage/cache.rb
 - lib/kameleoon/storage/cache_factory.rb
 - lib/kameleoon/targeting/condition.rb
@@ -172,6 +173,7 @@ files:
 - lib/kameleoon/targeting/conditions/target_personalization_condition.rb
 - lib/kameleoon/targeting/conditions/time_elapsed_since_visit_condition.rb
 - lib/kameleoon/targeting/conditions/unknown_condition.rb
+- lib/kameleoon/targeting/conditions/version_condition.rb
 - lib/kameleoon/targeting/conditions/visit_number_today_condition.rb
 - lib/kameleoon/targeting/conditions/visit_number_total_condition.rb
 - lib/kameleoon/targeting/conditions/visitor_code_condition.rb

data/lib/kameleoon/sdk_version.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-require 'kameleoon/logging/kameleoon_logger'
-
-module Kameleoon
-  # SdkManager is a helper method for fetching / obtaining version of SDK from string
-  class SdkVersion
-    def self.get_version_components(version_string)
-      versions = [0, 0, 0]
-
-      version_parts = version_string.split('.')
-      version_parts.each_with_index do |part, i|
-        versions[i] = Integer(part)
-      rescue ArgumentError
-        Logging::KameleoonLogger.error('Invalid version component, index: %s, value: %s', i, part)
-        return nil
-      end
-      versions
-    end
-
-    def self.get_float_version(version_string)
-      version_components = get_version_components(version_string)
-
-      return Float::NAN if version_components.nil?
-
-      major = version_components[0]
-      minor = version_components[1]
-      "#{major}.#{minor}".to_f
-    end
-  end
-end