aimeat 2.0.0 → 2.2.0

package/dist/static/app-catalog/js/main.js

@@ -4,23 +4,30 @@
  *   served src/static/app-catalog.html). Holds catalog state, rendering, actions, and the
  *   window._launcher handler surface consumed by inline onclick in the markup. Carved from
  *   the former single inline <script>; further modules are split out incrementally.
- * @structure  imports (i18n data) → state → db → api → render → actions → window._launcher → init
+ * @structure  imports (i18n data) → state → api → render → actions → window._launcher → init
  * @usage  built, not loaded raw: pnpm build:app-catalog
+ * @version-history
+ *   v2.0.0 — 2026-07-20 — Server-only cutover: drop the IndexedDB/Shared-Mine plumbing; wire the
+ *     create-flow publish (initAppsIo showPublishModal) and the one-time legacy-local migration.
  */
 import { t, getLang, setLang, applyI18n } from './i18n.js';
 import { escapeHtml, jsArg, sourceLabel, sourceLabelText, bareOwnerName, sameOwner, filterAttr, isSameOriginUrl, currentOwnerName, generateId, readFileAsText } from './util.js';
-import { getAllApps, saveApp, deleteApp, openDB, getDbName, getDbMode, setDbMode, closeDbInstance } from './db.js';
+import { getAllApps, saveApp, deleteApp } from './db.js';
 import { showConfirm, closeConfirm, showNotice, dismissNotice, dtlBtn } from './ui.js';
 import { loadConfig, saveConfig } from './config.js';
 import { extractZip, bundleZip } from './zip.js';
-import { initDetail, refreshServerMgmt, openDetailView, editAppDetails, closeDetailView, detailLaunch, mountLoginPill, detailAboutEdit, detailAboutCancel, detailAboutSave, detailToggleFavorite, detailAccessCodeEdit, detailAccessCodeCancel, detailAccessCodeSave, detailSkillAttachToggle, detailSkillAttach, detailSkillDetach, detailSetScreenshot, detailRefreshScreenshot, detailAiRun, detailAiTest, detailAiKeep, detailAiDiscard, detailTestDraftLive, detailPublishTestedDraft, openStagingPreview, sourceTestDraftLive, sourcePublishTested, detailEditSource, detailImproveExternal, detailSharePrompt, detailPublish, detailDelete, openPublishedDetail, fetchAppContentBase64, showLineageModal, showProtectionModal, saveProtection, showVersionsModal, restoreVersion, forkVersion } from './detail.js';
-import { monetizeAddTool, monetizeEditTool, monetizeCancelEdit, monetizeSaveTool, monetizeDeleteTool } from './monetize.js';
+import { initDetail, refreshServerMgmt, openDetailView, editAppDetails, closeDetailView, detailLaunch, mountLoginPill, detailAboutEdit, detailAboutCancel, detailAboutSave, detailTranslateDesc, detailPromoteSave, detailPromoteClear, detailToggleFavorite, detailAccessCodeEdit, detailAccessCodeCancel, detailAccessCodeSave, detailSkillAttachToggle, detailSkillAttach, detailSkillDetach, detailSetScreenshot, detailRefreshScreenshot, detailAiRun, detailAiTest, detailAiKeep, detailAiDiscard, detailTestDraftLive, detailPublishTestedDraft, detailWorkTry, detailWorkPublish, detailWorkDiscard, detailCheckpointPreview, detailCheckpointRestore, detailCheckpointDelete, saveSourceAsWorkingCopy, openStagingPreview, sourceTestDraftLive, sourcePublishTested, detailEditSource, detailImproveExternal, detailSharePrompt, detailPublish, detailDelete, openPublishedDetail, fetchAppContentBase64, showLineageModal, showProtectionModal, saveProtection, showVersionsModal, restoreVersion, forkVersion } from './detail.js';
+import { monetizeAddTool, monetizeEditTool, monetizeCancelEdit, monetizeSaveTool, monetizeDeleteTool,
+  odpsToggleDefaultsUi, odpsToggleToolUi, odpsSuggestUi, odpsSaveDefaults,
+  odpsGenerateSampleUi, odpsUseMeasuredUi } from './monetize.js';
 import { loadCortexExtensions, showCortexPopup, cortexCopy, getCortexOwnerToken, openCortexEditor, cortexEditorAddLib, cortexEditorSave, cortexEditorExport, closeCortexEditor, openPromptBuilder, closePbPanel, buildPromptFromBuilder, updatePbPreview } from './cortex.js';
-import { initSettings, applyTheme, updateThemeToggle, toggleTheme, getThemePref, openSettings, saveSettings, syncConfigToServer, loadConfigFromServer, closeSettings, openHelp, closeHelp, exportBackup, handleImportBackup, jsonImportSelectAll, submitJsonImport, removeDuplicateApps, clearAllData } from './settings.js';
-import { initAppsIo, setEditingAppId, addAppFromZip, addAppFromUrl, addAppFromFile, addAppFromSource, showModal, requireSignInThen, parseAppMeta, closeModal, switchTab, handleFileDrop, handleSave } from './apps-io.js';
-import { initServerIo, isOperatorSession, importFromAimeat, processAimeatImport, showPublishModal, submitPublish, toggleCommunity, switchView, showSubdomainModal, submitSubdomainAssign, unassignSubdomain, closeConsents, openConsents, revokeConsent, toggleBackupMenu, toggleCreateMenu, closeCreateMenu, toggleCortexBar, exportBackupZip, importBackupPick, importBackupFile, backupUpdateSummary, backupSelectAll, submitBackupRestore, loadPublishedApps, applyServerFilter, unpublishApp, toggleParkApp, toggleForkApp, deleteServerApp } from './server-io.js';
-import { initRender, setServerManifests, setOwnServerApps, setIframeUrl, serverStateByFilename, serverAppManifests, ownAppProtection, ownServerApps, currentIframeUrl, renderTags, filterByTag, launchApp, launchInTab, viewPublished, launchInIframe, renderApps, renderRecentlyOpened, closeIframe, openExternal, showContextMenu, hideContextMenu, handleContextAction, viewSource, generateSharePrompt, generateHomepagePrompt, onCardDragStart, onCardDragEnd, onCardDragOver, onCardDrop } from './render.js';
+import { initSettings, applyTheme, updateThemeToggle, toggleTheme, getThemePref, openSettings, saveSettings, syncConfigToServer, loadConfigFromServer, closeSettings, openHelp, closeHelp } from './settings.js';
+import { initAppsIo, setEditingAppId, showModal, requireSignInThen, parseAppMeta, closeModal, switchTab, handleFileDrop, handleSave } from './apps-io.js';
+import { initServerIo, isOperatorSession, showPublishModal, submitPublish, toggleCommunity, switchView, showSubdomainModal, submitSubdomainAssign, unassignSubdomain, closeConsents, openConsents, revokeConsent, toggleBackupMenu, toggleCreateMenu, closeCreateMenu, toggleCortexBar, exportBackupZip, importBackupPick, importBackupFile, backupUpdateSummary, backupSelectAll, submitBackupRestore, loadPublishedApps, refreshFavoritesUI, applyServerFilter, unpublishApp, toggleParkApp, toggleForkApp, deleteServerApp } from './server-io.js';
+import { initRender, setServerManifests, setOwnServerApps, setIframeUrl, serverStateByFilename, serverAppManifests, ownAppProtection, ownServerApps, currentIframeUrl, renderTags, filterByTag, launchApp, launchInTab, viewPublished, launchInIframe, renderApps, closeIframe, openExternal, showContextMenu, hideContextMenu, handleContextAction, viewSource, generateSharePrompt, generateHomepagePrompt } from './render.js';
 import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from './app-agents.js';
+import { checkLegacyLocalApps } from './migrate.js';
+import { toggleFavorite } from './favorites.js';
 
 
   // ── i18n (en / fi) ─────────────────────────────────
@@ -38,39 +45,10 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     try { renderApps(); } catch (e) {}
     try { renderTags(); } catch (e) {}
     try { loadPublishedApps(); } catch (e) {}
-    try { renderRecentlyOpened(); } catch (e) {}
     try { loadCortexExtensions(); } catch (e) {}
     try { mountLoginPill(); } catch (e) {}  // re-render the golden pill in the new language
   }
 
-  function switchDbMode(mode) {
-    if (mode === getDbMode()) return;
-    // Personal mode is per-account and meaningless without a session — it would silently show the
-    // shared Global DB (the "my apps vanished when I changed browser" confusion). Require sign-in
-    // first, keeping the toggle on the current mode until the user actually signs in.
-    if (mode === 'personal' && !currentOwnerName()) {
-      updateModeToggle();
-      requireSignInThen(function () { switchDbMode('personal'); });
-      return;
-    }
-    setDbMode(mode);
-    closeDbInstance();
-    updateModeToggle();
-    refreshAll();
-  }
-
-  function updateModeToggle() {
-    var globalBtn = document.getElementById('mode-global');
-    var personalBtn = document.getElementById('mode-personal');
-    if (!globalBtn || !personalBtn) return;
-    globalBtn.classList.toggle('active', getDbMode() === 'global');
-    personalBtn.classList.toggle('active', getDbMode() === 'personal');
-    // Personal needs a session — dim it and explain via the title when logged out.
-    var signedIn = !!currentOwnerName();
-    personalBtn.classList.toggle('mode-btn-locked', !signedIn);
-    personalBtn.title = signedIn ? t('mode.personal.title') : t('mode.personal.needsLogin');
-  }
-
   // ── Config → config.js (loadConfig / saveConfig, imported above) ──
 
   // ── generateId / readFileAsText → util.js (imported above) ──
@@ -105,7 +83,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
   // ── Public API ────────────────────────────────────
 
   window._launcher = {
-    openDB: openDB,
     getAllApps: getAllApps,
     saveApp: saveApp,
     deleteApp: deleteApp,
@@ -126,10 +103,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     handleContextAction: handleContextAction,
     generateId: generateId,
     readFileAsText: readFileAsText,
-    addAppFromUrl: addAppFromUrl,
-    addAppFromFile: addAppFromFile,
-    addAppFromSource: addAppFromSource,
-    addAppFromZip: addAppFromZip,
     showModal: showModal,
     closeModal: closeModal,
     openSettings: openSettings,
@@ -138,18 +111,15 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     saveSettings: saveSettings,
     closeSettings: closeSettings,
     applyTheme: applyTheme,
-    exportBackup: exportBackup,
-    clearAllData: clearAllData,
-    importFromAimeat: importFromAimeat,
-    processAimeatImport: processAimeatImport,
     viewSource: viewSource,
     generateHomepagePrompt: generateHomepagePrompt,
     showPublishModal: showPublishModal,
     submitPublish: submitPublish,
     loadPublishedApps: loadPublishedApps,
+    // Toggle a server-backed favourite (ref = "owner/filename"), then re-render the ⭐ group + stars.
+    toggleFavorite: function (ref) { toggleFavorite(ref).then(function () { try { refreshFavoritesUI(); } catch (e) {} }); },
     toggleCommunity: toggleCommunity,
     switchView: switchView,
-    switchDbMode: switchDbMode,
     unpublishApp: unpublishApp,
     deleteServerApp: deleteServerApp,
     toggleParkApp: toggleParkApp,
@@ -157,6 +127,9 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     detailAboutEdit: detailAboutEdit,
     detailAboutCancel: detailAboutCancel,
     detailAboutSave: detailAboutSave,
+    detailTranslateDesc: detailTranslateDesc,
+    detailPromoteSave: detailPromoteSave,
+    detailPromoteClear: detailPromoteClear,
     detailToggleFavorite: detailToggleFavorite,
     detailAccessCodeEdit: detailAccessCodeEdit,
     detailAccessCodeCancel: detailAccessCodeCancel,
@@ -169,6 +142,12 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     monetizeCancelEdit: monetizeCancelEdit,
     monetizeSaveTool: monetizeSaveTool,
     monetizeDeleteTool: monetizeDeleteTool,
+    odpsToggleDefaults: odpsToggleDefaultsUi,
+    odpsToggleTool: odpsToggleToolUi,
+    odpsSuggest: odpsSuggestUi,
+    odpsSaveDefaults: odpsSaveDefaults,
+    odpsGenerateSample: odpsGenerateSampleUi,
+    odpsUseMeasured: odpsUseMeasuredUi,
     editAppDetails: editAppDetails,
     showSubdomainModal: showSubdomainModal,
     openConsents: openConsents,
@@ -176,9 +155,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     revokeConsent: revokeConsent,
     submitSubdomainAssign: submitSubdomainAssign,
     unassignSubdomain: unassignSubdomain,
-    jsonImportSelectAll: jsonImportSelectAll,
-    submitJsonImport: submitJsonImport,
-    removeDuplicateApps: removeDuplicateApps,
     toggleBackupMenu: toggleBackupMenu,
     toggleCreateMenu: toggleCreateMenu,
     toggleCortexBar: toggleCortexBar,
@@ -205,6 +181,12 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     detailAiDiscard: detailAiDiscard,
     detailTestDraftLive: detailTestDraftLive,
     detailPublishTestedDraft: detailPublishTestedDraft,
+    detailWorkTry: detailWorkTry,
+    detailWorkPublish: detailWorkPublish,
+    detailWorkDiscard: detailWorkDiscard,
+    detailCheckpointPreview: detailCheckpointPreview,
+    detailCheckpointRestore: detailCheckpointRestore,
+    detailCheckpointDelete: detailCheckpointDelete,
     openStagingPreview: openStagingPreview,
     detailEditSource: detailEditSource,
     detailImproveExternal: detailImproveExternal,
@@ -214,7 +196,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     detailSetScreenshot: detailSetScreenshot,
     detailRefreshScreenshot: detailRefreshScreenshot,
     openPublishedDetail: openPublishedDetail,
-    renderRecentlyOpened: renderRecentlyOpened,
     loadCortexExtensions: loadCortexExtensions,
     showCortexPopup: showCortexPopup,
     cortexCopy: cortexCopy,
@@ -225,10 +206,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     cortexEditorExport: cortexEditorExport,
     openPromptBuilder: openPromptBuilder,
     closePbPanel: closePbPanel,
-    onCardDragStart: onCardDragStart,
-    onCardDragEnd: onCardDragEnd,
-    onCardDragOver: onCardDragOver,
-    onCardDrop: onCardDrop,
     syncConfigToServer: syncConfigToServer,
     loadConfigFromServer: loadConfigFromServer,
     setLanguage: setLanguage,
@@ -244,7 +221,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     allApps = [];
     renderApps();
     loadPublishedApps();
-    renderRecentlyOpened();
   }
 
   // ── Bootstrap ─────────────────────────────────────
@@ -254,7 +230,7 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     // can open the detail view or mount the login pill (whose onAuthChanged uses these).
     initDetail({
       refreshAll: refreshAll, loadPublishedApps: loadPublishedApps, renderApps: renderApps,
-      updateModeToggle: updateModeToggle, getCortexOwnerToken: getCortexOwnerToken, launchApp: launchApp,
+      updateModeToggle: function () {}, getCortexOwnerToken: getCortexOwnerToken, launchApp: launchApp,
       viewPublished: viewPublished, viewSource: viewSource, generateId: generateId,
       generateSharePrompt: generateSharePrompt, openPromptBuilder: openPromptBuilder,
       showPublishModal: showPublishModal,
@@ -266,7 +242,7 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
     });
     initAppAgents({ getServerManifests: function () { return serverAppManifests; } });
     initSettings({ generateId: generateId, renderApps: renderApps, loadPublishedApps: loadPublishedApps });
-    initAppsIo({ generateId: generateId, readFileAsText: readFileAsText, renderApps: renderApps, getMainApps: function () { return allApps; } });
+    initAppsIo({ generateId: generateId, readFileAsText: readFileAsText, renderApps: renderApps, getMainApps: function () { return allApps; }, showPublishModal: showPublishModal });
     initServerIo({
       getMainApps: function () { return allApps; },
       getServerState: function () { return serverStateByFilename; },
@@ -300,7 +276,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
       ? _urlLang
       : ((loadConfig().language === 'fi') ? 'fi' : 'en'));
     applyI18n();
-    updateModeToggle();
     // Restore the last-used view (Kirjasto / Yhteisö); defaults to Library.
     var _savedView = 'library';
     try { _savedView = localStorage.getItem('appCatalogView') || 'library'; } catch (e) { /* private mode */ }
@@ -328,6 +303,10 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
       if (e.target === this) closeConfirm(false);
     });
 
+    // One-time migration off the retired browser-local catalog: offer a JSON export of any apps
+    // left in the old IndexedDB store, so the server-only cutover never silently loses them.
+    try { checkLegacyLocalApps(); } catch (e) { /* migration is best-effort */ }
+
     // Deep link ?create=1 — open the AI prompt builder ("Build an app") right away.
     if (_params.get('create') === '1') {
       try { openPromptBuilder(null); } catch (e) { /* prompt builder optional */ }
@@ -374,21 +353,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
       }
     });
 
-    // ── Import backup file input ────────────────────
-    document.getElementById('import-file-input').addEventListener('change', function () {
-      if (this.files && this.files.length > 0) {
-        handleImportBackup(this.files[0]);
-        this.value = ''; // Reset for re-import
-      }
-    });
-
-    // ── Click AIMEAT import overlay to close ────────
-    document.getElementById('aimeat-import-overlay').addEventListener('click', function (e) {
-      if (e.target === this) {
-        this.hidden = true;
-      }
-    });
-
     // ── Click publish overlay to close ──────────────
     document.getElementById('publish-overlay').addEventListener('click', function (e) {
       if (e.target === this) {
@@ -420,11 +384,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
         this.hidden = true;
       }
     });
-    document.getElementById('json-import-overlay').addEventListener('click', function (e) {
-      if (e.target === this) {
-        this.hidden = true;
-      }
-    });
     document.addEventListener('click', function (e) {
       var menu = document.getElementById('backup-menu');
       if (!menu.hidden && !menu.contains(e.target) && e.target.id !== 'backup-btn') {
@@ -592,16 +551,12 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
           document.getElementById('source-overlay').hidden = true;
         } else if (!document.getElementById('context-menu').hidden) {
           hideContextMenu();
-        } else if (!document.getElementById('aimeat-import-overlay').hidden) {
-          document.getElementById('aimeat-import-overlay').hidden = true;
         } else if (!document.getElementById('publish-overlay').hidden) {
           document.getElementById('publish-overlay').hidden = true;
         } else if (!document.getElementById('subdomain-overlay').hidden) {
           document.getElementById('subdomain-overlay').hidden = true;
         } else if (!document.getElementById('backup-overlay').hidden) {
           document.getElementById('backup-overlay').hidden = true;
-        } else if (!document.getElementById('json-import-overlay').hidden) {
-          document.getElementById('json-import-overlay').hidden = true;
         } else if (!document.getElementById('settings-overlay').hidden) {
           closeSettings();
         } else if (!document.getElementById('modal-overlay').hidden) {
@@ -624,27 +579,6 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
       }
     });
 
-    // ── Long-press for touch devices ─────────────────
-    document.getElementById('app-grid').addEventListener('touchstart', function(e) {
-      var card = e.target.closest('.app-card');
-      if (!card) return;
-      var appId = card.getAttribute('data-id');
-      card._longPressTimer = setTimeout(function() {
-        e.preventDefault();
-        window._launcher.showContextMenu(e.touches[0], appId);
-      }, 500);
-    }, { passive: false });
-
-    document.getElementById('app-grid').addEventListener('touchend', function(e) {
-      var card = e.target.closest('.app-card');
-      if (card && card._longPressTimer) clearTimeout(card._longPressTimer);
-    });
-
-    document.getElementById('app-grid').addEventListener('touchmove', function(e) {
-      var card = e.target.closest('.app-card');
-      if (card && card._longPressTimer) clearTimeout(card._longPressTimer);
-    });
-
     // ── Copy Source button ───────────────────────────
     document.getElementById('copy-source-btn').addEventListener('click', function() {
       var code = document.getElementById('source-code').value;
@@ -684,52 +618,29 @@ import { initAppAgents, showAppAgentsModal, agentsDeploy, agentsUndeploy } from
       saveBtn.disabled = (this.value === original);
     });
 
-    // ── Save Changes button ──────────────────────────
+    // ── Save working copy ────────────────────────────
+    // Delegates to detail.js saveSourceAsWorkingCopy: checkpoint the replaced bytes, then persist
+    // to the app's server draft slot. (It used to only overwrite a transient in-memory blob, which
+    // a reload discarded — the root of "my edits kept disappearing".)
     document.getElementById('save-source-btn').addEventListener('click', function() {
       var overlay = document.getElementById('source-overlay');
       var textarea = document.getElementById('source-code');
-      var appId = overlay.dataset.appId;
       var btn = this;
-
-      if (!appId) {
-        showNotice('Cannot save: no app ID found.');
-        return;
-      }
+      if (!overlay.dataset.appId) { showNotice('Cannot save: no app ID found.'); return; }
 
       var newSource = textarea.value;
-      // Encode to base64 blob
-      var newBlob = btoa(unescape(encodeURIComponent(newSource)));
-
-      // Find the app in allApps and update it
-      var app = null;
-      for (var i = 0; i < allApps.length; i++) {
-        if (allApps[i].id === appId) {
-          app = allApps[i];
-          break;
-        }
-      }
-
-      if (!app) {
-        showNotice('App not found in library.');
-        return;
-      }
-
-      app.blob = newBlob;
-      btn.textContent = 'Saving...';
+      var idle = t('source.save');
+      btn.textContent = t('wc.saving');
       btn.disabled = true;
 
-      saveApp(app).then(function() {
-        btn.textContent = 'Saved!';
+      saveSourceAsWorkingCopy().then(function() {
+        btn.textContent = t('wc.savedShort');
         overlay.dataset.originalSource = newSource;
-        setTimeout(function() {
-          btn.textContent = 'Save Changes';
-          btn.disabled = true;
-        }, 1500);
-        renderApps();
+        setTimeout(function() { btn.textContent = idle; btn.disabled = true; }, 1500);
       }).catch(function(err) {
-        btn.textContent = 'Save Changes';
+        btn.textContent = idle;
         btn.disabled = false;
-        showNotice('Failed to save: ' + (err.message || err));
+        showNotice((t('wc.saveFailed') || 'Failed to save') + ': ' + ((err && err.message) || err));
       });
     });
 

package/dist/static/app-catalog/js/migrate.js

@@ -0,0 +1,88 @@
+/**
+ * @file migrate.js
+ * @description One-time migration off the retired browser-local catalog. The server-only cutover
+ *   dropped IndexedDB persistence; a user may still have apps in the old `AppLauncherDB[_owner]`
+ *   store from before. On first load after the change this reads those apps (read-only, never
+ *   deletes the DB) and offers a one-time JSON download so nothing is silently lost, then sets a
+ *   "done" flag so it never nags again.
+ * @usage import { checkLegacyLocalApps } from './migrate.js'; checkLegacyLocalApps();
+ * @version-history
+ *   v1.0.0 — 2026-07-20 — Added with the server-only catalog cutover.
+ */
+import { showConfirm } from './ui.js';
+import { t } from './i18n.js';
+
+const DONE_KEY = 'appCatalogLocalMigrated';
+
+// Discover every legacy DB name (the shared `AppLauncherDB` plus any per-account
+// `AppLauncherDB_<owner>` from the old "Mine" mode) when the browser supports enumeration.
+async function legacyDbNames() {
+  var names = ['AppLauncherDB'];
+  try {
+    if (indexedDB.databases) {
+      var list = await indexedDB.databases();
+      list.forEach(function (d) {
+        if (d && d.name && d.name.indexOf('AppLauncherDB') === 0 && names.indexOf(d.name) < 0) names.push(d.name);
+      });
+    }
+  } catch (e) { /* enumeration unsupported — fall back to the shared DB only */ }
+  return names;
+}
+
+function openExisting(name) {
+  return new Promise(function (resolve) {
+    var req;
+    try { req = indexedDB.open(name); } catch (e) { resolve(null); return; }
+    req.onsuccess = function () { resolve(req.result); };
+    req.onerror = function () { resolve(null); };
+    // A brand-new open would upgrade an empty DB; leave it storeless so readApps returns [].
+    req.onupgradeneeded = function () { /* no stores */ };
+  });
+}
+
+function readApps(db) {
+  return new Promise(function (resolve) {
+    if (!db || !db.objectStoreNames || !db.objectStoreNames.contains('apps')) { resolve([]); return; }
+    try {
+      var tx = db.transaction('apps', 'readonly');
+      var r = tx.objectStore('apps').getAll();
+      r.onsuccess = function () { resolve(r.result || []); };
+      r.onerror = function () { resolve([]); };
+    } catch (e) { resolve([]); }
+  });
+}
+
+function downloadJson(apps) {
+  var json = JSON.stringify({ version: 1, exportedAt: new Date().toISOString(), apps: apps }, null, 2);
+  var blob = new Blob([json], { type: 'application/json' });
+  var url = URL.createObjectURL(blob);
+  var a = document.createElement('a');
+  a.href = url;
+  a.download = 'app-catalog-local-apps.json';
+  document.body.appendChild(a);
+  a.click();
+  document.body.removeChild(a);
+  URL.revokeObjectURL(url);
+}
+
+export async function checkLegacyLocalApps() {
+  try { if (localStorage.getItem(DONE_KEY)) return; } catch (e) { return; }
+  var apps = [];
+  try {
+    var names = await legacyDbNames();
+    for (var i = 0; i < names.length; i++) {
+      var db = await openExisting(names[i]);
+      var found = await readApps(db);
+      if (found && found.length) apps = apps.concat(found);
+      try { if (db) db.close(); } catch (e) { /* ignore */ }
+    }
+  } catch (e) { /* if anything goes wrong, do not block the catalog */ }
+
+  if (!apps.length) { try { localStorage.setItem(DONE_KEY, '1'); } catch (e) { /* private mode */ } return; }
+
+  var msg = (t('migrate.found') || 'You have {n} local app(s) from the old catalog. Download them as a backup?')
+    .replace('{n}', String(apps.length));
+  var wants = await showConfirm(msg);
+  if (wants) downloadJson(apps);
+  try { localStorage.setItem(DONE_KEY, '1'); } catch (e) { /* private mode */ }
+}