arrow-left Back to Announcements
DATE:
AUTHOR:
PowerSync Product Team
Node.js SDK

Beta Release of the PowerSync Node.js Client SDK

DATE:
AUTHOR: PowerSync Product Team

Overview

Back in March 2025 we shipped the Node.js client SDK into alpha, bringing PowerSync’s real-time sync capabilities to Node apps such as backend workers and CLI tools.

Since then, many of you have used the SDK in your apps, logged issues and suggested improvements - thank you! After shipping a bunch of improvements and bug fixes, we are now confident the SDK is ready for production use (once you’ve tested your use cases), so we’re bumping it to beta. Under the hood nothing fundamental changed: the package still extends the same @powersync/common core that drives our stable Web and React Native SDKs, so any remaining issues should be surface-level.

What’s new since alpha

Some highlights that were shipped since the alpha:

  • CommonJS build support: We now publish a CommonJS bundle alongside the ESM output, enabling you to run the SDK directly in Electron main processes or Node environments that don’t support ES modules (PR #532)

  • Full proxy support: Added support for proxy environment variables for both HTTP and WebSocket connections. HTTP traffic uses HTTP_PROXY / HTTPS_PROXY via EnvHttpProxyAgent, while WebSocket traffic uses WS_PROXY / WSS_PROXY through proxy-agent. (PR #573)

  • WebSocket + diagnostics improvements: We switched to Undici’s WebSocket implementation (unifying WebSocket's dispatcher behavior with HTTP fetch for more consistent proxy support) and enabled Node’s diagnostics_channel to expose tracing of network connections, requests and responses (PR #621)

  • Stability improvements: Several smaller fixes and improvements pulled in from our wider JavaScript SDK ecosystem.

Installation

Add the PowerSync Node SDK to your project:

npm install @powersync/node

This SDK requires @powersync/better-sqlite3 as a peer dependency:

npm install @powersync/better-sqlite3

Then follow additional configuration instructions for PowerSync in the Quickstart guide.

Docs & links

Help & feedback

Need help or have feedback? Join our Discord or open an issue on GitHub—we’d love to hear how you’re using PowerSync and what we can improve.

Powered by LaunchNotes