mirror of
https://github.com/vercel/flags.git
synced 2026-09-19 03:49:23 +08:00
Dominik Ferber
b70c2ea466
* refactor * remove retries * simplify * simplify options * before * rename DataSource to Controller * refactor and better tests * avoid double polling * rename * fix * simplify test setup * wip * unify * wip * only track 1 read per build * make BundledSource lazy * clean up fallback behavior * add mode * mutually exclusive streaming & polling * rely more on black box testing * simplify * Update CLAUDE.md * various fixes * add tests * more fixes * Update CLAUDE.md * more fixes * resolve more issues * unite black box tests * tests * progress * adjust * don't report on 401s; use Response.json * enforce min polling interval * progress * types * capture all logs * throw with prefix * added a minimum gap of `BASE_DELAY_MS` (1 second) between connection attempts * step * progress * use request context in tests * add separate tests depending on context * tests * rm unused option * add state machine chart * rm sources * use fake timers for more tests * swap remaining tests from msw to mocked fetch * update comments * Update CLAUDE.md * update comment * fix comment * fix types * rm peek * adds ping checks and sending x-revision header (#282) * abort on missed pings * use revision from bundled definitions * tests * simplify * send x-revsion on reconnects too * simplify StreamSource * rename * rename in test * wait for stream * replace startBackgroundUpdates with explicit call * Update CLAUDE.md * restore stronger tests * Update CLAUDE.md * convert * simplify tests * fix test * fixes * rm state machine * await first poll before resoliving init * rm outdated comment * avoid leaking _origin * changeset * avoid log on reconnect due to missed pings * don't warn on missed pings * Update event reporting for control rewrite (#289) * Update event reporting for control rewrite * Log ingest response * Use string for revision * Add retries when ingesting events * adapt changeset * adjust test --------- Co-authored-by: Luis Meyer <luis.meyer@vercel.com> Co-authored-by: Andy <AndyBitz@users.noreply.github.com> Co-authored-by: Andy Bitz <artzbitz@gmail.com>
1.5 KiB
1.5 KiB
@vercel/flags-core
The core evaluation engine for Vercel Flags, the feature flag platform built into Vercel. This package provides direct access to the flag evaluation client, data fetching, and an OpenFeature provider.
For Next.js and SvelteKit applications, use the Flags SDK with @flags-sdk/vercel provider instead. Use @vercel/flags-core when you need lower-level control, are working with an unsupported framework, or want to use the OpenFeature standard.
Installation
npm i @vercel/flags-core
Usage
import { createClient } from '@vercel/flags-core';
const client = createClient(process.env.FLAGS!);
await client.initialize();
const result = await client.evaluate<boolean>('show-new-feature', false, {
user: { id: 'user-123' },
});
OpenFeature
An OpenFeature-compatible provider is available at @vercel/flags-core/openfeature:
import { OpenFeature } from '@openfeature/server-sdk';
import { VercelProvider } from '@vercel/flags-core/openfeature';
await OpenFeature.setProviderAndWait(new VercelProvider());
const client = OpenFeature.getClient();