activeitem 0.0.14 → 0.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54985c6329129ceac142d8f176c14dfcc68548992f7e00d54a116592ee2a9276
-  data.tar.gz: abee89f1984d42b3dd72991c5db573370ed356d4272be0bb0d4d21163a233f50
+  metadata.gz: 2706d94d7f88c19fdb9fc14d8a9408d1f8dc088a5eabf2e583d60351173b9870
+  data.tar.gz: 41c8e00d8b5a45ec26b58123efc86437795e1921c59dc8c44f3a770727496702
 SHA512:
-  metadata.gz: 456eb037d79395d8a63916245a681af7ad4a98a933cb294226658bf532886a7feb4fa2f90a2593cd1df34d4b5abd6d9299b206af2ad72cb96a5f1aa4ce1d3334
-  data.tar.gz: a0626e95bf4d42f4b1f1c0c453223e50214cbad0be8de67e76539f42ff2c3449027bf78f62a6708303db14195c10558972b9715e7c2f9bbf95c080b5d4bcf509
+  metadata.gz: 41689642db2d18371ae7f9c7987a72d001f3aa18d5e7bb3f0a7248100e5de2a8aa6cb039742057c176bfb6f9eeaa02a240847d50c64f6f02c54372da6c069020
+  data.tar.gz: 5c1a35c85c0b6d641fd630681fccb4995637eb733c50eada9a197a1c2fd503cc62855c1ad14eb81e19ccf324e1da2941ab93cbf87b72e5116285b8b5e49ed7a8

data/lib/active_item/relation.rb

@@ -374,6 +374,39 @@ module ActiveItem
       record
     end
 
+    # Build a new record with the foreign key pre-set (does not save).
+    # Usage: conversation.messages.build(role: "user", body: "hello")
+    # @param attributes [Hash] Attributes for the new record
+    # @return [ActiveItem::Base] The unsaved record
+    def build(attributes = {})
+      foreign_key, foreign_value = conditions.first
+      resolved_model.new(attributes.merge(foreign_key => foreign_value))
+    end
+
+    # Build and save a new record with the foreign key pre-set.
+    # Returns the record (may be invalid — check .persisted? or .errors).
+    # Usage: conversation.messages.create(role: "user", body: "hello")
+    # @param attributes [Hash] Attributes for the new record
+    # @return [ActiveItem::Base] The record (saved if valid)
+    def create(attributes = {})
+      record = build(attributes)
+      record.save
+      reload
+      record
+    end
+
+    # Build and save a new record with the foreign key pre-set.
+    # Raises ActiveItem::RecordInvalid if validations fail.
+    # Usage: conversation.messages.create!(role: "user", body: "hello")
+    # @param attributes [Hash] Attributes for the new record
+    # @return [ActiveItem::Base] The persisted record
+    def create!(attributes = {})
+      record = build(attributes)
+      record.save!
+      reload
+      record
+    end
+
     # Returns the DynamoDB operation that would be executed, without running it.
     # Analogous to ActiveRecord's .to_sql — shows the operation type, table, index,
     # key conditions, filters, and limits in DynamoDB terms.

data/lib/active_item/version.rb

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

metadata

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