V5 bringing RESP3, Sentinel and TypeMapping to node-redis

RESP3 Support - Some commands responses in RESP3 aren't stable yet and therefore return an "untyped" ReplyUnion. Sentinel TypeMapping Correctly types Multi commands Note: some API changes to be further documented in v4-to-v5.md
2025-08-09 00:22:08 +03:00 · 2024-10-15 17:46:52 +03:00
parent 2fc79bdfb3
commit b2d35c5286
1174 changed files with 45931 additions and 36274 deletions
--- a/packages/time-series/lib/commands/MRANGE_WITHLABELS_GROUPBY.ts
+++ b/packages/time-series/lib/commands/MRANGE_WITHLABELS_GROUPBY.ts
@@ -0,0 +1,79 @@
+import { Command, ArrayReply, BlobStringReply, Resp2Reply, MapReply, TuplesReply, TypeMapping, RedisArgument } from '@redis/client/dist/lib/RESP/types';
+import { RedisVariadicArgument } from '@redis/client/dist/lib/commands/generic-transformers';
+import { resp2MapToValue, resp3MapToValue, SampleRawReply, Timestamp, transformRESP2LabelsWithSources, transformSamplesReply } from '.';
+import { TsRangeOptions, pushRangeArguments } from './RANGE';
+import { extractResp3MRangeSources, pushGroupByArguments, TsMRangeGroupBy, TsMRangeGroupByRawMetadataReply3 } from './MRANGE_GROUPBY';
+import { pushFilterArgument } from './MGET';
+
+export type TsMRangeWithLabelsGroupByRawReply2 = ArrayReply<
+  TuplesReply<[
+    key: BlobStringReply,
+    labels: ArrayReply<TuplesReply<[
+      label: BlobStringReply,
+      value: BlobStringReply
+    ]>>,
+    samples: ArrayReply<Resp2Reply<SampleRawReply>>
+  ]>
+>;
+
+export type TsMRangeWithLabelsGroupByRawReply3 = MapReply<
+  BlobStringReply,
+  TuplesReply<[
+    labels: MapReply<BlobStringReply, BlobStringReply>,
+    metadata: never, // ?!
+    metadata2: TsMRangeGroupByRawMetadataReply3,
+    samples: ArrayReply<SampleRawReply>
+  ]>
+>;
+
+export function createMRangeWithLabelsGroupByTransformArguments(command: RedisArgument) {
+  return (
+    fromTimestamp: Timestamp,
+    toTimestamp: Timestamp,
+    filter: RedisVariadicArgument,
+    groupBy: TsMRangeGroupBy,
+    options?: TsRangeOptions
+  ) => {
+    let args = pushRangeArguments(
+      [command],
+      fromTimestamp,
+      toTimestamp,
+      options
+    );
+  
+    args.push('WITHLABELS');
+  
+    args = pushFilterArgument(args, filter);
+  
+    pushGroupByArguments(args, groupBy);
+  
+    return args;
+  };
+}
+
+export default {
+  FIRST_KEY_INDEX: undefined,
+  IS_READ_ONLY: true,
+  transformArguments: createMRangeWithLabelsGroupByTransformArguments('TS.MRANGE'),
+  transformReply: {
+    2(reply: TsMRangeWithLabelsGroupByRawReply2, _?: any, typeMapping?: TypeMapping) {
+      return resp2MapToValue(reply, ([_key, labels, samples]) => {
+        const transformed = transformRESP2LabelsWithSources(labels);
+        return {
+          labels: transformed.labels,
+          sources: transformed.sources,
+          samples: transformSamplesReply[2](samples)
+        };
+      }, typeMapping);
+    },
+    3(reply: TsMRangeWithLabelsGroupByRawReply3) {
+      return resp3MapToValue(reply, ([labels, _metadata, metadata2, samples]) => {
+        return {
+          labels,
+          sources: extractResp3MRangeSources(metadata2),
+          samples: transformSamplesReply[3](samples)
+        };
+      });
+    }
+  },
+} as const satisfies Command;