smplkit 1.0.11 → 1.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45b89bb8091aeb0e42f1e6ccbf0b94cde98f827bae408770317658dd24c4de3c
-  data.tar.gz: 06eff16b91b28ef98f9fc2b7a64253d099154a6730a7ecbf1f2e99df9d8629c3
+  metadata.gz: 0f74b529f57291b182d674d166e138a61b95bb01c1bdf01a71261405f75a6879
+  data.tar.gz: 7e08e3ec63e892ae13bec37446afcd38c7b5d16008a0396d7046efd362598ed9
 SHA512:
-  metadata.gz: 8f06ccbadf581ad0f7253ebb80ca35ecc6f1dcd94c63ad476bbfd742068702774f9b2dc416da6d6f035fd50502cebea17bfae6d8a203f4d0f4c39dec495c30ef
-  data.tar.gz: 6ac31365d9a694b9b11e0a8b00e7ca37c3a8fa5354fe678ef91fdc7bcd7a3ad257220b5521a4704ebdb210838c3e4ad120afe5dc4af01686f7339538510b0024
+  metadata.gz: 28aa21a7b049e824c613ab8d53df09a0993abd938cb275ee7a330735623b9e6de99b986f6930bc6bab472a26533abf472d5a6f41301e54d833856fdb6708c882
+  data.tar.gz: 738683d247b8a2c557731deaae62c93120899da054dcfb91991d7ee114dd5a40c7f945456916713aa4500aa2a6e1fefe5ea0916f682804c63a4eea2af3ad1afc

data/README.md

@@ -77,7 +77,14 @@ Two adapters ship at launch (per ADR-046 §2.3):
 | `stdlib-logger`   | Ruby stdlib `Logger` (and Rails via `ActiveSupport::Logger`)            |
 | `semantic-logger` | The [`semantic_logger` gem](https://github.com/reidmorrison/semantic_logger) |
 
-Custom adapters subclass `Smplkit::Logging::Adapters::Base`.
+Both are auto-loaded by `install` when the corresponding framework is available. To support an additional framework, subclass `Smplkit::Logging::Adapters::Base` and implement the five contract methods (`name`, `discover`, `apply_level`, `install_hook`, `uninstall_hook`), then register before `install`:
+
+```ruby
+client.logging.register_adapter(MyFrameworkAdapter.new)
+client.logging.install
+```
+
+Calling `register_adapter` disables auto-loading — only the adapters you register are used.
 
 ## Rails integration
 

data/lib/smplkit/config/client.rb

@@ -157,11 +157,21 @@ module Smplkit
 
       def typed_get(item_key, default, config_key)
         snapshot = config_key ? resolve(config_key) : merged_snapshot
-        keys = item_key.to_s.split(".")
-        value = keys.reduce(snapshot) do |scope, k|
-          break default unless scope.is_a?(Hash)
-
-          scope[k]
+        key = item_key.to_s
+        # Items live under flat dotted keys (e.g. +"api.host"+ — not nested
+        # +api → host+). Match Python's +current_values.get(key)+ behavior.
+        value = snapshot[key]
+        if value.nil? && snapshot.is_a?(Hash)
+          # Fallback: support callers that constructed an explicitly-nested
+          # snapshot (rare — typed model bindings only).
+          parts = key.split(".")
+          if parts.length > 1
+            value = parts.reduce(snapshot) do |scope, k|
+              break nil unless scope.is_a?(Hash)
+
+              scope[k]
+            end
+          end
         end
         return default if value.nil?
 

data/lib/smplkit/config/helpers.rb

@@ -32,7 +32,7 @@ module Smplkit
           key: attrs["key"] || resource["id"],
           name: attrs["name"],
           description: attrs["description"],
-          parent_id: attrs["parent_id"],
+          parent_id: attrs["parent"] || attrs["parent_id"],
           items: items,
           environments: environments,
           created_at: attrs["created_at"],
@@ -54,11 +54,12 @@ module Smplkit
           out[env] = { "values" => env_obj.values_raw }
         end
 
+        # The Config schema (per the OpenAPI spec) does not include +key+ in
+        # attributes — the resource +id+ carries the customer-facing key.
         attributes = {
-          "key" => config.key,
           "name" => config.name,
           "description" => config.description,
-          "parent_id" => config.parent_id,
+          "parent" => config.parent_id,
           "items" => items,
           "environments" => environments
         }.compact

data/lib/smplkit/config_resolution.rb

@@ -81,7 +81,10 @@ module Smplkit
 
       sections =
         begin
-          parse_ini(File.read(path))
+          # Force UTF-8 — the file may contain comments with non-ASCII bytes
+          # (em dashes, smart quotes) and the system's default external
+          # encoding is locale-dependent.
+          parse_ini(File.read(path, encoding: "UTF-8"))
         rescue StandardError
           return {}
         end

data/lib/smplkit/management/client.rb

@@ -143,25 +143,25 @@ module Smplkit
         return if batch.empty?
 
         body = { "data" => { "type" => "context_bulk_register", "attributes" => { "contexts" => batch } } }
-        http_post("/api/contexts/v1/bulk", body)
+        http_post("/api/v1/contexts/bulk", body)
       rescue StandardError => e
         Smplkit.debug("registration", "context flush failed: #{e.class}: #{e.message}")
       end
 
       def list
-        list_resp = http_list("/api/contexts/v1")
+        list_resp = http_list("/api/v1/contexts")
         list_resp.map { |r| context_from_resource(r) }
       end
 
       def get(id_or_type, key = nil)
         type, ckey = split_id(id_or_type, key)
-        resource = http_get("/api/contexts/v1/#{type}:#{ckey}")
+        resource = http_get("/api/v1/contexts/#{type}:#{ckey}")
         context_from_resource(resource["data"])
       end
 
       def delete(id_or_type, key = nil)
         type, ckey = split_id(id_or_type, key)
-        http_delete("/api/contexts/v1/#{type}:#{ckey}")
+        http_delete("/api/v1/contexts/#{type}:#{ckey}")
       end
 
       def _save_context(ctx)
@@ -172,7 +172,7 @@ module Smplkit
             "attributes" => { "type" => ctx.type, "key" => ctx.key, "attributes" => ctx.attributes }.compact
           }
         }
-        resp = http_put("/api/contexts/v1/#{ctx.id}", body)
+        resp = http_put("/api/v1/contexts/#{ctx.id}", body)
         context_from_resource(resp["data"]).tap { |c| c._bind_client(self) }
       end
 
@@ -210,17 +210,17 @@ module Smplkit
       end
 
       def list
-        list_resp = http_list("/api/context_types/v1")
+        list_resp = http_list("/api/v1/context_types")
         list_resp.map { |r| from_resource(r) }
       end
 
       def get(key)
-        resp = http_get("/api/context_types/v1/#{key}")
+        resp = http_get("/api/v1/context_types/#{key}")
         from_resource(resp["data"])
       end
 
       def delete(key)
-        http_delete("/api/context_types/v1/#{key}")
+        http_delete("/api/v1/context_types/#{key}")
       end
 
       def new_context_type(key, name: nil, description: nil)
@@ -228,12 +228,12 @@ module Smplkit
       end
 
       def _create_context_type(ct)
-        resp = http_post("/api/context_types/v1", body_for(ct))
+        resp = http_post("/api/v1/context_types", body_for(ct))
         from_resource(resp["data"])
       end
 
       def _update_context_type(ct)
-        resp = http_put("/api/context_types/v1/#{ct.key}", body_for(ct))
+        resp = http_put("/api/v1/context_types/#{ct.key}", body_for(ct))
         from_resource(resp["data"])
       end
 
@@ -268,17 +268,17 @@ module Smplkit
       end
 
       def list
-        list_resp = http_list("/api/environments/v1")
+        list_resp = http_list("/api/v1/environments")
         list_resp.map { |r| from_resource(r) }
       end
 
       def get(key)
-        resp = http_get("/api/environments/v1/#{key}")
+        resp = http_get("/api/v1/environments/#{key}")
         from_resource(resp["data"])
       end
 
       def delete(key)
-        http_delete("/api/environments/v1/#{key}")
+        http_delete("/api/v1/environments/#{key}")
       end
 
       def new(key, name: nil, color: nil,
@@ -293,12 +293,12 @@ module Smplkit
       end
 
       def _create_environment(env)
-        resp = http_post("/api/environments/v1", body_for(env))
+        resp = http_post("/api/v1/environments", body_for(env))
         from_resource(resp["data"])
       end
 
       def _update_environment(env)
-        resp = http_put("/api/environments/v1/#{env.key}", body_for(env))
+        resp = http_put("/api/v1/environments/#{env.key}", body_for(env))
         from_resource(resp["data"])
       end
 
@@ -342,12 +342,12 @@ module Smplkit
       end
 
       def get
-        resp = http_get("/api/account_settings/v1")
+        resp = http_get("/api/v1/accounts/current/settings")
         from_resource(resp["data"])
       end
 
       def _update_account_settings(settings)
-        resp = http_put("/api/account_settings/v1", body_for(settings))
+        resp = http_put("/api/v1/accounts/current/settings", body_for(settings))
         from_resource(resp["data"])
       end
 
@@ -385,41 +385,86 @@ module Smplkit
       end
 
       def list
-        list_resp = http_list("/api/configs/v1")
+        list_resp = http_list("/api/v1/configs")
         list_resp.map { |r| Smplkit::Config::Helpers.config_from_json(self, r) }
       end
 
       def get(key)
-        resp = http_get("/api/configs/v1/#{key}")
+        resp = http_get("/api/v1/configs/#{key}")
         Smplkit::Config::Helpers.config_from_json(self, resp["data"])
       end
 
       def delete(key)
-        http_delete("/api/configs/v1/#{key}")
+        http_delete("/api/v1/configs/#{key}")
       end
 
       def new_config(key, name: nil, description: nil, parent: nil)
         Smplkit::Config::Config.new(
-          self, key: key, name: name, description: description,
-                parent_id: parent.is_a?(Smplkit::Config::Config) ? parent.key : parent
+          self,
+          key: key,
+          name: name || Smplkit::Helpers.key_to_display_name(key),
+          description: description,
+          parent_id: parent.is_a?(Smplkit::Config::Config) ? parent.key : parent
         )
       end
 
       def _create_config(config)
         body = Smplkit::Config::Helpers.build_config_request_body(config)
-        resp = http_post("/api/configs/v1", body)
+        resp = http_post("/api/v1/configs", body)
         Smplkit::Config::Helpers.config_from_json(self, resp["data"])
       end
 
       def _update_config(config)
         body = Smplkit::Config::Helpers.build_config_request_body(config)
-        resp = http_put("/api/configs/v1/#{config.key}", body)
+        resp = http_put("/api/v1/configs/#{config.key}", body)
         Smplkit::Config::Helpers.config_from_json(self, resp["data"])
       end
 
-      def fetch_chain(key)
-        resp = http_get("/api/configs/v1/#{key}/chain")
-        (resp["data"] || []).map { |r| r["attributes"] || {} }
+      # Build the parent-chain for a given config, walking +parent_id+
+      # pointers across the full config list. Mirrors the Python SDK's
+      # client-side resolution — there is no server +/chain+ endpoint.
+      #
+      # Each chain entry is a Hash matching the wire shape that
+      # +Smplkit::Config::Helpers.resolve_chain+ consumes.
+      def fetch_chain(target_key)
+        all_configs = list
+        by_key = all_configs.to_h { |c| [c.key, c] }
+        by_id  = all_configs.to_h { |c| [c.id, c] }
+
+        current = by_key[target_key]
+        return [] unless current
+
+        chain = []
+        loop do
+          chain << config_to_chain_entry(current)
+          parent_id = current.parent_id
+          break if parent_id.nil? || parent_id == ""
+
+          parent = by_id[parent_id]
+          break unless parent
+
+          current = parent
+        end
+        chain
+      end
+
+      private
+
+      def config_to_chain_entry(config)
+        items_hash = {}
+        config.items.each do |item|
+          items_hash[item.name] = {
+            "value" => item.value,
+            "type" => item.type,
+            "description" => item.description
+          }.compact
+        end
+
+        environments = config.environments.each_with_object({}) do |(env_key, env_obj), out|
+          out[env_key] = { "values" => env_obj.values_raw }
+        end
+
+        { "id" => config.id, "items" => items_hash, "environments" => environments }
       end
     end
 
@@ -441,23 +486,23 @@ module Smplkit
         return if batch.empty?
 
         body = { "data" => { "type" => "flag_bulk_register", "attributes" => { "flags" => batch } } }
-        http_post("/api/flags/v1/bulk", body)
+        http_post("/api/v1/flags/bulk", body)
       rescue StandardError => e
         Smplkit.debug("registration", "flag flush failed: #{e.class}: #{e.message}")
       end
 
       def list
-        list_resp = http_list("/api/flags/v1")
+        list_resp = http_list("/api/v1/flags")
         list_resp.map { |r| flag_from_resource(r) }
       end
 
       def get(id)
-        resp = http_get("/api/flags/v1/#{id}")
+        resp = http_get("/api/v1/flags/#{id}")
         flag_from_resource(resp["data"])
       end
 
       def delete(id)
-        http_delete("/api/flags/v1/#{id}")
+        http_delete("/api/v1/flags/#{id}")
       end
 
       def new_boolean_flag(id, default:, name: nil, description: nil, values: nil)
@@ -490,23 +535,23 @@ module Smplkit
 
       def _create_flag(flag)
         body = Smplkit::Flags::Helpers.build_flag_request_body(flag)
-        resp = http_post("/api/flags/v1", body)
+        resp = http_post("/api/v1/flags", body)
         flag_from_resource(resp["data"])
       end
 
       def _update_flag(flag)
         body = Smplkit::Flags::Helpers.build_flag_request_body(flag)
-        resp = http_put("/api/flags/v1/#{flag.id}", body)
+        resp = http_put("/api/v1/flags/#{flag.id}", body)
         flag_from_resource(resp["data"])
       end
 
       def fetch_flag(id)
-        resp = http_get("/api/flags/v1/#{id}")
+        resp = http_get("/api/v1/flags/#{id}")
         Smplkit::Flags::Helpers.flag_dict_from_json(resp["data"])
       end
 
       def list_flags
-        body = http_list("/api/flags/v1")
+        body = http_list("/api/v1/flags")
         body.map { |r| Smplkit::Flags::Helpers.flag_dict_from_json(r) }
       end
 
@@ -550,30 +595,30 @@ module Smplkit
         return if batch.empty?
 
         body = { "data" => { "type" => "logger_bulk_register", "attributes" => { "loggers" => batch } } }
-        http_post("/api/loggers/v1/bulk", body)
+        http_post("/api/v1/loggers/bulk", body)
       rescue StandardError => e
         Smplkit.debug("registration", "logger flush failed: #{e.class}: #{e.message}")
       end
 
       def list
-        list_resp = http_list("/api/loggers/v1")
+        list_resp = http_list("/api/v1/loggers")
         list_resp.map { |r| Smplkit::Logging::Helpers.logger_resource_to_model(self, r) }
       end
 
       def get(id)
         normalized = Smplkit::Logging::Normalize.normalize_logger_name(id)
-        resp = http_get("/api/loggers/v1/#{normalized}")
+        resp = http_get("/api/v1/loggers/#{normalized}")
         Smplkit::Logging::Helpers.logger_resource_to_model(self, resp["data"])
       end
 
       def delete(id)
         normalized = Smplkit::Logging::Normalize.normalize_logger_name(id)
-        http_delete("/api/loggers/v1/#{normalized}")
+        http_delete("/api/v1/loggers/#{normalized}")
       end
 
       def _update_logger(logger)
         body = Smplkit::Logging::Helpers.build_logger_body(logger)
-        resp = http_put("/api/loggers/v1/#{logger.id || logger.name}", body)
+        resp = http_put("/api/v1/loggers/#{logger.id || logger.name}", body)
         Smplkit::Logging::Helpers.logger_resource_to_model(self, resp["data"])
       end
     end
@@ -586,17 +631,17 @@ module Smplkit
       end
 
       def list
-        list_resp = http_list("/api/log_groups/v1")
+        list_resp = http_list("/api/v1/log_groups")
         list_resp.map { |r| Smplkit::Logging::Helpers.log_group_resource_to_model(self, r) }
       end
 
       def get(key)
-        resp = http_get("/api/log_groups/v1/#{key}")
+        resp = http_get("/api/v1/log_groups/#{key}")
         Smplkit::Logging::Helpers.log_group_resource_to_model(self, resp["data"])
       end
 
       def delete(key)
-        http_delete("/api/log_groups/v1/#{key}")
+        http_delete("/api/v1/log_groups/#{key}")
       end
 
       def new_log_group(key, name: nil, level: nil, description: nil, parent: nil)
@@ -609,13 +654,13 @@ module Smplkit
 
       def _create_log_group(group)
         body = Smplkit::Logging::Helpers.build_log_group_body(group)
-        resp = http_post("/api/log_groups/v1", body)
+        resp = http_post("/api/v1/log_groups", body)
         Smplkit::Logging::Helpers.log_group_resource_to_model(self, resp["data"])
       end
 
       def _update_log_group(group)
         body = Smplkit::Logging::Helpers.build_log_group_body(group)
-        resp = http_put("/api/log_groups/v1/#{group.key}", body)
+        resp = http_put("/api/v1/log_groups/#{group.key}", body)
         Smplkit::Logging::Helpers.log_group_resource_to_model(self, resp["data"])
       end
     end

data/lib/smplkit/ws.rb

@@ -3,6 +3,7 @@
 require "json"
 require "async"
 require "async/http/endpoint"
+require "async/http/protocol/http1"
 require "async/websocket/client"
 require "concurrent"
 
@@ -172,7 +173,12 @@ module Smplkit
       @connection_status = "connecting"
       Smplkit.debug("websocket", "connecting to #{safe_url}")
 
-      endpoint = Async::HTTP::Endpoint.parse(url)
+      # Force HTTP/1.1 for the WebSocket upgrade. async-http defaults to
+      # HTTP/2 on TLS endpoints, but the smplkit event gateway speaks the
+      # classic RFC 6455 upgrade over HTTP/1.1, not the HTTP/2-tunneled
+      # variant from RFC 8441 — without this override the upgrade returns
+      # a Protocol::HTTP2::StreamError before any frame is exchanged.
+      endpoint = Async::HTTP::Endpoint.parse(url, protocol: Async::HTTP::Protocol::HTTP1)
       headers = { "user-agent" => USER_AGENT }
       connection = Async::WebSocket::Client.connect(endpoint, headers: headers)
       @connection_lock.synchronize { @connection = connection }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smplkit
 version: !ruby/object:Gem::Version
-  version: 1.0.11
+  version: 1.0.13
 platform: ruby
 authors:
 - Smpl Solutions LLC