familia 2.0.0.pre18 → 2.0.0.pre21

data/try/features/relationships/participation_unresolved_target_try.rb

@@ -0,0 +1,109 @@
+# try/features/relationships/participation_unresolved_target_try.rb
+#
+# frozen_string_literal: true
+
+# Test for proper error handling when target class cannot be resolved
+#
+# This test verifies that participates_in raises a helpful error when
+# the target class hasn't been loaded yet or doesn't exist.
+
+require_relative '../../support/helpers/test_helpers'
+
+## Test error message when target class doesn't exist (Symbol)
+begin
+  class UnresolvedTargetTest1 < Familia::Horreum
+    feature :relationships
+    identifier_field :id
+    field :id
+
+    participates_in :NonExistentTargetClass, :items
+  end
+  @error_raised = false
+rescue ArgumentError => e
+  @error_raised = true
+  @error_message = e.message
+end
+@error_raised
+#=> true
+
+## Test error message includes the unresolved class name
+@error_message.include?('NonExistentTargetClass')
+#=> true
+
+## Test error message mentions load order issue
+@error_message.include?('load order')
+#=> true
+
+## Test error message mentions Familia.members
+@error_message.include?('Familia.members')
+#=> true
+
+## Test error message includes list of registered classes
+@error_message.include?('Current registered classes')
+#=> true
+
+## Test error when target class doesn't exist (String)
+begin
+  class UnresolvedTargetTest2 < Familia::Horreum
+    feature :relationships
+    identifier_field :id
+    field :id
+
+    participates_in 'AnotherNonExistentClass', :items
+  end
+  @string_error_raised = false
+rescue ArgumentError => e
+  @string_error_raised = true
+  @string_error_message = e.message
+end
+@string_error_raised
+#=> true
+
+## Test error message for String target includes class name
+@string_error_message.include?('AnotherNonExistentClass')
+#=> true
+
+## Test error provides solution hint
+@string_error_message.include?('Solution')
+#=> true
+
+## Test that Class objects don't trigger the error (they're already resolved)
+# This should work fine - no error expected
+class ExistingTargetClass < Familia::Horreum
+  feature :relationships
+  identifier_field :id
+  field :id
+end
+
+class WorkingParticipant < Familia::Horreum
+  feature :relationships
+  identifier_field :id
+  field :id
+
+  # This should work - ExistingTargetClass is already defined
+  participates_in ExistingTargetClass, :items
+end
+
+# Verify the class was created successfully
+WorkingParticipant.ancestors.include?(Familia::Horreum)
+#=> true
+
+## Test that resolved Symbol target works (no error)
+class PreDefinedTarget < Familia::Horreum
+  feature :relationships
+  identifier_field :id
+  field :id
+end
+
+class SymbolParticipant < Familia::Horreum
+  feature :relationships
+  identifier_field :id
+  field :id
+
+  # This should work - PreDefinedTarget is defined above
+  participates_in :PreDefinedTarget, :items
+end
+
+# Verify it worked
+SymbolParticipant.ancestors.include?(Familia::Horreum)
+#=> true

data/try/features/relationships/relationships_api_changes_try.rb

@@ -1,5 +1,7 @@
 # try/features/relationships/relationships_api_changes_try.rb
 #
+# frozen_string_literal: true
+
 # Test coverage for Familia v2 relationships API changes
 # Testing new class_participates_in and unique_index methods
 # Testing breaking changes and argument validation
@@ -264,17 +266,17 @@ participation_meta.target_class.familia_name
 
 ## unique_index stores correct target_class
 indexing_meta = ApiTestUser.indexing_relationships.find { |r| r.index_name == :email_lookup }
-indexing_meta.target_class
+indexing_meta.scope_class
 #=> ApiTestUser
 
-## unique_index stores correct target_class via familia_name
+## unique_index stores correct scope_class via familia_name
 indexing_meta = ApiTestUser.indexing_relationships.find { |r| r.index_name == :email_lookup }
-indexing_meta.target_class.familia_name
+indexing_meta.scope_class.familia_name
 #=> 'ApiTestUser'
 
 ## multi_index with within: stores correct metadata
 membership_meta = ApiTestMembership.indexing_relationships.find { |r| r.index_name == :user_memberships }
-membership_meta.target_class
+membership_meta.scope_class
 #=> ApiTestUser
 
 # =============================================

data/try/features/relationships/relationships_edge_cases_try.rb

@@ -1,3 +1,7 @@
+# try/features/relationships/relationships_edge_cases_try.rb
+#
+# frozen_string_literal: true
+
 # Simplified edge case testing for Relationships v2 - focusing on core functionality
 
 require_relative '../../support/helpers/test_helpers'

data/try/features/relationships/relationships_performance_minimal_try.rb

@@ -1,3 +1,7 @@
+# try/features/relationships/relationships_performance_minimal_try.rb
+#
+# frozen_string_literal: true
+
 # Minimal performance testing focusing on core Familia functionality
 
 require_relative '../../support/helpers/test_helpers'

data/try/features/relationships/relationships_performance_simple_try.rb

@@ -1,3 +1,7 @@
+# try/features/relationships/relationships_performance_simple_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/relationships_performance_simple_try.rb
 #
 # Simplified performance testing for the Relationships feature

data/try/features/relationships/relationships_performance_try.rb

@@ -1,3 +1,7 @@
+# try/features/relationships/relationships_performance_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/relationships_performance_try.rb
 #
 # Performance and integration testing for the Relationships feature

data/try/features/relationships/relationships_performance_working_try.rb

@@ -1,3 +1,7 @@
+# try/features/relationships/relationships_performance_working_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/relationships_performance_working_try.rb
 #
 # Working performance test focusing on basic functionality

data/try/features/relationships/relationships_try.rb

@@ -1,5 +1,7 @@
 # try/features/relationships/relationships_try.rb
 #
+# frozen_string_literal: true
+
 # Simplified Familia v2 relationship functionality tests - focusing on core working features
 #
 
@@ -113,12 +115,12 @@ decoded[:permission_list].include?(:write)
 @customer.domains.class.name
 #=> "Familia::SortedSet"
 
-## Customer can add domains (generated method)
-@customer.respond_to?(:add_domain)
+## Customer can add domains (generated method with _instance suffix)
+@customer.respond_to?(:add_domains_instance)
 #=> true
 
-## Customer can remove domains (generated method)
-@customer.respond_to?(:remove_domain)
+## Customer can remove domains (generated method with _instance suffix)
+@customer.respond_to?(:remove_domains_instance)
 #=> true
 
 ## Domain can check membership in customer domains (collision-free naming)

data/try/features/safe_dump/safe_dump_advanced_try.rb

@@ -1,3 +1,7 @@
+# try/features/safe_dump/safe_dump_advanced_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/safe_dump_extended_try.rb
 
 # These tryouts test the safe dumping functionality.

data/try/features/safe_dump/safe_dump_try.rb

@@ -1,3 +1,7 @@
+# try/features/safe_dump/safe_dump_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/safe_dump_try.rb
 
 require_relative '../../support/helpers/test_helpers'

data/try/features/transient_fields/redacted_string_try.rb

@@ -1,4 +1,6 @@
 # try/features/transient_fields/redacted_string_try.rb
+#
+# frozen_string_literal: true
 
 require_relative '../../support/helpers/test_helpers'
 

data/try/features/transient_fields/refresh_reset_try.rb

@@ -1,4 +1,7 @@
 # try/features/transient_fields/refresh_reset_try.rb
+#
+# frozen_string_literal: true
+
 # Test that refresh! properly resets transient fields to nil
 
 require_relative '../../support/helpers/test_helpers'

data/try/features/transient_fields/simple_refresh_test.rb

@@ -1,3 +1,6 @@
+# try/features/transient_fields/simple_refresh_test.rb
+#
+# frozen_string_literal: true
 
 require_relative '../../helpers/test_helpers'
 

data/try/features/transient_fields/single_use_redacted_string_try.rb

@@ -1,4 +1,6 @@
 # try/features/transient_fields/single_use_redacted_string_try.rb
+#
+# frozen_string_literal: true
 
 require_relative '../../support/helpers/test_helpers'
 

data/try/features/transient_fields/transient_fields_core_try.rb

@@ -1,3 +1,7 @@
+# try/features/transient_fields/transient_fields_core_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/transient_fields_core_try.rb
 
 require_relative '../../support/helpers/test_helpers'

data/try/features/transient_fields/transient_fields_integration_try.rb

@@ -1,3 +1,7 @@
+# try/features/transient_fields/transient_fields_integration_try.rb
+#
+# frozen_string_literal: true
+
 # try/features/transient_fields_integration_try.rb
 
 require_relative '../../support/helpers/test_helpers'

data/try/integration/connection/fiber_context_preservation_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/fiber_context_preservation_try.rb
+#
+# frozen_string_literal: true
+
 # Fiber Context Preservation Tryouts
 #
 # Tests that verify the removal of previous_conn preservation logic
@@ -166,7 +170,7 @@ end
 ## Operation guards prevent pipeline fiber issues before they occur
 begin
   # Ensure we're in strict mode for this test
-  Familia.configure { |config| config.pipeline_mode = :strict }
+  Familia.configure { |config| config.pipelined_mode = :strict }
 
   Fiber[:familia_connection] = [Customer.create_dbclient, Familia.middleware_version]
   Fiber[:familia_connection_handler_class] = Familia::Connection::FiberConnectionHandler
@@ -185,7 +189,7 @@ end
 
 ## Method aliases work correctly
 # pipeline alias for pipelined
-result1 = Familia.pipeline do |conn|
+result1 = Familia.pipelined do |conn|
   conn.set('alias_test', 'alias_success')
   conn.get('alias_test')
 end
@@ -203,7 +207,7 @@ result1.results.last == 'alias_success' && result2.results.last == 'alias_succes
 customer = Customer.new(custid: 'alias_test')
 
 # pipeline alias
-result1 = customer.pipeline do |conn|
+result1 = customer.pipelined do |conn|
   conn.set('horreum:alias1', 'success1')
   conn.get('horreum:alias1')
 end

data/try/integration/connection/handler_constraints_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/handler_constraints_try.rb
+#
+# frozen_string_literal: true
+
 # Handler Constraint Methods Tryouts
 #
 # Tests that each connection handler class correctly defines its operation

data/try/integration/connection/isolated_dbclient_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/isolated_dbclient_try.rb
+#
+# frozen_string_literal: true
+
 # try/core/isolated_dbclient_try.rb
 
 # Tryouts: Isolated connection functionality

data/try/integration/connection/middleware_reconnect_try.rb

@@ -1,5 +1,7 @@
 # try/integration/connection/middleware_reconnect_try.rb
 #
+# frozen_string_literal: true
+
 # Tests for Familia.reconnect! method that refreshes connection pools
 # with current middleware configuration
 

data/try/integration/connection/operation_mode_guards_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/operation_mode_guards_try.rb
+#
+# frozen_string_literal: true
+
 # Operation Mode Guards Tryouts
 #
 # Tests the connection handler operation mode enforcement that prevents Redis
@@ -36,7 +40,7 @@ end
 ## FiberConnectionHandler blocks pipelines
 begin
   # Ensure we're in strict mode for this test
-  Familia.configure { |config| config.pipeline_mode = :strict }
+  Familia.configure { |config| config.pipelined_mode = :strict }
 
   # Simulate middleware connection
   Fiber[:familia_connection] = [Customer.create_dbclient, Familia.middleware_version]

data/try/integration/connection/pipeline_fallback_integration_try.rb

@@ -1,13 +1,16 @@
+# try/integration/connection/pipeline_fallback_integration_try.rb
 #
+# frozen_string_literal: true
+
 # Tests pipeline fallback modes when connection handlers don't support pipelines.
-# Validates that pipeline_mode configuration works correctly with cached connections
+# Validates that pipelined_mode configuration works correctly with cached connections
 # and that the fallback behavior matches transaction fallback patterns.
 #
 
 require_relative '../../support/helpers/test_helpers'
 
 # Store original values
-$original_pipeline_mode = Familia.pipeline_mode
+$original_pipelined_mode = Familia.pipelined_mode
 $original_transaction_mode = Familia.transaction_mode
 
 # Test model for pipeline fallback scenarios
@@ -17,7 +20,7 @@ class PipelineFallbackTest < Familia::Horreum
 end
 
 ## Test 1: Strict mode raises error with cached connection
-Familia.configure { |c| c.pipeline_mode = :strict }
+Familia.configure { |c| c.pipelined_mode = :strict }
 
 # Cache connection at class level (uses DefaultConnectionHandler which doesn't support pipelines)
 PipelineFallbackTest.instance_variable_set(:@dbclient, Familia.create_dbclient)
@@ -28,7 +31,7 @@ customer.pipelined { |c| c.set('key', 'value') }
 #=~> /Cannot start pipeline with.*CachedConnectionHandler/
 
 ## Test 2: Warn mode falls back successfully with cached connection
-Familia.configure { |c| c.pipeline_mode = :warn }
+Familia.configure { |c| c.pipelined_mode = :warn }
 
 # Cache connection at class level
 PipelineFallbackTest.instance_variable_set(:@dbclient, Familia.create_dbclient)
@@ -51,7 +54,7 @@ $warn_result.results[2]
 #=> 'value1'
 
 ## Test 3: Fresh connections still support real pipelines in strict mode
-Familia.configure { |c| c.pipeline_mode = :strict }
+Familia.configure { |c| c.pipelined_mode = :strict }
 
 # Clear cached class-level connection to force CreateConnectionHandler
 PipelineFallbackTest.remove_instance_variable(:@dbclient) if PipelineFallbackTest.instance_variable_defined?(:@dbclient)
@@ -70,7 +73,7 @@ $fresh_result.results.size
 #=> 3
 
 ## Test 4: MultiResult format is correct for fallback
-Familia.configure { |c| c.pipeline_mode = :permissive }
+Familia.configure { |c| c.pipelined_mode = :permissive }
 
 # Cache connection at class level
 PipelineFallbackTest.instance_variable_set(:@dbclient, Familia.create_dbclient)
@@ -92,7 +95,7 @@ $multi_result.results.class
 #=> Array
 
 ## Test 5: Permissive mode silently falls back
-Familia.configure { |c| c.pipeline_mode = :permissive }
+Familia.configure { |c| c.pipelined_mode = :permissive }
 
 # Cache connection at class level
 PipelineFallbackTest.instance_variable_set(:@dbclient, Familia.create_dbclient)
@@ -111,18 +114,18 @@ $permissive_result.results
 #=> ['OK', 1, '1']
 
 ## Test 6: Pipeline mode configuration validation
-Familia.configure { |c| c.pipeline_mode = :invalid }
+Familia.configure { |c| c.pipelined_mode = :invalid }
 #=:> ArgumentError
 #=~> /Pipeline mode must be :strict, :warn, or :permissive/
 
-## Test 7: Default pipeline_mode is :warn
-Familia.instance_variable_set(:@pipeline_mode, nil)
-Familia.pipeline_mode
+## Test 7: Default pipelined_mode is :warn
+Familia.instance_variable_set(:@pipelined_mode, nil)
+Familia.pipelined_mode
 #=> :warn
 
 ## Cleanup: Restore original values
 Familia.configure do |c|
-  c.pipeline_mode = $original_pipeline_mode
+  c.pipelined_mode = $original_pipelined_mode
   c.transaction_mode = $original_transaction_mode
 end
 PipelineFallbackTest.remove_instance_variable(:@dbclient) if PipelineFallbackTest.instance_variable_defined?(:@dbclient)

data/try/integration/connection/pools_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/pools_try.rb
+#
+# frozen_string_literal: true
+
 # try/pooling/connection_pool_test_try.rb
 
 # USAGE: FAMILIA_TRACE=1 FAMILIA_DEBUG=1 bundle exec tryouts try/pooling/connection_pool_test_try.rb

data/try/integration/connection/responsibility_chain_tracking_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/responsibility_chain_tracking_try.rb
+#
+# frozen_string_literal: true
+
 # ResponsibilityChain Handler Tracking Tryouts
 #
 # Tests that the ResponsibilityChain correctly tracks which handler provided

data/try/integration/connection/transaction_fallback_integration_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/transaction_fallback_integration_try.rb
+#
+# frozen_string_literal: true
+
 # Transaction Fallback Integration Tryouts
 #
 # Tests real-world scenarios where transaction fallback is needed, particularly

data/try/integration/connection/transaction_mode_permissive_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/transaction_mode_permissive_try.rb
+#
+# frozen_string_literal: true
+
 # Transaction Mode: Permissive Tryouts
 #
 # Tests permissive transaction mode behavior where operations silently

data/try/integration/connection/transaction_mode_strict_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/transaction_mode_strict_try.rb
+#
+# frozen_string_literal: true
+
 # Transaction Mode: Strict Tryouts
 #
 # Tests strict transaction mode behavior where operations fail fast

data/try/integration/connection/transaction_mode_warn_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/transaction_mode_warn_try.rb
+#
+# frozen_string_literal: true
+
 # Transaction Mode: Warn Tryouts
 #
 # Tests warn transaction mode behavior where operations log a warning

data/try/integration/connection/transaction_modes_try.rb

@@ -1,3 +1,7 @@
+# try/integration/connection/transaction_modes_try.rb
+#
+# frozen_string_literal: true
+
 # Transaction Modes Tryouts
 #
 # Tests the configurable transaction mode system that provides graceful fallback

data/try/integration/conventional_inheritance_try.rb

@@ -1,3 +1,7 @@
+# try/integration/conventional_inheritance_try.rb
+#
+# frozen_string_literal: true
+
 require_relative '../support/helpers/test_helpers'
 
 # Define test classes in global namespace