Skip to main content

​
Core SDK

@superflag-sh/core is the dependency-free evaluation authority shared by Superflag’s control plane and SDKs. Use it directly when your application already possesses a versioned configuration or needs schema, code generation, inspection, migration, experiment, telemetry, or OpenFeature primitives.

​
What core owns

  • strict schema v1 parsing and validation;
  • deterministic rules, prerequisites, segments, schedules, and weighted rollouts;
  • explicit fallback and evaluation-detail semantics;
  • client privacy projection and context allow-listing;
  • deterministic TypeScript code generation;
  • legacy configuration migration;
  • OpenFeature server provider adaptation;
  • conformance vectors shared by packages;
  • immutable experiment iterations and assignment;
  • evaluation explanations, dependency impact, and simulations; and
  • opt-in, transport-independent feature-event telemetry.
Core does not synchronize remote configuration, persist caches, mount React providers, or run background work.

​
Entry points

Evaluate a config

Define, validate, evaluate, inspect, and project a versioned configuration.