toggly 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 810c3cb9858347a1cb79212512e006bf2362ee97cd09c7a528eb334c0bf949cc
-  data.tar.gz: 7f6ef5ce376a28c1101ce65c1d82080c02e6b254487ed0908479c1a622adffeb
+  metadata.gz: 8e7e0a87a56b437ad26a416ec236125cdffab5f1ed3ac0a65260da717c58c04d
+  data.tar.gz: 4e3a36875f88ee85dbe81ae51cb72226b97cd3951d8034ddf600d2f8a5ce8da6
 SHA512:
-  metadata.gz: e0c8fbd59c7cfa8baafd73f580da168fe0fe4114e802f0e55bec3c406994e8a4a169b773dbf6e97862f831157d7b011df18f6210cda33740a56a6f515c05fcfc
-  data.tar.gz: 92d791902d6bf591f9731647caa1963b2c589bf12255afe376b1f1fa9591437d9af10388503b54bbbf06e911afb41fb2b557be60c9564dd09eec423037fcbdab
+  metadata.gz: 0e8ddc1874675e6536462478a8245f964470951cede5dae334c13383cd34af96627a6be8a1f8778eb0b2941dc74433714113b85167f88a472ff88d7e1b763094
+  data.tar.gz: d743ba544845147aff474191418ab201a3945c3e8edad5ccb78d34364d175a8a8aa1b0cf38ac5c3122f95517670b75416261821b5dd75d214fe0d3483b789a72

data/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2026-10-04
+
+### Added
+- `Toggly::SegmentMembership` for Backend-key targeting-list membership updates.
+
+## [1.2.1] - 2026-09-28
+
+### Fixed
+
+- Always apply HTTP 200 definition bodies when the storage revision matches.
+  Same-revision responses still count as cache hits for telemetry after the
+  body is applied [OPS-1568].
+
 ## [1.2.0] - 2026-09-24
 
 ### Added

data/lib/toggly/client.rb

@@ -24,6 +24,8 @@ module Toggly
   #   )
   #   client = Toggly::Client.new(config)
   class Client
+    UNHANDLED_VARIANT_VALUE = Object.new.freeze
+
     include CacheTelemetry
     include SnapshotSupport
 
@@ -359,30 +361,43 @@ module Toggly
       return block.call(value) if block
       return nil if as.nil?
 
-      # Scalars / :boolean before Class#new — String.new({}) would soft-fail to "".
-      if as == String
-        return value.is_a?(String) ? value : nil
-      end
-      if as == Integer
-        return value.is_a?(Integer) && !value.is_a?(TrueClass) && !value.is_a?(FalseClass) ? value : nil
-      end
-      if as == Float
-        return value.is_a?(Numeric) && !value.is_a?(TrueClass) && !value.is_a?(FalseClass) ? value.to_f : nil
-      end
-      if [TrueClass, FalseClass, :boolean].include?(as)
-        return [true, false].include?(value) ? value : nil
-      end
+      scalar_value = decode_scalar_variant_value(value, as)
+      return scalar_value unless scalar_value.equal?(UNHANDLED_VARIANT_VALUE)
 
       # is_a? requires a Module; symbols like :boolean are handled above.
       return value if as.is_a?(Module) && value.is_a?(as)
-      return as.new(**value.transform_keys(&:to_sym)) if as.respond_to?(:new) && value.is_a?(Hash)
-      return as.json_create(value) if as.respond_to?(:json_create) && value.is_a?(Hash)
 
-      nil
+      decode_variant_object(value, as)
     rescue StandardError
       nil
     end
 
+    # Scalars / :boolean before Class#new — String.new({}) would soft-fail to "".
+    def decode_scalar_variant_value(value, as)
+      return value.is_a?(String) ? value : nil if as == String
+      return numeric_variant_value(value, Integer) if as == Integer
+      return numeric_variant_value(value, Float) if as == Float
+      return [true, false].include?(value) ? value : nil if [TrueClass, FalseClass, :boolean].include?(as)
+
+      UNHANDLED_VARIANT_VALUE
+    end
+
+    def numeric_variant_value(value, type)
+      return nil if value.is_a?(TrueClass) || value.is_a?(FalseClass)
+      return value if type == Integer && value.is_a?(Integer)
+      return value.to_f if type == Float && value.is_a?(Numeric)
+
+      nil
+    end
+
+    def decode_variant_object(value, as)
+      return nil unless value.is_a?(Hash)
+      return as.new(**value.transform_keys(&:to_sym)) if as.respond_to?(:new)
+      return as.json_create(value) if as.respond_to?(:json_create)
+
+      nil
+    end
+
     # `definitions` / `definitions-signed` → local rule eval. The sole
     # source of truth for `enabled?`; also carries `variants` / `allocation`
     # for the catalog-local `get_variant` assignment.

data/lib/toggly/definitions_provider.rb

@@ -189,9 +189,11 @@ module Toggly
         log_debug("Definitions not modified")
         FetchResult.new(definitions: nil, cache_outcome: :hit)
       when :same_revision
-        log_debug("Definitions revision matches existing (ETag or Last-Modified)")
-        store_revision_headers(response_etag, response_lm)
-        FetchResult.new(definitions: nil, cache_outcome: :hit)
+        # Same storage revision is a telemetry hit, but HTTP 200 still carries
+        # an authoritative body — apply it (parity with Go/Rust/Python).
+        log_debug("Definitions revision matches existing; applying HTTP 200 body")
+        result = handle_new_content(response, response_etag, response_lm)
+        FetchResult.new(definitions: result.definitions, cache_outcome: :hit)
       when :new_content
         handle_new_content(response, response_etag, response_lm)
       when :error_status

data/lib/toggly/segment_membership.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module Toggly
+  # Backend-key client for targeting-list membership on app.toggly.io.
+  class SegmentMembership
+    def initialize(app_key:, app_base_url: "https://app.toggly.io")
+      raise ArgumentError, "app_key is required" if app_key.nil? || app_key.empty?
+
+      @app_key = app_key
+      @base = app_base_url.sub(%r{/+\z}, "")
+    end
+
+    def list_segments
+      request(Net::HTTP::Get, "/api/v2/segments")
+    end
+
+    def add_segment_members(segment, identifiers)
+      request(Net::HTTP::Post, items_path(segment), { identifiers: identifiers })
+    end
+
+    def remove_segment_members(segment, identifiers)
+      request(Net::HTTP::Delete, items_path(segment), { identifiers: identifiers })
+    end
+
+    def replace_segment_members(segment, identifiers)
+      request(Net::HTTP::Put, items_path(segment), { identifiers: identifiers })
+    end
+
+    private
+
+    def items_path(segment)
+      "/api/v2/segments/#{URI.encode_www_form_component(segment).gsub("+", "%20")}/items"
+    end
+
+    def request(klass, path, body = nil)
+      uri = URI.parse("#{@base}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = 30
+      http.read_timeout = 30
+      req = klass.new(uri)
+      req["Authorization"] = @app_key
+      req["Accept"] = "application/json"
+      if body
+        req["Content-Type"] = "application/json"
+        req.body = JSON.generate(body)
+      end
+      response = http.request(req)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise Toggly::NetworkError.new(
+          "Segment membership failed",
+          status_code: response.code.to_i,
+          response_body: response.body
+        )
+      end
+
+      # Mutations may return 204/empty bodies; do not JSON-parse blank payloads.
+      body = response.body.to_s
+      return nil if body.strip.empty?
+
+      JSON.parse(body)
+    end
+  end
+end

data/lib/toggly/variant_allocator.rb

@@ -112,13 +112,12 @@ module Toggly
       return nil if list.empty?
 
       pct = compute_percentile(identity, seed, feature_key, ignore_case)
-      list.each do |entry|
+      matching_entry = list.find do |entry|
         from = entry[:from].to_f
         to = entry[:to].to_f
-        matched = to >= 100.0 ? pct >= from : (pct >= from && pct < to)
-        return entry[:variant] if matched
+        to >= 100.0 ? pct >= from : (pct >= from && pct < to)
       end
-      nil
+      matching_entry&.fetch(:variant, nil)
     end
 
     # MF-parity percentile hash.

data/lib/toggly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Toggly
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

data/lib/toggly.rb

@@ -37,6 +37,7 @@ require_relative "toggly/snapshot_providers/file"
 require_relative "toggly/definition_cache"
 require_relative "toggly/definitions_provider"
 require_relative "toggly/client"
+require_relative "toggly/segment_membership"
 
 # Toggly - Feature Flag Management SDK for Ruby
 #
@@ -71,6 +72,8 @@ require_relative "toggly/client"
 #     }
 #   )
 module Toggly
+  NOT_CONFIGURED_ERROR = "Toggly not configured. Call Toggly.configure first."
+
   class << self
     # Global client instance
     attr_accessor :client
@@ -92,7 +95,7 @@ module Toggly
     # @param context [Context, nil] Optional evaluation context
     # @return [Boolean]
     def enabled?(feature_key, context: nil)
-      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+      raise Error, NOT_CONFIGURED_ERROR unless @client
 
       @client.enabled?(feature_key, context: context)
     end
@@ -113,7 +116,7 @@ module Toggly
     # @param context [Context, nil]
     # @return [VariantResult, nil]
     def get_variant(feature_key, context: nil)
-      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+      raise Error, NOT_CONFIGURED_ERROR unless @client
 
       @client.get_variant(feature_key, context: context)
     end
@@ -124,7 +127,7 @@ module Toggly
     # @param context [Context, nil]
     # @return [Object, nil]
     def get_variant_value(feature_key, context: nil, as: nil, &)
-      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+      raise Error, NOT_CONFIGURED_ERROR unless @client
 
       @client.get_variant_value(feature_key, context: context, as: as, &)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toggly
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Ops.ai
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-25 00:00:00.000000000 Z
+date: 2026-10-06 00:00:00.000000000 Z
 dependencies: []
 description: High-performance Ruby SDK for Toggly feature flag management. Works with
   or without Toggly.io.
@@ -52,6 +52,7 @@ files:
 - lib/toggly/http_request_mapper.rb
 - lib/toggly/registry.rb
 - lib/toggly/request_context.rb
+- lib/toggly/segment_membership.rb
 - lib/toggly/snapshot_providers/base.rb
 - lib/toggly/snapshot_providers/file.rb
 - lib/toggly/snapshot_providers/memory.rb