Refactor ClearData dialog text.

Signed-off-by: Dmitri Zagidulin <dzagidulin@gmail.com>

Author: dmitrizagidulin

CHANGELOG.md

@@ -1,5 +1,18 @@
 # @interop/was-react Changelog
 
+## 0.2.1 - TBD
+
+### Changed
+
+- `ClearDataDialog` warning text is now mode-aware: once connected, it explains
+  that only the device copy is erased and the data already synced to the Web
+  Space survives (reconnect to bring it back), instead of the local-only "cannot
+  be recovered" warning, which was inaccurate in that state.
+- `clearLocalData` now also clears the persisted connected session (as `logout`
+  already did), so clearing data while connected fully disconnects -- the next
+  page load lands in `local` mode instead of silently reconnecting and syncing
+  the cleared data back down.
+
 ## 0.2.0 - 2026-07-20
 
 ### Changed

src/mui/ClearDataDialog.tsx

@@ -2,12 +2,14 @@
  * Copyright (c) 2026 Interop Alliance. All rights reserved.
  */
 /**
- * The clear-data confirmation dialog (local mode). A dumb presentational
- * component over the store's `clearLocalData` action: it confirms the
- * destructive reset -- deleting the local replica and minting a brand-new
- * anonymous identity -- and nudges the user to export their data first, since a
- * local-only, unsynced app has no server copy to recover from. Dismissing the
- * dialog (backdrop / escape / Cancel) leaves the data untouched.
+ * The clear-data confirmation dialog. A dumb presentational component over the
+ * store's `clearLocalData` action: it confirms the destructive reset --
+ * deleting the local replica and minting a brand-new anonymous identity. The
+ * warning text is mode-aware: in `local` mode the device copy is the ONLY copy,
+ * so it nudges the user to export first; once connected, the copy already
+ * synced to the Web Space survives the reset, so the text says so instead of
+ * threatening total loss. Dismissing the dialog (backdrop / escape / Cancel)
+ * leaves the data untouched.
  */
 import {
   Button,
@@ -17,7 +19,7 @@ import {
   DialogContentText,
   DialogTitle
 } from '@mui/material'
-import { useClearData } from '../react/hooks.js'
+import { useClearData, useSession } from '../react/hooks.js'
 
 /**
  * @param props {object}
@@ -34,6 +36,8 @@ export function ClearDataDialog({
   onClose: () => void
 }) {
   const clearData = useClearData()
+  const { status } = useSession()
+  const connected = status === 'connected' || status === 'reconnect'
 
   async function handleClear(): Promise<void> {
     await clearData()
@@ -45,9 +49,15 @@ export function ClearDataDialog({
       <DialogTitle>Clear data</DialogTitle>
       <DialogContent>
         <DialogContentText>
-          This permanently erases everything stored on this device and starts
-          you over fresh. Your data lives only on this device, so once cleared
-          it cannot be recovered -- export a copy first if you want to keep it.
+          {connected
+            ? 'This erases the copy stored on this device and disconnects it ' +
+              'from your Web Space. The data already saved to your Web Space ' +
+              'stays there -- reconnect with your wallet to bring it back ' +
+              'onto this device.'
+            : 'This permanently erases everything stored on this device and ' +
+              'starts you over fresh. Your data lives only on this device, ' +
+              'so once cleared it cannot be recovered -- export a copy first ' +
+              'if you want to keep it.'}
         </DialogContentText>
       </DialogContent>
       <DialogActions>

src/session/authStore.ts

@@ -24,7 +24,8 @@
  * anonymous seed + database are deleted once the activation lands. `adopt:
  * 'leave'` sets the anonymous replica aside untouched instead (it returns after
  * a logout). Logout returns to a fresh `local` (optionally wiping the connected
- * replica); `clearLocalData` mints a brand-new anonymous seed and replica.
+ * replica); `clearLocalData` mints a brand-new anonymous seed and replica and
+ * drops any persisted connected session.
  *
  * The library cannot bind a module-level store to app config, so this is a
  * FACTORY: {@link createAuthStore} captures the app's {@link WasAppConfig} and
@@ -206,8 +207,10 @@ export interface AuthState {
   logout: (options?: { wipe?: boolean }) => Promise<void>
   /**
    * Delete the local replica, discard the anonymous seed, and mint a fresh
-   * anonymous seed/DID + replica. The shared reset primitive behind the
-   * `local`-mode "Clear data" button.
+   * anonymous seed/DID + replica. Also clears any persisted connected session,
+   * so clearing while connected fully disconnects (a later boot lands `local`
+   * instead of silently reconnecting and syncing the data back down). The
+   * reset primitive behind the "Clear data" button.
    */
   clearLocalData: () => Promise<void>
   /**
@@ -931,6 +934,7 @@ export function createAuthStore({
 
       clearLocalData: async () => {
         await resetToFreshLocal({ deleteDb: true, discardAnonSeed: true })
+        await clearAppSession({ store: sessionStore })
         set({ phase: null, reconnecting: false })
       },
 

test/node/authStore.test.ts

@@ -15,7 +15,8 @@
  *   `local -> connected`, tearing down the anonymous replica but leaving its
  *   seed intact; a cancelled `login()` leaves `local` intact;
  * - `logout({ wipe })` keeps vs deletes the connected replica, landing `local`;
- * - `clearLocalData()` mints a brand-new anonymous seed/DID and empties stores.
+ * - `clearLocalData()` mints a brand-new anonymous seed/DID, empties stores,
+ *   and drops any persisted connected session.
  *
  * @vitest-environment node
  */
@@ -625,4 +626,18 @@ describe('clearLocalData()', () => {
     expect(store.getState().controllerDid).toMatch(/^did:key:/)
     expect(await requireStore().listEntities('notes')).toHaveLength(0)
   })
+
+  it('clears the persisted session when run while connected', async () => {
+    const seedStore = newSeedStore()
+    await persistSession({ seedStore })
+    const store = makeStore(baseConfig(), seedStore)
+    await store.getState().boot()
+    expect(store.getState().status).toBe('connected')
+
+    await store.getState().clearLocalData()
+
+    expect(store.getState().status).toBe('local')
+    // The session record was cleared, so a later boot cannot reconnect.
+    expect(await seedStore.loadSeed()).toBeNull()
+  })
 })