[5.1.0] - 2023-10-04

Changed:

• Update minimumLaunchDarkly.Logging version to2.0.0 to share the same min version as SDK implementations.

[5.0.1] - 2022-08-24

Changed:

• Relaxed dependency constraint to allow use ofLaunchDarkly.Logging 1.x or 2.x.

[5.0.0] - 2022-08-18

Changed:

• Removed EOL target framework .NET Framework 4.5.2. Lowest compatible platform versions are now .NET Core 3.1, .NET Framework 4.6.2, .NET 6.0, and .NET Standard 2.0.
• EventSource now considers any server response with an encoding other than UTF-8 to be invalid. The Server-Sent Events specification states that event streams must always use UTF-8.

Removed:

• ConfigurationBuilder.DefaultEncoding (no longer relevant since the encoding must be UTF-8).

[4.2.0] - 2022-04-19

Added:

• ConfigurationBuilder.HttpRequestModifier, for making custom modifications to outgoing HTTP requests. (Thanks,acquleo!)

[4.1.3] - 2021-10-04

Changed:

• UpdatedLaunchDarkly.Logging dependency to 1.0.1, to match the version used in the latest server-side .NET SDK release. Since .NET Framework is stricter about dependency versions than .NET Core, it is desirable to keep transitive dependency versions in sync in all packages used by the SDK.

[4.1.2] - 2021-05-17

Fixed:

• Fixed a memory leak in which aCancellationTokenSource instance was not disposed of after reading from the stream. This bug was introduced in the 4.0.0 release. (#77)

[4.1.1] - 2021-05-04

(The 4.1.0 release was an accidental duplicate of 4.0.0 and did not include these changes.)

Added:

• ConfigurationBuilder.ResponseStartTimeout-- added as a more accurately named replacement forConnectionTimeout.

Deprecated:

• ConfigurationBuilder.ConnectionTimeout

[4.1.0] - 2021-05-04

This release was an accidental duplicate of 4.0.0. Please use 4.1.1 instead.

[4.0.0] - 2021-02-22

Starting with this version, the API documentation for the latest release is viewable athttps://launchdarkly.github.io/dotnet-eventsource.

The 4.x major version ofLaunchDarkly.EventSource will be used in the upcoming major version releases of LaunchDarkly's .NET-based SDKs. This release streamlines the API, updates platform compatibility, and improves performance.

Added:

• EventSource.Restart: this method allows the caller to trigger a connection restart even if there was not an error on the stream.
• MessageEvent.Name: previously, the event name was only available as a property ofMessageReceivedEventArgs.
• ConfigurationBuilder.DefaultEncoding: sets the character encoding to use for parsing the stream data if the server did not specify an encoding in itsContent-Type.
• ConfigurationBuilder.PreferDataAsUtf8Bytes: an optional mode in whichEventSource will read thedata: property of events as a raw UTF-8 byte array (assuming the stream encoding is UTF-8) to avoid unnecessarily allocating a UTF-16string. This is meant as an optimization for applications that will be processing the data with a UTF-8-based API such asSystem.Text.Json.
• SimpleEventSource(Uri) constructor for cases where you do not need any other configuration options.
• Standard .NET XML documentation of all public types and methods is now produced in the build.
• The release now publishes aSource Link package.

Changed:

• The minimum .NET Standard compatibility version is now 2.0.
• The minimum .NET Framework compatibility version is now 4.5.2.
• Logging now works through the newLaunchDarkly.Logging facade which is used by LaunchDarkly .NET-based SDKs, instead ofCommon.Logging.
• ConfigurationBuilder methods no longer throw any exceptions, except for one case: passingnull for the stream URI. In all cases where a property has a maximum and/or minimum value, if you try to set a value outside that range it will simply be changed to the closest valid value. If two properties do not make sense to use together (such as a non-nullHttpClient and a non-nullHttpMessageHandler), one will simply override the other as described in the API documentation.
• ConfigurationBuilder.DelayRetryDuration is named toInitialRetryDelay, which more accurately describes its meaning.
• ConfigurationBuilder.MessageHandler is renamed toHttpMessageHandler, since that's the name of its type (also, "message" has other meanings in this API).
• The type ofConfiguration.HttpContentFactory is now simplyFunc<HttpContent> rather than using a custom delegate type.
• If you pass aDictionary of headers toConfigurationBuilder.RequestHeaders, it will now be copied. Previously the configuration retained a reference to the originalDictionary, which could cause problems if it was later modified.
• EventSource now implements the stream read timeout in a way that uses the task scheduler more efficiently. Previously, it executed an additional task for each read withTask.Delay; now, it uses a timed cancellation token.
• Exception messages have been rewritten for clarity and style.

Fixed:

• ConfigurationBuilder.BackoffResetThreshold had no effect; the default value was being used regardless of what you set it to.
• When reading the SSE stream,EventSource was using a case-insensitive comparison to recognize field names likeevent anddata. TheSSE specification states that field name "must be compared literally, with no case folding performed," so a field name likeEVENT is invalid.

Removed:

• Removed all types and methods that were marked as deprecated/obsolete in the last 3.x version.
• Configuration no longer has a public constructor. Instances must now be created withConfiguration.Builder.
• The helper classExponentialBackoffWithDecorrelation is no longer public.