stoplight 5.7.0 → 5.8.2

data/sig/stoplight/ports/configuration.rbs

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Stoplight
+  interface _Configuration
+    def notifiers: -> Array[state_transition_notifier]
+
+    def cool_off_time=: (duration) -> void
+    def threshold=: (percentage | Integer) -> void
+    def recovery_threshold=: (Integer) -> void
+    def window_size=: (duration?) -> void
+    def tracked_errors=: (Array[_ExceptionMatcher] | _ExceptionMatcher) -> void
+    def skipped_errors=: (Array[_ExceptionMatcher] | _ExceptionMatcher) -> void
+    def traffic_control=: (traffic_control) -> void
+    def traffic_recovery=: (traffic_recovery) -> void
+    def error_notifier=: (error_notifier) -> void
+    def data_store=: (data_store) -> void
+    def notifiers=:(Array[state_transition_notifier]) -> void
+  end
+end

data/sig/stoplight/ports/exception_matcher.rbs

@@ -0,0 +1,8 @@
+module Stoplight
+  interface _ExceptionMatcher
+    def ===: (untyped) -> bool
+
+    # Object methods
+    def is_a?: (untyped) -> bool
+  end
+end

data/sig/stoplight/ports/light.rbs

@@ -0,0 +1,12 @@
+module Stoplight
+  interface _Light
+    def name: -> String
+
+    def state: -> state
+    def color: -> color
+    def run: [T] (?(^(StandardError?) -> T)?) { () -> T } -> T
+    def lock: (color) -> _Light
+    def unlock: -> _Light
+    def ==: (untyped) -> bool
+  end
+end

data/sig/stoplight/ports/light_info.rbs

@@ -0,0 +1,5 @@
+module Stoplight
+  interface _LightInfo
+    def name: -> String
+  end
+end

data/sig/stoplight/ports/state_transition_notifier.rbs

@@ -0,0 +1,15 @@
+module Stoplight
+  interface _StateTransitionNotifier
+    # Sends a notification when a Stoplight changes state.
+    #
+    # @param config The Stoplight instance triggering the notification.
+    # @param from_color The previous state color of the Stoplight.
+    # @param to_color The new state color of the Stoplight.
+    # @param error The error (if any) that caused the state change.
+    def notify: (_LightInfo, color from_color, color to_color, ?StandardError? error) -> void
+
+    # Object methods needed for comparison/inspection
+    def ==: (untyped) -> bool
+    def class: -> Class
+  end
+end

data/sig/stoplight/ports/system.rbs

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Stoplight
+  # A System is a composition root that groups related circuit breakers
+  # with shared configuration.
+  interface _System
+    def name: -> String
+
+    def light: (
+      String name,
+      ?cool_off_time: optional[duration],
+      ?threshold: optional[percentage | Integer],
+      ?recovery_threshold: optional[Integer],
+      ?window_size: optional[duration?],
+      ?skipped_errors: optional[Array[_ExceptionMatcher]],
+      ?tracked_errors: optional[Array[_ExceptionMatcher]],
+      ?traffic_control: optional[traffic_control],
+      ?traffic_recovery: optional[traffic_recovery]
+    ) -> _Light
+  end
+end

data/sig/stoplight/state.rbs

@@ -0,0 +1,7 @@
+module Stoplight
+  module State
+    UNLOCKED: unlocked
+    LOCKED_GREEN: locked_green
+    LOCKED_RED: locked_red
+  end
+end

data/sig/stoplight/undefined.rbs

@@ -0,0 +1,9 @@
+module Stoplight
+  class Undefined
+    include Singleton
+
+    def self.instance: -> instance
+    def inspect: -> String
+    def to_s: -> String
+  end
+end

data/sig/stoplight/version.rbs

@@ -0,0 +1,3 @@
+module Stoplight
+  VERSION: Gem::Version
+end

data/sig/stoplight.rbs

@@ -0,0 +1,66 @@
+module Stoplight
+  type optional[T] = Undefined | T
+
+  type timestamp = Float | Integer
+  type redis = ::Redis | ConnectionPool[::Redis]
+
+  # Light Colors
+  type green = "green"
+  type yellow = "yellow"
+  type red = "red"
+  type color = green | yellow | red
+
+  # Light States
+  type unlocked = "unlocked"
+  type locked_green = "locked_green"
+  type locked_red = "locked_red"
+  type state = unlocked | locked_green | locked_red
+
+  # Duration in seconds (1, 23, 0.4, etc.)
+  type duration = Float | Integer
+  # Percentage as decimal (0.0 to 1.0)
+  type percentage = Float
+
+  type error_notifier = ^(StandardError) -> void
+  type traffic_control = :consecutive_errors | :error_rate | {error_rate: {min_requests: Integer}}
+  type traffic_recovery = :consecutive_successes
+  type data_store = DataStore::Redis | DataStore::Memory
+  type state_transition_notifier = _StateTransitionNotifier
+  type notification_formatter = ^(Domain::Config light, color, color, StandardError?) -> String
+
+  def self.configure: (?trust_me_im_an_engineer: bool) ?{ (_Configuration) -> void } -> void
+
+  def self.light: (
+      String name,
+      ?cool_off_time: optional[duration],
+      ?threshold: optional[percentage | Integer],
+      ?recovery_threshold: optional[Integer],
+      ?window_size: optional[duration?],
+      ?tracked_errors: optional[Array[_ExceptionMatcher] | _ExceptionMatcher],
+      ?skipped_errors: optional[Array[_ExceptionMatcher] | _ExceptionMatcher],
+      ?data_store: optional[data_store],
+      ?error_notifier: optional[error_notifier],
+      ?notifiers: optional[Array[state_transition_notifier]],
+      ?traffic_control: optional[traffic_control],
+      ?traffic_recovery: optional[traffic_recovery],
+    ) -> _Light
+end
+
+module Kernel
+  # For a method usable both as Kernel.Stoplight() and just Stoplight()
+  def self?.Stoplight: (
+      String name,
+      ?cool_off_time: Stoplight::optional[Stoplight::duration],
+      ?threshold: Stoplight::optional[Stoplight::percentage | Integer],
+      ?recovery_threshold: Stoplight::optional[Integer],
+      ?window_size: Stoplight::optional[Stoplight::duration?],
+      ?tracked_errors: Stoplight::optional[Array[Stoplight::_ExceptionMatcher] | Stoplight::_ExceptionMatcher],
+      ?skipped_errors: Stoplight::optional[Array[Stoplight::_ExceptionMatcher] | Stoplight::_ExceptionMatcher],
+      ?data_store: Stoplight::optional[Stoplight::data_store],
+      ?error_notifier: Stoplight::optional[Stoplight::error_notifier],
+      ?notifiers: Stoplight::optional[Array[Stoplight::state_transition_notifier]],
+      ?traffic_control: Stoplight::optional[Stoplight::traffic_control],
+      ?traffic_recovery: Stoplight::optional[Stoplight::traffic_recovery],
+  ) -> Stoplight::_Light
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stoplight
 version: !ruby/object:Gem::Version
-  version: 5.7.0
+  version: 5.8.2
 platform: ruby
 authors:
 - Cameron Desautels
@@ -51,6 +51,7 @@ files:
 - CHANGELOG.md
 - LICENSE.md
 - README.md
+- UPGRADING.md
 - lib/generators/stoplight/install/USAGE
 - lib/generators/stoplight/install/install_generator.rb
 - lib/generators/stoplight/install/templates/stoplight.rb.erb
@@ -72,85 +73,212 @@ files:
 - lib/stoplight/admin/views/_card.erb
 - lib/stoplight/admin/views/index.erb
 - lib/stoplight/admin/views/layout.erb
+- lib/stoplight/color.rb
 - lib/stoplight/common/deprecations.rb
-- lib/stoplight/domain/color.rb
+- lib/stoplight/data_store.rb
 - lib/stoplight/domain/compatibility_result.rb
 - lib/stoplight/domain/config.rb
-- lib/stoplight/domain/data_store.rb
-- lib/stoplight/domain/error.rb
+- lib/stoplight/domain/error_tracking_policy.rb
 - lib/stoplight/domain/failure.rb
 - lib/stoplight/domain/light.rb
 - lib/stoplight/domain/light/configuration_builder_interface.rb
-- lib/stoplight/domain/light_factory.rb
-- lib/stoplight/domain/metrics.rb
-- lib/stoplight/domain/recovery_lock_token.rb
-- lib/stoplight/domain/state.rb
+- lib/stoplight/domain/light_info.rb
+- lib/stoplight/domain/metrics_snapshot.rb
 - lib/stoplight/domain/state_snapshot.rb
-- lib/stoplight/domain/state_transition_notifier.rb
-- lib/stoplight/domain/storage/metrics.rb
-- lib/stoplight/domain/storage/recovery_lock.rb
-- lib/stoplight/domain/storage/state.rb
+- lib/stoplight/domain/storage/recovery_lock_token.rb
 - lib/stoplight/domain/strategies/green_run_strategy.rb
 - lib/stoplight/domain/strategies/red_run_strategy.rb
-- lib/stoplight/domain/strategies/run_strategy.rb
 - lib/stoplight/domain/strategies/yellow_run_strategy.rb
-- lib/stoplight/domain/tracker/base.rb
 - lib/stoplight/domain/tracker/recovery_probe.rb
 - lib/stoplight/domain/tracker/request.rb
-- lib/stoplight/domain/traffic_control/base.rb
 - lib/stoplight/domain/traffic_control/consecutive_errors.rb
 - lib/stoplight/domain/traffic_control/error_rate.rb
 - lib/stoplight/domain/traffic_recovery.rb
-- lib/stoplight/domain/traffic_recovery/base.rb
 - lib/stoplight/domain/traffic_recovery/consecutive_successes.rb
-- lib/stoplight/infrastructure/data_store/fail_safe.rb
-- lib/stoplight/infrastructure/data_store/memory.rb
-- lib/stoplight/infrastructure/data_store/memory/metrics.rb
-- lib/stoplight/infrastructure/data_store/memory/recovery_lock_store.rb
-- lib/stoplight/infrastructure/data_store/memory/recovery_lock_token.rb
-- lib/stoplight/infrastructure/data_store/memory/sliding_window.rb
-- lib/stoplight/infrastructure/data_store/memory/state.rb
-- lib/stoplight/infrastructure/data_store/redis.rb
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/get_metrics.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/record_failure.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/record_recovery_probe_failure.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/record_recovery_probe_success.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/record_success.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/release_lock.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/transition_to_green.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/transition_to_red.lua
-- lib/stoplight/infrastructure/data_store/redis/lua_scripts/transition_to_yellow.lua
-- lib/stoplight/infrastructure/data_store/redis/recovery_lock_store.rb
-- lib/stoplight/infrastructure/data_store/redis/recovery_lock_token.rb
-- lib/stoplight/infrastructure/data_store/redis/scripting.rb
+- lib/stoplight/error.rb
+- lib/stoplight/infrastructure/fail_safe/data_store.rb
+- lib/stoplight/infrastructure/fail_safe/storage/metrics.rb
+- lib/stoplight/infrastructure/fail_safe/storage/recovery_lock.rb
+- lib/stoplight/infrastructure/fail_safe/storage/recovery_lock_token.rb
+- lib/stoplight/infrastructure/fail_safe/storage/state.rb
+- lib/stoplight/infrastructure/memory/data_store.rb
+- lib/stoplight/infrastructure/memory/data_store/metrics.rb
+- lib/stoplight/infrastructure/memory/data_store/recovery_lock_store.rb
+- lib/stoplight/infrastructure/memory/data_store/recovery_lock_token.rb
+- lib/stoplight/infrastructure/memory/data_store/sliding_window.rb
+- lib/stoplight/infrastructure/memory/data_store/state.rb
+- lib/stoplight/infrastructure/memory/storage/recovery_lock.rb
+- lib/stoplight/infrastructure/memory/storage/recovery_metrics.rb
+- lib/stoplight/infrastructure/memory/storage/state.rb
+- lib/stoplight/infrastructure/memory/storage/unbounded_metrics.rb
+- lib/stoplight/infrastructure/memory/storage/window_metrics.rb
 - lib/stoplight/infrastructure/notifier/fail_safe.rb
 - lib/stoplight/infrastructure/notifier/generic.rb
 - lib/stoplight/infrastructure/notifier/io.rb
 - lib/stoplight/infrastructure/notifier/logger.rb
+- lib/stoplight/infrastructure/redis/data_store.rb
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/get_metrics.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/record_failure.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/record_recovery_probe_failure.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/record_recovery_probe_success.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/record_success.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/release_lock.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/transition_to_green.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/transition_to_red.lua
+- lib/stoplight/infrastructure/redis/data_store/lua_scripts/transition_to_yellow.lua
+- lib/stoplight/infrastructure/redis/data_store/recovery_lock_store.rb
+- lib/stoplight/infrastructure/redis/data_store/recovery_lock_token.rb
+- lib/stoplight/infrastructure/redis/data_store/scripting.rb
+- lib/stoplight/infrastructure/redis/storage/key_space.rb
+- lib/stoplight/infrastructure/redis/storage/metrics.rb
+- lib/stoplight/infrastructure/redis/storage/recovery_lock.rb
+- lib/stoplight/infrastructure/redis/storage/recovery_lock/release_lock.lua
+- lib/stoplight/infrastructure/redis/storage/recovery_metrics.rb
+- lib/stoplight/infrastructure/redis/storage/scripting.rb
+- lib/stoplight/infrastructure/redis/storage/state.rb
+- lib/stoplight/infrastructure/redis/storage/state/transition_to_green.lua
+- lib/stoplight/infrastructure/redis/storage/state/transition_to_red.lua
+- lib/stoplight/infrastructure/redis/storage/state/transition_to_yellow.lua
+- lib/stoplight/infrastructure/redis/storage/unbounded_metrics.rb
+- lib/stoplight/infrastructure/redis/storage/unbounded_metrics/record_failure.lua
+- lib/stoplight/infrastructure/redis/storage/unbounded_metrics/record_success.lua
+- lib/stoplight/infrastructure/redis/storage/window_metrics.rb
+- lib/stoplight/infrastructure/redis/storage/window_metrics/metrics_snapshot.lua
+- lib/stoplight/infrastructure/redis/storage/window_metrics/record_failure.lua
+- lib/stoplight/infrastructure/redis/storage/window_metrics/record_success.lua
 - lib/stoplight/infrastructure/storage/compatibility_metrics.rb
 - lib/stoplight/infrastructure/storage/compatibility_recovery_lock.rb
 - lib/stoplight/infrastructure/storage/compatibility_recovery_metrics.rb
 - lib/stoplight/infrastructure/storage/compatibility_state.rb
+- lib/stoplight/infrastructure/system_clock.rb
+- lib/stoplight/notifier.rb
 - lib/stoplight/rspec.rb
 - lib/stoplight/rspec/generic_notifier.rb
+- lib/stoplight/state.rb
+- lib/stoplight/types.rb
+- lib/stoplight/undefined.rb
 - lib/stoplight/version.rb
-- lib/stoplight/wiring/data_store/base.rb
-- lib/stoplight/wiring/data_store/memory.rb
-- lib/stoplight/wiring/data_store/redis.rb
+- lib/stoplight/wiring/config_compatibility_validator.rb
+- lib/stoplight/wiring/configuration_dsl.rb
+- lib/stoplight/wiring/data_store_backend.rb
 - lib/stoplight/wiring/default.rb
+- lib/stoplight/wiring/default_config.rb
 - lib/stoplight/wiring/default_configuration.rb
-- lib/stoplight/wiring/default_factory_builder.rb
-- lib/stoplight/wiring/light/default_config.rb
-- lib/stoplight/wiring/light/system_config.rb
 - lib/stoplight/wiring/light_builder.rb
 - lib/stoplight/wiring/light_factory.rb
-- lib/stoplight/wiring/light_factory/compatibility_validator.rb
-- lib/stoplight/wiring/light_factory/config_normalizer.rb
-- lib/stoplight/wiring/light_factory/configuration_pipeline.rb
 - lib/stoplight/wiring/light_factory/traffic_control_dsl.rb
 - lib/stoplight/wiring/light_factory/traffic_recovery_dsl.rb
+- lib/stoplight/wiring/memory/backend.rb
 - lib/stoplight/wiring/notifier_factory.rb
-- lib/stoplight/wiring/public_api.rb
+- lib/stoplight/wiring/redis/backend.rb
+- lib/stoplight/wiring/storage_set.rb
+- lib/stoplight/wiring/storage_set_builder.rb
+- lib/stoplight/wiring/system.rb
+- lib/stoplight/wiring/system/light_builder.rb
+- lib/stoplight/wiring/system/light_factory.rb
+- sig/_private/generators/stoplight/install/install_generator.rbs
+- sig/_private/stoplight.rbs
+- sig/_private/stoplight/common/deprecations.rbs
+- sig/_private/stoplight/data_store.rbs
+- sig/_private/stoplight/domain/compatibility_result.rbs
+- sig/_private/stoplight/domain/config.rbs
+- sig/_private/stoplight/domain/error_tracking_policy.rbs
+- sig/_private/stoplight/domain/failure.rbs
+- sig/_private/stoplight/domain/light.rbs
+- sig/_private/stoplight/domain/light_info.rbs
+- sig/_private/stoplight/domain/metrics_snapshot.rbs
+- sig/_private/stoplight/domain/ports/clock.rbs
+- sig/_private/stoplight/domain/ports/data_store.rbs
+- sig/_private/stoplight/domain/ports/light_factory.rbs
+- sig/_private/stoplight/domain/ports/metrics_store.rbs
+- sig/_private/stoplight/domain/ports/recovery_lock_store.rbs
+- sig/_private/stoplight/domain/ports/recovery_lock_token.rbs
+- sig/_private/stoplight/domain/ports/run_strategy.rbs
+- sig/_private/stoplight/domain/ports/state_store.rbs
+- sig/_private/stoplight/domain/ports/traffic_control.rbs
+- sig/_private/stoplight/domain/ports/traffic_recovery.rbs
+- sig/_private/stoplight/domain/state_snapshot.rbs
+- sig/_private/stoplight/domain/storage/recovery_lock_token.rbs
+- sig/_private/stoplight/domain/strategies/green_run_strategy.rbs
+- sig/_private/stoplight/domain/strategies/red_run_strategy.rbs
+- sig/_private/stoplight/domain/strategies/yellow_run_strategy.rbs
+- sig/_private/stoplight/domain/tracker/base.rbs
+- sig/_private/stoplight/domain/tracker/recovery_probe.rbs
+- sig/_private/stoplight/domain/tracker/request.rbs
+- sig/_private/stoplight/domain/traffic_control/consecutive_errors.rbs
+- sig/_private/stoplight/domain/traffic_control/error_rate.rbs
+- sig/_private/stoplight/domain/traffic_recovery.rbs
+- sig/_private/stoplight/domain/traffic_recovery/consecutive_successes.rbs
+- sig/_private/stoplight/infrastructure/fail_safe/data_store.rbs
+- sig/_private/stoplight/infrastructure/fail_safe/storage/metrics.rbs
+- sig/_private/stoplight/infrastructure/fail_safe/storage/recovery_lock.rbs
+- sig/_private/stoplight/infrastructure/fail_safe/storage/recovery_lock_token.rbs
+- sig/_private/stoplight/infrastructure/fail_safe/storage/state.rbs
+- sig/_private/stoplight/infrastructure/memory/data_store.rbs
+- sig/_private/stoplight/infrastructure/memory/data_store/metrics.rbs
+- sig/_private/stoplight/infrastructure/memory/data_store/recovery_lock_store.rbs
+- sig/_private/stoplight/infrastructure/memory/data_store/recovery_lock_token.rbs
+- sig/_private/stoplight/infrastructure/memory/data_store/sliding_window.rbs
+- sig/_private/stoplight/infrastructure/memory/data_store/state.rbs
+- sig/_private/stoplight/infrastructure/memory/storage/recovery_lock.rbs
+- sig/_private/stoplight/infrastructure/memory/storage/recovery_metrics.rbs
+- sig/_private/stoplight/infrastructure/memory/storage/state.rbs
+- sig/_private/stoplight/infrastructure/memory/storage/unbounded_metrics.rbs
+- sig/_private/stoplight/infrastructure/memory/storage/window_metrics.rbs
+- sig/_private/stoplight/infrastructure/notifier/fail_safe.rbs
+- sig/_private/stoplight/infrastructure/notifier/generic.rbs
+- sig/_private/stoplight/infrastructure/notifier/io.rbs
+- sig/_private/stoplight/infrastructure/notifier/logger.rbs
+- sig/_private/stoplight/infrastructure/redis/data_store.rbs
+- sig/_private/stoplight/infrastructure/redis/data_store/recovery_lock_store.rbs
+- sig/_private/stoplight/infrastructure/redis/data_store/recovery_lock_token.rbs
+- sig/_private/stoplight/infrastructure/redis/data_store/scripting.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/key_space.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/metrics.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/recovery_lock.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/recovery_metrics.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/scripting.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/state.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/unbounded_metrics.rbs
+- sig/_private/stoplight/infrastructure/redis/storage/window_metrics.rbs
+- sig/_private/stoplight/infrastructure/storage/compatibility_metrics.rbs
+- sig/_private/stoplight/infrastructure/storage/compatibility_recovery_lock.rbs
+- sig/_private/stoplight/infrastructure/storage/compatibility_recovery_metrics.rbs
+- sig/_private/stoplight/infrastructure/storage/compatibility_state.rbs
+- sig/_private/stoplight/infrastructure/system_clock.rbs
+- sig/_private/stoplight/system/light_builder.rbs
+- sig/_private/stoplight/system/light_factory.rbs
+- sig/_private/stoplight/types.rbs
+- sig/_private/stoplight/wiring/config_compatibility_validator.rbs
+- sig/_private/stoplight/wiring/configuration_dsl.rbs
+- sig/_private/stoplight/wiring/data_store_backend.rbs
+- sig/_private/stoplight/wiring/default.rbs
+- sig/_private/stoplight/wiring/default_config.rbs
+- sig/_private/stoplight/wiring/default_configuration.rbs
+- sig/_private/stoplight/wiring/light_builder.rbs
+- sig/_private/stoplight/wiring/light_factory.rbs
+- sig/_private/stoplight/wiring/light_factory/traffic_control_dsl.rbs
+- sig/_private/stoplight/wiring/light_factory/traffic_recovery_dsl.rbs
+- sig/_private/stoplight/wiring/memory/backend.rbs
+- sig/_private/stoplight/wiring/notifier_factory.rbs
+- sig/_private/stoplight/wiring/redis/backend.rbs
+- sig/_private/stoplight/wiring/storage_set.rbs
+- sig/_private/stoplight/wiring/storage_set_builder.rbs
+- sig/_private/stoplight/wiring/system.rbs
+- sig/stoplight.rbs
+- sig/stoplight/color.rbs
+- sig/stoplight/data_store.rbs
+- sig/stoplight/error.rbs
+- sig/stoplight/notifier.rbs
+- sig/stoplight/ports/configuration.rbs
+- sig/stoplight/ports/exception_matcher.rbs
+- sig/stoplight/ports/light.rbs
+- sig/stoplight/ports/light_info.rbs
+- sig/stoplight/ports/state_transition_notifier.rbs
+- sig/stoplight/ports/system.rbs
+- sig/stoplight/state.rbs
+- sig/stoplight/undefined.rbs
+- sig/stoplight/version.rbs
 homepage: https://github.com/bolshakov/stoplight
 licenses:
 - MIT
@@ -169,7 +297,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Traffic control for code.
 test_files: []

data/lib/stoplight/domain/color.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module Domain
-    module Color
-      GREEN = "green"
-      YELLOW = "yellow"
-      RED = "red"
-    end
-  end
-end

data/lib/stoplight/domain/data_store.rb

@@ -1,146 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module Domain
-    # @abstract
-    # :nocov:
-    class DataStore
-      METRICS_RETENTION_TIME = 60 * 60 * 24 # 1 day
-
-      # Retrieves the names of all lights stored in the data store.
-      #
-      # @return [Array<String>] An array of light names.
-      def names
-        raise NotImplementedError
-      end
-
-      # Retrieves metrics for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @return [Stoplight::Domain::Metrics]
-      def get_metrics(config)
-        raise NotImplementedError
-      end
-
-      # Retrieves recovery metrics for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @return [Stoplight::Domain::Metrics]
-      def get_recovery_metrics(config)
-        raise NotImplementedError
-      end
-
-      # Retrieves State Snapshot for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config] The light configuration.
-      # @return [Stoplight::Domain::StateSnapshot]
-      def get_state_snapshot(config)
-        raise NotImplementedError
-      end
-
-      # Clears windowed metrics (successes/errors) to prevent
-      # stale failures from before recovery from affecting post-recovery decisions.
-      # Consecutive counts are intentionally preserved as they track current streaks.
-      #
-      # @param config [Stoplight::Domain::Config] The light configuration.
-      # @return [void]
-      def clear_metrics(config)
-        raise NotImplementedError
-      end
-
-      def clear_recovery_metrics(config)
-        raise NotImplementedError
-      end
-
-      # Records a failure for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @param exception [Exception]
-      # @return [void]
-      def record_failure(config, exception)
-        raise NotImplementedError
-      end
-
-      # Records a success for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @return [void]
-      def record_success(config)
-        raise NotImplementedError
-      end
-
-      # Records a failed recovery probe for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @param failure [Failure]
-      # @return [void]
-      def record_recovery_probe_failure(config, failure)
-        raise NotImplementedError
-      end
-
-      # Records a successful recovery probe for a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @return [void]
-      def record_recovery_probe_success(config)
-        raise NotImplementedError
-      end
-
-      # Sets the state of a specific light configuration.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @param state [String] The new state to set.
-      # @return [String] The state that was set.
-      def set_state(config, state)
-        raise NotImplementedError
-      end
-
-      # Acquires recovery lock for serializing probe execution.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @return [Stoplight::Domain::LockToken, nil] Lock if acquired, nil if contended
-      def acquire_recovery_lock(config) = raise NotImplementedError
-
-      # Releases previously acquired lock.
-      #
-      # @param lock [Stoplight::Domain::RecoveryLockToken]
-      # @return [void]
-      def release_recovery_lock(lock) = raise NotImplementedError
-
-      # Transitions the Stoplight to the specified color.
-      #
-      # This method performs a color transition operation that works across distributed instances
-      # of the light. It ensures that in a multi-instance environment, only one instance
-      # is considered the "first" to perform the transition (and therefore responsible for
-      # triggering notifications).
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @param color [String] The target color/state to transition to.
-      #   Should be one of Stoplight::Color::GREEN, Stoplight::Color::YELLOW, or Stoplight::Color::RED.
-      #
-      # @return [Boolean] Returns +true+ if this instance was the first to perform this specific transition
-      #   (and should therefore trigger notifications). Returns +false+ if another instance already
-      #   initiated this transition.
-      #
-      # @note In distributed environments with multiple instances, race conditions can occur when instances
-      #   attempt conflicting transitions simultaneously (e.g., one instance tries to transition from
-      #   YELLOW to GREEN while another tries YELLOW to RED). The implementation handles this, but
-      #   be aware that the last operation may determine the final color of the light.
-      #
-      def transition_to_color(config, color)
-        raise NotImplementedError
-      end
-
-      # Deletes metadata (and related persistent state) for the given light.
-      #
-      # Implementations may choose to only remove metadata; metrics may expire via TTL.
-      #
-      # @param config [Stoplight::Domain::Config]
-      # @return [void]
-      def delete_light(config)
-        raise NotImplementedError
-      end
-    end
-    # :nocov:
-  end
-end