@omega.js/desktop 0.52.0 → 0.54.0

package/dist/lib/restart-manager/index.js

@@ -28,14 +28,14 @@
 // 60s heartbeats reconnect through the fresh runtime.json afterwards.
 //
 // Bail conditions (any one → the lib schedules nothing):
-//   - manager.isTesting() — tests drive the public methods explicitly against
+//   - omega.isTesting() — tests drive the public methods explicitly against
 //     an isolated root; nothing may fire on its own, and install/spawn paths
 //     stay dead so tests never touch network or real OS state.
 //   - brand.id === 'restart-manager' (RM doesn't manage itself)
 //   - config.restartManager.enabled === false
 //   - non-production without OMEGA_RESTART_MANAGER_DEV=1 (dev noise guard)
 //
-// Full reference: docs/restart-manager.md.
+// Full reference: docs/desktop/restart-manager.md.
 
 const path       = require('path');
 const fs         = require('fs');
@@ -70,7 +70,7 @@ const INSTALL_COOLDOWN_MS     = 60 * 60 * 1000;        // failed install → bac
 
 const restartManager = {
   _initialized:  false,
-  _manager:      null,
+  _omega:        null,
   _enabled:      true,
   _bailed:       false,
   _bailReason:   null,
@@ -88,12 +88,12 @@ const restartManager = {
   _lastHeartbeatAt: null,
   _lastError:    null,
 
-  initialize(manager) {
+  initialize(omega) {
     if (restartManager._initialized) return;
     restartManager._initialized = true;
-    restartManager._manager = manager;
+    restartManager._omega = omega;
 
-    const cfg = manager.config.restartManager || {};
+    const cfg = omega.config.restartManager || {};
     restartManager._enabled = cfg.enabled !== false;
     restartManager._feed = { ...DEFAULT_FEED, ...(cfg.feed || {}) };
 
@@ -103,20 +103,20 @@ const restartManager = {
     // userData (wiped every run) so explicit test calls never touch the real
     // neutral root; everything else shares `<appData>/restart-manager` (or the
     // OMEGA_RM_ROOT override — the cross-repo dev/test isolation seam).
-    restartManager._root = manager.isTesting()
+    restartManager._root = omega.isTesting()
       ? path.join(app.getPath('userData'), protocol.SHARED_DIR_NAME)
       : protocol.resolveSharedRoot(app.getPath('appData'), process.env);
 
     // Bail #1: test mode. Nothing fires on its own — no timers, no quit hook
     // (a preventDefault in before-quit would wedge the harness's quit). Tests
     // drive register()/unregister()/ensureInstalled() explicitly.
-    if (manager.isTesting()) {
+    if (omega.isTesting()) {
       restartManager._bail('testing', 'skipping (test mode).');
       return;
     }
 
     // Bail #2: this app IS restart-manager. RM doesn't manage itself.
-    if (manager.config.brand.id === 'restart-manager') {
+    if (omega.config.brand.id === 'restart-manager') {
       restartManager._bail('self', 'skipping (this app is restart-manager itself).');
       return;
     }
@@ -129,14 +129,14 @@ const restartManager = {
 
     // Bail #4: dev mode unless explicitly opted in — avoids feed fetches and
     // spawn thrash during local dev where RM likely isn't installed.
-    if (!manager.isProduction() && process.env.OMEGA_RESTART_MANAGER_DEV !== '1') {
+    if (!omega.isProduction() && process.env.OMEGA_RESTART_MANAGER_DEV !== '1') {
       restartManager._bail('dev', 'skipping outside production (set OMEGA_RESTART_MANAGER_DEV=1 to test).');
       return;
     }
 
     // Schedule the first register after whenReady; single timer so re-init
     // guards don't pile up (tests shutdown() to clear).
-    const delay = manager.isDevelopment() ? REGISTER_DELAY_DEV_MS : REGISTER_DELAY_PROD_MS;
+    const delay = omega.isDevelopment() ? REGISTER_DELAY_DEV_MS : REGISTER_DELAY_PROD_MS;
     app.whenReady().then(() => {
       restartManager._registerTimer = setTimeout(() => {
         restartManager.register().catch((e) => logger.warn(`register failed: ${e.message}`));
@@ -155,14 +155,14 @@ const restartManager = {
   // or spawns — a probe failure just returns false.
   async register() {
     if (restartManager._hardBailed()) return false;
-    const manager = restartManager._manager;
+    const omega = restartManager._omega;
 
     for (let attempt = 1; attempt <= MAX_REGISTER_ATTEMPTS; attempt++) {
       try {
         let probe = await restartManager._probeRunning();
 
         if (!probe.ok) {
-          if (manager.isTesting()) {
+          if (omega.isTesting()) {
             restartManager._lastError = 'restart-manager not running';
             return false;
           }
@@ -198,9 +198,9 @@ const restartManager = {
     if (restartManager._hardBailed()) return false;
 
     try {
-      const manager = restartManager._manager;
+      const omega = restartManager._omega;
       const res = await restartManager._post(protocol.ENDPOINTS.deregister, {
-        id:  manager.config.brand.id,
+        id:  omega.config.brand.id,
         pid: process.pid,
       });
       restartManager._registered = false;
@@ -215,21 +215,21 @@ const restartManager = {
   // Install RM into <root>/app/ when missing. Smart existence: the installed
   // app on disk short-circuits BEFORE any network so repeat boots cost one stat.
   async ensureInstalled() {
-    const manager = restartManager._manager;
+    const omega = restartManager._omega;
     const platform = process.platform;
 
     const appPath = protocol.getInstalledAppPath(restartManager._root, platform);
     if (fs.existsSync(appPath)) return true;
 
     // Tests never hit the network unless explicitly in extended mode.
-    if (manager.isTesting() && !process.env.TEST_EXTENDED_MODE) return false;
+    if (omega.isTesting() && !process.env.TEST_EXTENDED_MODE) return false;
 
     if (Date.now() < restartManager._installCooldownUntil) {
       logger.log('install on cooldown after a recent failure — skipping.');
       return false;
     }
 
-    if (!install.acquireInstallLock(restartManager._root, { pid: process.pid, hostAppId: manager.config.brand.id })) {
+    if (!install.acquireInstallLock(restartManager._root, { pid: process.pid, hostAppId: omega.config.brand.id })) {
       logger.log('another app holds the install lock — skipping (heartbeat retries).');
       return false;
     }
@@ -258,13 +258,13 @@ const restartManager = {
 
   // Make sure RM is actually serving: probe → spawn the installed app → poll.
   async ensureRunning() {
-    const manager = restartManager._manager;
+    const omega = restartManager._omega;
 
     const probe = await restartManager._probeRunning();
     if (probe.ok) return true;
 
     // Tests never spawn real binaries — the fixture server plays the running RM.
-    if (manager.isTesting()) return false;
+    if (omega.isTesting()) return false;
 
     const appPath = protocol.getInstalledAppPath(restartManager._root, process.platform);
     if (!fs.existsSync(appPath)) return false;
@@ -319,7 +319,7 @@ const restartManager = {
       restartManager._quitWired = false;
     }
     restartManager._initialized  = false;
-    restartManager._manager      = null;
+    restartManager._omega        = null;
     restartManager._enabled      = true;
     restartManager._bailed       = false;
     restartManager._bailReason   = null;
@@ -441,15 +441,15 @@ const restartManager = {
   },
 
   _buildPayload() {
-    const manager = restartManager._manager;
+    const omega = restartManager._omega;
     const { app } = require('electron');
     return protocol.buildRegisterPayload({
-      id:          manager.config.brand.id,
+      id:          omega.config.brand.id,
       name:        app.getName(),
       pid:         process.pid,
       path:        app.getPath('exe'),
-      version:     manager.getVersion(),
-      environment: manager.getEnvironment(),
+      version:     omega.getVersion(),
+      environment: omega.getEnvironment(),
     });
   },
 
@@ -516,15 +516,15 @@ const restartManager = {
   },
 
   _handleBeforeQuit(event) {
-    const manager = restartManager._manager;
+    const omega = restartManager._omega;
     if (restartManager._quitFlushed || !restartManager._registered) return;
 
     // Never intercept the auto-updater's quitAndInstall — its quit sequence
     // (especially Squirrel.Mac) must own the exit. The app relaunches via the
     // updater anyway; RM's deregister-wins grace window + @omega.js/desktop's single-instance
     // lock neutralize the tiny race.
-    const updaterStatus = manager.autoUpdater.getStatus();
-    if (manager._allowQuit && updaterStatus.code === 'downloaded') {
+    const updaterStatus = omega.autoUpdater.getStatus();
+    if (omega._allowQuit && updaterStatus.code === 'downloaded') {
       restartManager._quitFlushed = true;
       restartManager.unregister().catch(() => { /* best-effort */ });
       return;
@@ -532,7 +532,7 @@ const restartManager = {
 
     event.preventDefault();
     restartManager._quitFlushed = true;
-    restartManager._quitFlush().finally(() => manager.quit({ force: true }));
+    restartManager._quitFlush().finally(() => omega.quit({ force: true }));
   },
 
   async _quitFlush() {

package/dist/lib/restart-manager/install.js

@@ -19,7 +19,7 @@
 // the same machine from running installers concurrently; RM itself ignores it.
 //
 // Pure helpers (parseFeed, pickArtifact, URL builders) are exported individually
-// for build-layer tests. See docs/restart-manager.md.
+// for build-layer tests. See docs/desktop/restart-manager.md.
 
 const path       = require('path');
 const fs         = require('fs');

package/dist/lib/restart-manager/protocol.js

@@ -29,7 +29,7 @@
 // storage-persisted, so they survive the update relaunch). @omega.js/desktop's lib only ever
 // installs RM when it's missing.
 //
-// Full reference: docs/restart-manager.md.
+// Full reference: docs/desktop/restart-manager.md.
 
 const path = require('path');
 

package/dist/lib/sign-helpers/exec-with-limit.js

@@ -13,7 +13,7 @@
 const { spawnSync } = require('child_process');
 const { execute } = require('node-powertools');
 
-const logger = new (require('../../build.js'))().logger('exec-with-limit');
+const logger = require('../../build.js').logger('exec-with-limit');
 
 // A kill that failed is exactly the state the operator needs to see, so every
 // failure is said, never swallowed.

package/dist/lib/sign-helpers/sign-events.js

@@ -21,7 +21,7 @@ const os      = require('os');
 const path    = require('path');
 const jetpack = require('fs-jetpack');
 
-const logger = new (require('../../build.js'))().logger('sign-events');
+const logger = require('../../build.js').logger('sign-events');
 
 function resolveLogPath(env, platform) {
   env      = env || process.env;

package/dist/lib/startup.js

@@ -6,7 +6,7 @@
 //      normal — default. Dock icon visible on macOS, taskbar entry on Windows.
 //      hidden — packaged builds get LSUIElement=true on macOS (zero dock bounce, no
 //               dock icon, not in Cmd+Tab). Tray/notifications/networking still work.
-//               Consumer surfaces UI later via `manager.windows.create('main')`, which
+//               Consumer surfaces UI later via `omega.windows.create('main')`, which
 //               calls app.dock.show() automatically so the icon appears alongside the
 //               window. Use this for menubar apps, agent apps, anything that should
 //               be invisible until the user explicitly asks for UI.
@@ -18,7 +18,7 @@
 //
 // @omega.js/desktop does NOT auto-create any windows anymore — the consumer's main.js drives that.
 // So "isLaunchHidden" no longer needs to gate window creation; we just expose the
-// raw mode and let the consumer decide whether to call `manager.windows.create()`.
+// raw mode and let the consumer decide whether to call `omega.windows.create()`.
 //
 // Detection: macOS sets `getLoginItemSettings().wasOpenedAtLogin = true`. On Windows we
 // register the login item with `--omega-launched-at-login` arg and check process.argv.
@@ -33,17 +33,21 @@ const logger = new LoggerLite('startup');
 const VALID_MODES = ['normal', 'hidden'];
 const LOGIN_ARG   = '--omega-launched-at-login';   // marker for Windows + Linux login-launch detection
 
+// The env keys the boot summary logs: the environment input, the login-item override,
+// and the two a parent process leaks in (ELECTRON_RUN_AS_NODE turns Electron into Node)
+const BOOT_ENV_KEYS = ['OMEGA_ENVIRONMENT', 'OMEGA_FORCE_LOGIN_ITEM', 'ELECTRON_RUN_AS_NODE', 'NODE_ENV'];
+
 const startup = {
   _initialized: false,
-  _manager:     null,
+  _omega:       null,
   _electron:    null,
 
-  initialize(manager) {
+  initialize(omega) {
     if (startup._initialized) {
       return;
     }
 
-    startup._manager = manager;
+    startup._omega = omega;
     startup._electron = require('electron');
 
     const mode         = startup.getMode();
@@ -76,8 +80,9 @@ const startup = {
     //   "Why is @omega.js/desktop behaving like X?" → check resolved values
     //   "Why did @omega.js/desktop decide X?" → check raw inputs
     const macLogin = process.platform === 'darwin' ? startup._electron.app.getLoginItemSettings() : null;
-    const emEnv = Object.fromEntries(
-      Object.entries(process.env).filter(([k]) => k.startsWith('EM_') || k === 'ELECTRON_RUN_AS_NODE' || k === 'NODE_ENV')
+    // The named knobs that steer this boot, never a prefix: OMEGA_* also names secrets
+    const bootEnv = Object.fromEntries(
+      Object.entries(process.env).filter(([k]) => BOOT_ENV_KEYS.includes(k))
     );
     const launchedAtLogin = startup.wasLaunchedAtLogin();
     const launchedAtLoginVia = startup._launchedAtLoginVia();
@@ -89,7 +94,7 @@ const startup = {
     logger.log(`  process.arch:            ${process.arch}`);
     logger.log(`  app.isPackaged:          ${startup._electron.app.isPackaged}`);
     logger.log(`  app.getLoginItemSettings(): ${macLogin ? JSON.stringify(macLogin) : '(not macOS)'}`);
-    logger.log(`  EM_/electron/node env:   ${JSON.stringify(emEnv)}`);
+    logger.log(`  boot env:                ${JSON.stringify(bootEnv)}`);
 
     logger.log('startup boot summary — RESOLVED values:');
     logger.log(`  config.startup.mode:     ${mode}`);
@@ -116,32 +121,32 @@ const startup = {
   // OMEGA_FORCE_LOGIN_ITEM=1 bypasses the guard so you can intentionally exercise the flow.
   _isDev() {
     if (process.env.OMEGA_FORCE_LOGIN_ITEM === '1') return false;
-    return !startup._manager.isProduction();
+    return !startup._omega.isProduction();
   },
 
   // Returns the resolved user-launch mode, defaulting to 'normal' for unknown values.
   getMode() {
-    const raw = startup._manager.config.startup?.mode || 'normal';
+    const raw = startup._omega.config.startup?.mode || 'normal';
     return VALID_MODES.includes(raw) ? raw : 'normal';
   },
 
   // openAtLogin block reads. `_loginEnabled` defaults to true; `_loginMode` defaults to 'hidden'.
   _loginEnabled() {
-    const v = startup._manager.config.startup?.openAtLogin;
+    const v = startup._omega.config.startup?.openAtLogin;
     if (typeof v === 'boolean') return v;                          // back-compat for boolean form
     if (v && typeof v === 'object') return v.enabled !== false;    // object form: default true
     return true;                                                   // unset → true (apps open at login by default)
   },
 
   _loginMode() {
-    const v = startup._manager.config.startup?.openAtLogin;
+    const v = startup._omega.config.startup?.openAtLogin;
     if (v && typeof v === 'object' && VALID_MODES.includes(v.mode)) return v.mode;
     return 'hidden';                                               // default: launch hidden at login
   },
 
   // True if this launch is hidden — combines user-launch mode (always honored) with
   // login-launch mode (only honored when the app was launched at login). Consumers can
-  // read this to decide whether to call manager.windows.create() during boot.
+  // read this to decide whether to call omega.windows.create() during boot.
   isLaunchHidden() {
     if (startup.getMode() === 'hidden') return true;
     if (startup.wasLaunchedAtLogin() && startup._loginMode() === 'hidden') return true;

package/dist/lib/storage.js

@@ -1,12 +1,12 @@
 // Storage — unified KV store for main + renderer.
 //
 // Main-side (sync, direct disk-backed via electron-store):
-//   manager.storage.get(key, default)
-//   manager.storage.set(key, value)
-//   manager.storage.delete(key)
-//   manager.storage.has(key)
-//   manager.storage.clear()
-//   manager.storage.onChange(key, fn)  // returns unsubscribe fn
+//   omega.storage.get(key, default)
+//   omega.storage.set(key, value)
+//   omega.storage.delete(key)
+//   omega.storage.has(key)
+//   omega.storage.clear()
+//   omega.storage.onChange(key, fn)  // returns unsubscribe fn
 //
 // Renderer-side (async, proxied through preload contextBridge → IPC → main):
 //   window.desktop.storage.get(key, default)   → Promise
@@ -27,17 +27,17 @@ const logger = new LoggerLite('storage');
 
 const storage = {
   _initialized: false,
-  _manager:     null,
+  _omega:       null,
   _store:       null,
   _changeSubs:  {}, // key -> Set<fn>
   _ipcRegistered: false,
 
-  async initialize(manager) {
+  async initialize(omega) {
     if (storage._initialized) {
       return;
     }
 
-    storage._manager = manager;
+    storage._omega = omega;
 
     let ElectronStore;
     try {
@@ -58,7 +58,7 @@ const storage = {
 
     // Build the store. Filename is `omega-storage.json` (electron-store appends .json).
     // Production name is read from electron's app.name (set automatically from package.productName).
-    const projectName = manager.config.app?.productName || electron.app.getName();
+    const projectName = omega.config.app?.productName || electron.app.getName();
 
     storage._store = new ElectronStore({
       name: 'omega-storage',

package/dist/lib/templating.js

@@ -1,15 +1,15 @@
 // Templating — light token-replacement engine for HTML/CSS/JS at build time.
 //
 // Wraps node-powertools' template() with framework-friendly defaults:
-//   - Brackets are `{{ }}` (matches BXM/UJM convention).
-//   - Standard variable scope built from manager.config + page metadata.
+//   - Brackets are `{{ }}`.
+//   - Standard variable scope built from omega.config + page metadata.
 //
 // Public API:
-//   manager.templating.render(input, vars)               // arbitrary string + arbitrary vars
-//   manager.templating.buildPageVars(pageName, extras)   // produces { brand, app, page, theme, cacheBust }
-//   manager.templating.renderPage(pageTemplate, vars)    // shortcut that uses {{ }} brackets
+//   omega.templating.render(input, vars)               // arbitrary string + arbitrary vars
+//   omega.templating.buildPageVars(pageName, extras)   // produces { brand, app, page, theme, cacheBust }
+//   omega.templating.renderPage(pageTemplate, vars)    // shortcut that uses {{ }} brackets
 //
-// Manager.initialize calls .initialize(manager) but the lib is mostly used at build time
+// omega.initialize() calls .initialize(omega) but the lib is mostly used at build time
 // (gulp/html), not at runtime. The runtime surface is exposed for consumer hooks that want
 // to template their own strings.
 
@@ -22,10 +22,10 @@ const DEFAULT_BRACKETS = ['{{', '}}'];
 
 const templating = {
   _initialized: false,
-  _manager:     null,
+  _omega:       null,
 
-  initialize(manager) {
-    templating._manager = manager;
+  initialize(omega) {
+    templating._omega = omega;
     templating._initialized = true;
     logger.log('initialize');
   },
@@ -37,19 +37,19 @@ const templating = {
     return template(String(input || ''), vars || {}, { brackets });
   },
 
-  // Build the standard variable scope for a page render. Combines manager.config with
+  // Build the standard variable scope for a page render. Combines omega.config with
   // page-specific metadata + cache-buster for asset URLs.
-  // `manager` is optional — buildPageVars works at build time (where Manager singleton is built
-  // from build.js) without needing the runtime manager singleton.
-  buildPageVars(pageName, extras, manager) {
-    const m = manager || templating._manager;
-    const cfg = (m && m.config) || (m && typeof m.getConfig === 'function' ? m.getConfig() : {}) || {};
+  // `omega` is optional: buildPageVars works at build time (where the build module from
+  // build.js stands in) without needing the runtime omega instance.
+  buildPageVars(pageName, extras, omega) {
+    omega = omega || templating._omega;
+    const cfg = (omega && omega.config) || (omega && typeof omega.getConfig === 'function' ? omega.getConfig() : {}) || {};
     // Pull version from the consumer's package.json at build time. This baked-in
     // string is used by templates that want to display the running version in the
     // UI (e.g. "v1.0.5" in a footer). At runtime it always matches the version
     // that was packaged + signed + uploaded, since both come from the same
     // package.json read.
-    const pkg = (m && typeof m.getPackage === 'function' ? m.getPackage('project') : null) || {};
+    const pkg = (omega && typeof omega.getPackage === 'function' ? omega.getPackage('project') : null) || {};
     const appBlock = { ...(cfg.app || {}) };
     if (pkg.version && !appBlock.version) appBlock.version = pkg.version;
     const vars = {

package/dist/lib/theme.js

@@ -1,10 +1,10 @@
 // Theme — system-aware dynamic appearance (light / dark / follow-the-OS).
 //
 // Main-side API:
-//   manager.theme.get()        → 'system' | 'light' | 'dark'   (the SOURCE — what's chosen)
-//   manager.theme.resolved()   → 'light' | 'dark'              (what's actually showing)
-//   manager.theme.set(source)  → apply + persist a new source
-//   manager.theme.onChange(fn) → fn({ source, resolved }) on every effective change; returns unsubscribe
+//   omega.theme.get()        → 'system' | 'light' | 'dark'   (the SOURCE — what's chosen)
+//   omega.theme.resolved()   → 'light' | 'dark'              (what's actually showing)
+//   omega.theme.set(source)  → apply + persist a new source
+//   omega.theme.onChange(fn) → fn({ source, resolved }) on every effective change; returns unsubscribe
 //
 // Renderer-side (preload contextBridge):
 //   window.desktop.theme.get()      → Promise<{ source, resolved }>
@@ -38,18 +38,18 @@ const SOURCES = ['system', 'light', 'dark'];
 
 const theme = {
   _initialized: false,
-  _manager: null,
+  _omega: null,
   _nativeTheme: null,
   _listeners: new Set(),
   _lastEmitted: null,
   _onNativeUpdated: null,
 
-  initialize(manager) {
+  initialize(omega) {
     if (theme._initialized) {
       return;
     }
 
-    theme._manager = manager;
+    theme._omega = omega;
 
     let nativeTheme;
     try {
@@ -65,8 +65,8 @@ const theme = {
     theme._nativeTheme = nativeTheme;
 
     // Boot source: storage override → config default → 'system'.
-    const stored = manager.storage.get(`${STORAGE_KEY}.appearance`);
-    const configured = manager.config?.theme?.appearance;
+    const stored = omega.storage.get(`${STORAGE_KEY}.appearance`);
+    const configured = omega.config?.theme?.appearance;
     const source = SOURCES.includes(stored) ? stored
       : SOURCES.includes(configured) ? configured
       : 'system';
@@ -116,7 +116,7 @@ const theme = {
       return;
     }
 
-    theme._manager.storage.set(`${STORAGE_KEY}.appearance`, source);
+    theme._omega.storage.set(`${STORAGE_KEY}.appearance`, source);
     theme._nativeTheme.themeSource = source;
 
     // nativeTheme 'updated' only fires when the RESOLVED appearance changes — a