@buoy-gg/time-machine 7.0.41 → 7.0.42

package/lib/module/store/timeMachineStore.js

@@ -1,839 +1 @@
-"use strict";
-
-/**
- * Time Machine orchestrator — snapshot CRUD + capture/restore across every
- * registered StateSnapshotProvider (storage, redux, zustand, jotai, query,
- * plus any custom providers the app registers).
- *
- * Restore ordering is fixed: persisted storage FIRST (so store persist
- * middleware writing through after an in-memory restore converges with what
- * we just wrote), then redux → zustand → jotai, query LAST (restored queries
- * may derive from store state). Custom providers run after, in data order.
- *
- * Two restore modes:
- * - "live":   in-place state replacement, capability-gated per source.
- * - "reload": restore ONLY persisted storage, then reload the JS bundle —
- *             in-memory stores rebuild themselves from the restored storage.
- *             Baseline snapshots always use this path (clear + reload).
- */
-import { getStateSnapshotProvider, getStateSnapshotProviders, scheduleReloadApp, superJsonDeserialize, superJsonSerialize } from "@buoy-gg/shared-ui";
-import { objectDiff } from "@buoy-gg/shared-ui/dataViewer";
-import { deleteSnapshot, duplicateSnapshot, loadIndex, loadSnapshot, markSnapshotRestored, readSnapshot, renameSnapshot, restoreDeletedSnapshot, saveSnapshot, setSnapshotRestoreRoute, setSnapshotScope, setSnapshotExclusions } from "./snapshotVault";
-import { captureCurrentRoute, navigateToRoute, savePendingRoute } from "./routeRestore";
-import { ensureSourceSettingsLoaded, isSourceEnabled } from "./sourceSettings";
-import { ROUTE_SOURCE_ID } from "./sourceIds";
-export const RESTORE_ORDER = ["storage", "redux", "zustand", "jotai", "query"];
-/**
- * What to call a capture nobody named. The screen you were on plus the time
- * is the pair that makes a restore point recognizable an hour later —
- * "Untitled snapshot" never was, and typing mid-flow is the friction that
- * produced it.
- */
-function defaultSnapshotName(route) {
-  const now = new Date();
-  const clock = `${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}`;
-  const screen = route ? route.pathname === "/" ? "Home" : route.pathname : null;
-  return screen ? `${screen} · ${clock}` : `Snapshot · ${clock}`;
-}
-
-/**
- * Two captures in the same minute on the same screen would get the same
- * default name and be told apart by nothing. Number the repeats.
- */
-function dedupeName(name, existing) {
-  const taken = new Set(existing.map(m => m.name));
-  if (!taken.has(name)) return name;
-  for (let n = 2; n < 1000; n++) {
-    const candidate = `${name} (${n})`;
-    if (!taken.has(candidate)) return candidate;
-  }
-  return name;
-}
-
-/**
- * Will restoring this point also navigate back to its route? Having a route
- * means wanting it back unless the point says otherwise — the same rule
- * `restore` applies, exported so the UI can't drift from it.
- */
-export function willRestoreRoute(meta) {
-  return !!meta.route && (meta.restoreRoute ?? true);
-}
-
-/** Extra knobs a restore accepts beyond mode + exclusions. */
-
-export const SAFETY_SNAPSHOT_NAME = "Before last restore";
-
-/** Provider capability row as mirrored to a remote dashboard. */
-
-/** One side of a preview comparison. */
-
-/** Whether this device can capture and return to routes, and where it is now. */
-
-let remoteHandler = null;
-function skippedResult(reason) {
-  return {
-    ok: false,
-    applied: 0,
-    skipped: [{
-      id: "*",
-      reason
-    }],
-    warnings: []
-  };
-}
-let idCounter = 0;
-function nextId() {
-  idCounter += 1;
-  return `snap_${Date.now().toString(36)}_${idCounter.toString(36)}`;
-}
-class TimeMachineStore {
-  state = {
-    snapshots: [],
-    hasLoaded: false,
-    busy: null,
-    lastOutcome: null,
-    preview: null,
-    remoteProviders: null,
-    remoteRoute: null,
-    recentlyDeleted: null
-  };
-  /** Monotonic token — a preview build checks it after every await and
-   * abandons itself when a newer build (or clearPreview) supersedes it. */
-  previewRunId = 0;
-  listeners = new Set();
-  loadPromise = null;
-  getState() {
-    return this.state;
-  }
-  subscribe = listener => {
-    this.listeners.add(listener);
-    void this.ensureLoaded();
-    return () => {
-      this.listeners.delete(listener);
-    };
-  };
-  setState(patch) {
-    this.state = {
-      ...this.state,
-      ...patch
-    };
-    this.listeners.forEach(l => {
-      try {
-        l();
-      } catch {
-        // listener errors must not break the store
-      }
-    });
-  }
-  ensureLoaded() {
-    if (remoteHandler) return Promise.resolve(); // mirror mode — device owns the vault
-    if (!this.loadPromise) {
-      this.loadPromise = loadIndex().then(snapshots => {
-        if (remoteHandler) return;
-        this.setState({
-          snapshots,
-          hasLoaded: true
-        });
-      });
-    }
-    return this.loadPromise;
-  }
-
-  /** @internal Buoy Desktop: mirror the device's synced metadata payload. */
-  replaceFromSnapshot(payload) {
-    this.setState({
-      snapshots: payload.snapshots ?? [],
-      busy: payload.busy ?? null,
-      lastOutcome: payload.lastOutcome ?? null,
-      remoteProviders: payload.providers ?? [],
-      remoteRoute: payload.route ?? {
-        available: false
-      },
-      hasLoaded: true
-    });
-  }
-
-  /** Capture all capturable sources (or a subset) into a named snapshot. */
-  async capture(name, sourceIds, options) {
-    if (remoteHandler) {
-      const result = await remoteHandler("capture", {
-        name,
-        sourceIds
-      });
-      return result.snapshot;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    this.setState({
-      busy: "capture"
-    });
-    try {
-      const providers = getStateSnapshotProviders().filter(p => p.status().canCapture && isSourceEnabled(p.id) && (!sourceIds || sourceIds.includes(p.id)));
-      const data = {};
-      const sources = {};
-      for (const provider of providers) {
-        try {
-          const captured = await provider.capture();
-          data[provider.id] = superJsonSerialize(captured.data);
-          sources[provider.id] = {
-            warnings: captured.warnings
-          };
-        } catch (e) {
-          sources[provider.id] = {
-            warnings: [`capture failed: ${String(e)}`]
-          };
-        }
-      }
-      // Where the app was when this state was true — restoring can return here.
-      const route = isSourceEnabled(ROUTE_SOURCE_ID) ? captureCurrentRoute() : null;
-      // The safety slot is rolling: the previous one goes before this one lands.
-      let current = this.state.snapshots;
-      if (options?.safety) {
-        for (const stale of current.filter(m => m.safety)) {
-          current = await deleteSnapshot(stale.id, current);
-        }
-      }
-      const snapshot = {
-        meta: {
-          id: nextId(),
-          name: options?.safety ? SAFETY_SNAPSHOT_NAME : dedupeName(name.trim() || defaultSnapshotName(route), current),
-          createdAt: Date.now(),
-          sizeBytes: 0,
-          ...(route ? {
-            route
-          } : {}),
-          ...(options?.safety ? {
-            safety: true
-          } : {}),
-          sources
-        },
-        data
-      };
-      const snapshots = await saveSnapshot(snapshot, current);
-      this.setState({
-        snapshots
-      });
-      return snapshot.meta;
-    } finally {
-      this.setState({
-        busy: null
-      });
-    }
-  }
-
-  /**
-   * Capture the fresh-install baseline: an EMPTY snapshot whose restore
-   * wipes app state (clear + reload) — regardless of what state the app is
-   * in when the button is pressed.
-   */
-  async captureBaseline() {
-    if (remoteHandler) {
-      const result = await remoteHandler("captureBaseline", {});
-      return result.snapshot;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const snapshot = {
-      meta: {
-        id: nextId(),
-        name: "Fresh install",
-        createdAt: Date.now(),
-        sizeBytes: 0,
-        baseline: true,
-        sources: {}
-      },
-      data: {}
-    };
-    const snapshots = await saveSnapshot(snapshot, this.state.snapshots);
-    this.setState({
-      snapshots
-    });
-    return snapshot.meta;
-  }
-
-  /**
-   * `excludeKeys` entries are compound `"sourceId::itemKey"` strings (the
-   * itemKey being what previewItems emitted) — split per source before each
-   * provider sees only its own keys.
-   */
-  async restore(id, mode, excludeKeys, options) {
-    if (remoteHandler) {
-      const outcome = await remoteHandler("restore", {
-        id,
-        mode,
-        excludeKeys,
-        restoreRoute: options?.restoreRoute
-      });
-      this.setState({
-        lastOutcome: outcome
-      });
-      return outcome;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    // The way back from a mis-tap: capture what is about to be replaced.
-    // Restoring the safety slot itself never rolls it, or Undo would eat
-    // its own target.
-    let safetySnapshotId;
-    if (options?.safetyCapture && !this.state.snapshots.find(m => m.id === id)?.safety) {
-      safetySnapshotId = (await this.capture(SAFETY_SNAPSHOT_NAME, undefined, {
-        safety: true
-      })).id;
-    }
-    this.setState({
-      busy: "restore"
-    });
-    try {
-      const stored = await loadSnapshot(id);
-      if (!stored) throw new Error(`No snapshot with id "${id}"`);
-      const outcome = {
-        snapshotId: id,
-        snapshotName: stored.meta.name,
-        mode,
-        at: Date.now(),
-        willReload: false,
-        results: {},
-        ...(safetySnapshotId ? {
-          safetySnapshotId
-        } : {})
-      };
-      if (stored.meta.baseline) {
-        // Fresh install: wipe every clearable source, then reload so all
-        // in-memory state rebuilds from nothing.
-        for (const provider of getStateSnapshotProviders()) {
-          if (provider.clear) {
-            try {
-              outcome.results[provider.id] = await provider.clear();
-            } catch (e) {
-              outcome.results[provider.id] = skippedResult(String(e));
-            }
-          }
-        }
-        outcome.willReload = this.scheduleReload("buoy time-machine baseline");
-        this.setState({
-          lastOutcome: outcome
-        });
-        return outcome;
-      }
-      const sourceIds = [...RESTORE_ORDER.filter(sid => sid in stored.data), ...Object.keys(stored.data).filter(sid => !RESTORE_ORDER.includes(sid))];
-      const splitCompound = keys => {
-        const bySource = new Map();
-        for (const compound of keys) {
-          const sep = compound.indexOf("::");
-          if (sep <= 0) continue;
-          const sid = compound.slice(0, sep);
-          const itemKey = compound.slice(sep + 2);
-          const list = bySource.get(sid) ?? [];
-          list.push(itemKey);
-          bySource.set(sid, list);
-        }
-        return bySource;
-      };
-
-      // No explicit list means "use what the user saved in the preview" —
-      // that is what makes an unchecked item stay unchecked forever, for the
-      // one-tap RESTORE on the list and for MCP alike.
-      const effectiveExcludes = excludeKeys ?? stored.meta.excludedKeys ?? [];
-      const excludeBySource = splitCompound(effectiveExcludes);
-      // A saved scope makes this a targeted restore point. An explicit
-      // exclusion list from the preview already reflects the scope (the
-      // preview seeds its selection from it), so it takes precedence.
-      const includeBySource = !excludeKeys && stored.meta.scope?.length ? splitCompound(stored.meta.scope) : null;
-
-      // No prompt any more: the point carries its own answer, and having a
-      // route means wanting it back unless you said otherwise. An explicit
-      // option still wins, so MCP and the desktop can force either way.
-      const wantsRoute = isSourceEnabled(ROUTE_SOURCE_ID) && (options?.restoreRoute ?? willRestoreRoute(stored.meta));
-      if (mode === "reload") {
-        // Storage only; everything in-memory rebuilds after the reload.
-        if (stored.data.storage && isSourceEnabled("storage") && (!includeBySource || includeBySource.has("storage"))) {
-          outcome.results.storage = await this.restoreSource("storage", stored.data.storage, excludeBySource.get("storage"), includeBySource?.get("storage"));
-        }
-        // Hand the route to the NEXT boot — this realm is about to die, so the
-        // slot must be written before the reload is armed.
-        if (wantsRoute) {
-          const route = stored.meta.route;
-          try {
-            await savePendingRoute(route, stored.meta.name);
-            outcome.route = {
-              ...route,
-              status: "deferred"
-            };
-          } catch (e) {
-            outcome.route = {
-              ...route,
-              status: "failed",
-              error: String(e)
-            };
-          }
-        }
-        outcome.willReload = this.scheduleReload("buoy time-machine restore");
-        // Stamped BEFORE the reload is armed — the JS realm is about to die.
-        this.setState({
-          lastOutcome: outcome,
-          snapshots: await markSnapshotRestored(id, outcome.at, this.state.snapshots)
-        });
-        return outcome;
-      }
-      for (const sid of sourceIds) {
-        // Sources entirely outside the scope are untouched and unreported.
-        if (includeBySource && !includeBySource.has(sid)) continue;
-        // A source switched off in Sources is left exactly as it is. Reported
-        // as a warning, not a failure: this is what you asked for.
-        if (!isSourceEnabled(sid)) {
-          outcome.results[sid] = {
-            ok: true,
-            applied: 0,
-            skipped: [],
-            warnings: ["Switched off in Sources; left as it is"]
-          };
-          continue;
-        }
-        outcome.results[sid] = await this.restoreSource(sid, stored.data[sid], excludeBySource.get(sid), includeBySource?.get(sid));
-      }
-      // Navigate LAST — the screen we land on should read the restored state.
-      if (wantsRoute) {
-        outcome.route = navigateToRoute(stored.meta.route);
-      }
-      this.setState({
-        lastOutcome: outcome,
-        snapshots: await markSnapshotRestored(id, outcome.at, this.state.snapshots)
-      });
-      return outcome;
-    } finally {
-      this.setState({
-        busy: null
-      });
-    }
-  }
-  async restoreSource(sourceId, payload, excludeKeys, includeKeys) {
-    const provider = getStateSnapshotProvider(sourceId);
-    if (!provider) {
-      return skippedResult("provider not available (package missing or not initialized)");
-    }
-    const status = provider.status();
-    if (!status.canRestore) {
-      return skippedResult(status.detail ?? "restore unavailable");
-    }
-    try {
-      const options = excludeKeys?.length || includeKeys?.length ? {
-        ...(excludeKeys?.length ? {
-          excludeKeys
-        } : {}),
-        ...(includeKeys?.length ? {
-          includeKeys
-        } : {})
-      } : undefined;
-      return await provider.restore(superJsonDeserialize(payload), options);
-    } catch (e) {
-      return skippedResult(String(e));
-    }
-  }
-  scheduleReload(reason) {
-    try {
-      scheduleReloadApp({
-        reason
-      });
-      return true;
-    } catch {
-      // No reload mechanism (bare production build?) — restore still stands.
-      return false;
-    }
-  }
-
-  /**
-   * Delete, holding the whole record in memory so `undoDelete` can put it
-   * back. Swipe-and-tap is deliberate but not recoverable, and those are
-   * different properties — a restore point can represent state that takes
-   * ten minutes and a cooperative backend to rebuild.
-   */
-  async delete(id) {
-    if (remoteHandler) {
-      await remoteHandler("delete", {
-        id
-      });
-      return;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const stored = await readSnapshot(id);
-    const snapshots = await deleteSnapshot(id, this.state.snapshots);
-    this.setState({
-      snapshots,
-      recentlyDeleted: stored ? {
-        stored,
-        at: Date.now()
-      } : null
-    });
-  }
-
-  /** Put the last deleted point back. No-op once the window has passed. */
-  async undoDelete() {
-    const held = this.state.recentlyDeleted;
-    if (!held) return;
-    const snapshots = await restoreDeletedSnapshot(held.stored, this.state.snapshots);
-    this.setState({
-      snapshots,
-      recentlyDeleted: null
-    });
-  }
-
-  /** Drop the undo offer — on timeout, or when the user moves on. */
-  clearRecentlyDeleted() {
-    if (this.state.recentlyDeleted) this.setState({
-      recentlyDeleted: null
-    });
-  }
-
-  /** Turn this point's route restore on or off. */
-  async setRestoreRoute(id, restoreRoute) {
-    if (remoteHandler) {
-      await remoteHandler("setRestoreRoute", {
-        id,
-        restoreRoute
-      });
-      return;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const snapshots = await setSnapshotRestoreRoute(id, restoreRoute, this.state.snapshots);
-    this.setState({
-      snapshots
-    });
-  }
-
-  /** Copy a point so a variation can start from a known-good base. */
-  async duplicate(id) {
-    if (remoteHandler) {
-      const result = await remoteHandler("duplicate", {
-        id
-      });
-      return result?.snapshot ?? null;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const source = this.state.snapshots.find(s => s.id === id);
-    if (!source) return null;
-    const result = await duplicateSnapshot(id, `${source.name} copy`, this.state.snapshots);
-    if (!result) return null;
-    this.setState({
-      snapshots: result.metas
-    });
-    return result.meta;
-  }
-  async rename(id, name) {
-    if (remoteHandler) {
-      await remoteHandler("rename", {
-        id,
-        name
-      });
-      return;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const snapshots = await renameSnapshot(id, name, this.state.snapshots);
-    this.setState({
-      snapshots
-    });
-  }
-
-  /**
-   * Save (or clear with null/empty) a snapshot's restore scope — compound
-   * "sourceId::itemKey" strings. A scoped restore point only ever touches
-   * its scoped items.
-   */
-  async setScope(id, scope) {
-    if (remoteHandler) {
-      await remoteHandler("setScope", {
-        id,
-        scope
-      });
-      return;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const snapshots = await setSnapshotScope(id, scope, this.state.snapshots);
-    this.setState({
-      snapshots
-    });
-  }
-
-  /**
-   * Save (or clear with null/empty) the items every later restore of this
-   * snapshot must leave untouched — what the restore preview's checkboxes
-   * write when you save a selection.
-   */
-  async setExclusions(id, excludedKeys) {
-    if (remoteHandler) {
-      await remoteHandler("setExclusions", {
-        id,
-        excludedKeys
-      });
-      return;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const snapshots = await setSnapshotExclusions(id, excludedKeys, this.state.snapshots);
-    this.setState({
-      snapshots
-    });
-  }
-  clearLastOutcome() {
-    this.setState({
-      lastOutcome: null
-    });
-  }
-
-  /**
-   * Wipe every clearable source to fresh-install state and reload — the
-   * standalone utility behind the home screen's "Wipe all app state" button
-   * (no baseline snapshot involved).
-   */
-  async wipeAll() {
-    if (remoteHandler) {
-      const outcome = await remoteHandler("wipeAll", {});
-      this.setState({
-        lastOutcome: outcome
-      });
-      return outcome;
-    }
-    this.setState({
-      busy: "restore"
-    });
-    try {
-      const outcome = {
-        snapshotId: "wipe-all",
-        snapshotName: "Wipe all",
-        mode: "reload",
-        at: Date.now(),
-        willReload: false,
-        results: {}
-      };
-      for (const provider of getStateSnapshotProviders()) {
-        if (provider.clear) {
-          try {
-            outcome.results[provider.id] = await provider.clear();
-          } catch (e) {
-            outcome.results[provider.id] = skippedResult(String(e));
-          }
-        }
-      }
-      outcome.willReload = this.scheduleReload("buoy time-machine wipe all");
-      this.setState({
-        lastOutcome: outcome
-      });
-      return outcome;
-    } finally {
-      this.setState({
-        busy: null
-      });
-    }
-  }
-  clearPreview() {
-    this.previewRunId += 1;
-    this.setState({
-      preview: null
-    });
-  }
-
-  /**
-   * Build (or rebuild) the restore preview: item-level verdicts per source,
-   * filled in incrementally with a frame yield between sources so a big app
-   * never freezes the JS thread in one go.
-   */
-  async buildPreview(right, left = "current") {
-    if (remoteHandler) {
-      // Buoy Desktop: the device builds it; result mirrors into state.
-      const runId = ++this.previewRunId;
-      this.setState({
-        preview: {
-          left,
-          right,
-          building: true,
-          builtAt: Date.now(),
-          sources: []
-        }
-      });
-      try {
-        const result = await remoteHandler("preview", {
-          id: right === "current" ? undefined : right.snapshotId,
-          compareTo: left === "current" ? undefined : left.snapshotId
-        });
-        if (runId !== this.previewRunId) return;
-        this.setState({
-          preview: {
-            left,
-            right,
-            building: false,
-            builtAt: Date.now(),
-            sources: result.sources ?? []
-          }
-        });
-      } catch (e) {
-        if (runId !== this.previewRunId) return;
-        this.setState({
-          preview: {
-            left,
-            right,
-            building: false,
-            builtAt: Date.now(),
-            sources: [{
-              id: "error",
-              label: "Preview",
-              items: [],
-              notes: [],
-              error: String(e)
-            }]
-          }
-        });
-      }
-      return;
-    }
-    await this.ensureLoaded();
-    await ensureSourceSettingsLoaded();
-    const runId = ++this.previewRunId;
-    this.setState({
-      preview: {
-        left,
-        right,
-        building: true,
-        builtAt: Date.now(),
-        sources: []
-      }
-    });
-    const loadSide = async ref => {
-      if (ref === "current") return null; // providers capture live themselves
-      const stored = await loadSnapshot(ref.snapshotId);
-      if (!stored) throw new Error(`No snapshot with id "${ref.snapshotId}"`);
-      return stored.data;
-    };
-    try {
-      if (right === "current") throw new Error("preview target must be a snapshot");
-      const [leftData, rightStored] = await Promise.all([loadSide(left), loadSnapshot(right.snapshotId)]);
-      if (runId !== this.previewRunId) return;
-      if (!rightStored) {
-        throw new Error(`No snapshot with id "${right.snapshotId}"`);
-      }
-      const rightData = rightStored.data;
-
-      // Baseline = empty target: preview every clearable source against live,
-      // so each live key naturally reads as "removed" — the informed wipe.
-      const isBaseline = rightStored.meta.baseline === true;
-      const sourceIds = isBaseline ? getStateSnapshotProviders().filter(p => p.clear).map(p => p.id) : [...RESTORE_ORDER.filter(sid => sid in rightData), ...Object.keys(rightData).filter(sid => !RESTORE_ORDER.includes(sid))];
-      const sources = [];
-      for (const sid of sourceIds) {
-        // Off in Sources: a restore will not touch it, so there is nothing
-        // to preview.
-        if (!isSourceEnabled(sid)) continue;
-        // Yield a frame between sources — verdict passes are bounded but a
-        // five-source build shouldn't run as one synchronous block.
-        await new Promise(r => setTimeout(r, 0));
-        if (runId !== this.previewRunId) return;
-        const provider = getStateSnapshotProvider(sid);
-        const label = provider?.label ?? sid;
-        try {
-          const targetData = isBaseline ? undefined // provider treats an absent target as "empty"
-          : superJsonDeserialize(rightData[sid]);
-          const baseData = leftData === null ? undefined : sid in leftData ? superJsonDeserialize(leftData[sid]) : undefined;
-          let result;
-          if (!provider) {
-            result = {
-              items: [{
-                key: sid,
-                label,
-                verdict: "wont-apply",
-                reason: "tool not installed — restore skips this source"
-              }],
-              notes: []
-            };
-          } else if (provider.previewItems) {
-            result = await provider.previewItems(targetData, baseData);
-          } else {
-            // Whole-source fallback for custom providers without previewItems.
-            const diff = objectDiff(baseData, targetData);
-            result = {
-              items: [{
-                key: sid,
-                label,
-                verdict: diff.equal ? "unchanged" : "changed",
-                oldValue: baseData,
-                newValue: targetData
-              }],
-              notes: diff.truncated ? ["diff truncated (large value)"] : []
-            };
-          }
-          if (runId !== this.previewRunId) return;
-          sources.push({
-            id: sid,
-            label,
-            ...result
-          });
-        } catch (e) {
-          sources.push({
-            id: sid,
-            label,
-            items: [],
-            notes: [],
-            error: String(e)
-          });
-        }
-        this.setState({
-          preview: {
-            left,
-            right,
-            building: true,
-            builtAt: Date.now(),
-            sources: [...sources]
-          }
-        });
-      }
-      if (runId !== this.previewRunId) return;
-      this.setState({
-        preview: {
-          left,
-          right,
-          building: false,
-          builtAt: Date.now(),
-          sources
-        }
-      });
-    } catch (e) {
-      if (runId !== this.previewRunId) return;
-      this.setState({
-        preview: {
-          left,
-          right,
-          building: false,
-          builtAt: Date.now(),
-          sources: [{
-            id: "error",
-            label: "Preview",
-            items: [],
-            notes: [],
-            error: String(e)
-          }]
-        }
-      });
-    }
-  }
-}
-export const timeMachineStore = new TimeMachineStore();
-
-/**
- * Buoy Desktop: route every Time Machine operation through a remote handler
- * (the device's sync adapter actions) instead of running locally. Pass null
- * to detach. While attached, feed device payloads to
- * {@link replaceTimeMachineFromSnapshot}.
- */
-export function setRemoteTimeMachineHandler(handler) {
-  remoteHandler = handler;
-  if (!handler) {
-    timeMachineStore.replaceFromSnapshot({});
-  }
-}
-
-/** Buoy Desktop: mirror a device's synced Time Machine metadata payload. */
-export function replaceTimeMachineFromSnapshot(payload) {
-  timeMachineStore.replaceFromSnapshot(payload);
-}
-//# sourceMappingURL=timeMachineStore.js.map
+"use strict";import{getStateSnapshotProvider as L,getStateSnapshotProviders as b,scheduleReloadApp as B,superJsonDeserialize as D,superJsonSerialize as M}from"@buoy-gg/shared-ui";import{objectDiff as _}from"@buoy-gg/shared-ui/dataViewer";import{deleteSnapshot as P,duplicateSnapshot as z,loadIndex as C,loadSnapshot as I,markSnapshotRestored as A,readSnapshot as F,renameSnapshot as H,restoreDeletedSnapshot as j,saveSnapshot as k,setSnapshotRestoreRoute as q,setSnapshotScope as J,setSnapshotExclusions as U}from"./snapshotVault";import{captureCurrentRoute as V,navigateToRoute as W,savePendingRoute as Y}from"./routeRestore";import{ensureSourceSettingsLoaded as w,isSourceEnabled as g}from"./sourceSettings";import{ROUTE_SOURCE_ID as $}from"./sourceIds";export const RESTORE_ORDER=["storage","redux","zustand","jotai","query"];function G(c){const t=new Date;const e=`${String(t.getHours()).padStart(2,"0")}:${String(t.getMinutes()).padStart(2,"0")}`;const s=c?c.pathname==="/"?"Home":c.pathname:null;return s?`${s} \xB7 ${e}`:`Snapshot \xB7 ${e}`}function Q(c,t){const e=new Set(t.map(s=>s.name));if(!e.has(c))return c;for(let s=2;s<1e3;s++){const l=`${c} (${s})`;if(!e.has(l))return l}return c}export function willRestoreRoute(c){return!!c.route&&(c.restoreRoute??true)}export const SAFETY_SNAPSHOT_NAME="Before last restore";let o=null;function R(c){return{ok:false,applied:0,skipped:[{id:"*",reason:c}],warnings:[]}}let x=0;function T(){x+=1;return`snap_${Date.now().toString(36)}_${x.toString(36)}`}class X{state={snapshots:[],hasLoaded:false,busy:null,lastOutcome:null,preview:null,remoteProviders:null,remoteRoute:null,recentlyDeleted:null};previewRunId=0;listeners=new Set;loadPromise=null;getState(){return this.state}subscribe=t=>{this.listeners.add(t);void this.ensureLoaded();return()=>{this.listeners.delete(t)}};setState(t){this.state={...this.state,...t};this.listeners.forEach(e=>{try{e()}catch{}})}ensureLoaded(){if(o)return Promise.resolve();if(!this.loadPromise){this.loadPromise=C().then(t=>{if(o)return;this.setState({snapshots:t,hasLoaded:true})})}return this.loadPromise}replaceFromSnapshot(t){this.setState({snapshots:t.snapshots??[],busy:t.busy??null,lastOutcome:t.lastOutcome??null,remoteProviders:t.providers??[],remoteRoute:t.route??{available:false},hasLoaded:true})}async capture(t,e,s){if(o){const l=await o("capture",{name:t,sourceIds:e});return l.snapshot}await this.ensureLoaded();await w();this.setState({busy:"capture"});try{const l=b().filter(r=>r.status().canCapture&&g(r.id)&&(!e||e.includes(r.id)));const u={};const a={};for(const r of l){try{const d=await r.capture();u[r.id]=M(d.data);a[r.id]={warnings:d.warnings}}catch(d){a[r.id]={warnings:[`capture failed: ${String(d)}`]}}}const i=g($)?V():null;let p=this.state.snapshots;if(s?.safety){for(const r of p.filter(d=>d.safety)){p=await P(r.id,p)}}const S={meta:{id:T(),name:s?.safety?SAFETY_SNAPSHOT_NAME:Q(t.trim()||G(i),p),createdAt:Date.now(),sizeBytes:0,...i?{route:i}:{},...s?.safety?{safety:true}:{},sources:a},data:u};const f=await k(S,p);this.setState({snapshots:f});return S.meta}finally{this.setState({busy:null})}}async captureBaseline(){if(o){const s=await o("captureBaseline",{});return s.snapshot}await this.ensureLoaded();await w();const t={meta:{id:T(),name:"Fresh install",createdAt:Date.now(),sizeBytes:0,baseline:true,sources:{}},data:{}};const e=await k(t,this.state.snapshots);this.setState({snapshots:e});return t.meta}async restore(t,e,s,l){if(o){const a=await o("restore",{id:t,mode:e,excludeKeys:s,restoreRoute:l?.restoreRoute});this.setState({lastOutcome:a});return a}await this.ensureLoaded();await w();let u;if(l?.safetyCapture&&!this.state.snapshots.find(a=>a.id===t)?.safety){u=(await this.capture(SAFETY_SNAPSHOT_NAME,void 0,{safety:true})).id}this.setState({busy:"restore"});try{const a=await I(t);if(!a)throw new Error(`No snapshot with id "${t}"`);const i={snapshotId:t,snapshotName:a.meta.name,mode:e,at:Date.now(),willReload:false,results:{},...u?{safetySnapshotId:u}:{}};if(a.meta.baseline){for(const n of b()){if(n.clear){try{i.results[n.id]=await n.clear()}catch(h){i.results[n.id]=R(String(h))}}}i.willReload=this.scheduleReload("buoy time-machine baseline");this.setState({lastOutcome:i});return i}const p=[...RESTORE_ORDER.filter(n=>n in a.data),...Object.keys(a.data).filter(n=>!RESTORE_ORDER.includes(n))];const S=n=>{const h=new Map;for(const m of n){const v=m.indexOf("::");if(v<=0)continue;const O=m.slice(0,v);const N=m.slice(v+2);const E=h.get(O)??[];E.push(N);h.set(O,E)}return h};const f=s??a.meta.excludedKeys??[];const r=S(f);const d=!s&&a.meta.scope?.length?S(a.meta.scope):null;const y=g($)&&(l?.restoreRoute??willRestoreRoute(a.meta));if(e==="reload"){if(a.data.storage&&g("storage")&&(!d||d.has("storage"))){i.results.storage=await this.restoreSource("storage",a.data.storage,r.get("storage"),d?.get("storage"))}if(y){const n=a.meta.route;try{await Y(n,a.meta.name);i.route={...n,status:"deferred"}}catch(h){i.route={...n,status:"failed",error:String(h)}}}i.willReload=this.scheduleReload("buoy time-machine restore");this.setState({lastOutcome:i,snapshots:await A(t,i.at,this.state.snapshots)});return i}for(const n of p){if(d&&!d.has(n))continue;if(!g(n)){i.results[n]={ok:true,applied:0,skipped:[],warnings:["Switched off in Sources; left as it is"]};continue}i.results[n]=await this.restoreSource(n,a.data[n],r.get(n),d?.get(n))}if(y){i.route=W(a.meta.route)}this.setState({lastOutcome:i,snapshots:await A(t,i.at,this.state.snapshots)});return i}finally{this.setState({busy:null})}}async restoreSource(t,e,s,l){const u=L(t);if(!u){return R("provider not available (package missing or not initialized)")}const a=u.status();if(!a.canRestore){return R(a.detail??"restore unavailable")}try{const i=s?.length||l?.length?{...s?.length?{excludeKeys:s}:{},...l?.length?{includeKeys:l}:{}}:void 0;return await u.restore(D(e),i)}catch(i){return R(String(i))}}scheduleReload(t){try{B({reason:t});return true}catch{return false}}async delete(t){if(o){await o("delete",{id:t});return}await this.ensureLoaded();await w();const e=await F(t);const s=await P(t,this.state.snapshots);this.setState({snapshots:s,recentlyDeleted:e?{stored:e,at:Date.now()}:null})}async undoDelete(){const t=this.state.recentlyDeleted;if(!t)return;const e=await j(t.stored,this.state.snapshots);this.setState({snapshots:e,recentlyDeleted:null})}clearRecentlyDeleted(){if(this.state.recentlyDeleted)this.setState({recentlyDeleted:null})}async setRestoreRoute(t,e){if(o){await o("setRestoreRoute",{id:t,restoreRoute:e});return}await this.ensureLoaded();await w();const s=await q(t,e,this.state.snapshots);this.setState({snapshots:s})}async duplicate(t){if(o){const l=await o("duplicate",{id:t});return l?.snapshot??null}await this.ensureLoaded();await w();const e=this.state.snapshots.find(l=>l.id===t);if(!e)return null;const s=await z(t,`${e.name} copy`,this.state.snapshots);if(!s)return null;this.setState({snapshots:s.metas});return s.meta}async rename(t,e){if(o){await o("rename",{id:t,name:e});return}await this.ensureLoaded();await w();const s=await H(t,e,this.state.snapshots);this.setState({snapshots:s})}async setScope(t,e){if(o){await o("setScope",{id:t,scope:e});return}await this.ensureLoaded();await w();const s=await J(t,e,this.state.snapshots);this.setState({snapshots:s})}async setExclusions(t,e){if(o){await o("setExclusions",{id:t,excludedKeys:e});return}await this.ensureLoaded();await w();const s=await U(t,e,this.state.snapshots);this.setState({snapshots:s})}clearLastOutcome(){this.setState({lastOutcome:null})}async wipeAll(){if(o){const t=await o("wipeAll",{});this.setState({lastOutcome:t});return t}this.setState({busy:"restore"});try{const t={snapshotId:"wipe-all",snapshotName:"Wipe all",mode:"reload",at:Date.now(),willReload:false,results:{}};for(const e of b()){if(e.clear){try{t.results[e.id]=await e.clear()}catch(s){t.results[e.id]=R(String(s))}}}t.willReload=this.scheduleReload("buoy time-machine wipe all");this.setState({lastOutcome:t});return t}finally{this.setState({busy:null})}}clearPreview(){this.previewRunId+=1;this.setState({preview:null})}async buildPreview(t,e="current"){if(o){const u=++this.previewRunId;this.setState({preview:{left:e,right:t,building:true,builtAt:Date.now(),sources:[]}});try{const a=await o("preview",{id:t==="current"?void 0:t.snapshotId,compareTo:e==="current"?void 0:e.snapshotId});if(u!==this.previewRunId)return;this.setState({preview:{left:e,right:t,building:false,builtAt:Date.now(),sources:a.sources??[]}})}catch(a){if(u!==this.previewRunId)return;this.setState({preview:{left:e,right:t,building:false,builtAt:Date.now(),sources:[{id:"error",label:"Preview",items:[],notes:[],error:String(a)}]}})}return}await this.ensureLoaded();await w();const s=++this.previewRunId;this.setState({preview:{left:e,right:t,building:true,builtAt:Date.now(),sources:[]}});const l=async u=>{if(u==="current")return null;const a=await I(u.snapshotId);if(!a)throw new Error(`No snapshot with id "${u.snapshotId}"`);return a.data};try{if(t==="current")throw new Error("preview target must be a snapshot");const[u,a]=await Promise.all([l(e),I(t.snapshotId)]);if(s!==this.previewRunId)return;if(!a){throw new Error(`No snapshot with id "${t.snapshotId}"`)}const i=a.data;const p=a.meta.baseline===true;const S=p?b().filter(r=>r.clear).map(r=>r.id):[...RESTORE_ORDER.filter(r=>r in i),...Object.keys(i).filter(r=>!RESTORE_ORDER.includes(r))];const f=[];for(const r of S){if(!g(r))continue;await new Promise(n=>setTimeout(n,0));if(s!==this.previewRunId)return;const d=L(r);const y=d?.label??r;try{const n=p?void 0:D(i[r]);const h=u===null?void 0:r in u?D(u[r]):void 0;let m;if(!d){m={items:[{key:r,label:y,verdict:"wont-apply",reason:"tool not installed \u2014 restore skips this source"}],notes:[]}}else if(d.previewItems){m=await d.previewItems(n,h)}else{const v=_(h,n);m={items:[{key:r,label:y,verdict:v.equal?"unchanged":"changed",oldValue:h,newValue:n}],notes:v.truncated?["diff truncated (large value)"]:[]}}if(s!==this.previewRunId)return;f.push({id:r,label:y,...m})}catch(n){f.push({id:r,label:y,items:[],notes:[],error:String(n)})}this.setState({preview:{left:e,right:t,building:true,builtAt:Date.now(),sources:[...f]}})}if(s!==this.previewRunId)return;this.setState({preview:{left:e,right:t,building:false,builtAt:Date.now(),sources:f}})}catch(u){if(s!==this.previewRunId)return;this.setState({preview:{left:e,right:t,building:false,builtAt:Date.now(),sources:[{id:"error",label:"Preview",items:[],notes:[],error:String(u)}]}})}}}export const timeMachineStore=new X;export function setRemoteTimeMachineHandler(c){o=c;if(!c){timeMachineStore.replaceFromSnapshot({})}}export function replaceTimeMachineFromSnapshot(c){timeMachineStore.replaceFromSnapshot(c)}