RubyGems - familia - Versions diffs - 2.0.0.pre15 → 2.0.0.pre17 - Mend

familia 2.0.0.pre15 → 2.0.0.pre17

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 (288) hide show

checksums.yaml +4 -4
data/.github/workflows/ci.yml +2 -2
data/.github/workflows/code-quality.yml +138 -0
data/.github/workflows/code-smells.yml +85 -0
data/.github/workflows/docs.yml +31 -8
data/.gitignore +3 -1
data/.pre-commit-config.yaml +7 -1
data/.reek.yml +98 -0
data/.rubocop.yml +54 -10
data/.talismanrc +9 -0
data/.yardopts +18 -13
data/CHANGELOG.rst +86 -4
data/CLAUDE.md +39 -1
data/Gemfile +6 -5
data/Gemfile.lock +99 -23
data/LICENSE.txt +1 -1
data/README.md +285 -85
data/changelog.d/README.md +2 -2
data/docs/archive/FAMILIA_RELATIONSHIPS.md +22 -22
data/docs/archive/FAMILIA_TECHNICAL.md +42 -42
data/docs/archive/FAMILIA_UPDATE.md +3 -3
data/docs/archive/README.md +3 -2
data/docs/{guides/API-Reference.md → archive/api-reference.md} +87 -101
data/docs/conf.py +29 -0
data/docs/guides/{Field-System-Guide.md → core-field-system.md} +9 -9
data/docs/guides/feature-encrypted-fields.md +785 -0
data/docs/guides/{Expiration-Feature-Guide.md → feature-expiration.md} +11 -2
data/docs/guides/feature-external-identifiers.md +637 -0
data/docs/guides/feature-object-identifiers.md +435 -0
data/docs/guides/{Quantization-Feature-Guide.md → feature-quantization.md} +94 -29
data/docs/guides/feature-relationships-methods.md +684 -0
data/docs/guides/feature-relationships.md +200 -0
data/docs/guides/{Features-System-Developer-Guide.md → feature-system-devs.md} +4 -4
data/docs/guides/{Feature-System-Guide.md → feature-system.md} +5 -5
data/docs/guides/{Transient-Fields-Guide.md → feature-transient-fields.md} +2 -2
data/docs/guides/{Implementation-Guide.md → implementation.md} +3 -3
data/docs/guides/index.md +176 -0
data/docs/guides/{Security-Model.md → security-model.md} +1 -1
data/docs/migrating/v2.0.0-pre.md +1 -1
data/docs/migrating/v2.0.0-pre11.md +2 -2
data/docs/migrating/v2.0.0-pre12.md +2 -2
data/docs/migrating/v2.0.0-pre5.md +33 -12
data/docs/migrating/v2.0.0-pre6.md +2 -2
data/docs/migrating/v2.0.0-pre7.md +8 -8
data/docs/overview.md +624 -20
data/docs/reference/api-technical.md +1365 -0
data/examples/autoloader/mega_customer/features/deprecated_fields.rb +7 -0
data/examples/autoloader/mega_customer/safe_dump_fields.rb +1 -1
data/examples/autoloader/mega_customer.rb +3 -1
data/examples/encrypted_fields.rb +378 -0
data/examples/json_usage_patterns.rb +144 -0
data/examples/relationships.rb +13 -13
data/examples/safe_dump.rb +7 -7
data/examples/single_connection_transaction_confusions.rb +379 -0
data/lib/familia/base.rb +51 -10
data/lib/familia/connection/handlers.rb +223 -0
data/lib/familia/connection/individual_command_proxy.rb +64 -0
data/lib/familia/connection/middleware.rb +75 -0
data/lib/familia/connection/operation_core.rb +93 -0
data/lib/familia/connection/operations.rb +277 -0
data/lib/familia/connection/pipeline_core.rb +87 -0
data/lib/familia/connection/transaction_core.rb +100 -0
data/lib/familia/connection.rb +60 -186
data/lib/familia/data_type/class_methods.rb +63 -0
data/lib/familia/data_type/commands.rb +53 -51
data/lib/familia/data_type/connection.rb +83 -0
data/lib/familia/data_type/serialization.rb +108 -107
data/lib/familia/data_type/settings.rb +96 -0
data/lib/familia/data_type/types/counter.rb +1 -1
data/lib/familia/data_type/types/hashkey.rb +15 -11
data/lib/familia/data_type/types/{list.rb → listkey.rb} +13 -5
data/lib/familia/data_type/types/lock.rb +3 -2
data/lib/familia/data_type/types/sorted_set.rb +128 -14
data/lib/familia/data_type/types/{string.rb → stringkey.rb} +7 -9
data/lib/familia/data_type/types/unsorted_set.rb +20 -27
data/lib/familia/data_type.rb +12 -171
data/lib/familia/distinguisher.rb +85 -0
data/lib/familia/encryption/encrypted_data.rb +15 -24
data/lib/familia/encryption/manager.rb +6 -4
data/lib/familia/encryption/providers/aes_gcm_provider.rb +1 -1
data/lib/familia/encryption/providers/secure_xchacha20_poly1305_provider.rb +7 -9
data/lib/familia/encryption/providers/xchacha20_poly1305_provider.rb +4 -5
data/lib/familia/encryption/request_cache.rb +7 -7
data/lib/familia/encryption.rb +2 -3
data/lib/familia/errors.rb +9 -3
data/lib/familia/features/autoloader.rb +30 -12
data/lib/familia/features/encrypted_fields/concealed_string.rb +3 -4
data/lib/familia/features/encrypted_fields/encrypted_field_type.rb +13 -14
data/lib/familia/features/encrypted_fields.rb +71 -66
data/lib/familia/features/expiration/extensions.rb +1 -1
data/lib/familia/features/expiration.rb +31 -26
data/lib/familia/features/external_identifier.rb +57 -19
data/lib/familia/features/object_identifier.rb +134 -25
data/lib/familia/features/quantization.rb +16 -21
data/lib/familia/features/relationships/README.md +97 -0
data/lib/familia/features/relationships/collection_operations.rb +104 -0
data/lib/familia/features/relationships/indexing/multi_index_generators.rb +202 -0
data/lib/familia/features/relationships/indexing/unique_index_generators.rb +306 -0
data/lib/familia/features/relationships/indexing.rb +182 -256
data/lib/familia/features/relationships/indexing_relationship.rb +35 -0
data/lib/familia/features/relationships/participation/participant_methods.rb +164 -0
data/lib/familia/features/relationships/participation/target_methods.rb +225 -0
data/lib/familia/features/relationships/participation.rb +656 -0
data/lib/familia/features/relationships/participation_relationship.rb +31 -0
data/lib/familia/features/relationships/score_encoding.rb +20 -20
data/lib/familia/features/relationships.rb +65 -266
data/lib/familia/features/safe_dump.rb +127 -130
data/lib/familia/features/transient_fields/redacted_string.rb +6 -6
data/lib/familia/features/transient_fields/transient_field_type.rb +5 -5
data/lib/familia/features/transient_fields.rb +10 -7
data/lib/familia/features.rb +10 -14
data/lib/familia/field_type.rb +6 -4
data/lib/familia/horreum/connection.rb +297 -0
data/lib/familia/horreum/{core/database_commands.rb → database_commands.rb} +27 -17
data/lib/familia/horreum/{subclass/definition.rb → definition.rb} +139 -74
data/lib/familia/horreum/{subclass/management.rb → management.rb} +73 -27
data/lib/familia/horreum/{core/serialization.rb → persistence.rb} +108 -185
data/lib/familia/horreum/{subclass/related_fields_management.rb → related_fields.rb} +104 -23
data/lib/familia/horreum/serialization.rb +172 -0
data/lib/familia/horreum/{shared/settings.rb → settings.rb} +2 -1
data/lib/familia/horreum/{core/utils.rb → utils.rb} +2 -1
data/lib/familia/horreum.rb +222 -119
data/lib/familia/json_serializer.rb +0 -1
data/lib/familia/logging.rb +11 -114
data/lib/familia/refinements/dear_json.rb +122 -0
data/lib/familia/refinements/logger_trace.rb +20 -17
data/lib/familia/refinements/stylize_words.rb +65 -0
data/lib/familia/refinements/time_literals.rb +60 -52
data/lib/familia/refinements.rb +2 -1
data/lib/familia/secure_identifier.rb +60 -28
data/lib/familia/settings.rb +83 -7
data/lib/familia/utils.rb +5 -87
data/lib/familia/verifiable_identifier.rb +4 -4
data/lib/familia/version.rb +1 -1
data/lib/familia.rb +72 -14
data/lib/middleware/database_middleware.rb +56 -14
data/lib/{familia/multi_result.rb → multi_result.rb} +23 -16
data/try/configuration/scenarios_try.rb +2 -2
data/try/connection/fiber_context_preservation_try.rb +250 -0
data/try/connection/handler_constraints_try.rb +59 -0
data/try/connection/operation_mode_guards_try.rb +208 -0
data/try/connection/pipeline_fallback_integration_try.rb +128 -0
data/try/connection/responsibility_chain_tracking_try.rb +72 -0
data/try/connection/transaction_fallback_integration_try.rb +288 -0
data/try/connection/transaction_mode_permissive_try.rb +153 -0
data/try/connection/transaction_mode_strict_try.rb +98 -0
data/try/connection/transaction_mode_warn_try.rb +131 -0
data/try/connection/transaction_modes_try.rb +249 -0
data/try/core/autoloader_try.rb +120 -2
data/try/core/connection_try.rb +10 -10
data/try/core/conventional_inheritance_try.rb +130 -0
data/try/core/create_method_try.rb +15 -23
data/try/core/database_consistency_try.rb +11 -10
data/try/core/errors_try.rb +11 -14
data/try/core/familia_extended_try.rb +2 -2
data/try/core/familia_members_methods_try.rb +76 -0
data/try/core/familia_try.rb +1 -1
data/try/core/isolated_dbclient_try.rb +165 -0
data/try/core/middleware_try.rb +16 -16
data/try/core/persistence_operations_try.rb +4 -4
data/try/core/pools_try.rb +42 -26
data/try/core/secure_identifier_try.rb +28 -24
data/try/core/time_utils_try.rb +10 -10
data/try/core/tools_try.rb +3 -3
data/try/core/utils_try.rb +2 -2
data/try/data_types/boolean_try.rb +4 -4
data/try/data_types/datatype_base_try.rb +0 -2
data/try/data_types/list_try.rb +10 -10
data/try/data_types/sorted_set_try.rb +5 -5
data/try/data_types/sorted_set_zadd_options_try.rb +625 -0
data/try/data_types/string_try.rb +12 -12
data/try/data_types/unsortedset_try.rb +33 -0
data/try/debugging/cache_behavior_tracer.rb +7 -7
data/try/debugging/debug_aad_process.rb +1 -1
data/try/debugging/debug_concealed_internal.rb +1 -1
data/try/debugging/debug_cross_context.rb +1 -1
data/try/debugging/debug_fresh_cross_context.rb +1 -1
data/try/debugging/encryption_method_tracer.rb +10 -10
data/try/edge_cases/hash_symbolization_try.rb +1 -1
data/try/edge_cases/ttl_side_effects_try.rb +1 -1
data/try/encryption/config_persistence_try.rb +2 -2
data/try/encryption/encryption_core_try.rb +19 -19
data/try/encryption/instance_variable_scope_try.rb +1 -1
data/try/encryption/module_loading_try.rb +2 -2
data/try/encryption/providers/aes_gcm_provider_try.rb +1 -1
data/try/encryption/providers/xchacha20_poly1305_provider_try.rb +1 -1
data/try/encryption/secure_memory_handling_try.rb +1 -1
data/try/features/encrypted_fields/concealed_string_core_try.rb +11 -7
data/try/features/encrypted_fields/encrypted_fields_core_try.rb +1 -1
data/try/features/encrypted_fields/encrypted_fields_integration_try.rb +3 -3
data/try/features/encrypted_fields/encrypted_fields_no_cache_security_try.rb +10 -10
data/try/features/encrypted_fields/encrypted_fields_security_try.rb +14 -14
data/try/features/encrypted_fields/error_conditions_try.rb +7 -7
data/try/features/encrypted_fields/fresh_key_try.rb +1 -1
data/try/features/encrypted_fields/nonce_uniqueness_try.rb +1 -1
data/try/features/encrypted_fields/secure_by_default_behavior_try.rb +7 -7
data/try/features/encrypted_fields/universal_serialization_safety_try.rb +13 -20
data/try/features/external_identifier/external_identifier_try.rb +1 -1
data/try/features/feature_dependencies_try.rb +3 -3
data/try/features/field_groups_try.rb +244 -0
data/try/features/object_identifier/object_identifier_integration_try.rb +28 -34
data/try/features/object_identifier/object_identifier_try.rb +10 -0
data/try/features/quantization/quantization_try.rb +1 -1
data/try/features/relationships/indexing_commands_verification_try.rb +136 -0
data/try/features/relationships/indexing_try.rb +443 -0
data/try/features/relationships/participation_commands_verification_spec.rb +102 -0
data/try/features/relationships/participation_commands_verification_try.rb +105 -0
data/try/features/relationships/participation_performance_improvements_try.rb +124 -0
data/try/features/relationships/participation_reverse_index_try.rb +196 -0
data/try/features/relationships/relationships_api_changes_try.rb +72 -71
data/try/features/relationships/relationships_edge_cases_try.rb +15 -18
data/try/features/relationships/relationships_performance_minimal_try.rb +2 -2
data/try/features/relationships/relationships_performance_simple_try.rb +8 -8
data/try/features/relationships/relationships_performance_try.rb +20 -20
data/try/features/relationships/relationships_try.rb +27 -38
data/try/features/safe_dump/safe_dump_advanced_try.rb +2 -2
data/try/features/transient_fields/refresh_reset_try.rb +3 -1
data/try/features/transient_fields/simple_refresh_test.rb +1 -1
data/try/helpers/test_cleanup.rb +86 -0
data/try/helpers/test_helpers.rb +6 -7
data/try/horreum/auto_indexing_on_save_try.rb +212 -0
data/try/horreum/base_try.rb +3 -2
data/try/horreum/commands_try.rb +3 -1
data/try/horreum/defensive_initialization_try.rb +86 -0
data/try/horreum/destroy_related_fields_cleanup_try.rb +332 -0
data/try/horreum/initialization_try.rb +11 -7
data/try/horreum/relations_try.rb +21 -13
data/try/horreum/serialization_try.rb +12 -11
data/try/horreum/settings_try.rb +2 -0
data/try/integration/cross_component_try.rb +3 -3
data/try/memory/memory_basic_test.rb +1 -1
data/try/memory/memory_docker_ruby_dump.sh +2 -2
data/try/models/customer_safe_dump_try.rb +1 -1
data/try/models/customer_try.rb +13 -15
data/try/models/datatype_base_try.rb +3 -3
data/try/models/familia_object_try.rb +9 -8
data/try/performance/benchmarks_try.rb +2 -2
data/try/prototypes/atomic_saves_v1_context_proxy.rb +2 -2
data/try/prototypes/atomic_saves_v3_connection_pool.rb +3 -3
data/try/prototypes/atomic_saves_v4.rb +1 -1
data/try/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb +4 -4
data/try/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb +4 -4
data/try/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb +4 -4
data/try/prototypes/pooling/lib/connection_pool_metrics.rb +5 -5
data/try/prototypes/pooling/lib/connection_pool_stress_test.rb +26 -26
data/try/prototypes/pooling/lib/connection_pool_threading_models.rb +7 -7
data/try/prototypes/pooling/lib/visualize_stress_results.rb +1 -1
data/try/prototypes/pooling/pool_siege.rb +11 -11
data/try/prototypes/pooling/run_stress_tests.rb +7 -7
data/try/refinements/dear_json_array_methods_try.rb +53 -0
data/try/refinements/dear_json_hash_methods_try.rb +54 -0
data/try/refinements/logger_trace_methods_try.rb +44 -0
data/try/refinements/time_literals_numeric_methods_try.rb +141 -0
data/try/refinements/time_literals_string_methods_try.rb +80 -0
data/try/valkey.conf +26 -0
metadata +92 -52
data/.rubocop_todo.yml +0 -208
data/docs/connection_pooling.md +0 -192
data/docs/guides/Connection-Pooling-Guide.md +0 -437
data/docs/guides/Encrypted-Fields-Overview.md +0 -101
data/docs/guides/Feature-System-Autoloading.md +0 -198
data/docs/guides/Home.md +0 -116
data/docs/guides/Relationships-Guide.md +0 -737
data/docs/guides/relationships-methods.md +0 -266
data/docs/reference/auditing_database_commands.rb +0 -228
data/examples/permissions.rb +0 -240
data/lib/familia/features/relationships/cascading.rb +0 -437
data/lib/familia/features/relationships/membership.rb +0 -497
data/lib/familia/features/relationships/permission_management.rb +0 -264
data/lib/familia/features/relationships/querying.rb +0 -615
data/lib/familia/features/relationships/redis_operations.rb +0 -274
data/lib/familia/features/relationships/tracking.rb +0 -418
data/lib/familia/horreum/core/connection.rb +0 -73
data/lib/familia/horreum/core.rb +0 -21
data/lib/familia/refinements/snake_case.rb +0 -40
data/lib/familia/validation/command_recorder.rb +0 -336
data/lib/familia/validation/expectations.rb +0 -519
data/lib/familia/validation/validation_helpers.rb +0 -443
data/lib/familia/validation/validator.rb +0 -412
data/lib/familia/validation.rb +0 -140
data/try/data_types/set_try.rb +0 -33
data/try/features/relationships/categorical_permissions_try.rb +0 -515
data/try/features/safe_dump/module_based_extensions_try.rb +0 -100
data/try/features/safe_dump/safe_dump_autoloading_try.rb +0 -107
data/try/validation/atomic_operations_try.rb.disabled +0 -320
data/try/validation/command_validation_try.rb.disabled +0 -207
data/try/validation/performance_validation_try.rb.disabled +0 -324
data/try/validation/real_world_scenarios_try.rb.disabled +0 -390

data/docs/migrating/v2.0.0-pre7.md CHANGED Viewed

@@ -46,10 +46,10 @@ class Customer < Familia::Horreum
   feature :relationships
   # Global email index for O(1) lookups
-  indexed_by :email, :email_lookup, context: :global
+  indexed_by :email, :email_lookup, target: :global
   # Domain-specific indexes
-  indexed_by :account_id, :account_lookup, context: Domain
+  indexed_by :account_id, :account_lookup, target: Domain
 end
 ```
@@ -59,7 +59,7 @@ class Domain < Familia::Horreum
   feature :relationships
   # Belongs to customer's domains collection
-  member_of Customer, :domains, type: :set
+  participates_in Customer, :domains, type: :set
 end
 ```
@@ -86,7 +86,7 @@ end
 ### 4. Update Queries
-**Before (manual Redis operations):**
+**Before (manual db operations):**
 ```ruby
 # Manual sorted set operations
 redis.zadd("all_customers", customer.created_at, customer.custid)
@@ -144,7 +144,7 @@ admin_permissions = ADMIN        # All permissions via hierarchy
 ### Time-Based Permission Scores
 ```ruby
 # Encode timestamp with permission bits
-timestamp = Time.now.to_i
+timestamp = Familia.now.to_i
 permissions = READ | WRITE
 score = Familia::Features::Relationships::ScoreEncoding.encode_score(timestamp, permissions)
@@ -172,7 +172,7 @@ documents_with_write_access = customer.documents.accessible_items(
 **Use `member_of` for:**
 - Simple membership tracking
 - Bidirectional relationships
-- Set-based collections
+- UnsortedSet-based collections
 ### Optimization Tips
@@ -199,7 +199,7 @@ accessible_docs = document.accessible_items(
 ### Method Name Changes
 - Relationship methods follow new naming patterns
-- Previous manual Redis operations need updating
+- Previous manual db operations need updating
 - Collection access methods standardized
 ### Permission System
@@ -209,7 +209,7 @@ accessible_docs = document.accessible_items(
 ## Next Steps
-1. **Analyze Existing Relationships:** Review current Redis operations for optimization opportunities
+1. **Analyze Existing Relationships:** Review current db operations for optimization opportunities
 2. **Choose Relationship Types:** Select appropriate types based on usage patterns
 3. **Implement Permissions:** Add access control where needed
 4. **Update Queries:** Replace manual operations with generated relationship methods