standard_circuit 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fa1437c2a9810a0a9064639adcb8dad378f906786936dfa754ab0fa1e501e67
-  data.tar.gz: 4fc05e0a8b2a713f1ee7df03a6dde803db3f556916bc127c87d09a39fb7ccfc9
+  metadata.gz: e92eb79ddb1cfc0f2e9221aa62f45d7c304df0dfea22c114eb31a78c071b6c3c
+  data.tar.gz: 0aac1e3c093805ea2825cfb434840d83842999cb757cdcca896466c86a6abbff
 SHA512:
-  metadata.gz: eedd74500b0ae59383f60737bf191f1557be80f334ccdd3da6f46229a74272bbfaed866090b5bca810e226e5f42a1b8029c0fa00dd7200e87baa03a32b03c3e9
-  data.tar.gz: 9bb00b1ebbd89e5b9b68e8b0b01b042e25444b801f57733756c1804ba83d598558c68b0793bd86f587833f3e44350158f62496b65f722befacdf3a49f3bd8022
+  metadata.gz: 9e5ac3bb1d7352c6300fa70530602910dd3a45539e1cfad5d45b8ac702a223a22961cdaef377daf7c968ad7bbb5db54814c70a40b1a054a41df88c15fc5908c2
+  data.tar.gz: e8f4b265dd59f67442b52fafdb4db15923236df241b4296adc80bb6576654a888cdc564a5c2aa36e9ad291f5720f0c7fae7a274edcce046bb6995b6fbcb04dc7

data/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-04-27
+
+### Added
+- `StandardCircuit::ErrorTaxonomies::{Stripe,Smtp,Aws,Faraday}.tracked` — pre-combined `NetworkErrors.defaults + AdapterErrors::X.server_errors` arrays. Saves consumers from typing the same line for every circuit they register and gives a single place to evolve what counts as a "server-side outage" per integration. `caller_errors` (validation/auth/etc.) stay on `AdapterErrors::*` because the right `skipped_errors` set is usually app-specific.
+
+### Changed
+- `ControllerSupport.circuit_open_fallback` now appends a fresh `rescue_from Stoplight::Error::RedLight` handler each time it's called (deduplicating any prior RedLight handler on the class first, so repeated calls don't accumulate). Rails matches `rescue_handlers` last-declared-first, so a `rescue_from StandardError` catch-all declared *after* `include StandardCircuit::ControllerSupport` previously shadowed the gem's RedLight handler. As long as `circuit_open_fallback` is called after any catch-all rescues in your controller, RedLight now keeps routing to `handle_circuit_open` reliably.
+
 ## [0.1.1] - 2026-04-27
 
 ### Fixed

data/lib/standard_circuit/controller_support.rb

@@ -14,6 +14,14 @@ module StandardCircuit
     end
 
     class_methods do
+      # Rails iterates `rescue_handlers` from last-declared to first to find a
+      # match, so a `rescue_from StandardError` declared *after* `include
+      # StandardCircuit::ControllerSupport` shadows the gem's `RedLight` handler
+      # registered in `included`. Re-appending the handler here makes the DSL
+      # call effectively bump it to the end of the list — so as long as
+      # `circuit_open_fallback` is the last thing in your controller (or at
+      # least after any `rescue_from StandardError`-style catch-alls),
+      # `Stoplight::Error::RedLight` keeps routing to `handle_circuit_open`.
       def circuit_open_fallback(status: :service_unavailable, html: nil, json: nil, stream: nil)
         self._circuit_open_fallback = {
           status: status,
@@ -21,6 +29,19 @@ module StandardCircuit
           json: json,
           stream: stream
         }
+
+        # Drop existing RedLight handlers on this class before re-appending so
+        # repeated DSL calls (or sub-controllers calling the DSL after a base
+        # controller did) don't accumulate duplicate entries in
+        # `rescue_handlers`. Use the writer (not `reject!`) to avoid mutating
+        # the array a parent class might still share via `class_attribute`.
+        # Each entry's first element is a class-name string
+        # ("Stoplight::Error::RedLight"), not the constant itself.
+        self.rescue_handlers = rescue_handlers.reject { |handler| handler.first == "Stoplight::Error::RedLight" }
+
+        rescue_from Stoplight::Error::RedLight do |error|
+          handle_circuit_open(error)
+        end
       end
     end
 

data/lib/standard_circuit/error_taxonomies.rb

@@ -0,0 +1,43 @@
+module StandardCircuit
+  # Pre-combined `tracked_errors` sets per adapter — saves consumers from
+  # typing the same `NetworkErrors.defaults + AdapterErrors::X.server_errors`
+  # line for every circuit they register, and gives a single place to evolve
+  # what counts as a "server-side outage" for each integration.
+  #
+  # Each adapter's `tracked` returns a fresh array, so callers can safely
+  # `+` additional app-specific error classes without mutating shared state.
+  #
+  # Example:
+  #   c.register(:stripe,
+  #     tracked_errors: StandardCircuit::ErrorTaxonomies::Stripe.tracked,
+  #     skipped_errors: StandardCircuit::AdapterErrors::Stripe.caller_errors)
+  #
+  # Adapter-specific `caller_errors` (validation/auth/etc.) stay on
+  # `AdapterErrors::*` because the right `skipped_errors` set is usually
+  # app-specific and a shared taxonomy would over-skip.
+  module ErrorTaxonomies
+    module Stripe
+      def self.tracked
+        NetworkErrors.defaults + AdapterErrors::Stripe.server_errors
+      end
+    end
+
+    module Smtp
+      def self.tracked
+        NetworkErrors.defaults + AdapterErrors::Smtp.server_errors
+      end
+    end
+
+    module Aws
+      def self.tracked
+        NetworkErrors.defaults + AdapterErrors::Aws.server_errors
+      end
+    end
+
+    module Faraday
+      def self.tracked
+        NetworkErrors.defaults + AdapterErrors::Faraday.server_errors
+      end
+    end
+  end
+end

data/lib/standard_circuit/version.rb

@@ -1,3 +1,3 @@
 module StandardCircuit
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/standard_circuit.rb

@@ -8,6 +8,7 @@ require "standard_circuit/adapter_errors/stripe"
 require "standard_circuit/adapter_errors/aws"
 require "standard_circuit/adapter_errors/faraday"
 require "standard_circuit/adapter_errors/smtp"
+require "standard_circuit/error_taxonomies"
 require "standard_circuit/notifiers/logger"
 require "standard_circuit/notifiers/sentry"
 require "standard_circuit/notifiers/metrics"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: standard_circuit
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Jaryl Sim
@@ -87,6 +87,7 @@ files:
 - lib/standard_circuit/adapter_errors/stripe.rb
 - lib/standard_circuit/config.rb
 - lib/standard_circuit/controller_support.rb
+- lib/standard_circuit/error_taxonomies.rb
 - lib/standard_circuit/health.rb
 - lib/standard_circuit/health_controller.rb
 - lib/standard_circuit/mailer/circuit_open_error.rb