featurehub-sdk 2.0.1 → 2.1.0

data/examples/sinatra/sinatra.iml

@@ -10,22 +10,31 @@
     <orderEntry type="library" scope="PROVIDED" name="concurrent-ruby (v1.3.6, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="connection_pool (v3.0.2, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="daemons (v1.4.1, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="dalli (v4.3.3, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="domain_name (v0.6.20240107, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="eventmachine (v1.2.7, rbenv: 3.3.10) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="faraday (v2.14.1, rbenv: 3.3.10) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="faraday-net_http (v3.4.2, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday (v1.10.5, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-em_http (v1.0.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-em_synchrony (v1.0.1, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-excon (v1.1.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-httpclient (v1.0.1, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-multipart (v1.2.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-net_http (v1.0.2, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-net_http_persistent (v1.2.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-patron (v1.0.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-rack (v1.0.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday-retry (v1.0.4, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ffi (v1.17.3, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ffi-compiler (v1.3.2, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="http (v5.3.1, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="http-cookie (v1.1.0, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="http-form_data (v2.3.0, rbenv: 3.3.10) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="json (v2.19.2, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="ld-eventsource (v2.5.1, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="llhttp-ffi (v0.5.1, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="logger (v1.7.0, rbenv: 3.3.10) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="multipart-post (v2.4.1, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="murmurhash3 (v0.1.7, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="mustermann (v2.0.2, rbenv: 3.3.10) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="net-http (v0.9.1, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="public_suffix (v7.0.5, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rack (v2.2.6.4, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rack-protection (v2.2.3, rbenv: 3.3.10) [gem]" level="application" />
@@ -38,6 +47,5 @@
     <orderEntry type="library" scope="PROVIDED" name="sinatra (v2.2.3, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="thin (v1.8.1, rbenv: 3.3.10) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="tilt (v2.1.0, rbenv: 3.3.10) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="uri (v1.1.1, rbenv: 3.3.10) [gem]" level="application" />
   </component>
 </module>

data/examples/sinatra/start.sh

@@ -1,5 +1,20 @@
-#!/bin/sh
+#!/bin/bash
 RACK_ENV=development
-#export FEATUREHUB_REDIS_STORE=redis://localhost:6379
-export FEATUREHUB_LOCAL_YAML=feature-flags.yaml
-bundle exec thin -R thin.ru -a 0.0.0.0 -p 8099 start
+if [[ "$1" == "redis" ]]; then
+  echo "detected redis"
+  export FEATUREHUB_REDIS_STORE=redis://localhost:6379
+fi
+if [[ "$1" == "memcache" ]]; then
+  echo "detected memcache"
+  export FEATUREHUB_MEMCACHE_STORE=localhost:11211
+fi
+if [[ "$1" == "local" ]]; then
+  echo "detected local yaml"
+  export FEATUREHUB_LOCAL_YAML=feature-flags.yaml
+fi
+PORT=8099
+if [[ "$2" == "sec" ]];  then
+  PORT=8100
+fi
+
+bundle exec thin -R thin.ru -a 0.0.0.0 -p $PORT start

data/featurehub-sdk.gemspec

@@ -35,11 +35,12 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "concurrent-ruby", "~> 1.3"
-  spec.add_dependency "faraday", "~> 2"
+  spec.add_dependency "faraday"
   spec.add_dependency "ld-eventsource", "~> 2.5.1"
   spec.add_dependency "murmurhash3", "~> 0.1.7"
   spec.add_dependency "sem_version", "~> 2.0.0"
 
   # we will dynamically determine if redis is available
+  spec.add_development_dependency "dalli", "~> 4"
   spec.add_development_dependency "redis", "~> 5"
 end

data/lib/feature_hub/sdk/context.rb

@@ -171,7 +171,7 @@ module FeatureHub
       end
 
       def build
-        @edge.poll
+        @edge&.poll
         self
       end
 
@@ -190,6 +190,8 @@ module FeatureHub
       end
 
       def build
+        return self unless @edge
+
         new_header = @attributes.map { |k, v| "#{k}=#{URI.encode_www_form_component(v[0].to_s)}" } * "&"
 
         if @old_header.nil? && new_header.empty?

data/lib/feature_hub/sdk/feature_hub_config.rb

@@ -25,12 +25,16 @@ module FeatureHub
 
     # central dispatch class for FeatureHub SDK
     class FeatureHubConfig
+      FALLBACK_ENVIRONMENT_ID = "569b0129-d53d-4516-a818-9154af601047"
+
       attr_reader :edge_url, :api_keys, :client_evaluated, :logger
 
       def initialize(edge_url = nil, api_keys = nil, repository = nil, edge_provider = nil, logger = nil) # rubocop:disable Metrics/ParameterLists
         @logger = logger
         @repository = repository || FeatureHub::Sdk::FeatureHubRepository.new(nil, @logger)
 
+        @closed = false
+
         resolved_url = resolve_edge_url(edge_url)
         resolved_keys = resolve_api_keys(api_keys)
 
@@ -84,6 +88,8 @@ module FeatureHub
 
       # rubocop:disable Naming/AccessorMethodName
       def get_or_create_edge_service
+        return nil if @closed
+
         @edge_service = create_edge_service if @edge_service.nil?
 
         @edge_service
@@ -91,6 +97,7 @@ module FeatureHub
       # rubocop:enable Naming/AccessorMethodName
 
       def edge_service_provider(edge_provider = nil)
+        return nil if @closed
         return @edge_service_provider if edge_provider.nil?
 
         @edge_service_provider = edge_provider
@@ -103,7 +110,8 @@ module FeatureHub
         edge_provider
       end
 
-      def use_polling_edge_service(interval = ENV.fetch("FEATUREHUB_POLL_INTERVAL", "30").to_i)
+      def use_polling_edge_service(interval = ENV.fetch("FEATUREHUB_POLL_INTERVAL",
+                                                        ENV.fetch("FEATUREHUB_POLLING_INTERVAL", "30")).to_i)
         @interval = interval
         @edge_service_provider = method(:create_polling_edge_provider)
       end
@@ -111,32 +119,43 @@ module FeatureHub
       def new_context
         get_or_create_edge_service
 
+        edge_service = @closed ? nil : @edge_service
+
         if @client_evaluated
-          ClientEvalFeatureContext.new(@repository, @edge_service)
+          ClientEvalFeatureContext.new(@repository, edge_service)
         else
-          ServerEvalFeatureContext.new(@repository, @edge_service)
+          ServerEvalFeatureContext.new(@repository, edge_service)
         end
       end
 
       def close
         unless @repository.nil?
+          @logger&.info("[featurehubsdk] repository now closed")
           @repository.close
           @repository = nil
         end
 
-        return if @edge_service.nil?
-
-        @edge_service.close
-        @edge_service = nil
+        close_edge
       end
 
       def close_edge
+        return if @closed
+
+        @logger&.info("[featurehubsdk] edge now closed")
+        @closed = true
         return if @edge_service.nil?
 
         @edge_service.close
         @edge_service = nil
       end
 
+      def environment_id
+        return FALLBACK_ENVIRONMENT_ID if @api_keys.empty?
+
+        parts = @api_keys.first.split("/")
+        parts.length == 3 ? parts[1] : parts[0]
+      end
+
       private
 
       def create_edge_service
@@ -148,7 +167,12 @@ module FeatureHub
       end
 
       def create_default_provider(repo, api_keys, edge_url, logger)
-        FeatureHub::Sdk::StreamingEdgeService.new(repo, api_keys, edge_url, logger)
+        if ENV["FEATUREHUB_POLL_INTERVAL"] || ENV["FEATUREHUB_POLLING_INTERVAL"]
+          use_polling_edge_service
+          create_polling_edge_provider(repo, api_keys, edge_url, logger)
+        else
+          FeatureHub::Sdk::StreamingEdgeService.new(repo, api_keys, edge_url, logger)
+        end
       end
 
       def resolve_edge_url(edge_url)

data/lib/feature_hub/sdk/feature_state_holder.rb

@@ -92,6 +92,12 @@ module FeatureHub
         !value.nil?
       end
 
+      def phantom?
+        return @parent_state&.phantom? unless @parent_state.nil?
+
+        @internal_feature_state.empty?
+      end
+
       def top_feature_state
         return @parent_state&.top_feature_state if @parent_state
 

data/lib/feature_hub/sdk/memcache_session_store.rb

@@ -0,0 +1,221 @@
+# frozen_string_literal: true
+
+require "json"
+require "concurrent-ruby"
+require_relative "session_store_helpers"
+
+module FeatureHub
+  module Sdk
+    # Optional configuration for MemcacheSessionStore.
+    class MemcacheSessionStoreOptions
+      attr_reader :prefix, :backoff_timeout, :retry_update_count, :refresh_timeout, :logger
+
+      def initialize(opts = nil)
+        opts ||= {}
+        @prefix = opts[:prefix] || "featurehub"
+        @backoff_timeout = opts[:backoff_timeout] || 500
+        @retry_update_count = opts[:retry_update_count] || 10
+        @refresh_timeout = opts[:refresh_timeout] || 300
+        @logger = opts[:logger]
+      end
+    end
+
+    # Persists feature values from a FeatureHubRepository in Memcache so they survive
+    # process restarts and are shared across multiple processes.
+    #
+    # Uses SHA256-based change detection and compare-and-set for multi-process safety.
+    #
+    # WARNING: Do not use with server-evaluated features. Each server-evaluated context
+    # sends different resolved values; storing them in a shared Memcache key will cause
+    # processes to overwrite each other's feature states.
+    #
+    # On initialization the store reads any previously saved features from Memcache and
+    # replays them into the repository. A periodic timer re-reads the SHA key so that
+    # updates published by other processes are picked up automatically.
+    class MemcacheSessionStore < RawUpdateFeatureListener
+      include SessionStoreHelpers
+
+      SOURCE = "memcache-store"
+
+      # @param connection_or_client [String, Dalli::Client] Memcache connection string or existing client
+      # @param config [FeatureHubConfig] SDK config (provides repository and environment_id)
+      # @param opts [MemcacheSessionStoreOptions, Hash, nil] optional configuration
+      def initialize(connection_or_client, config, opts = nil)
+        super()
+
+        options = opts.is_a?(MemcacheSessionStoreOptions) ? opts : MemcacheSessionStoreOptions.new(opts)
+
+        @repository = config.repository
+        @environment_id = config.environment_id
+        @prefix = options.prefix
+        @backoff_timeout = options.backoff_timeout
+        @retry_update_count = options.retry_update_count
+        @refresh_timeout = options.refresh_timeout
+        @internal_sha = nil
+        @mutex = Mutex.new
+        @task = nil
+        @logger = options.logger
+
+        return unless dalli_available?
+
+        @dalli = if connection_or_client.is_a?(String)
+                   Dalli::Client.new(connection_or_client, serializer: JSON)
+                 else
+                   connection_or_client
+                 end
+
+        @logger&.debug("[featurehubsdk] started memcache store")
+        Concurrent::Future.execute { load_from_memcache }
+        start_timer
+      end
+
+      def process_updates(features, source)
+        return if source == SOURCE || !dalli_available?
+
+        incoming_sha = calculate_sha(features)
+        return if incoming_sha == @dalli.get(sha_key)
+
+        perform_store_with_retry do |memcache_features|
+          has_newer = features.any? do |f|
+            existing = memcache_features.find { |mf| mf["id"] == f["id"] }
+            existing.nil? || version_of(f) > version_of(existing)
+          end
+          has_newer ? merge_features(memcache_features, features) : nil
+        end
+      end
+
+      def process_update(feature, source)
+        return if source == SOURCE || !dalli_available?
+
+        perform_store_with_retry do |memcache_features|
+          existing = memcache_features.find { |f| f["id"] == feature["id"] }
+          next nil if existing && version_of(existing) >= version_of(feature)
+
+          merge_features(memcache_features, [feature])
+        end
+      end
+
+      def delete_feature(feature, source)
+        return if source == SOURCE || !dalli_available? || !feature["id"]
+
+        perform_store_with_retry do |memcache_features|
+          updated = memcache_features.reject { |f| f["id"] == feature["id"] }
+          updated.length < memcache_features.length ? updated : nil
+        end
+      end
+
+      def close
+        return if @task.nil?
+
+        @task.shutdown
+        @task = nil
+      end
+
+      private
+
+      def dalli_available?
+        @dalli_available ||= begin
+          require "dalli"
+          true
+        rescue LoadError
+          false
+        end
+      end
+
+      def load_from_memcache
+        sha = @dalli.get(sha_key)
+        @mutex.synchronize { @internal_sha = sha }
+
+        features = read_features_from_memcache
+        return if features.empty?
+
+        @logger&.debug("[featurehubsdk] loading #{features.size} feature(s) from memcache")
+        @repository.notify("features", features, SOURCE)
+      end
+
+      def start_timer
+        @task = Concurrent::TimerTask.new(execution_interval: @refresh_timeout, run_now: false) do
+          check_for_updates
+        end
+        @task.execute
+      end
+
+      def check_for_updates
+        return unless dalli_available?
+
+        current_sha = @dalli.get(sha_key)
+        stored_sha = @mutex.synchronize { @internal_sha }
+        return if current_sha == stored_sha
+
+        features = read_features_from_memcache
+        @logger&.debug("[featurehubsdk] detected memcache change, reloading #{features.size} feature(s)")
+        @repository.notify("features", features, SOURCE)
+        @mutex.synchronize { @internal_sha = current_sha }
+      end
+
+      # Computes what to write by yielding the current memcache features to the block.
+      # The block returns the new features array to store, or nil to abort.
+      # Uses compare-and-set with retry to handle multi-process contention.
+      def perform_store_with_retry
+        attempt = 0
+        while attempt < @retry_update_count
+          memcache_features = read_features_from_memcache
+          new_features = yield(memcache_features)
+          return if new_features.nil?
+
+          new_sha = calculate_sha(new_features)
+          current_internal = @mutex.synchronize { @internal_sha }
+          return if new_sha == current_internal
+
+          current_sha = @dalli.get(sha_key)
+
+          if current_sha != current_internal
+            # Another process updated memcache — reload and recheck on next attempt
+            sleep(@backoff_timeout / 1000.0) unless attempt == @retry_update_count - 1
+            attempt += 1
+            next
+          end
+
+          stored = attempt_atomic_write(current_sha, new_sha, current_internal)
+
+          if stored
+            @dalli.set(features_key, new_features.to_json)
+            @mutex.synchronize { @internal_sha = new_sha }
+            return
+          end
+
+          sleep(@backoff_timeout / 1000.0) unless attempt == @retry_update_count - 1
+          attempt += 1
+        end
+
+        @logger&.warn("[featurehubsdk] failed to update memcache after #{@retry_update_count} retries")
+      end
+
+      def attempt_atomic_write(current_sha, new_sha, current_internal)
+        if current_sha.nil?
+          !!@dalli.add(sha_key, new_sha)
+        else
+          stored = false
+          @dalli.cas(sha_key) do |current|
+            if current == current_internal
+              stored = true
+              new_sha
+            else
+              current # write back same value — harmless no-op if CAS token still valid
+            end
+          end
+          stored
+        end
+      end
+
+      def read_features_from_memcache
+        json = @dalli.get(features_key)
+        return [] unless json
+
+        JSON.parse(json)
+      rescue JSON::ParserError
+        []
+      end
+    end
+  end
+end