toggly 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a484fa27dd7cc53210f2af73984c93d9109205f797172203aea42c44c4722569
-  data.tar.gz: 79a64ed42c9497e8ce8ca0f59d4dc3c21e52e68ba5e24b3b76680767d2a4787b
+  metadata.gz: 8e7e0a87a56b437ad26a416ec236125cdffab5f1ed3ac0a65260da717c58c04d
+  data.tar.gz: 4e3a36875f88ee85dbe81ae51cb72226b97cd3951d8034ddf600d2f8a5ce8da6
 SHA512:
-  metadata.gz: 07f924fb8addc26c7af35f31f0a023680201f097cfa6b26826c333a2dc3a2086c07ae094ca23413daf176546a886dbd39598914a79c0ae6cd35c8c0aeb5df564
-  data.tar.gz: 353559ba9d83853a589d843f01b52cbdb9287074b7be77505784515df99b2505317d54225456b7818c210d050b5cd170abe1a8bc315545dad5f534f9a7537244
+  metadata.gz: 0e8ddc1874675e6536462478a8245f964470951cede5dae334c13383cd34af96627a6be8a1f8778eb0b2941dc74433714113b85167f88a472ff88d7e1b763094
+  data.tar.gz: d743ba544845147aff474191418ab201a3945c3e8edad5ccb78d34364d175a8a8aa1b0cf38ac5c3122f95517670b75416261821b5dd75d214fe0d3483b789a72

data/CHANGELOG.md

@@ -5,6 +5,11 @@ 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

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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Toggly
-  VERSION = "1.2.1"
+  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
 #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toggly
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Ops.ai
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-04 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