familia 2.0.0.pre10 → 2.0.0.pre13

data/try/helpers/test_helpers.rb

@@ -12,6 +12,8 @@ Familia.enable_database_logging = true
 Familia.enable_database_counter = true
 
 class Bone < Familia::Horreum
+  using Familia::Refinements::TimeUtils
+
   identifier_field :token
   field     :token
   field     :name
@@ -33,7 +35,15 @@ class Blone < Familia::Horreum
   string    :value, default: 'GREAT!'
 end
 
+class Bourne < Familia::Horreum
+  feature :object_identifier
+  feature :external_identifier
+end
+
 class Customer < Familia::Horreum
+
+  using Familia::Refinements::TimeUtils
+
   logical_database 15 # Use something other than the default DB
   default_expiration 5.years
 
@@ -41,24 +51,19 @@ class Customer < Familia::Horreum
   # feature :expiration
   # feature :api_version
 
-  # NOTE: The SafeDump mixin caches the safe_dump_field_map so updating this list
-  # with hot reloading in dev mode will not work. You will need to restart the
-  # server to see the changes.
-  @safe_dump_fields = [
-    :custid,
-    :role,
-    :verified,
-    :updated,
-    :created,
-
-    # NOTE: The secrets_created incrementer is null until the first secret
-    # is created. See CreateSecret for where the incrementer is called.
-    #
-    { secrets_created: ->(cust) { cust.secrets_created.value || 0 } },
+  # Use new SafeDump DSL instead of @safe_dump_fields
+  safe_dump_field :custid
+  safe_dump_field :role
+  safe_dump_field :verified
+  safe_dump_field :updated
+  safe_dump_field :created
 
-    # We use the hash syntax here since `:active?` is not a valid symbol.
-    { active: ->(cust) { cust.active? } }
-  ]
+  # NOTE: The secrets_created incrementer is null until the first secret
+  # is created. See CreateSecret for where the incrementer is called.
+  safe_dump_field :secrets_created, ->(cust) { cust.secrets_created.value || 0 }
+
+  # We use a callable here since `:active?` is not a valid method symbol.
+  safe_dump_field :active, ->(cust) { cust.active? }
 
   class_sorted_set :values, key: 'onetime:customer'
   class_hashkey :domains
@@ -101,6 +106,8 @@ end
 @c.custid = 'd@example.com'
 
 class Session < Familia::Horreum
+  using Familia::Refinements::TimeUtils
+
   logical_database 14 # don't use Onetime's default DB
   default_expiration 180.minutes
 
@@ -123,6 +130,8 @@ end
 @s = Session.new
 
 class CustomDomain < Familia::Horreum
+  using Familia::Refinements::TimeUtils
+
   feature :expiration
 
   class_sorted_set :values
@@ -152,6 +161,8 @@ end
 @d.custid = @c.custid
 
 class Limiter < Familia::Horreum
+  using Familia::Refinements::TimeUtils
+
   feature :expiration
   feature :quantization
 
@@ -229,3 +240,16 @@ module ConcealedStringTestHelper
     end
   end
 end
+
+# Helper module for testing refinements in tryouts
+module RefinedContext
+  using Familia::Refinements::TimeUtils
+
+  def self.eval_in_refined_context(code)
+    eval(code)
+  end
+
+  def self.instance_eval_in_refined_context(code)
+    instance_eval(code)
+  end
+end

data/try/integration/cross_component_try.rb

@@ -2,7 +2,9 @@
 
 require_relative '../helpers/test_helpers'
 
-TestUser = Class.new(Familia::Horreum) do
+class TestUser < Familia::Horreum
+  using Familia::Refinements::SnakeCase
+
   identifier_field :email
   field :email
   field :name

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: familia
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre10
+  version: 2.0.0.pre13
 platform: ruby
 authors:
 - Delano Mandelbaum
@@ -15,56 +15,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: connection_pool
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '2.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: csv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
 - !ruby/object:Gem::Dependency
   name: redis
   requirement: !ruby/object:Gem::Requirement
@@ -129,7 +143,7 @@ files:
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - ".yardopts"
-- CHANGELOG.md
+- CHANGELOG.rst
 - CLAUDE.md
 - Gemfile
 - Gemfile.lock
@@ -137,8 +151,7 @@ files:
 - README.md
 - bin/irb
 - changelog.d/README.md
-- changelog.d/fragments/.keep
-- changelog.d/template.md.j2
+- changelog.d/scriv.ini
 - docs/archive/.gitignore
 - docs/archive/FAMILIA_RELATIONSHIPS.md
 - docs/archive/FAMILIA_TECHNICAL.md
@@ -150,6 +163,7 @@ files:
 - docs/guides/Connection-Pooling-Guide.md
 - docs/guides/Encrypted-Fields-Overview.md
 - docs/guides/Expiration-Feature-Guide.md
+- docs/guides/Feature-System-Autoloading.md
 - docs/guides/Feature-System-Guide.md
 - docs/guides/Features-System-Developer-Guide.md
 - docs/guides/Field-System-Guide.md
@@ -160,15 +174,27 @@ files:
 - docs/guides/Security-Model.md
 - docs/guides/Transient-Fields-Guide.md
 - docs/guides/relationships-methods.md
+- docs/guides/time-utilities.md
+- docs/migrating/.gitignore
+- docs/migrating/v2.0.0-pre.md
+- docs/migrating/v2.0.0-pre11.md
+- docs/migrating/v2.0.0-pre12.md
+- docs/migrating/v2.0.0-pre13.md
+- docs/migrating/v2.0.0-pre5.md
+- docs/migrating/v2.0.0-pre6.md
+- docs/migrating/v2.0.0-pre7.md
 - docs/overview.md
-- examples/bit_encoding_integration.rb
-- examples/redis_command_validation_example.rb
-- examples/relationships_basic.rb
+- docs/reference/auditing_database_commands.rb
+- examples/autoloader/mega_customer.rb
+- examples/autoloader/mega_customer/safe_dump_fields.rb
+- examples/permissions.rb
+- examples/relationships.rb
+- examples/safe_dump.rb
 - familia.gemspec
 - lib/familia.rb
+- lib/familia/autoloader.rb
 - lib/familia/base.rb
 - lib/familia/connection.rb
-- lib/familia/core_ext.rb
 - lib/familia/data_type.rb
 - lib/familia/data_type/commands.rb
 - lib/familia/data_type/serialization.rb
@@ -187,17 +213,16 @@ files:
 - lib/familia/encryption/providers/secure_xchacha20_poly1305_provider.rb
 - lib/familia/encryption/providers/xchacha20_poly1305_provider.rb
 - lib/familia/encryption/registry.rb
-- lib/familia/encryption_request_cache.rb
+- lib/familia/encryption/request_cache.rb
 - lib/familia/errors.rb
 - lib/familia/features.rb
+- lib/familia/features/autoloadable.rb
 - lib/familia/features/encrypted_fields.rb
 - lib/familia/features/encrypted_fields/concealed_string.rb
 - lib/familia/features/encrypted_fields/encrypted_field_type.rb
 - lib/familia/features/expiration.rb
-- lib/familia/features/external_identifiers.rb
-- lib/familia/features/external_identifiers/external_identifier_field_type.rb
-- lib/familia/features/object_identifiers.rb
-- lib/familia/features/object_identifiers/object_identifier_field_type.rb
+- lib/familia/features/external_identifier.rb
+- lib/familia/features/object_identifier.rb
 - lib/familia/features/quantization.rb
 - lib/familia/features/relationships.rb
 - lib/familia/features/relationships/cascading.rb
@@ -224,21 +249,26 @@ files:
 - lib/familia/horreum/subclass/definition.rb
 - lib/familia/horreum/subclass/management.rb
 - lib/familia/horreum/subclass/related_fields_management.rb
+- lib/familia/json_serializer.rb
 - lib/familia/logging.rb
 - lib/familia/multi_result.rb
 - lib/familia/refinements.rb
+- lib/familia/refinements/logger_trace.rb
+- lib/familia/refinements/snake_case.rb
+- lib/familia/refinements/time_utils.rb
 - lib/familia/secure_identifier.rb
 - lib/familia/settings.rb
 - lib/familia/utils.rb
 - lib/familia/validation.rb
 - lib/familia/validation/command_recorder.rb
 - lib/familia/validation/expectations.rb
-- lib/familia/validation/test_helpers.rb
+- lib/familia/validation/validation_helpers.rb
 - lib/familia/validation/validator.rb
+- lib/familia/verifiable_identifier.rb
 - lib/familia/version.rb
 - lib/middleware/database_middleware.rb
-- setup.cfg
 - try/configuration/scenarios_try.rb
+- try/core/autoloader_try.rb
 - try/core/base_enhancements_try.rb
 - try/core/connection_try.rb
 - try/core/create_method_try.rb
@@ -252,8 +282,10 @@ files:
 - try/core/pools_try.rb
 - try/core/secure_identifier_try.rb
 - try/core/settings_try.rb
+- try/core/time_utils_try.rb
 - try/core/tools_try.rb
 - try/core/utils_try.rb
+- try/core/verifiable_identifier_try.rb
 - try/data_types/boolean_try.rb
 - try/data_types/counter_try.rb
 - try/data_types/datatype_base_try.rb
@@ -303,6 +335,7 @@ files:
 - try/encryption/providers/xchacha20_poly1305_provider_try.rb
 - try/encryption/roundtrip_validation_try.rb
 - try/encryption/secure_memory_handling_try.rb
+- try/features/autoloadable/autoloadable_try.rb
 - try/features/encrypted_fields/aad_protection_try.rb
 - try/features/encrypted_fields/concealed_string_core_try.rb
 - try/features/encrypted_fields/context_isolation_try.rb
@@ -321,10 +354,11 @@ files:
 - try/features/encrypted_fields/thread_safety_try.rb
 - try/features/encrypted_fields/universal_serialization_safety_try.rb
 - try/features/expiration/expiration_try.rb
-- try/features/external_identifiers/external_identifiers_try.rb
+- try/features/external_identifier/external_identifier_try.rb
 - try/features/feature_dependencies_try.rb
-- try/features/object_identifiers/object_identifiers_integration_try.rb
-- try/features/object_identifiers/object_identifiers_try.rb
+- try/features/feature_improvements_try.rb
+- try/features/object_identifier/object_identifier_integration_try.rb
+- try/features/object_identifier/object_identifier_try.rb
 - try/features/quantization/quantization_try.rb
 - try/features/real_feature_integration_try.rb
 - try/features/relationships/categorical_permissions_try.rb
@@ -336,6 +370,7 @@ files:
 - try/features/relationships/relationships_performance_working_try.rb
 - try/features/relationships/relationships_try.rb
 - try/features/safe_dump/safe_dump_advanced_try.rb
+- try/features/safe_dump/safe_dump_autoloading_try.rb
 - try/features/safe_dump/safe_dump_try.rb
 - try/features/transient_fields/redacted_string_try.rb
 - try/features/transient_fields/refresh_reset_try.rb

data/CHANGELOG.md

@@ -1,184 +0,0 @@
-# CHANGELOG.md
-
-All notable changes to Familia are documented here.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-<!--scriv-insert-here-->
-
-<a id='changelog-2.0.0-pre10'></a>
-## [2.0.0-pre10] - 2025-09-02 18:07:56.439890
-
-### Added
-
-- The `Familia::Horreum` initializer now supports creating an object directly from its identifier by passing a single argument (e.g., `Customer.new(customer_id)`). This provides a more convenient and intuitive way to instantiate objects from lookups.
-
-- Automatic indexing and class-level tracking on `save()` operations, eliminating the need for manual index updates.
-- Enhanced collection syntax supports the Ruby-idiomatic `<<` operator for more natural relationship management.
-
-### Changed
-
-- The `member_of` relationship is now bidirectional. A single call to `member.add_to_owner_collection(owner)` is sufficient to establish the relationship, removing the need for a second, redundant call on the owner object. This fixes bugs where members could be added to collections twice.
-
-- **BREAKING**: Refactored Familia Relationships API to remove "global" terminology and simplify method generation. (Closes #86)
-- Split `generate_indexing_instance_methods` into focused `generate_direct_index_methods` and `generate_relationship_index_methods` for better separation between direct class-level and relationship-based indexing.
-- Simplified method generation by removing complex global vs parent conditionals.
-- All indexes are now stored at the class level for consistency.
-
-### Fixed
-
-- Fixed a bug in the `class_indexed_by` feature where finder methods (e.g., `find_by_email`) would fail to correctly instantiate objects from the index, returning partially-formed objects.
-
-- Refactored connection handling to properly cache and reuse Redis connections. This eliminates repetitive "Overriding existing connection" warnings and improves performance.
-
-- Method generation now works consistently for both `class_indexed_by` and `indexed_by` with a `parent:`.
-- Resolved metadata storage issues for dynamically created classes.
-- Improved error handling for nil class names in tracking relationships.
-
-### Documentation
-
-- Updated the `examples/relationships_basic.rb` script to reflect the improved, bidirectional `member_of` API and to ensure a clean database state for each run.
-
-### AI Assistance
-
-- This refactoring was implemented with Claude Code assistance, including comprehensive test updates and API modernization.
-
-<a id='changelog-2.0.0-pre9'></a>
-# [2.0.0-pre9] - 2025-09-02 00:35:28.974817
-
-## Added
-
-- Added `class_tracked_in` method for global tracking relationships following Horreum's established `class_` prefix convention
-- Added `class_indexed_by` method for global index relationships with consistent API design
-
-## Changed
-
-- **BREAKING**: `tracked_in :global, collection` syntax now raises ArgumentError - use `class_tracked_in collection` instead
-- **BREAKING**: `indexed_by field, index, context: :global` syntax replaced with `class_indexed_by field, index`
-- **BREAKING**: `indexed_by field, index, context: SomeClass` syntax replaced with `indexed_by field, index, parent: SomeClass`
-- Relationships API now provides consistent parameter naming across all relationship types
-
-## Documentation
-
-- Updated Relationships Guide with new API syntax and migration examples
-- Updated relationships method documentation with new method signatures
-- Updated basic relationships example to demonstrate new API patterns
-- Added tryouts test coverage in try/features/relationships/relationships_api_changes_try.rb
-
-
-<a id='changelog-2.0.0-pre8'></a>
-## [2.0.0-pre8] - 2025-09-01
-
-#### Added
-
-- Implemented Scriv-based changelog system for sustainable documentation
-- Added fragment-based workflow for tracking changes
-- Created structured changelog templates and configuration
-
-### Documentation
-
-- Set up Scriv configuration and directory structure
-- Created README for changelog fragment workflow
-
-
-<a id='changelog-2.0.0-pre7'></a>
-## [2.0.0-pre7] - 2025-08-31
-
-### Added
-
-- Comprehensive relationships system with three relationship types:
-  - `tracked_in` - Multi-presence tracking with score encoding
-  - `indexed_by` - O(1) hash-based lookups
-  - `member_of` - Bidirectional membership with collision-free naming
-- Categorical permission system with bit-encoded permissions
-- Time-based permission scoring for temporal access control
-- Permission tier hierarchies with inheritance patterns
-- Scalable permission management for large object collections
-- Score-based sorting with custom scoring functions
-- Permission-aware queries filtering by access levels
-- Relationship validation framework ensuring data integrity
-
-### Changed
-
-- Performance optimizations for large-scale relationship operations
-
-### Security
-
-- GitHub Actions security hardening with matrix optimization
-
-
-<a id='changelog-2.0.0-pre6'></a>
-## [2.0.0-pre6] - 2025-08-15
-
-### Added
-
-- New `save_if_not_exists` method for conditional persistence
-- Atomic persistence operations with transaction support
-- Enhanced error handling for persistence failures
-- Improved data consistency guarantees
-
-### Changed
-
-- Connection provider pattern for flexible pooling strategies
-- Multi-database support with intelligent pool management
-- Thread-safe connection handling for concurrent applications
-- Configurable pool sizing and timeout management
-- Modular class structure with cleaner separation of concerns
-- Enhanced feature system with dependency management
-- Improved inheritance patterns for better code organization
-- Streamlined base class functionality
-
-### Fixed
-
-- Critical security fixes in Ruby workflow vulnerabilities
-- Systematic dependency resolution via multi-constraint optimization
-
-
-<a id='changelog-2.0.0-pre5'></a>
-## [2.0.0-pre5] - 2025-08-05
-
-### Added
-
-- Field-level encryption with transparent access patterns
-- Multiple encryption providers:
-  - XChaCha20-Poly1305 (preferred, requires rbnacl)
-  - AES-256-GCM (fallback, OpenSSL-based)
-- Field-specific key derivation for cryptographic domain separation
-- Configurable key versioning supporting key rotation
-- Non-persistent field storage for sensitive runtime data
-- RedactedString wrapper preventing accidental logging/serialization
-- Memory-safe handling of sensitive data in Ruby objects
-- API-safe serialization excluding transient fields
-
-### Security
-
-- Encryption field security hardening with additional validation
-- Enhanced memory protection for sensitive data handling
-- Improved key management patterns and best practices
-- Security test suite expansion with comprehensive coverage
-
-
-<a id='changelog-2.0.0-pre'></a>
-## [2.0.0-pre] - 2025-07-25
-
-### Added
-
-- Complete API redesign for clarity and modern Ruby conventions
-- Valkey compatibility alongside traditional Redis support
-- Ruby 3.4+ modernization with fiber and thread safety improvements
-- Connection pooling foundation with provider pattern architecture
-
-### Changed
-
-- `Familia::Base` replaced by `Familia::Horreum` as the primary base class
-- Connection configuration moved from simple string to block-based setup
-- Feature activation changed from `include` to `feature` declarations
-- Method naming updated for consistency (`delete` → `destroy`, `exists` → `exists?`, `dump` → `serialize`)
-
-### Documentation
-
-- YARD documentation workflow with automated GitHub Pages deployment
-- Comprehensive migration guide for v1.x to v2.0.0-pre transition
-
-<!-- scriv-end-here -->

data/changelog.d/template.md.j2

@@ -1,29 +0,0 @@
-<!--
-A new scriv fragment. Uncomment sections as needed.
-Reference issues or pull requests in parentheses at the end of the entry.
-Example: - Fixed a bug in the connection pool. (Closes #123)
--->
-
-### Added
-<!-- - New features or capabilities -->
-
-### Changed
-<!-- - Changes to existing functionality -->
-
-### Deprecated
-<!-- - Soon-to-be removed features -->
-
-### Removed
-<!-- - Now removed features -->
-
-### Fixed
-<!-- - Bug fixes -->
-
-### Security
-<!-- - Security-related improvements -->
-
-### Documentation
-<!-- - Documentation improvements -->
-
-### AI Assistance
-<!-- - Briefly describe how AI was used for this change (e.g., "Refactoring and documentation by Gemini"). -->