What's changing: The JS 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; Dart and .NET add it in the same release window (powersync.dart#476, 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 — worth documenting
- No SDK reference or handling-writes page documents
DisconnectAndClearOptions (clearLocal, and now soft) in narrative form; the JavaScript Web SDK API Reference page only links out to the auto-generated typedoc site. Raw Tables already shows a Dart disconnectAndClear(soft: true) example for migrations, but nothing parallel exists for JavaScript.
Source PR: powersync-ja/powersync-js#1111 — 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 JS 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; Dart and .NET add it in the same release window (powersync.dart#476, 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 — worth documenting
DisconnectAndClearOptions(clearLocal, and nowsoft) in narrative form; the JavaScript Web SDK API Reference page only links out to the auto-generated typedoc site. Raw Tables already shows a DartdisconnectAndClear(soft: true)example for migrations, but nothing parallel exists for JavaScript.Source PR: powersync-ja/powersync-js#1111 — 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.