What's changing: The Dart SDK adds a soft option to disconnectAndClear. Enabling it deletes locally visible (ps_data__) tables but keeps internal sync state (ps_buckets, ps_oplog) intact, so a later connect() call from the same user completes its first sync quickly instead of re-downloading everything. The Kotlin and Swift SDKs already support this option; JavaScript and .NET add it in the same release window (powersync-js#1111, powersync-dotnet#101).
High priority — existing docs are now inaccurate or incomplete
- Reducing Usage (https://docs.powersync.com/resources/usage-and-billing/reducing-usage), "Avoiding Unnecessary Full Re-Syncs" section: presents
disconnectAndClear() and disconnect() as the only two sign-out options, implying a returning user can only avoid a full re-sync by not clearing data at all. It doesn't mention the new soft option, which clears locally visible data while keeping internal sync state so a returning user's reconnect stays fast.
For reviewer consideration
None beyond the above. Raw Tables, "Deleting Data on Migrations" section, already shows await db.disconnectAndClear(soft: true) for Dart, so that usage is already covered.
Source PR: powersync-ja/powersync.dart#476 — merged 2026-09-17.
Filed automatically by Claude Code (claude-sonnet-5). A human must verify the scope, prepare the docs PR, and publish it only once this update has been released.
What's changing: The Dart SDK adds a
softoption todisconnectAndClear. Enabling it deletes locally visible (ps_data__) tables but keeps internal sync state (ps_buckets,ps_oplog) intact, so a laterconnect()call from the same user completes its first sync quickly instead of re-downloading everything. The Kotlin and Swift SDKs already support this option; JavaScript and .NET add it in the same release window (powersync-js#1111, powersync-dotnet#101).High priority — existing docs are now inaccurate or incomplete
disconnectAndClear()anddisconnect()as the only two sign-out options, implying a returning user can only avoid a full re-sync by not clearing data at all. It doesn't mention the newsoftoption, which clears locally visible data while keeping internal sync state so a returning user's reconnect stays fast.For reviewer consideration
None beyond the above. Raw Tables, "Deleting Data on Migrations" section, already shows
await db.disconnectAndClear(soft: true)for Dart, so that usage is already covered.Source PR: powersync-ja/powersync.dart#476 — merged 2026-09-17.
Filed automatically by Claude Code (
claude-sonnet-5). A human must verify the scope, prepare the docs PR, and publish it only once this update has been released.