rom 5.4.1 → 6.0.0.alpha1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f78614ebe29df613821eb9d8c814c8adeca27c8a4ddc9f302e4fa95bf77a9d0
-  data.tar.gz: f791266878776c46aa41976175ee6a54fbcc58c7ece785f7d3abc4fa98147f08
+  metadata.gz: 3dd988f906dce6d2688a81ef514a35dcf5661708a02381bcc929950b9ffee9ee
+  data.tar.gz: 63cf0036ba18ce38385b915bb9ac44b6a022cb6066575a596f675fe15a485dac
 SHA512:
-  metadata.gz: facb0dc67eee323b66c7b13620c74c6f343f8f8ade4e6357a8db4c135bcee1420a7840c95a96b6c7104d1b25c31dacba5834db6d9a29ffaefefd728e88ac7eca
-  data.tar.gz: 8e05837d811ed972a7f44dd4c71c0d2f737c6bd9e3940f982ff186f822b40bf7342814db238a49af6a0766d295dfb69f67956a4a83e529d398dd5cb25dff6cd9
+  metadata.gz: 7dccbadae0c2c95428bb7303a7afca7f878d72ce6ac0824dc8002bf4d6d9bba950d0e50ea3d74e53ec2b8edf157c58315e3b584180009c9b2f0d1e3e423fed13
+  data.tar.gz: bb9a618db56d1d3f803b17f8390261f50e4c0a381fc8b8e7090ed6efce288daa5adaeddd6c01c8900f0117cdb86276d2d3c73335956f88a141c62268a25f1431

data/CHANGELOG.md

@@ -1,92 +1,85 @@
-## 5.4.1 2025-01-09
+<!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
-### Fixed
-
-- [rom-repository] `set_relation` is deprecated and will be removed in 6.0.0 (issue #698 fixed via #699) (@flash-gordon)
-
-## 5.4.0 2025-01-08
-
-### Fixed
-
-- [rom-repository] reduce memory allocation for relations reader in repository and regisry reader (issue #694 fixed via #695 and #695 and #697) (@flash-gordon)
-
-### Changed
-
-- [rom-core] Ruby 3.1 is now the minimum supported version (@flash-gordon)
-
-[Compare v5.3.2...v5.4.0](https://github.com/rom-rb/rom/compare/v5.3.2...v5.4.0)
-
-## 5.3.2 2024-05-06
-
-### Fixed
-
-- [rom-core] another fix caused by `Object#with` from ActiveSupport 7.1 (@flash-gordon)
-
-[Compare v5.3.1...v5.3.2](https://github.com/rom-rb/rom/compare/v5.3.1...v5.3.2)
-
-## 5.3.1 2024-03-15
-
-### Changed
-
-- [rom-core] workaround for compatibility with `Object#with` added in ActiveSupport 7.1 (@rykov + @flash-gordon)
+## 6.0.0.alpha1 2022-04-15
 
-[Compare v5.3.0...v5.3.1](https://github.com/rom-rb/rom/compare/v5.3.0...v5.3.1)
+This is a major release but it's backward compatible. Please see [the upgrade guide](https://github.com/rom-rb/rom/wiki/6.0-Upgrade-Guide) as there are
+a couple of extra steps required for the upgrade.
 
-## 5.3.0 2022-11-11
 
-### Changed
+### Added
 
-- [rom] Upgraded to the latest versions of dry-* (@flash-gordon)
+- New settings API for components using dry-configurable (via #651) (@solnic)
+- ROM(...) shortcut method for setting up rom, ie `ROM(:sql, "sqlite::memory")` (@solnic)
+- You can now configure a custom inflector via configuration (PR #591) (@flash-gordon)
+- New component API that replaces internal implementation of the finalization code and makes it possible to extend ROM with arbitrary component types (see #637) (@solnic)
+- Generic Component API which allows you to turn any class or object into a DSL that can define rom components (via #650) (@solnic)
+- Support for defining abstract components via `config.component.abstract` in which case they won't be initialized for runtime usage (via #651) (@solnic)
+- Ability to provide top-level component configuration ie default gateway, adapter, inflector etc. (via #653) (@solnic)
+- Ability to configure gateways using configuration DSL (via #653) (@solnic)
+- Ability to define schemas without relations (via #653) (@solnic)
+- Relation view schemas that are defined via `Relation.view` DSL are now registered too, which makes them more accessible/reusable (via #653) (@solnic)
+- Global configuration that can provide default settings for all your components. ie a default adapter, gateway etc. (via #654) (@solnic)
+- Support for custom namespaces under which commands and mappers can be registered (via #654) (@solnic)
+- Top-level `associations` DSL (via #656) (@solnic)
+- Support for configuring plugins on a per-component *instance* basis, which means that implementing plugins is now simpler and more powerful (via #656) (@solnic)
+- New relation setting: `component.infer_id_from_class` (via #661) (@solnic)
+- [experimental] New `ROM.components` API for registering custom component types (via #654) (@solnic)
+- .transaction methods now accept keyword arguments. `Repository#transaction` accepts gateway to use. `Repository::Root#transaction` uses a gateway of the root relation by default (#620 closed by #621) (@flash-gordon)
+- Backward-compatibility extension that you can load via `require "rom/compat"` (via #634 refs #607) (@solnic)
 
 ### Fixed
 
-- [rom-core] warning about using `lambda` without a literal block (@flash-gordon)
-
-[Compare v5.2.6...v5.3.0](https://github.com/rom-rb/rom/compare/v5.2.6...v5.3.0)
-
-## 5.2.6 2021-01-16
+- Setup works under MRI 3.0.0 (issue #622 fixed via #623) (@v-kolesnikov)
 
 ### Changed
 
-- [rom] Dependency on `rom-core` was bumped to `>= 5.2.5` (@solnic)
-
-### Fixed
-
-- [rom-core] Setup works under MRI 3.0.0 (issue #622 fixed via #623) (@v-kolesnikov)
+- [BREAKING] `rom-core`, `rom-changeset` and `rom-repository` have been merged into `rom` gem (@solnic)
+- [BREAKING] `Setup#auto_registration` was renamed to `Setup#auto_register`. You can restore the original method via rom/compat extension (via #634 refs #607) (@solnic)
+- [BREAKING] `Configuration#method_missing` no longer resolves gateways by default. This functionality was moved to rom/compat (@solnic)
+- [BREAKING] `ROM::Configuration` is deprecated and it was replaced by `ROM::Setup`. It can be restored via rom/compat (via #653) (@solnic)
+- `ROM.container` is deprecated and it was replaced by `ROM.runtime` (via #653) (@solnic)
+- `Schema#[]` and `Relation#[]` now raise an error if a given attribute is not unique (issue #529 fixed via #543) (@waiting-for-dev)
+- Configuration values are no longer being frozen during setup process (issue #616 fixed via #617) (@v-kolesnikov)
+- Custom commands are now lazily-resolved at runtime, which simplifies and speeds up setup and finalization (via #641) (@solnic)
+- Mappers are now lazy-resolved at runtime which speeds up setup and finalization (via #642) (@solnic)
+- Schemas are now 1st class components accessible via runtime container and decoupled from relations (via #644) (@solnic)
+- `Relation.dataset` receives canonical schema object now, rather than relation class (via #644) (@solnic)
+- Relation classes no holder hold their schemas as class variables (via #644) (@solnic)
+- Gateways are now lazy-loadable (via #645) (@solnic)
+- Associations are now decoupled from schemas and lazy-loaded (via #646) (@solnic)
+- Plugin API is now internally simplified which resulted in faster runtime. It's also no longer required to register plugin types upfront (via #648) (@solnic)
+- Configuring auto_register stores its config under `config.auto_register` (via #650) (@solnic)
+- [internal] auto registration is now powered by Zeitwerk (via #634 refs #607) (@solnic)
+- Plugin event listeners are no longer global which makes it possible to have plugin with different configs in a single process (via #639) (@solnic)
+- [internal] Command compiler is no longer coupled to gateway and notifications (via #640) (@solnic)
+- Plugin configurations **are no longer global** which means that you can configure the same plugin with different default settings for different component groups or different runtimes in the same Ruby process (via #654) (@solnic)
+- `Schema::DSL` is now deprecated. Adapters that need customized schema DSL behavior can provide plugins instead (via #656) (@solnic)
+- `ROM.plugins` returns global plugin registry when called without a block (via #660) (@solnic)
+- [internal] `ROM::Container` is deprecated and it was replaced by `ROM::Registries::Root`. It can be restored via rom/compat (via #653) (@solnic)
+- [internal] Commands that are compiled at runtime are now cached in the runtime registry (via #653) (@solnic)
+- [internal] `ROM.plugin_registry` is deprecated, use `ROM.plugins` instead (via #660) (@solnic)
+- [REVISIT] configuring custom gateway for a relation via DSL requires passing it as an option rather than specifying it within the block. It kinda-worked previously because the adapter was defaulting to the first one found. I'm quite sure this was more like a bug than a feature. This behavior could be restored in rom/compat though - it's a matter of defaulting to the first adapter found when gateway was not explicitly specified, meaning the new default should be set to `Undefined` rather than `:default` so that we can detect when it was not specified and act accordingly. This will only make sense when there's just *one adapter available* (via bedb330f0ec195d9acacf4481dad3a705e8a36af) (@solnic)
+
+[Compare v5.2.4...v6.0.0.alpha1](https://github.com/rom-rb/rom/compare/v5.2.4...v6.0.0.alpha1)
 
-[Compare v5.2.5...v5.2.6](https://github.com/rom-rb/rom/compare/v5.2.5...v5.2.6)
+## 5.2.4 2020-05-08
 
-## 5.2.5 2020-12-30
 
 ### Fixed
 
-- [rom-core] auto-registration sorts files now which fixes some (rare) issues with file loading (@v-kolesnikov)
-- [rom-core] configuration values are no longer being frozen during finalization of the setup (@v-kolesnikov)
-
-### Changed
+- [rom] Bumped rom-changeset version (@flash-gordon)
 
-- [rom] Dependency on `rom-core` was bumped to `>= 5.2.4` (@solnic)
-
-[Compare v5.2.4...v5.2.5](https://github.com/rom-rb/rom/compare/v5.2.4...v5.2.5)
-
-## 5.2.4 2020-05-08
-
-### Changed
-
-- [rom] Dependency on `rom-changeset` was bumped to `>= 5.2.3` (@flash-gordon)
 
 [Compare v5.2.3...v5.2.4](https://github.com/rom-rb/rom/compare/v5.2.3...v5.2.4)
 
 ## 5.2.3 2020-05-07
 
-### Fixed
 
-- [rom-core] Fix duplicated input processing in update commands (see #594) (@flash-gordon)
-- [rom-changeset] fix binding mapping functions in `Update` changesets (@timriley & @flash-gordon)
+### Fixed
 
-### Changed
+- [rom-core] Constructor types were fired twice when updating data (@flash-gordon)
+- [rom-changeset] fixed a regression where a map function in `Update` changesets was not evaluated in the context of a changeset object (fixed via #592) (@timriley + @solnic)
 
-- [rom] Dependency on `rom-core` was bumped to `>= 5.2.3` (@solnic)
 
 [Compare v5.2.2...v5.2.3](https://github.com/rom-rb/rom/compare/v5.2.2...v5.2.3)
 
@@ -311,4 +304,4 @@ Yanked and republished as 5.2.1
 
 ## 4.0.0 2017-10-18
 
-This release turns `rom` gem into a meta gem which depends on `rom-core`, `rom-mapper`, `rom-repository` and `rom-changeset'`. See [CHANGELOG](https://github.com/rom-rb/rom/blob/master/core/CHANGELOG.md#v400-2017-10-18) in core for more information.
+This release turns `rom` gem into a meta gem which depends on `rom-core`, `rom-mapper`, `rom-repository` and `rom-changeset'`. See [CHANGELOG](https://github.com/rom-rb/rom/blob/main/core/CHANGELOG.md#v400-2017-10-18) in core for more information.

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2019 rom-rb team
+Copyright (c) 2015-2021 rom-rb team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/README.md

@@ -10,7 +10,7 @@
 [![CI Status](https://github.com/rom-rb/rom/workflows/ci/badge.svg)][actions]
 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/f473a2496d6e41ed94d3fc1e96c4a486)][codacy]
 [![Codacy Badge](https://api.codacy.com/project/badge/Coverage/f473a2496d6e41ed94d3fc1e96c4a486)][codacy]
-[![Inline docs](http://inch-ci.org/github/rom-rb/rom.svg?branch=master&style=flat)][inchpages]
+[![Inline docs](http://inch-ci.org/github/rom-rb/rom.svg?branch=main&style=flat)][inchpages]
 [![OpenCollective](https://opencollective.com/rom/backers/badge.svg)](#backers)
 [![OpenCollective](https://opencollective.com/rom/sponsors/badge.svg)](#sponsors)
 
@@ -20,14 +20,14 @@ the full power of your database.
 
 Main rom gem provides following components:
 
-* [core](https://github.com/rom-rb/rom/blob/master/core/README.md) - Core and Adapter APIs
-* [changeset](https://github.com/rom-rb/rom/blob/master/changeset/README.md) - Changeset objects integrated with rom-core
-* [repository](https://github.com/rom-rb/rom/blob/master/repository/README.md) - Additional repository abstraction integrated with rom-core
+* [core](https://github.com/rom-rb/rom/blob/main/core/README.md) - Core and Adapter APIs
+* [changeset](https://github.com/rom-rb/rom/blob/main/changeset/README.md) - Changeset objects integrated with rom-core
+* [repository](https://github.com/rom-rb/rom/blob/main/repository/README.md) - Additional repository abstraction integrated with rom-core
 
 Learn more:
 
-* [Introduction](http://rom-rb.org/learn/introduction)
-* [Quick Start](http://rom-rb.org/learn/repositories/quick-start)
+* [Introduction](https://rom-rb.org/learn/introduction)
+* [Quick Start](https://rom-rb.org/learn/repository/5.2/quick-start/)
 
 ## Backers
 
@@ -104,6 +104,7 @@ Become a sponsor and get your logo on our README on Github with a link to your s
 There are other gems within the rom ecosystem that you will find useful:
 
 * [rom-factory](https://github.com/rom-rb/rom-factory) struct generator with support for persistence
+* (WIP) [rom-migrator](https://github.com/rom-rb/rom-migrator) common APIs for database migrations
 
 ## Adapters
 

data/lib/rom/array_dataset.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "rom/initializer"
+require "rom/enumerable_dataset"
+
+module ROM
+  # A helper module that adds data-proxy behavior to an array-like object
+  #
+  # @see EnumerableDataset
+  #
+  # @api public
+  module ArrayDataset
+    extend DataProxy::ClassMethods
+    include EnumerableDataset
+
+    # Extends the class with data-proxy behavior
+    #
+    # @api private
+    def self.included(klass)
+      klass.class_eval do
+        extend Initializer
+        include DataProxy
+
+        param :data
+      end
+    end
+
+    forward(
+      :*, :+, :-, :compact, :compact!, :flatten, :flatten!, :length, :pop,
+      :reverse, :reverse!, :sample, :size, :shift, :shuffle, :shuffle!,
+      :slice, :slice!, :sort!, :uniq, :uniq!, :unshift, :values_at
+    )
+
+    %i[
+      map! combination cycle delete_if keep_if permutation reject!
+      select! sort_by!
+    ].each do |method|
+      class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def #{method}(*args, &block)
+          return to_enum unless block
+          self.class.new(data.send(:#{method}, *args, &block), **options)
+        end
+      RUBY
+    end
+  end
+end

data/lib/rom/associations/abstract.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+require "dry/core/constants"
+require "dry/core/class_attributes"
+
+require "rom/types"
+require "rom/initializer"
+require "rom/support/memoizable"
+
+module ROM
+  module Associations
+    # Abstract association class
+    #
+    # @api public
+    class Abstract
+      extend Initializer
+
+      include Memoizable
+      include Dry::Equalizer(:definition, :source, :target)
+
+      # @!attribute [r] definition
+      #   @return [ROM::Associations::Definition] Association configuration object
+      param :definition
+
+      # @!attribute [r] relations
+      #   @return [ROM::RelationRegistry] Relation registry
+      option :relations, reader: true
+
+      # @!attribute [r] source
+      #   @return [ROM::Relation] The source relation
+      option :source, reader: false, optional: true
+
+      # @!attribute [r] target
+      #   @return [ROM::Relation] The target relation
+      option :target, reader: false, optional: true
+
+      # Create an association object
+      #
+      # @param [Definition] definition The association definition object
+      # @param [RelationRegistry] relations The relation registry
+      #
+      # @api public
+      def self.new(definition, relations)
+        super(definition, relations: relations)
+      end
+
+      # @return [ROM::Relation] The source relation
+      #
+      # @api public
+      def source
+        options[:source] || relations[definition.source.relation]
+      end
+
+      # @return [ROM::Relation] The target relation
+      #
+      # @api public
+      def target
+        options[:target] || relations[definition.target.relation]
+      end
+
+      # Return if an association has an alias
+      #
+      # @return [Boolean]
+      #
+      # @api public
+      def aliased?
+        definition.aliased?
+      end
+
+      # Return association alias
+      #
+      # @return [Symbol]
+      #
+      # @api public
+      def as
+        definition.as
+      end
+
+      # Return association canonical name
+      #
+      # @return [Symbol]
+      #
+      # @api public
+      def name
+        definition.name
+      end
+
+      # Return the name of a custom relation view that should be use to
+      # extend or override default association view
+      #
+      # @return [Symbol]
+      #
+      # @api public
+      def view
+        definition.view
+      end
+
+      # Return association foreign key name
+      #
+      # @return [Symbol]
+      #
+      # @api public
+      def foreign_key
+        definition.foreign_key
+      end
+
+      # Return result type
+      #
+      # This can be either :one or :many
+      #
+      # @return [Symbol]
+      #
+      # @api public
+      def result
+        definition.result
+      end
+
+      # Return if a custom view should override default association view
+      #
+      # @return [Boolean]
+      #
+      # @api public
+      def override?
+        definition.override
+      end
+
+      # Return the name of a key in tuples under which loaded association data are returned
+      #
+      # @return [Symbol]
+      #
+      # @api public
+      def key
+        as || name
+      end
+
+      # Applies custom view to the default association view
+      #
+      # @return [Relation]
+      #
+      # @api protected
+      def apply_view(schema, relation)
+        view_rel = relation.public_send(view)
+        schema.merge(view_rel.schema).uniq(&:key).(view_rel)
+      end
+
+      # Return combine keys hash
+      #
+      # Combine keys are used for merging associated data together, typically these
+      # are the same as fk<=>pk mapping
+      #
+      # @return [Hash<Symbol=>Symbol>]
+      #
+      # @api public
+      def combine_keys
+        definition.combine_keys || {source_key => target_key}
+      end
+
+      # Return names of source PKs and target FKs
+      #
+      # @return [Array<Symbol>]
+      #
+      # @api private
+      def join_key_map
+        join_keys.to_a.flatten(1).map(&:key)
+      end
+
+      # Return target relation configured as a combine node
+      #
+      # @return [Relation]
+      #
+      # @api private
+      def node
+        target.with(
+          name: target.name.as(key),
+          meta: {keys: combine_keys, combine_type: result, combine_name: key}
+        )
+      end
+
+      # Return target relation as a wrap node
+      #
+      # @return [Relation]
+      #
+      # @api private
+      def wrap
+        target.with(
+          name: target.name.as(key),
+          schema: target.schema.wrap,
+          meta: {wrap: true, combine_name: key}
+        )
+      end
+
+      # Prepare association's target relation for composition
+      #
+      # @return [Relation]
+      #
+      # @api private
+      def prepare(target)
+        if override?
+          target.public_send(view)
+        else
+          call(target: target)
+        end
+      end
+
+      # Return if this association's source relation is the same as the target
+      #
+      # @return [Boolean]
+      #
+      # @api private
+      def self_ref?
+        source.name.dataset == target.name.dataset
+      end
+
+      memoize :combine_keys, :join_key_map
+    end
+  end
+end

data/lib/rom/associations/definitions/abstract.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+require "dry/core/class_attributes"
+
+require "rom/constants"
+require "rom/types"
+require "rom/initializer"
+require "rom/relation/name"
+require "rom/associations/through_identifier"
+require "rom/support/inflector"
+
+module ROM
+  module Associations
+    module Definitions
+      # Abstract association definition object
+      #
+      # @api public
+      class Abstract
+        include Dry::Equalizer(:source, :target, :result)
+        extend Initializer
+        extend Dry::Core::ClassAttributes
+
+        defines :result
+
+        # @!attribute [r] source
+        #   @return [Relation::Name] the source relation name
+        param :source
+
+        # @!attribute [r] target
+        #   @return [Relation::Name] the target relation name
+        param :target
+
+        # @!attribute [r] name
+        #   @return [Symbol] The name of an association
+        option :name, Types::Strict::Symbol, default: -> { target.to_sym }
+
+        # @!attribute [r] relation
+        #   @return [Symbol] an optional relation identifier for the target
+        option :relation, Types::Strict::Symbol, default: -> { name }
+
+        # @!attribute [r] alias
+        #   @return [Symbol] An optional association alias
+        option :as, Types::Strict::Symbol.optional, optional: true
+
+        # @!attribute [r] foreign_key
+        #   @return [Symbol] an optional association alias name
+        option :foreign_key, Types::Optional::Strict::Symbol, optional: true
+
+        # @!attribute [r] result
+        #   @return [Symbol] either :one or :many
+        option :result, Types::Strict::Symbol, default: -> { self.class.result }
+
+        # @!attribute [r] view
+        #   @return [Symbol] An optional view that should be used to extend assoc relation
+        option :view, optional: true
+
+        # @!attribute [r] override
+        #   @return [TrueClass,FalseClass] Whether custom view should override default one or not
+        option :override, default: -> { false }
+
+        # @!attribute [r] combine_keys
+        #   @return [Hash<Symbol=>Symbol>] Override inferred combine keys
+        option :combine_keys, optional: true
+
+        # Instantiate a new association definition
+        #
+        # @param [Symbol] source The name of the source dataset
+        # @param [Symbol] target The name of the target dataset
+        # @param [Hash] opts The option hash
+        # @option opts [Symbol] :as The name of the association (defaults to target)
+        # @option opts [Symbol] :relation The name of the target relation (defaults to target)
+        # @option opts [Symbol] :foreign_key The name of a custom foreign key
+        # @option opts [Symbol] :view The name of a custom relation view on the target's relation side
+        # @option opts [TrueClass,FalseClass] :override Whether provided :view should override association's default view
+        #
+        # @api public
+        def self.new(source, target, **opts)
+          source_name = Relation::Name[source]
+          target_name = resolve_target_name(target, opts)
+          options = process_options(target_name, opts.to_h)
+
+          super(source_name, target_name, **options)
+        end
+
+        # @api private
+        def self.resolve_target_name(target, options)
+          dataset = target
+          relation = options.fetch(:relation, target)
+
+          Relation::Name[relation, dataset, options[:as]]
+        end
+
+        # @api private
+        def self.process_options(target, options)
+          through = options[:through]
+
+          if through
+            options[:through] = ThroughIdentifier[
+              through,
+              target.relation,
+              options[:assoc],
+              inflector: options.fetch(:inflector, Inflector)
+            ]
+          end
+
+          options[:name] = target.relation
+
+          options
+        end
+
+        # @api public
+        def id
+          aliased? ? as : name
+        end
+
+        # @api public
+        def to_h
+          {id: id, **options}
+        end
+
+        # Return true if association's default relation view should be overridden by a custom one
+        #
+        # @return [Boolean]
+        #
+        # @api public
+        def override?
+          options[:override].equal?(true)
+        end
+
+        # Return true if association is aliased
+        #
+        # @return [Boolean]
+        #
+        # @api public
+        def aliased?
+          !options[:as].nil?
+        end
+
+        # Return association class for a given definition object
+        #
+        # @return [Class]
+        #
+        # @api public
+        def type
+          Inflector.demodulize(self.class.name).to_sym
+        end
+      end
+    end
+  end
+end

data/lib/rom/associations/definitions/many_to_many.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "rom/types"
+require "rom/associations/definitions/abstract"
+
+module ROM
+  module Associations
+    module Definitions
+      # @api private
+      class ManyToMany < Abstract
+        result :many
+
+        # @!attribute [r] through
+        #   @return [ThroughIdentifier] The name of the "through" relation
+        option :through, reader: true
+
+        # @api private
+        def through_relation
+          through.relation
+        end
+
+        # @api private
+        def through_assoc_name
+          through.assoc_name
+        end
+      end
+    end
+  end
+end

data/lib/rom/associations/definitions/many_to_one.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "rom/associations/definitions/abstract"
+
+module ROM
+  module Associations
+    module Definitions
+      # @api private
+      class ManyToOne < Abstract
+        result :one
+      end
+    end
+  end
+end