@omega.js/desktop 0.52.0 → 0.54.0

package/dist/vendor/config/schema-manager.js

@@ -0,0 +1,118 @@
+/**
+ * Schema rules for the keys the manager's services (and the backend's content
+ * generators) read or write back: the brand switch, service switches, and the
+ * Stripe, GA4, devlog, blog and SEO engine data. The four zero-data switches
+ * default ON here and are materialized into brand files; the engine data's
+ * defaults stay in the manager's config.js.
+ */
+
+const MANAGER_RULES = [
+  {
+    path:        'enabled',
+    type:        'boolean',
+    required:    false,
+    default:     true,
+    description: 'Whether the brand is active. `false` makes the manager skip it: a company run stamps it but never spawns its walk.',
+  },
+  {
+    path:        'server.enabled',
+    type:        'boolean',
+    required:    false,
+    default:     true,
+    description: "false (or `server: false`) skips the manager's server service, which registers this brand in the company server's brands collection.",
+  },
+  {
+    path:        'assets.enabled',
+    type:        'boolean',
+    required:    false,
+    default:     true,
+    description: "false (or `assets: false`) skips the manager's assets service, which derives the brand's visual collateral from its logo sources.",
+  },
+  {
+    path:        'payment.enabled',
+    type:        'boolean',
+    required:    false,
+    default:     true,
+    description: "false skips the manager's payment service: no provider account, product, webhook or Radar reconciliation for this brand.",
+  },
+  {
+    path:        'payment.providers.stripe.updateAccountInfo',
+    type:        'boolean',
+    required:    false,
+    description: "false leaves the Stripe account's business profile alone instead of diffing it to the brand's name, url and support email.",
+  },
+  {
+    path:        'payment.providers.stripe.radar',
+    type:        'array',
+    required:    false,
+    description: "The Radar fraud rules ([{ action, predicate, description }]) the payment service prints as guidance: Radar has no API, so a human applies them in the Dashboard.",
+  },
+  {
+    path:        'payment.providers.stripe.radarConfirmed',
+    type:        'boolean',
+    required:    false,
+    description: 'Machine-written: the Radar rules were applied by hand in the Dashboard. The confirmation is the record, because nothing can read them back.',
+  },
+  {
+    path:        'payment.providers.stripe.disputesConfirmed',
+    type:        'boolean',
+    required:    false,
+    description: 'Machine-written: Enhanced Dispute Protection was switched on by hand in the Dashboard. The confirmation is the record, because nothing can read it back.',
+  },
+  {
+    path:        'analytics.providers.google.timeZone',
+    type:        'string',
+    required:    false,
+    description: 'The GA4 property reporting time zone the analytics service uses when it creates the property.',
+  },
+  {
+    path:        'analytics.providers.google.currency',
+    type:        'string',
+    required:    false,
+    description: 'The GA4 property reporting currency the analytics service uses when it creates the property.',
+  },
+  {
+    path:        'analytics.providers.google.enhancedMeasurement',
+    type:        'object',
+    required:    false,
+    description: "The GA4 web streams' Enhanced Measurement switches ({ scrollsEnabled, siteSearchEnabled, … }) the analytics service diffs every stream to.",
+  },
+  {
+    path:        'devlog.providers.ghostii',
+    type:        'object',
+    required:    false,
+    description: 'The devlog writer and its settings (orgs, lookbackDays, excludeRepos, excludeCommits, excludeTopics, includePrivate, postPath, destinations, overrides): the manager\'s devlog pipeline reads them here.',
+  },
+  {
+    path:        'blog.enabled',
+    type:        'boolean',
+    required:    false,
+    description: "true lets the backend's daily blog auto-publisher run; absent or false, it skips.",
+  },
+  {
+    path:        'blog.providers',
+    type:        'object',
+    required:    false,
+    description: 'The blog writer, a KEY under `providers` (ghostii when none is picked).',
+  },
+  {
+    path:        'blog.content',
+    type:        'object|array',
+    required:    false,
+    description: 'The blog pipeline entries ({ sources, categories, links, postPath, … }), one object or a list.',
+  },
+  {
+    path:        'seo.enabled',
+    type:        'boolean',
+    required:    false,
+    description: "false (or `seo: false`) skips the manager's seo service.",
+  },
+  {
+    path:        'seo.github',
+    type:        'object',
+    required:    false,
+    description: "The parasite-SEO content repos (`seo.github.content[]`) the seo service reconciles; a `config/seo.json5` sidecar merges over it.",
+  },
+];
+
+module.exports = { MANAGER_RULES };

package/dist/vendor/config/schema-overrides.js

@@ -0,0 +1,68 @@
+/**
+ * Per-target rules for what a brand hands a framework verbatim: the desktop
+ * install knobs electron-builder takes, and the documented override blocks
+ * whose shape belongs to someone else (electron-builder, Electron, the MCP
+ * client), where a rule types the block and never the keys inside it.
+ */
+
+// A platform's install knobs beside its `formats`, handed to electron-builder
+const knob = (path, type, description) => ({ path: `platforms.${path}`, type, required: false, description });
+
+const DESKTOP = [
+  knob('mac.arch', 'array|string', 'The mac architectures built (`universal`, `x64`, `arm64`).'),
+  knob('mac.entitlements', 'object|string', 'The mac hardened-runtime entitlements (a map, or a plist path).'),
+  knob('mac.mas.enabled', 'boolean', 'Mac App Store distribution: reserved, not implemented yet (the audit warns when true).'),
+  knob('mac.mas.provisioningProfile', 'string', 'The Mac App Store provisioning profile path (reserved).'),
+  knob('mac.mas.entitlements', 'string', 'The Mac App Store entitlements plist (reserved).'),
+  knob('mac.mas.entitlementsInherit', 'string', 'The Mac App Store inherited entitlements plist (reserved).'),
+  knob('windows.arch', 'array|string', 'The Windows architectures built (`x64`, `ia32`, `arm64`).'),
+  knob('windows.oneClick', 'boolean', 'NSIS one-click install (no wizard).'),
+  knob('windows.desktopShortcut', 'boolean', 'NSIS creates a desktop shortcut.'),
+  knob('windows.startMenuShortcut', 'boolean', 'NSIS creates a Start-menu shortcut.'),
+  knob('windows.runAfterFinish', 'boolean', 'NSIS launches the app when the install finishes.'),
+  knob('windows.perMachine', 'boolean', 'NSIS installs for every user rather than the current one.'),
+  knob('windows.signing.cloud', 'object', 'The cloud signing provider and its options, for the `cloud` signing strategy.'),
+  knob('linux.arch', 'array|string', 'The Linux architectures built (`x64`, `arm64`).'),
+  {
+    path:        'electronBuilder',
+    type:        'object',
+    required:    false,
+    description: "Merged over the generated electron-builder config as the LAST layer (build-config.js), for the rare knob the framework defaults do not cover. Any electron-builder key.",
+  },
+  {
+    path:        'fileAssociations',
+    type:        'array',
+    required:    false,
+    description: "The file types the packaged app registers for ([{ ext, name, role, icon }]), handed to electron-builder's fileAssociations as written.",
+  },
+  {
+    path:        'protocols',
+    type:        'array',
+    required:    false,
+    description: "The URL schemes the packaged app registers for ([{ name, schemes }]), handed to electron-builder's protocols as written.",
+  },
+  {
+    path:        'windows',
+    type:        'object',
+    required:    false,
+    description: 'Per-window BrowserWindow options keyed by window name (`windows.main.width`); the window manager merges each over its own defaults, and a call-site override still wins.',
+  },
+  {
+    path:        'cdp',
+    type:        'object',
+    required:    false,
+    description: 'The desktop cdp command\'s settings. `cdp.readySignal` is the URL substring of the view whose load marks boot complete, for an app that finishes after its first paint.',
+  },
+];
+
+const BACKEND = [
+  {
+    path:        'mcp.authUrl',
+    type:        'string',
+    required:    false,
+    match:       /^https?:\/\//,
+    description: "Overrides the consumer auth URL the backend's MCP OAuth flow sends a client to; unset derives `<website url>/token` (docs/backend/mcp.md).",
+  },
+];
+
+module.exports = { OVERRIDE_RULES: { desktop: DESKTOP, backend: BACKEND } };