kameleoon-client-ruby 3.20.0 → 3.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6e939e54b9b0f43a46d27b3ce7d1d442916d036a7db9ca5159645ffc869415b
-  data.tar.gz: 98b6e2c2b04c183ba5052379066e3eff95c9ffdc2b28963a0bd106dcf8adb0db
+  metadata.gz: ea79d87e992d2f5bf9829c8082427c18251101be90f50c769b46242a1f4fc272
+  data.tar.gz: 305d07e5adee2b86cf58acc2b01f8a47f4161daeb06efbc8239e7a585ec355cd
 SHA512:
-  metadata.gz: c4eb181ded7a566731df5e6af6bcb271fcf852c27503b5e0c44be51eb93b729decb88c378732f9a9584d5d1ef452e71a5ba651a39d20a06f7e689a3b016bc65a
-  data.tar.gz: 997194371128c0c25cd394ab7ed22e05a0b57684915c96268874ab9e426aa3e0228f396488e77da61c2b122798eeccfee2ad1e8785900ddff24452faac953025
+  metadata.gz: c3319b271cf4053f01e9fab40b0133cd609a800f55fd3de84f19b76209d2fcbe5438672aa24a42dc39c1dd4dade97641956c2cff1f5c5c0cee8ece0d80636ca8
+  data.tar.gz: 10dfdd35cf97d0adb20ed4a866c4b6739be6ec11458c267a550bf02f6e5ae2542b282b2c30ac33ae94797e3e4a8ce8dd6187406ef1d85603c2d02d0b9f09d44f

data/lib/kameleoon/client_readiness.rb

@@ -3,37 +3,47 @@
 require 'concurrent'
 
 module Kameleoon
+  # ClientReadiness is a cross-thread latch signalling that the SDK has
+  # successfully loaded its configuration.
+  #
+  # It is created on the thread that builds the client but released (`set`) from
+  # the background thread(s) performing configuration fetches, so it relies on
+  # Concurrent::Event (which allows cross-thread release) rather than a
+  # read/write lock (whose write lock must be released by the acquiring thread).
+  #
+  # A failed fetch does NOT release the latch: the client keeps retrying in the
+  # background and the latch is released as soon as any fetch succeeds. Callers
+  # should bound their `wait` with a timeout so they are never blocked forever
+  # when the configuration can never be loaded.
   class ClientReadiness
-    attr_reader :is_initializing, :success
-
     def initialize
-      @is_initializing = false
       @success = false
-      @condition = Concurrent::ReadWriteLock.new
-      reset
+      @event = Concurrent::Event.new
     end
 
-    def reset
-      @success = false
-      unless @is_initializing
-        @is_initializing = true
-        @condition.acquire_write_lock
-      end
+    # @return [Boolean] whether the SDK has become ready (configuration loaded).
+    def success
+      @success
     end
 
+    # Record a fetch outcome. A successful fetch marks the client ready and
+    # unblocks all waiting threads; a failed fetch is ignored so that a later
+    # successful retry can still release the latch. Idempotent and safe to call
+    # from any thread.
     def set(success)
-      @success = success
-      if @is_initializing
-        @condition.release_write_lock
-        @is_initializing = false
-      end
+      return unless success
+
+      @success = true
+      @event.set
     end
 
-    def wait
-      if @is_initializing
-        @condition.acquire_read_lock
-        @condition.release_read_lock
-      end
+    # Block until the SDK becomes ready or the timeout elapses.
+    #
+    # @param timeout [Numeric, nil] maximum number of seconds to wait;
+    #   nil waits indefinitely.
+    # @return [Boolean] whether the SDK is ready.
+    def wait(timeout = nil)
+      @event.wait(timeout)
       @success
     end
   end

data/lib/kameleoon/kameleoon_client.rb

@@ -92,9 +92,24 @@ module Kameleoon
                                     site_code, config)
     end
 
-    def wait_init
-      Logging::KameleoonLogger.info('CALL: KameleoonClient.wait_init')
-      result = @readiness.wait
+    ##
+    # Block until the SDK has loaded its configuration and is ready to use.
+    #
+    # If the initial fetch fails the client keeps retrying in the background, so
+    # this method returns as soon as any fetch succeeds. The wait is always
+    # bounded by a timeout, so it never blocks indefinitely: when the timeout
+    # elapses before the configuration is loaded, the method returns false.
+    #
+    # @param [Integer, nil] timeout_millisecond Maximum time to wait, in
+    #   milliseconds. When nil or negative, config.default_timeout_millisecond
+    #   is applied.
+    # @return [Boolean] true if the SDK is ready, false if the timeout elapsed first.
+    def wait_init(timeout_millisecond = nil)
+      Logging::KameleoonLogger.info('CALL: KameleoonClient.wait_init(timeout_millisecond: %s)', timeout_millisecond)
+      if timeout_millisecond.nil? || timeout_millisecond.negative?
+        timeout_millisecond = @config.default_timeout_millisecond
+      end
+      result = @readiness.wait(timeout_millisecond / 1000.0)
       Logging::KameleoonLogger.info('RETURN: KameleoonClient.wait_init -> (result: %s)', result)
       result
     end
@@ -822,7 +837,8 @@ module Kameleoon
           Logging::KameleoonLogger.error('Initial configuration fetch failed: %s', e)
         end
         @readiness.set(ok)
-        manage_configuration_update(@data_manager.data_file.settings.real_time_update) if ok
+        real_time_update = ok && @data_manager.data_file.settings.real_time_update
+        manage_configuration_update(real_time_update)
       end
     end
 
@@ -834,6 +850,9 @@ module Kameleoon
         rescue StandardError => e
           Logging::KameleoonLogger.error('Error occurred during configuration fetching: %s', e)
         end
+        # Release any threads still waiting in `wait_init` once a (re)fetch
+        # finally succeeds after an unsuccessful initial fetch.
+        @readiness.set(ok)
         real_time_update = @data_manager.data_file.settings.real_time_update
         if !ok && real_time_update
           @data_manager.data_file.settings.real_time_update = false

data/lib/kameleoon/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Kameleoon
-  SDK_VERSION = '3.20.0'
+  SDK_VERSION = '3.21.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.20.0
+  version: 3.21.0
 platform: ruby
 authors:
 - Kameleoon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-05-05 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request