activeitem 0.0.18 → 0.0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89a17fbb7cce2459ac2ab8c4edf9e981e12193571b273c149b3d2d74511dba9e
-  data.tar.gz: 1cb5a9301704de43df7fd601c841183bbfdb5b140bac9e2f7ff2b4e729b77f70
+  metadata.gz: 7992e08eadef33c715ba67e3869454bca7cf174cae56e419982b81de608075c6
+  data.tar.gz: dc1e6e803c91bb774f7e0c2edf43f6ca744ac10221bba26b8a5a4a4d7466f425
 SHA512:
-  metadata.gz: 4e7ac3bb2d79938a0aec2d860fc1cd106472e8d24b27166dc0afccaba2fac740faed88d2753e664f96f3149937e6b0209c35d316bfa84b7c020e45e601fa8ab2
-  data.tar.gz: 9c9c2bac36a241539eab5ebc44dd428d3b91b2780b18dd1660e5b3a997fc151669ea46df521b29e5636e26e6f444063a4bf49d059940bf0d03f3bc5bfeb5928c
+  metadata.gz: ee3f192c4bc8d0ea583f85462cb28841092e0389ed7682b6cfec753f446b687174385f74b81fa58ddc411c34b7dea1fd348aeea243a1109b0ae1ae0915565036
+  data.tar.gz: f21580968c7db755fbc2c75e4cdb2cf8c9b3ab7f400a5a83954fb297215a78ec9adf4968f2ed3e526d771747c80460d50a8b7c23f70c6e2489a5d8e84f03b4a2

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.0.19
+
+### Added
+
+- **`validates_associated`** — Validates that associated records (loaded via `has_many`) are valid before saving the parent. Only checks in-memory/loaded records — does not trigger DB queries for unloaded associations.
+
+- **`accepts_nested_attributes_for`** — Define nested attribute writers for has_many associations. Supports create, update, and destroy of child records through the parent's save. Nested saves are now wrapped in a DynamoDB transaction for atomicity — if any child operation fails, none are committed.
+
+  ```ruby
+  class Conversation < ActiveItem::Base
+    has_many :messages
+    accepts_nested_attributes_for :messages, allow_destroy: true
+  end
+
+  conversation.messages_attributes = [
+    { role: 'user', body: 'Hello' },
+    { id: 'msg-1', body: 'Updated text' },
+    { id: 'msg-2', _destroy: true }
+  ]
+  conversation.save  # atomic: all children created/updated/destroyed together
+  ```
+
+- **`Relation#loaded?`** — Check whether a has_many relation's records have been loaded into memory.
+
 ## 0.0.18
 
 ### Added

data/lib/active_item/associations.rb

@@ -152,9 +152,92 @@ module ActiveItem
           index_name => { partition_key: dynamo_key }
         )
       end
-    end
 
-    private
+      # Allows nested attributes for associated records, similar to Rails.
+      # Defines a writer method that builds or updates child records through the parent.
+      #
+      # @example
+      #   class Conversation < ApplicationRecord
+      #     has_many :messages
+      #     accepts_nested_attributes_for :messages
+      #   end
+      #
+      #   conversation.messages_attributes = [
+      #     { role: 'user', body: 'Hello' },
+      #     { role: 'assistant', body: 'Hi there' }
+      #   ]
+      #   conversation.save  # saves parent and creates children
+      #
+      # @param associations [Array<Symbol>] Association names to accept nested attributes for
+      # @param options [Hash] Options (allow_destroy: true to enable _destroy flag)
+      def accepts_nested_attributes_for(*associations, **options)
+        associations.each do |association_name|
+          define_nested_attributes_writer(association_name, options)
+        end
+      end
+
+      private
+
+      def define_nested_attributes_writer(association_name, options)
+        writer_method = :"#{association_name}_attributes="
+        allow_destroy = options.fetch(:allow_destroy, false)
+
+        # Store pending nested records for saving after parent
+        define_method(writer_method) do |attributes_collection|
+          attributes_collection = attributes_collection.values if attributes_collection.is_a?(Hash)
+          @_nested_attributes ||= {}
+          @_nested_attributes[association_name] = { records: attributes_collection, allow_destroy: allow_destroy }
+        end
+
+        # Hook into save to persist nested records
+        define_method(:save_with_nested) do
+          result = save_without_nested
+          return result unless result
+
+          save_nested_attributes
+          result
+        end
+
+        define_method(:save_nested_attributes) do
+          return unless instance_variable_defined?(:@_nested_attributes) && @_nested_attributes
+
+          self.class.transaction do
+            @_nested_attributes.each do |assoc_name, config|
+              assoc_config = self.class._associations[assoc_name]
+              next unless assoc_config
+
+              target_class = safe_constantize_model(assoc_config[:class_name])
+              foreign_key = assoc_config[:foreign_key]
+
+              config[:records].each do |attrs|
+                attrs = attrs.transform_keys(&:to_sym)
+
+                if attrs[:_destroy] && config[:allow_destroy]
+                  if attrs[:id]
+                    record = target_class.find(attrs[:id])
+                    record.destroy!
+                  end
+                elsif attrs[:id]
+                  record = target_class.find(attrs[:id])
+                  record.assign_attributes(attrs.except(:id, :_destroy))
+                  record.save!
+                else
+                  target_class.create!(attrs.merge(foreign_key.to_sym => id))
+                end
+              end
+            end
+          end
+
+          @_nested_attributes = nil
+        end
+
+        # Wrap save to include nested attributes
+        return if method_defined?(:save_without_nested)
+
+        alias_method :save_without_nested, :save
+        alias_method :save, :save_with_nested
+      end
+    end
 
     def load_has_many_association(name)
       config = self.class._associations[name]

data/lib/active_item/relation.rb

@@ -31,6 +31,11 @@ module ActiveItem
       @select_attributes = select_attributes # Projection expression attributes
     end
 
+    # Whether the relation's records have been loaded from DynamoDB.
+    def loaded?
+      @loaded
+    end
+
     # Chainable includes - preload associations to avoid N+1 queries
     #
     # Supports three forms:

data/lib/active_item/validations.rb

@@ -50,5 +50,47 @@ module ActiveItem
     def validates_uniqueness_of(*attributes, **options)
       validates(*attributes, uniqueness: options.empty? || options)
     end
+
+    # Validates that the associated records are valid.
+    # If any associated record is invalid, errors are added to the parent.
+    #
+    # @example
+    #   class Conversation < ApplicationRecord
+    #     has_many :messages
+    #     validates_associated :messages
+    #   end
+    #
+    #   conversation.messages.build(role: "invalid")
+    #   conversation.valid? # => false
+    #   conversation.errors[:messages] # => ["is invalid"]
+    def validates_associated(*associations, **options)
+      validates(*associations, associated: options.empty? || options)
+    end
+  end
+
+  # ActiveModel validator that checks associated records are valid.
+  # Validates in-memory built records (via .build) and already-loaded records.
+  # Does not trigger a DB query — only checks what's already in memory.
+  class AssociatedValidator < ActiveModel::EachValidator
+    def validate_each(record, attribute, _value)
+      association_config = record.class._associations[attribute]
+      return unless association_config
+
+      associated = record.send(attribute)
+
+      # Only validate loaded/cached records — don't trigger a DB query
+      records = if associated.respond_to?(:loaded?) && associated.loaded?
+                  associated.to_a
+                else
+                  []
+                end
+
+      records.each do |child|
+        next if child.valid?
+
+        record.errors.add(attribute, :invalid, **options.except(:on))
+        break
+      end
+    end
   end
 end

data/lib/active_item/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activeitem
 version: !ruby/object:Gem::Version
-  version: 0.0.18
+  version: 0.0.19
 platform: ruby
 authors:
 - Andy Davis