@blunode/feature-flags-core

Evaluation engine and shared types for the BluNode feature flag service. Zero dependencies.

You normally do not install this directly. It is a dependency of @blunode/feature-flags-sdk (Node/NestJS) and @blunode/feature-flags-react (React), and is used by the flag service itself so that server and clients resolve rules identically.

import {
  evaluateFlag,
  evaluateFlags,
  type ClientConfig,
} from '@blunode/feature-flags-core';

const result = evaluateFlags(config.flags, {
  userId: 'usr_123',
  role: 'admin',
});

Evaluation order per flag: environment master switch, then rules by ascending priority (first match wins), then the environment rollout percentage (deterministic bucket on userId, then tenantId), then variant assignment. Operators: EQUALS, IN, REGEX, PERCENTAGE.

A flag service instance and an environment-scoped API key are required to obtain a config; this package contains no endpoints or credentials.