featurehub-sdk 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc48d48647d7b4aee1a53a733506382f3e6cb021de19ae9c7192a38ff3af38a9
-  data.tar.gz: 499b54873a2cbb87e72dcb815509a8260f12ec0ffa6a4b529ac779acad7c4729
+  metadata.gz: e641291e7daf8a2bb0209ecfd7b0af27fc46b4cd17645bbe7072171ee0c8eb79
+  data.tar.gz: c37349075e7d5ccdff4776d6980f612e0e8b3bd9d5964124aab104dcf06a991a
 SHA512:
-  metadata.gz: 1f3620cf2da86a7a897efae7c766b00eaf98549c9c9b90dee97f14c67c9d32718cdf4046accfdd887622b80bb44943704fda18acfa179ed90b801c9938bd2130
-  data.tar.gz: f31beae7e13e8261b541ffc211a3a8dad8c49563918d12e178f9390b4d079bcd303d8273f5741986bc1907d12d7e646bf0f62c553527ed87ee83ca77834c1f42
+  metadata.gz: efe9d777183431e8729c37aba09384998c82d8b52eddf2835e47aba7ea60546630a09587fe6f8639c1f4daddb637c68b915daf4dbcdd362ba59b8960ca68d321
+  data.tar.gz: c028d22c9f8e32077a69e2e0bbc2ba34ea96892cfd78431f480ea020bdf9d7baec15c3af8bb3c0cbe0497c112eec372cd5615f9393fbd5b9dc73a7bcbb08f7fc

data/.claude/CLAUDE.md

@@ -83,3 +83,4 @@ Type definitions live in [sig/feature_hub/featurehub.rbs](sig/feature_hub/featur
 - RuboCop: max line length 120, metrics cops disabled, documentation disabled
 - Tests mirror lib structure: `spec/feature_hub/sdk/**/*_spec.rb`
 - Use `instance_double` for mocking, `aggregate_failures` for multiple assertions
+- after making changes run `bundle exec rubocop -a` to autocorrect minor offences and understand what major offences may have been introduced and fix them  

data/.dockerignore

@@ -0,0 +1,12 @@
+/bin
+/sig
+/spec
+/.rpsec
+/.rubocop.yml
+/*.md
+/.github
+/examples/rails-example
+/examples/sinatra/logs
+/.git
+/.idea
+/.claude

data/.rubocop.yml

@@ -35,8 +35,6 @@ Metrics/CyclomaticComplexity:
 Naming/FileName:
   Enabled: false
 
-Gemspec/DeprecatedAttributeAssignment:
-  Enabled: true
 Gemspec/DeprecatedAttributeAssignment: # new in 1.30
   Enabled: true
 Gemspec/RequireMFA: # new in 1.23

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [2.1.0] - 2026-04-14
+        
+- Once the Config is closed it won't reopen
+- Added Memcache cache that operates on the same general principles as Redis.
+It requires Dalli to be available in your dependencies at least 4.x.
+- The requirement for faraday 2+ has been relaxed, just faraday is now required in
+the gemspec. It has been tested with 2 and 1.
+- Redis session store has been updated so it only uses two keys
+
 ## [2.0.1] - 2026-03-27
 
 - Remove `FeatureHub::Sdk.default_logger`; logger now defaults to `nil` instead of a stdout DEBUG logger

data/Gemfile

@@ -15,7 +15,7 @@ gem "simplecov", "~> 0.21"
 
 gem "concurrent-ruby", "~> 1.3"
 
-gem "faraday", "~> 2"
+gem "faraday"
 
 gem "murmurhash3", "~> 0.1.7"
 

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    featurehub-sdk (2.0.1)
+    featurehub-sdk (2.1.0)
       concurrent-ruby (~> 1.3)
-      faraday (~> 2)
+      faraday
       ld-eventsource (~> 2.5.1)
       murmurhash3 (~> 0.1.7)
       sem_version (~> 2.0.0)
@@ -16,6 +16,8 @@ GEM
     ast (2.4.3)
     concurrent-ruby (1.3.6)
     connection_pool (3.0.2)
+    dalli (4.3.3)
+      logger
     diff-lcs (1.6.2)
     docile (1.4.1)
     domain_name (0.6.20240107)
@@ -113,7 +115,8 @@ PLATFORMS
 
 DEPENDENCIES
   concurrent-ruby (~> 1.3)
-  faraday (~> 2)
+  dalli (~> 4)
+  faraday
   featurehub-sdk!
   ld-eventsource (~> 2.5.1)
   murmurhash3 (~> 0.1.7)
@@ -129,12 +132,13 @@ CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
+  dalli (4.3.3) sha256=ae58aa3442b0d9e129898f56bc6e3a0f8b6149523e723b3eb124a05ae9a2da0c
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   domain_name (0.6.20240107) sha256=5f693b2215708476517479bf2b3802e49068ad82167bcd2286f899536a17d933
   faraday (2.14.0) sha256=8699cfe5d97e55268f2596f9a9d5a43736808a943714e3d9a53e6110593941cd
   faraday-net_http (3.4.2) sha256=f147758260d3526939bf57ecf911682f94926a3666502e24c69992765875906c
-  featurehub-sdk (2.0.1)
+  featurehub-sdk (2.1.0)
   ffi (1.17.3-arm64-darwin) sha256=0c690555d4cee17a7f07c04d59df39b2fba74ec440b19da1f685c6579bb0717f
   ffi (1.17.3-x86_64-darwin) sha256=1f211811eb5cfaa25998322cdd92ab104bfbd26d1c4c08471599c511f2c00bb5
   ffi (1.17.3-x86_64-linux-gnu) sha256=3746b01f677aae7b16dc1acb7cb3cc17b3e35bdae7676a3f568153fb0e2c887f

data/Makefile

@@ -0,0 +1,12 @@
+e2e:
+	docker build -t todo-server:e2e --progress=plain -f examples/sinatra/Dockerfile .
+
+run-e2e: e2e
+
+cop:
+	bundle exec rubocop -a
+
+spec:
+	bundle exec rspec
+
+ci: cop spec

data/README.md

@@ -295,34 +295,87 @@ The file path defaults to `featurehub-overrides.yaml` or the `FEATUREHUB_LOCAL_Y
 
 ## Caching feature state in Redis
 
-`RedisSessionStore` persists feature values from a `FeatureHubRepository` to Redis. On startup it replays cached features into the repository, then listens for live updates and writes newer versions back. A background timer re-reads all features periodically so updates from other processes are picked up automatically.
+`RedisSessionStore` persists feature values from a `FeatureHubRepository` to Redis. On startup it replays cached features into the repository, then listens for live updates and writes newer versions back. A background timer periodically re-reads a SHA key so that updates published by other processes are picked up automatically.
 
 > **Warning:** Do not use `RedisSessionStore` with server-evaluated features. Each server-evaluated context resolves to different values; sharing a single Redis key across processes will cause them to overwrite each other's state.
 
+Multi-process writes are safe: the store uses SHA256-based change detection and Redis `WATCH`/`MULTI`/`EXEC` to atomically update both keys and prevent races between concurrent writers.
+
+Pass a `FeatureHubConfig` as the second argument — the store reads `repository` and `environment_id` from it and registers itself as a raw update listener automatically.
+
 ```ruby
 # Requires the 'redis' gem: gem 'redis', '~> 5'
 store = FeatureHub::Sdk::RedisSessionStore.new(
   "redis://localhost:6379",
-  config.repository,
+  config,                       # FeatureHubConfig — NOT config.repository
   {
-    prefix:    "myapp",       # Redis key prefix (default: "featurehub")
-    namespace: 0,             # Redis DB index (default: 0)
-    timeout:   60,            # Seconds between periodic reloads (default: 30)
-    password:  "secret",      # Optional Redis password
-    logger:    my_logger      # Optional logger (default: SDK default logger)
+    prefix:             "myapp", # Redis key prefix (default: "featurehub")
+    db:                 0,       # Redis DB index (default: 0)
+    refresh_timeout:    300,     # Seconds between periodic SHA checks (default: 300)
+    backoff_timeout:    500,     # Milliseconds to wait between WATCH retries (default: 500)
+    retry_update_count: 10,      # Maximum WATCH retry attempts per write (default: 10)
+    logger:             my_logger # Optional logger
   }
 )
 
-# Register it so it also receives live updates
-config.register_raw_update_listener(store)
-
 # Shut down cleanly
 store.close
 ```
 
+You can also pass an existing Redis client instead of a connection string (e.g. a RedisCluster client or a pre-configured `Redis` instance):
+
+```ruby
+redis = Redis.new(url: "redis://localhost:6379", db: 1)
+store = FeatureHub::Sdk::RedisSessionStore.new(redis, config)
+```
+
+You can also pass a `RedisSessionStoreOptions` object directly:
+
+```ruby
+opts = FeatureHub::Sdk::RedisSessionStoreOptions.new(prefix: "myapp", db: 2)
+store = FeatureHub::Sdk::RedisSessionStore.new("redis://localhost:6379", config, opts)
+```
+
 Redis keys used:
-- `{prefix}_ids` — a Redis SET of feature IDs
-- `{prefix}_{id}` — the JSON-encoded feature state for each feature
+- `{prefix}_{environment_id}` — JSON-encoded array of all feature states
+- `{prefix}_{environment_id}_sha` — SHA256 fingerprint used for cross-process change detection
+
+## Caching feature state in Memcache
+
+`MemcacheSessionStore` persists feature values from a `FeatureHubRepository` to Memcache. On startup it reads any previously saved features from Memcache and replays them into the repository, then listens for live updates and writes newer versions back. A background timer periodically re-reads a SHA key so that updates published by other processes are picked up automatically.
+
+> **Warning:** Do not use `MemcacheSessionStore` with server-evaluated features. Each server-evaluated context resolves to different values; sharing a single Memcache key across processes will cause them to overwrite each other's state.
+
+Multi-process writes are safe: the store uses SHA256-based change detection and Dalli's compare-and-set (`cas`) to prevent races between concurrent writers.
+
+```ruby
+# Requires the 'dalli' gem: gem 'dalli', '~> 5'
+store = FeatureHub::Sdk::MemcacheSessionStore.new(
+  "localhost:11211",
+  config,
+  {
+    prefix:             "myapp",  # Key prefix (default: "featurehub")
+    refresh_timeout:    300,      # Seconds between periodic SHA checks (default: 300)
+    backoff_timeout:    500,      # Milliseconds to wait between CAS retries (default: 500)
+    retry_update_count: 10,       # Maximum CAS retry attempts per write (default: 10)
+    logger:             my_logger # Optional logger (default: SDK default logger)
+  }
+)
+
+# Shut down cleanly
+store.close
+```
+
+You can also pass an existing `Dalli::Client` instead of a connection string:
+
+```ruby
+dalli = Dalli::Client.new("localhost:11211", serializer: JSON)
+store = FeatureHub::Sdk::MemcacheSessionStore.new(dalli, config)
+```
+
+Memcache keys used:
+- `{prefix}_{environment_id}` — JSON-encoded array of all feature states
+- `{prefix}_{environment_id}_sha` — SHA256 fingerprint used for cross-process change detection
 
 ## Custom raw update listeners
 
@@ -346,7 +399,7 @@ end
 config.register_raw_update_listener(MyAuditListener.new)
 ```
 
-Callbacks are dispatched asynchronously via `Concurrent::Future`. The `source` parameter will be `"streaming"`, `"polling"`, `"local-yaml"`, `"redis-store"`, or `"unknown"`.
+Callbacks are dispatched asynchronously via `Concurrent::Future`. The `source` parameter will be `"streaming"`, `"polling"`, `"local-yaml"`, `"redis-store"`, `"memcache-store"`, or `"unknown"`.
 
 All listeners are closed automatically when `config.close` or `repository.close` is called.
 

data/examples/sinatra/Dockerfile

@@ -1,31 +1,31 @@
-FROM ruby:3.3.10-bookworm
+FROM phusion/passenger-ruby33:latest
 
 MAINTAINER info@featurehub.io
-ENV BUNDLER_VERSION 2.3.15
+ENV BUNDLER_VERSION 4.0.3
 ARG DEBIAN_FRONTEND=noninteractive
 
-RUN apt update && \
-    apt install -y gnupg wget tzdata apt-transport-https dirmngr gnupg curl && \
-    curl https://oss-binaries.phusionpassenger.com/auto-software-signing-gpg-key-2025.txt | gpg --dearmor | tee /etc/apt/trusted.gpg.d/phusion.gpg >/dev/null && \
-        sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger bookworm main > /etc/apt/sources.list.d/passenger.list' && \
-        apt-get update && \
-        apt-get install -y nginx passenger
-
-#ENV BUNDLE_PATH /bundle
-RUN passenger-config build-native-support
+# The purpose of this Dockerfile is to build a test to-do server that can be used against the
+# e2e tests. It *MUST* test the SDK on the current HEAD, so the file is complicated and awkward
+# and not like a typical deploy.
 
 RUN echo 'gem: --no-document' >> ~/.gemrc && \
     gem update --system && \
     gem install bundler -v ${BUNDLER_VERSION}  --force
 
+RUN gem uninstall logger -v 1.6.0
+
 # set up nsswitch
 COPY examples/sinatra/conf/nsswitch.conf /etc/nsswitch.conf
 
-RUN mkdir -p /app/featurehub
 COPY examples/sinatra/conf/nginx.conf /etc/nginx/nginx.conf
-COPY . /app/
+ADD . /app/featurehub
 WORKDIR /app/featurehub
-RUN cd /app/featurehub && bundle install
-ADD examples/sinatra/ /app/featurehub
+RUN rm Gemfile Gemfile.lock && cd examples/sinatra && bundle config set --local deployment 'true' --without 'development test' path 'vendor/bundle'
+RUN cd /app/featurehub/examples/sinatra && cat .bundle/config && mkdir logs
+RUN cd /app/featurehub/examples/sinatra && bundle install
+RUN chown -R nobody /app
+ENV BUNDLE_PATH=/app/featurehub/examples/sinatra/vendor/bundle
 
-CMD /usr/sbin/nginx -g \'daemon off;\'
+USER root
+CMD /usr/sbin/nginx -g 'daemon off;'
+#CMD /usr/bin/bash

data/examples/sinatra/Gemfile

@@ -4,7 +4,11 @@ source "https://rubygems.org"
 
 ruby "3.3.10"
 
+# 5 prevents us using ruby 3.2 which while EOL is still in our build
+gem "dalli", "~> 4"
 gem "featurehub-sdk", path: "../.."
+# this is just to test 1.x works OK
+gem "faraday", "~> 1"
 gem "rack"
 gem "redis"
 gem "sinatra"

data/examples/sinatra/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: ../..
   specs:
-    featurehub-sdk (2.0.0)
+    featurehub-sdk (2.1.0)
       concurrent-ruby (~> 1.3)
-      faraday (~> 2)
+      faraday
       ld-eventsource (~> 2.5.1)
       murmurhash3 (~> 0.1.7)
       sem_version (~> 2.0.0)
@@ -16,15 +16,35 @@ GEM
     concurrent-ruby (1.3.6)
     connection_pool (3.0.2)
     daemons (1.4.1)
+    dalli (4.3.3)
+      logger
     domain_name (0.6.20240107)
     eventmachine (1.2.7)
-    faraday (2.14.1)
-      faraday-net_http (>= 2.0, < 3.5)
-      json
-      logger
-    faraday-net_http (3.4.2)
-      net-http (~> 0.5)
+    faraday (1.10.5)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.1)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.2.0)
+      multipart-post (~> 2.0)
+    faraday-net_http (1.0.2)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.4)
     ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
     ffi-compiler (1.3.2)
       ffi (>= 1.15.5)
       rake
@@ -36,7 +56,6 @@ GEM
     http-cookie (1.1.0)
       domain_name (~> 0.5)
     http-form_data (2.3.0)
-    json (2.19.2)
     ld-eventsource (2.5.1)
       concurrent-ruby (~> 1.0)
       http (>= 4.4.1, < 6.0.0)
@@ -44,11 +63,10 @@ GEM
       ffi-compiler (~> 1.0)
       rake (~> 13.0)
     logger (1.7.0)
+    multipart-post (2.4.1)
     murmurhash3 (0.1.7)
     mustermann (2.0.2)
       ruby2_keywords (~> 0.0.1)
-    net-http (0.9.1)
-      uri (>= 0.11.1)
     public_suffix (7.0.5)
     rack (2.2.6.4)
     rack-protection (2.2.3)
@@ -72,7 +90,6 @@ GEM
       eventmachine (~> 1.0, >= 1.0.4)
       rack (>= 1, < 3)
     tilt (2.1.0)
-    uri (1.1.1)
 
 PLATFORMS
   x86_64-darwin-21
@@ -80,6 +97,8 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  dalli (~> 4)
+  faraday (~> 1)
   featurehub-sdk!
   rack
   redis

data/examples/sinatra/README.adoc

@@ -4,7 +4,23 @@ This is a simple todo server example that we use to run our Cucumber tests again
 to ensure that the SDK is operating as expected. Please read the `application.rb`
 for details on how it works, it is fairly simple.
 
-It can be built into a Passenger dockerfile using the `build.sh` script and started
-using `docker_start.sh`
+NOTE: The `Dockerfile` is intended for use in the e2e tests in the pipeline and is not a general use-case sample. It uses Passenger, Sinatra and the FeatureHub SDK on this specific branch. It is, as such, constructed from the root directory (using the `Makefile`).
 
+We typically want to run one cache and then two copies of the server. We would normally disconnect the primary server (running on 8099) from edge, leaving the second server running (8100) and writing to the cache.
 
+To disconnect from edge, call `curl localhost:8099/health/disconnect`
+
+The tests should still pass as the primary server is picking up changes from the cache.
+
+== Redis
+
+----
+docker run -d -p 6379:6379 --name redis redis
+
+----
+
+== Memcache
+
+----
+docker run -p 11211:11211 --name memcache -d memcached
+----

data/examples/sinatra/app/application.rb

@@ -5,14 +5,21 @@ require "sinatra"
 require "featurehub-sdk"
 require "json"
 
-def configure_featurehub
+def configure_featurehub(logger)
   puts "FeatureHub SDK Version is #{FeatureHub::Sdk::VERSION}"
 
-  config = FeatureHub::Sdk::FeatureHubConfig.new
+  config = FeatureHub::Sdk::FeatureHubConfig.new(nil, nil, nil, nil, logger)
   repo = config.repository
 
   if ENV["FEATUREHUB_REDIS_STORE"]
-    config.register_raw_update_listener(FeatureHub::Sdk::RedisSessionStore.new(ENV["FEATUREHUB_REDIS_STORE"], repo))
+    FeatureHub::Sdk::RedisSessionStore.new(ENV["FEATUREHUB_REDIS_STORE"], config,
+                                           { logger: logger, refresh_timeout: 3 })
+  end
+
+  if ENV["FEATUREHUB_MEMCACHE_STORE"]
+    FeatureHub::Sdk::MemcacheSessionStore.new(ENV["FEATUREHUB_MEMCACHE_STORE"],
+                                              config, { logger: logger,
+                                                        refresh_timeout: 3 })
   end
 
   if ENV["FEATUREHUB_LOCAL_YAML"]
@@ -20,6 +27,7 @@ def configure_featurehub
     config.register_interceptor(FeatureHub::Sdk::LocalYamlValueInterceptor.new(watch: true))
   end
 
+  puts "connecting to FeatureHub"
   # connect to edge service
   config.init
 end
@@ -34,7 +42,9 @@ class App < Sinatra::Base
     rack = File.new("logs/rack.log", "a+")
     use Rack::CommonLogger, rack
 
-    set :fh_config, configure_featurehub
+    logger = Logger.new($stdout)
+    set :logger, logger
+    set :fh_config, configure_featurehub(logger)
     set :users, {}
   end
 
@@ -42,10 +52,6 @@ class App < Sinatra::Base
     content_type "application/json"
   end
 
-  get("/config/disconnect-edge") do
-    settings.fh_config.close_edge
-  end
-
   # Routes
   # "resolve" a specific todo for this user
   put("/todo/:user/:id/resolve") do
@@ -83,6 +89,7 @@ class App < Sinatra::Base
     if new_todo["title"].nil?
       status(400)
     else
+      settings.logger.debug("todo is #{new_todo}")
       todos.push(Todo.new(new_todo["id"] || 1, new_todo["title"], new_todo["resolved"] || false))
       todo_list(user)
     end
@@ -94,13 +101,26 @@ class App < Sinatra::Base
   end
 
   get("/health/readiness") do
-    if config.repository.ready?
+    if settings.fh_config.repository.ready?
+      "ok"
+    else
+      status(500)
+    end
+  end
+
+  get("/health/liveness") do
+    if settings.fh_config.repository.ready?
       "ok"
     else
       status(500)
     end
   end
 
+  get("/health/disconnect") do
+    settings.fh_config.close_edge
+    status 200
+  end
+
   private
 
   def todo_list(user)
@@ -113,6 +133,7 @@ class App < Sinatra::Base
       new_todos.push(Todo.new(todo.id, process_title(ctx, todo.title), todo.resolved).to_h)
     end
 
+    settings.logger.debug("todos #{new_todos}")
     new_todos.to_json
   end
 
@@ -139,15 +160,6 @@ class App < Sinatra::Base
 
     new_title = new_title.upcase if ctx.enabled?("FEATURE_TITLE_TO_UPPERCASE")
 
-    # puts("features via repository: #{settings.fh_config.repository.features}")
-    # puts("features via edge service: #{settings.fh_config.get_or_create_edge_service.repository}")
-
-    # puts("enabled? #{ctx.repo.features}")
-    puts(ctx.enabled?("FEATURE_TITLE_TO_UPPERCASE"))
-    puts(ctx.flag("FEATURE_TITLE_TO_UPPERCASE"))
-    puts(settings.fh_config.repository.feature("FEATURE_TITLE_TO_UPPERCASE").feature_type)
-    puts(settings.fh_config.repository.feature("FEATURE_TITLE_TO_UPPERCASE").flag)
-
-    new_title&.strip
+    new_title
   end
 end

data/examples/sinatra/conf/nginx.conf

@@ -11,15 +11,6 @@ events {
 http {
 
 
-  passenger_user_switching on;
-  passenger_user root;
-  passenger_default_user root;
-
-  passenger_max_pool_size 6;
-
-  passenger_disable_security_update_check on;
-  passenger_disable_anonymous_telemetry on;
-
   include /etc/nginx/conf/vhosts/*.conf;
   include /etc/nginx/conf.d/*.conf;
 
@@ -33,8 +24,9 @@ http {
     access_log /dev/stdout;
     listen 8099 default_server;
     server_name localhost;
-    root /app/featurehub;
-    passenger_app_root /app/featurehub;
+    root /app/featurehub/examples/sinatra;
+    passenger_app_root /app/featurehub/examples/sinatra;
+    passenger_preload_bundler on;
     passenger_enabled on;
     passenger_startup_file config.ru;
     passenger_app_type rack;

data/examples/sinatra/conf/webapp.conf

@@ -0,0 +1,16 @@
+server {
+    listen 80;
+    server_name localhost;
+    root /app/featurehub/examples/sinatra;
+
+    passenger_enabled on;
+    passenger_user root;
+
+    # If this is a Ruby app, specify a Ruby version:
+    # For Ruby 3.3
+    passenger_ruby /usr/bin/ruby3.3;
+
+    # Nginx has a default limit of 1 MB for request bodies, which also applies
+    # to file uploads. The following line enables uploads of up to 50 MB:
+    #client_max_body_size 50M;
+}

data/examples/sinatra/docker-compose.yaml

@@ -1,6 +1,6 @@
 services:
   party-server:
-    image: featurehub/party-server:1.9.4
+    image: featurehub/party-server:latest
     ports:
       - 8085:8085
     user: 999:999
@@ -12,13 +12,41 @@ services:
     image: redis:latest
     ports:
       - 6379:6379
-  ruby-sinatra:
-    image: ruby-sinatra:latest
+  memcache:
+    image: memcached:1.6-alpine
+    ports:
+      - 11211:11211
+  sinatra:
+    image: todo-server:e2e
+    ports:
+      - 8099:8099
+    environment:
+      RAILS_ENV: production
+      FEATUREHUB_CLIENT_API_KEY: "a1286d73-a23b-4f5b-8fdf-04dd03668fb9/xPlhDYnWlKjjZ3maUPquhOUOmk50gn*Hh8Q5qY6JEURrxtEEjzk"
+      FEATUREHUB_EDGE_URL: http://party-server:8085
+      FEATUREHUB_BASE_URL: http://party-server:8085
+  sinatra-redis:
+    image: todo-server:e2e
+    ports:
+      - 8099:8099
+    environment:
+      FEATUREHUB_POLLING_INTERVAL: "3"
+      FEATUREHUB_CLIENT_API_KEY: "a1286d73-a23b-4f5b-8fdf-04dd03668fb9/xPlhDYnWlKjjZ3maUPquhOUOmk50gn*Hh8Q5qY6JEURrxtEEjzk"
+      FEATUREHUB_EDGE_URL: http://party-server:8085
+      FEATUREHUB_BASE_URL: http://party-server:8085
+      FEATUREHUB_REDIS_STORE: redis://redis:6379
+  sinatra-memcache:
+    image: todo-server:e2e
     ports:
       - 8099:8099
     environment:
+      RAILS_ENV: production
+      FEATUREHUB_POLLING_INTERVAL: "3"
+      FEATUREHUB_CLIENT_API_KEY: "a1286d73-a23b-4f5b-8fdf-04dd03668fb9/xPlhDYnWlKjjZ3maUPquhOUOmk50gn*Hh8Q5qY6JEURrxtEEjzk"
       FEATUREHUB_EDGE_URL: http://party-server:8085
       FEATUREHUB_BASE_URL: http://party-server:8085
-      FEATUREHUB_REDIS_STORE: redis
+      FEATUREHUB_MEMCACHE_STORE: memcache
+    depends_on:
+      - memcache
 volumes:
   featurehub-h2-data: