WLCR Feature Flags

Small, dependency-free helper for WLCR feature flags.

Usage

``ts
import { createFeatureFlags } from "wlcr-feature-flags";

const flags = createFeatureFlags("rallycrew", { timeoutMs: 1500 });
await flags.ready;

const isOn = flags.isEnabled("test");
const value = flags.getValue("number-flag", 0);
const all = flags.getFlags();
const info = flags.getInfo();
`

Scripts

- npm run build builds CJS + ESM and type declarations.
- npm test runs the minimal Node.js test harness.

API

- createFeatureFlags(handle, options)
- handle: the WLCR handle.
- options.timeoutMs: optional request timeout.
- options.fetch: optional custom fetch implementation.
- options.headers: optional headers.

Returned client:
- ready: promise that resolves after initial fetch.
- refresh(): re-fetches the JSON file.
- getFlags(): returns a record of all flags.
- getFlag(key): returns a single flag or null.
- getValue(key, fallback): returns the flag value or fallback.
- isEnabled(key, fallback): convenience boolean for boolean flags.
- getInfo(): returns flag set metadata (no flags).
- getLastError()`: last error message, if any.

This package never throws; all methods return safe values on errors.