familia 2.0.0.pre7 → 2.0.0.pre8

data/try/features/object_identifiers/object_identifiers_integration_try.rb

@@ -0,0 +1,289 @@
+# try/features/object_identifiers_integration_try.rb
+
+require_relative '../../helpers/test_helpers'
+
+Familia.debug = false
+
+# Integration test for ObjectIdentifiers and ExternalIdentifiers features together
+
+# Class using both features with defaults
+class IntegrationTest < Familia::Horreum
+  feature :object_identifiers
+  feature :external_identifiers  # This depends on :object_identifiers
+  identifier_field :id
+  field :id
+  field :name
+  field :email
+end
+
+# Class with custom configurations for both features
+class CustomIntegrationTest < Familia::Horreum
+  feature :object_identifiers, generator: :hex
+  feature :external_identifiers, prefix: 'custom'
+  identifier_field :id
+  field :id
+  field :name
+end
+
+# Class testing full lifecycle with Redis persistence
+class PersistenceTest < Familia::Horreum
+  feature :object_identifiers
+  feature :external_identifiers
+  identifier_field :id
+  field :id
+  field :name
+  field :created_at
+end
+
+# Setup test objects
+@integration_obj = IntegrationTest.new(id: 'integration_1', name: 'Integration Test', email: 'test@example.com')
+@custom_obj = CustomIntegrationTest.new(id: 'custom_1', name: 'Custom Test')
+
+## Object identifiers feature is automatically included
+IntegrationTest.features_enabled.include?(:object_identifiers)
+#==> true
+
+## External identifiers feature is included
+IntegrationTest.features_enabled.include?(:external_identifiers)
+#==> true
+
+## Object responds to objid accessor
+obj = IntegrationTest.new
+obj.respond_to?(:objid)
+#==> true
+
+## Object responds to extid accessor
+obj = IntegrationTest.new
+obj.respond_to?(:extid)
+#==> true
+
+## Class responds to find_by_objid method
+IntegrationTest.respond_to?(:find_by_objid)
+#==> true
+
+## Class responds to find_by_extid method
+IntegrationTest.respond_to?(:find_by_extid)
+#==> true
+
+## objid and extid are different values
+obj = IntegrationTest.new
+obj.objid != obj.extid
+#==> true
+
+## extid is deterministically generated from objid
+obj = IntegrationTest.new
+original_objid = obj.objid
+original_extid = obj.extid
+# Create new object with same objid
+obj2 = IntegrationTest.new
+obj2.instance_variable_set(:@objid, original_objid)
+obj2.extid == original_extid
+#==> true
+
+## Custom objid uses hex format (64 chars for 256-bit)
+@custom_obj.objid.match(/\A[0-9a-f]{64}\z/)
+#=*> nil
+
+## Custom extid uses custom prefix
+@custom_obj.extid.start_with?('custom_')
+#==> true
+
+## Both IDs persist through save/load cycle
+persistence_obj = PersistenceTest.new
+persistence_obj.id = 'persistence_test'
+persistence_obj.name = 'Persistence Test Object'
+persistence_obj.created_at = Time.now.to_i
+original_objid = persistence_obj.objid
+original_extid = persistence_obj.extid
+persistence_obj.save
+
+# Load from Redis
+loaded_obj = PersistenceTest.new(id: 'persistence_test')
+
+## objid persists after save/load
+persistence_obj = PersistenceTest.new
+persistence_obj.id = 'persistence_test'
+persistence_obj.name = 'Persistence Test Object'
+persistence_obj.created_at = Time.now.to_i
+original_objid = persistence_obj.objid
+persistence_obj.save
+loaded_obj = PersistenceTest.new(id: 'persistence_test')
+loaded_obj.objid == original_objid
+#==> true
+
+## extid persists after save/load
+persistence_obj = PersistenceTest.new
+persistence_obj.id = 'persistence_test'
+persistence_obj.name = 'Persistence Test Object'
+persistence_obj.created_at = Time.now.to_i
+original_extid = persistence_obj.extid
+persistence_obj.save
+loaded_obj = PersistenceTest.new(id: 'persistence_test')
+loaded_obj.extid == original_extid
+#==> true
+
+## objid instance variable starts nil (lazy generation)
+lazy_obj = IntegrationTest.new
+lazy_obj.instance_variable_get(:@objid)
+#=> nil
+
+## extid instance variable starts nil (lazy generation)
+lazy_obj = IntegrationTest.new
+lazy_obj.instance_variable_get(:@extid)
+#=> nil
+
+## Accessing objid first doesn't trigger extid generation
+lazy_obj = IntegrationTest.new
+lazy_obj.objid
+lazy_obj.instance_variable_get(:@extid)
+#=> nil
+
+## Accessing extid triggers objid generation if needed
+lazy_obj2 = IntegrationTest.new
+lazy_obj2.extid  # This should trigger objid generation too
+lazy_obj2.instance_variable_get(:@objid)
+#=*> nil
+
+## Check field types objid
+IntegrationTest.field_types[:objid].is_a?(Familia::Features::ObjectIdentifiers::ObjectIdentifierFieldType)
+#==> true
+
+## ObjectIdentifier fields have correct types in field registry
+IntegrationTest.field_types[:objid].class.ancestors.include?(Familia::Features::ObjectIdentifiers::ObjectIdentifierFieldType)
+#==> true
+
+## ExternalIdentifier fields have correct types in field registry
+IntegrationTest.field_types[:extid].class.ancestors.include?(Familia::Features::ExternalIdentifiers::ExternalIdentifierFieldType)
+#==> true
+
+## Object identifiers options are preserved
+opts = IntegrationTest.feature_options
+opts.key?(:object_identifiers)
+#==> true
+
+## External identifiers options are preserved
+opts = IntegrationTest.feature_options
+opts.key?(:external_identifiers)
+#==> true
+
+## Generator default configuration is applied correctly
+IntegrationTest.feature_options(:object_identifiers)[:generator]
+#=> :uuid_v7
+
+## Prefix default configuration is applied correctly
+IntegrationTest.feature_options(:external_identifiers)[:prefix]
+#=> "ext"
+
+## Custom generator configuration is applied correctly
+CustomIntegrationTest.feature_options(:object_identifiers)[:generator]
+#=> :hex
+
+## Custom prefix configuration is applied correctly
+CustomIntegrationTest.feature_options(:external_identifiers)[:prefix]
+#=> "custom"
+
+## objid is URL-safe (UUID format)
+obj = IntegrationTest.new
+obj.objid.match(/\A[A-Za-z0-9\-]+\z/)
+#=*> nil
+
+## extid is URL-safe (base36 format)
+obj = IntegrationTest.new
+obj.extid.match(/\A[a-z0-9_]+\z/)
+#=*> nil
+
+## Data integrity preserved during complex initialization
+complex_obj = IntegrationTest.new(
+  id: 'complex_integration',
+  name: 'Complex Integration',
+  email: 'complex@test.com',
+  objid: 'preset_objid_123',
+  extid: 'preset_ext_456'
+)
+
+## Preset objid value is preserved
+complex_obj = IntegrationTest.new(
+  id: 'complex_integration',
+  name: 'Complex Integration',
+  email: 'complex@test.com',
+  objid: 'preset_objid_123',
+  extid: 'preset_ext_456'
+)
+complex_obj.objid
+#=> 'preset_objid_123'
+
+## Preset extid value is preserved
+complex_obj = IntegrationTest.new(
+  id: 'complex_integration',
+  name: 'Complex Integration',
+  email: 'complex@test.com',
+  objid: 'preset_objid_123',
+  extid: 'preset_ext_456'
+)
+complex_obj.extid
+#=> 'preset_ext_456'
+
+## find_by methods are available (stub implementations)
+search_obj = IntegrationTest.new
+search_obj.id = 'search_test'
+search_obj.save
+
+## find_by_objid returns nil (stub implementation)
+search_obj = IntegrationTest.new
+search_obj.id = 'search_test'
+search_obj.save
+found_by_objid = IntegrationTest.find_by_objid(search_obj.objid)
+found_by_objid
+#=> nil
+
+## find_by_extid works with real implementation
+@search_obj = IntegrationTest.new
+@search_obj.id = 'search_test'
+@search_obj.save
+found_by_extid = IntegrationTest.find_by_extid(@search_obj.extid)
+found_by_extid&.id
+#=> "search_test"
+
+## Both IDs remain stable across multiple accesses
+stability_obj = IntegrationTest.new
+first_objid = stability_obj.objid
+first_extid = stability_obj.extid
+second_objid = stability_obj.objid
+second_extid = stability_obj.extid
+
+## objid remains stable across accesses
+stability_obj = IntegrationTest.new
+first_objid = stability_obj.objid
+second_objid = stability_obj.objid
+first_objid == second_objid
+#==> true
+
+## extid remains stable across accesses
+stability_obj = IntegrationTest.new
+first_extid = stability_obj.extid
+second_extid = stability_obj.extid
+first_extid == second_extid
+#==> true
+
+## Feature dependency is enforced (external_identifiers requires object_identifiers)
+# This is automatically handled by the feature system
+IntegrationTest.features_enabled.include?(:object_identifiers)
+#==> true
+
+## Objects work with existing Horreum save pattern
+obj = IntegrationTest.new
+obj.respond_to?(:save)
+#==> true
+
+## Objects work with existing Horreum exists pattern
+obj = IntegrationTest.new
+obj.respond_to?(:exists?)
+#==> true
+
+## Objects work with existing Horreum delete pattern
+obj = IntegrationTest.new
+obj.respond_to?(:delete!)
+#==> true
+
+# Cleanup test objects
+@search_obj.destroy! rescue nil

data/try/features/object_identifiers/object_identifiers_try.rb

@@ -0,0 +1,191 @@
+# try/features/object_identifiers_try.rb
+
+require_relative '../../helpers/test_helpers'
+
+Familia.debug = false
+
+# Test ObjectIdentifiers feature functionality
+
+# Basic class using default UUID v7 generator
+class BasicObjectTest < Familia::Horreum
+  feature :object_identifiers
+  identifier_field :id
+  field :id
+  field :name
+end
+
+# Class using UUID v4 generator
+class UuidV4Test < Familia::Horreum
+  feature :object_identifiers, generator: :uuid_v4
+  identifier_field :id
+  field :id
+  field :name
+end
+
+# Class using hex generator
+class HexTest < Familia::Horreum
+  feature :object_identifiers, generator: :hex
+  identifier_field :id
+  field :id
+  field :name
+end
+
+# Class using custom proc generator
+class CustomProcTest < Familia::Horreum
+  feature :object_identifiers, generator: -> { "custom_#{SecureRandom.hex(4)}" }
+  identifier_field :id
+  field :id
+  field :name
+end
+
+# Class testing data integrity preservation
+class DataIntegrityTest < Familia::Horreum
+  feature :object_identifiers
+  identifier_field :id
+  field :id
+  field :name
+end
+
+# Test with existing object ID during initialization
+@existing_obj = DataIntegrityTest.new(id: 'test_id', objid: 'preset_id_123', name: 'Preset Object')
+
+## Feature is available on class
+BasicObjectTest.features_enabled.include?(:object_identifiers)
+#==> true
+
+## Class has objid field defined
+BasicObjectTest.respond_to?(:objid)
+#==> true
+
+## Object has objid accessor
+obj = BasicObjectTest.new
+obj.respond_to?(:objid)
+#==> true
+
+## Default generator creates UUID v7 format
+obj = BasicObjectTest.new
+obj.name = 'Test Object'
+objid = obj.objid
+objid.is_a?(String) && objid.length == 36 && objid.include?('-')
+#==> true
+
+## UUID v7 objid has correct format (8-4-4-4-12 characters)
+obj = BasicObjectTest.new
+obj.objid.match(/\A[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\z/)
+#=*> nil
+
+## UUID v4 generator creates correct format
+v4_obj = UuidV4Test.new
+v4_objid = v4_obj.objid
+v4_objid.match(/\A[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\z/)
+#=*> nil
+
+## Hex generator creates hex string
+hex_obj = HexTest.new
+hex_objid = hex_obj.objid
+hex_objid.is_a?(String) && hex_objid.length == 16 && hex_objid.match(/\A[0-9a-f]+\z/)
+#==> true
+
+## Custom proc generator works
+custom_obj = CustomProcTest.new
+custom_objid = custom_obj.objid
+custom_objid.start_with?('custom_') && custom_objid.length == 15
+#==> true
+
+## objid is lazy - not generated until accessed
+lazy_obj = BasicObjectTest.new
+lazy_obj.instance_variable_get(:@objid)
+#=> nil
+
+## objid is generated when first accessed
+lazy_obj = BasicObjectTest.new
+lazy_obj.objid
+lazy_obj
+#=*> _.instance_variable_get(:@objid)
+
+## objid is generated when first accessed (alternatve testcase expectation)
+lazy_obj = BasicObjectTest.new
+lazy_obj.objid
+lazy_obj.instance_variable_get(:@objid)
+#=<> nil
+
+## objid value is stable across multiple calls
+lazy_obj = BasicObjectTest.new
+first_call = lazy_obj.objid
+second_call = lazy_obj.objid
+first_call == second_call
+#==> true
+
+## Data integrity: preset objid is preserved
+@existing_obj.objid
+#=> "preset_id_123"
+
+## Data integrity: preset objid not regenerated
+@existing_obj.instance_variable_get(:@objid)
+#=> "preset_id_123"
+
+## find_by_objid class method exists
+BasicObjectTest.respond_to?(:find_by_objid)
+#==> true
+
+## find_by_objid returns correct type (stub for now)
+BasicObjectTest.find_by_objid('nonexistent')
+#=> nil
+
+## Generated objid is URL-safe (no special chars except hyphens)
+url_obj = BasicObjectTest.new
+objid = url_obj.objid
+objid
+#=*> _.match(/\A[A-Za-z0-9\-]+\z/)
+
+## Different objects get different objids
+obj1 = BasicObjectTest.new
+obj2 = BasicObjectTest.new
+obj1.objid != obj2.objid
+#==> true
+
+## objid persists through save/load cycle
+save_obj = BasicObjectTest.new
+save_obj.id = 'save_test'
+save_obj.name = 'Save Test'
+original_objid = save_obj.objid
+save_obj.save
+loaded_obj = BasicObjectTest.new(id: 'save_test')
+loaded_obj.objid == original_objid
+#==> true
+
+## Class with different generator has different objid pattern
+basic_obj = BasicObjectTest.new
+hex_obj = HexTest.new
+basic_obj.objid.include?('-') && !hex_obj.objid.include?('-')
+#==> true
+
+## objid field type is ObjectIdentifierFieldType
+BasicObjectTest.field_types[:objid]
+#=:> Familia::Features::ObjectIdentifiers::ObjectIdentifierFieldType
+
+## Generator configuration is accessible through feature options
+BasicObjectTest.feature_options(:object_identifiers)[:generator]
+#=> :uuid_v7
+
+## UUID v4 class has correct generator configured
+UuidV4Test.feature_options(:object_identifiers)[:generator]
+#=> :uuid_v4
+
+## Hex class has correct generator configured
+HexTest.feature_options(:object_identifiers)[:generator]
+#=> :hex
+
+## Custom proc class has proc generator
+CustomProcTest.feature_options(:object_identifiers)[:generator]
+#=:> Proc
+
+## Empty initialization preserves nil objid for lazy generation
+empty_obj = BasicObjectTest.new
+empty_obj.instance_variable_get(:@objid)
+#=> nil
+
+## Objid generation works with complex initialization
+complex_obj = BasicObjectTest.new(id: 'complex', name: 'Complex Object')
+complex_obj
+#=*> _.objid

data/try/features/{quantization_try.rb → quantization/quantization_try.rb}

@@ -1,6 +1,6 @@
 # try/features/quantization_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 Familia.debug = false
 

data/try/features/{categorical_permissions_try.rb → relationships/categorical_permissions_try.rb}

@@ -4,7 +4,7 @@
 # Validates the implementation of categorical permission management with
 # two-stage filtering pattern for efficient permission-based queries.
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 # Categorical Permission System Setup
 

data/try/features/{relationships_edge_cases_try.rb → relationships/relationships_edge_cases_try.rb}

@@ -1,6 +1,6 @@
 # Simplified edge case testing for Relationships v2 - focusing on core functionality
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 # Test classes for edge case testing
 class EdgeTestCustomer < Familia::Horreum

data/try/features/{relationships_performance_minimal_try.rb → relationships/relationships_performance_minimal_try.rb}

@@ -1,6 +1,6 @@
 # Minimal performance testing focusing on core Familia functionality
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 require 'benchmark'
 
 # Simple test classes without relationships feature

data/try/features/{relationships_performance_simple_try.rb → relationships/relationships_performance_simple_try.rb}

@@ -2,7 +2,7 @@
 #
 # Simplified performance testing for the Relationships feature
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 require 'benchmark'
 
 # Test classes for performance testing

data/try/features/{relationships_performance_try.rb → relationships/relationships_performance_try.rb}

@@ -2,7 +2,7 @@
 #
 # Performance and integration testing for the Relationships feature
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 require 'benchmark'
 
 # Test classes for performance testing

data/try/features/{relationships_performance_working_try.rb → relationships/relationships_performance_working_try.rb}

@@ -2,7 +2,7 @@
 #
 # Working performance test focusing on basic functionality
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 require 'benchmark'
 
 # Simple test class using only basic Familia features

data/try/features/{relationships_try.rb → relationships/relationships_try.rb}

@@ -2,7 +2,7 @@
 #
 # Simplified Familia v2 relationship functionality tests - focusing on core working features
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 # Test classes for Familia v2 relationship functionality
 class TestCustomer < Familia::Horreum

data/try/features/{safe_dump_advanced_try.rb → safe_dump/safe_dump_advanced_try.rb}

@@ -2,7 +2,7 @@
 
 # These tryouts test the safe dumping functionality.
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 ## By default Familia::Base has no safe_dump_fields method
 Familia::Base.respond_to?(:safe_dump_fields)

data/try/features/{safe_dump_try.rb → safe_dump/safe_dump_try.rb}

@@ -1,6 +1,6 @@
 # try/features/safe_dump_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 Familia.debug = false
 

data/try/features/{transient_fields_core_try.rb → transient_fields/transient_fields_core_try.rb}

@@ -1,6 +1,6 @@
 # try/features/transient_fields_core_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 class SecretService < Familia::Horreum
   feature :transient_fields

data/try/features/{transient_fields_integration_try.rb → transient_fields/transient_fields_integration_try.rb}

@@ -1,6 +1,6 @@
 # try/features/transient_fields_integration_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../helpers/test_helpers'
 
 class SecretService < Familia::Horreum
   feature :transient_fields