activeitem 0.0.17 → 0.0.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a4b1c7cc7af49e67776f895886bdf472d1e801ab3280f3ea28101bd20b8a701
-  data.tar.gz: 7415931df8a26b187e4a9ab52586b67c7cea08f0fa3a476ab09b863c02250835
+  metadata.gz: 89a17fbb7cce2459ac2ab8c4edf9e981e12193571b273c149b3d2d74511dba9e
+  data.tar.gz: 1cb5a9301704de43df7fd601c841183bbfdb5b140bac9e2f7ff2b4e729b77f70
 SHA512:
-  metadata.gz: b8c97c1ffadb921d440702b5299cf4bb219ba97ad0351cef7bebfea1125e74bf027ddc0546e1a254da8d6da8952598bf170368404c6ab65074ecc8379bfaec3b
-  data.tar.gz: b9936169d15857e1423de8f622ddfe85b7be05458739f569ce1983dd6565f234ae2789f12978ac530106cc98203906a99b9666805d1e2e43c7e0a275e7c41d06
+  metadata.gz: 4e7ac3bb2d79938a0aec2d860fc1cd106472e8d24b27166dc0afccaba2fac740faed88d2753e664f96f3149937e6b0209c35d316bfa84b7c020e45e601fa8ab2
+  data.tar.gz: 9c9c2bac36a241539eab5ebc44dd428d3b91b2780b18dd1660e5b3a997fc151669ea46df521b29e5636e26e6f444063a4bf49d059940bf0d03f3bc5bfeb5928c

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.0.18
+
+### Added
+
+- **Transactional saves** — `save`, `save!`, `destroy`, and `destroy!` now automatically enroll in the current transaction when called inside a `Model.transaction` block. This enables an ActiveRecord-style implicit API:
+
+  ```ruby
+  Model.transaction do
+    record1.save!
+    record2.save!
+    record3.destroy!
+  end
+  ```
+
+  All operations are committed atomically at block end. The explicit API (`txn.put(record)`) continues to work for backwards compatibility.
+
+- **RecordInvalid exception** — `save!` now raises `ActiveItem::RecordInvalid` with the record attached, instead of a generic `StandardError`. This matches ActiveRecord behavior.
+
+- **Transaction.active?** — class method to check if code is executing inside a transaction block.
+
 ## 0.0.13
 
 ### Changed

data/lib/active_item/base.rb

@@ -349,6 +349,9 @@ module ActiveItem
     def save(validate: true)
       return false if validate && !run_validations
 
+      # If inside a transaction block, enroll this save in the transaction
+      return enroll_in_transaction if Transaction.active?
+
       result = run_callbacks :save do
         if new_record?
           run_callbacks(:create) { perform_create }
@@ -368,7 +371,9 @@ module ActiveItem
     end
 
     def save!
-      raise StandardError, "Validation failed: #{errors.full_messages.join(', ')}" unless save
+      raise RecordInvalid.new(self), "Validation failed: #{errors.full_messages.join(', ')}" unless save
+
+      true
     end
 
     def self.create(attributes = {})
@@ -383,10 +388,39 @@ module ActiveItem
       obj
     end
 
+    # Execute a block within a transaction context.
+    #
+    # Supports two usage patterns:
+    #
+    # 1. Explicit API (block receives transaction):
+    #      Model.transaction do |txn|
+    #        txn.put(record1)
+    #        txn.update(record2)
+    #      end
+    #
+    # 2. Implicit API (transactional saves):
+    #      Model.transaction do
+    #        record1.save!
+    #        record2.save!
+    #        record3.destroy!
+    #      end
+    #
+    # In the implicit API, save/destroy calls are automatically enrolled.
+    # The transaction is committed when the block completes successfully.
+    # If an exception is raised, no changes are committed (all-or-nothing).
+    #
+    # @yield [Transaction] the transaction object (optional)
+    # @raise [TransactionError] if the transaction fails
     def self.transaction
       txn = Transaction.new
-      yield txn
-      txn.execute!
+      Transaction.current = txn
+      begin
+        # Support both explicit (yield txn) and implicit (no block param) APIs
+        yield txn if block_given?
+        txn.execute!
+      ensure
+        Transaction.current = nil
+      end
     end
 
     def self.transaction_find(items)
@@ -408,6 +442,9 @@ module ActiveItem
     end
 
     def destroy
+      # If inside a transaction block, enroll this destroy in the transaction
+      return enroll_destroy_in_transaction if Transaction.active?
+
       result = run_callbacks(:destroy) { perform_destroy }
       return false if result == false
 
@@ -421,7 +458,9 @@ module ActiveItem
     end
 
     def destroy!
-      destroy || raise(RecordNotDestroyed.new(nil, self))
+      raise RecordNotDestroyed.new(nil, self) unless destroy
+
+      true
     end
 
     def delete
@@ -460,6 +499,37 @@ module ActiveItem
 
     private
 
+    # Enroll this record's save operation in the current transaction.
+    # Called when save is invoked inside a transaction block.
+    def enroll_in_transaction
+      txn = Transaction.current
+
+      result = run_callbacks :save do
+        if new_record?
+          run_callbacks(:create) { txn.put(self) }
+        else
+          run_callbacks(:update) { txn.update(self) }
+        end
+      end
+
+      return false if result == false
+
+      # Mark changes as applied (will be committed when transaction executes)
+      # Note: @new_record stays true until transaction.execute! completes
+      true
+    end
+
+    # Enroll this record's destroy operation in the current transaction.
+    # Called when destroy is invoked inside a transaction block.
+    def enroll_destroy_in_transaction
+      txn = Transaction.current
+
+      result = run_callbacks(:destroy) { txn.delete(self) }
+      return false if result == false
+
+      true
+    end
+
     def generate_primary_key
       @id = nil if @id.to_s.strip.empty?
       @id ||= SecureRandom.uuid

data/lib/active_item/errors.rb

@@ -4,6 +4,17 @@ module ActiveItem
   class RecordNotFound < StandardError; end
   class TransactionError < StandardError; end
 
+  # Raised by save! when validations fail.
+  class RecordInvalid < StandardError
+    attr_reader :record
+
+    def initialize(record = nil)
+      @record = record
+      message = record ? "Validation failed: #{record.errors.full_messages.join(', ')}" : 'Validation failed'
+      super(message)
+    end
+  end
+
   # Raised when an IAM policy denies a DynamoDB operation on a table.
   class AccessDeniedError < StandardError
     attr_reader :model_name, :table, :operation, :original_error

data/lib/active_item/transaction.rb

@@ -3,15 +3,49 @@
 module ActiveItem
   # Wraps DynamoDB TransactWriteItems, allowing multiple put, update, and
   # delete operations to be committed atomically (up to 100 items).
+  #
+  # Supports two usage patterns:
+  #
+  # 1. Explicit API (original):
+  #      Model.transaction do |txn|
+  #        txn.put(record1)
+  #        txn.update(record2)
+  #      end
+  #
+  # 2. Implicit API (transactional saves):
+  #      Model.transaction do
+  #        record1.save!
+  #        record2.save!
+  #        record3.destroy!
+  #      end
+  #
+  # In the implicit API, save/destroy calls inside the block are automatically
+  # enrolled in the transaction and committed atomically at block end.
   class Transaction
     MAX_ITEMS = 100
 
     attr_reader :operations
 
+    class << self
+      # Thread-local storage for the current transaction context
+      def current
+        Thread.current[:activeitem_current_transaction]
+      end
+
+      def current=(txn)
+        Thread.current[:activeitem_current_transaction] = txn
+      end
+    end
+
     def initialize
       @operations = []
     end
 
+    # Check if we're inside a transaction block
+    def self.active?
+      !current.nil?
+    end
+
     def put(record, condition: nil)
       record.instance_variable_set(:@id, SecureRandom.uuid) unless record.id
       pk = record.class.primary_key

data/lib/active_item/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveItem
-  VERSION = '0.0.17'
+  VERSION = '0.0.18'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activeitem
 version: !ruby/object:Gem::Version
-  version: 0.0.17
+  version: 0.0.18
 platform: ruby
 authors:
 - Andy Davis
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-04 00:00:00.000000000 Z
+date: 2026-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel