CHANGELOG.md

Changelog

9.0.0 (2025-11-28)

⚠ BREAKING CHANGES

• Client: Integrate SDK with context-based engine (#179)

Features

• Client: Add mapper layer for context-based engine (#177) (ef5082b)
• Client: Integrate SDK with context-based engine (#179) (a5f15b6)
• Context Values support, GetEvaluationResult (#171) (b064127)
• Send a standard User-Agent: sdk-name/version header (#172) (743b767)

Bug Fixes

• Engine: Fix segment condition evaluation across all system locales (#175) (be7ad72)
• Exclude identities when PERCENTAGE_SPLIT trait is undefined (#181) (78f9814)

Docs

• removing hero image from SDK readme (#163) (357788f)

8.0.2 (2025-05-23)

Bug Fixes

• Analytics update is blocking (#156) (06afacc)

CI

• Add release-please (#159) (a99ea42)

Changelog

v8.0.1 - 06 May 2025

What's Changed

• fix: Fix default request timeout being 0 by @rolodato in #155

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v8.0.0...v8.0.1

Changes

v8.0.0 - 28 Apr 2025

What's Changed

BREAKING CHANGES

• fix!: Remove deprecated methods and constructors. Throw error if using local eval without server-side key by @rolodato in #147

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v7.1.1...v8.0.0

Changes

v7.1.1 - 10 Apr 2025

What's Changed

• fix: RequestTimeout would return the seconds component of its TimeSpan instead of the total duration in seconds by @rolodato in #149

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v7.1.0...v7.1.1

Changes

v7.1.0 - 04 Apr 2025

What's Changed

Deprecated FlagsmithClient constructors with more than one parameter

The preferred way to instantiate a FlagsmithClient is now to use the FlagsmithClient(FlagsmithConfiguration) constructor. All other constructors are deprecated.

For example, if you were previously initialising the client like this:

new FlagsmithClient(environmentKey: "my-key", enableAnalytics: true);

You should pass the equivalent FlagsmithConfiguration object instead:

new FlagsmithClient(new FlagsmithConfiguration
{
    EnvironmentKey = "my-key",
    EnableAnalytics = true
});

This gives us more flexibility as SDK authors to add or change configuration options without requiring further breaking changes. It also allows us to provide better inline documentation for each configuration parameter.

Deprecated ApiUrl, EnableClientSideEvaluation, and EnvironmentRefreshIntervalSeconds options

Instead, use ApiUri, EnableLocalEvaluation, and EnvironmentRefreshInterval respectively. This change makes this SDK more consistent with Flagsmith documentation and other SDKs, and improves type safety by accepting Uri and TimeSpan objects instead of deriving them from raw strings or numbers.

Deprecated PollingManager(Func<Task>, int) constructor

Instead, use new PollingManager(callback, TimeSpan.FromSeconds(intervalSeconds)). Almost no users will be affected by this change, as PollingManager is meant for internal use.

Changes

v7.0.1 - 15 Jan 2025

What's Changed

• ci: fix testing workflow by @matthewelwell in #132
• fix: missing semver dependency by @matthewelwell in #130
• ci: fix release workflow by @matthewelwell in #133
• chore: bump version 7.0.1 by @matthewelwell in #134

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v7.0.0...v7.0.1

Changes

v7.0.0 - 18 Dec 2024

What's Changed

• fix!: Remove flag ID properties/methods by @rolodato in #129

Breaking Changes

Version 7 removes the Id methods from the IFlag interface and Flag class to avoid deserialisation problems if this ID is null. A flag's internal ID is an implementation detail that should not be relevant to SDK users. If you have a use case that requires using a flag's internal ID, please create an issue here: https://github.com/Flagsmith/flagsmith-dotnet-client/issues

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v6.0.0...v7.0.0

Changes

v6.0.0 - 18 Dec 2024

What's Changed

• Fixes by @mjwills-k in #126

Breaking Changes

The changes in this release affect the encoding of identifiers. This is technically fixing an issue where an identifier such as "abc&def" would actually retrieve the flags for the identity "abc" and discard the "&def" portion. Since this change will affect the behaviour for these identities, we are marking it as a major version release.

New Contributors

• @mjwills-k made their first contribution in #126

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.4.3...v6.0.0

Changes

v5.4.3 - 30 Oct 2024

What's Changed

• fix: handle null django_id in identity overrides for local evaluation mode by @rolodato in #122

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.4.2...v5.4.3

Changes

v5.4.2 - 17 Oct 2024

What's Changed

• Fix constructor deadlock when using local evaluation by @rolodato in #121

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.4.1...v5.4.2

Changes

v5.4.1 - 09 Oct 2024

What's Changed

• deps: bump artifact options by @matthewelwell in #115
• Add ConfigureAwait(false) to Flags by @ben-buckli in #118

New Contributors

• @ben-buckli made their first contribution in #118

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.4.0...v5.4.1

Changes

v5.4.0 - 11 Sep 2024

What's Changed

• feat: Transient identities and traits by @novakzaballa in #111
• Add ConfigureAwait(false) to AnalyticsProcessor by @DavidPerish in #117

New Contributors

• @DavidPerish made their first contribution in #117

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.3.2...v5.4.0

Changes

v5.3.2 - 29 Jul 2024

What's Changed

• fix: OfflineHandler causes the SDK to bypass live flag lookups by @novakzaballa in #110

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.3.1...v5.3.2

Changes

v5.3.1 - 18 Jul 2024

What's Changed

• fix: Prevent SynchronizationContext deadlock on dotnet framework by @novakzaballa in #107

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.3.0...v5.3.1

Changes

v5.3.0 - 19 Apr 2024

What's Changed

• feat: Offline mode by @novakzaballa in #86
• feat: Identity overrides in local evaluation mode by @khvn26 in #90
• feat: Implement multi-threading support for analytics Processor by @novakzaballa in #95
• chore(infra): Publish NuGet package automatically by @khvn26 in #97
• chore(infra): test against dotnet core 8 by @matthewelwell in #91
• chore: Delete example by @novakzaballa in #92

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.2.2...v5.3.0

Changes

Version 5.2.2 (v5.2.2) - 19 Apr 2024

What's Changed

• fix: Ensure environment is retrieved on start polling by @novakzaballa in #83
• fix: exception on get identity cache by @vpetrusevici in #84

New Contributors

• @vpetrusevici made their first contribution in #84

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.2.1...v5.2.2

Changes

Version 5.2.1 (v5.2.1) - 27 Oct 2023

What's Changed

• Fix cache initialisation that was some kind of circular reference. by @JFCote in #81

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.2.0...v5.2.1

Changes

Version 5.2.0 (v5.2.0) - 26 Oct 2023

What's Changed

• chore: test support for other .NET versions by @matthewelwell in #75
• Add caching by @JFCote in #77

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.1.0...v5.2.0

Changes

Version 5.1.0 (v5.1.0) - 26 Oct 2023

What's Changed

• feat: implement IN operator by @khvn26 in #72

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.0.1...v5.1.0

Changes

Version 5.0.1 (v5.0.1) - 22 Jun 2023

What's Changed

• feat: accept FlagsmithConfiguration in FlagsmithClient & small refactor by @luk355 in #67

New Contributors

• @luk355 made their first contribution in #67

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v5.0.0...v5.0.1

Changes

v5.0.0 - 15 Jun 2023

What's Changed

• BREAKING CHANGE: fix: consistent split evaluations by @khvn26 in #69

WARNING: We modified the local evaluation behaviour. You may see different flags returned to identities attributed to your percentage split-based segments after upgrading to this version.

New Contributors

• @khvn26 made their first contribution in #69

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.3.3...v5.0.0

Changes

v4.3.3 - 15 Jun 2023

What's Changed

• Bump copyright notices by @matthewelwell in #63
• Add Environment API key to identity init by @matthewelwell in #65

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.3.2...v4.3.3

Changes

v4.3.2 - 08 Jun 2023

What's Changed

• Feature/use interfaces by @tberger in #61
• Bump version 4.3.2 by @matthewelwell in #62

New Contributors

• @tberger made their first contribution in #61

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.3.1...v4.3.2

Changes

Version 4.3.1 (v4.3.1) - 29 Mar 2023

What's Changed

• Release 4.3.1 by @matthewelwell in #60

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.3.0...v4.3.1

Changes

Version 4.3.0 (v4.3.0) - 07 Mar 2023

What's Changed

• Update engine test data submodule by @matthewelwell in #58
• Add interfaces to allow unit testing in .NET app using the FlagsmithClient by @JFCote in #57
• Release 4.3.0 by @matthewelwell in #59

New Contributors

• @JFCote made their first contribution in #57

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.2.1...v4.3.0

Changes

Version 4.2.1 (v4.2.1) - 03 Nov 2022

What's Changed

• Use identity get request if no traits by @matthewelwell in #54
• Release 4.2.1 by @matthewelwell in #53

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.2.0...v4.2.1

Changes

Version 4.2.0 (v4.2.0) - 01 Nov 2022

What's Changed

• Add Modulo operator by @matthewelwell in #50
• Add IS_SET and IS_NOT_SET operators by @matthewelwell in #51
• Release 4.2.0 by @matthewelwell in #49

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.1.0...v4.2.0

Changes

Version 4.1.0 (v4.1.0) - 29 Jul 2022

What's Changed

• Add GetIdentitySegments method by @matthewelwell in #45
• Release 4.1.0 by @matthewelwell in #46

Full Changelog: https://github.com/Flagsmith/flagsmith-dotnet-client/compare/v4.0.3...v4.1.0

Changes

Version 4.0.0 (v4.0.0) - 07 Jun 2022

Changes