Skip to content

docs: update Node.js requirements for NAPI-RS architecture - #286

Open
Aryex wants to merge 1 commit into
mainfrom
alexl/agent/node-napi-architecture
Open

docs: update Node.js requirements for NAPI-RS architecture#286
Aryex wants to merge 1 commit into
mainfrom
alexl/agent/node-napi-architecture

Conversation

@Aryex

@Aryex Aryex commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Update Node.js documentation to reflect the replacement of Unix socket IPC with a direct NAPI-RS native binding layer.

⚠️ Attention: This PR was generated automatically. Verify that all relevant pages have been updated.

Source Commits

  • e2706b0 — Node: Replace socket IPC with direct NAPI layer (#5325)

Changes

  • Updated minimum Node.js version from 16+ to 20+ (installation and quickstart pages)
  • Removed obsolete protobufjs dependency note (no longer used with NAPI-RS)
  • Updated glibc requirement from 2.17+ to 2.28+ for Node.js native binaries
  • Updated Alpine Linux/MUSL support status: now supported for Node.js and Java
  • Added NAPI-RS to the FFI layer description in the architecture docs
  • Fixed typo: Py03 → PyO3

Context

The Node.js client was rearchitected to replace Unix socket IPC + protobuf serialization with a direct NAPI-RS binding into the Rust core (valkey-glide #5325). This changes the minimum supported Node.js version to 20, removes the protobuf dependency, and adds MUSL/Alpine Linux support via prebuilt native binaries.

cc @avifenesh


This PR was generated by the automated documentation pipeline.

@Aryex Aryex added AI Generated documentation Improvements or additions to documentation nodejs labels Jul 26, 2026
@Aryex
Aryex force-pushed the alexl/agent/node-napi-architecture branch from f8fb3e2 to 21b40eb Compare July 26, 2026 21:27
@Aryex Aryex self-assigned this Jul 27, 2026
@Aryex
Aryex requested review from jeremyprime and xShinnRyuu July 27, 2026 14:42
@Aryex
Aryex marked this pull request as ready for review July 27, 2026 14:42
Signed-off-by: kiro-agent <kiro-agent@users.noreply.github.com>
@Aryex
Aryex force-pushed the alexl/agent/node-napi-architecture branch from 21b40eb to b8f60a3 Compare July 27, 2026 14:42
@jeremyprime
jeremyprime requested review from affonsov and removed request for xShinnRyuu July 27, 2026 15:36
@Aryex Aryex assigned affonsov and unassigned Aryex Jul 27, 2026
<details>
<summary>`glibc` requirements</summary>
Node.js requires `glibc` 2.17+. This should be the standard for GNU Linux based systems.
The Node.js native binaries require glibc 2.28+. This is standard for most modern GNU/Linux distributions (Ubuntu 20.04+, Amazon Linux 2023, RHEL 8+).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think glibc was changed, still 2.17.


<TabItem label="Node">
**Requirements:** Node.js 16+
**Requirements:** Node.js 20+

@jeremyprime jeremyprime Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also need to ensure other pages are updated with new minimum Node version, like doc-gen/typedoc/node-home.md (which also needs to remove protobuf dependency note).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AI Generated documentation Improvements or additions to documentation nodejs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants