@omega.js/desktop 0.52.0 → 0.53.0

package/dist/test/suites/main/url-helpers.test.js

@@ -1,8 +1,8 @@
 // Tests for src/utils/url-helpers.js — getFunctionsUrl / getApiUrl / getWebsiteUrl —
 // plus the getEnvironment() resolution they depend on (getEnvironment itself is the
 // SSOT defined in src/utils/mode-helpers.js; these tests exercise it through the
-// Manager because the URL helpers route through `this.config` and `this.getEnvironment()`).
-// The manager (already bootstrapped by the test harness) is the natural object under test.
+// omega instance because the URL helpers route through `this.config` and `this.getEnvironment()`).
+// The instance (already bootstrapped by the test harness) is the natural object under test.
 
 const defineCases = require('../../../vendor/devkit/test/define-cases.js');
 const { CLASSIC_PORTS, CLASSIC_DEV_ORIGIN } = require('../../../vendor/config/index.js');
@@ -13,11 +13,11 @@ const { CLASSIC_PORTS, CLASSIC_DEV_ORIGIN } = require('../../../vendor/config/in
 // bakes the classic map as the FLOOR of the resolved one, so the classics reach
 // these helpers the way they reach a shipped dev build, from @omega.js/config,
 // and no copy of the numbers lives in this file or in url-helpers.js.
-function withClassicBakedPorts(manager, fn) {
-  const original = manager.config.dev;
-  manager.config.dev = { ports: { ...CLASSIC_PORTS } };
+function withClassicBakedPorts(omega, fn) {
+  const original = omega.config.dev;
+  omega.config.dev = { ports: { ...CLASSIC_PORTS } };
   try { return fn(); } finally {
-    if (original !== undefined) manager.config.dev = original; else delete manager.config.dev;
+    if (original !== undefined) omega.config.dev = original; else delete omega.config.dev;
   }
 }
 
@@ -36,50 +36,50 @@ module.exports = defineCases({
       // app.isPackaged / OMEGA_BUILD_MODE / NODE_ENV sniffs.
       name: 'getEnvironment: the process input, then the baked config.environment',
       run: (ctx) => {
-        const m = ctx.manager;
-        const origConfigEnv = m.config.environment;
+        const omega = ctx.omega;
+        const origConfigEnv = omega.config.environment;
         const origVar = process.env.OMEGA_ENVIRONMENT;
         try {
           // The lane's variable is the answer wherever it exists.
-          m.config.environment = 'production';
+          omega.config.environment = 'production';
           for (const name of ['development', 'testing', 'production']) {
             process.env.OMEGA_ENVIRONMENT = name;
-            ctx.expect(m.getEnvironment()).toBe(name);
+            ctx.expect(omega.getEnvironment()).toBe(name);
           }
 
           // With no variable, the artifact's own baked word answers.
           delete process.env.OMEGA_ENVIRONMENT;
           for (const name of ['development', 'testing', 'production']) {
-            m.config.environment = name;
-            ctx.expect(m.getEnvironment()).toBe(name);
+            omega.config.environment = name;
+            ctx.expect(omega.getEnvironment()).toBe(name);
           }
 
           // Neither is a loud error, never a default.
-          delete m.config.environment;
+          delete omega.config.environment;
           let threw;
-          try { m.getEnvironment(); } catch (e) { threw = e; }
+          try { omega.getEnvironment(); } catch (e) { threw = e; }
           ctx.expect(threw).toBeDefined();
           ctx.expect(threw.message).toMatch(/OMEGA_ENVIRONMENT/);
         } finally {
-          if (origConfigEnv !== undefined) m.config.environment = origConfigEnv; else delete m.config.environment;
+          if (origConfigEnv !== undefined) omega.config.environment = origConfigEnv; else delete omega.config.environment;
           if (origVar !== undefined) process.env.OMEGA_ENVIRONMENT = origVar; else delete process.env.OMEGA_ENVIRONMENT;
         }
       },
     },
     {
       // The three checks DERIVE from getEnvironment(), on the REAL main-process
-      // Manager, so they can never disagree with it.
+      // omega instance, so they can never disagree with it.
       name: 'the three is*() checks derive from it, and exactly one is true',
       run: (ctx) => {
-        const m = ctx.manager;
+        const omega = ctx.omega;
         const origVar = process.env.OMEGA_ENVIRONMENT;
         try {
           for (const name of ['development', 'testing', 'production']) {
             process.env.OMEGA_ENVIRONMENT = name;
-            ctx.expect(m.isDevelopment()).toBe(name === 'development');
-            ctx.expect(m.isTesting()).toBe(name === 'testing');
-            ctx.expect(m.isProduction()).toBe(name === 'production');
-            ctx.expect([m.isDevelopment(), m.isTesting(), m.isProduction()].filter(Boolean).length).toBe(1);
+            ctx.expect(omega.isDevelopment()).toBe(name === 'development');
+            ctx.expect(omega.isTesting()).toBe(name === 'testing');
+            ctx.expect(omega.isProduction()).toBe(name === 'production');
+            ctx.expect([omega.isDevelopment(), omega.isTesting(), omega.isProduction()].filter(Boolean).length).toBe(1);
           }
         } finally {
           if (origVar !== undefined) process.env.OMEGA_ENVIRONMENT = origVar; else delete process.env.OMEGA_ENVIRONMENT;
@@ -89,44 +89,44 @@ module.exports = defineCases({
     {
       name: 'getFunctionsUrl: dev returns localhost:5001/<projectId>/us-central1',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.cloud = m.config.cloud || {};
-        m.config.cloud.config = m.config.cloud.config || {};
-        const orig = m.config.cloud.config.projectId;
-        m.config.cloud.config.projectId = 'demo-app';
+        const omega = ctx.omega;
+        omega.config.cloud = omega.config.cloud || {};
+        omega.config.cloud.config = omega.config.cloud.config || {};
+        const orig = omega.config.cloud.config.projectId;
+        omega.config.cloud.config.projectId = 'demo-app';
         try {
-          withClassicBakedPorts(m, () => {
-            ctx.expect(m.getFunctionsUrl('development')).toBe('http://localhost:5001/demo-app/us-central1');
+          withClassicBakedPorts(omega, () => {
+            ctx.expect(omega.getFunctionsUrl('development')).toBe('http://localhost:5001/demo-app/us-central1');
           });
-        } finally { m.config.cloud.config.projectId = orig; }
+        } finally { omega.config.cloud.config.projectId = orig; }
       },
     },
     {
       name: 'getFunctionsUrl: prod returns us-central1-<projectId>.cloudfunctions.net',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.cloud = m.config.cloud || {};
-        m.config.cloud.config = m.config.cloud.config || {};
-        const orig = m.config.cloud.config.projectId;
-        m.config.cloud.config.projectId = 'demo-app';
+        const omega = ctx.omega;
+        omega.config.cloud = omega.config.cloud || {};
+        omega.config.cloud.config = omega.config.cloud.config || {};
+        const orig = omega.config.cloud.config.projectId;
+        omega.config.cloud.config.projectId = 'demo-app';
         try {
-          ctx.expect(m.getFunctionsUrl('production')).toBe('https://us-central1-demo-app.cloudfunctions.net');
-        } finally { m.config.cloud.config.projectId = orig; }
+          ctx.expect(omega.getFunctionsUrl('production')).toBe('https://us-central1-demo-app.cloudfunctions.net');
+        } finally { omega.config.cloud.config.projectId = orig; }
       },
     },
     {
       name: 'getFunctionsUrl: throws when projectId missing',
       run: (ctx) => {
-        const m = ctx.manager;
-        const orig = m.config.cloud?.config?.projectId;
-        if (m.config.cloud?.config) delete m.config.cloud.config.projectId;
+        const omega = ctx.omega;
+        const orig = omega.config.cloud?.config?.projectId;
+        if (omega.config.cloud?.config) delete omega.config.cloud.config.projectId;
         try {
           let threw;
-          try { m.getFunctionsUrl('production'); } catch (e) { threw = e; }
+          try { omega.getFunctionsUrl('production'); } catch (e) { threw = e; }
           ctx.expect(threw).toBeDefined();
           ctx.expect(threw.message).toMatch(/cloud\.config\.projectId/);
         } finally {
-          if (orig !== undefined) m.config.cloud.config.projectId = orig;
+          if (orig !== undefined) omega.config.cloud.config.projectId = orig;
         }
       },
     },
@@ -138,8 +138,8 @@ module.exports = defineCases({
         delete process.env.OMEGA_HTTPS_PORT;
         delete process.env.OMEGA_HOSTING_PORT;
         try {
-          withClassicBakedPorts(ctx.manager, () => {
-            ctx.expect(ctx.manager.getApiUrl('development')).toBe('http://localhost:5002');
+          withClassicBakedPorts(ctx.omega, () => {
+            ctx.expect(ctx.omega.getApiUrl('development')).toBe('http://localhost:5002');
           });
         } finally {
           if (origHttps !== undefined) process.env.OMEGA_HTTPS_PORT = origHttps;
@@ -157,8 +157,8 @@ module.exports = defineCases({
         delete process.env.OMEGA_HTTPS_PORT;
         delete process.env.OMEGA_HOSTING_PORT;
         try {
-          withClassicBakedPorts(ctx.manager, () => {
-            ctx.expect(ctx.manager.getApiUrl('testing')).toBe('http://localhost:5002');
+          withClassicBakedPorts(ctx.omega, () => {
+            ctx.expect(ctx.omega.getApiUrl('testing')).toBe('http://localhost:5002');
           });
         } finally {
           if (origHttps !== undefined) process.env.OMEGA_HTTPS_PORT = origHttps;
@@ -172,15 +172,15 @@ module.exports = defineCases({
       // published OMEGA_HOSTING_PORT is plain http to the hosting emulator.
       name: 'getApiUrl: dev follows OMEGA_HTTPS_PORT (https) then OMEGA_HOSTING_PORT (http)',
       run: (ctx) => {
-        const m = ctx.manager;
+        const omega = ctx.omega;
         const origHttps = process.env.OMEGA_HTTPS_PORT;
         const origHosting = process.env.OMEGA_HOSTING_PORT;
         try {
           process.env.OMEGA_HOSTING_PORT = '5099';
           delete process.env.OMEGA_HTTPS_PORT;
-          ctx.expect(m.getApiUrl('development')).toBe('http://localhost:5099');
+          ctx.expect(omega.getApiUrl('development')).toBe('http://localhost:5099');
           process.env.OMEGA_HTTPS_PORT = '5443';
-          ctx.expect(m.getApiUrl('development')).toBe('https://localhost:5443');
+          ctx.expect(omega.getApiUrl('development')).toBe('https://localhost:5443');
         } finally {
           if (origHttps !== undefined) process.env.OMEGA_HTTPS_PORT = origHttps; else delete process.env.OMEGA_HTTPS_PORT;
           if (origHosting !== undefined) process.env.OMEGA_HOSTING_PORT = origHosting; else delete process.env.OMEGA_HOSTING_PORT;
@@ -190,25 +190,25 @@ module.exports = defineCases({
     {
       // #745: the baked `dev.ports` map (written by the bundle task from the
       // sibling backend's ports file) is the second channel, behind the env
-      // and ahead of the classics, on the REAL main-process Manager shape.
+      // and ahead of the classics, on the REAL main-process omega shape.
       name: 'getApiUrl: dev follows the baked dev.ports map when no env is published',
       run: (ctx) => {
-        const m = ctx.manager;
-        const origDev = m.config.dev;
+        const omega = ctx.omega;
+        const origDev = omega.config.dev;
         const origHttps = process.env.OMEGA_HTTPS_PORT;
         const origHosting = process.env.OMEGA_HOSTING_PORT;
         try {
           delete process.env.OMEGA_HTTPS_PORT;
           delete process.env.OMEGA_HOSTING_PORT;
-          m.config.dev = { ports: { hosting: 5012 } };
-          ctx.expect(m.getApiUrl('development')).toBe('http://localhost:5012');
-          m.config.dev = { ports: { hosting: 5012, https: 5003 } };
-          ctx.expect(m.getApiUrl('development')).toBe('https://localhost:5003');
+          omega.config.dev = { ports: { hosting: 5012 } };
+          ctx.expect(omega.getApiUrl('development')).toBe('http://localhost:5012');
+          omega.config.dev = { ports: { hosting: 5012, https: 5003 } };
+          ctx.expect(omega.getApiUrl('development')).toBe('https://localhost:5003');
           process.env.OMEGA_HOSTING_PORT = '5099';
-          delete m.config.dev.ports.https;
-          ctx.expect(m.getApiUrl('development')).toBe('http://localhost:5099');
+          delete omega.config.dev.ports.https;
+          ctx.expect(omega.getApiUrl('development')).toBe('http://localhost:5099');
         } finally {
-          if (origDev !== undefined) m.config.dev = origDev; else delete m.config.dev;
+          if (origDev !== undefined) omega.config.dev = origDev; else delete omega.config.dev;
           if (origHttps !== undefined) process.env.OMEGA_HTTPS_PORT = origHttps; else delete process.env.OMEGA_HTTPS_PORT;
           if (origHosting !== undefined) process.env.OMEGA_HOSTING_PORT = origHosting; else delete process.env.OMEGA_HOSTING_PORT;
         }
@@ -219,36 +219,36 @@ module.exports = defineCases({
       // the API base must come from brand.url, never authDomain.
       name: 'getApiUrl: prod returns api.<brand.url host>, never api.<authDomain>',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.brand = m.config.brand || {};
-        const origUrl = m.config.brand.url;
-        m.config.brand.url = 'https://demo-app.example.com';
-        m.config.cloud = m.config.cloud || {};
-        m.config.cloud.config = m.config.cloud.config || {};
-        const origAuth = m.config.cloud.config.authDomain;
-        m.config.cloud.config.authDomain = 'demo-app.firebaseapp.com';
+        const omega = ctx.omega;
+        omega.config.brand = omega.config.brand || {};
+        const origUrl = omega.config.brand.url;
+        omega.config.brand.url = 'https://demo-app.example.com';
+        omega.config.cloud = omega.config.cloud || {};
+        omega.config.cloud.config = omega.config.cloud.config || {};
+        const origAuth = omega.config.cloud.config.authDomain;
+        omega.config.cloud.config.authDomain = 'demo-app.firebaseapp.com';
         try {
-          ctx.expect(m.getApiUrl('production')).toBe('https://api.demo-app.example.com');
+          ctx.expect(omega.getApiUrl('production')).toBe('https://api.demo-app.example.com');
         } finally {
-          m.config.brand.url = origUrl;
-          m.config.cloud.config.authDomain = origAuth;
+          omega.config.brand.url = origUrl;
+          omega.config.cloud.config.authDomain = origAuth;
         }
       },
     },
     {
       name: 'getApiUrl: throws when brand.url missing in prod',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.brand = m.config.brand || {};
-        const orig = m.config.brand.url;
-        delete m.config.brand.url;
+        const omega = ctx.omega;
+        omega.config.brand = omega.config.brand || {};
+        const orig = omega.config.brand.url;
+        delete omega.config.brand.url;
         try {
           let threw;
-          try { m.getApiUrl('production'); } catch (e) { threw = e; }
+          try { omega.getApiUrl('production'); } catch (e) { threw = e; }
           ctx.expect(threw).toBeDefined();
           ctx.expect(threw.message).toMatch(/brand\.url/);
         } finally {
-          if (orig !== undefined) m.config.brand.url = orig;
+          if (orig !== undefined) omega.config.brand.url = orig;
         }
       },
     },
@@ -258,8 +258,8 @@ module.exports = defineCases({
         const orig = process.env.OMEGA_WEBSITE_PORT;
         delete process.env.OMEGA_WEBSITE_PORT;
         try {
-          withClassicBakedPorts(ctx.manager, () => {
-            ctx.expect(ctx.manager.getWebsiteUrl('development')).toBe('https://localhost:4000');
+          withClassicBakedPorts(ctx.omega, () => {
+            ctx.expect(ctx.omega.getWebsiteUrl('development')).toBe('https://localhost:4000');
           });
         } finally {
           if (orig !== undefined) process.env.OMEGA_WEBSITE_PORT = orig;
@@ -272,7 +272,7 @@ module.exports = defineCases({
         const orig = process.env.OMEGA_WEBSITE_PORT;
         try {
           process.env.OMEGA_WEBSITE_PORT = '4001';
-          ctx.expect(ctx.manager.getWebsiteUrl('development')).toBe('https://localhost:4001');
+          ctx.expect(ctx.omega.getWebsiteUrl('development')).toBe('https://localhost:4001');
         } finally {
           if (orig !== undefined) process.env.OMEGA_WEBSITE_PORT = orig; else delete process.env.OMEGA_WEBSITE_PORT;
         }
@@ -281,19 +281,19 @@ module.exports = defineCases({
     {
       // #747: the baked `dev.origin` (the live website's published origin,
       // scheme included) is the complete fact and outranks the env port, on
-      // the REAL main-process Manager shape; getAuthUrl rides it by construction.
+      // the REAL main-process omega shape; getAuthUrl rides it by construction.
       name: 'getWebsiteUrl: dev follows the baked dev.origin over OMEGA_WEBSITE_PORT',
       run: (ctx) => {
-        const m = ctx.manager;
-        const origDev = m.config.dev;
+        const omega = ctx.omega;
+        const origDev = omega.config.dev;
         const origPort = process.env.OMEGA_WEBSITE_PORT;
         try {
           process.env.OMEGA_WEBSITE_PORT = '4001';
-          m.config.dev = { origin: 'https://localhost:4123' };
-          ctx.expect(m.getWebsiteUrl('development')).toBe('https://localhost:4123');
-          ctx.expect(new URL(m.getAuthUrl('development')).origin).toBe('https://localhost:4123');
+          omega.config.dev = { origin: 'https://localhost:4123' };
+          ctx.expect(omega.getWebsiteUrl('development')).toBe('https://localhost:4123');
+          ctx.expect(new URL(omega.getAuthUrl('development')).origin).toBe('https://localhost:4123');
         } finally {
-          if (origDev !== undefined) m.config.dev = origDev; else delete m.config.dev;
+          if (origDev !== undefined) omega.config.dev = origDev; else delete omega.config.dev;
           if (origPort !== undefined) process.env.OMEGA_WEBSITE_PORT = origPort; else delete process.env.OMEGA_WEBSITE_PORT;
         }
       },
@@ -301,28 +301,28 @@ module.exports = defineCases({
     {
       name: 'getWebsiteUrl: prod returns config.brand.url',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.brand = m.config.brand || {};
-        const orig = m.config.brand.url;
-        m.config.brand.url = 'https://example.com';
+        const omega = ctx.omega;
+        omega.config.brand = omega.config.brand || {};
+        const orig = omega.config.brand.url;
+        omega.config.brand.url = 'https://example.com';
         try {
-          ctx.expect(m.getWebsiteUrl('production')).toBe('https://example.com');
-        } finally { m.config.brand.url = orig; }
+          ctx.expect(omega.getWebsiteUrl('production')).toBe('https://example.com');
+        } finally { omega.config.brand.url = orig; }
       },
     },
     {
       name: 'getWebsiteUrl: throws in prod when brand.url is missing',
       run: (ctx) => {
-        const m = ctx.manager;
-        const orig = m.config.brand?.url;
-        if (m.config.brand) delete m.config.brand.url;
+        const omega = ctx.omega;
+        const orig = omega.config.brand?.url;
+        if (omega.config.brand) delete omega.config.brand.url;
         try {
           let threw;
-          try { m.getWebsiteUrl('production'); } catch (e) { threw = e; }
+          try { omega.getWebsiteUrl('production'); } catch (e) { threw = e; }
           ctx.expect(threw).toBeDefined();
           ctx.expect(threw.message).toMatch(/brand\.url/);
         } finally {
-          if (orig !== undefined) m.config.brand.url = orig;
+          if (orig !== undefined) omega.config.brand.url = orig;
         }
       },
     },
@@ -331,13 +331,13 @@ module.exports = defineCases({
       // (searchParams round-trip), not by string-matching encodings.
       name: 'getAuthUrl: chains /signin → /token → <brand.id>://auth/token (dev)',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.brand = m.config.brand || {};
-        const origId = m.config.brand.id;
-        m.config.brand.id = 'demo';
+        const omega = ctx.omega;
+        omega.config.brand = omega.config.brand || {};
+        const origId = omega.config.brand.id;
+        omega.config.brand.id = 'demo';
         try {
-          withClassicBakedPorts(m, () => {
-            const url = new URL(m.getAuthUrl('development'));
+          withClassicBakedPorts(omega, () => {
+            const url = new URL(omega.getAuthUrl('development'));
             ctx.expect(url.origin).toBe('https://localhost:4000');
             ctx.expect(url.pathname).toBe('/signin');
             const tokenUrl = new URL(url.searchParams.get('authReturnUrl'));
@@ -346,29 +346,29 @@ module.exports = defineCases({
             ctx.expect(tokenUrl.searchParams.get('authReturnUrl')).toBe('demo://auth/token');
           });
         } finally {
-          if (origId !== undefined) m.config.brand.id = origId; else delete m.config.brand.id;
+          if (origId !== undefined) omega.config.brand.id = origId; else delete omega.config.brand.id;
         }
       },
     },
     {
       name: 'getAuthUrl: prod rides brand.url',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.brand = m.config.brand || {};
-        const origId = m.config.brand.id;
-        const origUrl = m.config.brand.url;
-        m.config.brand.id = 'demo';
-        m.config.brand.url = 'https://example.com';
+        const omega = ctx.omega;
+        omega.config.brand = omega.config.brand || {};
+        const origId = omega.config.brand.id;
+        const origUrl = omega.config.brand.url;
+        omega.config.brand.id = 'demo';
+        omega.config.brand.url = 'https://example.com';
         try {
-          const url = new URL(m.getAuthUrl('production'));
+          const url = new URL(omega.getAuthUrl('production'));
           ctx.expect(url.origin).toBe('https://example.com');
           ctx.expect(url.pathname).toBe('/signin');
           const tokenUrl = new URL(url.searchParams.get('authReturnUrl'));
           ctx.expect(tokenUrl.origin).toBe('https://example.com');
           ctx.expect(tokenUrl.searchParams.get('authReturnUrl')).toBe('demo://auth/token');
         } finally {
-          if (origId !== undefined) m.config.brand.id = origId; else delete m.config.brand.id;
-          if (origUrl !== undefined) m.config.brand.url = origUrl; else delete m.config.brand.url;
+          if (origId !== undefined) omega.config.brand.id = origId; else delete omega.config.brand.id;
+          if (origUrl !== undefined) omega.config.brand.url = origUrl; else delete omega.config.brand.url;
         }
       },
     },
@@ -376,38 +376,38 @@ module.exports = defineCases({
       // The dev loopback return channel (lib/auth-flow.js) swaps the final hop.
       name: 'getAuthUrl: optional returnUrl overrides the final hop',
       run: (ctx) => {
-        const m = ctx.manager;
-        m.config.brand = m.config.brand || {};
-        const origId = m.config.brand.id;
-        m.config.brand.id = 'demo';
+        const omega = ctx.omega;
+        omega.config.brand = omega.config.brand || {};
+        const origId = omega.config.brand.id;
+        omega.config.brand.id = 'demo';
         try {
           const loopback = 'http://127.0.0.1:49152/auth/token?state=abc';
-          withClassicBakedPorts(m, () => {
-            const url = new URL(m.getAuthUrl('development', loopback));
+          withClassicBakedPorts(omega, () => {
+            const url = new URL(omega.getAuthUrl('development', loopback));
             const tokenUrl = new URL(url.searchParams.get('authReturnUrl'));
             ctx.expect(tokenUrl.pathname).toBe('/token');
             ctx.expect(tokenUrl.searchParams.get('authReturnUrl')).toBe(loopback);
           });
         } finally {
-          if (origId !== undefined) m.config.brand.id = origId; else delete m.config.brand.id;
+          if (origId !== undefined) omega.config.brand.id = origId; else delete omega.config.brand.id;
         }
       },
     },
     {
       name: 'getAuthUrl: throws when brand.id missing',
       run: (ctx) => {
-        const m = ctx.manager;
-        const orig = m.config.brand?.id;
-        if (m.config.brand) delete m.config.brand.id;
+        const omega = ctx.omega;
+        const orig = omega.config.brand?.id;
+        if (omega.config.brand) delete omega.config.brand.id;
         try {
-          withClassicBakedPorts(m, () => {
+          withClassicBakedPorts(omega, () => {
             let threw;
-            try { m.getAuthUrl('development'); } catch (e) { threw = e; }
+            try { omega.getAuthUrl('development'); } catch (e) { threw = e; }
             ctx.expect(threw).toBeDefined();
             ctx.expect(threw.message).toMatch(/brand\.id/);
           });
         } finally {
-          if (orig !== undefined) m.config.brand.id = orig;
+          if (orig !== undefined) omega.config.brand.id = orig;
         }
       },
     },
@@ -416,21 +416,21 @@ module.exports = defineCases({
       // the one input (#817): whatever the lane named for this process.
       name: 'getWebsiteUrl: respects the current environment when no arg passed',
       run: (ctx) => {
-        const m = ctx.manager;
+        const omega = ctx.omega;
         const origVar = process.env.OMEGA_ENVIRONMENT;
-        m.config.brand = m.config.brand || {};
-        const origUrl = m.config.brand.url;
-        m.config.brand.url = 'https://example.com';
+        omega.config.brand = omega.config.brand || {};
+        const origUrl = omega.config.brand.url;
+        omega.config.brand.url = 'https://example.com';
         try {
           process.env.OMEGA_ENVIRONMENT = 'development';
-          withClassicBakedPorts(m, () => {
-            ctx.expect(m.getWebsiteUrl()).toBe('https://localhost:4000');
+          withClassicBakedPorts(omega, () => {
+            ctx.expect(omega.getWebsiteUrl()).toBe('https://localhost:4000');
           });
           process.env.OMEGA_ENVIRONMENT = 'production';
-          ctx.expect(m.getWebsiteUrl()).toBe('https://example.com');
+          ctx.expect(omega.getWebsiteUrl()).toBe('https://example.com');
         } finally {
           if (origVar !== undefined) process.env.OMEGA_ENVIRONMENT = origVar; else delete process.env.OMEGA_ENVIRONMENT;
-          m.config.brand.url = origUrl;
+          omega.config.brand.url = origUrl;
         }
       },
     },

package/dist/test/suites/main/usage.test.js

@@ -6,9 +6,9 @@ const STORAGE_KEY = 'usage';
 
 async function reinitWithSnapshot(ctx, snapshot) {
   // Reset and re-init with a planted previous snapshot.
-  ctx.manager.usage.shutdown();
-  ctx.manager.storage.set(STORAGE_KEY, snapshot);
-  ctx.manager.usage.initialize(ctx.manager);
+  ctx.omega.usage.shutdown();
+  ctx.omega.storage.set(STORAGE_KEY, snapshot);
+  ctx.omega.usage.initialize(ctx.omega);
 }
 
 module.exports = defineCases({
@@ -16,28 +16,28 @@ module.exports = defineCases({
   layer: 'main',
   description: 'usage (main)',
   cleanup: (ctx) => {
-    ctx.manager.usage.shutdown();
-    ctx.manager.storage.set(STORAGE_KEY, null);
-    ctx.manager.usage.initialize(ctx.manager);
+    ctx.omega.usage.shutdown();
+    ctx.omega.storage.set(STORAGE_KEY, null);
+    ctx.omega.usage.initialize(ctx.omega);
   },
   tests: [
     {
-      name: 'usage module wired on manager + initialized during boot',
+      name: 'usage module wired on omega + initialized during boot',
       run: (ctx) => {
-        ctx.expect(ctx.manager.usage).toBeDefined();
-        ctx.expect(ctx.manager.usage._initialized).toBe(true);
+        ctx.expect(ctx.omega.usage).toBeDefined();
+        ctx.expect(ctx.omega.usage._initialized).toBe(true);
       },
     },
     {
       name: 'opens() returns at least 1 (this launch)',
       run: (ctx) => {
-        ctx.expect(ctx.manager.usage.opens() >= 1).toBe(true);
+        ctx.expect(ctx.omega.usage.opens() >= 1).toBe(true);
       },
     },
     {
       name: 'hoursThisSession() is a small positive number',
       run: (ctx) => {
-        const h = ctx.manager.usage.hoursThisSession();
+        const h = ctx.omega.usage.hoursThisSession();
         ctx.expect(typeof h).toBe('number');
         ctx.expect(h >= 0).toBe(true);
         ctx.expect(h < 1).toBe(true);   // tests run in seconds, not hours
@@ -48,14 +48,14 @@ module.exports = defineCases({
       run: async (ctx) => {
         // Plant a known starting state so this test isn't sensitive to whatever
         // accumulated in the prior test's storage.
-        ctx.manager.usage.shutdown();
-        ctx.manager.storage.set('usage', { opens: 5, hoursTotal: 0, installedAt: '2024-01-01T00:00:00Z', lastLaunchAt: null, lastQuitAt: null });
-        ctx.manager.usage.initialize(ctx.manager);
-        const before = ctx.manager.usage.opens();
+        ctx.omega.usage.shutdown();
+        ctx.omega.storage.set('usage', { opens: 5, hoursTotal: 0, installedAt: '2024-01-01T00:00:00Z', lastLaunchAt: null, lastQuitAt: null });
+        ctx.omega.usage.initialize(ctx.omega);
+        const before = ctx.omega.usage.opens();
         ctx.expect(before).toBe(6);   // 5 + this re-init
-        ctx.manager.usage.shutdown();
-        ctx.manager.usage.initialize(ctx.manager);
-        const after = ctx.manager.usage.opens();
+        ctx.omega.usage.shutdown();
+        ctx.omega.usage.initialize(ctx.omega);
+        const after = ctx.omega.usage.opens();
         ctx.expect(after).toBe(before + 1);   // 7
       },
     },
@@ -73,10 +73,10 @@ module.exports = defineCases({
           installedAt:  '2024-01-01T00:00:00.000Z',
         });
         // After re-init we should have hoursTotal = 10 + 2 = 12 (within rounding).
-        const ht = ctx.manager.usage.hoursTotal();
+        const ht = ctx.omega.usage.hoursTotal();
         ctx.expect(ht > 11.9).toBe(true);
         ctx.expect(ht < 12.1).toBe(true);
-        ctx.expect(ctx.manager.usage.opens()).toBe(6);
+        ctx.expect(ctx.omega.usage.opens()).toBe(6);
       },
     },
     {
@@ -90,7 +90,7 @@ module.exports = defineCases({
           installedAt:  '2024-01-01T00:00:00.000Z',
         });
         // Should still be 5 — crashed sessions don't credit hours.
-        ctx.expect(ctx.manager.usage.hoursTotal()).toBe(5);
+        ctx.expect(ctx.omega.usage.hoursTotal()).toBe(5);
       },
     },
     {
@@ -103,13 +103,13 @@ module.exports = defineCases({
           lastLaunchAt: new Date().toISOString(),
           lastQuitAt:   null,
         });
-        ctx.expect(ctx.manager.usage.installedAt()).toBe('2023-06-15T10:00:00.000Z');
+        ctx.expect(ctx.omega.usage.installedAt()).toBe('2023-06-15T10:00:00.000Z');
       },
     },
     {
       name: 'toJSON includes opens, hoursTotal, hoursThisSession, installedAt',
       run: (ctx) => {
-        const j = ctx.manager.usage.toJSON();
+        const j = ctx.omega.usage.toJSON();
         ctx.expect(typeof j.opens).toBe('number');
         ctx.expect(typeof j.hoursTotal).toBe('number');
         ctx.expect(typeof j.hoursThisSession).toBe('number');
@@ -119,8 +119,8 @@ module.exports = defineCases({
     {
       name: 'IPC handler desktop:usage:get returns the snapshot',
       run: async (ctx) => {
-        const snap = await ctx.manager.ipc.invoke('desktop:usage:get');
-        ctx.expect(snap.opens).toBe(ctx.manager.usage.opens());
+        const snap = await ctx.omega.ipc.invoke('desktop:usage:get');
+        ctx.expect(snap.opens).toBe(ctx.omega.usage.opens());
       },
     },
   ],