Skip to main content
The @westyx-nexus/sdk-nodejs package is hosted on the GitLab npm Package Registry. It is public - no token is required to install.

​
1. Configure npm to look at the registry

Add (or merge) the following to your project’s .npmrc:
Commit the .npmrc to source control. It contains no credentials - every developer on the team automatically picks up the right registry.

​
2. Install the package

Pin to a specific version:

​
Requirements

  • Node.js 22 or newer. Node 22 is the oldest line still receiving security patches - Maintenance LTS until 2027-04-30 - which is what makes it the floor. CI runs the suite on Node 22, 24 (Active LTS) and 26. The SDK also relies on JSON.parse source-text access for exact config numbers, which Node has had since 22.0.
  • TypeScript users: any version supporting ES2022 target is fine. Type definitions ship in the package.

​
Importing

The package exposes a CommonJS build under dist/. Both import (ES modules) and require (CommonJS) work:

​
Verifying connectivity

Before writing any code, confirm your endpoint and API key work with a plain curl:
A valid response returns a JSON snapshot with your configs, secrets, and flags. An HTTP 401 means the key is wrong; HTTP 404 means the slug is wrong. To watch the live SSE stream:
You should see event:resync arrive within a second. Press Ctrl+C to stop.

​
Troubleshooting

  • Could not resolve '@westyx-nexus/sdk-nodejs' - your .npmrc is not picked up. Confirm it’s at the project root next to package.json, and check npm config get registry @westyx-nexus.
  • 401 Unauthorized when running npm install - the registry may be configured with an old path that’s no longer valid. Switch to the numeric-ID variant above.
  • ERR_REQUIRE_ESM - you tried to require() an ESM-only build. The SDK ships CJS; if you see this, double-check the import path.