dexkit 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc994e44218cf9063af69ad1d01929d86b91fe35b6f30769dd068832fb04fc37
-  data.tar.gz: b4a078fb25780824cd2a876f5d668196ba2f3a2094ce63a1b9731dfeab1c7aa6
+  metadata.gz: c6f6f437fc7f7726b58232820e6f1afd65c5adf674f51c4be07944a43d92a58b
+  data.tar.gz: 13046423e606ff6e000b6d557ce468efa94d0f13d8aa36530dc5ae69a688e097
 SHA512:
-  metadata.gz: b4bb8dbbe3c9acd66e5c3ed6a6b203408f66c7455544c36de4e60e755a9cfa9a2fa3405a39648e77e5bd42b2593a053d5d517e16ce1cd5236225083bd24891b3
-  data.tar.gz: c050bd2dc477e19efcebbe6bfa6fe7d46dbfa4dea5367f38c098b6c82750439211d1b4a28224c21fd66e98c8971b9532f341f4e17b4d2e836383470ccf778913
+  metadata.gz: d48748c521d0e0c298ab78230797f7a22e45ae194fee6669f0f99669ea0ac1333b59158a8068211319694cbd073660f298babdb0a784b251444b579b898ba1c0
+  data.tar.gz: 4a574717aa7d2f5f5de9d192b86d7a6151d5b1a8cd2bba04c79e933cb2768e5c4d7cd05d91e22cf3ca9973cfca59467cd1a6972df8626ce90971ca9fec2a365d

data/README.md

@@ -18,7 +18,12 @@ class CreateUser < Dex::Operation
 
   def perform
     error!(:email_taken) if User.exists?(email: email)
-    User.create!(name: name, email: email)
+
+    user = User.create!(name: name, email: email)
+
+    after_commit { WelcomeMailer.with(user: user).deliver_later }
+
+    user
   end
 end
 

data/guides/llm/OPERATION.md

@@ -20,7 +20,12 @@ class CreateUser < Dex::Operation
   def perform
     error!(:invalid_email) unless email.include?("@")
     error!(:email_taken) if User.exists?(email: email)
-    User.create!(email: email, name: name, role: role)
+
+    user = User.create!(email: email, name: name, role: role)
+
+    after_commit { WelcomeMailer.with(user: user).deliver_later }
+
+    user
   end
 end
 ```
@@ -255,6 +260,25 @@ transaction :mongoid     # adapter override (default: auto-detect AR → Mongoid
 
 Child classes can re-enable: `transaction true`.
 
+### after_commit
+
+Register blocks to run after the transaction commits. Use for side effects that should only happen on success (emails, webhooks, cache invalidation):
+
+```ruby
+def perform
+  user = User.create!(name: name, email: email)
+  after_commit { WelcomeMailer.with(user: user).deliver_later }
+  after_commit { Analytics.track(:user_created, user_id: user.id) }
+  user
+end
+```
+
+On rollback (`error!` or exception), callbacks are discarded. When no transaction is open anywhere, executes immediately. Multiple blocks run in registration order.
+
+**ActiveRecord:** fully nesting-aware — callbacks are deferred until the outermost transaction commits, even across nested operations or ambient `ActiveRecord::Base.transaction` blocks. Requires Rails 7.2+.
+
+**Mongoid:** callbacks are deferred across nested Dex operations. Ambient `Mongoid.transaction` blocks opened outside Dex are not detected — callbacks will fire immediately in that case.
+
 ---
 
 ## Advisory Locking

data/lib/dex/operation/transaction_adapter.rb

@@ -32,17 +32,63 @@ module Dex
           ActiveRecord::Base.transaction(&block)
         end
 
+        def self.after_commit(&block)
+          unless defined?(ActiveRecord) && ActiveRecord.respond_to?(:after_all_transactions_commit)
+            raise LoadError, "after_commit requires Rails 7.2+"
+          end
+
+          ActiveRecord.after_all_transactions_commit(&block)
+        end
+
         def self.rollback_exception_class
           ActiveRecord::Rollback
         end
       end
 
       module MongoidAdapter
+        AFTER_COMMIT_KEY = :_dex_mongoid_after_commit
+
         def self.wrap(&block)
           unless defined?(Mongoid)
             raise LoadError, "Mongoid is required for transactions"
           end
-          Mongoid.transaction(&block)
+
+          outermost = !Thread.current[AFTER_COMMIT_KEY]
+          Thread.current[AFTER_COMMIT_KEY] ||= []
+          snapshot = Thread.current[AFTER_COMMIT_KEY].length
+
+          block_completed = false
+          result = Mongoid.transaction do
+            value = block.call
+            block_completed = true
+            value
+          end
+
+          if outermost && block_completed
+            Thread.current[AFTER_COMMIT_KEY].each(&:call)
+          elsif !block_completed
+            # Mongoid swallowed a Rollback exception — discard callbacks from this level
+            Thread.current[AFTER_COMMIT_KEY].slice!(snapshot..)
+          end
+
+          result
+        rescue StandardError # rubocop:disable Style/RescueStandardError
+          Thread.current[AFTER_COMMIT_KEY]&.slice!(snapshot..) unless outermost
+          raise
+        ensure
+          Thread.current[AFTER_COMMIT_KEY] = nil if outermost
+        end
+
+        # NOTE: Only detects transactions opened via MongoidAdapter.wrap (i.e. Dex operations).
+        # Ambient Mongoid.transaction blocks opened outside Dex are invisible here —
+        # the callback will fire immediately instead of deferring to the outer commit.
+        def self.after_commit(&block)
+          callbacks = Thread.current[AFTER_COMMIT_KEY]
+          if callbacks
+            callbacks << block
+          else
+            block.call
+          end
         end
 
         def self.rollback_exception_class

data/lib/dex/operation/transaction_wrapper.rb

@@ -18,6 +18,17 @@ module Dex
       result
     end
 
+    def after_commit(&block)
+      raise ArgumentError, "after_commit requires a block" unless block
+
+      adapter = _transaction_adapter
+      if adapter
+        adapter.after_commit(&block)
+      else
+        block.call
+      end
+    end
+
     TRANSACTION_KNOWN_ADAPTERS = %i[active_record mongoid].freeze
 
     module ClassMethods

data/lib/dex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dex
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dexkit
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Jacek Galanciak