Skip to content

Add support for CLAIM option on XREADGROUP #3482

@a-TODO-rov

Description

@a-TODO-rov

Summary

Introduce client support for the new XREADGROUP … CLAIM <min-idle-time> option so consumers can reclaim idle pending entries (from the group PEL) and read new entries in a single call. When entries are claimed, Redis returns two extra fields per entry:

  • msSinceLastDelivery
  • redeliveryCount

The client should surface these alongside the stream message.

Motivation

  • Reduce round-trips and complexity vs. separate PEL inspection and claim flows.
  • Enable a single read path that first yields overdue PEL items (claimed) and then new entries.
  • Align with server support that returns additional metadata about claimed entries.

Backward compatibility

  • Without CLAIM, behavior is unchanged.
  • On servers that don’t support CLAIM, the command will fail with a syntax error; applications can feature-detect or fall back (e.g., XAUTOCLAIM).
  • Parsing remains compatible with legacy XREAD/XREADGROUP replies.

References

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions