brainzlab 0.1.24 → 0.1.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ab7b5c063e4371cad8decac72f4f0508c3ad4da1fedd8041a97c2f6601ee601
-  data.tar.gz: c3af39c85de1dee2a20cc4586809c5e7634fe8aa85f4145716b56e342119e48b
+  metadata.gz: e904bb588651bb7902dad92287cd8965c3bf4eb2f744b0e325c2e60239d135df
+  data.tar.gz: b0b3116d3d81af097d0f88563e6a4e93f6d0cd02ee2a9c8423ee86bd2b0eb14c
 SHA512:
-  metadata.gz: 5581a93b79f51388c3d0ea6c5a1681418618bafbabfdb6e688210e7ae07cdf5d1a047fb414434c5f5171b95363734197555b5be6a2b6ad4c7f75cdf5740ce61f
-  data.tar.gz: 3a71004cb62f9a74fb3fdd5979da80757ffd06b30461bfb970217fb972c01c92904db9949bf52a7b48e4d5b5c20f2f745e63b908b4d49ea5c84ce3bebcc0e553
+  metadata.gz: a0bc7313cc6650ad775914d76de538508744e3da8cda7e319777a9fc7fdc0c2d77336b0c53f0f3db172ac686e23539e94b077c0f1641fcf9828d22dbed520740
+  data.tar.gz: a84b9e3ce514e58105803243d8f4d608f22643dc2ac73affa8a2c89107383b7f8088a793016c1026ef9577bb4de39e75e85bee79c6574a533b3828e910a5ce0b

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.25] - 2026-06-07
+
+### Added
+
+- **`BrainzLab::Cortex` management ("send") operations** — the Cortex client can now write feature flags, not just read them:
+  - `Cortex.create_flag(:key, name:, type:, description:, tags:)` → `POST /api/v1/flags`
+  - `Cortex.enable!(:key, environment:)` / `Cortex.disable!(:key, environment:)` → idempotent `POST /api/v1/flags/:key/toggle` with an explicit `enabled` flag
+  - `Cortex.set_percentage(:key, pct, environment:)` → `POST /api/v1/flags/:key/set_percentage`
+  - Writes clear the local flag cache. Reads (`enabled?`/`get`/`variant`/`all`/`list_flags`) and provisioning (`POST /api/v1/projects/provision`) now align with the Cortex service contract.
+
 ## [0.1.13] - 2026-02-24
 
 ### Fixed

data/lib/brainzlab/cortex/client.rb

@@ -75,6 +75,50 @@ module BrainzLab
         nil
       end
 
+      # Create (push) a flag definition. Returns the created flag hash or nil.
+      def create_flag(attrs)
+        response = request(:post, '/api/v1/flags', body: { flag: attrs })
+
+        return nil unless created_or_ok?(response)
+
+        JSON.parse(response.body, symbolize_names: true)[:flag]
+      rescue StandardError => e
+        log_error('create_flag', e)
+        nil
+      end
+
+      # Set a flag's enabled state in an environment. Returns the new state or nil.
+      def toggle(flag_name, enabled:, environment:)
+        response = request(
+          :post,
+          "/api/v1/flags/#{CGI.escape(flag_name)}/toggle",
+          body: { enabled: enabled, environment: environment }
+        )
+
+        return nil unless created_or_ok?(response)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('toggle', e)
+        nil
+      end
+
+      # Set a percentage flag's rollout in an environment. Returns the new state or nil.
+      def set_percentage(flag_name, percentage:, environment:)
+        response = request(
+          :post,
+          "/api/v1/flags/#{CGI.escape(flag_name)}/set_percentage",
+          body: { percentage: percentage, environment: environment }
+        )
+
+        return nil unless created_or_ok?(response)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('set_percentage', e)
+        nil
+      end
+
       def provision(project_id:, app_name:)
         response = request(
           :post,
@@ -91,6 +135,10 @@ module BrainzLab
 
       private
 
+      def created_or_ok?(response)
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPCreated)
+      end
+
       def request(method, path, headers: {}, body: nil, params: nil, use_service_key: false)
         uri = URI.parse("#{@base_url}#{path}")
 

data/lib/brainzlab/cortex.rb

@@ -123,6 +123,52 @@ module BrainzLab
         client.get_flag(flag_name.to_s)
       end
 
+      # === Management ("send" / write operations) ===
+
+      # Create (push) a new feature flag definition.
+      # @param flag_name [String, Symbol] flag key (lowercase, underscores)
+      # @param name [String] human-readable name (defaults to the key)
+      # @param type [String] boolean | percentage | variant | segment
+      # @return [Hash, nil] the created flag, or nil if disabled/unconfigured
+      #
+      # @example
+      #   BrainzLab::Cortex.create_flag(:new_checkout, name: "New Checkout")
+      def create_flag(flag_name, name: nil, type: 'boolean', description: nil, tags: [])
+        return nil unless writable?
+
+        client.create_flag(
+          key: flag_name.to_s,
+          name: name || flag_name.to_s,
+          flag_type: type,
+          description: description,
+          tags: tags
+        )
+      end
+
+      # Enable a flag in an environment (idempotent).
+      # @return [Hash, nil] the new state, or nil if disabled/unconfigured
+      def enable!(flag_name, environment: nil)
+        set_enabled(flag_name, true, environment: environment)
+      end
+
+      # Disable a flag in an environment (idempotent).
+      def disable!(flag_name, environment: nil)
+        set_enabled(flag_name, false, environment: environment)
+      end
+
+      # Set the rollout percentage (0-100) for a percentage flag.
+      def set_percentage(flag_name, percentage, environment: nil)
+        return nil unless writable?
+
+        result = client.set_percentage(
+          flag_name.to_s,
+          percentage: percentage,
+          environment: environment || BrainzLab.configuration.environment
+        )
+        clear_cache!
+        result
+      end
+
       # Clear the flag cache
       def clear_cache!
         cache.clear!
@@ -186,6 +232,26 @@ module BrainzLab
         BrainzLab.configuration.cortex_enabled
       end
 
+      # Write operations require the module on, a provisioned project, and a key.
+      def writable?
+        return false unless module_enabled?
+
+        ensure_provisioned!
+        BrainzLab.configuration.cortex_valid?
+      end
+
+      def set_enabled(flag_name, enabled, environment:)
+        return nil unless writable?
+
+        result = client.toggle(
+          flag_name.to_s,
+          enabled: enabled,
+          environment: environment || BrainzLab.configuration.environment
+        )
+        clear_cache!
+        result
+      end
+
       def merge_context(context)
         default_context = BrainzLab.configuration.cortex_default_context || {}
         thread_context = Thread.current[:cortex_context] || {}

data/lib/brainzlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrainzLab
-  VERSION = '0.1.24'
+  VERSION = '0.1.25'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainzlab
 version: !ruby/object:Gem::Version
-  version: 0.1.24
+  version: 0.1.25
 platform: ruby
 authors:
 - BrainzLab