Add HPEXPIRETIME and HGETEX hash commands

[Copilot]

Implements Redis 7.4+ hash field expiration commands: HPEXPIRETIME for querying expiration times and HGETEX for atomic get-with-optional-set-TTL.

Implementation

HPEXPIRETIME

• Returns absolute Unix timestamps in milliseconds for hash field expiration
• Return values: -2 (key not found), -1 (no TTL), -3 (field not found), or timestamp

HGETEX

• Retrieves field values with optional TTL update in single operation
• Supports EX, PX, EXAT, PXAT options
• Automatically converts listpack to StringMap when setting field-level TTL
• Note: PERSIST option deferred (requires expiry removal API not in StringMap)

Example

# Set hash fields with expiration
> HSETEX mykey 30 f1 v1 f2 v2
(integer) 2

# Query expiration times in milliseconds
> HPEXPIRETIME mykey FIELDS 2 f1 f2
1) (integer) 1675209630000
2) (integer) 1675209630000

# Get values and update TTL atomically
> HGETEX mykey EX 60 FIELDS 2 f1 f2
1) "v1"
2) "v2"

Technical Notes

• HPEXPIRETIME uses read-only transaction path
• HGETEX switches to write path only when expiration option provided
• Both registered with CO::FAST flag for performance
• Ceiling division for PX duration conversion, direct division for PXAT timestamps

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Please add the HPEXPIRETIME HGETEX commands</issue_title>
<issue_description>Redis has the HPEXPIRETIME and HGETEX commands. Can we add HPEXPIRETIME and HGETEX commands?</issue_description>

<agent_instructions>Add tests, also cover all parameters that Redis supports</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Please add the HPEXPIRETIME HGETEX commands #5935

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.