Superposition Provider

Superposition provider is an openfeature provider that works with Superposition to fetch feature flags, configurations, and experiment variants from a Superposition server, store it in-memory and do configuration resolutions based on dynamic contexts. Read the docs for more details.

Getting started

Install the provider

npm install superposition-provider

Note: You will need to boot up Superposition before running the client code. Check the docs on how to get started with Superposition.

Initialization

To initialize the Superposition provider, you need to create a configuration. Create the provider object and then, you can set the provider using OpenFeature's API.

import { OpenFeature } from '@openfeature/server-sdk';
import { SuperpositionProvider } from 'superposition-provider';

// create a simple configuration object, for all options check the provider documentation
const config = {
  endpoint: "http://localhost:8080",
  token: "your-token-here",
  org_id: "localorg",
  workspace_id: "test",
};
const provider = new SuperpositionProvider(config);
console.log("Provider created successfully");

// Initialize the provider
await OpenFeature.setProviderAndWait(provider);
console.log("Provider initialized successfully");

Usage

Once the provider is initialized, you can evaluate feature flags and configurations using the OpenFeature client.

const client = OpenFeature.getClient();
const context = {
  d1: "d1",
};

console.log("Testing feature flags...");

const boolValue = await client.getBooleanValue("bool", false, context);
console.log("Boolean flag 'bool':", boolValue);

const stringValue = await client.getStringValue(
  "string",
  "default",
  context,
);
console.log("String flag 'string':", stringValue);

const numberValue = await client.getNumberValue("number_key", 0, context);
console.log("Number flag 'number_key':", numberValue);

// Test resolving all config
const allConfig = await provider.resolveAllConfigDetails({}, context);
console.log("All config:", allConfig);