@omega.js/desktop 0.51.0 → 0.53.0

package/dist/build.js

@@ -1,96 +1,71 @@
+// The build-time module: one plain object of functions every gulp task, verb
+// and consumer hook reads (`const build = require('@omega.js/desktop/build')`).
+// No class and no `new`, the shape @omega.js/web's and @omega.js/extension's
+// build modules share.
+
 // Libraries
 const path = require('path');
 const jetpack = require('fs-jetpack');
 const { setEnvironment, buildLaneEnvironment } = require('./vendor/config/environment.js');
 const fs = require('fs');
 const JSON5 = require('json5');
-const { force, execute } = require('node-powertools');
+const { force } = require('node-powertools');
 const { parseArgv } = require('./vendor/devkit/argv.js');
+const { getEnvironment, isDevelopment, isProduction, isTesting, getVersion } = require('./utils/mode-helpers.js');
 
-// Class
-function Manager() {
-  const self = this;
-
-  // Properties
-  self._logger = null;
-
-  // Return
-  return self;
+// Logger: a named build logger
+function logger(name) {
+  return new (require('./vendor/devkit/logger.js'))(name);
 }
 
-// Initialize (build-time hook)
-Manager.prototype.initialize = function () {
-  console.log('initialize:');
-};
-
-// Logger
-Manager.prototype.logger = function (name) {
-  // Static-style call
-  if (!(this instanceof Manager)) {
-    return new (require('./lib/logger'))(name);
-  }
-
-  // Cache one logger per Manager instance
-  if (!this._logger) {
-    this._logger = new (require('./lib/logger'))(name);
-  }
-
-  return this._logger;
-};
-
 // argv: the gulp lane's own parse. It is spawned with the TASK NAME alone
 // (`npm run gulp -- build`), so `debug` is the one flag it declares.
-Manager.getArguments = function () {
+function getArguments() {
   const options = parseArgv(process.argv.slice(2), { booleans: ['debug'] });
 
   options.debug = force(options.debug === undefined ? false : options.debug, 'boolean');
 
   return options;
-};
-Manager.prototype.getArguments = Manager.getArguments;
+}
 
-// Report build errors with notification (parity with BXM)
-Manager.reportBuildError = function (error, callback) {
-  const logger = new (require('./lib/logger'))('build-error');
+// Report build errors with notification (parity with @omega.js/extension)
+function reportBuildError(error, callback) {
+  const log = logger('build-error');
   const errorMessage = error.message || error.toString() || 'Unknown error';
   const errorPlugin = error.plugin || 'Build';
 
-  logger.error(`[${errorPlugin}] ${errorMessage}`);
+  log.error(`[${errorPlugin}] ${errorMessage}`);
 
   if (callback) {
     return callback(error);
   }
 
   return (cb) => cb ? cb(error) : error;
-};
-Manager.prototype.reportBuildError = Manager.reportBuildError;
+}
 
 // Mode flags
-Manager.isBuildMode = function () {
+function isBuildMode() {
   return process.env.OMEGA_BUILD_MODE === 'true';
-};
-Manager.prototype.isBuildMode = Manager.isBuildMode;
+}
 
-Manager.isPublishMode = function () {
+function isPublishMode() {
   return process.env.OMEGA_IS_PUBLISH === 'true';
-};
-Manager.prototype.isPublishMode = Manager.isPublishMode;
+}
 
-Manager.isServerMode = function () {
+function isServerMode() {
   return process.env.OMEGA_IS_SERVER === 'true';
-};
-Manager.prototype.isServerMode = Manager.isServerMode;
+}
 
-Manager.actLikeProduction = function () {
-  return Boolean(Manager.isBuildMode() || process.env.OMEGA_AUDIT_FORCE === 'true');
-};
-Manager.prototype.actLikeProduction = Manager.actLikeProduction;
+function actLikeProduction() {
+  return Boolean(isBuildMode() || process.env.OMEGA_AUDIT_FORCE === 'true');
+}
 
 // The environment is the ONE module's (@omega.js/config's environment.js,
 // [#817](https://github.com/Omega-JS-Stack/omega/issues/817)), reachable from
-// all four @omega.js/desktop Manager entry points (main / renderer / preload /
-// build) through the mode-helpers attachTo() call at the bottom of each, so
-// every context resolves it identically. It reads ONE input and never guesses.
+// all four @omega.js/desktop entry points (the main / renderer / preload `Omega`
+// classes and this build module) through the same plain functions in
+// utils/mode-helpers.js, so every context resolves it identically. It reads ONE
+// input and never guesses.
 //
 // THIS FILE IS THE NODE LANE'S ONE SETTER, and it runs at load, before any
 // gulp task, verb or getConfig() asks. Two rules, no sniffing:
@@ -108,19 +83,18 @@ Manager.prototype.actLikeProduction = Manager.actLikeProduction;
 // The electron app this lane spawns inherits the variable; a PACKAGED app has
 // no parent env, so main.js sets it from the baked config instead (the same
 // word, written into the artifact by the bundle task).
-setEnvironment(buildLaneEnvironment(Manager.isBuildMode()));
+setEnvironment(buildLaneEnvironment(isBuildMode()));
 
-Manager.getMode = function () {
+function getMode() {
   return {
-    build:   Manager.isBuildMode(),
-    publish: Manager.isPublishMode(),
-    server:  Manager.isServerMode(),
-    environment: Manager.getEnvironment(),
+    build:   isBuildMode(),
+    publish: isPublishMode(),
+    server:  isServerMode(),
+    environment: getEnvironment(),
   };
-};
-Manager.prototype.getMode = Manager.getMode;
+}
 
-// Config — the consumer's config/omega.json5 resolved for the desktop target via
+// Config: the consumer's config/omega.json5 resolved for the desktop target via
 // @omega.js/config: shared sections (brand, cloud, analytics, payment, monitoring,
 // theme) at the top level, targets.desktop overlaid onto them (so app/platforms/startup/
 // releases/... land at the top level here), and in a brand monorepo the brand root's
@@ -136,7 +110,7 @@ Manager.prototype.getMode = Manager.getMode;
 //   app.productName ← brand.name if not set
 // These keep the consumer's config minimal: setting `brand: { id: 'foo', name: 'Foo',
 // url: 'https://foo.com' }` is enough; appId/productName flow through automatically.
-Manager.getConfig = function () {
+function getConfig() {
   const { hasOmegaConfig, loadConfig, composeBundleId, deriveBundleIdPrefix } = require('./vendor/config/index.js');
 
   // WHICH environment overlay composes
@@ -147,7 +121,7 @@ Manager.getConfig = function () {
   // every other read in the process answers from, so the overlay that composes
   // and the environment the artifact records can never be two different words.
   // Same rule, same shape, in @omega.js/extension's getConfig.
-  const environment = Manager.getEnvironment();
+  const environment = getEnvironment();
 
   // No config at all (fresh dir, non-consumer cwd) → seeded empty shape below; the
   // schema validation in audit/boot reports what's actually missing.
@@ -184,11 +158,10 @@ Manager.getConfig = function () {
   if (!config.app.productName && config.brand.name) config.app.productName = config.brand.name;
 
   return config;
-};
-Manager.prototype.getConfig = Manager.getConfig;
+}
 
 // package.json
-Manager.getPackage = function (type) {
+function getPackage(type) {
   const basePath = type === 'project'
     ? process.cwd()
     : path.resolve(__dirname, '..');
@@ -201,35 +174,31 @@ Manager.getPackage = function (type) {
   }
 
   return JSON5.parse(raw);
-};
-Manager.prototype.getPackage = Manager.getPackage;
+}
 
 // Root path
-Manager.getRootPath = function (type) {
+function getRootPath(type) {
   return type === 'project'
     ? process.cwd()
     : path.resolve(__dirname, '..');
-};
-Manager.prototype.getRootPath = Manager.getRootPath;
+}
 
 // Live reload port
-Manager.getLiveReloadPort = function () {
+function getLiveReloadPort() {
   process.env.OMEGA_LIVERELOAD_PORT = process.env.OMEGA_LIVERELOAD_PORT || 35729;
   return parseInt(process.env.OMEGA_LIVERELOAD_PORT, 10);
-};
-Manager.prototype.getLiveReloadPort = Manager.getLiveReloadPort;
+}
 
 // Windows signing strategy. Config-only: `platforms.windows.signing.strategy`
 // (targets.desktop.platforms.windows in the raw omega.json5). Default 'self-hosted'.
-Manager.getWindowsSignStrategy = function () {
-  const config = Manager.getConfig();
+function getWindowsSignStrategy() {
+  const config = getConfig();
   return config?.platforms?.windows?.signing?.strategy || 'self-hosted';
-};
-Manager.prototype.getWindowsSignStrategy = Manager.getWindowsSignStrategy;
+}
 
 // Touch files to trigger a rebuild watcher
-Manager.triggerRebuild = function (files, logger) {
-  logger = this?._logger || logger || console;
+function triggerRebuild(files, log) {
+  log = log || console;
 
   if (typeof files === 'string') {
     files = [files];
@@ -238,7 +207,7 @@ Manager.triggerRebuild = function (files, logger) {
   } else if (typeof files === 'object' && files !== null) {
     files = Object.keys(files);
   } else {
-    logger.error('Invalid files for triggerRebuild()');
+    log.error('Invalid files for triggerRebuild()');
     return;
   }
 
@@ -247,24 +216,15 @@ Manager.triggerRebuild = function (files, logger) {
   files.forEach((file) => {
     try {
       fs.utimesSync(file, now, now);
-      logger.log(`Triggered build: ${file}`);
+      log.log(`Triggered build: ${file}`);
     } catch (e) {
-      logger.error(`Failed to trigger build ${file}`, e);
+      log.error(`Failed to trigger build ${file}`, e);
     }
   });
-};
-Manager.prototype.triggerRebuild = Manager.triggerRebuild;
-
-// Generic require passthrough (lets gulp tasks dynamically load lib modules).
-// Only ever called from gulp tasks (release / package / bundle), which run
-// un-bundled — so plain require is fine.
-Manager.require = function (p) {
-  return require(p);
-};
-Manager.prototype.require = Manager.require;
+}
 
 // Memory usage
-Manager.getMemoryUsage = function () {
+function getMemoryUsage() {
   const used = process.memoryUsage();
   return {
     rss:       Math.round(used.rss / 1024 / 1024),
@@ -272,19 +232,35 @@ Manager.getMemoryUsage = function () {
     heapUsed:  Math.round(used.heapUsed / 1024 / 1024),
     external:  Math.round(used.external / 1024 / 1024),
   };
-};
-Manager.prototype.getMemoryUsage = Manager.getMemoryUsage;
-
-Manager.logMemory = function (logger, label) {
-  const mem = Manager.getMemoryUsage();
-  logger.log(`[Memory ${label}] RSS: ${mem.rss}MB | Heap Used: ${mem.heapUsed}MB / ${mem.heapTotal}MB | External: ${mem.external}MB`);
-};
-Manager.prototype.logMemory = Manager.logMemory;
+}
 
-// Mix in shared cross-context helpers — same code path used in main, renderer, preload.
-// All four contexts share the exact same implementation.
-require('./utils/mode-helpers.js').attachTo(Manager);
-require('./utils/url-helpers.js').attachTo(Manager);
+function logMemory(log, label) {
+  const mem = getMemoryUsage();
+  log.log(`[Memory ${label}] RSS: ${mem.rss}MB | Heap Used: ${mem.heapUsed}MB / ${mem.heapTotal}MB | External: ${mem.external}MB`);
+}
 
-// Export
-module.exports = Manager;
+// Export: the environment four + getVersion() come from the same plain
+// functions the runtime `Omega` classes call
+module.exports = {
+  logger,
+  getArguments,
+  reportBuildError,
+  isBuildMode,
+  isPublishMode,
+  isServerMode,
+  actLikeProduction,
+  getMode,
+  getConfig,
+  getPackage,
+  getRootPath,
+  getLiveReloadPort,
+  getWindowsSignStrategy,
+  triggerRebuild,
+  getMemoryUsage,
+  logMemory,
+  getEnvironment,
+  isDevelopment,
+  isProduction,
+  isTesting,
+  getVersion,
+};

package/dist/cli.js

@@ -19,7 +19,7 @@ const { isBoxVerbArgv } = require('./vendor/devkit/omega-bin.js');
 // reading of it, covering the bare verb and its `--` flag spelling alike.
 if (!isBoxVerbArgv(process.argv.slice(2))) {
   require('./utils/load-env.js').loadDesktopEnv(process.cwd(), {
-    logger: new (require('./lib/logger.js'))('env'),
+    logger: new (require('./vendor/devkit/logger.js'))('env'),
   });
 }
 

package/dist/commands/build.js

@@ -1,6 +1,6 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('build');
+const build = require('../build.js');
+const logger = build.logger('build');
 const { runPipeline } = require('../utils/build-pipeline.js');
 const { ensureTarget } = require('./lib/ensure-target.js');
 

package/dist/commands/cdp/capture.js

@@ -21,7 +21,7 @@
 const { execFileSync } = require('child_process');
 const client = require('./client');
 
-const Manager = new (require('../../build.js'))();
+const build = require('../../build.js');
 
 const SRGB_PROFILE = '/System/Library/ColorSync/Profiles/sRGB Profile.icc';
 
@@ -65,7 +65,7 @@ module.exports = async function (options) {
     throw new Error('mgr cdp capture is macOS-only (screencapture/sips/osascript)');
   }
 
-  const names = client.appNames(Manager.getConfig());
+  const names = client.appNames(build.getConfig());
 
   if (options['find-window-id'] || options.findWindowId) {
     console.log(findWindowIds(names) || `no windows found (tried: ${names.join(', ')})`);

package/dist/commands/cdp/quit.js

@@ -9,7 +9,7 @@
 const { execFileSync } = require('child_process');
 const client = require('./client');
 
-const Manager = new (require('../../build.js'))();
+const build = require('../../build.js');
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
@@ -77,7 +77,7 @@ async function quitAndDrain(names) {
 }
 
 module.exports = async function (options) {
-  const wasRunning = await quitAndDrain(client.appNames(Manager.getConfig()));
+  const wasRunning = await quitAndDrain(client.appNames(build.getConfig()));
   console.log(wasRunning ? 'quit running app' : 'app was not running');
 };
 

package/dist/commands/cdp/relaunch.js

@@ -17,7 +17,7 @@ const { spawn } = require('child_process');
 const client = require('./client');
 const { quitAndDrain } = require('./quit');
 
-const Manager = new (require('../../build.js'))();
+const build = require('../../build.js');
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
@@ -42,7 +42,7 @@ async function waitForBoot(matcher) {
 }
 
 module.exports = async function (options) {
-  const config = Manager.getConfig();
+  const config = build.getConfig();
 
   const wasRunning = await quitAndDrain(client.appNames(config));
   console.log(wasRunning ? 'quit running app' : 'app was not running');

package/dist/commands/cdp/theme.js

@@ -1,5 +1,5 @@
 // `npx omega cdp theme <dark|light|system>` — flip the app's theme live
-// (manager.theme via the main window's renderer).
+// (omega.theme via the main window's renderer).
 //
 // Flips every renderer (BrowserWindows AND WebContentsViews) with no restart —
 // nativeTheme.themeSource → prefers-color-scheme → the preload applier

package/dist/commands/clean.js

@@ -1,6 +1,6 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('clean');
+const build = require('../build.js');
+const logger = build.logger('clean');
 const { cleanDirs } = require('../vendor/devkit/clean-dirs.js');
 const { ensureTarget } = require('./lib/ensure-target.js');
 

package/dist/commands/deploy.js

@@ -18,8 +18,8 @@
  * most; a linked brand now packs its frameworks into the snapshot instead.
  */
 const path = require('node:path');
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('deploy');
+const build = require('../build.js');
+const logger = build.logger('deploy');
 const attachLogFile = require('../utils/attach-log-file.js');
 const { assertBrandVersion } = require('../vendor/devkit/brand-version.js');
 const { targetNameFromDir } = require('../vendor/config/index.js');
@@ -62,9 +62,9 @@ module.exports = async function (options) {
   if (dryRun) {
     logger.log('DRY RUN, skipping hook "deploy/pre"');
   } else {
-    // The one ctx shape every OMEGA hook takes, `{ manager, projectRoot, mode }`,
+    // The one ctx shape every OMEGA hook takes, `{ build, projectRoot, mode }`,
     // and a deploy's mode is PRODUCTION: what it is about to publish is a release.
-    await runConsumerHook('deploy/pre', { manager: Manager, projectRoot: projectDir, mode: 'production' });
+    await runConsumerHook('deploy/pre', { build, projectRoot: projectDir, mode: 'production' });
   }
 
   // The direct lane: build + sign + publish from THIS machine, for this

package/dist/commands/finalize-release.js

@@ -27,9 +27,9 @@ const jetpack = require('fs-jetpack');
 
 const { getOctokit } = require('../utils/github.js');
 const { releasesRepo } = require('../vendor/config/index.js');
-const Manager = new (require('../build.js'));
+const build = require('../build.js');
 
-const logger = Manager.logger('finalize-release');
+const logger = build.logger('finalize-release');
 
 module.exports = async function finalizeRelease(options = {}) {
   const argv = options._ || [];
@@ -42,8 +42,8 @@ module.exports = async function finalizeRelease(options = {}) {
   }
 
   const projectRoot = process.cwd();
-  const config      = Manager.getConfig() || {};
-  const pkgVersion  = (Manager.getPackage('project') || {}).version;
+  const config      = build.getConfig() || {};
+  const pkgVersion  = (build.getPackage('project') || {}).version;
 
   if (!pkgVersion) {
     throw new Error('finalize-release: package.json version not found');

package/dist/commands/install.js

@@ -1,9 +1,9 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('install');
+const build = require('../build.js');
+const logger = build.logger('install');
 const local = require('../vendor/devkit/local.js');
 
-const package = Manager.getPackage('main');
+const package = build.getPackage('main');
 
 module.exports = async function (options) {
   logger.log(`Installing ${package.name}...`);

package/dist/commands/launch.js

@@ -31,8 +31,8 @@ const fs       = require('fs');
 const jetpack  = require('fs-jetpack');
 const { spawn } = require('child_process');
 
-const Manager = new (require('../build.js'));
-const logger  = Manager.logger('launch');
+const build = require('../build.js');
+const logger  = build.logger('launch');
 
 module.exports = async function (options) {
   options = options || {};

package/dist/commands/lib/deploy-precheck.js

@@ -22,14 +22,14 @@
  * The RUNNER is `@omega.js/devkit/deploy-precheck` (one copy for every
  * framework); this file is desktop's STEPS.
  */
-const Manager = new (require('../../build.js'));
+const build = require('../../build.js');
 const { runDeployPrecheck } = require('../../vendor/devkit/deploy-precheck.js');
 const { releasesRepo } = require('../../vendor/config/index.js');
 const { publishTargetSecrets } = require('../../vendor/devkit/target-secrets.js');
 const { resolveToken } = require('../../vendor/devkit/deploy.js');
 const { updateManager } = require('./dependencies.js');
 
-const package = Manager.getPackage('main');
+const package = build.getPackage('main');
 
 /**
  * Auto-provision the brand's ONE public releases repo, addressed by
@@ -57,7 +57,7 @@ const package = Manager.getPackage('main');
 async function provisionReleaseRepos({ log, warn, config, execFn, dryRun }) {
   const { ensureRepo } = require('../../vendor/devkit/github-repo.js');
 
-  const resolved = config || Manager.getConfig() || {};
+  const resolved = config || build.getConfig() || {};
   if (resolved.releases?.enabled === false) return;
 
   const releases = releasesRepo(resolved);

package/dist/commands/lib/ensure-target.js

@@ -31,14 +31,14 @@
 const path = require('path');
 const jetpack = require('fs-jetpack');
 const version = require('wonderful-version');
-const Manager = new (require('../../build.js'));
+const build = require('../../build.js');
 const { ensurePeerDependencies, readProject } = require('./dependencies.js');
 const { renderSecretsBlock } = require('../../vendor/config/env-delivery.js');
 const { composeTargetWorkflows, renderInstallFirewall, renderInstallWorkspace } = require('../../vendor/devkit/ci-workflows.js');
 const { assertScaffoldable } = require('../../vendor/devkit/scaffold-guard.js');
 
-const logger = Manager.logger('ensure-target');
-const package = Manager.getPackage('main');
+const logger = build.logger('ensure-target');
+const package = build.getPackage('main');
 
 /**
  * Sync the consumer manifest: the omega verb scripts, the npm-private latch,
@@ -47,7 +47,7 @@ const package = Manager.getPackage('main');
  * Identical content is not a write (#590).
  */
 function setupScripts(projectDir, result) {
-  projectDir = projectDir || Manager.getRootPath('project');
+  projectDir = projectDir || build.getRootPath('project');
   result = result || { changed: [] };
 
   const project = readProject(projectDir);
@@ -128,7 +128,7 @@ function checkNodeVersion(projectDir, requiredMajor, warn) {
  * @param {object} log - `{ log, warn, error }` handed to the engine.
  */
 async function copyDefaults(projectDir, engineLogger) {
-  projectDir = projectDir || Manager.getRootPath('project');
+  projectDir = projectDir || build.getRootPath('project');
   engineLogger = engineLogger || logger;
 
   const defaultsDir = path.resolve(__dirname, '..', '..', 'defaults');
@@ -311,7 +311,7 @@ function checkLocality(projectDir) {
  */
 async function ensureTarget(options) {
   options = options || {};
-  const projectDir = options.projectDir || Manager.getRootPath('project');
+  const projectDir = options.projectDir || build.getRootPath('project');
   const log = options.log || (() => {});
   const warn = options.warn || (() => {});
   const result = { written: [], merged: [], changed: [] };

package/dist/commands/package.js

@@ -1,6 +1,6 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('package');
+const build = require('../build.js');
+const logger = build.logger('package');
 const { runPipeline } = require('../utils/build-pipeline.js');
 
 // `npx omega package` (the consumer's `package` script) builds the full installer

package/dist/commands/publish.js

@@ -1,6 +1,6 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('publish');
+const build = require('../build.js');
+const logger = build.logger('publish');
 const { runPipeline } = require('../utils/build-pipeline.js');
 
 // `npx omega publish` publishes from an already-built tree (the CI lane calls it

package/dist/commands/release.js

@@ -24,9 +24,9 @@ const attachLogFile = require('../utils/attach-log-file.js');
 const { deployViaDispatch, dispatchTarget, laneLabel, resolveToken } = require('../vendor/devkit/deploy.js');
 const { followRun } = require('../vendor/devkit/deploy-follow.js');
 const { targetNameFromDir } = require('../vendor/config/index.js');
-const Manager = new (require('../build.js'));
+const build = require('../build.js');
 
-const logger = Manager.logger('release');
+const logger = build.logger('release');
 
 module.exports = async function release(options = {}) {
   const projectRoot = process.cwd();
@@ -58,7 +58,7 @@ module.exports = async function release(options = {}) {
   // `build.yml` standalone). ONE helper for all four targets
   // ([#847](https://github.com/Omega-JS-Stack/omega/issues/847)), where this
   // file used to keep desktop's own copy of it.
-  const { owner, repo, workflow: WORKFLOW_FILE } = dispatchTarget({ projectRoot, config: Manager.getConfig(), workflow: 'build.yml' });
+  const { owner, repo, workflow: WORKFLOW_FILE } = dispatchTarget({ projectRoot, config: build.getConfig(), workflow: 'build.yml' });
 
   // Optional --platforms / --platform flag forwarded as a workflow input. Accepts a
   // single value ('windows') or comma-separated list ('mac,linux'). Special value