bouncy 0.1.0 → 0.2.0

data/lib/bouncy.rb

@@ -84,7 +84,7 @@ module Bouncy
         return Status.new(nil, knowledge: :unconfigured)
       end
 
-      Status.new(Suppression.find_by(scope: scope, email: Identity.normalize(email)))
+      Status.new(current_state(Suppression).find_by(scope: scope, email: Identity.normalize(email)))
     rescue ActiveRecord::ActiveRecordError => e
       raise unless database_unavailable?(e)
 
@@ -106,7 +106,7 @@ module Bouncy
         return StatusSet.new(keys.index_with { Status.new(nil, knowledge: :unconfigured) }, knowledge: :unconfigured)
       end
 
-      rows = Suppression.where(scope: scope, email: keys).index_by(&:email)
+      rows = current_state(Suppression).where(scope: scope, email: keys).index_by(&:email)
       StatusSet.new(keys.to_h { |key| [key, Status.new(rows[key])] })
     rescue ActiveRecord::ActiveRecordError => e
       raise unless database_unavailable?(e)
@@ -141,6 +141,35 @@ module Bouncy
       end
     end
 
+    # Holds the address while the block runs, so no new block for it can commit between the
+    # app's own check and its send. Inside a transaction the hold lasts until the transaction
+    # ends. Returns the block's value. Unconfigured, it only runs the block. The check needs the
+    # latest committed state: see current_state. Inside a PostgreSQL REPEATABLE READ or
+    # SERIALIZABLE transaction it raises; hold around such a transaction, and around SQLite ones.
+    #
+    #   Bouncy.hold(order.email) do
+    #     ReceiptMailer.with(order:).receipt.deliver_now unless Bouncy.blocked?(order.email)
+    #   end
+    def hold(email, &)
+      raise ArgumentError, "Bouncy.hold needs a block" unless block_given?
+
+      unless configured?
+        unconfigured!("hold")
+        return yield
+      end
+
+      AddressLock.hold(email, &)
+    end
+
+    # Inside Bouncy.hold, MySQL reads restrictions with a locking read, which sees the latest
+    # committed state: a REPEATABLE READ snapshot from before the hold cannot hide a newer block
+    # or release. PostgreSQL at READ COMMITTED reads the latest state with every statement.
+    def current_state(relation)
+      return relation unless AddressLock.holding? && Record.connection_pool.with_connection(&:adapter_name).match?(/Mysql|Trilogy/i)
+
+      relation.lock("LOCK IN SHARE MODE")
+    end
+
     def unblocked
       previous = ActiveSupport::IsolatedExecutionState[:bouncy_unblocked]
       ActiveSupport::IsolatedExecutionState[:bouncy_unblocked] = true
@@ -169,10 +198,12 @@ require_relative "bouncy/suppression"
 require_relative "bouncy/event"
 require_relative "bouncy/status"
 require_relative "bouncy/status_set"
+require_relative "bouncy/address_lock"
 require_relative "bouncy/store"
 require_relative "bouncy/providers/base"
 require_relative "bouncy/providers/ses"
 require_relative "bouncy/providers/ses_parser"
+require_relative "bouncy/notification"
 require_relative "bouncy/ingestor"
 require_relative "bouncy/recovery"
 require_relative "bouncy/scope_lock"
@@ -180,6 +211,7 @@ require_relative "bouncy/reconciler"
 require_relative "bouncy/model"
 require_relative "bouncy/interceptor"
 require_relative "bouncy/webhook"
+require_relative "bouncy/body_limit"
 require_relative "bouncy/sync_job"
 require_relative "bouncy/prune_job"
 require_relative "bouncy/engine"

data/lib/generators/bouncy/templates/initializer.rb.tt

@@ -19,5 +19,19 @@ Bouncy.configure do |config|
   # config.soft_bounce_window = 30.days
   # config.soft_bounce_block_for = 30.days
 
+  # Stamp one SES configuration set on every message, so SES publishes its events to the topic.
+  # config.ses.configuration_set = "transactional"
+
+  # Confirm the SNS subscription by visiting its signed SubscribeURL instead of calling
+  # sns:ConfirmSubscription.
+  # config.ses.subscription_confirmation = :subscribe_url
+
+  # An app that runs no sync job enforces its webhook blocks alone. webhook_blocking then
+  # defaults to :strict: every Permanent bounce and every complained recipient blocks.
+  # config.require_fresh_sync = false
+
+  # Every SES notification, after Bouncy recorded it. A raise makes SNS deliver it again.
+  # config.on_notification = ->(notification) { }
+
   config.interception = :log # Review a complete sync before enabling :drop.
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bouncy
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - rameerez
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -61,16 +62,22 @@ files:
 - LICENSE.txt
 - README.md
 - config/routes.rb
+- guides/README.md
 - guides/admin.md
 - guides/amazon-ses.md
+- guides/api.md
 - guides/bounce-handling.md
 - guides/compatibility.md
+- guides/configuration.md
 - guides/delivery.md
 - guides/migrating.md
+- guides/operations.md
 - guides/privacy.md
 - guides/recovery.md
 - guides/troubleshooting.md
 - lib/bouncy.rb
+- lib/bouncy/address_lock.rb
+- lib/bouncy/body_limit.rb
 - lib/bouncy/configuration.rb
 - lib/bouncy/engine.rb
 - lib/bouncy/event.rb
@@ -78,6 +85,7 @@ files:
 - lib/bouncy/ingestor.rb
 - lib/bouncy/interceptor.rb
 - lib/bouncy/model.rb
+- lib/bouncy/notification.rb
 - lib/bouncy/providers/base.rb
 - lib/bouncy/providers/ses.rb
 - lib/bouncy/providers/ses_parser.rb
@@ -106,6 +114,7 @@ metadata:
   source_code_uri: https://github.com/rameerez/bouncy/tree/main
   changelog_uri: https://github.com/rameerez/bouncy/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -120,7 +129,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Email bounce handling and suppression management for Rails.
 test_files: []