togul 2.4.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75fde010ac0c727c425c169bff582437c313ddc71a06e6bd285cd3271848afde
-  data.tar.gz: 3fcf4a81648a4c4bf52538026fa17ef7ac4fda0e5bc2c34bc9caa74bad029a8a
+  metadata.gz: 8b2551b63847f7928914d173351b85f54aa78f64a67552701273b9ef334ea0e2
+  data.tar.gz: cb63352498c0f05520963a92fb0f8ea17759b91823a7538d9051134ffd91120b
 SHA512:
-  metadata.gz: b13234a1b51798a399e6cb7e9a80274c2ef26db810df4d0f609329c097cf90cd71bddd2a6b11d00dd1b565efc43f6ff75b2f99bd8c5105c4917735dd0ac860e3
-  data.tar.gz: 1723699c586897d12cb4b29a2c8f8bbfd9563daea8ad6e1c598c035eb2efd7cead5d2fd3e823ca7ad97ea416a830100eff7287a149fdaffa26eac79e3ee8f306
+  metadata.gz: 7272d609f48bd5100c6e9f6bf78b00d0df4bd0a517f1e96a2c097335d6319b66d81f0f7c8485ea3a9307c7868c5ce2c74cc59bee5e8971f4884fc4247a36e843
+  data.tar.gz: 359137fd534f9dac13572955a506852ab9baa1d8c6e5a07289312075bb4d12656f3fd1e5c65dbb6df439342e18d41647e040e95a9e43ec5c20769b2010f787c3

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
@@ -101,19 +39,24 @@ module Togul
       @cache.invalidate_flag(key)
     end
 
-    # Start SSE stream for real-time cache invalidation.
-    def stream
+    # Start the SSE stream in a background thread for real-time cache invalidation.
+    # Subsequent calls are no-ops; the thread runs until the process exits.
+    def start_stream
       @stream_client ||= StreamClient.new(@config, @cache)
+      @stream_thread ||= Thread.new { @stream_client.connect }
+      nil
     end
 
     # Register a listener for cache invalidation events.
+    # Call start_stream separately to begin receiving events.
     def on_cache_invalidated(&block)
-      stream.on_cache_invalidated(&block)
+      @stream_client ||= StreamClient.new(@config, @cache)
+      @stream_client.on_cache_invalidated(&block)
     end
 
     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 +95,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

data/lib/togul/stream_client.rb

@@ -37,6 +37,8 @@ module Togul
       uri = URI("#{@config.base_url}/api/v1/stream")
       http = Net::HTTP.new(uri.host, uri.port)
       http.use_ssl = uri.scheme == 'https'
+      http.open_timeout = @config.timeout
+      http.read_timeout = nil  # SSE is long-lived; no read deadline
 
       request = Net::HTTP::Get.new(uri.path)
       request['Accept'] = 'text/event-stream'

metadata

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