sdk-reforge 1.9.0

data/test/test_sse_config_client.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+require 'webrick'
+require 'ostruct'
+
+class TestSSEConfigClient < Minitest::Test
+  def test_client
+    sources = [
+      'https://primary.goatsofreforge.com'
+    ]
+
+    options = Reforge::Options.new(sources: sources, sdk_key: ENV.fetch('REFORGE_INTEGRATION_TEST_SDK_KEY', nil))
+
+    config_loader = OpenStruct.new(highwater_mark: 4)
+
+    client = Reforge::SSEConfigClient.new(options, config_loader)
+
+    assert_equal 4, client.headers['Last-Event-ID']
+    assert_equal "https://stream.goatsofreforge.com", client.source
+
+    result = nil
+
+    # fake our load_configs block
+    client.start do |c, _event, source|
+      result = c
+      assert_equal :sse, source
+    end
+
+    wait_for -> { !result.nil? }
+
+    assert result.configs.size > 30
+  ensure
+    client.close
+  end
+
+  def test_failing_over
+    sources = [
+      'https://does.not.exist.staging-prefab.cloud/',
+      'https://api.goatsofreforge.com/'
+    ]
+
+    prefab_options = Reforge::Options.new(sources: sources, sdk_key: ENV.fetch('REFORGE_INTEGRATION_TEST_SDK_KEY', nil))
+
+    config_loader = OpenStruct.new(highwater_mark: 4)
+
+    sse_options = Reforge::SSEConfigClient::Options.new(seconds_between_new_connection: 0.01, sleep_delay_for_new_connection_check: 0.01)
+
+    client = Reforge::SSEConfigClient.new(prefab_options, config_loader, sse_options)
+
+    assert_equal 4, client.headers['Last-Event-ID']
+
+    result = nil
+
+    # fake our load_configs block
+    client.start do |c, _event, source|
+      result = c
+      assert_equal :sse, source
+    end
+
+    wait_for -> { !result.nil? }
+
+    assert result.configs.size > 30
+  ensure
+    client.close
+
+    assert_logged [
+      %r{failed to connect: .*https://does.not.exist},
+      /HTTP::ConnectionError/
+    ]
+  end
+
+  def test_recovering_from_disconnection
+    server, = start_webrick_server(4567, DisconnectingEndpoint)
+
+    config_loader = OpenStruct.new(highwater_mark: 4)
+
+    prefab_options = OpenStruct.new(sse_sources: ['http://localhost:4567'], sdk_key: 'test')
+    last_event_id = nil
+    client = nil
+
+    begin
+      Thread.new do
+        server.start
+      end
+
+      sse_options = Reforge::SSEConfigClient::Options.new(
+        sse_default_reconnect_time: 0.1
+      )
+      client = Reforge::SSEConfigClient.new(prefab_options, config_loader, sse_options)
+
+      client.start do |_configs, event, _source|
+        last_event_id = event.id.to_i
+      end
+
+      wait_for -> { last_event_id && last_event_id > 1 }
+    ensure
+      client.close
+      server.stop
+
+      refute_nil last_event_id, 'Expected to have received an event'
+      assert last_event_id > 1, 'Expected to have received multiple events (indicating a retry)'
+    end
+  end
+
+  def test_recovering_from_an_error
+    log_output = StringIO.new
+    logger = Logger.new(log_output)
+
+    server, = start_webrick_server(4568, ErroringEndpoint)
+
+    config_loader = OpenStruct.new(highwater_mark: 4)
+
+    prefab_options = OpenStruct.new(sse_sources: ['http://localhost:4568'], sdk_key: 'test')
+    last_event_id = nil
+    client = nil
+
+    begin
+      Thread.new do
+        server.start
+      end
+
+      sse_options = Reforge::SSEConfigClient::Options.new(
+        sse_default_reconnect_time: 0.1,
+        seconds_between_new_connection: 0.1,
+        sleep_delay_for_new_connection_check: 0.1,
+        errors_to_close_connection: [SSE::Errors::HTTPStatusError]
+      )
+      client = Reforge::SSEConfigClient.new(prefab_options, config_loader, sse_options, logger)
+
+      client.start do |_configs, event, _source|
+        last_event_id = event.id.to_i
+      end
+
+      wait_for -> { last_event_id && last_event_id > 2 }
+    ensure
+      server.stop
+      client.close
+
+      refute_nil last_event_id, 'Expected to have received an event'
+      assert last_event_id > 2, 'Expected to have received multiple events (indicating a reconnect)'
+    end
+
+    log_lines = log_output.string.split("\n")
+
+    assert_match(/SSE Streaming Connect/, log_lines[0])
+    assert_match(/SSE Streaming Error/, log_lines[1], 'Expected to have logged an error. If this starts failing after an ld-eventsource upgrade, you might need to tweak NUMBER_OF_FAILURES below')
+    assert_match(/Closing SSE connection/, log_lines[2])
+    assert_match(/Reconnecting SSE client/, log_lines[3])
+    assert_match(/SSE Streaming Connect/, log_lines[4])
+  end
+
+  def start_webrick_server(port, endpoint_class)
+    log_string = StringIO.new
+    logger = WEBrick::Log.new(log_string)
+    server = WEBrick::HTTPServer.new(Port: port, Logger: logger, AccessLog: [])
+    server.mount '/api/v2/sse/config', endpoint_class
+
+    [server, log_string]
+  end
+
+  module SharedEndpointLogic
+    def event_id
+      @@event_id ||= 0
+      @@event_id += 1
+    end
+
+    def setup_response(response)
+      response.status = 200
+      response['Content-Type'] = 'text/event-stream'
+      response['Cache-Control'] = 'no-cache'
+      response['Connection'] = 'keep-alive'
+
+      response.chunked = false
+    end
+  end
+
+  class DisconnectingEndpoint < WEBrick::HTTPServlet::AbstractServlet
+    include SharedEndpointLogic
+
+    def do_GET(_request, response)
+      setup_response(response)
+
+      output = response.body
+
+      output << "id: #{event_id}\n"
+      output << "event: message\n"
+      output << "data: CmYIu8fh4YaO0x4QZBo0bG9nLWxldmVsLmNsb3VkLnByZWZhYi5zZXJ2ZXIubG9nZ2luZy5FdmVudFByb2Nlc3NvciIfCAESG2phbWVzLmtlYmluZ2VyQHByZWZhYi5jbG91ZDgGSAkSDQhkELvH4eGGjtMeGGU=\n\n"
+    end
+  end
+
+  class ErroringEndpoint < WEBrick::HTTPServlet::AbstractServlet
+    include SharedEndpointLogic
+    NUMBER_OF_FAILURES = 5
+
+    def do_GET(_request, response)
+      setup_response(response)
+
+      output = response.body
+
+      output << "id: #{event_id}\n"
+
+      if event_id < NUMBER_OF_FAILURES
+        raise 'ErroringEndpoint' # This manifests as an SSE::Errors::HTTPStatusError
+      end
+
+      output << "event: message\n"
+      output << "data: CmYIu8fh4YaO0x4QZBo0bG9nLWxldmVsLmNsb3VkLnByZWZhYi5zZXJ2ZXIubG9nZ2luZy5FdmVudFByb2Nlc3NvciIfCAESG2phbWVzLmtlYmluZ2VyQHByZWZhYi5jbG91ZDgGSAkSDQhkELvH4eGGjtMeGGU=\n\n"
+    end
+  end
+end

data/test/test_weighted_value_resolver.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class TestWeightedValueResolver < Minitest::Test
+  KEY = 'config_key'
+
+  def test_resolving_single_value
+    values = weighted_values([['abc', 1]])
+    resolver = Reforge::WeightedValueResolver.new(values, KEY, nil)
+    assert_equal 'abc', resolver.resolve[0].value.string
+    assert_equal 0, resolver.resolve[1]
+  end
+
+  def test_resolving_multiple_values_evenly_distributed
+    values = weighted_values([['abc', 1], ['def', 1]])
+
+    resolver = Reforge::WeightedValueResolver.new(values, KEY, 'user:001')
+    assert_equal 'abc', resolver.resolve[0].value.string
+    assert_equal 0, resolver.resolve[1]
+
+    resolver = Reforge::WeightedValueResolver.new(values, KEY, 'user:456')
+    assert_equal 'def', resolver.resolve[0].value.string
+    assert_equal 1, resolver.resolve[1]
+  end
+
+  def test_resolving_multiple_values_unevenly_distributed
+    values = weighted_values([['abc', 1], ['def', 98], ['ghi', 1]])
+
+    resolver = Reforge::WeightedValueResolver.new(values, KEY, 'user:456')
+    assert_equal 'def', resolver.resolve[0].value.string
+    assert_equal 1, resolver.resolve[1]
+
+    resolver = Reforge::WeightedValueResolver.new(values, KEY, 'user:103')
+    assert_equal 'ghi', resolver.resolve[0].value.string
+    assert_equal 2, resolver.resolve[1]
+
+    resolver = Reforge::WeightedValueResolver.new(values, KEY, 'user:119')
+    assert_equal 'abc', resolver.resolve[0].value.string
+    assert_equal 0, resolver.resolve[1]
+  end
+
+  def test_resolving_multiple_values_with_simulation
+    values = weighted_values([['abc', 1], ['def', 98], ['ghi', 1]])
+    results = {}
+
+    10_000.times do |i|
+      result = Reforge::WeightedValueResolver.new(values, KEY, "user:#{i}").resolve[0].value.string
+      results[result] ||= 0
+      results[result] += 1
+    end
+
+    assert_in_delta 100, results['abc'], 20
+    assert_in_delta 9800, results['def'], 50
+    assert_in_delta 100, results['ghi'], 20
+  end
+
+  private
+
+  def weighted_values(values_and_weights)
+    values_and_weights.map do |value, weight|
+      weighted_value(value, weight)
+    end
+  end
+
+  def weighted_value(string, weight)
+    PrefabProto::WeightedValue.new(
+      value: PrefabProto::ConfigValue.new(string: string), weight: weight
+    )
+  end
+end

metadata

@@ -0,0 +1,345 @@
+--- !ruby/object:Gem::Specification
+name: sdk-reforge
+version: !ruby/object:Gem::Version
+  version: 1.9.0
+platform: ruby
+authors:
+- Jeff Dwyer
+bindir: bin
+cert_chain: []
+date: 2025-09-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.5
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: googleapis-common-protos-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ld-eventsource
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: uuid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: semantic_logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "!="
+      - !ruby/object:Gem::Version
+        version: 4.16.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "!="
+      - !ruby/object:Gem::Version
+        version: 4.16.0
+- !ruby/object:Gem::Dependency
+  name: allocation_stats
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: juwelier
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.4.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.4.9
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Feature Flags, Live Config as a service
+email: jeff.dwyer@reforge.com.cloud
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+files:
+- ".envrc.sample"
+- ".github/CODEOWNERS"
+- ".github/pull_request_template.md"
+- ".github/workflows/ruby.yml"
+- ".gitmodules"
+- ".rubocop.yml"
+- ".tool-versions"
+- CHANGELOG.md
+- CODEOWNERS
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- compile_protos.sh
+- dev/allocation_stats
+- dev/benchmark
+- dev/console
+- dev/script_setup.rb
+- lib/prefab_pb.rb
+- lib/reforge-sdk.rb
+- lib/reforge/caching_http_connection.rb
+- lib/reforge/client.rb
+- lib/reforge/config_client.rb
+- lib/reforge/config_client_presenter.rb
+- lib/reforge/config_loader.rb
+- lib/reforge/config_resolver.rb
+- lib/reforge/config_value_unwrapper.rb
+- lib/reforge/config_value_wrapper.rb
+- lib/reforge/context.rb
+- lib/reforge/context_shape.rb
+- lib/reforge/context_shape_aggregator.rb
+- lib/reforge/criteria_evaluator.rb
+- lib/reforge/duration.rb
+- lib/reforge/encryption.rb
+- lib/reforge/error.rb
+- lib/reforge/errors/env_var_parse_error.rb
+- lib/reforge/errors/initialization_timeout_error.rb
+- lib/reforge/errors/invalid_sdk_key_error.rb
+- lib/reforge/errors/missing_default_error.rb
+- lib/reforge/errors/missing_env_var_error.rb
+- lib/reforge/errors/uninitialized_error.rb
+- lib/reforge/evaluation.rb
+- lib/reforge/evaluation_summary_aggregator.rb
+- lib/reforge/example_contexts_aggregator.rb
+- lib/reforge/exponential_backoff.rb
+- lib/reforge/feature_flag_client.rb
+- lib/reforge/fixed_size_hash.rb
+- lib/reforge/http_connection.rb
+- lib/reforge/internal_logger.rb
+- lib/reforge/javascript_stub.rb
+- lib/reforge/local_config_parser.rb
+- lib/reforge/murmer3.rb
+- lib/reforge/options.rb
+- lib/reforge/periodic_sync.rb
+- lib/reforge/prefab.rb
+- lib/reforge/rate_limit_cache.rb
+- lib/reforge/resolved_config_presenter.rb
+- lib/reforge/semver.rb
+- lib/reforge/sse_config_client.rb
+- lib/reforge/time_helpers.rb
+- lib/reforge/weighted_value_resolver.rb
+- lib/reforge/yaml_config_parser.rb
+- test/fixtures/datafile.json
+- test/integration_test.rb
+- test/integration_test_helpers.rb
+- test/support/common_helpers.rb
+- test/support/mock_base_client.rb
+- test/support/mock_config_client.rb
+- test/support/mock_config_loader.rb
+- test/test_caching_http_connection.rb
+- test/test_client.rb
+- test/test_config_client.rb
+- test/test_config_loader.rb
+- test/test_config_resolver.rb
+- test/test_config_value_unwrapper.rb
+- test/test_config_value_wrapper.rb
+- test/test_context.rb
+- test/test_context_shape.rb
+- test/test_context_shape_aggregator.rb
+- test/test_criteria_evaluator.rb
+- test/test_duration.rb
+- test/test_encryption.rb
+- test/test_evaluation_summary_aggregator.rb
+- test/test_example_contexts_aggregator.rb
+- test/test_exponential_backoff.rb
+- test/test_feature_flag_client.rb
+- test/test_fixed_size_hash.rb
+- test/test_helper.rb
+- test/test_integration.rb
+- test/test_internal_logger.rb
+- test/test_javascript_stub.rb
+- test/test_local_config_parser.rb
+- test/test_logger_initialization.rb
+- test/test_options.rb
+- test/test_prefab.rb
+- test/test_rate_limit_cache.rb
+- test/test_semver.rb
+- test/test_sse_config_client.rb
+- test/test_weighted_value_resolver.rb
+homepage: http://github.com/ReforgeHQ/sdk-ruby
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Reforge Launch Ruby Infrastructure
+test_files: []