synthos 0.8.0 → 0.10.0

package/dist/storage/StorageProvider.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="node" />
+/**
+ * Abstraction over user-mutable storage (pages, settings, themes, data, uploads).
+ *
+ * All paths are absolute. Callers build paths with `path.join(config.pagesFolder, ...)`
+ * exactly as they do today — the provider simply executes the I/O against
+ * whatever backend it wraps (local filesystem, blob storage, etc.).
+ *
+ * Package/read-only content (required-pages, default-themes, static-files,
+ * service-connectors) stays on local filesystem and is NOT routed through
+ * this interface.
+ */
+export interface StorageProvider {
+    checkIfExists(filePath: string): Promise<boolean>;
+    loadFile(filePath: string): Promise<string>;
+    saveFile(filePath: string, content: string): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    saveBuffer(filePath: string, data: Buffer): Promise<void>;
+    loadBuffer(filePath: string): Promise<Buffer>;
+    stat(filePath: string): Promise<{
+        size: number;
+        isFile: boolean;
+    }>;
+    createReadStream(filePath: string): NodeJS.ReadableStream;
+    listFiles(dirPath: string): Promise<string[]>;
+    listFolders(dirPath: string): Promise<string[]>;
+    ensureFolderExists(dirPath: string): Promise<void>;
+    deleteFolder(dirPath: string): Promise<void>;
+    copyFolderRecursive(srcPath: string, destPath: string): Promise<void>;
+}
+//# sourceMappingURL=StorageProvider.d.ts.map

package/dist/storage/StorageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAG5B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI5C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC;IAI1D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE"}

package/dist/storage/StorageProvider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=StorageProvider.js.map

package/dist/storage/StorageProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageProvider.js","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":""}

package/dist/storage/index.d.ts

@@ -0,0 +1,3 @@
+export { StorageProvider } from './StorageProvider';
+export { FsStorageProvider } from './FsStorageProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsStorageProvider = void 0;
+var FsStorageProvider_1 = require("./FsStorageProvider");
+Object.defineProperty(exports, "FsStorageProvider", { enumerable: true, get: function () { return FsStorageProvider_1.FsStorageProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;AACA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

package/dist/synthos-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthos-cli.d.ts","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":"AAOA,wBAAsB,GAAG,kBAwCxB"}
+{"version":3,"file":"synthos-cli.d.ts","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":"AAQA,wBAAsB,GAAG,kBAwCxB"}

package/dist/synthos-cli.js

@@ -8,6 +8,7 @@ const yargs_1 = __importDefault(require("yargs"));
 const helpers_1 = require("yargs/helpers");
 const service_1 = require("./service");
 const init_1 = require("./init");
+const customizer_1 = require("./customizer");
 const dynamicImport = new Function('specifier', `return import(specifier)`);
 async function run() {
     await (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
@@ -20,7 +21,7 @@ async function run() {
             default: 4242
         })
             .option('pages', {
-            describe: `Include default pages when initializing a new .synthos folder.`,
+            describe: `Include default pages when initializing a new local folder.`,
             type: 'boolean',
             default: true
         })
@@ -36,9 +37,9 @@ async function run() {
         })
             .demandOption([]);
     }, async (args) => {
-        const config = (0, init_1.createConfig)('.synthos', { debug: args.debug, debugPageUpdates: args.debugPageUpdates });
+        const config = await (0, init_1.createConfig)(customizer_1.customizer.localFolder, { debug: args.debug, debugPageUpdates: args.debugPageUpdates }, customizer_1.customizer);
         await (0, init_1.init)(config, args.pages);
-        await (0, service_1.server)(config).listen(args.port, async () => {
+        await (0, service_1.server)(config, customizer_1.customizer).listen(args.port, async () => {
             console.log(`SynthOS server is running on http://localhost:${args.port}`);
             // Open using default browser
             const open = await dynamicImport('open');

package/dist/synthos-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"synthos-cli.js","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,2CAAwC;AACxC,uCAAmC;AACnC,iCAA4C;AAE5C,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;AAErE,KAAK,UAAU,GAAG;IACrB,MAAM,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC7B,UAAU,CAAC,SAAS,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,4BAA4B,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,OAAO,KAAK;aACP,MAAM,CAAC,MAAM,EAAE;YACZ,QAAQ,EAAE,yBAAyB;YACnC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,gEAAgE;YAC1E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,gEAAgE;YAC1E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACjB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC1B,QAAQ,EAAE,iEAAiE;YAC3E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACjB,CAAC;aACD,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACxG,MAAM,IAAA,WAAI,EAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAA,gBAAM,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC9C,OAAO,CAAC,GAAG,CAAC,iDAAiD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1E,6BAA6B;YAC7B,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;SACD,IAAI,EAAE;SACN,aAAa,EAAE;SACf,UAAU,EAAE,CAAC;AACtB,CAAC;AAxCD,kBAwCC"}
+{"version":3,"file":"synthos-cli.js","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,2CAAwC;AACxC,uCAAmC;AACnC,iCAA4C;AAC5C,6CAA0C;AAE1C,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;AAErE,KAAK,UAAU,GAAG;IACrB,MAAM,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC7B,UAAU,CAAC,SAAS,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,4BAA4B,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,OAAO,KAAK;aACP,MAAM,CAAC,MAAM,EAAE;YACZ,QAAQ,EAAE,yBAAyB;YACnC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,6DAA6D;YACvE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,gEAAgE;YAC1E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACjB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC1B,QAAQ,EAAE,iEAAiE;YAC3E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACjB,CAAC;aACD,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAY,EAAC,uBAAU,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,uBAAU,CAAC,CAAC;QACtI,MAAM,IAAA,WAAI,EAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAA,gBAAM,EAAC,MAAM,EAAE,uBAAU,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC1D,OAAO,CAAC,GAAG,CAAC,iDAAiD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1E,6BAA6B;YAC7B,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;SACD,IAAI,EAAE;SACN,aAAa,EAAE;SACf,UAAU,EAAE,CAAC;AACtB,CAAC;AAxCD,kBAwCC"}

package/dist/themes.d.ts

@@ -13,6 +13,7 @@ export declare function parseThemeFilename(filename: string): {
     name: string;
     version: number;
 } | undefined;
+export declare function loadThemeVersion(name: string, config: SynthOSConfig): Promise<number>;
 export declare function loadThemeInfo(name: string, config: SynthOSConfig): Promise<ThemeInfo | undefined>;
 export declare function loadTheme(name: string, config: SynthOSConfig): Promise<string | undefined>;
 export declare function listThemes(config: SynthOSConfig): Promise<string[]>;

package/dist/themes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOlG;AAqBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAevG;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAahG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBzE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkChF"}
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOlG;AAwCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ3F;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAkBvG;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkBhG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBzE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmChF"}

package/dist/themes.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOutdatedThemes = exports.listThemes = exports.loadTheme = exports.loadThemeInfo = exports.parseThemeFilename = exports.THEME_VERSION = void 0;
+exports.getOutdatedThemes = exports.listThemes = exports.loadTheme = exports.loadThemeInfo = exports.loadThemeVersion = exports.parseThemeFilename = exports.THEME_VERSION = void 0;
 const path_1 = __importDefault(require("path"));
 const files_1 = require("./files");
 exports.THEME_VERSION = 2;
@@ -26,10 +26,29 @@ function parseThemeFilename(filename) {
 }
 exports.parseThemeFilename = parseThemeFilename;
 /**
- * Find the CSS file for a theme by name in a folder.
+ * Find the CSS file for a theme by name in a user folder (via storageProvider).
  * Prefers the highest-versioned file (e.g. name.v2.css over name.css).
  */
-async function findThemeCssFile(folder, name) {
+async function findUserThemeCssFile(config, folder, name) {
+    const sp = config.storageProvider;
+    if (!await sp.checkIfExists(folder))
+        return undefined;
+    const files = await sp.listFiles(folder);
+    let best;
+    for (const f of files) {
+        const parsed = parseThemeFilename(f);
+        if (parsed && parsed.name === name) {
+            if (!best || parsed.version > best.version) {
+                best = { path: path_1.default.join(folder, f), version: parsed.version };
+            }
+        }
+    }
+    return best;
+}
+/**
+ * Find the CSS file for a theme by name in a local-fs folder (package defaults).
+ */
+async function findDefaultThemeCssFile(folder, name) {
     if (!await (0, files_1.checkIfExists)(folder))
         return undefined;
     const files = await (0, files_1.listFiles)(folder);
@@ -44,15 +63,29 @@ async function findThemeCssFile(folder, name) {
     }
     return best;
 }
+async function loadThemeVersion(name, config) {
+    const local = await findUserThemeCssFile(config, userThemesFolder(config), name);
+    if (local)
+        return local.version;
+    for (const folder of config.defaultThemesFolders) {
+        const def = await findDefaultThemeCssFile(folder, name);
+        if (def)
+            return def.version;
+    }
+    return 1;
+}
+exports.loadThemeVersion = loadThemeVersion;
 async function loadThemeInfo(name, config) {
-    // Check user's local themes first, then fall back to package defaults
+    const sp = config.storageProvider;
+    // Check user's local themes first (user storage)
     const localPath = path_1.default.join(userThemesFolder(config), `${name}.json`);
-    if (await (0, files_1.checkIfExists)(localPath)) {
-        const raw = await (0, files_1.loadFile)(localPath);
+    if (await sp.checkIfExists(localPath)) {
+        const raw = await sp.loadFile(localPath);
         return raw ? JSON.parse(raw) : undefined;
     }
-    const defaultPath = path_1.default.join(config.defaultThemesFolder, `${name}.json`);
-    if (await (0, files_1.checkIfExists)(defaultPath)) {
+    // Fall back to package defaults (local fs)
+    const defaultPath = await (0, files_1.findFileInFolders)(config.defaultThemesFolders, `${name}.json`);
+    if (defaultPath) {
         const raw = await (0, files_1.loadFile)(defaultPath);
         return raw ? JSON.parse(raw) : undefined;
     }
@@ -60,38 +93,41 @@ async function loadThemeInfo(name, config) {
 }
 exports.loadThemeInfo = loadThemeInfo;
 async function loadTheme(name, config) {
-    // Check user's local themes first, then fall back to package defaults
-    const local = await findThemeCssFile(userThemesFolder(config), name);
+    const sp = config.storageProvider;
+    // Check user's local themes first (user storage)
+    const local = await findUserThemeCssFile(config, userThemesFolder(config), name);
     if (local) {
-        return await (0, files_1.loadFile)(local.path);
+        return await sp.loadFile(local.path);
     }
-    const def = await findThemeCssFile(config.defaultThemesFolder, name);
-    if (def) {
-        return await (0, files_1.loadFile)(def.path);
+    // Search all default theme folders (local fs)
+    for (const folder of config.defaultThemesFolders) {
+        const def = await findDefaultThemeCssFile(folder, name);
+        if (def) {
+            return await (0, files_1.loadFile)(def.path);
+        }
     }
     return undefined;
 }
 exports.loadTheme = loadTheme;
 async function listThemes(config) {
+    const sp = config.storageProvider;
     const names = new Set();
-    // Collect from user's local themes folder
+    // Collect from user's local themes folder (user storage)
     const localFolder = userThemesFolder(config);
-    if (await (0, files_1.checkIfExists)(localFolder)) {
-        const files = await (0, files_1.listFiles)(localFolder);
+    if (await sp.checkIfExists(localFolder)) {
+        const files = await sp.listFiles(localFolder);
         for (const f of files) {
             const parsed = parseThemeFilename(f);
             if (parsed)
                 names.add(parsed.name);
         }
     }
-    // Collect from package defaults
-    if (await (0, files_1.checkIfExists)(config.defaultThemesFolder)) {
-        const files = await (0, files_1.listFiles)(config.defaultThemesFolder);
-        for (const f of files) {
-            const parsed = parseThemeFilename(f);
-            if (parsed)
-                names.add(parsed.name);
-        }
+    // Collect from all default theme folders (local fs)
+    const defaultFiles = await (0, files_1.listFilesFromFolders)(config.defaultThemesFolders);
+    for (const f of defaultFiles) {
+        const parsed = parseThemeFilename(f);
+        if (parsed)
+            names.add(parsed.name);
     }
     return Array.from(names).sort();
 }
@@ -100,11 +136,12 @@ exports.listThemes = listThemes;
  * Compare local theme versions against defaults and return themes that need upgrading.
  */
 async function getOutdatedThemes(config) {
+    const sp = config.storageProvider;
     const localFolder = userThemesFolder(config);
-    if (!await (0, files_1.checkIfExists)(localFolder))
+    if (!await sp.checkIfExists(localFolder))
         return [];
-    const defaultFiles = await (0, files_1.listFiles)(config.defaultThemesFolder);
-    const localFiles = await (0, files_1.listFiles)(localFolder);
+    const defaultFiles = await (0, files_1.listFilesFromFolders)(config.defaultThemesFolders);
+    const localFiles = await sp.listFiles(localFolder);
     // Build maps: theme name → highest version
     const defaultVersions = new Map();
     for (const f of defaultFiles) {

package/dist/themes.js.map

@@ -1 +1 @@
-{"version":3,"file":"themes.js","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,mCAA6D;AAGhD,QAAA,aAAa,GAAG,CAAC,CAAC;AAO/B,SAAS,gBAAgB,CAAC,MAAqB;IAC3C,OAAO,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC7D,IAAI,cAAc,EAAE;QAChB,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;KAChF;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC;AAPD,gDAOC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,IAAY;IACxD,IAAI,CAAC,MAAM,IAAA,qBAAa,EAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAC;IACtC,IAAI,IAAmD,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE;QACnB,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE;YAChC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE;gBACxC,IAAI,GAAG,EAAE,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;aAClE;SACJ;KACJ;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,MAAqB;IACnE,sEAAsE;IACtE,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACtE,IAAI,MAAM,IAAA,qBAAa,EAAC,SAAS,CAAC,EAAE;QAChC,MAAM,GAAG,GAAG,MAAM,IAAA,gBAAQ,EAAC,SAAS,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;KAC5C;IAED,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC1E,IAAI,MAAM,IAAA,qBAAa,EAAC,WAAW,CAAC,EAAE;QAClC,MAAM,GAAG,GAAG,MAAM,IAAA,gBAAQ,EAAC,WAAW,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;KAC5C;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAfD,sCAeC;AAEM,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,MAAqB;IAC/D,sEAAsE;IACtE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACrE,IAAI,KAAK,EAAE;QACP,OAAO,MAAM,IAAA,gBAAQ,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KACrC;IAED,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACrE,IAAI,GAAG,EAAE;QACL,OAAO,MAAM,IAAA,gBAAQ,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC;KACnC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAbD,8BAaC;AAEM,KAAK,UAAU,UAAU,CAAC,MAAqB;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,0CAA0C;IAC1C,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,IAAA,qBAAa,EAAC,WAAW,CAAC,EAAE;QAClC,MAAM,KAAK,GAAG,MAAM,IAAA,iBAAS,EAAC,WAAW,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE;YACnB,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,MAAM;gBAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SACtC;KACJ;IAED,gCAAgC;IAChC,IAAI,MAAM,IAAA,qBAAa,EAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE;QACjD,MAAM,KAAK,GAAG,MAAM,IAAA,iBAAS,EAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE;YACnB,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,MAAM;gBAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SACtC;KACJ;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAvBD,gCAuBC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAC,MAAqB;IACzD,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,IAAA,qBAAa,EAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,YAAY,GAAG,MAAM,IAAA,iBAAS,EAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,MAAM,IAAA,iBAAS,EAAC,WAAW,CAAC,CAAC;IAEhD,2CAA2C;IAC3C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE;QAC1B,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE;YACR,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,OAAO,GAAG,GAAG;gBAAE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;SAC9E;KACJ;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE;QACxB,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE;YACR,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,OAAO,GAAG,GAAG;gBAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;SAC5E;KACJ;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,eAAe,EAAE;QAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ,GAAG,MAAM,EAAE;YACnB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACvB;KACJ;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAlCD,8CAkCC"}
+{"version":3,"file":"themes.js","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"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"}

package/migration-rules/v1-to-v2.md

@@ -0,0 +1,193 @@
+You are a code migration tool. You convert SynthOS v1 pages to v2 format.
+
+## CRITICAL — Structural Elements You MUST Preserve
+
+These elements are required by the SynthOS runtime (`page-script.js`). Removing them breaks the page.
+
+1. **Chat panel** — The entire `.chat-panel` div including:
+   - `.chat-header`
+   - `.chat-messages` with all message history
+   - `.link-group` with Save/Pages/Reset links
+   - `<form id="chatForm">` with `.chat-input` and `.chat-submit`
+   If the chat form is missing, POST requests fail with "Cannot POST /".
+
+2. **Thoughts div** — `<div id="thoughts" style="display: none;">...</div>` must stay in the page.
+
+3. **Loading overlay** — `<div id="loadingOverlay" class="loading-overlay"><div class="spinner"></div></div>` must be **inside** `.viewer-panel` (not outside it, not removed).
+
+4. **Two-panel layout** — The `chat-panel` + `viewer-panel` structure must remain intact.
+
+---
+
+## Rules — What to REMOVE
+
+### 1. Shared CSS rules
+
+Remove CSS rules matching these selectors (they are now in theme.css):
+
+**Base:** `:root`, `*`, `body`, `html`
+
+**Chat panel:** `.chat-panel`, `.chat-header`, `.chat-messages`, `.chat-message`, `.chat-message p`, `.chat-message p strong`, `.chat-message p code`, `.chat-message strong`, `.chat-message pre`, `.chat-message code`, `.chat-message a`, `.link-group`, `.link-group a`, `.link-group a:hover`, `form`, `.chat-input`, `.chat-input:focus`, `.chat-input::placeholder`, `.chat-input:disabled`, `.chat-submit`, `.chat-submit:hover`, `.chat-submit:active`, `.chat-submit:disabled`, `.chat-input-wrapper`, `.chat-input-wrapper .chat-input`
+
+**Viewer panel:** `.viewer-panel`, `.viewer-panel::before`, `.viewer-panel.full-viewer`
+
+**Loading:** `.loading-overlay`, `.spinner`, `#loadingOverlay`
+
+**Chat toggle:** `.chat-toggle`, `.chat-toggle:hover`, `.chat-toggle-dots`, `.chat-toggle-dot`, `.chat-toggle:hover .chat-toggle-dot`, `body.chat-collapsed .chat-panel`, `body.chat-collapsed .chat-toggle`
+
+**Modals:** `.modal-overlay`, `.modal-overlay.show`, `.modal-content`, `.modal-header`, `.modal-body`, `.modal-footer`, `.modal-footer-right`, `.modal-btn`, `.modal-btn-primary`, `.modal-btn-primary:hover`, `.modal-btn-secondary`, `.modal-btn-secondary:hover`, `.modal-btn-danger`, `.modal-btn-danger:hover`
+
+**Form elements:** `.form-group`, `.form-group:last-child`, `.form-label`, `.form-input`, `.form-input:focus`, `.form-input:read-only`, `.form-input::placeholder`, `.checkbox-label`, `.checkbox-label input[type="checkbox"]`, `.checkbox-label span`
+
+**Brainstorm:** All `.brainstorm-*` selectors
+
+**Animations:** `@keyframes spin`, `@keyframes nebula-pulse`
+
+**Scrollbars:** All `::-webkit-scrollbar*` rules, `scrollbar-width` and `scrollbar-color` on `*`
+
+### 2. Shared inline JS
+
+Remove these specific code blocks from `<script>` tags (page-script.js handles them now):
+
+- `document.getElementById('chatInput').focus()` line
+- `chatForm` submit event listener (the one with setTimeout and loading overlay)
+- `saveLink` click handler
+- `resetLink` click handler
+- `window.onload` that ONLY scrolls chatMessages — **keep other onload logic!**
+- Chat panel toggle IIFE (references `synthos-chat-collapsed`)
+- Focus management IIFE (references `stopImmediatePropagation`)
+- `// Basic chat functionality` comment
+
+### 3. Empty tags
+
+If a `<script>` or `<style>` block becomes empty after stripping, remove it entirely.
+
+---
+
+## Rules — What to ADD
+
+In `<head>`, add these two lines right after the `<title>` tag (if not already present):
+```html
+<script src="/api/theme-info.js"></script>
+<link rel="stylesheet" href="/api/theme.css">
+```
+
+Do NOT add `page-info.js`, `page-helpers.js`, or `page-script.js` — the server auto-injects those.
+
+---
+
+## Rules — What to TRANSFORM
+
+### Data/Table API migration
+
+The data API changed from global tables to **page-scoped** tables. Prefer converting raw fetch calls to `synthos.data.*` helpers (they auto-scope via `window.pageInfo.name`):
+
+| v1 pattern | v2 replacement |
+|---|---|
+| `fetch('/api/data/TABLE')` | `synthos.data.list('TABLE')` |
+| `fetch('/api/data/TABLE/ID')` | `synthos.data.get('TABLE', 'ID')` |
+| `fetch('/api/data/TABLE', {method:'POST', body:...})` | `synthos.data.save('TABLE', row)` |
+| `fetch('/api/data/TABLE/ID', {method:'DELETE'})` | `synthos.data.remove('TABLE', 'ID')` |
+
+**Important:** `synthos.data.get()` returns the object directly (or `null`), NOT a Response — no `.json()` needed.
+
+If raw fetch must be kept: `fetch('/api/data/notes')` → `fetch('/api/data/' + pageName + '/notes')`
+
+### Color variables
+
+Replace hardcoded Nebula Dusk colors with CSS variables in **page-specific CSS only**:
+
+| Hardcoded | CSS Variable |
+|-----------|-------------|
+| `#667eea` | `var(--accent-primary)` |
+| `#764ba2` | `var(--accent-secondary)` |
+| `#f093fb` | `var(--accent-tertiary)` |
+| `#b794f6` | `var(--text-secondary)` |
+| `#e0e0e0` | `var(--text-primary)` |
+| `rgba(138, 43, 226, 0.3)` | `var(--border-color)` or `var(--accent-glow)` |
+| `#1a1a2e` | `var(--bg-primary)` |
+| `#16213e` | `var(--bg-secondary)` |
+| `#0f0f23` | `var(--bg-tertiary)` |
+
+For gradients: `linear-gradient(135deg, #667eea, #764ba2)` → `linear-gradient(135deg, var(--accent-primary), var(--accent-secondary))`
+
+**Exceptions — do NOT replace colors in:**
+- Canvas 2D API calls (`ctx.fillStyle`, `ctx.strokeStyle`, etc.) — CSS variables don't work in Canvas JS
+- Print-specific styles (`@media print`) — these target white backgrounds and need hardcoded dark-on-light colors
+
+---
+
+## Rules — What to PRESERVE (do NOT modify)
+
+- ALL viewer-panel HTML content (games, presentations, tools, dashboards, etc.)
+- ALL page-specific JavaScript (game logic, presentation logic, keyboard handlers, etc.)
+- ALL page-specific CSS (styles for custom classes not in the shared list above)
+- Chat message history in `.chat-messages`
+- `<div id="thoughts">` content
+- External CDN script tags (`<script src="...">`)
+- The `loadingOverlay` element (just ensure it's inside `.viewer-panel`)
+
+---
+
+## Viewer Panel Overrides
+
+The theme sets `.viewer-panel` to `justify-content: center; align-items: center; overflow: hidden`. Pages with **scrollable or top-aligned content** (dashboards, lists, tabs, tables) need these overrides in their page-specific `<style>`:
+
+```css
+.viewer-panel {
+    justify-content: flex-start;
+    align-items: stretch;
+    overflow-y: auto;
+}
+```
+
+Add this override when the viewer-panel contains content that should scroll or align to the top.
+
+---
+
+## V2 Page Structure Reference
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>SynthOS - Page Title</title>
+    <script src="/api/theme-info.js"></script>
+    <link rel="stylesheet" href="/api/theme.css">
+    <style>
+        /* Only page-specific styles here */
+    </style>
+</head>
+<body>
+    <div class="chat-panel">
+        <div class="chat-header">SynthOS</div>
+        <div class="chat-messages" id="chatMessages">
+            <!-- chat messages preserved -->
+        </div>
+        <div class="link-group">
+            <a href="#" id="saveLink">Save</a>
+            <a href="/pages" id="pagesLink">Pages</a>
+            <a href="#" id="resetLink">Reset</a>
+        </div>
+        <form action="/" method="POST" id="chatForm">
+            <input type="text" class="chat-input" id="chatInput" name="message" placeholder="Type a message...">
+            <button type="submit" class="chat-submit">Send</button>
+        </form>
+    </div>
+    <div class="viewer-panel" id="viewerPanel">
+        <!-- page content preserved -->
+        <div id="loadingOverlay" class="loading-overlay"><div class="spinner"></div></div>
+    </div>
+    <div id="thoughts" style="display: none;">...</div>
+    <script>
+        /* Only page-specific JS here */
+    </script>
+</body>
+</html>
+```
+
+## Output format
+
+Return ONLY the complete migrated HTML. No markdown fences, no explanation, no commentary. Just the raw HTML starting with `<!DOCTYPE html>`.