devcycle-ruby-server-sdk 2.7.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75a9de78ddc4e249767ad074f6e2a8021b4705bb8f99e54202b774fffee4d8e5
-  data.tar.gz: df1c02d526d99595cebc42dddbc4952e2e917bc22df68e695d863eb6fa226fe5
+  metadata.gz: 11f97c726357c0e8c267da73d94ed9c1a24e290f6bb4340e337f0b3bb78b66e3
+  data.tar.gz: 9554c5c27297236f1e3e588ff1e15c43090a042807afb44ef239052e5ae81bbd
 SHA512:
-  metadata.gz: d1b4943aabe48858c247a1426fe3b06399f09d5c680f15eec953188fb5dece618adab305563eb5d3ef2bfc75b59b0dd74a6ac6ff820842d0b14796c2fa2e242b
-  data.tar.gz: ecae14540e9316e5e182dae5dc27e60831241ba91905e9c8d962f58c8ca8736f1df863f2ed5832458c3a0edb0e6241fd245fbb9415b0e61b7678b0f4fffcc018
+  metadata.gz: 41e832272e313529bd070d3b0aeb909e166114a451ee4493afa60d432b979adcc996198f9ae4a95407056512df144d138362738da1d9bf5033778312440c3ebb
+  data.tar.gz: 93127946368ce2350cf0dac32d7928b5d6a3c49f9c6fca6e69dd82b10e6b7c70b12a8a0227ce68acff783ae02296eccd97ad4d59e6ce760a9474879b27087dd1

data/Gemfile

@@ -6,6 +6,7 @@ gem 'oj'
 gem 'wasmtime'
 gem 'concurrent-ruby'
 gem 'google-protobuf'
+gem 'ld-eventsource'
 
 group :development, :test do
   gem 'sorbet'

data/devcycle-ruby-server-sdk.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |s|
   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.2'
 
 
   s.add_development_dependency 'rspec', '~> 3.6', '>= 3.6.0'

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

@@ -5,6 +5,7 @@ require 'concurrent-ruby'
 require 'typhoeus'
 require 'json'
 require 'time'
+require 'ld-eventsource'
 
 module DevCycle
   class ConfigManager
@@ -19,15 +20,18 @@ module DevCycle
       @config_version = "v1"
       @local_bucketing = local_bucketing
       @sdkKey = sdkKey
+      @sse_url = ""
+      @sse_polling = false
       @config_e_tag = ""
       @config_last_modified = ""
       @logger = local_bucketing.options.logger
+      @enable_sse = local_bucketing.options.enable_beta_realtime_updates
       @polling_enabled = true
+      @sse_active = false
       @max_config_retries = 2
-
       @config_poller = Concurrent::TimerTask.new({
                                                    execution_interval: @local_bucketing.options.config_polling_interval_ms.fdiv(1000)
-                                                 }) do |task|
+                                                 }) do |_|
         fetch_config
       end
 
@@ -38,7 +42,7 @@ module DevCycle
     def initialize_config
       begin
         fetch_config
-        @config_poller.execute if @polling_enabled
+        start_polling(false)
       rescue => e
         @logger.error("DevCycle: Error Initializing Config: #{e.message}")
       ensure
@@ -46,8 +50,8 @@ module DevCycle
       end
     end
 
-    def fetch_config
-      return unless @polling_enabled
+    def fetch_config(min_last_modified: -1)
+      return unless @polling_enabled || (@sse_active && @enable_sse)
 
       req = Typhoeus::Request.new(
         get_config_url,
@@ -56,14 +60,24 @@ module DevCycle
         })
 
       begin
-        Date.parse(@config_last_modified)
+        # Blind parse the lastmodified string to check if it's a valid date.
+        # This short circuits the rest of the checks if it's not set
         if @config_last_modified != ""
-          req.options[:headers]["If-Modified-Since"] = Time.httpdate(@config_last_modified)
+          if min_last_modified != -1
+            stored_date = Date.parse(@config_last_modified)
+            parsed_sse_ts = Time.at(min_last_modified)
+            if parsed_sse_ts.utc > stored_date.utc
+              req.options[:headers]["If-Modified-Since"] = parsed_sse_ts.utc.httpdate
+            else
+              req.options[:headers]["If-Modified-Since"] = @config_last_modified
+            end
+          else
+            req.options[:headers]["If-Modified-Since"] = @config_last_modified
+          end
         end
       rescue
       end
 
-
       if @config_e_tag != ""
         req.options[:headers]['If-None-Match'] = @config_e_tag
       end
@@ -77,28 +91,33 @@ module DevCycle
           @logger.debug("Config not modified, using cache, etag: #{@config_e_tag}, last modified: #{@config_last_modified}")
           break
         when 200
-          @logger.debug("New config received, etag: #{resp.headers['Etag']} LM:#{resp.headers['Last-Modified']}")
-          lm_header = resp.headers['Last-Modified']
+          @logger.debug("New config received, etag: #{resp.headers['Etag']} LastModified:#{resp.headers['Last-Modified']}")
           begin
-            lm_timestamp = Time.rfc2822(lm_header)
+            if @config_last_modified == ""
+              set_config(resp.body, resp.headers['Etag'], resp.headers['Last-Modified'])
+              return
+            end
+
+            lm_timestamp = Time.rfc2822(resp.headers['Last-Modified'])
             current_lm = Time.rfc2822(@config_last_modified)
             if lm_timestamp == "" && @config_last_modified == "" || (current_lm.utc < lm_timestamp.utc)
-              set_config(resp.body, resp.headers['Etag'], lm_header)
-              @logger.debug("New config stored, etag: #{@config_e_tag}, last modified: #{lm_header}")
+              set_config(resp.body, resp.headers['Etag'], resp.headers['Last-Modified'])
             else
-              @logger.warn("Config response was an older config than currently stored config.")
+              @logger.warn("Config last-modified was an older date than currently stored config.")
             end
           rescue
-            @logger.warn("Failed to parse last modified header, setting config.")
-            set_config(resp.body, resp.headers['Etag'], lm_header)
+            @logger.warn("Failed to parse last modified header, setting config anyway.")
+            set_config(resp.body, resp.headers['Etag'], resp.headers['Last-Modified'])
           end
           break
         when 403
           stop_polling
+          stop_sse
           @logger.error("Failed to download DevCycle config; Invalid SDK Key.")
           break
         when 404
           stop_polling
+          stop_sse
           @logger.error("Failed to download DevCycle config; Config not found.")
           break
         when 500...599
@@ -110,7 +129,6 @@ module DevCycle
           break
         end
       end
-
       nil
     end
 
@@ -118,11 +136,21 @@ module DevCycle
       if !JSON.parse(config).is_a?(Hash)
         raise("Invalid JSON body parsed from Config Response")
       end
-
+      parsed_config = JSON.parse(config)
+
+      if parsed_config['sse'] != nil
+        raw_url = "#{parsed_config['sse']['hostname']}#{parsed_config['sse']['path']}"
+        if @sse_url != raw_url && raw_url != ""
+          stop_sse
+          @sse_url = raw_url
+          init_sse(@sse_url)
+        end
+      end
       @local_bucketing.store_config(config)
       @config_e_tag = etag
       @config_last_modified = lastmodified
       @local_bucketing.has_config = true
+      @logger.debug("New config stored, etag: #{@config_e_tag}, last modified: #{@config_last_modified}")
     end
 
     def get_config_url
@@ -130,14 +158,70 @@ module DevCycle
       "#{configBasePath}/config/#{@config_version}/server/#{@sdkKey}.json"
     end
 
-    def stop_polling
+    def start_polling(sse)
+      if sse
+        @config_poller.shutdown if @config_poller.running?
+        @config_poller = Concurrent::TimerTask.new({ execution_interval: 60 * 10 }) do |_|
+          fetch_config
+        end
+        @sse_polling = sse
+      end
+      @polling_enabled = true
+      @config_poller.execute if @polling_enabled && (!@sse_active || sse)
+    end
+
+    def stop_polling()
       @polling_enabled = false
       @config_poller.shutdown if @config_poller.running?
     end
 
+    def stop_sse
+      return unless @enable_sse
+      @sse_active = false
+      @sse_polling = false
+      @sse_client.close if @sse_client
+      start_polling(@sse_polling)
+    end
+
     def close
       @config_poller.shutdown if @config_poller.running?
       nil
     end
+
+    def init_sse(path)
+      return unless @enable_sse
+      @logger.debug("Initializing SSE with url: #{path}")
+      @sse_active = true
+      @sse_client = SSE::Client.new(path) do |client|
+        client.on_event do |event|
+
+          parsed_json = JSON.parse(event.data)
+          handle_sse(parsed_json)
+        end
+        client.on_error do |error|
+          @logger.debug("SSE Error: #{error.message}")
+        end
+      end
+    end
+
+    def handle_sse(event_data)
+      unless @sse_polling
+        stop_polling
+        start_polling(true)
+      end
+      if event_data["data"] == nil
+        return
+      end
+      @logger.debug("SSE: Message received: #{event_data["data"]}")
+      parsed_event_data = JSON.parse(event_data["data"])
+
+      last_modified = parsed_event_data["lastModified"]
+      event_type = parsed_event_data["type"]
+
+      if event_type == "refetchConfig" || event_type == nil
+        @logger.debug("SSE: Re-fetching new config with TS: #{last_modified}")
+        fetch_config(min_last_modified: last_modified / 1000)
+      end
+    end
   end
 end

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

@@ -26,6 +26,7 @@ module DevCycle
       @flush_mutex = Mutex.new
       @local_bucketing = local_bucketing
       @local_bucketing.init_event_queue(@client_uuid, options)
+
     end
 
     def close

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

@@ -3,6 +3,7 @@ module DevCycle
     attr_reader :config_polling_interval_ms
     attr_reader :enable_edge_db
     attr_reader :enable_cloud_bucketing
+    attr_reader :enable_beta_realtime_updates
     attr_reader :config_cdn_uri
     attr_reader :events_api_uri
     attr_reader :bucketing_api_uri
@@ -14,6 +15,7 @@ module DevCycle
       disable_custom_event_logging: false,
       disable_automatic_event_logging: false,
       config_polling_interval_ms: 10_000,
+      enable_beta_realtime_updates: false,
       request_timeout_ms: 5_000,
       max_event_queue_size: 2_000,
       flush_event_queue_size: 1_000,
@@ -71,6 +73,7 @@ module DevCycle
 
       @disable_custom_event_logging = disable_custom_event_logging
       @disable_automatic_event_logging = disable_automatic_event_logging
+      @enable_beta_realtime_updates = enable_beta_realtime_updates
       @config_cdn_uri = config_cdn_uri
       @events_api_uri = events_api_uri
       @bucketing_api_uri = "https://bucketing-api.devcyle.com"

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

@@ -11,5 +11,5 @@ OpenAPI Generator version: 5.3.0
 =end
 
 module DevCycle
-  VERSION = '2.7.1'
+  VERSION = '3.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: devcycle-ruby-server-sdk
 version: !ruby/object:Gem::Version
-  version: 2.7.1
+  version: 3.1.0
 platform: ruby
 authors:
 - DevCycleHQ
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-17 00:00:00.000000000 Z
+date: 2024-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -100,6 +100,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.22'
+- !ruby/object:Gem::Dependency
+  name: ld-eventsource
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.2
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement