smplkit 1.0.13 → 1.0.15

data/lib/smplkit/ws.rb

@@ -90,14 +90,16 @@ module Smplkit
     def stop
       Smplkit.debug("websocket", "stopping shared WebSocket")
       @closed = true
-      @connection_status = "disconnected"
       close_active_connection
       thread = @ws_thread
       @ws_thread = nil
-      return unless thread
-
-      thread.join(2.0)
-      thread.kill if thread.alive?
+      if thread
+        thread.join(2.0)
+        thread.kill if thread.alive?
+      end
+      # Set authoritatively after the thread is dead so a racing connect
+      # call (which also sets "connecting") cannot clobber this value.
+      @connection_status = "disconnected"
     end
 
     # ----- URL builder ----------------------------------------------
@@ -169,6 +171,8 @@ module Smplkit
     end
 
     def connect(task)
+      return if @closed
+
       url = build_ws_url
       @connection_status = "connecting"
       Smplkit.debug("websocket", "connecting to #{safe_url}")

data/lib/smplkit.rb

@@ -11,6 +11,29 @@ module Smplkit
 end
 
 require_relative "smplkit/version"
+
+# Load the generated OpenAPI client trees. Each tree under
+# +lib/smplkit/_generated/<svc>/lib+ uses internal +require+ paths like
+# +smplkit_<svc>_client/api_client+, so the directory has to be on
+# +$LOAD_PATH+ before its top-level entry is required.
+%w[app config flags logging].each do |svc|
+  generated_lib = File.expand_path("smplkit/_generated/#{svc}/lib", __dir__)
+  $LOAD_PATH.unshift(generated_lib) if File.directory?(generated_lib)
+end
+
+# The openapi-generator-produced files declare +module SmplkitGeneratedClient::App+
+# without first declaring the parent module. MRI requires it to already
+# exist, so pre-declare here.
+module SmplkitGeneratedClient # rubocop:disable Style/OneClassPerFile
+end
+
+%w[smplkit_app_client smplkit_config_client smplkit_flags_client smplkit_logging_client].each do |gem_lib|
+  require gem_lib
+rescue LoadError
+  # Generated tree may be intentionally absent in development snapshots —
+  # the wrapper layer falls back gracefully.
+end
+
 require_relative "smplkit/errors"
 require_relative "smplkit/debug"
 require_relative "smplkit/helpers"

data/sig/smplkit/config.rbs

@@ -0,0 +1,78 @@
+module Smplkit
+  module Config
+    module ItemType
+      STRING: String
+      NUMBER: String
+      BOOLEAN: String
+      JSON: String
+      ALL: Array[String]
+    end
+
+    class ConfigItem
+      attr_accessor name: String
+      attr_accessor value: untyped
+      attr_accessor type: String
+      attr_accessor description: String?
+      def initialize: (name: String, value: untyped, type: String, ?description: String?) -> void
+      def to_h: () -> Hash[String, untyped]
+    end
+
+    class ConfigEnvironment
+      def initialize: (?values: Hash[String, untyped]?) -> void
+      def values: () -> Hash[String, untyped]
+      def values_raw: () -> Hash[String, Hash[String, untyped]]
+    end
+
+    class Config
+      attr_accessor id: String?
+      attr_accessor key: String
+      attr_accessor name: String?
+      attr_accessor description: String?
+      attr_accessor parent_id: String?
+      attr_accessor created_at: untyped
+      attr_accessor updated_at: untyped
+
+      def items: () -> Array[ConfigItem]
+      def environments: () -> Hash[String, ConfigEnvironment]
+      def set_string: (String, String, ?environment: String?, ?description: String?) -> Config
+      def set_number: (String, (Integer | Float), ?environment: String?, ?description: String?) -> Config
+      def set_boolean: (String, bool, ?environment: String?, ?description: String?) -> Config
+      def set_json: (String, untyped, ?environment: String?, ?description: String?) -> Config
+      def remove_item: (String, ?environment: String?) -> Config
+      def save: () -> Config
+      alias save! save
+      def delete: () -> void
+      alias delete! delete
+    end
+
+    class ConfigChangeEvent
+      attr_reader key: String
+      attr_reader source: String
+      attr_reader deleted: bool
+      def deleted?: () -> bool
+    end
+
+    class LiveConfigProxy
+      def get: (String?, ?untyped) -> untyped
+      def []: (String) -> untyped
+      def to_h: () -> Hash[String, untyped]
+      def refresh: () -> LiveConfigProxy
+    end
+
+    class ConfigClient
+      def start: () -> void
+      def get: (String, ?untyped?) -> untyped
+      def get_string: (String, ?default: String?, ?config: String?) -> String?
+      def get_number: (String, ?default: untyped, ?config: String?) -> untyped
+      def get_boolean: (String, ?default: bool?, ?config: String?) -> bool
+      def get_json: (String, ?default: untyped, ?config: String?) -> untyped
+      def live: (String) -> LiveConfigProxy
+      def on_change: (?String?) { (ConfigChangeEvent) -> void } -> Proc
+      def refresh: () -> void
+    end
+  end
+
+  ConfigItem: singleton(Config::ConfigItem)
+  ConfigEnvironment: singleton(Config::ConfigEnvironment)
+  ItemType: singleton(Config::ItemType)
+end

data/sig/smplkit/flags.rbs

@@ -0,0 +1,93 @@
+module Smplkit
+  module Flags
+    class FlagValue
+      attr_reader name: String
+      attr_reader value: untyped
+      def self.new: (name: String, value: untyped) -> FlagValue
+    end
+
+    class FlagRule
+      attr_reader logic: Hash[String, untyped]
+      attr_reader value: untyped
+      attr_reader description: String?
+      def self.new: (logic: Hash[String, untyped], ?value: untyped, ?description: String?) -> FlagRule
+    end
+
+    class FlagEnvironment
+      attr_reader enabled: bool
+      attr_reader default: untyped
+      attr_reader rules: Array[FlagRule]
+      def enabled?: () -> bool
+      def with: (**untyped) -> FlagEnvironment
+    end
+
+    class Flag
+      attr_accessor id: String?
+      attr_accessor name: String
+      attr_accessor type: String
+      attr_accessor default: untyped
+      attr_accessor description: String?
+      attr_accessor created_at: untyped
+      attr_accessor updated_at: untyped
+
+      def values: () -> Array[FlagValue]?
+      def environments: () -> Hash[String, FlagEnvironment]
+      def add_rule: (Hash[String, untyped]) -> Flag
+      def enable_rules: (?environment: String?) -> Flag
+      def disable_rules: (?environment: String?) -> Flag
+      def clear_rules: (?environment: String?) -> Flag
+      def set_default: (untyped, environment: String) -> Flag
+      def clear_default: (environment: String) -> Flag
+      def add_value: (FlagValue) -> Flag
+      def remove_value: (String) -> Flag
+      def clear_values: () -> Flag
+      def save: () -> Flag
+      alias save! save
+      def delete: () -> void
+      alias delete! delete
+    end
+
+    class BooleanFlag < Flag
+      def get: (?context: Array[Smplkit::Context]?) -> bool
+    end
+
+    class StringFlag < Flag
+      def get: (?context: Array[Smplkit::Context]?) -> String
+    end
+
+    class NumberFlag < Flag
+      def get: (?context: Array[Smplkit::Context]?) -> (Integer | Float)
+    end
+
+    class JsonFlag < Flag
+      def get: (?context: Array[Smplkit::Context]?) -> untyped
+    end
+
+    class FlagChangeEvent
+      attr_reader id: String
+      attr_reader source: String
+      attr_reader deleted: bool
+      def deleted?: () -> bool
+    end
+
+    class FlagStats
+      attr_reader cache_hits: Integer
+      attr_reader cache_misses: Integer
+    end
+
+    class FlagsClient
+      def boolean_flag: (String, default: bool) -> BooleanFlag
+      def string_flag: (String, default: String) -> StringFlag
+      def number_flag: (String, default: (Integer | Float)) -> NumberFlag
+      def json_flag: (String, default: untyped) -> JsonFlag
+      def start: () -> void
+      def refresh: () -> void
+      def stats: () -> FlagStats
+      def on_change: (?String?) { (FlagChangeEvent) -> void } -> Proc
+    end
+  end
+
+  FlagValue: singleton(Flags::FlagValue)
+  FlagRule: singleton(Flags::FlagRule)
+  FlagEnvironment: singleton(Flags::FlagEnvironment)
+end

data/sig/smplkit/logging.rbs

@@ -0,0 +1,92 @@
+module Smplkit
+  module Logging
+    class LoggerSource
+      attr_reader name: String
+      attr_reader resolved_level: Smplkit::LogLevel
+      attr_reader level: Smplkit::LogLevel?
+      attr_reader service: String?
+      attr_reader environment: String?
+      def self.new: (name: String, resolved_level: Smplkit::LogLevel,
+                     ?level: Smplkit::LogLevel?, ?service: String?,
+                     ?environment: String?) -> LoggerSource
+    end
+
+    class SmplLogger
+      attr_accessor id: String?
+      attr_accessor name: String
+      attr_accessor resolved_level: Smplkit::LogLevel?
+      attr_accessor level: Smplkit::LogLevel?
+      attr_accessor service: String?
+      attr_accessor environment: String?
+      attr_accessor log_group_id: String?
+      attr_accessor managed: bool
+      attr_accessor description: String?
+      attr_accessor created_at: untyped
+      attr_accessor updated_at: untyped
+      def managed?: () -> bool
+      def save: () -> SmplLogger
+      alias save! save
+      def delete: () -> void
+      alias delete! delete
+    end
+
+    class SmplLogGroup
+      attr_accessor id: String?
+      attr_accessor key: String
+      attr_accessor name: String?
+      attr_accessor level: Smplkit::LogLevel?
+      attr_accessor description: String?
+      attr_accessor parent_id: String?
+      attr_accessor environments: Hash[String, untyped]
+      def save: () -> SmplLogGroup
+      alias save! save
+      def delete: () -> void
+      alias delete! delete
+    end
+
+    class LoggingClient
+      def install: () -> LoggingClient
+      alias start install
+      def register_adapter: (Adapters::Base) -> LoggingClient
+      def adapters: () -> Array[Adapters::Base]
+      def get: (String) -> SmplLogger
+      def list: () -> Array[SmplLogger]
+      def delete: (String) -> bool
+      def on_change: (?String?) { (untyped) -> void } -> Proc
+    end
+
+    module Adapters
+      class Base
+        def name: () -> String
+        def discover: () -> Array[[String, Smplkit::LogLevel?, Smplkit::LogLevel]]
+        def apply_level: (String, Smplkit::LogLevel) -> void
+        def install_hook: () { (String, Smplkit::LogLevel?, Smplkit::LogLevel) -> void } -> void
+        def uninstall_hook: () -> void
+      end
+
+      class StdlibLoggerAdapter < Base
+        def track: (String, untyped) -> void
+      end
+
+      class SemanticLoggerAdapter < Base
+        def track: (String, untyped) -> void
+      end
+    end
+
+    module Levels
+      def self.smpl_level_to_stdlib: (Smplkit::LogLevel) -> Integer
+      def self.stdlib_level_to_smpl: (Integer?) -> Smplkit::LogLevel
+      def self.semantic_level_to_smpl: (Symbol?) -> Smplkit::LogLevel
+      def self.smpl_level_to_semantic: (Smplkit::LogLevel) -> Symbol
+    end
+
+    module Normalize
+      def self.normalize_logger_name: (String) -> String
+    end
+  end
+
+  LoggerSource: singleton(Logging::LoggerSource)
+  StdlibLoggerAdapter: singleton(Logging::Adapters::StdlibLoggerAdapter)
+  SemanticLoggerAdapter: singleton(Logging::Adapters::SemanticLoggerAdapter)
+  LoggingAdapter: singleton(Logging::Adapters::Base)
+end

data/sig/smplkit/management.rbs

@@ -0,0 +1,123 @@
+module Smplkit
+  module Management
+    module EnvironmentClassification
+      STANDARD: String
+      AD_HOC: String
+      ALL: Array[String]
+    end
+
+    class Color
+      attr_reader hex: String
+      def initialize: (String) -> void
+      def self.rgb: (Integer, Integer, Integer) -> Color
+    end
+
+    class Environment
+      attr_accessor id: String?
+      attr_accessor key: String
+      attr_accessor name: String?
+      attr_accessor color: Color?
+      attr_accessor classification: String
+      attr_accessor description: String?
+      attr_accessor created_at: untyped
+      attr_accessor updated_at: untyped
+      def save: () -> Environment
+      alias save! save
+      def delete: () -> void
+      alias delete! delete
+    end
+
+    class ContextType
+      attr_accessor id: String?
+      attr_accessor key: String
+      attr_accessor name: String?
+      attr_accessor description: String?
+      def save: () -> ContextType
+      alias save! save
+      def delete: () -> void
+      alias delete! delete
+    end
+
+    class AccountSettings
+      attr_accessor id: String?
+      attr_accessor environment_order: Array[String]
+      attr_accessor default_environment: String?
+      attr_accessor updated_at: untyped
+      def save: () -> AccountSettings
+      alias save! save
+    end
+  end
+
+  Color: singleton(Management::Color)
+  EnvironmentClassification: singleton(Management::EnvironmentClassification)
+
+  class ManagementClient
+    class ContextsNamespace
+      def register: (Array[Smplkit::Context]?) -> void
+      def flush: () -> void
+      def list: () -> Array[Smplkit::Context]
+      def get: (String, ?String?) -> Smplkit::Context
+      def delete: (String, ?String?) -> bool
+    end
+
+    class ContextTypesNamespace
+      def list: () -> Array[Management::ContextType]
+      def get: (String) -> Management::ContextType
+      def delete: (String) -> bool
+      def new_context_type: (String, ?name: String?, ?description: String?) -> Management::ContextType
+    end
+
+    class EnvironmentsNamespace
+      def list: () -> Array[Management::Environment]
+      def get: (String) -> Management::Environment
+      def delete: (String) -> bool
+      def new: (String, ?name: String?, ?color: (String | Management::Color)?,
+                ?classification: String, ?description: String?) -> Management::Environment
+    end
+
+    class AccountSettingsNamespace
+      def get: () -> Management::AccountSettings
+    end
+
+    class ConfigNamespace
+      def list: () -> Array[Smplkit::Config::Config]
+      def get: (String) -> Smplkit::Config::Config
+      def delete: (String) -> bool
+      def new_config: (String, ?name: String?, ?description: String?,
+                       ?parent: (String | Smplkit::Config::Config)?) -> Smplkit::Config::Config
+      def fetch_chain: (String) -> Array[Hash[String, untyped]]
+    end
+
+    class FlagsNamespace
+      def register: (Smplkit::FlagDeclaration) -> void
+      def flush: () -> void
+      def list: () -> Array[Smplkit::Flags::Flag]
+      def get: (String) -> Smplkit::Flags::Flag
+      def delete: (String) -> bool
+      def new_boolean_flag: (String, default: bool, ?name: String?,
+                             ?description: String?, ?values: Array[Smplkit::Flags::FlagValue]?) -> Smplkit::Flags::BooleanFlag
+      def new_string_flag: (String, default: String, ?name: String?,
+                            ?description: String?, ?values: Array[Smplkit::Flags::FlagValue]?) -> Smplkit::Flags::StringFlag
+      def new_number_flag: (String, default: (Integer | Float), ?name: String?,
+                            ?description: String?, ?values: Array[Smplkit::Flags::FlagValue]?) -> Smplkit::Flags::NumberFlag
+      def new_json_flag: (String, default: untyped, ?name: String?,
+                          ?description: String?, ?values: Array[Smplkit::Flags::FlagValue]?) -> Smplkit::Flags::JsonFlag
+    end
+
+    class LoggersNamespace
+      def register: (Smplkit::LoggerSource | Array[Smplkit::LoggerSource]) -> void
+      def flush: () -> void
+      def list: () -> Array[Smplkit::Logging::SmplLogger]
+      def get: (String) -> Smplkit::Logging::SmplLogger
+      def delete: (String) -> bool
+    end
+
+    class LogGroupsNamespace
+      def list: () -> Array[Smplkit::Logging::SmplLogGroup]
+      def get: (String) -> Smplkit::Logging::SmplLogGroup
+      def delete: (String) -> bool
+      def new_log_group: (String, ?name: String?, ?level: untyped, ?description: String?,
+                          ?parent: (String | Smplkit::Logging::SmplLogGroup)?) -> Smplkit::Logging::SmplLogGroup
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smplkit
 version: !ruby/object:Gem::Version
-  version: 1.0.13
+  version: 1.0.15
 platform: ruby
 authors:
 - Smpl Solutions LLC
@@ -13,44 +13,62 @@ dependencies:
   name: async
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '2.39'
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '2.39'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: async-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.79'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.95'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.95'
+        version: '0.79'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: async-websocket
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.26'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.30'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.26'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.30'
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -107,6 +125,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.0'
+- !ruby/object:Gem::Dependency
+  name: marcel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: Ruby SDK for the smplkit platform — flags, config, and logging APIs with
   runtime evaluation, live updates, and management operations.
 email:
@@ -536,6 +568,10 @@ files:
 - lib/smplkit/version.rb
 - lib/smplkit/ws.rb
 - sig/smplkit.rbs
+- sig/smplkit/config.rbs
+- sig/smplkit/flags.rbs
+- sig/smplkit/logging.rbs
+- sig/smplkit/management.rbs
 homepage: https://www.smplkit.com
 licenses:
 - MIT
@@ -552,7 +588,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.3'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="