active_record_compose 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 690ecf032eb0a4c59c97394702c838142a4d519145f72e58f9a381d956cad5ce
-  data.tar.gz: 7133a2f5defa0d1c97dac41b207936512f6d5375e8f534ea77dc6c13c3f61dde
+  metadata.gz: c78fcb982e3f8f36a5497483ae835eaba9724d72342efc0866ca596c25fa45a8
+  data.tar.gz: 515f08b1def287d06c1d8436a0c3cb466ef75016094e4778b0e9ba992c95cc30
 SHA512:
-  metadata.gz: 2680382210cf6eb2f8371cca7e656f8b00211361f00bf9aed7d2ee4f006a816eee6298a917e48c67d5b4f6149545f2ebb3e67bd5905946279c9e203e9e378d82
-  data.tar.gz: 63aa5b0a8abcbcd59eb81aadadf4c8207622988ad417b09d2e8f977615ed8726233ae8f257f8d8847e16e38f400955e0bda1d9340f9c7733f06ea8d76fa4854a
+  metadata.gz: 1976cef02cc6dbf8d9d543b339254136733c580f116f2ad38c1239fd7a18bdf9a2bde27d7a22be4f041c0eb2576f1bbc97d6e18cfd5859dae52fb2a90624ab69
+  data.tar.gz: 71130efd7792fa18dc33903d12bd6eb7ac17ac59bff95ceeedb2200ce128c3f34fdc7229866f8b5fbeea68f1136bb84dd35a17e2e0167b5990d2b26723022ba3

data/.rubocop.yml

@@ -24,6 +24,9 @@ Style/NumericPredicate:
 Style/OptionalBooleanParameter:
   Enabled: false
 
+Style/ParallelAssignment:
+  Enabled: false
+
 Style/StringLiterals:
   Enabled: true
 

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## [Unreleased]
 
+## [0.10.0] - 2025-04-07
+
+- avoid twice validation. As a side effect, save must accept argument `#save(**options)`.
+  In line with this, the model to be put into models must be
+  at least responsive to `model.valid? && model.save(validate: false)`, not `model.save()` (no arguments).
+- supports context as the first argument of `#valid?`, for example `model.valid(:custom_context)`.
+  At the same time, it accepts `options[:context]` in `#save(**options)`, such as `model.save(context: :custom_context)`.
+  However, this is a convenience support to unify the interface, not a positive one.
+
+## [0.9.0] - 2025-03-16
+
+- removed `persisted_flag_callback_control` support.
+- Omitted `:private` option from `delegate_attribute` because, assuming the
+  behavior and use cases of `ActiveModel::Attributes.attribute`, making it private is unnecessary.
+- Added the URL for the sample application to the README
+
 ## [0.8.0] - 2025-02-22
 
 - changed `persisted_flag_callback_control` default from `false` to `true`.

data/README.md

@@ -16,6 +16,7 @@ activemodel (activerecord) form object pattern. it embraces multiple AR models a
 - [Advanced Usage](#advanced-usage)
   - [`destroy` option](#destroy-option)
   - [Callback ordering by `#persisted?`](#callback-ordering-by-persisted)
+  - [`#save` with custom context option](#save-with-custom-context-option)
 - [Links](#links)
 - [Development](#development)
 - [Contributing](#contributing)
@@ -286,18 +287,11 @@ end
 
 ### Callback ordering by `#persisted?`
 
-The behavior of `(before|after|around)_create` and `(before|after|around)_update` hooks depends on
-the state of the `persisted_flag_callback_control` setting.
-default value is `true`, behavior when set to `false` will be removed in the next release.
-
-When `persisted_flag_callback_control` is set to `true`, it behaves almost like callback control in ActiveRecord.
-Depending on the evaluation result of `#persisted?`,
+The behavior of `(before|after|around)_create` and `(before|after|around)_update` hooks depending on the evaluation result of `#persisted?`,
 either the create-related callbacks or the update-related callbacks will be triggered.
 
 ```ruby
 class ComposedModel < ActiveRecordCompose::Model
-  self.persisted_flag_callback_control = true # In the future, true will be the default and false will no longer be supported.
-
   # ...
 
   before_save { puts 'before_save called!' }
@@ -345,48 +339,65 @@ model.save # or `model.update` (the same callbacks will be triggered in all case
 # after_save called!
 ```
 
-When `persisted_flag_callback_control` is set to false,
-the execution of `#create`, `#update`, or `#save` determines which callbacks will be triggered.
-This behavior will no longer be supported in the next release.
+### `#save` with custom context option
 
-```ruby
-class ComposedModel < ActiveRecordCompose::Model
-  self.persisted_flag_callback_control = false # Currently defaults to false, but will no longer be supported in the future.
+The interface remains consistent with standard ActiveModel and ActiveRecord models, so the :context option works with #save.
 
-  # ...
+```ruby
+composed_model.valid?(:custom_context)
 
-  before_save { puts 'before_save called!' }
-  before_create { puts 'before_create called!' }
-  before_update { puts 'before_update called!' }
-  after_save { puts 'after_save called!' }
-  after_create { puts 'after_create called!' }
-  after_update { puts 'after_update called!' }
-end
+composed_model.save(context: :custom_context)
 ```
 
+However, this may not be ideal from a design perspective.
+If your application requires complex context-specific validations, consider separating models by context.
+
 ```ruby
-model = ComposedModel.new
+class Account < ActiveRecord::Base
+  validates :name, presence: true
+  validates :email, presence: true
+  validates :email, format: { with: /\.edu\z/ }, on: :education
+end
 
-model.save
-# before_save called!
-# after_save called!
+class Registration < ActiveRecordCompose::Model
+  def initialize(attributes = {})
+    models.push(@account = Account.new)
+    super(attributes)
+  end
 
-model.create
-# before_save called!
-# before_create called!
-# after_create called!
-# after_save called!
+  attribute :accept, :boolean
+  validates :accept, presence: true, on: :education
 
-model.update
-# before_save called!
-# before_update called!
-# after_update called!
-# after_save called!
+  delegate_attribute :name, :email, to: :account
+
+  private
+
+  attr_reader :account
+end
+```
+```ruby
+r = Registration.new(name: 'foo', email: 'example@example.com', accept: false)
+r.valid?
+=> true
+
+r.valid?(:education)
+=> false
+r.errors.map { [_1.attribute, _1.type] }
+=> [[:email, :invalid], [:accept, :blank]]
+
+r.email = 'example@example.edu'
+r.accept = true
+
+r.valid?(:education)
+=> true
+r.save(context: :education)
+=> true
 ```
 
 ## Links
 
 - [Smart way to update multiple models simultaneously in Rails](https://dev.to/hamajyotan/smart-way-to-update-multiple-models-simultaneously-in-rails-51b6)
+- [Sample application as an example](https://github.com/hamajyotan/active_record_compose-example)
 
 ## Development
 

data/lib/active_record_compose/callbacks.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module ActiveRecordCompose
+  module Callbacks
+    extend ActiveSupport::Concern
+
+    included do
+      define_model_callbacks :save
+      define_model_callbacks :create
+      define_model_callbacks :update
+    end
+
+    private
+
+    def with_callbacks(&block) = run_callbacks(:save) { run_callbacks(callback_context, &block) }
+
+    def callback_context = persisted? ? :update : :create
+  end
+end

data/lib/active_record_compose/delegate_attribute.rb

@@ -45,7 +45,7 @@ module ActiveRecordCompose
     module ClassMethods
       # Defines the reader and writer for the specified attribute.
       #
-      def delegate_attribute(*attributes, to:, allow_nil: nil, private: nil)
+      def delegate_attribute(*attributes, to:, allow_nil: nil)
         delegates = attributes.flat_map do |attribute|
           reader = attribute.to_s
           writer = "#{attribute}="
@@ -53,7 +53,7 @@ module ActiveRecordCompose
           [reader, writer]
         end
 
-        delegate(*delegates, to:, allow_nil:, private:)
+        delegate(*delegates, to:, allow_nil:)
         self.delegated_attributes = delegated_attributes.to_a + attributes.map { _1.to_s }
       end
     end

data/lib/active_record_compose/model.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
+require 'active_record_compose/callbacks'
 require 'active_record_compose/composed_collection'
 require 'active_record_compose/delegate_attribute'
 require 'active_record_compose/transaction_support'
+require 'active_record_compose/validations'
 
 module ActiveRecordCompose
   using ComposedCollection::PackagePrivate
@@ -12,52 +14,10 @@ module ActiveRecordCompose
     include ActiveModel::Validations::Callbacks
     include ActiveModel::Attributes
 
+    include ActiveRecordCompose::Callbacks
     include ActiveRecordCompose::DelegateAttribute
     include ActiveRecordCompose::TransactionSupport
-
-    # This flag controls the callback sequence for models.
-    # The current default value is `true`, behavior when set to `false` will be removed in the next release.
-    #
-    # When `persisted_flag_callback_control` is set to `true`,
-    # the occurrence of callbacks depends on the evaluation result of `#persisted?`.
-    # Additionally, the definition of `#persisted?` itself can be appropriately overridden in subclasses.
-    #
-    # if `#persisted?` returns `false`:
-    # * before_save
-    # * before_create
-    # * after_create
-    # * after_save
-    #
-    # if `#persisted?` returns `true`:
-    # * before_save
-    # * before_update
-    # * after_update
-    # * after_save
-    #
-    # On the other hand, when `persisted_flag_callback_control` is set to `false`,
-    # the invoked methods during saving operations vary depending on the method used.
-    #
-    # when performing `#save` or `#save!`:
-    # * before_save
-    # * after_save
-    #
-    # when performing `#update` or `#update!`:
-    # * before_save
-    # * before_update
-    # * after_update
-    # * after_save
-    #
-    # when performing `#create` or `#create!`:
-    # * before_save
-    # * before_create
-    # * after_create
-    # * after_save
-    #
-    class_attribute :persisted_flag_callback_control, instance_accessor: false, default: true
-
-    define_model_callbacks :save
-    define_model_callbacks :create
-    define_model_callbacks :update
+    prepend ActiveRecordCompose::Validations
 
     validate :validate_models
 
@@ -70,23 +30,16 @@ module ActiveRecordCompose
     #
     # The save is performed within a single transaction.
     #
+    # Only the `:validate` option takes effect as it is required internally.
+    # However, we do not recommend explicitly specifying `validate: false` to skip validation.
+    # Additionally, the `:context` option is not accepted.
+    # The need for such a value indicates that operations from multiple contexts are being processed.
+    # If the contexts differ, we recommend separating them into different model definitions.
+    #
     # @return [Boolean] returns true on success, false on failure.
-    def save
-      return false if invalid?
-
+    def save(**options)
       with_transaction_returning_status do
-        if self.class.persisted_flag_callback_control
-          with_callbacks { save_models(bang: false) }
-        else
-          # steep:ignore:start
-          deprecator.warn(
-            'The behavior with `persisted_flag_callback_control` set to `false` will be removed in 0.9.0. ' \
-            'Use `self.persisted_flag_callback_control = true` set to `true`. ' \
-            '(Alternatively, exclude statements that set `false`)',
-          )
-          # steep:ignore:end
-          run_callbacks(:save) { save_models(bang: false) }
-        end
+        with_callbacks { save_models(**options, bang: false) }
       rescue ActiveRecord::RecordInvalid
         false
       end
@@ -97,165 +50,35 @@ module ActiveRecordCompose
     #
     # Saving, like `#save`, is performed within a single transaction.
     #
-    def save!
-      valid? || raise_validation_error
-
-      with_transaction_returning_status do
-        if self.class.persisted_flag_callback_control
-          with_callbacks { save_models(bang: true) }
-        else
-          # steep:ignore:start
-          deprecator.warn(
-            'The behavior with `persisted_flag_callback_control` set to `false` will be removed in 0.9.0. ' \
-            'Use `self.persisted_flag_callback_control = true` set to `true`. ' \
-            '(Alternatively, exclude statements that set `false`)',
-          )
-          # steep:ignore:end
-          run_callbacks(:save) { save_models(bang: true) }
-        end
-      end || raise_on_save_error
-    end
-
-    # Behavior is same to `#save`, but `before_create` and `after_create` hooks fires.
-    #
-    #   class ComposedModel < ActiveRecordCompose::Model
-    #     # ...
-    #
-    #     before_save { puts 'before_save called!' }
-    #     before_create { puts 'before_create called!' }
-    #     before_update { puts 'before_update called!' }
-    #     after_save { puts 'after_save called!' }
-    #     after_create { puts 'after_create called!' }
-    #     after_update { puts 'after_update called!' }
-    #   end
+    # Only the `:validate` option takes effect as it is required internally.
+    # However, we do not recommend explicitly specifying `validate: false` to skip validation.
+    # Additionally, the `:context` option is not accepted.
+    # The need for such a value indicates that operations from multiple contexts are being processed.
+    # If the contexts differ, we recommend separating them into different model definitions.
     #
-    #   model = ComposedModel.new
-    #
-    #   model.save
-    #   # before_save called!
-    #   # after_save called!
-    #
-    #   model.create
-    #   # before_save called!
-    #   # before_create called!
-    #   # after_create called!
-    #   # after_save called!
-    #
-    # @deprecated
-    def create(attributes = {})
-      if self.class.persisted_flag_callback_control
-        raise '`#create` cannot be called. The context for creation or update is determined by the `#persisted` flag.'
-      end
-
-      # steep:ignore:start
-      deprecator.warn(
-        'The behavior with `persisted_flag_callback_control` set to `false` will be removed in 0.9.0. ' \
-        'Use `self.persisted_flag_callback_control = true` set to `true`. ' \
-        '(Alternatively, exclude statements that set `false`)',
-      )
-      # steep:ignore:end
-
-      assign_attributes(attributes)
-      return false if invalid?
-
+    def save!(**options)
       with_transaction_returning_status do
-        with_callbacks(context: :create) { save_models(bang: false) }
-      rescue ActiveRecord::RecordInvalid
-        false
-      end
-    end
-
-    # Behavior is same to `#create`, but raises an exception prematurely on failure.
-    #
-    # @deprecated
-    def create!(attributes = {})
-      if self.class.persisted_flag_callback_control
-        raise '`#create` cannot be called. The context for creation or update is determined by the `#persisted` flag.'
-      end
-
-      # steep:ignore:start
-      deprecator.warn(
-        'The behavior with `persisted_flag_callback_control` set to `false` will be removed in 0.9.0. ' \
-        'Use `self.persisted_flag_callback_control = true` set to `true`. ' \
-        '(Alternatively, exclude statements that set `false`)',
-      )
-      # steep:ignore:end
-
-      assign_attributes(attributes)
-      valid? || raise_validation_error
-
-      with_transaction_returning_status do
-        with_callbacks(context: :create) { save_models(bang: true) }
+        with_callbacks { save_models(**options, bang: true) }
       end || raise_on_save_error
     end
 
-    # Behavior is same to `#save`, but `before_update` and `after_update` hooks fires.
-    #
-    #   class ComposedModel < ActiveRecordCompose::Model
-    #     # ...
-    #
-    #     before_save { puts 'before_save called!' }
-    #     before_create { puts 'before_create called!' }
-    #     before_update { puts 'before_update called!' }
-    #     after_save { puts 'after_save called!' }
-    #     after_create { puts 'after_create called!' }
-    #     after_update { puts 'after_update called!' }
-    #   end
-    #
-    #   model = ComposedModel.new
-    #
-    #   model.save
-    #   # before_save called!
-    #   # after_save called!
-    #
-    #   model.update
-    #   # before_save called!
-    #   # before_update called!
-    #   # after_update called!
-    #   # after_save called!
+    # Assign attributes and save.
     #
+    # @return [Boolean] returns true on success, false on failure.
     def update(attributes = {})
-      assign_attributes(attributes)
-      return false if invalid?
-
       with_transaction_returning_status do
-        if self.class.persisted_flag_callback_control
-          with_callbacks { save_models(bang: false) }
-        else
-          # steep:ignore:start
-          deprecator.warn(
-            'The behavior with `persisted_flag_callback_control` set to `false` will be removed in 0.9.0. ' \
-            'Use `self.persisted_flag_callback_control = true` set to `true`. ' \
-            '(Alternatively, exclude statements that set `false`)',
-          )
-          # steep:ignore:end
-          with_callbacks(context: :update) { save_models(bang: false) }
-        end
-      rescue ActiveRecord::RecordInvalid
-        false
+        assign_attributes(attributes)
+        save
       end
     end
 
     # Behavior is same to `#update`, but raises an exception prematurely on failure.
     #
     def update!(attributes = {})
-      assign_attributes(attributes)
-      valid? || raise_validation_error
-
       with_transaction_returning_status do
-        if self.class.persisted_flag_callback_control
-          with_callbacks { save_models(bang: true) }
-        else
-          # steep:ignore:start
-          deprecator.warn(
-            'The behavior with `persisted_flag_callback_control` set to `false` will be removed in 0.9.0. ' \
-            'Use `self.persisted_flag_callback_control = true` set to `true`. ' \
-            '(Alternatively, exclude statements that set `false`)',
-          )
-          # steep:ignore:end
-          with_callbacks(context: :update) { save_models(bang: true) }
-        end
-      end || raise_on_save_error
+        assign_attributes(attributes)
+        save!
+      end
     end
 
     # Returns true if model is persisted.
@@ -271,34 +94,12 @@ module ActiveRecordCompose
 
     def models = @__models ||= ActiveRecordCompose::ComposedCollection.new(self)
 
-    def validate_models
-      models.__wrapped_models.lazy.select { _1.invalid? }.each { errors.merge!(_1) }
-    end
-
-    def with_callbacks(context: nil, &block)
-      run_callbacks(:save) { run_callbacks(callback_context(context:), &block) }
-    end
-
-    def callback_context(context: nil)
-      context || (persisted? ? :update : :create)
-    end
-
-    def save_models(bang:)
-      models.__wrapped_models.all? { bang ? _1.save! : _1.save }
+    def save_models(bang:, **options)
+      models.__wrapped_models.all? { bang ? _1.save!(**options, validate: false) : _1.save(**options, validate: false) }
     end
 
-    def raise_validation_error = raise ActiveRecord::RecordInvalid, self
-
     def raise_on_save_error = raise ActiveRecord::RecordNotSaved.new(raise_on_save_error_message, self)
 
     def raise_on_save_error_message = 'Failed to save the model.'
-
-    def deprecator
-      if ActiveRecord.respond_to?(:deprecator)
-        ActiveRecord.deprecator # steep:ignore
-      else # for rails 7.0.x or lower
-        ActiveSupport::Deprecation
-      end
-    end
   end
 end

data/lib/active_record_compose/transaction_support.rb

@@ -18,7 +18,7 @@ module ActiveRecordCompose
 
       def with_connection(&) = ar_class.with_connection(&) # steep:ignore
 
-      def composite_primary_key? = false
+      def composite_primary_key? = false # steep:ignore
 
       private
 

data/lib/active_record_compose/validations.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module ActiveRecordCompose
+  using ComposedCollection::PackagePrivate
+
+  module Validations
+    def save(**options)
+      perform_validations(options) ? super : false
+    end
+
+    def save!(**options)
+      perform_validations(options) ? super : raise_validation_error
+    end
+
+    def valid?(context = nil) = context_for_override_validation.with_override(context) { super }
+
+    private
+
+    def validate_models
+      context = override_validation_context
+      models.__wrapped_models.lazy.select { _1.invalid?(context) }.each { errors.merge!(_1) }
+    end
+
+    def perform_validations(options)
+      options[:validate] == false || valid?(options[:context])
+    end
+
+    def raise_validation_error = raise ActiveRecord::RecordInvalid, self
+
+    def context_for_override_validation
+      @context_for_override_validation ||= OverrideValidationContext.new
+    end
+
+    def override_validation_context = context_for_override_validation.context
+
+    class OverrideValidationContext
+      attr_reader :context
+
+      def with_override(context)
+        @context, original = context, @context
+        yield
+      ensure
+        @context = original # steep:ignore
+      end
+    end
+    private_constant :OverrideValidationContext
+  end
+end

data/lib/active_record_compose/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveRecordCompose
-  VERSION = '0.8.0'
+  VERSION = '0.10.0'
 end

data/lib/active_record_compose/wrapped_model.rb

@@ -60,7 +60,7 @@ module ActiveRecordCompose
     # Whether save or destroy is executed depends on the value of `#destroy_context?`.
     #
     # @return [Boolean] returns true on success, false on failure.
-    def save
+    def save(**options)
       # While errors caused by the type check are avoided,
       # it is important to note that an error can still occur
       # if `#destroy_context?` returns true but ar_like does not implement `#destroy`.
@@ -70,14 +70,14 @@ module ActiveRecordCompose
         m.destroy
       else
         # @type var m: ActiveRecordCompose::_ARLike
-        m.save
+        m.save(**options)
       end
     end
 
     # Execute save or destroy. Unlike #save, an exception is raises on failure.
     # Whether save or destroy is executed depends on the value of `#destroy_context?`.
     #
-    def save!
+    def save!(**options)
       # While errors caused by the type check are avoided,
       # it is important to note that an error can still occur
       # if `#destroy_context?` returns true but ar_like does not implement `#destroy`.
@@ -87,15 +87,15 @@ module ActiveRecordCompose
         m.destroy!
       else
         # @type var model: ActiveRecordCompose::_ARLike
-        m.save!
+        m.save!(**options)
       end
     end
 
     # @return [Boolean]
-    def invalid? = destroy_context? ? false : model.invalid?
+    def invalid?(context = nil) = !valid?(context)
 
     # @return [Boolean]
-    def valid? = !invalid?
+    def valid?(context = nil) = destroy_context? || model.valid?(context)
 
     # Returns true if equivalent.
     #

data/sig/_internal/package_private.rbs

@@ -1,4 +1,15 @@
 module ActiveRecordCompose
+  module Callbacks
+    include ActiveModel::Model
+    include ActiveModel::Validations::Callbacks
+    extend ActiveSupport::Concern
+    extend ActiveModel::Callbacks
+
+    private
+    def with_callbacks: { () -> bool } -> bool
+    def callback_context: -> (:create | :update)
+  end
+
   class ComposedCollection
     def initialize: (Model) -> void
 
@@ -24,7 +35,7 @@ module ActiveRecordCompose
     def delegated_attributes: () -> Array[String]
 
     module ClassMethods : Module
-      def delegate_attribute: (*untyped methods, to: untyped, ?allow_nil: untyped?, ?private: untyped?) -> untyped
+      def delegate_attribute: (*untyped methods, to: untyped, ?allow_nil: untyped?) -> untyped
       def delegated_attributes: () -> Array[String]
       def delegated_attributes=: (Array[String]) -> untyped
     end
@@ -35,8 +46,13 @@ module ActiveRecordCompose
     extend DelegateAttribute::ClassMethods
     include TransactionSupport
     extend TransactionSupport::ClassMethods
+    include ActiveRecordCompose::Callbacks
 
     @__models: ComposedCollection
+
+    private
+    def validate_models: -> void
+    def override_validation_context: -> validation_context
   end
 
   module TransactionSupport
@@ -54,14 +70,37 @@ module ActiveRecordCompose
     end
   end
 
+  module Validations : Model
+    def save: (**untyped options) -> bool
+    def save!: (**untyped options) -> untyped
+    def valid?: (?validation_context context) -> bool
+
+    @context_for_override_validation: OverrideValidationContext
+
+    private
+
+    def perform_validations: (::Hash[untyped, untyped]) -> bool
+    def raise_validation_error: -> bot
+    def context_for_override_validation: -> OverrideValidationContext
+    def override_validation_context: -> validation_context
+
+    class OverrideValidationContext
+      @context: validation_context
+
+      attr_reader context: validation_context
+
+      def with_override: [T] (validation_context) { () -> T } -> T
+    end
+  end
+
   class WrappedModel
     def initialize: (ar_like, ?destroy: (bool | destroy_context_type), ?if: (nil | condition_type)) -> void
     def destroy_context?: -> bool
     def ignore?: -> bool
-    def save: -> bool
-    def save!: -> untyped
-    def invalid?: -> bool
-    def valid?: -> bool
+    def save: (**untyped options) -> bool
+    def save!: (**untyped options) -> untyped
+    def invalid?: (?validation_context context) -> bool
+    def valid?: (?validation_context context) -> bool
     def is_a?: (untyped) -> bool
     def ==: (untyped) -> bool
 

data/sig/active_record_compose.rbs

@@ -5,27 +5,29 @@ module ActiveRecordCompose
   VERSION: String
 
   interface _ARLike
-    def save: -> bool
-    def save!: -> untyped
-    def invalid?: -> bool
-    def valid?: -> bool
+    def save: (**untyped options) -> bool
+    def save!: (**untyped options) -> untyped
+    def invalid?: (?validation_context context) -> bool
+    def valid?: (?validation_context context) -> bool
     def errors: -> untyped
     def is_a?: (untyped) -> bool
     def ==: (untyped) -> bool
   end
   interface _ARLikeWithDestroy
-    def save: -> bool
-    def save!: -> untyped
+    def save: (**untyped options) -> bool
+    def save!: (**untyped options) -> untyped
     def destroy: -> bool
     def destroy!: -> untyped
-    def invalid?: -> bool
-    def valid?: -> bool
+    def invalid?: (?validation_context context) -> bool
+    def valid?: (?validation_context context) -> bool
     def errors: -> untyped
     def is_a?: (untyped) -> bool
     def ==: (untyped) -> bool
   end
   type ar_like = (_ARLike | _ARLikeWithDestroy)
 
+  type validation_context = nil | Symbol | Array[Symbol]
+
   type condition[T] = Symbol | ^(T) [self: T] -> boolish
   type callback[T] = Symbol | ^(T) [self: T] -> void
   type around_callback[T] = Symbol | ^(T, Proc) [self: T] -> void
@@ -69,30 +71,21 @@ module ActiveRecordCompose
     def self.after_commit: (*callback[instance], ?if: condition[instance], ?unless: condition[instance], **untyped) ?{ () [self: instance] -> void } -> void
     def self.after_rollback: (*callback[instance], ?if: condition[instance], ?unless: condition[instance], **untyped) ?{ () [self: instance] -> void } -> void
 
-    def self.persisted_flag_callback_control: () -> boolish
-    def self.persisted_flag_callback_control=: (boolish) -> untyped
-
-    def self.delegate_attribute: (*untyped methods, to: untyped, ?allow_nil: untyped?, ?private: untyped?) -> untyped
+    def self.delegate_attribute: (*untyped methods, to: untyped, ?allow_nil: untyped?) -> untyped
     def self.connection: -> ActiveRecord::ConnectionAdapters::AbstractAdapter
     def self.lease_connection: -> ActiveRecord::ConnectionAdapters::AbstractAdapter
     def self.with_connection: [T] () { () -> T } -> T
 
     def initialize: (?Hash[attribute_name, untyped]) -> void
-    def save: -> bool
-    def save!: -> untyped
-    def create: (?Hash[attribute_name, untyped]) -> bool
-    def create!: (?Hash[attribute_name, untyped]) -> untyped
+    def save: (**untyped options) -> bool
+    def save!: (**untyped options) -> untyped
     def update: (?Hash[attribute_name, untyped]) -> bool
     def update!: (?Hash[attribute_name, untyped]) -> untyped
     def id: -> untyped
 
     private
     def models: -> ComposedCollection
-    def with_callbacks: (?context: (nil | :create | :update)) { () -> bool } -> bool
-    def callback_context: (?context: (nil | :create | :update)) -> (:create | :update)
-    def validate_models: -> void
-    def save_models: (bang: bool) -> bool
-    def raise_validation_error: -> bot
+    def save_models: (bang: bool, **untyped options) -> bool
     def raise_on_save_error: -> bot
     def raise_on_save_error_message: -> String
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: active_record_compose
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - hamajyotan
 bindir: bin
 cert_chain: []
-date: 2025-02-22 00:00:00.000000000 Z
+date: 2025-04-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -37,10 +37,12 @@ files:
 - LICENSE.txt
 - README.md
 - lib/active_record_compose.rb
+- lib/active_record_compose/callbacks.rb
 - lib/active_record_compose/composed_collection.rb
 - lib/active_record_compose/delegate_attribute.rb
 - lib/active_record_compose/model.rb
 - lib/active_record_compose/transaction_support.rb
+- lib/active_record_compose/validations.rb
 - lib/active_record_compose/version.rb
 - lib/active_record_compose/wrapped_model.rb
 - sig/_internal/package_private.rbs
@@ -52,7 +54,7 @@ metadata:
   homepage_uri: https://github.com/hamajyotan/active_record_compose
   source_code_uri: https://github.com/hamajyotan/active_record_compose
   changelog_uri: https://github.com/hamajyotan/active_record_compose/blob/main/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/active_record_compose/0.8.0
+  documentation_uri: https://www.rubydoc.info/gems/active_record_compose/0.10.0
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: