paper_trail_diff 0.1.0 → 0.3.0

data/sig/generated/paper_trail_diff/traversal.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/traversal.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Coordinates root lifecycle, scalar, and association traversal.
+  class DiffTraversal < TraversalEmitter
+    # : (Diff, ^(TraversalEntry) -> void) -> void
+    def initialize: (Diff, ^(TraversalEntry) -> void) -> void
+
+    # : () -> void
+    def call: () -> void
+
+    private
+
+    @associations: AssociationDiffTraversal
+
+    @diff: Diff
+
+    @snapshots: SnapshotTraversal
+
+    # : () -> void
+    def walk_presence_change: () -> void
+
+    # : (RecordSnapshot?, traversal_state) -> void
+    def walk_presence_snapshot: (RecordSnapshot?, traversal_state) -> void
+  end
+
+  # The complete structured difference between two normalized endpoints.
+  class Diff
+    # Walks semantic changes and the nested state carried by added or removed records.
+    # @rbs () { (TraversalEntry) -> void } -> Diff
+    #    | () -> Enumerator[TraversalEntry, Diff]
+    def each_entry: () { (TraversalEntry) -> void } -> Diff
+                  | () -> Enumerator[TraversalEntry, Diff]
+
+    # Walks only semantic changes, excluding snapshot state included for context.
+    # @rbs () { (TraversalEntry) -> void } -> Diff
+    #    | () -> Enumerator[TraversalEntry, Diff]
+    def each_change: () { (TraversalEntry) -> void } -> Diff
+                   | () -> Enumerator[TraversalEntry, Diff]
+  end
+end

data/sig/generated/paper_trail_diff/traversal_emitter.rbs

@@ -0,0 +1,16 @@
+# Generated from lib/paper_trail_diff/traversal_emitter.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Shared entry construction for internal traversal collaborators.
+  class TraversalEmitter
+    # : (^(TraversalEntry) -> void) -> void
+    def initialize: (^(TraversalEntry) -> void) -> void
+
+    private
+
+    @receiver: ^(TraversalEntry) -> void
+
+    # : (kind: Symbol, context: traversal_context, association_path: traversal_association_path, record_path: traversal_record_path, value: untyped, ?association_kind: Symbol?, ?state: traversal_state?, ?attribute: String?) -> void
+    def emit: (kind: Symbol, context: traversal_context, association_path: traversal_association_path, record_path: traversal_record_path, value: untyped, ?association_kind: Symbol?, ?state: traversal_state?, ?attribute: String?) -> void
+  end
+end

data/sig/generated/paper_trail_diff/traversal_entry.rbs

@@ -0,0 +1,52 @@
+# Generated from lib/paper_trail_diff/traversal_entry.rb with RBS::Inline
+
+module PaperTrailDiff
+  # One immutable location and value emitted while walking a Diff tree.
+  class TraversalEntry
+    CONTEXTS: untyped
+
+    STATES: untyped
+
+    attr_reader kind: Symbol
+
+    attr_reader context: traversal_context
+
+    attr_reader association_path: traversal_association_path
+
+    attr_reader record_path: traversal_record_path
+
+    attr_reader association_kind: Symbol?
+
+    attr_reader state: traversal_state?
+
+    attr_reader attribute: String?
+
+    attr_reader value: untyped
+
+    # : (kind: Symbol, context: traversal_context, ?association_path: traversal_association_path, ?record_path: traversal_record_path, ?association_kind: Symbol?, ?state: traversal_state?, ?attribute: String?, ?value: untyped) -> void
+    def initialize: (kind: Symbol, context: traversal_context, ?association_path: traversal_association_path, ?record_path: traversal_record_path, ?association_kind: Symbol?, ?state: traversal_state?, ?attribute: String?, ?value: untyped) -> void
+
+    # : () -> bool
+    def change?: () -> bool
+
+    # : () -> bool
+    def included_state?: () -> bool
+
+    # : () -> String?
+    def association: () -> String?
+
+    # : () -> RecordReference?
+    def record: () -> RecordReference?
+
+    # : () -> Hash[Symbol, untyped]
+    def to_h: () -> Hash[Symbol, untyped]
+
+    private
+
+    # : (Symbol, Symbol?) -> void
+    def validate!: (Symbol, Symbol?) -> void
+
+    # : (traversal_association_path) -> traversal_association_path
+    def immutable_names: (traversal_association_path) -> traversal_association_path
+  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,7 +54,19 @@ 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"
+
+  type traversal_context = :change | :included_state
+
+  type traversal_state = :before | :after
+
+  type traversal_association_path = Array[String]
+
+  type traversal_record_path = Array[RecordReference]
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paper_trail_diff
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Alex Williams
@@ -40,20 +40,29 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE
+- QUICKSTART.md
 - 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
 - lib/paper_trail_diff/analysis.rb
+- lib/paper_trail_diff/association_diff_traversal.rb
 - 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
@@ -61,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
@@ -70,26 +84,43 @@ files:
 - lib/paper_trail_diff/prepared_record_index.rb
 - lib/paper_trail_diff/snapshot.rb
 - lib/paper_trail_diff/snapshot_normalizer.rb
+- 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
 - sig/generated/paper_trail_diff/analysis.rbs
+- sig/generated/paper_trail_diff/association_diff_traversal.rbs
 - 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
@@ -97,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
@@ -106,12 +142,21 @@ files:
 - sig/generated/paper_trail_diff/prepared_record_index.rbs
 - sig/generated/paper_trail_diff/snapshot.rbs
 - sig/generated/paper_trail_diff/snapshot_normalizer.rbs
+- 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:
@@ -119,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.1.0/CHANGELOG.md
-  documentation_uri: https://github.com/aheathwilliams/paper_trail_diff/blob/v0.1.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.1.0
+  source_code_uri: https://github.com/aheathwilliams/paper_trail_diff/tree/v0.3.0
 rdoc_options: []
 require_paths:
 - lib