FeatureSignals

Node.js SDK

TypeScript-first client for evaluating feature flags in Node.js applications.

Installation

bash
npm install @featuresignals/node

Requirements: Node.js 22+, ESM

Quick Start

typescript
import { FeatureSignalsClient } from '@featuresignals/node';

const client = new FeatureSignalsClient('fs_srv_your_api_key', {
  envKey: 'production',
  baseURL: 'https://api.featuresignals.com',
});

await client.waitForReady();

const enabled = client.boolVariation('new-feature', { key: 'user-123' }, false);
console.log('Feature enabled:', enabled);

// When shutting down
client.close();

Configuration Options

OptionTypeDefault
envKeystring(required)
baseURLstringhttps://api.featuresignals.com
pollingIntervalMsnumber30000
streamingbooleanfalse
timeoutMsnumber10000

Events

typescript
client.on('ready', () => console.log('Flags loaded'));
client.on('error', (err) => console.error('Fetch failed:', err));
client.on('update', (flags) => console.log('Updated:', Object.keys(flags).length));

Next Steps