refactor: migrate project storage from IndexedDB to OPFS with folder-based structure

- Replace monolithic KGStorage with KGProjectStorage (OPFS) and KGConfigStorage (IndexedDB) - Each project stored as folder: project.json + meta.json + media/ - Add KGConfigUpgrader with V1 upgrader to auto-migrate existing IndexedDB projects to OPFS - Request persistent storage via navigator.storage.persist() to prevent browser eviction - Show loading spinner during one-time migration - Enforce safe project name characters (letters, numbers, space, hyphen, underscore, period, parens) - Export projects as .kgstudio zip bundles instead of raw JSON - Import supports .kgstudio bundles (with meta.json validation) and legacy JSON files - Auto-deduplicate project names on import with (1), (2), etc. suffix - Add OPFS shell debugger (pwd, ls, cd, cat, dl) accessible via KGDebugger.opfs() - Add ESLint semi rule for consistent semicolons - Delete KGStorage.ts — all logic absorbed by new storage classes - Add jszip dependency for zip export/import
2026-04-09 19:25:08 -07:00
parent 17610f12f3
commit 2d3ea33ce6
21 changed files with 1781 additions and 235 deletions
@@ -0,0 +1,62 @@
+import { KGConfigStorage } from '../io/KGConfigStorage';
+import { CONFIG_UPGRADER_CONSTANTS } from '../../constants/coreConstants';
+import { upgradeConfigToV1 } from './upgradeConfigToV1';
+
+/**
+ * KGConfigUpgrader — Orchestrates app-level migrations (e.g., storage backend changes).
+ * Mirrors the KGProjectUpgrader pattern but operates on global app state, not individual projects.
+ *
+ * Version is tracked via a `__config_version` key in the IndexedDB config store.
+ */
+export class KGConfigUpgrader {
+  /**
+   * Run all pending config upgrades sequentially.
+   * Returns the number of upgrade steps that were executed.
+   */
+  public static async upgradeToLatest(): Promise<number> {
+    const storage = KGConfigStorage.getInstance();
+    const currentVersion = await KGConfigUpgrader.getConfigVersion(storage);
+    const targetVersion = CONFIG_UPGRADER_CONSTANTS.CURRENT_VERSION;
+
+    if (currentVersion >= targetVersion) {
+      console.log(`Config is up to date (version ${currentVersion})`);
+      return 0;
+    }
+
+    console.log(`Config upgrade needed: v${currentVersion} -> v${targetVersion}`);
+
+    let stepsExecuted = 0;
+
+    for (let nextVersion = currentVersion + 1; nextVersion <= targetVersion; nextVersion++) {
+      switch (nextVersion) {
+        case 1: {
+          await upgradeConfigToV1();
+          break;
+        }
+        default: {
+          throw new Error(`No config upgrader found for version ${nextVersion}`);
+        }
+      }
+
+      // Persist the version after each successful step
+      await KGConfigUpgrader.setConfigVersion(storage, nextVersion);
+      stepsExecuted++;
+      console.log(`Config upgraded to version ${nextVersion}`);
+    }
+
+    return stepsExecuted;
+  }
+
+  private static async getConfigVersion(storage: KGConfigStorage): Promise<number> {
+    const raw = await storage.getRaw(CONFIG_UPGRADER_CONSTANTS.VERSION_KEY);
+    if (!raw || typeof raw.version !== 'number') return 0;
+    return raw.version;
+  }
+
+  private static async setConfigVersion(storage: KGConfigStorage, version: number): Promise<void> {
+    await storage.saveRaw(CONFIG_UPGRADER_CONSTANTS.VERSION_KEY, {
+      version,
+      upgradedAt: Date.now(),
+    });
+  }
+}