@openfeature/flagd-web-provider
TypeScript icon, indicating that this package has built-in type declarations

0.7.2 • Public • Published

flagd-web Provider for OpenFeature

Experimental

A feature flag daemon with a Unix philosophy.

Installation

⚠️ This provider requires the use of the experimental @openfeature/web-sdk:

npm install @openfeature/web-sdk
npm install @openfeature/flagd-web-provider

Usage

The FlagdWebProvider communicates with flagd via the connect protocol.

Available options

Option name Type Default Description
host string sets the host used to connect to the flagd instance
pathPrefix string "" sets the path at which the flagd gRPC service is available, for example: /api/flagd (optional)
port number 443 sets the port used to connect to the flagd instance
tls boolean true when set to true the provider will attempt to connect to flagd via https
maxRetries number 0 Sets the maximum number of retries for a connection to be made to the flagd instance. A value of 0 means unlimited. A negative value means no retries.
maxDelay number 60000 sets the maximum time in ms to wait between reconnect intervals

Reconnection

If the connection to the flagd instance fails, the provider will attempt to reconnect with an exponential back-off. The maxDelay and maxRetries can be specified to customize reconnect behavior.

Event streaming

The FlagdWebProvider receives events from flagd with changes. Combined with the event API in the web SDK, this allows for subscription to flag value changes in clients.

client.addHandler(ProviderEvents.Ready, () => {
  // do something when the configuration has changed.
});

Caching

The FlagdWebProvider evaluates flags in bulk, taking into account the evaluation context, and then caches them in memory for local evaluation. The cache is invalidated when flag configuration change events are received.

Example

OpenFeature.setProvider(
  new FlagdWebProvider({
    host: 'myapp.com',
    port: 443,
    tls: true,
    maxRetries: 10,
    maxDelay: 30000,
  })
);

Building

Run npx nx package flagd-web to build the library.

NOTE: Buf must be installed to build locally.

Running unit tests

Run npx nx test flagd-web to execute the unit tests via Jest.

Versions

Current Tags

VersionDownloads (Last 7 Days)Tag
0.7.2648latest

Version History

VersionDownloads (Last 7 Days)Published
0.7.2648
0.7.1590
0.7.00
0.6.0123
0.5.10
0.5.00
0.4.11
0.4.01
0.3.50
0.3.41
0.3.31
0.3.20
0.3.10
0.3.00
0.2.00
0.1.40
0.1.30
0.1.20
0.1.10

Package Sidebar

Install

npm i @openfeature/flagd-web-provider

Weekly Downloads

1,365

Version

0.7.2

License

none

Unpacked Size

153 kB

Total Files

22

Last publish

Collaborators

  • beeme1mr
  • toddbaert