standard_circuit 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2faee952d1a2a7a131f721af4ac58ce46cbbe94dadc50cd50d4e6ac24af08600
-  data.tar.gz: e20f8adb374398ad0fab643b6333e329b6c7f5e187fc927092b1d167b4e290f8
+  metadata.gz: e92eb79ddb1cfc0f2e9221aa62f45d7c304df0dfea22c114eb31a78c071b6c3c
+  data.tar.gz: 0aac1e3c093805ea2825cfb434840d83842999cb757cdcca896466c86a6abbff
 SHA512:
-  metadata.gz: '09dd4b8be7afd25bb06044c3b80d41fa39c302ccbb9357cd770127050af30d517cef73d8f6ad03a6112f837ae5d6a278068bc7edc147824403081afe63670f13'
-  data.tar.gz: ef93377225b985b979ee54f35d86f9e52354030d0c5cad2131653828ee3a767239206268eb0b18b776b3ec3fa3cfc69fc9d9ed8118a9cd53ca0e9eb74cc6c834
+  metadata.gz: 9e5ac3bb1d7352c6300fa70530602910dd3a45539e1cfad5d45b8ac702a223a22961cdaef377daf7c968ad7bbb5db54814c70a40b1a054a41df88c15fc5908c2
+  data.tar.gz: e8f4b265dd59f67442b52fafdb4db15923236df241b4296adc80bb6576654a888cdc564a5c2aa36e9ad291f5720f0c7fae7a274edcce046bb6995b6fbcb04dc7

data/CHANGELOG.md

@@ -4,6 +4,19 @@ 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
+- `Mailer::Railtie`'s `standard_circuit.action_mailer` initializer now declares `before: "action_mailer.set_configs"`. Without this hint, the on_load callback that defines `standard_circuit_settings=` ran *after* Rails' `set_configs` initializer tried to forward `config.action_mailer.standard_circuit_settings = {...}` to `ActionMailer::Base`, raising `NoMethodError: undefined method 'standard_circuit_settings='` during eager_load. Two consumers previously worked around this by mutating the Initializer's private `@before` field in their `application.rb`; that workaround can now be removed.
+
 ## [0.1.0] - 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/mailer/delivery_method.rb

@@ -66,7 +66,10 @@ module StandardCircuit
           mailer_class.add_delivery_method :standard_circuit, StandardCircuit::Mailer::DeliveryMethod
         end
 
-        initializer "standard_circuit.action_mailer" do
+        # `before:` ensures `add_delivery_method` (which defines the
+        # `standard_circuit_settings=` accessor) runs before Rails' set_configs
+        # tries to forward `config.action_mailer.standard_circuit_settings=`.
+        initializer "standard_circuit.action_mailer", before: "action_mailer.set_configs" do
           ActiveSupport.on_load(:action_mailer) do
             StandardCircuit::Mailer::Railtie.install(self)
           end

data/lib/standard_circuit/version.rb

@@ -1,3 +1,3 @@
 module StandardCircuit
-  VERSION = "0.1.0"
+  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.0
+  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