@buoy-gg/time-machine 7.0.41 → 7.0.42

package/lib/commonjs/store/timeMachineStore.js

@@ -1,848 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.SAFETY_SNAPSHOT_NAME = exports.RESTORE_ORDER = void 0;
-exports.replaceTimeMachineFromSnapshot = replaceTimeMachineFromSnapshot;
-exports.setRemoteTimeMachineHandler = setRemoteTimeMachineHandler;
-exports.timeMachineStore = void 0;
-exports.willRestoreRoute = willRestoreRoute;
-var _sharedUi = require("@buoy-gg/shared-ui");
-var _dataViewer = require("@buoy-gg/shared-ui/dataViewer");
-var _snapshotVault = require("./snapshotVault");
-var _routeRestore = require("./routeRestore");
-var _sourceSettings = require("./sourceSettings");
-var _sourceIds = require("./sourceIds");
-/**
- * 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).
- */
-
-const RESTORE_ORDER = exports.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.
- */
-function willRestoreRoute(meta) {
-  return !!meta.route && (meta.restoreRoute ?? true);
-}
-
-/** Extra knobs a restore accepts beyond mode + exclusions. */
-
-const SAFETY_SNAPSHOT_NAME = exports.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 = (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    this.setState({
-      busy: "capture"
-    });
-    try {
-      const providers = (0, _sharedUi.getStateSnapshotProviders)().filter(p => p.status().canCapture && (0, _sourceSettings.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] = (0, _sharedUi.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 = (0, _sourceSettings.isSourceEnabled)(_sourceIds.ROUTE_SOURCE_ID) ? (0, _routeRestore.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 (0, _snapshotVault.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 (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const snapshot = {
-      meta: {
-        id: nextId(),
-        name: "Fresh install",
-        createdAt: Date.now(),
-        sizeBytes: 0,
-        baseline: true,
-        sources: {}
-      },
-      data: {}
-    };
-    const snapshots = await (0, _snapshotVault.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 (0, _sourceSettings.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 (0, _snapshotVault.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 (0, _sharedUi.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 = (0, _sourceSettings.isSourceEnabled)(_sourceIds.ROUTE_SOURCE_ID) && (options?.restoreRoute ?? willRestoreRoute(stored.meta));
-      if (mode === "reload") {
-        // Storage only; everything in-memory rebuilds after the reload.
-        if (stored.data.storage && (0, _sourceSettings.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 (0, _routeRestore.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 (0, _snapshotVault.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 (!(0, _sourceSettings.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 = (0, _routeRestore.navigateToRoute)(stored.meta.route);
-      }
-      this.setState({
-        lastOutcome: outcome,
-        snapshots: await (0, _snapshotVault.markSnapshotRestored)(id, outcome.at, this.state.snapshots)
-      });
-      return outcome;
-    } finally {
-      this.setState({
-        busy: null
-      });
-    }
-  }
-  async restoreSource(sourceId, payload, excludeKeys, includeKeys) {
-    const provider = (0, _sharedUi.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((0, _sharedUi.superJsonDeserialize)(payload), options);
-    } catch (e) {
-      return skippedResult(String(e));
-    }
-  }
-  scheduleReload(reason) {
-    try {
-      (0, _sharedUi.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const stored = await (0, _snapshotVault.readSnapshot)(id);
-    const snapshots = await (0, _snapshotVault.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 (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const snapshots = await (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const source = this.state.snapshots.find(s => s.id === id);
-    if (!source) return null;
-    const result = await (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const snapshots = await (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const snapshots = await (0, _snapshotVault.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 (0, _sourceSettings.ensureSourceSettingsLoaded)();
-    const snapshots = await (0, _snapshotVault.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 (0, _sharedUi.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 (0, _sourceSettings.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 (0, _snapshotVault.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), (0, _snapshotVault.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 ? (0, _sharedUi.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 (!(0, _sourceSettings.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 = (0, _sharedUi.getStateSnapshotProvider)(sid);
-        const label = provider?.label ?? sid;
-        try {
-          const targetData = isBaseline ? undefined // provider treats an absent target as "empty"
-          : (0, _sharedUi.superJsonDeserialize)(rightData[sid]);
-          const baseData = leftData === null ? undefined : sid in leftData ? (0, _sharedUi.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 = (0, _dataViewer.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)
-          }]
-        }
-      });
-    }
-  }
-}
-const timeMachineStore = exports.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}.
- */
-function setRemoteTimeMachineHandler(handler) {
-  remoteHandler = handler;
-  if (!handler) {
-    timeMachineStore.replaceFromSnapshot({});
-  }
-}
-
-/** Buoy Desktop: mirror a device's synced Time Machine metadata payload. */
-function replaceTimeMachineFromSnapshot(payload) {
-  timeMachineStore.replaceFromSnapshot(payload);
-}
-//# sourceMappingURL=timeMachineStore.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.SAFETY_SNAPSHOT_NAME=exports.RESTORE_ORDER=void 0;exports.replaceTimeMachineFromSnapshot=replaceTimeMachineFromSnapshot;exports.setRemoteTimeMachineHandler=setRemoteTimeMachineHandler;exports.timeMachineStore=void 0;exports.willRestoreRoute=willRestoreRoute;var _sharedUi=require("@buoy-gg/shared-ui");var _dataViewer=require("@buoy-gg/shared-ui/dataViewer");var _snapshotVault=require("./snapshotVault");var _routeRestore=require("./routeRestore");var _sourceSettings=require("./sourceSettings");var _sourceIds=require("./sourceIds");const RESTORE_ORDER=exports.RESTORE_ORDER=["storage","redux","zustand","jotai","query"];function defaultSnapshotName(l){const e=new Date;const t=`${String(e.getHours()).padStart(2,"0")}:${String(e.getMinutes()).padStart(2,"0")}`;const s=l?l.pathname==="/"?"Home":l.pathname:null;return s?`${s} \xB7 ${t}`:`Snapshot \xB7 ${t}`}function dedupeName(l,e){const t=new Set(e.map(s=>s.name));if(!t.has(l))return l;for(let s=2;s<1e3;s++){const u=`${l} (${s})`;if(!t.has(u))return u}return l}function willRestoreRoute(l){return!!l.route&&(l.restoreRoute??true)}const SAFETY_SNAPSHOT_NAME=exports.SAFETY_SNAPSHOT_NAME="Before last restore";let remoteHandler=null;function skippedResult(l){return{ok:false,applied:0,skipped:[{id:"*",reason:l}],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};previewRunId=0;listeners=new Set;loadPromise=null;getState(){return this.state}subscribe=e=>{this.listeners.add(e);void this.ensureLoaded();return()=>{this.listeners.delete(e)}};setState(e){this.state={...this.state,...e};this.listeners.forEach(t=>{try{t()}catch{}})}ensureLoaded(){if(remoteHandler)return Promise.resolve();if(!this.loadPromise){this.loadPromise=(0,_snapshotVault.loadIndex)().then(e=>{if(remoteHandler)return;this.setState({snapshots:e,hasLoaded:true})})}return this.loadPromise}replaceFromSnapshot(e){this.setState({snapshots:e.snapshots??[],busy:e.busy??null,lastOutcome:e.lastOutcome??null,remoteProviders:e.providers??[],remoteRoute:e.route??{available:false},hasLoaded:true})}async capture(e,t,s){if(remoteHandler){const u=await remoteHandler("capture",{name:e,sourceIds:t});return u.snapshot}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();this.setState({busy:"capture"});try{const u=(0,_sharedUi.getStateSnapshotProviders)().filter(r=>r.status().canCapture&&(0,_sourceSettings.isSourceEnabled)(r.id)&&(!t||t.includes(r.id)));const i={};const a={};for(const r of u){try{const c=await r.capture();i[r.id]=(0,_sharedUi.superJsonSerialize)(c.data);a[r.id]={warnings:c.warnings}}catch(c){a[r.id]={warnings:[`capture failed: ${String(c)}`]}}}const o=(0,_sourceSettings.isSourceEnabled)(_sourceIds.ROUTE_SOURCE_ID)?(0,_routeRestore.captureCurrentRoute)():null;let h=this.state.snapshots;if(s?.safety){for(const r of h.filter(c=>c.safety)){h=await(0,_snapshotVault.deleteSnapshot)(r.id,h)}}const w={meta:{id:nextId(),name:s?.safety?SAFETY_SNAPSHOT_NAME:dedupeName(e.trim()||defaultSnapshotName(o),h),createdAt:Date.now(),sizeBytes:0,...o?{route:o}:{},...s?.safety?{safety:true}:{},sources:a},data:i};const p=await(0,_snapshotVault.saveSnapshot)(w,h);this.setState({snapshots:p});return w.meta}finally{this.setState({busy:null})}}async captureBaseline(){if(remoteHandler){const s=await remoteHandler("captureBaseline",{});return s.snapshot}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const e={meta:{id:nextId(),name:"Fresh install",createdAt:Date.now(),sizeBytes:0,baseline:true,sources:{}},data:{}};const t=await(0,_snapshotVault.saveSnapshot)(e,this.state.snapshots);this.setState({snapshots:t});return e.meta}async restore(e,t,s,u){if(remoteHandler){const a=await remoteHandler("restore",{id:e,mode:t,excludeKeys:s,restoreRoute:u?.restoreRoute});this.setState({lastOutcome:a});return a}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();let i;if(u?.safetyCapture&&!this.state.snapshots.find(a=>a.id===e)?.safety){i=(await this.capture(SAFETY_SNAPSHOT_NAME,void 0,{safety:true})).id}this.setState({busy:"restore"});try{const a=await(0,_snapshotVault.loadSnapshot)(e);if(!a)throw new Error(`No snapshot with id "${e}"`);const o={snapshotId:e,snapshotName:a.meta.name,mode:t,at:Date.now(),willReload:false,results:{},...i?{safetySnapshotId:i}:{}};if(a.meta.baseline){for(const n of(0,_sharedUi.getStateSnapshotProviders)()){if(n.clear){try{o.results[n.id]=await n.clear()}catch(d){o.results[n.id]=skippedResult(String(d))}}}o.willReload=this.scheduleReload("buoy time-machine baseline");this.setState({lastOutcome:o});return o}const h=[...RESTORE_ORDER.filter(n=>n in a.data),...Object.keys(a.data).filter(n=>!RESTORE_ORDER.includes(n))];const w=n=>{const d=new Map;for(const S of n){const m=S.indexOf("::");if(m<=0)continue;const g=S.slice(0,m);const R=S.slice(m+2);const v=d.get(g)??[];v.push(R);d.set(g,v)}return d};const p=s??a.meta.excludedKeys??[];const r=w(p);const c=!s&&a.meta.scope?.length?w(a.meta.scope):null;const f=(0,_sourceSettings.isSourceEnabled)(_sourceIds.ROUTE_SOURCE_ID)&&(u?.restoreRoute??willRestoreRoute(a.meta));if(t==="reload"){if(a.data.storage&&(0,_sourceSettings.isSourceEnabled)("storage")&&(!c||c.has("storage"))){o.results.storage=await this.restoreSource("storage",a.data.storage,r.get("storage"),c?.get("storage"))}if(f){const n=a.meta.route;try{await(0,_routeRestore.savePendingRoute)(n,a.meta.name);o.route={...n,status:"deferred"}}catch(d){o.route={...n,status:"failed",error:String(d)}}}o.willReload=this.scheduleReload("buoy time-machine restore");this.setState({lastOutcome:o,snapshots:await(0,_snapshotVault.markSnapshotRestored)(e,o.at,this.state.snapshots)});return o}for(const n of h){if(c&&!c.has(n))continue;if(!(0,_sourceSettings.isSourceEnabled)(n)){o.results[n]={ok:true,applied:0,skipped:[],warnings:["Switched off in Sources; left as it is"]};continue}o.results[n]=await this.restoreSource(n,a.data[n],r.get(n),c?.get(n))}if(f){o.route=(0,_routeRestore.navigateToRoute)(a.meta.route)}this.setState({lastOutcome:o,snapshots:await(0,_snapshotVault.markSnapshotRestored)(e,o.at,this.state.snapshots)});return o}finally{this.setState({busy:null})}}async restoreSource(e,t,s,u){const i=(0,_sharedUi.getStateSnapshotProvider)(e);if(!i){return skippedResult("provider not available (package missing or not initialized)")}const a=i.status();if(!a.canRestore){return skippedResult(a.detail??"restore unavailable")}try{const o=s?.length||u?.length?{...s?.length?{excludeKeys:s}:{},...u?.length?{includeKeys:u}:{}}:void 0;return await i.restore((0,_sharedUi.superJsonDeserialize)(t),o)}catch(o){return skippedResult(String(o))}}scheduleReload(e){try{(0,_sharedUi.scheduleReloadApp)({reason:e});return true}catch{return false}}async delete(e){if(remoteHandler){await remoteHandler("delete",{id:e});return}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const t=await(0,_snapshotVault.readSnapshot)(e);const s=await(0,_snapshotVault.deleteSnapshot)(e,this.state.snapshots);this.setState({snapshots:s,recentlyDeleted:t?{stored:t,at:Date.now()}:null})}async undoDelete(){const e=this.state.recentlyDeleted;if(!e)return;const t=await(0,_snapshotVault.restoreDeletedSnapshot)(e.stored,this.state.snapshots);this.setState({snapshots:t,recentlyDeleted:null})}clearRecentlyDeleted(){if(this.state.recentlyDeleted)this.setState({recentlyDeleted:null})}async setRestoreRoute(e,t){if(remoteHandler){await remoteHandler("setRestoreRoute",{id:e,restoreRoute:t});return}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const s=await(0,_snapshotVault.setSnapshotRestoreRoute)(e,t,this.state.snapshots);this.setState({snapshots:s})}async duplicate(e){if(remoteHandler){const u=await remoteHandler("duplicate",{id:e});return u?.snapshot??null}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const t=this.state.snapshots.find(u=>u.id===e);if(!t)return null;const s=await(0,_snapshotVault.duplicateSnapshot)(e,`${t.name} copy`,this.state.snapshots);if(!s)return null;this.setState({snapshots:s.metas});return s.meta}async rename(e,t){if(remoteHandler){await remoteHandler("rename",{id:e,name:t});return}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const s=await(0,_snapshotVault.renameSnapshot)(e,t,this.state.snapshots);this.setState({snapshots:s})}async setScope(e,t){if(remoteHandler){await remoteHandler("setScope",{id:e,scope:t});return}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const s=await(0,_snapshotVault.setSnapshotScope)(e,t,this.state.snapshots);this.setState({snapshots:s})}async setExclusions(e,t){if(remoteHandler){await remoteHandler("setExclusions",{id:e,excludedKeys:t});return}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const s=await(0,_snapshotVault.setSnapshotExclusions)(e,t,this.state.snapshots);this.setState({snapshots:s})}clearLastOutcome(){this.setState({lastOutcome:null})}async wipeAll(){if(remoteHandler){const e=await remoteHandler("wipeAll",{});this.setState({lastOutcome:e});return e}this.setState({busy:"restore"});try{const e={snapshotId:"wipe-all",snapshotName:"Wipe all",mode:"reload",at:Date.now(),willReload:false,results:{}};for(const t of(0,_sharedUi.getStateSnapshotProviders)()){if(t.clear){try{e.results[t.id]=await t.clear()}catch(s){e.results[t.id]=skippedResult(String(s))}}}e.willReload=this.scheduleReload("buoy time-machine wipe all");this.setState({lastOutcome:e});return e}finally{this.setState({busy:null})}}clearPreview(){this.previewRunId+=1;this.setState({preview:null})}async buildPreview(e,t="current"){if(remoteHandler){const i=++this.previewRunId;this.setState({preview:{left:t,right:e,building:true,builtAt:Date.now(),sources:[]}});try{const a=await remoteHandler("preview",{id:e==="current"?void 0:e.snapshotId,compareTo:t==="current"?void 0:t.snapshotId});if(i!==this.previewRunId)return;this.setState({preview:{left:t,right:e,building:false,builtAt:Date.now(),sources:a.sources??[]}})}catch(a){if(i!==this.previewRunId)return;this.setState({preview:{left:t,right:e,building:false,builtAt:Date.now(),sources:[{id:"error",label:"Preview",items:[],notes:[],error:String(a)}]}})}return}await this.ensureLoaded();await(0,_sourceSettings.ensureSourceSettingsLoaded)();const s=++this.previewRunId;this.setState({preview:{left:t,right:e,building:true,builtAt:Date.now(),sources:[]}});const u=async i=>{if(i==="current")return null;const a=await(0,_snapshotVault.loadSnapshot)(i.snapshotId);if(!a)throw new Error(`No snapshot with id "${i.snapshotId}"`);return a.data};try{if(e==="current")throw new Error("preview target must be a snapshot");const[i,a]=await Promise.all([u(t),(0,_snapshotVault.loadSnapshot)(e.snapshotId)]);if(s!==this.previewRunId)return;if(!a){throw new Error(`No snapshot with id "${e.snapshotId}"`)}const o=a.data;const h=a.meta.baseline===true;const w=h?(0,_sharedUi.getStateSnapshotProviders)().filter(r=>r.clear).map(r=>r.id):[...RESTORE_ORDER.filter(r=>r in o),...Object.keys(o).filter(r=>!RESTORE_ORDER.includes(r))];const p=[];for(const r of w){if(!(0,_sourceSettings.isSourceEnabled)(r))continue;await new Promise(n=>setTimeout(n,0));if(s!==this.previewRunId)return;const c=(0,_sharedUi.getStateSnapshotProvider)(r);const f=c?.label??r;try{const n=h?void 0:(0,_sharedUi.superJsonDeserialize)(o[r]);const d=i===null?void 0:r in i?(0,_sharedUi.superJsonDeserialize)(i[r]):void 0;let S;if(!c){S={items:[{key:r,label:f,verdict:"wont-apply",reason:"tool not installed \u2014 restore skips this source"}],notes:[]}}else if(c.previewItems){S=await c.previewItems(n,d)}else{const m=(0,_dataViewer.objectDiff)(d,n);S={items:[{key:r,label:f,verdict:m.equal?"unchanged":"changed",oldValue:d,newValue:n}],notes:m.truncated?["diff truncated (large value)"]:[]}}if(s!==this.previewRunId)return;p.push({id:r,label:f,...S})}catch(n){p.push({id:r,label:f,items:[],notes:[],error:String(n)})}this.setState({preview:{left:t,right:e,building:true,builtAt:Date.now(),sources:[...p]}})}if(s!==this.previewRunId)return;this.setState({preview:{left:t,right:e,building:false,builtAt:Date.now(),sources:p}})}catch(i){if(s!==this.previewRunId)return;this.setState({preview:{left:t,right:e,building:false,builtAt:Date.now(),sources:[{id:"error",label:"Preview",items:[],notes:[],error:String(i)}]}})}}}const timeMachineStore=exports.timeMachineStore=new TimeMachineStore;function setRemoteTimeMachineHandler(l){remoteHandler=l;if(!l){timeMachineStore.replaceFromSnapshot({})}}function replaceTimeMachineFromSnapshot(l){timeMachineStore.replaceFromSnapshot(l)}