You've already forked node-redis
mirror of
https://github.com/redis/node-redis.git
synced 2025-12-12 21:21:15 +03:00
5a0a06df69
* feat(xreadgroup): add claim attribute the CLAIM attribute can be used to instruct redis to return PEL ( Pending Entries List ) entries with their respective deliveries and ms since last delivery * remove m01 from test matrix * add jsdoc
69 lines
2.1 KiB
TypeScript
69 lines
2.1 KiB
TypeScript
import { CommandParser } from '../client/parser';
|
|
import { Command, RedisArgument, ReplyUnion } from '../RESP/types';
|
|
import { XReadStreams, pushXReadStreams } from './XREAD';
|
|
import { transformStreamsMessagesReplyResp2 } from './generic-transformers';
|
|
|
|
/**
|
|
* Options for the XREADGROUP command
|
|
*
|
|
* @property COUNT - Limit the number of entries returned per stream
|
|
* @property BLOCK - Milliseconds to block waiting for new entries (0 for indefinite)
|
|
* @property NOACK - Skip adding the message to the PEL (Pending Entries List)
|
|
* @property CLAIM - Prepend PEL entries that are at least this many milliseconds old
|
|
*/
|
|
export interface XReadGroupOptions {
|
|
COUNT?: number;
|
|
BLOCK?: number;
|
|
NOACK?: boolean;
|
|
CLAIM?: number;
|
|
}
|
|
|
|
export default {
|
|
IS_READ_ONLY: true,
|
|
/**
|
|
* Constructs the XREADGROUP command to read messages from streams as a consumer group member
|
|
*
|
|
* @param parser - The command parser
|
|
* @param group - Name of the consumer group
|
|
* @param consumer - Name of the consumer in the group
|
|
* @param streams - Single stream or array of streams to read from
|
|
* @param options - Additional options for reading streams
|
|
* @returns Array of stream entries, each containing the stream name and its messages
|
|
* @see https://redis.io/commands/xreadgroup/
|
|
*/
|
|
parseCommand(
|
|
parser: CommandParser,
|
|
group: RedisArgument,
|
|
consumer: RedisArgument,
|
|
streams: XReadStreams,
|
|
options?: XReadGroupOptions
|
|
) {
|
|
parser.push('XREADGROUP', 'GROUP', group, consumer);
|
|
|
|
if (options?.COUNT !== undefined) {
|
|
parser.push('COUNT', options.COUNT.toString());
|
|
}
|
|
|
|
if (options?.BLOCK !== undefined) {
|
|
parser.push('BLOCK', options.BLOCK.toString());
|
|
}
|
|
|
|
if (options?.NOACK) {
|
|
parser.push('NOACK');
|
|
}
|
|
|
|
if (options?.CLAIM !== undefined) {
|
|
parser.push('CLAIM', options.CLAIM.toString());
|
|
}
|
|
|
|
pushXReadStreams(parser, streams);
|
|
},
|
|
/**
|
|
* Transform functions for different RESP versions
|
|
*/
|
|
transformReply: {
|
|
2: transformStreamsMessagesReplyResp2,
|
|
3: undefined as unknown as () => ReplyUnion
|
|
},
|
|
} as const satisfies Command;
|