CHANGELOG.md

[Unreleased]

[1.2.1] - 2026-03-21

• Improved clarity of error when accessing uninitialized attributes. (#71)
• doc: Minor document adjustments, etc.

[1.2.0] - 2026-01-05

• Avoid issuing multiple saves on the same object. (#56)
• The storage of #models has been changed from an Array to a Set. This prevents duplicate additions of the same object and option combinations. Also, #models#delete now deletes the model regardless of the options used when it was added. (#57)
• Adding an ActiveRecordCompose::Model to #models now throws an error if there is a circular reference. (#58)

[1.1.1] - 2025-12-04

• fix: the save method would return nil instead of false.
• doc: We've simplified the documentation comment yard.

[1.1.0] - 2025-11-19

• Implemented ActiveRecord-like #inspect In activerecord's #inspect, the string is a list of attributes, and we have reproduced a similar format. (#45)
• .with_connection .lease_connection and .connection are deprecated. Use ActiveRecord::Base.with_connection etc. instead. (#46)
• refactor: Remove ActiveRecord::Transactions module dependency (#44)

[1.0.1] - 2025-10-17

• Removed the private interface composite_primary_key? This was previously an internal ActiveRecord dependency, but was not exposed in the release version. (#39)
• Relaxed ActiveRecord dependency upper bound to < 8.2 (#42)

[1.0.0] - 2025-09-23

• drop support rails 7.0.x

[0.12.0] - 2025-08-21

• Omits default arguments for #update and #update!. It's to align I/F with ActiveRecord. (#25)
  • #update(attributes = {}) to #update(attributes)
  • #update!(attributes = {}) to #update!(attributes)
• Omitted Specify instance variables in the :to option of delegate_attribute. (#29)
• Omitted #destroy and #touch from ActiveRecordCompose::Model. These were unintentionally provided by the ActiveRecord::Transactions module. The but in fact did not work correctly. (#27)

[0.11.3] - 2025-07-13

• refactor: Aggregation attribute module. (#24)
• Warn against specifying instance variables, etc. directly in the :to option of delegate_attribute.
  • Deprecated:

    delegate_attribute :foo, to: :@model

  • Recommended:

    delegate_attribute :foo, to: :model
    private
    attr_reader :model

• doc: Expansion of yard documentation comments.

[0.11.2] - 2025-06-29

• ActiveModel::Attributes.attribute_names now takes into account attributes declared in .delegate_attribute
• relax rubocop config.
• refactor: extract persistence module
• Add upper version.
• refactor: extract Delegation class

[0.11.1] - 2025-06-10

• fix: Because define_attribute_methods was not executed, #attributes was evaluated each time attribute? was called.

[0.11.0] - 2025-05-30

• #attribute_names now takes into account attributes declared in .delegate_attribute
• Implemented query methods with a ? suffix for each attribute. Their evaluation behavior is consistent with ActiveRecord. For example:
  • Defining attribute :foo allows calling model.foo?.
  • Defining delegate_attribute :bar, to: :other allows calling model.bar?.

[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.
• adjusted to save errors as soon as an invalid is found.
• drop support rails 6.1.x.

[0.7.0] - 2025-02-12

• rename ActiveRecordCompose::InnerModel to ActiveRecordCompose::WrappedModel
• rename ActiveRecordCompose::InnerModelCollection to ActiveRecordCompose::ComposedCollection
• A new callback control flag, persisted_flag_callback_control, has been defined. Currently, the default value is false, which does not change the existing behavior, but it will be deprecated in the future. When the flag is set to true, the behavior will be almost the same as the callback sequence in ActiveRecord. (#11)

[0.6.3] - 2025-01-31

• fix: type error in ActiveRecordCompose::Model subclass definitions.
• fixed type errors in subclass callback definitions, etc.
• doc: more detailed gem desciption.
• rewrite readme.

[0.6.2] - 2025-01-04

• fix: delegate_attribute defined in a subclass had an unintended side effect on the superclass.
• support ruby 3.4.x
• refactor: remove some steep:ignore by private rbs.
• refactor: place definitions that you don't want to be used much in private rbs.
• make DelegateAttribute dependent on ActiveModel::Attributes since it will not change in practice.

[0.6.1] - 2024-12-23

• refactor: reorganize the overall structure of the test. Change from rspec to minitest
• ci: fix CI for rails new version.

[0.6.0] - 2024-11-11

• refactor: limit the scope of methods needed only for internal library purposes.
• support rails 8.0.x
• add optional value if to exclude from save (or destroy).

[0.5.0] - 2024-10-09

• remove :context option. use :destroy option instead.
• remove :destroy option from InnerModelCollection#destroy.

[0.4.1] - 2024-09-20

• Omitted optional argument for InnerModelCollection#destroy. InnerModel equivalence is always performed based on the instance of the inner model. Since there are no use cases that depend on the original behavior.

[0.4.0] - 2024-09-15

• support destrpy option. and deprecated context option. :context will be removed in 0.5.0. Use :destroy option instead. for example,
  • models.push(model, context: :destroy) is replaced by models.push(model, destroy: true)
  • models.push(model, context: -> { foo? ? :destroy : :save }) is replaced by models.push(model, destroy: -> { foo? })
  • models.push(model, context: ->(m) { m.bar? ? :destroy : :save }) is replaced by models.push(model, destroy: ->(m) { m.bar? })
• destroy option can now be specified with a Symbol representing the method name.

[0.3.4] - 2024-09-01

• ci: removed sqlite3 version specifing for new AR.
• delegate_attribute options are now specific and do not accept prefix

[0.3.3] - 2024-06-24

• use steep:ignore

[0.3.2] - 2024-04-10

• support ActiveRecord::Base#with_connection
• rbs maintained.
• relax context proc arity.

[0.3.1] - 2024-03-17

• purge nodoc definitions from type signature
• support ActiveRecord::Base#lease_connection

[0.3.0] - 2024-02-24

• strictify type checking
• testing with CI even in the head version of rails
• consolidate the main process of saving into the #save method
• leave transaction control to ActiveRecord::Transactions
• execution of before_commit, after_commit and after_rollback hook is delayed until after the database commit (or rollback).

[0.2.1] - 2024-01-31

• in #save (without bang), ActiveRecord::RecordInvalid error is not passed outward.

[0.2.0] - 2024-01-21

• add i18n doc.
• add sig/
• add typecheck for ci.

[0.1.8] - 2024-01-16

• avoid executing #save! from Model#save
• on save, ignore nil elements from models.

[0.1.7] - 2024-01-15

• remove add_development_dependency from gemspec
• add spec for DelegateAttribute module
• add and refactor doc.

[0.1.6] - 2024-01-14

• add doc for #save and #save!.
• implement #save for symmetry with #save!
• add InnerModel#initialize doc.

[0.1.5] - 2024-01-11

• when invalid, raises ActiveRecord::RecordInvalid on #save!

[0.1.4] - 2024-01-10

• remove uniquely defined exception class.

[0.1.3] - 2024-01-09

• fix documentation uri.

[0.1.2] - 2024-01-09

• fix and add doc.
• add development dependency
• avoid instance variable name conflict (@models to @__models)
• add #empty?, #clear to InnerModelCollection
• add #delete to InnerModelCollection

[0.1.1] - 2024-01-08

• fix 0.1.0 release date.
• add doc.
• Make it easier for application developers to work with #models

[0.1.0] - 2024-01-06

• Initial release