togul 2.4.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75fde010ac0c727c425c169bff582437c313ddc71a06e6bd285cd3271848afde
-  data.tar.gz: 3fcf4a81648a4c4bf52538026fa17ef7ac4fda0e5bc2c34bc9caa74bad029a8a
+  metadata.gz: f3cdd5233b5ab5e0c0a9173d1cad50da849053ac889f1421cf65e115cc5dd615
+  data.tar.gz: d910912cdca70532ddbc022caf2e8b4b8aca2bc2faac23a64f62aa1a1af287b3
 SHA512:
-  metadata.gz: b13234a1b51798a399e6cb7e9a80274c2ef26db810df4d0f609329c097cf90cd71bddd2a6b11d00dd1b565efc43f6ff75b2f99bd8c5105c4917735dd0ac860e3
-  data.tar.gz: 1723699c586897d12cb4b29a2c8f8bbfd9563daea8ad6e1c598c035eb2efd7cead5d2fd3e823ca7ad97ea416a830100eff7287a149fdaffa26eac79e3ee8f306
+  metadata.gz: 3543177c1ed3be6bb8a4d8e8eec2c0cf430ff67e095673aa7aa1466ae3d518e24a072d08dadf8498a350dd3ebbb415dbeea96af5621db303589f5c88c2efd3ee
+  data.tar.gz: ad43d8263b6f8c0c470ac11f69b2fdef12edfd960fc3bd5da65cccc38ccef0ca75a43f7a175d264dc6952294b01faddc61873fead885c88b60aeeec38274b664

data/lib/togul/client.rb

@@ -13,84 +13,22 @@ module Togul
       @stream_client = nil
     end
 
-    # Evaluate a feature flag.
-    #
-    # @param key [String] Flag key
-    # @param context [Hash<String, String>] User/request context
-    # @return [Boolean] Whether the flag is enabled
-    def enabled?(key, context = {})
-      evaluate_result(key, context).enabled?
-    rescue StandardError
-      case @config.fallback_mode
-      when :fail_open then true
-      else false
-      end
-    end
-
-    # Evaluate a feature flag and return the full result with typed value accessors.
+    # Evaluate a feature flag and return the result mirroring the API response.
     #
     # @param key [String] Flag key
     # @param context [Hash<String, String>] User/request context
     # @return [Togul::EvaluateResult]
-    def evaluate_result(key, context = {})
+    def evaluate(key, context = {})
       cache_key = build_cache_key(key, context)
 
       cached = @cache.get(cache_key)
       return cached unless cached.nil?
 
-      result = evaluate(key, context)
+      result = fetch_evaluation(key, context)
       @cache.set(cache_key, result)
       result
     end
 
-    # Evaluate a boolean flag.
-    #
-    # @param key [String] Flag key
-    # @param context [Hash<String, String>] User/request context
-    # @param fallback [Boolean] Value to return on error or type mismatch
-    # @return [Boolean]
-    def evaluate_bool(key, context = {}, fallback: false)
-      evaluate_result(key, context).bool_value(fallback)
-    rescue StandardError
-      fallback
-    end
-
-    # Evaluate a string flag.
-    #
-    # @param key [String] Flag key
-    # @param context [Hash<String, String>] User/request context
-    # @param fallback [String] Value to return on error or type mismatch
-    # @return [String]
-    def evaluate_string(key, context = {}, fallback: '')
-      evaluate_result(key, context).string_value(fallback)
-    rescue StandardError
-      fallback
-    end
-
-    # Evaluate a number flag.
-    #
-    # @param key [String] Flag key
-    # @param context [Hash<String, String>] User/request context
-    # @param fallback [Float] Value to return on error or type mismatch
-    # @return [Float]
-    def evaluate_number(key, context = {}, fallback: 0.0)
-      evaluate_result(key, context).number_value(fallback)
-    rescue StandardError
-      fallback
-    end
-
-    # Evaluate a JSON flag.
-    #
-    # @param key [String] Flag key
-    # @param context [Hash<String, String>] User/request context
-    # @param fallback [Object] Value to return on error or type mismatch
-    # @return [Object]
-    def evaluate_json(key, context = {}, fallback: nil)
-      evaluate_result(key, context).json_value(fallback)
-    rescue StandardError
-      fallback
-    end
-
     # Clear all cached flag values.
     def invalidate_cache
       @cache.flush
@@ -113,7 +51,7 @@ module Togul
 
     private
 
-    def evaluate(key, context)
+    def fetch_evaluation(key, context)
       raise Error.new('API key is required') if @config.api_key.empty?
 
       last_error = nil
@@ -152,7 +90,7 @@ module Togul
             flag_key:   body['flag_key'] || key,
             enabled:    body['enabled'] == true,
             value_type: body['value_type'].to_s,
-            raw_value:  body['value'],
+            value:      body['value'],
             reason:     body['reason'].to_s
           )
         rescue Error

data/lib/togul/config.rb

@@ -4,13 +4,12 @@ module Togul
   class Config
     DEFAULT_BASE_URL = 'https://api.togul.io'
 
-    attr_reader :api_key, :environment, :timeout, :cache_ttl, :fallback_mode, :retry_count, :base_url
+    attr_reader :api_key, :environment, :timeout, :cache_ttl, :retry_count, :base_url
 
     # @param environment [String] Environment key (e.g. "production")
     # @param api_key [String] Environment API key for evaluate/stream requests
     # @param timeout [Numeric] HTTP timeout in seconds
     # @param cache_ttl [Integer] Cache TTL in seconds
-    # @param fallback_mode [Symbol] :fail_closed or :fail_open
     # @param retry_count [Integer] Number of retry attempts
     # @param base_url [String, nil] Override default base URL (optional)
     def initialize(
@@ -18,7 +17,6 @@ module Togul
       api_key: '',
       timeout: 5,
       cache_ttl: 30,
-      fallback_mode: :fail_closed,
       retry_count: 2,
       base_url: nil
     )
@@ -27,7 +25,6 @@ module Togul
       @environment = environment
       @timeout = timeout
       @cache_ttl = cache_ttl
-      @fallback_mode = fallback_mode
       @retry_count = retry_count
     end
   end

data/lib/togul/evaluate_result.rb

@@ -2,45 +2,18 @@
 
 module Togul
   class EvaluateResult
-    attr_reader :flag_key, :enabled, :value_type, :reason
+    attr_reader :flag_key, :enabled, :value_type, :value, :reason
 
-    def initialize(flag_key:, enabled:, value_type:, raw_value:, reason:)
+    def initialize(flag_key:, enabled:, value_type:, value:, reason:)
       @flag_key   = flag_key
       @enabled    = enabled
       @value_type = value_type
-      @raw_value  = raw_value
+      @value      = value
       @reason     = reason
     end
 
     def enabled?
       @enabled == true
     end
-
-    def bool_value(fallback = false)
-      return fallback unless enabled? && @value_type == 'boolean'
-      return fallback unless @raw_value == true || @raw_value == false
-
-      @raw_value
-    end
-
-    def string_value(fallback = '')
-      return fallback unless enabled? && @value_type == 'string'
-      return fallback unless @raw_value.is_a?(String)
-
-      @raw_value
-    end
-
-    def number_value(fallback = 0.0)
-      return fallback unless enabled? && @value_type == 'number'
-      return fallback unless @raw_value.is_a?(Numeric)
-
-      @raw_value.to_f
-    end
-
-    def json_value(fallback = nil)
-      return fallback unless enabled? && @value_type == 'json'
-
-      @raw_value.nil? ? fallback : @raw_value
-    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: togul
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Togul
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json