fusion/packages/desktop/scripts/build.ts

import { build } from "esbuild";
import { cp, mkdir, rm, stat } from "node:fs/promises";
import { join } from "node:path";
import { buildDashboard, buildDashboardClient, packageRoot, workspaceRoot } from "./workspace-tools";
const dashboardRoot = join(workspaceRoot, "packages", "dashboard");
const dashboardClientDir = join(dashboardRoot, "dist", "client");
const dashboardRegistryManifestSource = join(dashboardRoot, "src", "registry-manifest.json");
const dashboardRegistryManifestDist = join(dashboardRoot, "dist", "registry-manifest.json");
const desktopDistDir = join(packageRoot, "dist");
const desktopClientDistDir = join(desktopDistDir, "client");
// FNXC:DesktopBuild 2026-06-25-09:45:
// Every workspace @fusion/* package and native (.node) module must stay external
// to the Electron main/preload bundles — they resolve from node_modules at runtime.
// @fusion/engine was missing here, so esbuild followed local-runtime.ts's dynamic
// `import("@fusion/engine")` and tried to bundle engine's transitive node-pty
// (@homebridge/node-pty-prebuilt-multiarch) native binaries, failing with
// "No loader is configured for .node files" and breaking every desktop release build.
const sharedExternals = [
  "electron",
  "@fusion/core",
  "@fusion/dashboard",
  "@fusion/engine",
  "better-sqlite3",
];
const mainExternals = sharedExternals;
const preloadExternals = sharedExternals;

async function ensureDashboardBuild(): Promise<void> {
  // FNXC:DesktopBuild 2026-07-01-11:35:
  // Windows release packaging invokes only `@fusion/desktop build` before electron-builder.
  // Build the dashboard server dist and copy registry-manifest.json here so the packaged
  // embedded runtime never depends on a separate `@fusion/dashboard build` workflow step.
  console.log("[desktop:build] Building dashboard server runtime...");
  await buildDashboard();
  await cp(dashboardRegistryManifestSource, dashboardRegistryManifestDist);

  console.log("[desktop:build] Building dashboard client for file:// desktop loading...");
  await buildDashboardClient();

  try {
    await stat(dashboardClientDir);
  } catch {
    throw new Error(`Dashboard client assets not found: ${dashboardClientDir}`);
  }

  try {
    await stat(dashboardRegistryManifestDist);
  } catch {
    throw new Error(`Dashboard registry manifest not found: ${dashboardRegistryManifestDist}`);
  }
}

async function buildElectronEntrypoints(): Promise<void> {
  console.log("[desktop:build] Bundling Electron main/preload with esbuild...");

  await Promise.all([
    build({
      entryPoints: [join(packageRoot, "src", "main.ts")],
      outfile: join(desktopDistDir, "main.js"),
      bundle: true,
      format: "esm",
      platform: "node",
      target: "node22",
      sourcemap: true,
      // FNXC:DesktopBuild 2026-07-01-07:31:
      // Windows Electron main output is ESM, but electron-updater loads CJS deps
      // such as fs-extra/graceful-fs that dynamically require built-ins. Keep all
      // npm packages external so Node/Electron evaluates those CJS modules natively
      // instead of esbuild emitting a __require("fs") trap in dist/main.js.
      packages: "external",
      external: mainExternals,
      logLevel: "info",
    }),
    build({
      entryPoints: [join(packageRoot, "src", "preload.ts")],
      outfile: join(desktopDistDir, "preload.js"),
      bundle: true,
      // Preload scripts must be CommonJS — Electron loads them via the
      // sandboxed Node context, not as ESM. With format:"esm" the
      // contextBridge calls silently no-op and window.fusionShell /
      // window.fusionAPI stay undefined, which made the dashboard fall
      // through to "can't reach the Fusion backend" and the launch gate
      // always bypass.
      format: "cjs",
      platform: "node",
      target: "node22",
      sourcemap: true,
      packages: "external",
      external: preloadExternals,
      logLevel: "info",
    }),
  ]);
}

async function copyDashboardClient(): Promise<void> {
  console.log("[desktop:build] Copying dashboard client into desktop dist/client...");
  await cp(dashboardClientDir, desktopClientDistDir, { recursive: true });
}

async function main(): Promise<void> {
  await rm(desktopDistDir, { recursive: true, force: true });
  await mkdir(desktopDistDir, { recursive: true });

  await ensureDashboardBuild();
  await buildElectronEntrypoints();
  await copyDashboardClient();

  console.log("[desktop:build] Desktop build complete");
}

void main().catch((error) => {
  console.error("[desktop:build] Build failed", error);
  process.exitCode = 1;
});