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
This commit is contained in:
Xiaohan-Tian
2026-04-09 19:25:08 -07:00
parent 17610f12f3
commit 2d3ea33ce6
21 changed files with 1781 additions and 235 deletions
+3 -10
View File
@@ -1,5 +1,4 @@
import { KGStorage } from '../io/KGStorage';
import { DB_CONSTANTS } from '../../constants/coreConstants';
import { KGConfigStorage } from '../io/KGConfigStorage';
/**
* Application configuration interface
@@ -99,7 +98,7 @@ export class ConfigManager {
// Configuration state
private config: AppConfig;
private storage: KGStorage;
private storage: KGConfigStorage;
private isInitialized: boolean = false;
private defaultConfig: AppConfig | null = null;
private changeListeners: Set<(changedKeys: string[]) => void> = new Set();
@@ -108,7 +107,7 @@ export class ConfigManager {
private constructor() {
// Initialize with empty config, will be loaded during initialize()
this.config = {} as AppConfig;
this.storage = KGStorage.getInstance();
this.storage = KGConfigStorage.getInstance();
console.log('ConfigManager initialized');
}
@@ -262,11 +261,8 @@ export class ConfigManager {
// For config, we don't use class-transformer since it's plain objects
// So we'll use a simple object approach and handle it directly with KGStorage
const savedConfigData = await this.storage.load(
DB_CONSTANTS.DB_NAME,
DB_CONSTANTS.CONFIG_STORE_NAME,
ConfigManager.CONFIG_KEY,
Object, // Simple object class
DB_CONSTANTS.DB_VERSION
);
if (savedConfigData) {
@@ -294,12 +290,9 @@ export class ConfigManager {
: this.config;
await this.storage.save(
DB_CONSTANTS.DB_NAME,
DB_CONSTANTS.CONFIG_STORE_NAME,
ConfigManager.CONFIG_KEY,
configToPersist,
true, // Always overwrite config
DB_CONSTANTS.DB_VERSION
);
console.log('Saved config to storage:', configToPersist);
} catch (error) {