familia 2.0.0.pre26 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e53524562d8d882f297dfff646ee905a2cba7fc887b00640ab80bed510de8c1c
-  data.tar.gz: 823ee307f5b4ce938a3970c4872b45351d87f7af8225d8bd98820f8f73eb4229
+  metadata.gz: a908aad71096ba6a650fa67545aad0a2f891be6472fc6cb4ed067977c4edd706
+  data.tar.gz: 01d676ccdf7a783d585053be2861319785a8aa5c33298848607f589b3dfa6aaf
 SHA512:
-  metadata.gz: 51bb9a24cb6d83caa6ca1574358a0c3a93bc6735f65294a45132e0d415c1494e97c092f9263457f49e2895dc56120ba0f384f1df7b29713784b2cd6fd1d4b8f5
-  data.tar.gz: 7fd5600d88b2ae5fd6971002d57f16094e59f4813b8a720cdc75fcdaac77e225384b0458c4a40b89bdc396e688ff677f86c75dfa19fc0e523fbd276369d2493f
+  metadata.gz: 6eb5d61cb2255e5901969ae607b324a1b396f819562815d9f7f57a851b433b6cd4c695d339978de0a3341f92ddb909c8c4878a3580d442cf651449b6ac6d3be8
+  data.tar.gz: 96f2e0a1bdefbd12e6332aefcdf189ae8279d07adaa05348d839ebccf40a9e306bdd18fc21a5a9af478dab94e6b5de71fd6e86ac7cbdd264a99a26f502d598d8

data/CHANGELOG.rst

@@ -7,6 +7,55 @@ The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.1.0/>`
 
    <!--scriv-insert-here-->
 
+.. _changelog-2.0.0:
+
+2.0.0 — 2026-01-19
+==================
+
+Familia 2.0.0 represents a complete rewrite of the library with 26 pre-release
+iterations incorporating community feedback and production testing.
+
+Added
+-----
+
+- **Modular Feature System**: Autoloading features with ancestry chain traversal
+  (``feature :expiration``, ``feature :relationships``, etc.)
+- **Unified Relationships API**: ``participates_in`` replaces ``tracked_in``/``member_of``
+  with bidirectional reverse lookups (``_instances`` suffix methods)
+- **Type-Safe Serialization**: JSON encoding preserves Integer, Boolean, Float,
+  Hash, Array types across Redis boundary
+- **Performance Optimizations**: Pipelined bulk loading (``load_multi``),
+  optional EXISTS check (``check_exists: false``), OJ JSON for 2-5× faster operations
+- **Security Features**: VerifiableIdentifier with HMAC signatures,
+  ExternalIdentifier with format flexibility, encrypted fields with key rotation
+- **Thread Safety**: Mutex initialization fixes, 56-test thread safety suite
+- **Instrumentation**: ``Familia.on_command``, ``Familia.on_pipeline``,
+  ``Familia.on_lifecycle`` hooks for monitoring
+
+Changed
+-------
+
+- **BREAKING**: DataType class renaming to avoid Ruby namespace conflicts
+  (``Familia::String`` → ``Familia::StringKey``, etc.)
+- **BREAKING**: Removed ``dump_method``/``load_method`` - JSON serialization is now standard
+- **BREAKING**: Indexing API renamed (``class_indexed_by`` → ``unique_index``,
+  ``indexed_by`` → ``multi_index``)
+
+Documentation
+-------------
+
+- Archived 11 pre-release migration guides to ``docs/.archive/``
+- Enhanced ``api-technical.md`` with bulk loading, EXISTS optimization,
+  per-class feature registration, and index rebuilding documentation
+- Updated version references and fixed broken anchor links throughout docs
+
+AI Assistance
+-------------
+
+- Claude Opus 4.5 coordinated 11 parallel code-explorer agents to evaluate
+  migration docs, identifying unique content to preserve before archiving.
+  Assisted with release statistics gathering and documentation consolidation.
+
 .. _changelog-2.0.0.pre26:
 
 2.0.0.pre26 — 2026-01-19

data/Gemfile

@@ -13,6 +13,7 @@ group :test do
 end
 
 group :development, :test do
+  gem 'benchmark', '~> 0.4', require: false
   gem 'debug', require: false
   gem 'irb', '~> 1.15.2', require: false
   gem 'redcarpet', require: false

data/Gemfile.lock

@@ -1,8 +1,7 @@
 PATH
   remote: .
   specs:
-    familia (2.0.0.pre26)
-      benchmark (~> 0.4)
+    familia (2.0.0)
       concurrent-ruby (~> 1.3)
       connection_pool (~> 2.5)
       csv (~> 3.3)
@@ -181,6 +180,7 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
+  benchmark (~> 0.4)
   concurrent-ruby (~> 1.3.5)
   debug
   familia!

data/README.md

@@ -4,8 +4,6 @@
 
 Familia provides object-oriented access to Valkey/Redis using their database types. Unlike traditional ORMs that map objects to relational tables, Familia maps Ruby objects directly to Valkey's native data structures (strings, lists, sets, sorted sets, hashes) as instance variables.
 
-> [!CAUTION]
-> Familia 2 is in pre-release and not ready for production use. (October 2025)
 ## Traditional ORM vs Familia
 
 **Traditional ORMs** convert your objects to SQL tables. A product with categories becomes two tables with a join table. Checking if a tag exists requires a query with joins.
@@ -140,7 +138,7 @@ user.tags?                       # Check if it's a Set type
 
 ## Prerequisites
 
-- **Ruby**: 3.4+ (3.4+ recommended)
+- **Ruby**: 3.2+
 - **Valkey/Redis**: 6.0+
 - **Gems**: `redis` (automatically installed)
 

data/docs/guides/feature-encrypted-fields.md

@@ -895,7 +895,7 @@ Familia::Encryption.validate_configuration!
 ## See Also
 
 - **[Overview](../overview.md#encrypted-fields)** - Conceptual introduction to encrypted fields
-- **[Technical Reference](../reference/api-technical.md#encrypted-fields-feature-v200-pre5)** - Implementation details and advanced patterns
+- **[Technical Reference](../reference/api-technical.md#feature-system)** - Implementation details and advanced patterns
 - **[Security Model Guide](security-model.md)** - Cryptographic design and threat model considerations
 - **[Feature System Guide](feature-system.md)** - Understanding Familia's feature architecture
 - **[Implementation Guide](implementation.md)** - Production deployment and configuration patterns

data/docs/guides/feature-expiration.md

@@ -641,7 +641,7 @@ Get/set class-level default expiration.
 
 ## See Also
 
-- **[Technical Reference](../reference/api-technical.md#expiration-feature-v200-pre5)** - Implementation details and advanced patterns
+- **[Technical Reference](../reference/api-technical.md#feature-system)** - Implementation details and advanced patterns
 - **[Overview](../overview.md#automatic-expiration)** - Conceptual introduction to expiration
 - **[Feature System Guide](feature-system.md)** - Understanding Familia's feature architecture
 - **[Implementation Guide](implementation.md)** - Production deployment and configuration patterns

data/docs/guides/feature-quantization.md

@@ -891,7 +891,7 @@ BasicModel.qstamp()  # Uses 10.minutes fallback (600 seconds)
 
 ## See Also
 
-- **[Technical Reference](../reference/api-technical.md#quantization-feature-v200-pre7)** - Implementation details and advanced patterns
+- **[Technical Reference](../reference/api-technical.md#feature-system)** - Implementation details and advanced patterns
 - **[Overview](../overview.md#time-based-quantization)** - Conceptual introduction to quantization
 - **[Time Utilities Guide](time-utilities.md)** - Time manipulation and formatting utilities
 - **[Feature System Guide](feature-system.md)** - Understanding Familia's feature architecture

data/docs/overview.md

@@ -242,7 +242,7 @@ This automatically groups metrics into 10-minute intervals formatted as "HH:MM",
 - **Reduced Storage**: Aggregate similar data points to optimize memory usage
 - **Analytics Ready**: Perfect for dashboards and time-series data visualization
 
-> For advanced quantization strategies, value bucketing, geographic quantization, and performance patterns, see the [Technical Reference](reference/api-technical.md#quantization-feature-v200-pre7).
+> For advanced quantization strategies, value bucketing, geographic quantization, and performance patterns, see the [Technical Reference](reference/api-technical.md#feature-system).
 
 ### Object Identifiers
 
@@ -273,7 +273,7 @@ session.objid  # => "a1b2c3d4e5f6" (hex)
 - `:uuid_v4` - Standard UUID format for global uniqueness
 - `:hex` - Compact hexadecimal identifiers for internal use
 
-> For custom generators, collision detection, and advanced identifier patterns, see the [Technical Reference](reference/api-technical.md#object-identifier-feature-v200-pre7).
+> For custom generators, collision detection, and advanced identifier patterns, see the [Technical Reference](reference/api-technical.md#feature-system).
 
 ### Specialized Field Types
 
@@ -354,7 +354,7 @@ user = ExternalUser.create(external_id: "ext_12345", name: "Alice")
 
 This feature helps maintain consistency when integrating with external APIs or legacy systems.
 
-> For advanced external identifier patterns, batch operations, and sync status management, see the [Technical Reference](reference/api-technical.md#external-identifier-feature-v200-pre7).
+> For advanced external identifier patterns, batch operations, and sync status management, see the [Technical Reference](reference/api-technical.md#feature-system).
 
 ### Relationships
 
@@ -435,7 +435,7 @@ Team.email_index_for("alice@example.com")      # Direct index access
 - **Automatic Indexing**: Efficient O(1) lookups with automatic index maintenance
 - **Performance Optimized**: Bulk operations and efficient sorted set operations
 
-> For advanced relationship patterns, permission-encoded relationships, time-series tracking, and performance optimization, see the [Technical Reference](reference/api-technical.md#relationships-feature-v200-pre7).
+> For advanced relationship patterns, permission-encoded relationships, time-series tracking, and performance optimization, see the [Technical Reference](reference/api-technical.md#feature-system).
 
 ### Transient Fields
 
@@ -472,7 +472,7 @@ attempt.security_token.reveal   # => "sensitive_data"
 - **Transient Fields**: Exist only in memory, never persisted
 - **Redacted Fields**: Return `[REDACTED]` when converted to strings for logging safety
 
-> For RedactedString implementation details, single-use patterns, and security considerations, see the [Technical Reference](reference/api-technical.md#transient-fields-feature-v200-pre5).
+> For RedactedString implementation details, single-use patterns, and security considerations, see the [Technical Reference](reference/api-technical.md#feature-system).
 
 ### Permission Management
 
@@ -638,7 +638,7 @@ user.encrypted_fields_status  # Check encryption status
 - **Key Rotation**: Seamless updates with backward compatibility
 - **Multiple Algorithms**: XChaCha20-Poly1305 (preferred) with AES-256-GCM fallback
 
-> For advanced encryption configuration, multiple providers, request caching, and key rotation procedures, see the [Technical Reference](reference/api-technical.md#encrypted-fields-feature-v200-pre5).
+> For advanced encryption configuration, multiple providers, request caching, and key rotation procedures, see the [Technical Reference](reference/api-technical.md#feature-system).
 
 ### Open-ended Serialization
 
@@ -772,7 +772,7 @@ Familia.configure do |config|
 end
 ```
 
-> For production configuration patterns, advanced connection pooling, multi-database setup, and environment-based configuration, see the [Technical Reference](reference/api-technical.md#connection-management-v200-pre).
+> For production configuration patterns, advanced connection pooling, multi-database setup, and environment-based configuration, see the [Technical Reference](reference/api-technical.md#connection-management).
 
 ## Common Patterns
 

data/docs/reference/api-technical.md

@@ -48,7 +48,7 @@ Base class for Valkey/Redis data type implementations.
 
 ---
 
-## Feature System (v2.0.0-pre5+)
+## Feature System
 
 ### Feature Architecture
 Modular system for extending Horreum classes with reusable functionality.
@@ -500,6 +500,39 @@ Familia::Base.add_feature ExternalIdentifier, :external_identifier, depends_on:
 end
 ```
 
+### Per-Class Feature Registration
+
+Register custom features for specific model classes with ancestry chain lookup.
+
+```ruby
+# Define a custom feature module
+module CustomerAnalytics
+  def track_purchase(amount)
+    purchases.increment(amount)
+  end
+end
+
+# Register feature only for Customer and its subclasses
+Customer.add_feature CustomerAnalytics, :customer_analytics
+
+class Customer < Familia::Horreum
+  feature :customer_analytics  # Available via Customer's registry
+end
+
+class PremiumCustomer < Customer
+  feature :customer_analytics  # Inherited via ancestry chain
+end
+
+class Session < Familia::Horreum
+  # feature :customer_analytics  # Not available - would raise error
+end
+```
+
+**Benefits:**
+- Features can have the same name across different model hierarchies
+- Natural inheritance through Ruby's class hierarchy
+- Better namespace management for large applications
+
 ### Per-Class Feature Configuration Isolation
 Each class maintains independent feature options.
 
@@ -970,6 +1003,43 @@ end
 
 ## Performance Optimization
 
+### Pipelined Bulk Loading
+
+Load multiple objects efficiently with a single pipelined Redis batch.
+
+```ruby
+# Before: N×2 commands (EXISTS + HGETALL per object)
+users = ids.map { |id| User.find_by_id(id) }
+# For 14 objects: 28 Redis commands
+
+# After: 1 pipelined batch
+users = User.load_multi(ids)
+# For 14 objects: 1 batch with 14 HGETALL commands (2× faster)
+
+# Load by full dbkeys
+users = User.load_multi_by_keys(['user:123:object', 'user:456:object'])
+
+# Filter out nils for missing objects
+existing_users = User.load_multi(ids).compact
+```
+
+### Optional EXISTS Check Optimization
+
+Skip the EXISTS check for 50% reduction in Redis commands when keys are known to exist.
+
+```ruby
+# Default behavior (2 commands: EXISTS + HGETALL)
+user = User.find_by_id(123)
+
+# Optimized (1 command: HGETALL only)
+user = User.find_by_id(123, check_exists: false)
+```
+
+**When to use `check_exists: false`:**
+- Loading from sorted set results (keys guaranteed to exist)
+- High-throughput API endpoints
+- Bulk operations with known-existing keys
+
 ### Batch Operations
 Minimize Valkey/Redis round trips with batch operations.
 
@@ -990,6 +1060,33 @@ User.pipelined do
 end
 ```
 
+### Index Rebuilding
+
+Auto-generated rebuild methods for unique and multi indexes with zero downtime.
+
+```ruby
+class User < Familia::Horreum
+  feature :relationships
+  unique_index :email, :email_lookup
+end
+
+# Rebuild class-level unique index
+User.rebuild_email_lookup
+
+# With progress tracking
+User.rebuild_email_lookup(batch_size: 100) do |progress|
+  puts "#{progress[:completed]}/#{progress[:total]}"
+end
+
+# Instance-scoped index rebuild
+company.rebuild_badge_index
+```
+
+**When to use:**
+- After data migrations or bulk imports
+- Recovering from index corruption
+- Adding indexes to existing data
+
 ### Memory Optimization
 Efficient memory usage patterns.
 
@@ -1040,7 +1137,7 @@ end
 
 ## Migration and Upgrading
 
-### From v1.x to v2.0.0-pre
+### From v1.x to v2.0
 Key changes and migration steps.
 
 ```ruby
@@ -1051,7 +1148,7 @@ class User < Familia
   list :sessions
 end
 
-# NEW v2.0.0-pre syntax
+# NEW v2.0 syntax
 class User < Familia::Horreum
   identifier_field :email  # Updated method name
   field :name              # Generic field method
@@ -1304,9 +1401,8 @@ end
 - [Connection Pooling Guide](../guides/Connection-Pooling-Guide.md)
 
 ### Version Information
-- **Current Version**: v2.0.0.pre6 (as of version.rb)
-- **Target Version**: v2.0.0.pre7 (relationships release)
-- **Ruby Compatibility**: 3.0+ (3.4+ recommended for optimal threading)
+- **Current Version**: v2.0.0
+- **Ruby Compatibility**: 3.2+
 - **Redis Compatibility**: 6.0+ (Valkey compatible)
 
-This technical reference covers the major components and usage patterns available in Familia v2.0.0-pre series. For complete API documentation, see the generated YARD docs and wiki guides.
+This technical reference covers the major components and usage patterns available in Familia v2.0. For complete API documentation, see the generated YARD docs and wiki guides.

data/familia.gemspec

@@ -17,9 +17,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = Gem::Requirement.new('>= 3.3.6')
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.2')
 
-  spec.add_dependency 'benchmark', '~> 0.4'
   spec.add_dependency 'concurrent-ruby', '~> 1.3'
   spec.add_dependency 'connection_pool', '~> 2.5'
   spec.add_dependency 'csv', '~> 3.3'

data/lib/familia/data_type/types/hashkey.rb

@@ -129,6 +129,244 @@ module Familia
       deserialize_values(*elements)
     end
 
+    # Incrementally iterates over fields in the hash using cursor-based iteration.
+    # This is more memory-efficient than `hgetall` for large hashes.
+    #
+    # @param cursor [Integer] The cursor position to start from (0 for initial call)
+    # @param match [String, nil] Optional glob-style pattern to filter field names
+    # @param count [Integer, nil] Optional hint for number of elements to return per call
+    # @return [Array<String, Hash>] A two-element array: [new_cursor, {field => value, ...}]
+    #   When new_cursor is "0", iteration is complete.
+    #
+    # @example Basic iteration
+    #   cursor = 0
+    #   loop do
+    #     cursor, results = my_hash.scan(cursor)
+    #     results.each { |field, value| puts "#{field}: #{value}" }
+    #     break if cursor == "0"
+    #   end
+    #
+    # @example With pattern matching
+    #   cursor, results = my_hash.scan(0, match: "user:*", count: 100)
+    def scan(cursor = 0, match: nil, count: nil)
+      args = [dbkey, cursor]
+      args += ['MATCH', match] if match
+      args += ['COUNT', count] if count
+
+      new_cursor, pairs = dbclient.hscan(*args)
+
+      # pairs is an array of [field, value] pairs, convert to hash with deserialization
+      result_hash = pairs.to_h.transform_values { |v| deserialize_value(v) }
+
+      [new_cursor, result_hash]
+    end
+    alias hscan scan
+
+    # Increments the float value of a hash field by the given amount.
+    #
+    # @param field [String] The field name
+    # @param by [Float, Integer] The amount to increment by (can be negative)
+    # @return [Float] The new value after incrementing
+    #
+    # @example
+    #   my_hash.incrbyfloat('temperature', 0.5)  #=> 23.5
+    #   my_hash.incrbyfloat('temperature', -1.2) #=> 22.3
+    def incrbyfloat(field, by)
+      dbclient.hincrbyfloat(dbkey, field.to_s, by).to_f
+    end
+    alias incrfloat incrbyfloat
+
+    # Returns the string length of the value associated with field.
+    #
+    # @param field [String] The field name
+    # @return [Integer] The length of the value in bytes, or 0 if field does not exist
+    #
+    # @example
+    #   my_hash['name'] = 'Alice'
+    #   my_hash.strlen('name')  #=> 7 (includes JSON quotes: "Alice")
+    def strlen(field)
+      dbclient.hstrlen(dbkey, field.to_s)
+    end
+    alias hstrlen strlen
+
+    # Returns one or more random fields from the hash.
+    #
+    # @param count [Integer, nil] Number of fields to return. If nil, returns a single field.
+    #   If positive, returns distinct fields. If negative, allows duplicates.
+    # @param withvalues [Boolean] If true, returns fields with their values
+    # @return [String, Array<String>, Array<Array>] Depending on arguments:
+    #   - No count: single field name (or nil if hash is empty)
+    #   - With count: array of field names
+    #   - With count and withvalues: array of [field, value] pairs
+    #
+    # @example Get a single random field
+    #   my_hash.randfield  #=> "some_field"
+    #
+    # @example Get 3 distinct random fields
+    #   my_hash.randfield(3)  #=> ["field1", "field2", "field3"]
+    #
+    # @example Get 2 random fields with values
+    #   my_hash.randfield(2, withvalues: true)  #=> [["field1", value1], ["field2", value2]]
+    def randfield(count = nil, withvalues: false)
+      if count.nil?
+        dbclient.hrandfield(dbkey)
+      elsif withvalues
+        pairs = dbclient.hrandfield(dbkey, count, 'WITHVALUES')
+        # pairs is array of [field, value, field, value, ...]
+        # Convert to array of [field, deserialized_value] pairs
+        pairs.each_slice(2).map { |field, val| [field, deserialize_value(val)] }
+      else
+        dbclient.hrandfield(dbkey, count)
+      end
+    end
+    alias hrandfield randfield
+
+    # -----------------------------------------------------------------------
+    # Field-Level Expiration Methods (Redis 7.4+)
+    #
+    # These methods require Redis/Valkey 7.4 or later. They allow setting
+    # TTL on individual hash fields rather than the entire key.
+    # -----------------------------------------------------------------------
+
+    # Sets expiration time in seconds on one or more hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param seconds [Integer] TTL in seconds
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of results for each field:
+    #   -2 if field does not exist, 1 if expiration was set,
+    #   0 if expiration was not set (e.g., field has no expiration)
+    #
+    # @example Set 1 hour TTL on specific fields
+    #   my_hash.expire_fields(3600, 'session_token', 'temp_data')
+    def expire_fields(seconds, *fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HEXPIRE', dbkey, seconds, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hexpire expire_fields
+
+    # Sets expiration time in milliseconds on one or more hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param milliseconds [Integer] TTL in milliseconds
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of results for each field
+    #
+    # @example Set 500ms TTL on a field
+    #   my_hash.pexpire_fields(500, 'rate_limit_counter')
+    def pexpire_fields(milliseconds, *fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HPEXPIRE', dbkey, milliseconds, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hpexpire pexpire_fields
+
+    # Sets absolute expiration time (Unix timestamp in seconds) on hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param unix_time [Integer] Absolute Unix timestamp in seconds
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of results for each field
+    #
+    # @example Expire fields at midnight tonight
+    #   midnight = Time.now.to_i + (24 * 60 * 60)
+    #   my_hash.expireat_fields(midnight, 'daily_counter')
+    def expireat_fields(unix_time, *fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HEXPIREAT', dbkey, unix_time, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hexpireat expireat_fields
+
+    # Sets absolute expiration time (Unix timestamp in milliseconds) on hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param unix_time_ms [Integer] Absolute Unix timestamp in milliseconds
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of results for each field
+    #
+    # @example Expire field at a precise millisecond
+    #   my_hash.pexpireat_fields(1700000000000, 'precise_data')
+    def pexpireat_fields(unix_time_ms, *fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HPEXPIREAT', dbkey, unix_time_ms, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hpexpireat pexpireat_fields
+
+    # Returns the remaining TTL in seconds for one or more hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of TTL values for each field:
+    #   -2 if field does not exist, -1 if field has no expiration,
+    #   otherwise the TTL in seconds
+    #
+    # @example Check remaining TTL on fields
+    #   my_hash.ttl_fields('session_token', 'temp_data')  #=> [3600, -1]
+    def ttl_fields(*fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HTTL', dbkey, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias httl ttl_fields
+
+    # Returns the remaining TTL in milliseconds for one or more hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of TTL values in milliseconds
+    #
+    # @example Check remaining TTL in milliseconds
+    #   my_hash.pttl_fields('rate_limit')  #=> [450]
+    def pttl_fields(*fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HPTTL', dbkey, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hpttl pttl_fields
+
+    # Removes expiration from one or more hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of results for each field:
+    #   -2 if field does not exist, -1 if field has no expiration,
+    #   1 if expiration was removed
+    #
+    # @example Remove expiration from fields
+    #   my_hash.persist_fields('important_data')  #=> [1]
+    def persist_fields(*fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HPERSIST', dbkey, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hpersist persist_fields
+
+    # Returns the absolute Unix expiration timestamp in seconds for hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of timestamps for each field:
+    #   -2 if field does not exist, -1 if field has no expiration,
+    #   otherwise the absolute Unix timestamp in seconds
+    #
+    # @example Get expiration timestamp
+    #   my_hash.expiretime_fields('session')  #=> [1700000000]
+    def expiretime_fields(*fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HEXPIRETIME', dbkey, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hexpiretime expiretime_fields
+
+    # Returns the absolute Unix expiration timestamp in milliseconds for hash fields.
+    # @note Requires Redis 7.4+
+    #
+    # @param fields [Array<String>] One or more field names
+    # @return [Array<Integer>] Array of timestamps in milliseconds
+    #
+    # @example Get precise expiration timestamp
+    #   my_hash.pexpiretime_fields('session')  #=> [1700000000000]
+    def pexpiretime_fields(*fields)
+      string_fields = fields.flatten.compact.map(&:to_s)
+      dbclient.call('HPEXPIRETIME', dbkey, 'FIELDS', string_fields.size, *string_fields)
+    end
+    alias hpexpiretime pexpiretime_fields
+
     # The Great Database Refresh-o-matic 3000 for HashKey!
     #
     # This method performs a complete refresh of the hash's state from the database.