featureflow 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2865ebc3fed1dfffb613a9a459ce6e0ac8d6e5cd05d758b4e93944cbc8d8d372
-  data.tar.gz: 1b5a7d4b01a2ff98501ca2818e3d00a4d4523525e9e71cd4cda1a847ef009867
+  metadata.gz: d5b0b34f2239d222c1899b7b7af000ab6ee80dc31c481076c73a3220a8f6e76b
+  data.tar.gz: fc7e045b04d49220ed536cd885aa7ecdcd63f85d22feed2b41fab7ca6ea434bf
 SHA512:
-  metadata.gz: 8c1fb252dcd6beac50457f7d8328198b7512d4bad761824d665490dc0a8fa59026aa55901adf0555dbfce12599ecbf1b611695801d150b29a76ee747abb1aadd
-  data.tar.gz: 712e342d59b58327b4ec1bf98770946ef255f39dbecc2093dc50fa786252b82f6aed33b06a1faacbd5c7e9f60aa65f750a37e454c4ec6f03f8a8cb9f96bb87c2
+  metadata.gz: 7c7834c0bd38d21c36bdbfe588491916b4d3f99c50bfce8ab33a654849fb3d58920918eada5616fc168373792c8373e86f5fbb239c210d1ce213bdd1c643002d
+  data.tar.gz: 362fae11135765cb677f26ee3619b57b499bc569d4af61119add4410704dfdcebae7e79d4652314f9d8d185f34dff8502383b0cc9ebf4b81f2d6003f3ea1fb8f

data/CHANGELOG.md

@@ -1,4 +1,12 @@
 # Change log
+## [0.8.0] - 2026-08-13
+### Added
+- `application` configuration option (falling back to the `FEATUREFLOW_APPLICATION`
+  environment variable): names this workload, sent as `X-Featureflow-Application` on
+  every request so the dashboard can attribute usage and flag evaluations per
+  application. Slug-validated client-side (case forgiven; an invalid value is dropped
+  with a warning and no header is sent).
+
 ## [0.7.0] - 2026-08-11
 ### Fixed
 - Condition operators fail closed instead of raising into the host application: an

data/README.md

@@ -153,6 +153,22 @@ featureflow.evaluate('key-three', user).is? 'custom' # == true
 
 ```
 
+#### Naming your application
+
+Optionally tag this workload with an application name so the Featureflow dashboard can
+attribute SDK usage and flag evaluations to it (Admin → SDKs, and the "Evaluated by"
+panel on each feature's statistics tab):
+
+```ruby
+featureflow = Featureflow::Client.new(api_key: FEATUREFLOW_SERVER_KEY,
+                                      application: 'checkout-api')
+```
+
+The name is a slug — lowercase letters, numbers, `.`, `_` and `-`, at most 64
+characters. An invalid value is dropped with a warning and no tag is sent. The
+`FEATUREFLOW_APPLICATION` environment variable is used when the option is not set in
+code.
+
 #### Further documentation
 Further documentation can be found [here](http://docs.featureflow.io/docs)
 

data/lib/featureflow/application.rb

@@ -0,0 +1,28 @@
+module Featureflow
+  # Validates the configured application tag, sent as the X-Featureflow-Application
+  # header on every request so the dashboard can attribute usage per workload.
+  #
+  # Contract slug (featureflow-client-sdk-testbed/CONTRACT.md): lowercase [a-z0-9._-],
+  # max 64 chars. The server sanitises defensively; the SDK validates strictly so a
+  # typo is a visible warning here rather than a silently mangled tag there.
+  class Application
+    PATTERN = /\A[a-z0-9._-]{1,64}\z/.freeze
+
+    # Case is forgiven (lowercased); anything else invalid is dropped with a warning
+    # and no X-Featureflow-Application header is sent.
+    def self.sanitise(raw)
+      return nil if raw.nil? || raw == ''
+      unless raw.is_a?(String)
+        Featureflow.logger.warn "ignoring application #{raw.inspect} - must be a string"
+        return nil
+      end
+      value = raw.strip.downcase
+      unless PATTERN.match?(value)
+        Featureflow.logger.warn "ignoring application #{raw.inspect} - must be lowercase " \
+                                'a-z, 0-9, dot, underscore or hyphen, max 64 chars'
+        return nil
+      end
+      value
+    end
+  end
+end

data/lib/featureflow/client.rb

@@ -1,4 +1,5 @@
 require 'time'
+require 'featureflow/application'
 require 'featureflow/evaluate'
 require 'featureflow/polling_client'
 require 'featureflow/events_client'
@@ -10,6 +11,10 @@ module Featureflow
       @configuration.validate!
       @features = {}
 
+      # Optional workload name sent as X-Featureflow-Application on every request so
+      # usage and flag evaluations are attributable per application in the dashboard.
+      @application = Application.sanitise(@configuration.application)
+
       Featureflow.logger.info 'initializing client'
 
       @failover_variants = {}
@@ -20,7 +25,7 @@ module Featureflow
       end
 
       unless @configuration.disable_events
-        @events_client = EventsClient.new @configuration.event_endpoint, @configuration.api_key
+        @events_client = EventsClient.new @configuration.event_endpoint, @configuration.api_key, @application
         @events_client.register_features @configuration.with_features
       end
 
@@ -39,7 +44,8 @@ module Featureflow
         @configuration.endpoint,
         @configuration.api_key,
         poll_interval: 10,
-        timeout: 30
+        timeout: 30,
+        application: @application
       )
     end
 

data/lib/featureflow/configuration.rb

@@ -5,12 +5,16 @@ class Featureflow::Configuration
   attr_accessor :disable_events
   attr_accessor :with_features
   attr_accessor :logger
+  # Optional workload name for per-application usage attribution in the dashboard;
+  # sent as X-Featureflow-Application on every request. See Featureflow::Application.
+  attr_accessor :application
   
   DEFAULT_ENDPOINT = 'https://app.featureflow.io'
   DEFAULT_EVENT_ENDPOINT = 'https://events.featureflow.io'
 
   def initialize
     self.api_key = ENV["FEATUREFLOW_SERVER_KEY"]
+    self.application = ENV["FEATUREFLOW_APPLICATION"]
     self.endpoint = DEFAULT_ENDPOINT
     self.event_endpoint = DEFAULT_EVENT_ENDPOINT
     self.disable_events = false

data/lib/featureflow/events_client.rb

@@ -7,9 +7,11 @@ module Featureflow
   #LOCK = Mutex.new
 
   class EventsClient
-    def initialize(url, api_key)
+    def initialize(url, api_key, application = nil)
       @url = url
       @api_key = api_key
+      # Already sanitised by the Client (see lib/featureflow/application.rb).
+      @application = application
       @eventsQueue = Queue.new
       @scheduler = start_scheduler
     end
@@ -104,15 +106,17 @@ module Featureflow
 =end
 
     private def send_event(event_name, method, path, body)
+      headers = {
+        'Authorization' => "Bearer #{@api_key}",
+        'Content-Type' => 'application/json;charset=UTF-8',
+        'Accept' => 'Application/Json',
+        'X-Featureflow-Client' => 'RubyClient/' + Featureflow::VERSION
+      }
+      headers['X-Featureflow-Application'] = @application if @application
       connection = Excon.new(@url)
       response = connection.request(method: method,
                                     path: path,
-                                    headers: {
-                                        'Authorization' => "Bearer #{@api_key}",
-                                        'Content-Type' => 'application/json;charset=UTF-8',
-                                        'Accept' => 'Application/Json',
-                                        'X-Featureflow-Client' => 'RubyClient/' + Featureflow::VERSION
-                                    },
+                                    headers: headers,
                                     omit_default_port: true,
                                     body: JSON.generate(body))
       if response.status >= 400

data/lib/featureflow/polling_client.rb

@@ -5,7 +5,8 @@ module Featureflow
   class PollingClient
     DEFAULT_OPTIONS = {
       poll_interval: 30,
-      timeout: 30
+      timeout: 30,
+      application: nil
     }.freeze
     LOCK = Mutex.new
 
@@ -35,12 +36,16 @@ module Featureflow
     end
 
     def load_features
-      response = Excon.get(@url +  + '/api/sdk/v1/features', headers: {
+      headers = {
         'Authorization' => "Bearer #{@api_key}",
         'Accept' => 'Application/Json',
         'If-None-Match' => @etag,
         'X-Featureflow-Client' => 'RubyClient/' + Featureflow::VERSION
-      }, omit_default_port: true, read_timeout: @options[:timeout])
+      }
+      # Write-only telemetry: never affects the response, so it cannot fragment the CDN cache.
+      headers['X-Featureflow-Application'] = @options[:application] if @options[:application]
+      response = Excon.get(@url +  + '/api/sdk/v1/features', headers: headers,
+                           omit_default_port: true, read_timeout: @options[:timeout])
 
       if response.status == 200
         Featureflow.logger.debug "updating features"

data/lib/featureflow/version.rb

@@ -1,3 +1,3 @@
 module Featureflow
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureflow
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Oliver Oldfield-Hodge
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -105,6 +105,7 @@ files:
 - LICENSE
 - README.md
 - lib/featureflow.rb
+- lib/featureflow/application.rb
 - lib/featureflow/client.rb
 - lib/featureflow/conditions.rb
 - lib/featureflow/configuration.rb