flipt_client 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b557abfcc6b932d2df3477574c31e1e3531b723e40c8d4165c896223f0a4e29
-  data.tar.gz: c4b0100e653392c2b7cf2a2d0706562295e378f042192f71ec2cbe9fb81ca22b
+  metadata.gz: ad11b9c66ba85ede2dc4bd1e13ea76625b40b4eb921d0bb905d5d3b575289662
+  data.tar.gz: 7a3f3db0ec3da94f946f94491809feaf6aa6a782a7ec843c47ab7c656bd764bc
 SHA512:
-  metadata.gz: e678e1267550f6d9a13a5b14b0b1182cb6bc7158f33c15c1eaee7428250ab5975e5f71e3d67d7fd2bdb5979887a959985efdf50009540a873b6126a4804e657a
-  data.tar.gz: a11c9c16338ba2184feb4e7a39cf7131f28779414b5c86f0b20da0dcbdc926b3afcd1f1ad5e4d66ca2f5cb36f8d9735a037e0732fd37d8da3b045fb710100345
+  metadata.gz: 35a4f6593d4b5b0b5eb99e10ce97b63f4a7567767a2a9160e033654d1de56103d3016e86cb517b22cb7c38c9ef7547bdd2f8a35a8c54caadff0d5f765fffcb7f
+  data.tar.gz: 85ef57b021d738b87eb72ff66c54932820eb95a1a4d6c931c24cf4ebfa256e9e88c38ee704aad57de08960a8f73c07b94b3ef26692f8768f83079015107335dc

data/README.md

@@ -89,6 +89,7 @@ The `Flipt::EvaluationClient` constructor accepts two optional arguments:
   - `authentication`: The authentication strategy to use when communicating with the upstream Flipt instance. If not provided, the client will default to no authentication. See the [Authentication](#authentication) section for more information.
   - `reference`: The [reference](https://docs.flipt.io/guides/user/using-references) to use when fetching flag state. If not provided, reference will not be used.
   - `fetch_mode`: The fetch mode to use when fetching flag state. If not provided, the client will default to polling.
+  - `error_strategy`: The error strategy to use when fetching flag state. If not provide, the client will be default to fail. See the [Error Strategies](#error-strategies) section for more information.
 
 ### Authentication
 
@@ -98,6 +99,13 @@ The `FliptEvaluationClient` supports the following authentication strategies:
 - [Client Token Authentication](https://docs.flipt.io/authentication/using-tokens)
 - [JWT Authentication](https://docs.flipt.io/authentication/using-jwts)
 
+### Error Strategies
+
+The client supports the following error strategies:
+
+- `fail`: The client will throw an error if the flag state cannot be fetched. This is the default behavior.
+- `fallback`: The client will maintain the last known good state and use that state for evaluation in case of an error.
+
 ## Load Test
 
 1. To run the load test, you'll need to have Flipt running locally. You can do this by running the following command from the root of the repository:

data/lib/flipt_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Flipt
-  VERSION = '0.14.0'
+  VERSION = '0.15.0'
 end

data/lib/flipt_client.rb

@@ -57,22 +57,13 @@ module Flipt
     # @option opts [String] :reference reference to use for namespace data
     # @option opts [Symbol] :fetch_mode fetch mode to use for the client (:polling or :streaming).
     #   Note: Streaming is currently only supported when using the SDK with Flipt Cloud (https://flipt.io/cloud).
+    # @option opts [Symbol] :error_strategy error strategy to use for the client (:fail or :fallback).
     def initialize(namespace = 'default', opts = {})
       @namespace = namespace
 
-      # set default no auth if not provided
-      authentication = opts.fetch(:authentication, NoAuthentication.new)
-      unless authentication.is_a?(AuthenticationStrategy)
-        raise ArgumentError,
-              'invalid authentication strategy'
-      end
-
-      fetch_mode = opts.fetch(:fetch_mode, :polling)
-      unless %i[polling streaming].include?(fetch_mode)
-        raise ArgumentError, 'invalid fetch mode'
-      end
-
-      opts[:authentication] = authentication.strategy
+      opts[:authentication] = validate_authentication(opts.fetch(:authentication, NoAuthentication.new))
+      opts[:fetch_mode] = validate_fetch_mode(opts.fetch(:fetch_mode, :polling))
+      opts[:error_strategy] = validate_error_strategy(opts.fetch(:error_strategy, :fail))
 
       @engine = self.class.initialize_engine(namespace, opts.to_json)
       ObjectSpace.define_finalizer(self, self.class.finalize(@engine))
@@ -149,5 +140,23 @@ module Flipt
         raise ArgumentError, 'flag_key is required'
       end
     end
+
+    def validate_authentication(authentication)
+      return authentication.strategy if authentication.is_a?(AuthenticationStrategy)
+
+      raise ArgumentError, 'invalid authentication strategy'
+    end
+
+    def validate_fetch_mode(fetch_mode)
+      return fetch_mode if %i[polling streaming].include?(fetch_mode)
+
+      raise ArgumentError, 'invalid fetch mode'
+    end
+
+    def validate_error_strategy(error_strategy)
+      return error_strategy if %i[fail fallback].include?(error_strategy)
+
+      raise ArgumentError, 'invalid error strategy'
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flipt_client
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Flipt Devs
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-14 00:00:00.000000000 Z
+date: 2025-02-20 00:00:00.000000000 Z
 dependencies: []
 description: Flipt Client Evaluation SDK
 email: