paper_trail_diff 0.3.0 → 0.3.1

data/lib/paper_trail_diff/activity_relationship.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module PaperTrailDiff
+  # Reads event-side foreign keys and matches them to an immutable snapshot owner.
+  class ActivityRelationship
+    #: (untyped, untyped, RecordSnapshot, ?state: Symbol) -> bool
+    def member_of_owner?(record, reflection, owner, state: :after)
+      actual = relationship_owner_values(record, reflection, state: state)
+      expected_ids = Array(owner.id)
+      # @type var expected_ids: Array[untyped]
+      expected = expected_ids.map { |id| id.to_s } # rubocop:disable Style/SymbolProc
+      return false unless actual == expected
+      return true unless reflection.options[:as]
+
+      type = event_attribute(record, reflection.type, state: state).to_s
+      owner_types(reflection, owner).include?(type)
+    end
+
+    #: (untyped, untyped, state: Symbol) -> untyped
+    def owner_id(record, reflection, state:)
+      values = Array(reflection.foreign_key).map do |foreign_key|
+        event_attribute(record, foreign_key, state: state)
+      end
+      values.one? ? values.first : values
+    end
+
+    private
+
+    #: (untyped, untyped, state: Symbol) -> Array[String]
+    def relationship_owner_values(record, reflection, state:)
+      Array(reflection.foreign_key).map do |key|
+        event_attribute(record, key, state: state).to_s
+      end
+    end
+
+    #: (untyped, untyped, state: Symbol) -> untyped
+    def event_attribute(record, name, state:)
+      if record.is_a?(ActivitySnapshotDelta)
+        return state == :before ? record.before_value(name) : record.after_value(name)
+      end
+
+      record.public_send(name)
+    end
+
+    #: (untyped, RecordSnapshot) -> Array[String]
+    def owner_types(reflection, owner)
+      [
+        owner.type.to_s,
+        reflection.active_record.name.to_s,
+        reflection.active_record.base_class.name.to_s
+      ]
+    end
+  end
+end

data/lib/paper_trail_diff/branch_snapshot_refresher.rb

@@ -159,6 +159,8 @@ module PaperTrailDiff
 
     #: (Array[String]) -> [AssociationTree, SnapshotNormalizer]
     def components(branches)
+      return @components[branches] if @components.key?(branches)
+
       key = branches.sort.freeze
       @components[key] ||= build_components(key)
     end

data/lib/paper_trail_diff/version.rb

@@ -2,5 +2,5 @@
 # rbs_inline: enabled
 
 module PaperTrailDiff
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

data/lib/paper_trail_diff.rb

@@ -40,6 +40,15 @@ require_relative 'paper_trail_diff/comparison_batch'
 require_relative 'paper_trail_diff/snapshot_normalizer'
 require_relative 'paper_trail_diff/historical_snapshot_store'
 require_relative 'paper_trail_diff/timeline_snapshot_provider'
+require_relative 'paper_trail_diff/activity_event_record_resolver'
+require_relative 'paper_trail_diff/activity_event_route_finder'
+require_relative 'paper_trail_diff/activity_relationship'
+require_relative 'paper_trail_diff/activity_collection_route_change'
+require_relative 'paper_trail_diff/activity_collection_record_updater'
+require_relative 'paper_trail_diff/activity_collection_route_updater'
+require_relative 'paper_trail_diff/activity_event_record_normalizer'
+require_relative 'paper_trail_diff/activity_collection_event_applier'
+require_relative 'paper_trail_diff/activity_belongs_to_event_applier'
 require_relative 'paper_trail_diff/activity_event_snapshot_refresher'
 require_relative 'paper_trail_diff/activity_root_snapshot_refresher'
 require_relative 'paper_trail_diff/branch_snapshot_refresher'

data/sig/generated/paper_trail_diff/activity_belongs_to_event_applier.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/activity_belongs_to_event_applier.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies selected non-polymorphic belongs-to target updates to a snapshot.
+  class ActivityBelongsToEventApplier
+    # : (route_finder: ActivityEventRouteFinder, record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer) -> void
+    def initialize: (route_finder: ActivityEventRouteFinder, record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer) -> void
+
+    # : (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [bool, RecordSnapshot?]
+    def call: (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [ bool, RecordSnapshot? ]
+
+    private
+
+    @record_normalizer: ActivityEventRecordNormalizer
+
+    @record_resolver: ActivityEventRecordResolver
+
+    @route_finder: ActivityEventRouteFinder
+
+    # : (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
+    def normalized_route_record: (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
+
+    # : (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [RecordSnapshot, bool]
+    def replace_route: (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [ RecordSnapshot, bool ]
+
+    # : (Array[RecordSnapshot], Array[untyped], untyped, RecordSnapshot?, Integer) -> [Array[RecordSnapshot], bool]
+    def replacement_records: (Array[RecordSnapshot], Array[untyped], untyped, RecordSnapshot?, Integer) -> [ Array[RecordSnapshot], bool ]
+
+    # : (Array[RecordSnapshot], untyped, RecordSnapshot?) -> [Array[RecordSnapshot], bool]
+    def replace_existing_target: (Array[RecordSnapshot], untyped, RecordSnapshot?) -> [ Array[RecordSnapshot], bool ]
+
+    # : (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+    def replace_association: (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+
+    # : (untyped, RecordSnapshot?) -> String
+    def replacement_type: (untyped, RecordSnapshot?) -> String
+
+    # : (untyped) -> untyped
+    def endpoint_model_class: (untyped) -> untyped
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_event_applier.rbs

@@ -0,0 +1,46 @@
+# Generated from lib/paper_trail_diff/activity_collection_event_applier.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies a safe collection event across every selected route for its record type.
+  class ActivityCollectionEventApplier
+    # : (record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer, route_updater: ActivityCollectionRouteUpdater, relationship: ActivityRelationship) -> void
+    def initialize: (record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer, route_updater: ActivityCollectionRouteUpdater, relationship: ActivityRelationship) -> void
+
+    # : (Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> bool
+    def safe?: (Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> bool
+
+    # : (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> [bool, RecordSnapshot]
+    def call: (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> [ bool, RecordSnapshot ]
+
+    private
+
+    @record_normalizer: ActivityEventRecordNormalizer
+
+    @record_resolver: ActivityEventRecordResolver
+
+    @relationship: ActivityRelationship
+
+    @route_updater: ActivityCollectionRouteUpdater
+
+    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot
+    def apply_route: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot
+
+    # : (Array[Array[untyped]], untyped) -> bool
+    def unsafe_through_membership_event?: (Array[Array[untyped]], untyped) -> bool
+
+    # : (Array[Array[untyped]], ActivitySnapshotDelta?) -> bool
+    def unsafe_nested_membership_delta?: (Array[Array[untyped]], ActivitySnapshotDelta?) -> bool
+
+    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> [untyped, RecordSnapshot?]
+    def route_event_state: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> [ untyped, RecordSnapshot? ]
+
+    # : (untyped, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot?
+    def normalized_event_record: (untyped, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot?
+
+    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?) -> RecordSnapshot?
+    def existing_delta_record: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?) -> RecordSnapshot?
+
+    # : (RecordSnapshot, Array[untyped], ActivitySnapshotDelta) -> RecordSnapshot?
+    def nested_delta_owner: (RecordSnapshot, Array[untyped], ActivitySnapshotDelta) -> RecordSnapshot?
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_record_updater.rbs

@@ -0,0 +1,25 @@
+# Generated from lib/paper_trail_diff/activity_collection_record_updater.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies one event to the leaf records of a collection association snapshot.
+  class ActivityCollectionRecordUpdater
+    # : (ActivityRelationship) -> void
+    def initialize: (ActivityRelationship) -> void
+
+    # : (AssociationSnapshot, ActivityCollectionRouteChange, untyped, RecordSnapshot) -> RecordSnapshot?
+    def event_child: (AssociationSnapshot, ActivityCollectionRouteChange, untyped, RecordSnapshot) -> RecordSnapshot?
+
+    # : (AssociationSnapshot, untyped, RecordSnapshot?) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]
+    def call: (AssociationSnapshot, untyped, RecordSnapshot?) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]
+
+    # : (untyped, RecordSnapshot?) -> String
+    def replacement_type: (untyped, RecordSnapshot?) -> String
+
+    private
+
+    @relationship: ActivityRelationship
+
+    # : (Array[RecordSnapshot], Integer?, RecordSnapshot?) -> Array[RecordSnapshot]
+    def replacement_records: (Array[RecordSnapshot], Integer?, RecordSnapshot?) -> Array[RecordSnapshot]
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_route_change.rbs

@@ -0,0 +1,17 @@
+# Generated from lib/paper_trail_diff/activity_collection_route_change.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Carries one collection event through recursive immutable route replacement.
+  class ActivityCollectionRouteChange
+    attr_reader route: Array[untyped]
+
+    attr_reader version: untyped
+
+    attr_reader record: untyped
+
+    attr_reader replacement: RecordSnapshot?
+
+    # : (route: Array[untyped], version: untyped, record: untyped, replacement: RecordSnapshot?) -> void
+    def initialize: (route: Array[untyped], version: untyped, record: untyped, replacement: RecordSnapshot?) -> void
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_route_updater.rbs

@@ -0,0 +1,44 @@
+# Generated from lib/paper_trail_diff/activity_collection_route_updater.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Replaces a collection event record along one explicit immutable snapshot route.
+  class ActivityCollectionRouteUpdater
+    # : (pool: SnapshotPool, relationship: ActivityRelationship) -> void
+    def initialize: (pool: SnapshotPool, relationship: ActivityRelationship) -> void
+
+    # : (RecordSnapshot, ActivityCollectionRouteChange, ?depth: Integer) -> [RecordSnapshot, bool]
+    def call: (RecordSnapshot, ActivityCollectionRouteChange, ?depth: Integer) -> [ RecordSnapshot, bool ]
+
+    private
+
+    @pool: SnapshotPool
+
+    @record_updater: ActivityCollectionRecordUpdater
+
+    @relationship: ActivityRelationship
+
+    # : (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool]
+    def updated_records: (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool ]
+
+    # : (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool]
+    def leaf_records: (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool ]
+
+    # : (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]?
+    def targeted_parent: (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]?
+
+    # : (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool]
+    def recursive_records: (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool ]
+
+    # : ([RecordSnapshot?, RecordSnapshot?, bool], RecordSnapshot, RecordSnapshot, bool) -> [RecordSnapshot?, RecordSnapshot?, bool]
+    def recursive_transition: ([ RecordSnapshot?, RecordSnapshot?, bool ], RecordSnapshot, RecordSnapshot, bool) -> [ RecordSnapshot?, RecordSnapshot?, bool ]
+
+    # : (Array[RecordSnapshot], Integer, RecordSnapshot, RecordSnapshot, bool) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]
+    def targeted_parent_replacement: (Array[RecordSnapshot], Integer, RecordSnapshot, RecordSnapshot, bool) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]
+
+    # : (AssociationSnapshot, untyped, ActivityCollectionRouteChange) -> Integer?
+    def nested_owner_position: (AssociationSnapshot, untyped, ActivityCollectionRouteChange) -> Integer?
+
+    # : (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+    def replace_association: (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_record_normalizer.rbs

@@ -0,0 +1,19 @@
+# Generated from lib/paper_trail_diff/activity_event_record_normalizer.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Normalizes one event record with the historical reader for its boundary.
+  class ActivityEventRecordNormalizer
+    # : (?association_reader: untyped) -> void
+    def initialize: (?association_reader: untyped) -> void
+
+    # : (untyped, reflection: untyped, subtree: AssociationTree, path: String, normalizer: SnapshotNormalizer, root_endpoint: untyped, context_endpoint: untyped) -> RecordSnapshot?
+    def call: (untyped, reflection: untyped, subtree: AssociationTree, path: String, normalizer: SnapshotNormalizer, root_endpoint: untyped, context_endpoint: untyped) -> RecordSnapshot?
+
+    private
+
+    @association_reader: untyped
+
+    # : (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
+    def historical_reader: (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_record_resolver.rbs

@@ -0,0 +1,44 @@
+# Generated from lib/paper_trail_diff/activity_event_record_resolver.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Reconstructs an event's post-change record or immutable scalar delta.
+  class ActivityEventRecordResolver
+    RECORD_AFTER_HANDLERS: untyped
+
+    # : (?record_transition: untyped) -> void
+    def initialize: (?record_transition: untyped) -> void
+
+    # : (untyped) -> untyped
+    def record_after: (untyped) -> untyped
+
+    # : (untyped) -> ActivitySnapshotDelta?
+    def snapshot_delta: (untyped) -> ActivitySnapshotDelta?
+
+    # : (untyped) -> untyped
+    def changed_record_after: (untyped) -> untyped
+
+    # : (untyped) -> untyped
+    def created_record_after: (untyped) -> untyped
+
+    # : (untyped) -> untyped
+    def updated_record_after: (untyped) -> untyped
+
+    # Mirrors PaperTrail's changeset deserialization without resolving
+    # +version.item+, which would issue one live-record query per event.
+    # : (untyped, untyped) -> untyped
+    def deserialized_changeset: (untyped, untyped) -> untyped
+
+    private
+
+    @record_transition: untyped
+
+    # : (untyped, untyped) -> Hash[untyped, untyped]
+    def after_attributes: (untyped, untyped) -> Hash[untyped, untyped]
+
+    # : (untyped, untyped) -> untyped
+    def apply_changes: (untyped, untyped) -> untyped
+
+    # : (untyped, untyped, untyped) -> untyped
+    def standard_changeset: (untyped, untyped, untyped) -> untyped
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_route_finder.rbs

@@ -0,0 +1,54 @@
+# Generated from lib/paper_trail_diff/activity_event_route_finder.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Finds explicitly selected collection and belongs-to routes for one event type.
+  class ActivityEventRouteFinder
+    # : (AssociationTraversal) -> void
+    def initialize: (AssociationTraversal) -> void
+
+    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    def collection_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+
+    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    def belongs_to_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+
+    private
+
+    @belongs_to_model: untyped
+
+    @belongs_to_path: String?
+
+    @belongs_to_routes: Array[Array[untyped]]?
+
+    @belongs_to_tree: AssociationTree?
+
+    @belongs_to_type: String?
+
+    @collection_model: untyped
+
+    @collection_path: String?
+
+    @collection_routes: Array[Array[untyped]]?
+
+    @collection_tree: AssociationTree?
+
+    @collection_type: String?
+
+    @traversal: AssociationTraversal
+
+    # : (Array[Array[untyped]]) -> Array[Array[untyped]]
+    def freeze_routes: (Array[Array[untyped]]) -> Array[Array[untyped]]
+
+    # : (untyped, AssociationTree, String, Symbol, path: String) -> Array[Array[untyped]]
+    def routes: (untyped, AssociationTree, String, Symbol, path: String) -> Array[Array[untyped]]
+
+    # : (untyped, AssociationTree, String, Symbol, String) -> Array[Array[untyped]]
+    def routes_for_reflection: (untyped, AssociationTree, String, Symbol, String) -> Array[Array[untyped]]
+
+    # : (untyped, String, Symbol) -> bool
+    def direct_route?: (untyped, String, Symbol) -> bool
+
+    # : (untyped, Symbol) -> bool
+    def supported_direct_reflection?: (untyped, Symbol) -> bool
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_snapshot_refresher.rbs

@@ -1,138 +1,46 @@
 # Generated from lib/paper_trail_diff/activity_event_snapshot_refresher.rb with RBS::Inline
 
 module PaperTrailDiff
-  # Applies safe descendant event deltas without rebuilding an entire selected branch.
-  # rubocop:disable Metrics/ClassLength
+  # Dispatches safe descendant events to focused immutable snapshot appliers.
   class ActivityEventSnapshotRefresher
-    RECORD_AFTER_HANDLERS: untyped
-
     # : (traversal: AssociationTraversal, pool: SnapshotPool, components: untyped, ?association_reader: untyped, ?record_transition: untyped) -> void
     def initialize: (traversal: AssociationTraversal, pool: SnapshotPool, components: untyped, ?association_reader: untyped, ?record_transition: untyped) -> void
 
-    # : (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [bool, RecordSnapshot?]
-    def call: (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [ bool, RecordSnapshot? ]
-
-    private
-
-    @association_reader: untyped
-
-    @components: untyped
-
-    @pool: SnapshotPool
-
-    @record_transition: untyped
-
-    @traversal: AssociationTraversal
+    # : (SnapshotPool, untyped) -> void
+    def configure_appliers: (SnapshotPool, untyped) -> void
 
-    # : (Array[Array[untyped]], untyped) -> bool
-    def unsafe_through_membership_event?: (Array[Array[untyped]], untyped) -> bool
+    # : (SnapshotPool) -> ActivityCollectionRouteUpdater
+    def collection_updater: (SnapshotPool) -> ActivityCollectionRouteUpdater
 
-    # : (Array[Array[untyped]], ActivitySnapshotDelta?) -> bool
-    def unsafe_nested_membership_delta?: (Array[Array[untyped]], ActivitySnapshotDelta?) -> bool
+    # : (ActivityEventRecordNormalizer, ActivityCollectionRouteUpdater) -> ActivityCollectionEventApplier
+    def collection_applier: (ActivityEventRecordNormalizer, ActivityCollectionRouteUpdater) -> ActivityCollectionEventApplier
 
-    # : (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> [bool, RecordSnapshot]
-    def collection_target_snapshot: (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> [ bool, RecordSnapshot ]
+    # : (ActivityEventRecordNormalizer) -> ActivityBelongsToEventApplier
+    def belongs_to_applier: (ActivityEventRecordNormalizer) -> ActivityBelongsToEventApplier
 
-    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, untyped, untyped) -> [untyped, RecordSnapshot?]
-    def collection_route_event_state: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, untyped, untyped) -> [ untyped, RecordSnapshot? ]
-
-    # : (untyped, Array[untyped], SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-    def normalized_collection_event_record: (untyped, Array[untyped], SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-
-    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?) -> RecordSnapshot?
-    def existing_delta_record: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?) -> RecordSnapshot?
-
-    # : (RecordSnapshot, Array[untyped], ActivitySnapshotDelta) -> RecordSnapshot?
-    def nested_delta_owner: (RecordSnapshot, Array[untyped], ActivitySnapshotDelta) -> RecordSnapshot?
-
-    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
-    def direct_collection_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
-
-    # : (RecordSnapshot, Array[untyped], untyped, untyped, RecordSnapshot?, ?depth: Integer) -> [RecordSnapshot, bool]
-    def replace_collection_route: (RecordSnapshot, Array[untyped], untyped, untyped, RecordSnapshot?, ?depth: Integer) -> [ RecordSnapshot, bool ]
-
-    # : (AssociationSnapshot, untyped, untyped, untyped, RecordSnapshot, RecordSnapshot?) -> RecordSnapshot?
-    def collection_event_child: (AssociationSnapshot, untyped, untyped, untyped, RecordSnapshot, RecordSnapshot?) -> RecordSnapshot?
-
-    # : (AssociationSnapshot, Array[untyped], untyped, untyped, RecordSnapshot?, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]?
-    def replace_targeted_collection_parent: (AssociationSnapshot, Array[untyped], untyped, untyped, RecordSnapshot?, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]?
+    # : (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [bool, RecordSnapshot?]
+    def call: (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [ bool, RecordSnapshot? ]
 
-    # : (Array[RecordSnapshot], Integer, RecordSnapshot, RecordSnapshot, bool) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]
-    def targeted_parent_replacement: (Array[RecordSnapshot], Integer, RecordSnapshot, RecordSnapshot, bool) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]
+    private
 
-    # : (AssociationSnapshot, untyped, untyped, untyped) -> Integer?
-    def nested_owner_position: (AssociationSnapshot, untyped, untyped, untyped) -> Integer?
+    @belongs_to_applier: ActivityBelongsToEventApplier
 
-    # : (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [bool, RecordSnapshot?]
-    def belongs_to_target_snapshot: (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [ bool, RecordSnapshot? ]
+    @collection_applier: ActivityCollectionEventApplier
 
-    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
-    def belongs_to_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    @components: untyped
 
-    # : (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-    def normalized_route_record: (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
+    @record_resolver: ActivityEventRecordResolver
 
-    # : (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [RecordSnapshot, bool]
-    def replace_route: (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [ RecordSnapshot, bool ]
+    @relationship: ActivityRelationship
 
-    # : (Array[RecordSnapshot], untyped, RecordSnapshot?) -> Array[RecordSnapshot]
-    def replace_existing_target: (Array[RecordSnapshot], untyped, RecordSnapshot?) -> Array[RecordSnapshot]
+    @route_finder: ActivityEventRouteFinder
 
     # : (untyped) -> untyped
     def record_after: (untyped) -> untyped
 
-    # PaperTrail create/update versions contain deserialized change pairs, so
-    # their post-event records need no successor query.
-    # : (untyped) -> untyped
-    def changed_record_after: (untyped) -> untyped
-
-    # : (untyped) -> untyped
-    def created_record_after: (untyped) -> untyped
-
-    # : (untyped) -> untyped
-    def updated_record_after: (untyped) -> untyped
-
-    # : (untyped, untyped) -> Hash[untyped, untyped]
-    def after_attributes: (untyped, untyped) -> Hash[untyped, untyped]
-
-    # : (untyped, untyped) -> untyped
-    def apply_changes: (untyped, untyped) -> untyped
-
-    # Mirrors PaperTrail's changeset deserialization without resolving
-    # +version.item+, which would issue one live-record query per event.
     # : (untyped, untyped) -> untyped
     def deserialized_changeset: (untyped, untyped) -> untyped
 
-    # : (untyped, untyped, untyped) -> untyped
-    def standard_changeset: (untyped, untyped, untyped) -> untyped
-
-    # : (untyped) -> ActivitySnapshotDelta?
-    def activity_snapshot_delta: (untyped) -> ActivitySnapshotDelta?
-
-    # : (untyped, untyped, RecordSnapshot, ?state: Symbol) -> bool
-    def member_of_owner?: (untyped, untyped, RecordSnapshot, ?state: Symbol) -> bool
-
-    # : (untyped, untyped, state: Symbol) -> untyped
-    def event_attribute: (untyped, untyped, state: Symbol) -> untyped
-
-    # : (untyped, untyped, state: Symbol) -> untyped
-    def relationship_owner_id: (untyped, untyped, state: Symbol) -> untyped
-
-    # : (untyped, untyped, AssociationTree, String, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-    def normalize_event_record: (untyped, untyped, AssociationTree, String, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-
-    # : (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
-    def historical_reader: (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
-
-    # : (AssociationSnapshot, untyped, RecordSnapshot?) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]
-    def replace_collection_record: (AssociationSnapshot, untyped, RecordSnapshot?) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]
-
-    # : (Array[RecordSnapshot], Integer?, RecordSnapshot?) -> Array[RecordSnapshot]
-    def replacement_collection_records: (Array[RecordSnapshot], Integer?, RecordSnapshot?) -> Array[RecordSnapshot]
-
-    # : (untyped, RecordSnapshot?) -> String
-    def replacement_type: (untyped, RecordSnapshot?) -> String
-
     # : (untyped) -> untyped
     def endpoint_model_class: (untyped) -> untyped
   end

data/sig/generated/paper_trail_diff/activity_relationship.rbs

@@ -0,0 +1,23 @@
+# Generated from lib/paper_trail_diff/activity_relationship.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Reads event-side foreign keys and matches them to an immutable snapshot owner.
+  class ActivityRelationship
+    # : (untyped, untyped, RecordSnapshot, ?state: Symbol) -> bool
+    def member_of_owner?: (untyped, untyped, RecordSnapshot, ?state: Symbol) -> bool
+
+    # : (untyped, untyped, state: Symbol) -> untyped
+    def owner_id: (untyped, untyped, state: Symbol) -> untyped
+
+    private
+
+    # : (untyped, untyped, state: Symbol) -> Array[String]
+    def relationship_owner_values: (untyped, untyped, state: Symbol) -> Array[String]
+
+    # : (untyped, untyped, state: Symbol) -> untyped
+    def event_attribute: (untyped, untyped, state: Symbol) -> untyped
+
+    # : (untyped, RecordSnapshot) -> Array[String]
+    def owner_types: (untyped, RecordSnapshot) -> Array[String]
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paper_trail_diff
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Alex Williams
@@ -43,12 +43,21 @@ files:
 - QUICKSTART.md
 - README.md
 - lib/paper_trail_diff.rb
+- lib/paper_trail_diff/activity_belongs_to_event_applier.rb
 - lib/paper_trail_diff/activity_boundary.rb
 - lib/paper_trail_diff/activity_child_candidate_loader.rb
+- lib/paper_trail_diff/activity_collection_event_applier.rb
+- lib/paper_trail_diff/activity_collection_record_updater.rb
+- lib/paper_trail_diff/activity_collection_route_change.rb
+- lib/paper_trail_diff/activity_collection_route_updater.rb
 - lib/paper_trail_diff/activity_event.rb
+- lib/paper_trail_diff/activity_event_record_normalizer.rb
+- lib/paper_trail_diff/activity_event_record_resolver.rb
+- lib/paper_trail_diff/activity_event_route_finder.rb
 - lib/paper_trail_diff/activity_event_snapshot_refresher.rb
 - lib/paper_trail_diff/activity_history.rb
 - lib/paper_trail_diff/activity_range.rb
+- lib/paper_trail_diff/activity_relationship.rb
 - lib/paper_trail_diff/activity_root_snapshot_refresher.rb
 - lib/paper_trail_diff/activity_snapshot_delta.rb
 - lib/paper_trail_diff/activity_snapshot_sequence.rb
@@ -101,12 +110,21 @@ files:
 - lib/paper_trail_diff/version_association_candidate_scope.rb
 - lib/paper_trail_diff/version_range.rb
 - sig/generated/paper_trail_diff.rbs
+- sig/generated/paper_trail_diff/activity_belongs_to_event_applier.rbs
 - sig/generated/paper_trail_diff/activity_boundary.rbs
 - sig/generated/paper_trail_diff/activity_child_candidate_loader.rbs
+- sig/generated/paper_trail_diff/activity_collection_event_applier.rbs
+- sig/generated/paper_trail_diff/activity_collection_record_updater.rbs
+- sig/generated/paper_trail_diff/activity_collection_route_change.rbs
+- sig/generated/paper_trail_diff/activity_collection_route_updater.rbs
 - sig/generated/paper_trail_diff/activity_event.rbs
+- sig/generated/paper_trail_diff/activity_event_record_normalizer.rbs
+- sig/generated/paper_trail_diff/activity_event_record_resolver.rbs
+- sig/generated/paper_trail_diff/activity_event_route_finder.rbs
 - sig/generated/paper_trail_diff/activity_event_snapshot_refresher.rbs
 - sig/generated/paper_trail_diff/activity_history.rbs
 - sig/generated/paper_trail_diff/activity_range.rbs
+- sig/generated/paper_trail_diff/activity_relationship.rbs
 - sig/generated/paper_trail_diff/activity_root_snapshot_refresher.rbs
 - sig/generated/paper_trail_diff/activity_snapshot_delta.rbs
 - sig/generated/paper_trail_diff/activity_snapshot_sequence.rbs
@@ -164,11 +182,11 @@ licenses:
 metadata:
   allowed_push_host: https://rubygems.org
   bug_tracker_uri: https://github.com/aheathwilliams/paper_trail_diff/issues
-  changelog_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.3.0/CHANGELOG.md
-  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.3.0/README.md
+  changelog_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.3.1/CHANGELOG.md
+  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.3.1/README.md
   homepage_uri: https://github.com/aheathwilliams/paper_trail_diff
   rubygems_mfa_required: 'true'
-  source_code_uri: https://github.com/aheathwilliams/paper_trail_diff/tree/v0.3.0
+  source_code_uri: https://github.com/aheathwilliams/paper_trail_diff/tree/v0.3.1
 rdoc_options: []
 require_paths:
 - lib