paper_trail_diff 0.16.0 → 0.17.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (206) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +581 -1
  3. data/README.md +42 -7
  4. data/docs/architecture.md +7 -5
  5. data/docs/performance.md +86 -38
  6. data/docs/reference.md +309 -92
  7. data/docs/testing.md +240 -32
  8. data/lib/paper_trail_diff/activity_belongs_to_event_applier.rb +2 -16
  9. data/lib/paper_trail_diff/activity_boundary.rb +55 -34
  10. data/lib/paper_trail_diff/activity_child_candidate_loader.rb +46 -57
  11. data/lib/paper_trail_diff/activity_collection_event_applier.rb +3 -13
  12. data/lib/paper_trail_diff/activity_collection_route_updater.rb +1 -1
  13. data/lib/paper_trail_diff/activity_event.rb +33 -21
  14. data/lib/paper_trail_diff/activity_event_record_resolver.rb +16 -116
  15. data/lib/paper_trail_diff/activity_event_route_finder.rb +29 -29
  16. data/lib/paper_trail_diff/activity_event_snapshot_refresher.rb +2 -7
  17. data/lib/paper_trail_diff/activity_history.rb +90 -49
  18. data/lib/paper_trail_diff/activity_range.rb +9 -35
  19. data/lib/paper_trail_diff/activity_root_snapshot_refresher.rb +74 -40
  20. data/lib/paper_trail_diff/activity_root_steps.rb +10 -13
  21. data/lib/paper_trail_diff/activity_scope_filter.rb +77 -0
  22. data/lib/paper_trail_diff/activity_snapshot_delta.rb +12 -15
  23. data/lib/paper_trail_diff/activity_snapshot_sequence.rb +37 -15
  24. data/lib/paper_trail_diff/activity_target_candidate_loader.rb +35 -43
  25. data/lib/paper_trail_diff/activity_timeline_builder.rb +194 -249
  26. data/lib/paper_trail_diff/activity_transaction_grouper.rb +3 -1
  27. data/lib/paper_trail_diff/activity_tree_filter.rb +54 -13
  28. data/lib/paper_trail_diff/activity_version_collector.rb +72 -138
  29. data/lib/paper_trail_diff/activity_view.rb +22 -11
  30. data/lib/paper_trail_diff/analysis.rb +19 -5
  31. data/lib/paper_trail_diff/analysis_batch.rb +16 -58
  32. data/lib/paper_trail_diff/approximate_paths.rb +4 -8
  33. data/lib/paper_trail_diff/association_activity_edge.rb +5 -24
  34. data/lib/paper_trail_diff/association_activity_selection.rb +10 -18
  35. data/lib/paper_trail_diff/association_discovery.rb +1 -6
  36. data/lib/paper_trail_diff/association_key.rb +9 -6
  37. data/lib/paper_trail_diff/association_traversal.rb +49 -6
  38. data/lib/paper_trail_diff/batch_boundary_resolver.rb +33 -42
  39. data/lib/paper_trail_diff/batch_preload.rb +2 -12
  40. data/lib/paper_trail_diff/batched_root_analyses.rb +72 -0
  41. data/lib/paper_trail_diff/batched_root_analyzer.rb +16 -14
  42. data/lib/paper_trail_diff/batched_root_versions.rb +25 -20
  43. data/lib/paper_trail_diff/branch_snapshot_refresher.rb +27 -31
  44. data/lib/paper_trail_diff/change_attribution.rb +329 -0
  45. data/lib/paper_trail_diff/change_row.rb +30 -10
  46. data/lib/paper_trail_diff/comparison_batch.rb +3 -4
  47. data/lib/paper_trail_diff/configuration.rb +1 -1
  48. data/lib/paper_trail_diff/deleted_analysis_batch.rb +22 -37
  49. data/lib/paper_trail_diff/deleted_root_filter.rb +3 -6
  50. data/lib/paper_trail_diff/deprecation.rb +4 -43
  51. data/lib/paper_trail_diff/diagnostics.rb +1 -2
  52. data/lib/paper_trail_diff/direct_record_state_loader.rb +8 -1
  53. data/lib/paper_trail_diff/endpoint.rb +78 -44
  54. data/lib/paper_trail_diff/errors.rb +2 -9
  55. data/lib/paper_trail_diff/fallback_paths.rb +2 -5
  56. data/lib/paper_trail_diff/habtm_transaction_owners.rb +5 -3
  57. data/lib/paper_trail_diff/historical_association_reifier.rb +3 -1
  58. data/lib/paper_trail_diff/historical_filter.rb +40 -15
  59. data/lib/paper_trail_diff/historical_snapshot_store.rb +80 -38
  60. data/lib/paper_trail_diff/instrumentation.rb +0 -8
  61. data/lib/paper_trail_diff/live_endpoint_batch_loader.rb +11 -7
  62. data/lib/paper_trail_diff/live_endpoint_provider.rb +7 -23
  63. data/lib/paper_trail_diff/live_graph_collector.rb +3 -3
  64. data/lib/paper_trail_diff/nested_comparator.rb +46 -19
  65. data/lib/paper_trail_diff/net_change.rb +276 -0
  66. data/lib/paper_trail_diff/own_window.rb +35 -0
  67. data/lib/paper_trail_diff/paper_trail_adapter.rb +40 -45
  68. data/lib/paper_trail_diff/prepared_activity_index.rb +197 -45
  69. data/lib/paper_trail_diff/prepared_child_candidates.rb +58 -0
  70. data/lib/paper_trail_diff/prepared_edge_loader.rb +43 -107
  71. data/lib/paper_trail_diff/prepared_history.rb +20 -31
  72. data/lib/paper_trail_diff/prepared_history_loader.rb +46 -9
  73. data/lib/paper_trail_diff/prepared_record_index.rb +137 -47
  74. data/lib/paper_trail_diff/prepared_snapshot_builder.rb +16 -0
  75. data/lib/paper_trail_diff/prepared_state_association_reader.rb +17 -19
  76. data/lib/paper_trail_diff/read_snapshot.rb +41 -19
  77. data/lib/paper_trail_diff/recorded_changes.rb +10 -11
  78. data/lib/paper_trail_diff/recorded_changes_reader.rb +60 -0
  79. data/lib/paper_trail_diff/recorded_class.rb +14 -19
  80. data/lib/paper_trail_diff/recorded_columns.rb +33 -0
  81. data/lib/paper_trail_diff/root_version_plan.rb +20 -22
  82. data/lib/paper_trail_diff/root_version_selection.rb +39 -29
  83. data/lib/paper_trail_diff/scope_condition.rb +7 -17
  84. data/lib/paper_trail_diff/scope_ranking.rb +16 -22
  85. data/lib/paper_trail_diff/scoped_analysis.rb +27 -4
  86. data/lib/paper_trail_diff/scoped_analysis_builder.rb +4 -3
  87. data/lib/paper_trail_diff/scoped_root_selection.rb +60 -41
  88. data/lib/paper_trail_diff/snapshot_normalizer.rb +18 -3
  89. data/lib/paper_trail_diff/stored_json_values.rb +52 -0
  90. data/lib/paper_trail_diff/stored_time_precision.rb +30 -18
  91. data/lib/paper_trail_diff/stored_values.rb +20 -0
  92. data/lib/paper_trail_diff/support.rb +185 -35
  93. data/lib/paper_trail_diff/time_of_day.rb +39 -0
  94. data/lib/paper_trail_diff/time_range.rb +37 -20
  95. data/lib/paper_trail_diff/time_version_range.rb +5 -10
  96. data/lib/paper_trail_diff/timeline_builder.rb +3 -3
  97. data/lib/paper_trail_diff/timeline_range.rb +18 -12
  98. data/lib/paper_trail_diff/timeline_snapshot_provider.rb +1 -1
  99. data/lib/paper_trail_diff/total_order.rb +55 -0
  100. data/lib/paper_trail_diff/transaction_cut.rb +192 -91
  101. data/lib/paper_trail_diff/traversal_preparer.rb +5 -8
  102. data/lib/paper_trail_diff/value_objects.rb +8 -4
  103. data/lib/paper_trail_diff/version.rb +1 -1
  104. data/lib/paper_trail_diff/version_association_candidate_scope.rb +27 -16
  105. data/lib/paper_trail_diff/version_boundary.rb +37 -21
  106. data/lib/paper_trail_diff/version_query.rb +25 -25
  107. data/lib/paper_trail_diff/version_range.rb +12 -16
  108. data/lib/paper_trail_diff/version_sequence_diagnostics.rb +32 -0
  109. data/lib/paper_trail_diff/version_table.rb +12 -8
  110. data/lib/paper_trail_diff.rb +28 -42
  111. data/sig/generated/paper_trail_diff/activity_belongs_to_event_applier.rbs +0 -8
  112. data/sig/generated/paper_trail_diff/activity_boundary.rbs +39 -17
  113. data/sig/generated/paper_trail_diff/activity_child_candidate_loader.rbs +19 -22
  114. data/sig/generated/paper_trail_diff/activity_collection_event_applier.rbs +0 -5
  115. data/sig/generated/paper_trail_diff/activity_event.rbs +25 -9
  116. data/sig/generated/paper_trail_diff/activity_event_record_resolver.rbs +6 -34
  117. data/sig/generated/paper_trail_diff/activity_event_route_finder.rbs +11 -4
  118. data/sig/generated/paper_trail_diff/activity_event_snapshot_refresher.rbs +0 -3
  119. data/sig/generated/paper_trail_diff/activity_history.rbs +54 -19
  120. data/sig/generated/paper_trail_diff/activity_range.rbs +6 -20
  121. data/sig/generated/paper_trail_diff/activity_root_snapshot_refresher.rbs +36 -2
  122. data/sig/generated/paper_trail_diff/activity_root_steps.rbs +6 -6
  123. data/sig/generated/paper_trail_diff/activity_scope_filter.rbs +51 -0
  124. data/sig/generated/paper_trail_diff/activity_snapshot_delta.rbs +5 -3
  125. data/sig/generated/paper_trail_diff/activity_snapshot_sequence.rbs +21 -3
  126. data/sig/generated/paper_trail_diff/activity_target_candidate_loader.rbs +19 -24
  127. data/sig/generated/paper_trail_diff/activity_timeline_builder.rbs +121 -127
  128. data/sig/generated/paper_trail_diff/activity_tree_filter.rbs +41 -8
  129. data/sig/generated/paper_trail_diff/activity_version_collector.rbs +42 -35
  130. data/sig/generated/paper_trail_diff/activity_view.rbs +16 -8
  131. data/sig/generated/paper_trail_diff/analysis.rbs +15 -6
  132. data/sig/generated/paper_trail_diff/analysis_batch.rbs +6 -24
  133. data/sig/generated/paper_trail_diff/association_activity_edge.rbs +0 -13
  134. data/sig/generated/paper_trail_diff/association_activity_selection.rbs +6 -9
  135. data/sig/generated/paper_trail_diff/association_discovery.rbs +0 -3
  136. data/sig/generated/paper_trail_diff/association_key.rbs +5 -0
  137. data/sig/generated/paper_trail_diff/association_traversal.rbs +26 -2
  138. data/sig/generated/paper_trail_diff/batch_boundary_resolver.rbs +17 -17
  139. data/sig/generated/paper_trail_diff/batch_preload.rbs +0 -4
  140. data/sig/generated/paper_trail_diff/batched_root_analyses.rbs +47 -0
  141. data/sig/generated/paper_trail_diff/batched_root_analyzer.rbs +9 -8
  142. data/sig/generated/paper_trail_diff/batched_root_versions.rbs +10 -6
  143. data/sig/generated/paper_trail_diff/branch_snapshot_refresher.rbs +11 -5
  144. data/sig/generated/paper_trail_diff/change_attribution.rbs +194 -0
  145. data/sig/generated/paper_trail_diff/change_row.rbs +22 -7
  146. data/sig/generated/paper_trail_diff/deleted_analysis_batch.rbs +11 -12
  147. data/sig/generated/paper_trail_diff/deleted_root_filter.rbs +0 -2
  148. data/sig/generated/paper_trail_diff/deprecation.rbs +4 -24
  149. data/sig/generated/paper_trail_diff/direct_record_state_loader.rbs +4 -0
  150. data/sig/generated/paper_trail_diff/endpoint.rbs +40 -16
  151. data/sig/generated/paper_trail_diff/errors.rbs +2 -11
  152. data/sig/generated/paper_trail_diff/habtm_transaction_owners.rbs +2 -1
  153. data/sig/generated/paper_trail_diff/historical_filter.rbs +20 -9
  154. data/sig/generated/paper_trail_diff/historical_snapshot_store.rbs +40 -10
  155. data/sig/generated/paper_trail_diff/instrumentation.rbs +0 -3
  156. data/sig/generated/paper_trail_diff/live_endpoint_batch_loader.rbs +3 -0
  157. data/sig/generated/paper_trail_diff/live_endpoint_provider.rbs +5 -8
  158. data/sig/generated/paper_trail_diff/live_graph_collector.rbs +2 -2
  159. data/sig/generated/paper_trail_diff/nested_comparator.rbs +20 -4
  160. data/sig/generated/paper_trail_diff/net_change.rbs +168 -0
  161. data/sig/generated/paper_trail_diff/own_window.rbs +22 -0
  162. data/sig/generated/paper_trail_diff/paper_trail_adapter.rbs +9 -6
  163. data/sig/generated/paper_trail_diff/prepared_activity_index.rbs +114 -14
  164. data/sig/generated/paper_trail_diff/prepared_child_candidates.rbs +39 -0
  165. data/sig/generated/paper_trail_diff/prepared_edge_loader.rbs +18 -35
  166. data/sig/generated/paper_trail_diff/prepared_history.rbs +9 -12
  167. data/sig/generated/paper_trail_diff/prepared_history_loader.rbs +28 -3
  168. data/sig/generated/paper_trail_diff/prepared_record_index.rbs +68 -14
  169. data/sig/generated/paper_trail_diff/prepared_snapshot_builder.rbs +12 -0
  170. data/sig/generated/paper_trail_diff/prepared_state_association_reader.rbs +6 -7
  171. data/sig/generated/paper_trail_diff/read_snapshot.rbs +27 -8
  172. data/sig/generated/paper_trail_diff/recorded_changes.rbs +4 -2
  173. data/sig/generated/paper_trail_diff/recorded_changes_reader.rbs +41 -0
  174. data/sig/generated/paper_trail_diff/recorded_class.rbs +7 -6
  175. data/sig/generated/paper_trail_diff/recorded_columns.rbs +21 -0
  176. data/sig/generated/paper_trail_diff/root_version_plan.rbs +8 -4
  177. data/sig/generated/paper_trail_diff/root_version_selection.rbs +27 -13
  178. data/sig/generated/paper_trail_diff/scope_condition.rbs +0 -2
  179. data/sig/generated/paper_trail_diff/scope_ranking.rbs +10 -10
  180. data/sig/generated/paper_trail_diff/scoped_analysis.rbs +19 -0
  181. data/sig/generated/paper_trail_diff/scoped_analysis_builder.rbs +2 -2
  182. data/sig/generated/paper_trail_diff/scoped_root_selection.rbs +37 -14
  183. data/sig/generated/paper_trail_diff/snapshot_normalizer.rbs +7 -0
  184. data/sig/generated/paper_trail_diff/stored_json_values.rbs +35 -0
  185. data/sig/generated/paper_trail_diff/stored_time_precision.rbs +19 -5
  186. data/sig/generated/paper_trail_diff/stored_values.rbs +13 -0
  187. data/sig/generated/paper_trail_diff/support.rbs +120 -23
  188. data/sig/generated/paper_trail_diff/time_of_day.rbs +21 -0
  189. data/sig/generated/paper_trail_diff/time_range.rbs +15 -8
  190. data/sig/generated/paper_trail_diff/time_version_range.rbs +2 -5
  191. data/sig/generated/paper_trail_diff/timeline_builder.rbs +2 -2
  192. data/sig/generated/paper_trail_diff/timeline_range.rbs +12 -7
  193. data/sig/generated/paper_trail_diff/total_order.rbs +32 -0
  194. data/sig/generated/paper_trail_diff/transaction_cut.rbs +111 -52
  195. data/sig/generated/paper_trail_diff/traversal_preparer.rbs +2 -2
  196. data/sig/generated/paper_trail_diff/value_objects.rbs +5 -1
  197. data/sig/generated/paper_trail_diff/version_association_candidate_scope.rbs +10 -9
  198. data/sig/generated/paper_trail_diff/version_boundary.rbs +15 -8
  199. data/sig/generated/paper_trail_diff/version_query.rbs +17 -10
  200. data/sig/generated/paper_trail_diff/version_range.rbs +6 -9
  201. data/sig/generated/paper_trail_diff/version_sequence_diagnostics.rbs +13 -0
  202. data/sig/generated/paper_trail_diff/version_table.rbs +3 -0
  203. data/sig/generated/paper_trail_diff.rbs +16 -16
  204. metadata +28 -6
  205. data/lib/paper_trail_diff/preloaded_endpoint_batch_loader.rb +0 -60
  206. data/sig/generated/paper_trail_diff/preloaded_endpoint_batch_loader.rbs +0 -32
@@ -18,13 +18,10 @@ module PaperTrailDiff
18
18
  # share these snapshots too, and the caches their refresher builds. They
19
19
  # are the same for any root with that history, so reusing them depends on
20
20
  # nothing but the history.
21
+ #
22
+ # A `start_at` is a window's; a range of versions starts at its first.
21
23
  #: (untyped, Array[untyped], ?start_at: untyped, ?end_at: untyped) -> PreparedActivitySnapshots
22
- def prepare(
23
- record,
24
- root_versions,
25
- start_at: root_versions.first.created_at,
26
- end_at: root_versions.last.created_at
27
- )
24
+ def prepare(record, root_versions, start_at: nil, end_at: root_versions.last.created_at)
28
25
  history = @store.prepare(record, root_versions, start_at: start_at, end_at: end_at)
29
26
  last = @last
30
27
  return last if last && last.history.equal?(history)
@@ -63,6 +60,11 @@ module PaperTrailDiff
63
60
  @history&.activity_index
64
61
  end
65
62
 
63
+ #: () -> Array[Array[untyped]]
64
+ def opening_transactions
65
+ @history&.opening_transactions || []
66
+ end
67
+
66
68
  #: (untyped, untyped) -> RecordSnapshot?
67
69
  def call(root_endpoint, context_endpoint)
68
70
  @snapshotter.call(root_endpoint, context_endpoint, history: @history)
@@ -86,6 +88,13 @@ module PaperTrailDiff
86
88
  history: @history)
87
89
  end
88
90
 
91
+ # The state this root's snapshot at an endpoint is built from, where
92
+ # prepared history builds it.
93
+ #: (untyped) -> PreparedRecordState?
94
+ def root_state(root_endpoint)
95
+ @store.root_state(root_endpoint) if @history
96
+ end
97
+
89
98
  #: (untyped, habtm_version: untyped) -> untyped
90
99
  def association_reader(context_version, habtm_version:)
91
100
  @store.association_reader(context_version, habtm_version: habtm_version, history: @history)
@@ -115,17 +124,12 @@ module PaperTrailDiff
115
124
  @events = events
116
125
  @snapshotter = snapshotter
117
126
  @current = current
118
- @transaction_groups = ActivityTransactionGroups.new(events)
127
+ @transaction_groups = ActivityTransactionGroups.new(
128
+ events, opening: snapshotter.opening_transactions
129
+ )
119
130
  @root_endpoints = build_root_endpoints
120
131
  end
121
132
 
122
- #: () -> Array[RecordSnapshot?]
123
- def call
124
- snapshots = [] #: Array[RecordSnapshot?]
125
- each { |_event, snapshot| snapshots << snapshot }
126
- snapshots
127
- end
128
-
129
133
  #: () { (ActivityEvent, RecordSnapshot?) -> void } -> void
130
134
  def each
131
135
  first = @events.first
@@ -156,7 +160,7 @@ module PaperTrailDiff
156
160
  incremental_root?(previous_event)
157
161
 
158
162
  branches = @transaction_groups.branches_for(previous_event)
159
- return full_snapshot(event) unless branches
163
+ return rebuilt_snapshot(previous_event, event, previous_snapshot) unless branches
160
164
 
161
165
  @snapshotter.refresh(
162
166
  root_endpoint(event.version),
@@ -168,6 +172,24 @@ module PaperTrailDiff
168
172
  )
169
173
  end
170
174
 
175
+ # A transaction with a root event is read whole once it ends. Until then,
176
+ # PT-AT reads the records it saved as they stood before it began, so from
177
+ # one descendant's event to the next in the same transaction the snapshot
178
+ # is the same, and from the root's event to a descendant's only the root's
179
+ # own version applies, as when it is alone in its transaction. A create
180
+ # leaves nothing to advance. The root's version can record what the
181
+ # transaction changed, such as HABTM membership, so a snapshot at a root
182
+ # event is rebuilt.
183
+ #: (ActivityEvent, ActivityEvent, RecordSnapshot?) -> RecordSnapshot?
184
+ def rebuilt_snapshot(previous_event, event, previous_snapshot)
185
+ return full_snapshot(event) if event.root?
186
+ return full_snapshot(event) unless @transaction_groups.shared?(previous_event, event)
187
+ return previous_snapshot unless previous_event.root?
188
+ return full_snapshot(event) unless previous_snapshot
189
+
190
+ advance_root(previous_event, event, previous_snapshot)
191
+ end
192
+
171
193
  #: (ActivityEvent) -> bool
172
194
  def incremental_root?(event)
173
195
  event.root? && @transaction_groups.isolated?(event)
@@ -2,14 +2,13 @@
2
2
  # rbs_inline: enabled
3
3
 
4
4
  module PaperTrailDiff
5
- # Loads the `belongs_to` targets owners pointed at during one activity range:
6
- # at its start and after each change inside it.
5
+ # Loads the `belongs_to` targets owners pointed at from a start onward: at
6
+ # the start, after each change since, and in the live row.
7
7
  #
8
8
  # PT-AT records a version's foreign keys as they stood after its change, so
9
- # the target at the start comes from the latest version before it, and the
10
- # version a range ends at names a target only after the range. Reading only
11
- # the owners' versions inside the range misses a target whose owner did not
12
- # change there -- an author renamed under an article nobody edited.
9
+ # the target at the start comes from the latest version before it. Reading
10
+ # only the owners' versions after the start misses a target whose owner did
11
+ # not change there -- an author renamed under an article nobody edited.
13
12
  class ActivityTargetCandidateLoader
14
13
  # A plain class rather than Data.define, which arrived in Ruby 3.2 while this
15
14
  # gem supports 3.1.
@@ -19,48 +18,40 @@ module PaperTrailDiff
19
18
  attr_reader :foreign_type #: String?
20
19
  attr_reader :created_at #: untyped
21
20
  attr_reader :event #: String?
22
- attr_reader :version_id #: untyped
23
21
 
24
- #: (untyped, untyped, String?, ?untyped, ?String?, ?untyped) -> void
25
- def initialize(owner_id, foreign_key_id, foreign_type, created_at = nil, event = nil, # rubocop:disable Metrics/ParameterLists
26
- version_id = nil)
22
+ #: (untyped, untyped, String?, ?untyped, ?String?) -> void
23
+ def initialize(owner_id, foreign_key_id, foreign_type, created_at = nil, event = nil)
27
24
  @owner_id = owner_id
28
25
  @foreign_key_id = foreign_key_id
29
26
  @foreign_type = foreign_type
30
27
  @created_at = created_at
31
28
  @event = event
32
- @version_id = version_id
33
29
  freeze
34
30
  end
35
31
  end
36
32
 
37
- #: (untyped, Array[untyped], untyped, ActivityRange) -> void
38
- def initialize(owner_class, owner_ids, reflection, range)
33
+ #: (untyped, Array[untyped], untyped, untyped) -> void
34
+ def initialize(owner_class, owner_ids, reflection, start_at)
39
35
  @owner_class = owner_class
40
36
  @owner_ids = owner_ids
41
37
  @reflection = reflection
42
- @range = range
38
+ @start_at = start_at
43
39
  end
44
40
 
45
- #: () -> Array[Row]
46
- def call
47
- rows = historical_rows.select do |row|
48
- @range.recorded_before_end?(row.created_at, row.version_id)
49
- end
50
- @range.current_end? ? rows + current_rows : rows
51
- end
52
-
53
- # One shared query keeps the owner and timestamp needed to partition a
54
- # batch's candidates back into each root's exact activity range.
41
+ # Queries shared by a batch's roots keep the owner and timestamp needed to
42
+ # partition its candidates back into each root's exact activity range.
55
43
  #: () -> Array[Row]
56
44
  def historical_rows
57
45
  return [] if composite_foreign_key?
58
46
 
59
47
  version_class = @owner_class.paper_trail.version_class
60
- relation = candidate_scope(version_class).call(historical_relation(version_class))
61
- historical_columns(relation, version_class).map do |row|
62
- owner_id, id, type, created_at, event, version_id = row
63
- Row.new(Support.record_id(@owner_class, owner_id), id, type, created_at, event, version_id)
48
+ scope = VersionAssociationCandidateScope.new(version_class, @start_at)
49
+ owner_slices.flat_map do |owners|
50
+ relation = scope.call(historical_relation(version_class, owners))
51
+ historical_columns(relation, version_class).map do |row|
52
+ owner_id, id, type, created_at, event = row
53
+ Row.new(Support.record_id(@owner_class, owner_id), id, type, created_at, event)
54
+ end
64
55
  end
65
56
  end
66
57
 
@@ -79,14 +70,20 @@ module PaperTrailDiff
79
70
  # @rbs @owner_class: untyped
80
71
  # @rbs @owner_ids: Array[untyped]
81
72
  # @rbs @reflection: untyped
82
- # @rbs @range: ActivityRange
73
+ # @rbs @start_at: untyped
83
74
 
84
- #: (untyped) -> untyped
85
- def historical_relation(version_class)
75
+ # Each statement reads the targets of 500 owners.
76
+ #: () -> Enumerator[Array[untyped], untyped]
77
+ def owner_slices
78
+ @owner_ids.each_slice(Support::IDS_PER_STATEMENT)
79
+ end
80
+
81
+ #: (untyped, Array[untyped]) -> untyped
82
+ def historical_relation(version_class, owners)
86
83
  VersionTable.joined(association_class, version_class)
87
84
  .where(foreign_key_name: @reflection.foreign_key)
88
85
  .where(version_class.table_name => {
89
- item_type: @owner_class.base_class.name, item_id: @owner_ids
86
+ item_type: @owner_class.base_class.name, item_id: owners
90
87
  })
91
88
  end
92
89
 
@@ -95,8 +92,7 @@ module PaperTrailDiff
95
92
  versions = version_class.arel_table
96
93
  associations = association_class.arel_table
97
94
  relation.pluck(versions[:item_id], associations[:foreign_key_id],
98
- associations[:foreign_type], versions[:created_at], versions[:event],
99
- versions[:id])
95
+ associations[:foreign_type], versions[:created_at], versions[:event])
100
96
  end
101
97
 
102
98
  # A polymorphic key names its target in a type column; any other names it
@@ -105,17 +101,13 @@ module PaperTrailDiff
105
101
  # the owners of an association through one subclass.
106
102
  #: () -> Array[Array[untyped]]
107
103
  def live_rows
108
- relation = @owner_class.base_class.unscoped.where(@owner_class.primary_key => @owner_ids)
109
104
  key = @reflection.foreign_key
110
- return relation.pluck(@owner_class.primary_key, key) unless @reflection.polymorphic?
111
-
112
- relation.pluck(@owner_class.primary_key, key, @reflection.foreign_type)
113
- end
105
+ owner_slices.flat_map do |owners|
106
+ relation = @owner_class.base_class.unscoped.where(@owner_class.primary_key => owners)
107
+ next relation.pluck(@owner_class.primary_key, key) unless @reflection.polymorphic?
114
108
 
115
- #: (untyped) -> VersionAssociationCandidateScope
116
- def candidate_scope(version_class)
117
- VersionAssociationCandidateScope.new(version_class, @range.start_time,
118
- end_at: @range.end_time)
109
+ relation.pluck(@owner_class.primary_key, key, @reflection.foreign_type)
110
+ end
119
111
  end
120
112
 
121
113
  #: () -> untyped