This PR contains the following updates:
| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| redis | ^5.11.0 → ^6.3.1 |
Release Notes
redis/node-redis (redis)
v6.3.1
v6.3.0
v6.2.1
What's Changed
- fix(sentinel): cap post-connect rediscovery retries by @DebadityaHait in #3388
- chore(deps): bump ip-address and socks by @dependabot[bot] in #3389
- feat(client): add MaxCommandRedirectionsError for cluster redirections by @Piyush0049 in #3386
- fix: remove stale data listener explicitly on socket error by @Chrisp1tv in #3209
- fix(client): dispose credentials subscription on every close() path by @lazerg in #3391
- fix(cluster): keep batch commands routed by slot during migration by @GiHoon1123 in #3377
- fix(client): decode RESP3 doubles to the value the server sent by @Jaybhade in #3393
- fix(cluster): handle MOVED and ASK redirects for atomic MULTI by @konovalovsergey in #3395
New Contributors
- @DebadityaHait made their first contribution in #3388
- @Chrisp1tv made their first contribution in #3209
- @lazerg made their first contribution in #3391
- @Jaybhade made their first contribution in #3393
- @konovalovsergey made their first contribution in #3395
Full Changelog: https://github.com/redis/node-redis/compare/redis@6.2.0...redis@6.2.1
v6.2.0
6.2.0
✨ Highlights
Cluster commands now follow the server's request/response policies. node-redis reads each command's routing policy from the server's COMMAND metadata and routes and aggregates accordingly, so the cluster client behaves much more like a single server. Multi-key commands that span hash slots — MGET, MSET, DEL, EXISTS, TOUCH, UNLINK — are transparently split per slot and their replies reassembled in caller order, so cross-slot calls that previously failed with CROSSSLOT now just work. Fan-out commands such as KEYS, DBSIZE, FLUSHALL, PING, WAIT, SCRIPT EXISTS and CONFIG SET run across every shard (or every node) and their replies are aggregated per the server's policy, SCAN walks the whole cluster behind a per-client virtual cursor, and RANDOMKEY / FT.CURSOR get correct cluster-aware routing. Replica read-scaling was also aligned with the server flags, so read-only keyless commands (DBSIZE, KEYS, SCAN, RANDOMKEY, and the RediSearch / time-series reads) can be served from replicas again.
⚠️ Behavior change for the raw sendCommand path: a table-recognized command sent raw — e.g. cluster.sendCommand(['DBSIZE']) — now follows its policy (fan-out and aggregate) instead of hitting a single node. Callers who relied on raw commands for per-node operations should target a specific node with cluster.nodeClient(node).sendCommand(...).
This release also brings a broad wave of new command coverage across the client and modules. The time-series package gains the most: new TS.NRANGE/TS.NREVRANGE multi-key pivot commands, a TS.READ cursor reader, TS.QUERYLABELS, EXCLUDEEMPTY on MRANGE/MREVRANGE, and multi-aggregator support. RediSearch adds FT.ALIASLIST, a COLLECT reducer for FT.AGGREGATE, HNSW RERANK, timeout warnings on the FT.SEARCH family, and the full set of stemmer languages. The core client adds SUNIONCARD/SDIFFCARD, LMOVEM/BLMOVEM, ZREVRANK WITHSCORE, COMMAND DOCS, and XREAD MAXCOUNT/MAXSIZE. A large batch of correctness fixes lands for zero-valued optional arguments (LIMIT 0, DB 0, SAMPLES 0, ENTRIESREAD 0, IDLETIME/FREQ 0, ENTRIESADDED 0) that were previously dropped from the wire, alongside several cluster and sentinel connection-lifecycle fixes.
The new HIMPORT command family (managed fieldset lifecycle) ships as experimental — see the warning below.
🚀 New Features
- feat(client): request/response policy routing for cluster commands (multi_shard split, fan-out aggregation, special SCAN/RANDOMKEY/FT.CURSOR) (#2996) — @nkaradzhov
- feat: add
COMMAND DOCSsupport (#3362) — @Hashim1999164 - feat(client): add
LMOVEMandBLMOVEMcommands (#3340) — @nkaradzhov - feat(client): add
SUNIONCARDandSDIFFCARDset-cardinality commands (#3336) — @nkaradzhov - feat(client): add
zRevRankWithScore(#3279) — @raashish1601 - feat(xread): add
MAXCOUNT/MAXSIZEoptions (#3335) — @nkaradzhov - feat(search): expose timeout warnings on the
FT.SEARCHfamily (#3338) — @nkaradzhov - feat(search): add missing RediSearch stemmer languages (#3350) — @nkaradzhov
- feat(search): add
FT.ALIASLIST(#3351) — @nkaradzhov - feat(search): add
RERANKparameter for HNSW vector fields (#3356) — @nkaradzhov - feat(search): add
COLLECTreducer toFT.AGGREGATE(#3310) — @nkaradzhov - feat(time-series): add
TS.NRANGE/TS.NREVRANGEmulti-key pivot commands (#3337) — @nkaradzhov - feat(time-series): support multiple aggregators per key in
TS.NRANGE/TS.NREVRANGE(#3360) — @nkaradzhov - feat(time-series): add
TS.QUERYLABELS(LABELSandVALUESforms) (#3354) — @nkaradzhov - feat(time-series): add
EXCLUDEEMPTYtoTS.MRANGE/TS.MREVRANGE(#3352) — @nkaradzhov - feat(time-series): add
TS.READcursor-read command (#3322) — @nkaradzhov - feat(json): add reviver support to
GET,MGET, andARRPOP(#3205) — @JeanSamGirard
⚠️ Experimental
- feat(client): add HIMPORT command family with managed fieldset lifecycle (#3381) — @nkaradzhov. The HIMPORT family and its FieldsetRegistry/PreparedFieldsets API are experimental and unstable; the surface may change or be removed in a future release. Do not depend on it in production.
🐛 Bug Fixes
- fix(cluster): reject commands before the cluster topology is ready (#3321) — @GiHoon1123
- fix(cluster): rebind abort/timeout listeners when a command moves to another queue (#3367) — @GiHoon1123
- fix(cluster): make
extractAllCommandsdrain the write queue (#3364) — @GiHoon1123 - fix(sentinel): reject
connect()instead of hanging when the resolved master is unreachable (#3331) — @GiHoon1123 - fix(client): include the acquire-timeout duration in the pool timeout error message (#3382) — @Piyush0049
- fix(client): reject the in-flight connect attempt when the socket dies during the initiator (#3374) — @nkaradzhov
- fix(client): correct DoublyLinkedList head removal (#3320) — @abhijeet117
- fix(client):
XADD/XTRIMwithLIMIT 0must emit the argument (#3342) — @Develop-KIM - fix(client):
XGROUP CREATE/SETIDwithENTRIESREAD 0must emit the argument (#3333) — @Develop-KIM - fix(client):
XSETIDwithENTRIESADDED 0must emit the argument (#3324) — @spokodev - fix(client):
MEMORY USAGEmust emitSAMPLESwhen 0 (#3328) — @Develop-KIM - fix(client):
RESTOREwithIDLETIME/FREQ 0must emit the argument (#3323) — @spokodev - fix(client):
GETEX PXATwith aDatemust encode milliseconds (#3317) — @spokodev - fix(client):
COPYwithDB 0must emit theDBargument (#3318) — @spokodev - fix(search): preserve zero
FT.CREATEscores (#3355) — @alencristen - fix:
hScanValuesIteratornow yields values instead of field names (#3344) — @winklemad
🧰 Maintenance
- ci(release): skip the throwaway workspace update during the staggered release (#3384) — @nkaradzhov
- ci: fix the release-drafter Maintenance category key (#3358) — @nkaradzhov
- ci(documentation): cap
GITHUB_TOKENtocontents: read(#3291) — @arpitjain099 - chore(tests): bump the default docker test image to 8.10 (#3319, #3348, #3383) — @nkaradzhov
- refactor(test-utils): single source for the default docker test image config (#3349) — @nkaradzhov
- test: run the client command specs against an external Redis Enterprise database (#3341) — @kiryazovi-redis
- test(scenario): tolerate at-least-once duplicate delivery during sharded pub/sub handoff (#3345) — @kiryazovi-redis
- test(search): add non-English language coverage for
FT.SEARCH(#3339) — @nkaradzhov - test(client): add a message-assertion test for
XCLAIM JUSTID(#3376) — @Piyush0049 - test/fix: stabilize the flaky cluster PubSub listener-move test (#3347, #3357) — @nkaradzhov
- fix(client): stabilize the flaky
LATENCY LATESTtest (#3326) — @nkaradzhov - fix: remove dangling agent symlinks that break checkout (#3334) — @nkaradzhov
- docs: add a CommonJS basic example to the README (#3359) — @Hashim1999164
- docs(cluster): document that
rootNodesconfig is not inherited by node connections (#3327) — @nkaradzhov - docs: update the
endevent description to referenceclose()anddestroy()(#3332) — @Wnayar - docs(contributing): document the Docker Desktop host-networking requirement for tests on macOS/Windows (#3330) — @nkaradzhov
- chore(docs): update the security email (#3379) — @nkaradzhov
- chore: add agent skills and tooling configs (#3316) — @nkaradzhov
- chore(skills): emit maintainer comments without blockquote markers (#3373) — @nkaradzhov
- docs(skills): improve the implement-command guidance (#3353) — @nkaradzhov
- chore: bump the metrics exporter (#3375) — @bobymicroby
- chore(deps): bump
jws(#3372),on-headers/express-session(#3371),uuid/nyc(#3370),esbuild/tsx(#3309) — @dependabot
New Contributors
- @spokodev made their first contribution in #3318
- @arpitjain099 made their first contribution in #3291
- @abhijeet117 made their first contribution in #3320
- @GiHoon1123 made their first contribution in #3321
- @JeanSamGirard made their first contribution in #3205
- @Develop-KIM made their first contribution in #3328
- @Wnayar made their first contribution in #3332
- @winklemad made their first contribution in #3344
- @Hashim1999164 made their first contribution in #3359
- @alencristen made their first contribution in #3355
- @Piyush0049 made their first contribution in #3376
Full Changelog: https://github.com/redis/node-redis/compare/redis@6.1.0...redis@6.2.0
v6.1.0
What's Changed
- feat: add key prefixing (fixes #2982) by @gajus in #3312
- feat(cluster): add getNodeClientForKey for WATCH/MULTI/EXEC by @nkaradzhov in #3315
New Contributors
Full Changelog: https://github.com/redis/node-redis/compare/redis@6.0.1...redis@6.1.0
v6.0.1
What's Changed
- ci: bump GitHub Actions to Node 24-compatible versions by @nkaradzhov in #3298
- chore(tests): bump default docker test image to 8.8.0 by @nkaradzhov in #3297
- fix(client): align RedisClientOptions RESP default with RedisClientType by @aartisonigra in #3303
- test(client): fix three flaky tests around socket/connect lifecycle by @nkaradzhov in #3299
- fix: embed sources in emitted sourcemaps by @raashish1601 in #3274
- Sentinel scan iterator by @harshrai654 in #3141
- ci: replace brittle Codecov uploader with codecov-action by @nkaradzhov in #3314
- Fix/issue 3311 by @aartisonigra in #3313
- fix(sentinel): preserve seed nodes in sentinelRootNodes after topology update (#3237) by @aartisonigra in #3306
New Contributors
- @aartisonigra made their first contribution in #3303
- @harshrai654 made their first contribution in #3141
Full Changelog: https://github.com/redis/node-redis/compare/redis@6.0.0...redis@6.0.1
v6.0.0
Changes
This is the first major release of node-redis since 5.x. The headline change is RESP3 by default, alongside broader Redis 8.8 command coverage, pubsub/cluster reliability fixes, and a bumped minimum Node.js version.
Key changes
- RESP3 is the default protocol — opt back into RESP2 explicitly if you need the old wire format
- Node.js 20 is the new minimum supported runtime
- Redis 8.8 coverage — new array commands, INCREX / INCREXBYFLOAT, ZINTER/ZUNION COUNT aggregator, XNACK, CLIENT UNBLOCK
- Sentinel & cluster pubsub fixes for failover-moved connections and sharded topology recovery
- Stack modules exposed on pool type and the core client classes are now publicly re-exported
🔥 Breaking Changes
See the v5 → v6 migration guide for migration steps.
- RESP3 is now the default protocol (#3215)
- Node.js 20 is now the minimum supported version (#3293)
- New default values for
keepAliveInitialDelay(30s) andcommandTimeout(5s) (#3292)
🔒 Security
- entraid: bump
@azure/msal-nodeto 5.x to drop vulnerable transitiveuuid(CVE-2026-41907) (#3269)
🚀 New Features
- Add
CLIENT UNBLOCKcommand (#3266) - Add
XNACKcommand with options (#3238) - Add Redis 8.8 array commands (#3285)
- Add
INCREXandINCREXBYFLOATcommands (#3288) - Add
COUNTaggregator toZINTER/ZINTERSTORE/ZUNION/ZUNIONSTORE(#3243) - Add
FPHAoption toJSON.SET(#3235) - time-series: add multi-aggregation range APIs (#3249)
- Add
duplicate()method toRedisSentinel(#3212) - Parse
unix://URLs inparseURL(#3271) - Expose
RedisClient,RedisCluster,RedisSentineland pool classes (#3251) - Expose stack modules on the pool type (#3267)
🐛 Bug Fixes
- sentinel: use mapped address when failover moves pubsub connections (#3190)
- cluster: recover sharded pubsub topology after node reconnects (#3223)
- client: swallow synchronous EPIPE from writeAfterFIN (#3283)
- search: allow
LOAD *inFT.AGGREGATE(#3241) - otel: record client connection errors (#3259)
- entraid: bump
@azure/msal-nodeto 5.x to drop vulnerableuuidtransitive (#3269) - Fix wrapper command options handling (#3295)
- Non-functional typo fixes (#3244)
📚 Documentation
- Document Node.js 20 minimum version in migration guide (#3293)
- Numerous typo and grammar fixes across docs and comments (#3230, #3231, #3232, #3239, #3240, #3242, #3245, #3246, #3
- Inline JSDoc improvements (#3250)
- Compact receiver hovers via public type aliases (#3248)
🧰 Maintenance
- Add changed-file lint gate (#3257)
- CI: lint changed files against PR merge base (#3265)
- CI: build monorepo before documentation generation (#3233)
- Add
min-release-agecooldown to.npmrc(#3286) - Allow empty object types in lint config (#3263)
- Add hash field subkey notifications test (#3264)
- Restore generic-transformers spec on current APIs (#3214)
- Bump default docker test image through 8.8 milestones to 8.8-rc1 (#3234, #3236, #3260, #3284)
- chore(deps): bump
basic-ftp(#3225),tmpand@inquirer/editor(#3294)
👥 New Contributors
- @Rohan5commit made their first contribution in #3232
- @opensourcezeal made their first contribution in #3244
- @aarond-sp made their first contribution in #3251
- @claygeo made their first contribution in #3212
- @raashish1601 made their first contribution in #3267
We'd like to thank all the contributors who worked on this release! @Rohan5commit, @opensourcezeal, @aarond-sp, @claygeo, @raashish1601, @watersRand, @PavelPashov, @elimelt, @nkaradzhov
Full Changelog: https://github.com/redis/node-redis/compare/redis@5.12.1...redis@6.0.0
v5.12.1
v5.12.0
✨ What's Changed
🚀 Features
- feat: expose
sendCommandonmultifor all clients by @nkaradzhov in #3181 - feat(sentinel): add
sSubscribe/sUnsubscribemethods to Sentinel client by @nkaradzhov in #3178
🐛 Fixes
- fix(search): correct
INDEXMISSINGplacement by @nkaradzhov in #3179 - Pool fixes by @nkaradzhov in #3182
- fix(search): use
@redis/clientdist imports inCREATEcommand by @PavelPashov in #3187 - fix(sentinel): preserve root seeds for outage recovery by @nkaradzhov in #3188
- fix: fallthrough bug in
transformDoubleReplyby @rhymincymon in #3213
🔭 Observability (OTEL + Diagnostics)
Node Redis now ships with first-class observability via OpenTelemetry metrics and Node.js diagnostics_channel. Initialize OpenTelemetry before creating clients (OpenTelemetry.init({ metrics: { enabled: true } })) and you can plug Redis client telemetry into your existing OTel SDK/exporter pipeline.
This enables visibility into command latency, connection lifecycle, resiliency/errors, Pub/Sub traffic, streaming behavior, and client-side caching activity. On top of metrics, diagnostics channels provide a more abstract, higher-level way to track runtime behavior through low-overhead event streams (commands, batches, connection events, maintenance notifications, pub/sub, cache, and pool wait timing), so APM tools or custom subscribers can observe the system without changing application code.
- add OpenTelemetry metrics instrumentation by @PavelPashov in #3110
- feat: implement diagnostic channels for observability by @logaretm in #3195
🧪 Tests & CI
- test(scho oss): add smigrating checks for new connections by @nkaradzhov in #3186
- Add self-report metrics step to CI workflow by @bobymicroby in #3199
- Add run tests action by @dariaguy in #3221
📚 Docs
- improve sentinel docs by @cutiepoka in #3189
- docs: clarify DUMP/RESTORE binary payload usage by @nkaradzhov in #3201
- fix(docs): configure typedoc entry points for monorepo by @nkaradzhov in #3220
🙌 New Contributors
- @cutiepoka made their first contribution in #3189
- @rhymincymon made their first contribution in #3213
- @logaretm made their first contribution in #3195
- @dariaguy made their first contribution in #3221
Full Changelog: https://github.com/redis/node-redis/compare/redis@5.11.0...redis@5.12.0
Configuration
📅 Schedule: (UTC)
- Branch creation
- At any time (no schedule defined)
- Automerge
- At any time (no schedule defined)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
- If you want to rebase/retry this PR, check this box
This PR was generated by Mend Renovate. View the repository job log.