feat: Add async FDv1 streaming and data source status tracking

[jsonbailey]

Overview

Adds the async FDv1 streaming data source and its companion async data source status tracking, plus a new shared sans-I/O datasource_common module. This is one slice of the async Python SDK work.

What's included

• Async FDv1 streaming data source (ldclient/impl/datasource/async_streaming.py) — driven by ld_eventsource's AsyncSSEClient and owning its own aiohttp session via make_client_session. It consumes SSE put/patch/delete events and pushes the resulting data into the async data source update sink.

• Async data source status tracking (ldclient/impl/datasource/async_status.py — AsyncDataSourceUpdateSinkImpl and friends). The streaming source pushes data and status transitions into this update sink, so the two are runtime-coupled and land together in this slice.

• New shared sans-I/O datasource_common module (ldclient/impl/datasource/datasource_common.py) — STREAM_ALL_PATH, sink_or_store, and parse_path. Both the sync data sources and the new async streaming source use it.

• Behavior-preserving extraction of the sync data sources. streaming.py and polling.py are routed through datasource_common: the inline _sink_or_store/_parse_path/STREAM_ALL_PATH/ParsedPath definitions are removed in favor of importing the shared helpers, with call sites switched accordingly. No behavior change. The shared module is also needed by the upcoming async polling slice.

• Unified status provider (sync/async). The async status provider was unified with the sync one: the redundant AsyncDataSourceStatusProviderImpl (which had no async-specific behavior — byte-identical to the sync provider apart from its sink type) is removed, and the async data system now reuses the sync DataSourceStatusProviderImpl. To let both sinks satisfy it structurally, the sync provider's update_sink parameter was widened to a small status-only Protocol (_DataSourceStatusSource). This is the same interface-segregation pattern as the PR 1b config read-protocols and mirrors the already-unified big-segment status provider. This adds a small behavior-preserving change to sync status.py.

Notes

• The async public class carries the experimental .. caution:: block.
• No CHANGELOG entries or version bumps (handled at release time).

Tracked internally: SDK-2743

---

Note

Medium Risk
Touches core flag data ingestion (streaming, store versioning, change notifications) for the new async path; sync changes are mostly refactors to shared helpers plus a widened status-provider type.

Overview
Adds async FDv1 streaming (AsyncStreamingUpdateProcessor) and AsyncDataSourceUpdateSinkImpl so SSE put/patch/delete updates flow through the async feature store with status and flag-change notifications, mirroring the sync stack.

Introduces datasource_common (STREAM_ALL_PATH, sink_or_store, parse_path, polling endpoint constant) and wires sync streaming/polling/feature requester through it instead of duplicated helpers—no intended behavior change on the sync path.

Async store contract: AsyncFeatureStore.delete now returns whether the delete was applied; the async sink only updates dependency tracking and flag listeners when upsert/delete actually write, avoiding spurious events on stale versions.

Status provider: DataSourceStatusProviderImpl accepts a small _DataSourceStatusSource protocol so one provider works with sync and async sinks.

Async streaming owns an aiohttp session built lazily in _run via make_client_session when no SSE factory is injected, with teardown on stop/errors; extensive tests cover streaming, status sink, and session lifecycle.

^{Reviewed by Cursor Bugbot for commit a32fc16. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit c7f3f28. Configure here.}