paper_trail_diff 0.2.0 → 0.3.0

data/sig/generated/paper_trail_diff/support.rbs

@@ -21,9 +21,15 @@ module PaperTrailDiff
     # : (String, String) -> String
     def self?.association_path: (String, String) -> String
 
+    # : (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+    def self?.merge_record_groups: (Hash[String, Hash[Symbol, untyped]], Hash[String, Hash[Symbol, untyped]]) -> Hash[String, Hash[Symbol, untyped]]
+
     # : (untyped) -> untyped
     def self?.duplicate_and_freeze: (untyped) -> untyped
 
+    # : (Hash[String, Array[untyped]]?, Hash[String, Array[untyped]]?) -> Hash[String, Array[untyped]]?
+    def self?.merge_record_owners: (Hash[String, Array[untyped]]?, Hash[String, Array[untyped]]?) -> Hash[String, Array[untyped]]?
+
     # : (untyped) -> bool
     def self?.paper_trail_diff_value?: (untyped) -> bool
   end

data/sig/generated/paper_trail_diff/time_activity_timeline_builder.rbs

@@ -0,0 +1,46 @@
+# Generated from lib/paper_trail_diff/time_activity_timeline_builder.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Builds activity views for mutations selected by a wall-clock range.
+  class TimeActivityTimelineBuilder
+    # : (untyped, range: TimelineRange, tree: AssociationTree, snapshotter: untyped) -> void
+    def initialize: (untyped, range: TimelineRange, tree: AssociationTree, snapshotter: untyped) -> void
+
+    # : () -> Array[ActivityStep]
+    def build: () -> Array[ActivityStep]
+
+    # : () -> Analysis
+    def analyze: () -> Analysis
+
+    private
+
+    @range: TimelineRange
+
+    @record: untyped
+
+    @snapshotter: untyped
+
+    @tree: AssociationTree
+
+    # : () -> [ActivityHistory, Array[untyped]]
+    def history_and_versions: () -> [ ActivityHistory, Array[untyped] ]
+
+    # : (Array[untyped]) -> void
+    def prepare_history: (Array[untyped]) -> void
+
+    # : (Array[untyped]) -> Array[ActivityEvent]
+    def collect_events: (Array[untyped]) -> Array[ActivityEvent]
+
+    # : (Array[ActivityEvent]) -> bool
+    def time_events?: (Array[ActivityEvent]) -> bool
+
+    # : (ActivityEvent, Array[ActivityEvent]) -> bool
+    def later_event?: (ActivityEvent, Array[ActivityEvent]) -> bool
+
+    # : (Array[untyped], Hash[Array[untyped], RecordSnapshot?]) -> Array[Step]
+    def root_steps: (Array[untyped], Hash[Array[untyped], RecordSnapshot?]) -> Array[Step]
+
+    # : (untyped) -> Array[untyped]
+    def version_key: (untyped) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/time_range.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/time_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Validates and applies a finite wall-clock range without loading model state.
+  class TimeRange
+    attr_reader begin_time: Time
+
+    attr_reader end_time: Time
+
+    # : (untyped) -> void
+    def initialize: (untyped) -> void
+
+    # : () -> bool
+    def exclude_end?: () -> bool
+
+    # : (untyped) -> bool
+    def include?: (untyped) -> bool
+
+    # : (untyped) -> untyped
+    def scope: (untyped) -> untyped
+
+    # : (untyped) -> untyped
+    def trailing_scope: (untyped) -> untyped
+
+    private
+
+    @exclude_end: bool
+
+    # : () -> Range[Time]
+    def query_range: () -> Range[Time]
+
+    # : (untyped, boundary: Symbol) -> Time
+    def coerce_time: (untyped, boundary: Symbol) -> Time
+
+    # : (untyped) -> Time
+    def time_value: (untyped) -> Time
+
+    # : () -> void
+    def validate_order!: () -> void
+  end
+end

data/sig/generated/paper_trail_diff/time_version_range.rbs

@@ -0,0 +1,27 @@
+# Generated from lib/paper_trail_diff/time_version_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Selects in-range root versions plus one later reconstruction boundary.
+  class TimeVersionRange
+    # : (untyped, time_range: TimeRange) -> void
+    def initialize: (untyped, time_range: TimeRange) -> void
+
+    # : (?context_required: bool) -> Array[untyped]
+    def select: (?context_required: bool) -> Array[untyped]
+
+    private
+
+    @record: untyped
+
+    @time_range: TimeRange
+
+    # : () -> untyped
+    def versions_relation: () -> untyped
+
+    # : (untyped) -> untyped
+    def trailing_version: (untyped) -> untyped
+
+    # : (Array[untyped]) -> Array[untyped]
+    def ordered: (Array[untyped]) -> Array[untyped]
+  end
+end

data/sig/generated/paper_trail_diff/timeline_builder.rbs

@@ -3,8 +3,8 @@
 module PaperTrailDiff
   # Selects and compares a chronological slice of a record's version history.
   class TimelineBuilder
-    # : (untyped, from: untyped, to: untyped, snapshotter: untyped) -> void
-    def initialize: (untyped, from: untyped, to: untyped, snapshotter: untyped) -> void
+    # : (untyped, from: untyped, to: untyped, snapshotter: untyped, ?within: untyped) -> void
+    def initialize: (untyped, from: untyped, to: untyped, snapshotter: untyped, ?within: untyped) -> void
 
     # : () -> Array[Step]
     def build: () -> Array[Step]
@@ -14,17 +14,18 @@ module PaperTrailDiff
 
     private
 
-    @from: untyped
+    @range: TimelineRange
 
     @record: untyped
 
     @snapshotter: untyped
 
-    @to: untyped
-
     # : (Array[untyped]) -> [Array[Step], RecordSnapshot?, RecordSnapshot?]
     def compare_history: (Array[untyped]) -> [ Array[Step], RecordSnapshot?, RecordSnapshot? ]
 
+    # : () -> [Array[Step], nil, nil]
+    def empty_history: () -> [ Array[Step], nil, nil ]
+
     # : () -> Array[untyped]
     def selected_versions: () -> Array[untyped]
   end

data/sig/generated/paper_trail_diff/timeline_range.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/timeline_range.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Chooses explicit-version or wall-clock selection for one timeline request.
+  class TimelineRange
+    attr_reader from: untyped
+
+    attr_reader to: untyped
+
+    attr_reader time_range: TimeRange?
+
+    # : (untyped, from: untyped, to: untyped, within: untyped) -> void
+    def initialize: (untyped, from: untyped, to: untyped, within: untyped) -> void
+
+    # : (?context_required: bool) -> Array[untyped]
+    def select: (?context_required: bool) -> Array[untyped]
+
+    # : () -> bool
+    def time?: () -> bool
+
+    # : () -> Time?
+    def begin_time: () -> Time?
+
+    # : (untyped) -> bool
+    def include?: (untyped) -> bool
+
+    private
+
+    @from: untyped
+
+    @record: untyped
+
+    @to: untyped
+
+    # : (untyped) -> TimeRange?
+    def build_time_range: (untyped) -> TimeRange?
+
+    # : () -> void
+    def validate_mode!: () -> void
+  end
+end

data/sig/generated/paper_trail_diff/version_association_candidate_scope.rbs

@@ -0,0 +1,32 @@
+# Generated from lib/paper_trail_diff/version_association_candidate_scope.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Selects association activity from a boundary forward plus the state at that boundary.
+  class VersionAssociationCandidateScope
+    # : (untyped, untyped, ?end_at: untyped) -> void
+    def initialize: (untyped, untyped, ?end_at: untyped) -> void
+
+    # : (untyped) -> untyped
+    def call: (untyped) -> untyped
+
+    private
+
+    @end_at: untyped
+
+    @start_at: untyped
+
+    @version_class: untyped
+
+    # : () -> String
+    def candidate_condition: () -> String
+
+    # : (String, String) -> String
+    def activity_condition: (String, String) -> String
+
+    # : (String, String) -> String
+    def column: (String, String) -> String
+
+    # : (String) -> String
+    def compact_sql: (String) -> String
+  end
+end

data/sig/generated/paper_trail_diff.rbs

@@ -7,20 +7,24 @@ module PaperTrailDiff
   SUPPORTED_ASSOCIATION_MACROS: untyped
 
   # Compares net state between explicit PaperTrail-version or current-record endpoints.
-  # : (untyped, untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Diff
-  def self.compare: (untyped, untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Diff
+  # : (untyped, untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> Diff
+  def self.compare: (untyped, untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> Diff
+
+  # Compares many independent endpoint pairs while batching current-record loading.
+  # : (Array[comparison_input], ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> comparison_results
+  def self.compare_many: (Array[comparison_input], ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> comparison_results
 
   # Compares every adjacent reconstructed state in an inclusive version range.
-  # : (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
-  def self.timeline: (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
+  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
+  def self.timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
 
   # Compares adjacent root and selected-descendant activity boundaries.
-  # : (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
-  def self.activity_timeline: (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
+  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
+  def self.activity_timeline: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
 
   # Builds an endpoint diff and root-checkpoint timeline while normalizing each version once.
-  # : (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
-  def self.analyze: (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
+  # : (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
+  def self.analyze: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
 
   # Returns the association macros this release can normalize.
   # : () -> Array[Symbol]
@@ -50,6 +54,10 @@ module PaperTrailDiff
 
   type identity = Array[untyped]
 
+  type comparison_input = Hash[String | Symbol, untyped]
+
+  type comparison_results = Hash[identity, Diff]
+
   type ignore_option = Array[String | Symbol] | Hash[String | Symbol, untyped]
 
   type reference_key = :type | :id | "type" | "id"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paper_trail_diff
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Alex Williams
@@ -44,10 +44,13 @@ files:
 - README.md
 - lib/paper_trail_diff.rb
 - lib/paper_trail_diff/activity_boundary.rb
+- lib/paper_trail_diff/activity_child_candidate_loader.rb
 - lib/paper_trail_diff/activity_event.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_root_snapshot_refresher.rb
+- lib/paper_trail_diff/activity_snapshot_delta.rb
 - lib/paper_trail_diff/activity_snapshot_sequence.rb
 - lib/paper_trail_diff/activity_timeline_builder.rb
 - lib/paper_trail_diff/activity_version_collector.rb
@@ -56,6 +59,10 @@ files:
 - lib/paper_trail_diff/association_discovery.rb
 - lib/paper_trail_diff/association_traversal.rb
 - lib/paper_trail_diff/branch_snapshot_refresher.rb
+- lib/paper_trail_diff/collection_comparator.rb
+- lib/paper_trail_diff/collection_identity_index.rb
+- lib/paper_trail_diff/collection_transition.rb
+- lib/paper_trail_diff/comparison_batch.rb
 - lib/paper_trail_diff/configuration.rb
 - lib/paper_trail_diff/diagnostics.rb
 - lib/paper_trail_diff/endpoint.rb
@@ -63,8 +70,13 @@ files:
 - lib/paper_trail_diff/errors.rb
 - lib/paper_trail_diff/historical_association_reifier.rb
 - lib/paper_trail_diff/historical_snapshot_store.rb
+- lib/paper_trail_diff/instrumentation.rb
 - lib/paper_trail_diff/live_association_reader.rb
+- lib/paper_trail_diff/live_endpoint_batch_loader.rb
+- lib/paper_trail_diff/live_endpoint_provider.rb
+- lib/paper_trail_diff/live_graph_collector.rb
 - lib/paper_trail_diff/paper_trail_adapter.rb
+- lib/paper_trail_diff/preloaded_endpoint_batch_loader.rb
 - lib/paper_trail_diff/prepared_association_reifier.rb
 - lib/paper_trail_diff/prepared_edge_loader.rb
 - lib/paper_trail_diff/prepared_history.rb
@@ -75,20 +87,28 @@ files:
 - lib/paper_trail_diff/snapshot_traversal.rb
 - lib/paper_trail_diff/step.rb
 - lib/paper_trail_diff/support.rb
+- lib/paper_trail_diff/time_activity_timeline_builder.rb
+- lib/paper_trail_diff/time_range.rb
+- lib/paper_trail_diff/time_version_range.rb
 - lib/paper_trail_diff/timeline_builder.rb
+- lib/paper_trail_diff/timeline_range.rb
 - lib/paper_trail_diff/timeline_snapshot_provider.rb
 - lib/paper_trail_diff/traversal.rb
 - lib/paper_trail_diff/traversal_emitter.rb
 - lib/paper_trail_diff/traversal_entry.rb
 - lib/paper_trail_diff/value_objects.rb
 - lib/paper_trail_diff/version.rb
+- 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_boundary.rbs
+- sig/generated/paper_trail_diff/activity_child_candidate_loader.rbs
 - sig/generated/paper_trail_diff/activity_event.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_root_snapshot_refresher.rbs
+- sig/generated/paper_trail_diff/activity_snapshot_delta.rbs
 - sig/generated/paper_trail_diff/activity_snapshot_sequence.rbs
 - sig/generated/paper_trail_diff/activity_timeline_builder.rbs
 - sig/generated/paper_trail_diff/activity_version_collector.rbs
@@ -97,6 +117,10 @@ files:
 - sig/generated/paper_trail_diff/association_discovery.rbs
 - sig/generated/paper_trail_diff/association_traversal.rbs
 - sig/generated/paper_trail_diff/branch_snapshot_refresher.rbs
+- sig/generated/paper_trail_diff/collection_comparator.rbs
+- sig/generated/paper_trail_diff/collection_identity_index.rbs
+- sig/generated/paper_trail_diff/collection_transition.rbs
+- sig/generated/paper_trail_diff/comparison_batch.rbs
 - sig/generated/paper_trail_diff/configuration.rbs
 - sig/generated/paper_trail_diff/diagnostics.rbs
 - sig/generated/paper_trail_diff/endpoint.rbs
@@ -104,8 +128,13 @@ files:
 - sig/generated/paper_trail_diff/errors.rbs
 - sig/generated/paper_trail_diff/historical_association_reifier.rbs
 - sig/generated/paper_trail_diff/historical_snapshot_store.rbs
+- sig/generated/paper_trail_diff/instrumentation.rbs
 - sig/generated/paper_trail_diff/live_association_reader.rbs
+- sig/generated/paper_trail_diff/live_endpoint_batch_loader.rbs
+- sig/generated/paper_trail_diff/live_endpoint_provider.rbs
+- sig/generated/paper_trail_diff/live_graph_collector.rbs
 - sig/generated/paper_trail_diff/paper_trail_adapter.rbs
+- sig/generated/paper_trail_diff/preloaded_endpoint_batch_loader.rbs
 - sig/generated/paper_trail_diff/prepared_association_reifier.rbs
 - sig/generated/paper_trail_diff/prepared_edge_loader.rbs
 - sig/generated/paper_trail_diff/prepared_history.rbs
@@ -116,13 +145,18 @@ files:
 - sig/generated/paper_trail_diff/snapshot_traversal.rbs
 - sig/generated/paper_trail_diff/step.rbs
 - sig/generated/paper_trail_diff/support.rbs
+- sig/generated/paper_trail_diff/time_activity_timeline_builder.rbs
+- sig/generated/paper_trail_diff/time_range.rbs
+- sig/generated/paper_trail_diff/time_version_range.rbs
 - sig/generated/paper_trail_diff/timeline_builder.rbs
+- sig/generated/paper_trail_diff/timeline_range.rbs
 - sig/generated/paper_trail_diff/timeline_snapshot_provider.rbs
 - sig/generated/paper_trail_diff/traversal.rbs
 - sig/generated/paper_trail_diff/traversal_emitter.rbs
 - sig/generated/paper_trail_diff/traversal_entry.rbs
 - sig/generated/paper_trail_diff/value_objects.rbs
 - sig/generated/paper_trail_diff/version.rbs
+- sig/generated/paper_trail_diff/version_association_candidate_scope.rbs
 - sig/generated/paper_trail_diff/version_range.rbs
 homepage: https://github.com/aheathwilliams/paper_trail_diff
 licenses:
@@ -130,11 +164,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.2.0/CHANGELOG.md
-  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.2.0/README.md
+  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
   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.2.0
+  source_code_uri: https://github.com/aheathwilliams/paper_trail_diff/tree/v0.3.0
 rdoc_options: []
 require_paths:
 - lib