Skip to content

Commit 9b81317

Browse files
chore: update sdk readmes
Signed-off-by: OpenFeature Bot <[email protected]>
1 parent 42ab028 commit 9b81317

File tree

16 files changed

+184
-46
lines changed

16 files changed

+184
-46
lines changed

docs/reference/technologies/client/kotlin.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from kotlin-sdk.
1010
Edits should be made here: https://github.com/open-feature/kotlin-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Mon Oct 27 2025 08:11:29 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
<p align="center" class="github-badges">

docs/reference/technologies/client/swift.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from swift-sdk.
1010
Edits should be made here: https://github.com/open-feature/swift-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Mon Oct 27 2025 08:11:29 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
<p align="center" class="github-badges">

docs/reference/technologies/client/web/angular.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,16 @@ This content has been automatically generated from js-sdk.
1010
Edits should be made here: https://github.com/open-feature/js-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Mon Oct 27 2025 08:11:29 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
<p align="center" class="github-badges">
1717
<a href="https://github.com/open-feature/spec/releases/tag/v0.8.0">
1818
<img alt="Specification" src="https://img.shields.io/static/v1?label=specification&message=v0.8.0&color=yellow&style=for-the-badge" />
1919
</a>
2020

21-
<a href="https://github.com/open-feature/js-sdk/releases/tag/angular-sdk-v0.0.17">
22-
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.0.17&color=blue&style=for-the-badge" />
21+
<a href="https://github.com/open-feature/js-sdk/releases/tag/angular-sdk-v0.0.19">
22+
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.0.19&color=blue&style=for-the-badge" />
2323
</a>
2424

2525
<br/>

docs/reference/technologies/client/web/index.mdx

Lines changed: 61 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,16 @@ This content has been automatically generated from js-sdk.
1010
Edits should be made here: https://github.com/open-feature/js-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Mon Oct 27 2025 08:11:28 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
<p align="center" class="github-badges">
1717
<a href="https://github.com/open-feature/spec/releases/tag/v0.8.0">
1818
<img alt="Specification" src="https://img.shields.io/static/v1?label=specification&message=v0.8.0&color=yellow&style=for-the-badge" />
1919
</a>
2020

21-
<a href="https://github.com/open-feature/js-sdk/releases/tag/web-sdk-v1.6.2">
22-
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v1.6.2&color=blue&style=for-the-badge" />
21+
<a href="https://github.com/open-feature/js-sdk/releases/tag/web-sdk-v1.7.0">
22+
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v1.7.0&color=blue&style=for-the-badge" />
2323
</a>
2424

2525
<br/>
@@ -106,6 +106,7 @@ See [here](https://open-feature.github.io/js-sdk/modules/_openfeature_web_sdk.ht
106106
|| [Tracking](#tracking) | Associate user actions with feature flag evaluations, particularly for A/B testing. |
107107
|| [Shutdown](#shutdown) | Gracefully clean up a provider during application shutdown. |
108108
|| [Extending](#extending) | Extend OpenFeature with custom providers and hooks. |
109+
|| [Multi-Provider](#multi-provider) | Combine multiple providers with configurable evaluation strategies. |
109110

110111
<sub>Implemented: ✅ | In-progress: ⚠️ | Not implemented yet: ❌</sub>
111112

@@ -142,6 +143,63 @@ Once the provider has been registered, the status can be tracked using [events](
142143
In some situations, it may be beneficial to register multiple providers in the same application.
143144
This is possible using [domains](#domains), which is covered in more detail below.
144145

146+
#### Multi-Provider
147+
148+
The Multi-Provider allows you to use multiple underlying providers as sources of flag data for the OpenFeature web SDK. When a flag is being evaluated, the Multi-Provider will consult each underlying provider it is managing in order to determine the final result. Different evaluation strategies can be defined to control which providers get evaluated and which result is used.
149+
150+
The Multi-Provider is a powerful tool for performing migrations between flag providers, or combining multiple providers into a single feature flagging interface. For example:
151+
152+
- **Migration**: When migrating between two providers, you can run both in parallel under a unified flagging interface. As flags are added to the new provider, the Multi-Provider will automatically find and return them, falling back to the old provider if the new provider does not have the flag.
153+
- **Multiple Data Sources**: The Multi-Provider allows you to seamlessly combine many sources of flagging data, such as environment variables, local files, database values and SaaS hosted feature management systems.
154+
155+
```ts
156+
import { MultiProvider } from '@openfeature/web-sdk';
157+
158+
const multiProvider = new MultiProvider([
159+
{ provider: new ProviderA() },
160+
{ provider: new ProviderB() }
161+
]);
162+
163+
await OpenFeature.setProviderAndWait(multiProvider);
164+
165+
const client = OpenFeature.getClient();
166+
console.log(client.getBooleanDetails("my-flag", false));
167+
```
168+
169+
By default, the Multi-Provider will evaluate all underlying providers in order and return the first successful result. If a provider indicates it does not have a flag (FLAG_NOT_FOUND error code), then it will be skipped and the next provider will be evaluated.
170+
171+
##### Evaluation Strategies
172+
173+
The Multi-Provider comes with three strategies out of the box:
174+
175+
- **FirstMatchStrategy** (default): Evaluates all providers in order and returns the first successful result. Providers that indicate FLAG_NOT_FOUND error will be skipped and the next provider will be evaluated.
176+
- **FirstSuccessfulStrategy**: Evaluates all providers in order and returns the first successful result. Any error will cause that provider to be skipped.
177+
- **ComparisonStrategy**: Evaluates all providers sequentially. If every provider returns a successful result with the same value, then that result is returned. Otherwise, the result returned by the configured "fallback provider" will be used.
178+
179+
```ts
180+
import { MultiProvider, FirstSuccessfulStrategy } from '@openfeature/web-sdk';
181+
182+
const multiProvider = new MultiProvider(
183+
[
184+
{ provider: new ProviderA() },
185+
{ provider: new ProviderB() }
186+
],
187+
new FirstSuccessfulStrategy()
188+
);
189+
```
190+
191+
##### Tracking Support
192+
193+
The Multi-Provider supports tracking events across multiple providers, allowing you to send analytics events to all configured providers simultaneously:
194+
195+
```ts
196+
// Tracked events will be sent to all providers by default
197+
client.track('user-conversion', {
198+
value: 99.99,
199+
currency: 'USD'
200+
});
201+
```
202+
145203
### Flag evaluation flow
146204

147205
When a new provider is added to OpenFeature client the following process happens:

docs/reference/technologies/client/web/react.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
1010
Edits should be made here: https://github.com/open-feature/js-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Mon Oct 27 2025 08:11:28 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
<p align="center" class="github-badges">

docs/reference/technologies/server/dart.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This content has been automatically generated from dart-server-sdk.
99
Edits should be made here: https://github.com/open-feature/dart-server-sdk
1010
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1111

12-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
12+
Last updated at Mon Oct 27 2025 08:11:29 GMT+0000 (Coordinated Universal Time)
1313
-->
1414

1515
<p align="center" class="github-badges">

docs/reference/technologies/server/dotnet.mdx

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,13 @@ This content has been automatically generated from dotnet-sdk.
1010
Edits should be made here: https://github.com/open-feature/dotnet-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Mon Oct 27 2025 08:11:28 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
[![Specification](https://img.shields.io/static/v1?label=specification&message=v0.8.0&color=yellow&style=for-the-badge)](https://github.com/open-feature/spec/releases/tag/v0.8.0)
1717
[
18-
![Release](https://img.shields.io/static/v1?label=release&message=v2.8.1&color=blue&style=for-the-badge)
19-
](https://github.com/open-feature/dotnet-sdk/releases/tag/v2.8.1)
18+
![Release](https://img.shields.io/static/v1?label=release&message=v2.9.0&color=blue&style=for-the-badge)
19+
](https://github.com/open-feature/dotnet-sdk/releases/tag/v2.9.0)
2020

2121
[![Slack](https://img.shields.io/badge/slack-%40cncf%2Fopenfeature-brightgreen?style=flat&logo=slack)](https://cloud-native.slack.com/archives/C0344AANLA1)
2222
[![Codecov](https://codecov.io/gh/open-feature/dotnet-sdk/branch/main/graph/badge.svg?token=MONAVJBXUJ)](https://codecov.io/gh/open-feature/dotnet-sdk)
@@ -442,10 +442,12 @@ Built a new hook? [Let us know](https://github.com/open-feature/openfeature.dev/
442442
### Multi-Provider
443443

444444
> [!NOTE]
445-
> The Multi-Provider feature is currently experimental. Hooks and events are not supported at the moment.
445+
> The Multi-Provider feature is currently experimental.
446446
447447
The Multi-Provider enables the use of multiple underlying feature flag providers simultaneously, allowing different providers to be used for different flag keys or based on specific evaluation strategies.
448448

449+
The Multi-Provider supports provider hooks and executes them in accordance with the OpenFeature specification. Each provider's hooks are executed with context isolation, ensuring that context modifications by one provider's hooks do not affect other providers.
450+
449451
#### Basic Usage
450452

451453
```csharp
@@ -523,23 +525,20 @@ The Multi-Provider supports two evaluation modes:
523525

524526
#### Limitations
525527

526-
- **Hooks are not supported**: Multi-Provider does not currently support hook registration or execution
527-
- **Events are not supported**: Provider events are not propagated from underlying providers
528-
- **Experimental status**: The API may change in future releases
528+
- **Experimental status**: The API may change in future releases
529529

530530
For a complete example, see the [AspNetCore sample](https://github.com/open-feature/dotnet-sdk/blob/main/samples/AspNetCore/README.md) which demonstrates Multi-Provider usage.
531531

532532
### Dependency Injection
533533

534534
> [!NOTE]
535-
> The OpenFeature.DependencyInjection and OpenFeature.Hosting packages are currently experimental. They streamline the integration of OpenFeature within .NET applications, allowing for seamless configuration and lifecycle management of feature flag providers using dependency injection and hosting services.
535+
> The OpenFeature.Hosting package is currently experimental. The Hosting package streamlines the integration of OpenFeature within .NET applications, allowing for seamless configuration and lifecycle management of feature flag providers using dependency injection and hosting services.
536536
537537
#### Installation
538538

539-
To set up dependency injection and hosting capabilities for OpenFeature, install the following packages:
539+
To set up dependency injection and hosting capabilities for OpenFeature, install the following package:
540540

541541
```sh
542-
dotnet add package OpenFeature.DependencyInjection
543542
dotnet add package OpenFeature.Hosting
544543
```
545544

@@ -552,7 +551,6 @@ For a basic configuration, you can use the InMemoryProvider. This provider is si
552551
```csharp
553552
builder.Services.AddOpenFeature(featureBuilder => {
554553
featureBuilder
555-
.AddHostedFeatureLifecycle() // From Hosting package
556554
.AddInMemoryProvider();
557555
});
558556
```
@@ -574,7 +572,6 @@ builder.Services.AddOpenFeature(featureBuilder => {
574572
```csharp
575573
builder.Services.AddOpenFeature(featureBuilder => {
576574
featureBuilder
577-
.AddHostedFeatureLifecycle()
578575
.AddContext((contextBuilder, serviceProvider) => { /* Custom context configuration */ })
579576
.AddHook((serviceProvider) => new LoggingHook( /* Custom configuration */ ))
580577
.AddHook(new MetricsHook())

docs/reference/technologies/server/go.mdx

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This content has been automatically generated from go-sdk.
99
Edits should be made here: https://github.com/open-feature/go-sdk
1010
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1111

12-
Last updated at Mon Oct 06 2025 08:10:45 GMT+0000 (Coordinated Universal Time)
12+
Last updated at Mon Oct 27 2025 08:11:28 GMT+0000 (Coordinated Universal Time)
1313
-->
1414

1515
<p align="center" class="github-badges">
@@ -114,7 +114,8 @@ openfeature.SetProviderAndWait(MyProvider{})
114114
```
115115

116116
In some situations, it may be beneficial to register multiple providers in the same application.
117-
This is possible using [domains](#domains), which is covered in more details below.
117+
This is possible using [domains](#domains), which is covered in more details below, or the included [multiprovider](#multi-provider-implementation)
118+
implementation.
118119

119120
### Targeting
120121

@@ -326,6 +327,11 @@ tCtx := openfeature.MergeTransactionContext(ctx, openfeature.EvaluationContext{}
326327
client.BooleanValue(tCtx, ....)
327328
```
328329

330+
### Multi-Provider Implementation
331+
332+
Included with this SDK is an _experimental_ multi-provider that can be used to query multiple feature flag providers simultaneously.
333+
More information can be found in the [multi package's README](https://github.com/open-feature/go-sdk/blob/main/openfeature/multi/README.md).
334+
329335
## Extending
330336

331337
### Develop a provider

docs/reference/technologies/server/java.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This content has been automatically generated from java-sdk.
99
Edits should be made here: https://github.com/open-feature/java-sdk
1010
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1111

12-
Last updated at Mon Oct 06 2025 08:10:44 GMT+0000 (Coordinated Universal Time)
12+
Last updated at Mon Oct 27 2025 08:11:27 GMT+0000 (Coordinated Universal Time)
1313
-->
1414

1515
<p align="center" class="github-badges">
@@ -18,8 +18,8 @@ Last updated at Mon Oct 06 2025 08:10:44 GMT+0000 (Coordinated Universal Time)
1818
</a>
1919

2020

21-
<a href="https://github.com/open-feature/java-sdk/releases/tag/v1.18.1">
22-
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v1.18.1&color=blue&style=for-the-badge" />
21+
<a href="https://github.com/open-feature/java-sdk/releases/tag/v1.18.2">
22+
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v1.18.2&color=blue&style=for-the-badge" />
2323
</a>
2424

2525

@@ -54,7 +54,7 @@ Note that this library is intended to be used in server-side contexts and has no
5454
<dependency>
5555
<groupId>dev.openfeature</groupId>
5656
<artifactId>sdk</artifactId>
57-
<version>1.18.1</version>
57+
<version>1.18.2</version>
5858
</dependency>
5959
```
6060

@@ -77,7 +77,7 @@ If you would like snapshot builds, this is the relevant repository information:
7777

7878
```groovy
7979
dependencies {
80-
implementation 'dev.openfeature:sdk:1.18.1'
80+
implementation 'dev.openfeature:sdk:1.18.2'
8181
}
8282
```
8383

0 commit comments

Comments
 (0)