@sanity/workbench-cli 1.1.0-beta.0 → 1.1.1

package/dist/actions/dev/startWorkbenchDev.js

@@ -0,0 +1,152 @@
+import { styleText } from 'node:util';
+import { startAppServerSupervisor } from './appServerSupervisor.js';
+import { startDevServerRegistration } from './startDevServerRegistration.js';
+import { startWorkbenchDevServer, startWorkbenchRemoteCoordinator } from './startWorkbenchDevServer.js';
+/** How long teardown runs before re-raising the signal to force-exit — enough for
+ * Vite/watchers to close, short enough not to strand a backgrounded process. */ const SHUTDOWN_GRACE_MS = 5000;
+// Bind-only addresses ('0.0.0.0', '::') aren't routable in every browser (notably
+// Windows); the displayed URL falls back to localhost. The bind address is untouched.
+function toDisplayHost(host) {
+    if (!host || host === '0.0.0.0' || host === '::' || host === '[::]') {
+        return 'localhost';
+    }
+    return host;
+}
+/**
+ * Orchestrate the dev servers a workbench project needs: a singleton workbench
+ * Vite server plus the app/studio dev server it renders, wired to the dev-server
+ * registry so view/service edits re-sync live.
+ *
+ * A running workbench claims the configured port, so the app server binds the
+ * next one. If the workbench can't start (package or port unavailable), the app
+ * server falls back to the configured port and announces its own URL, exactly as
+ * a plain `sanity dev` would.
+ */ export async function startWorkbenchDev(options) {
+    const { appId, cacheDir, checkForDeprecatedAppId, cliConfig, extractManifest, httpHost, httpPort, isApp, output, reactStrictMode, startAppServer, workDir } = options;
+    // The remote can't render itself, so it runs as a plain app server (not the
+    // shell) that still claims the lock and bridges the registry, so app
+    // `sanity dev`s register into it.
+    if (process.env.SANITY_INTERNAL_IS_WORKBENCH_REMOTE === 'true') {
+        const remote = await startAppServer({
+            announceUrl: true,
+            cliConfig,
+            httpPort
+        });
+        if (!remote.started) return {
+            close: async ()=>{}
+        };
+        const addr = remote.server.httpServer?.address();
+        const port = (typeof addr === 'object' && addr ? addr.port : remote.server.config.server.port) ?? httpPort;
+        const coordinator = startWorkbenchRemoteCoordinator({
+            httpHost,
+            port,
+            server: remote.server
+        });
+        return {
+            close: async ()=>{
+                await coordinator.close();
+                await remote.close();
+            }
+        };
+    }
+    // Unwound in reverse on any failure or on close(): the watcher stops before
+    // the app server, and the supervisor waits out an in-flight rebuild.
+    const closers = [];
+    const disposeAll = async ()=>{
+        for (const close of closers.splice(0).toReversed()){
+            await close().catch(()=>{});
+        }
+    };
+    const workbench = await startWorkbenchDevServer({
+        cacheDir,
+        cliConfig,
+        httpHost,
+        httpPort,
+        output,
+        reactStrictMode,
+        workDir
+    });
+    closers.push(workbench.close);
+    // A running workbench owns the configured port; the app server takes the next.
+    // Without one it claims the configured port and announces its own URL.
+    const appPort = workbench.workbenchAvailable ? workbench.workbenchPort + 1 : httpPort;
+    const announceUrl = !workbench.workbenchAvailable;
+    let closing;
+    const close = ()=>{
+        closing ??= (async ()=>{
+            process.off('SIGINT', onSignal);
+            process.off('SIGTERM', onSignal);
+            await disposeAll();
+        })();
+        return closing;
+    };
+    const supervised = await startAppServerSupervisor({
+        cliConfig,
+        start: (config)=>startAppServer({
+                announceUrl,
+                cliConfig: config,
+                httpPort: appPort
+            }),
+        workDir
+    }).catch(async (err)=>{
+        await disposeAll();
+        throw err;
+    });
+    if (!supervised.started) {
+        // The app server already reported why (e.g. missing organization id). Hand
+        // back a close that releases the workbench lock; nothing else came up.
+        return {
+            close
+        };
+    }
+    const { supervisor } = supervised;
+    closers.push(supervisor.close);
+    try {
+        // The deprecated-id check and manifest extractor are CLI-domain, injected here.
+        checkForDeprecatedAppId();
+        const registration = await startDevServerRegistration({
+            appId,
+            cliConfig,
+            extractManifest,
+            isApp,
+            onInterfaceSetChange: ()=>supervisor.rebuild(),
+            output,
+            server: supervisor.server,
+            workDir
+        });
+        closers.push(registration.close);
+    } catch (err) {
+        // Registration runs after both servers are up; a failure here would leak the
+        // workbench lock and dev servers without this teardown.
+        await disposeAll();
+        throw err;
+    }
+    if (workbench.workbenchAvailable) {
+        const workbenchUrl = `http://${toDisplayHost(workbench.httpHost)}:${workbench.workbenchPort}`;
+        const addr = supervisor.server.httpServer?.address();
+        const port = typeof addr === 'object' && addr ? addr.port : supervisor.server.config.server.port;
+        output.log(`Workbench dev server started at ${styleText([
+            'blue',
+            'underline'
+        ], workbenchUrl)} (app on port ${port})`);
+    }
+    // Trapping the signal disables Node's default exit, and a finished teardown
+    // doesn't guarantee an empty event loop (keep-alive sockets, an extraction
+    // worker mid-run) — so re-raise after teardown to restore conventional signal
+    // exit semantics. A backstop timer force-exits if teardown wedges.
+    function onSignal(signal) {
+        const graceTimer = setTimeout(()=>process.kill(process.pid, signal), SHUTDOWN_GRACE_MS);
+        graceTimer.unref();
+        void close().finally(()=>{
+            clearTimeout(graceTimer);
+            process.kill(process.pid, signal);
+        });
+    }
+    process.once('SIGINT', onSignal);
+    process.once('SIGTERM', onSignal);
+    return {
+        close
+    };
+}
+
+//# sourceMappingURL=startWorkbenchDev.js.map

package/dist/actions/dev/startWorkbenchDev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/dev/startWorkbenchDev.ts"],"sourcesContent":["import {styleText} from 'node:util'\n\nimport {type CliConfig, type Output} from '@sanity/cli-core'\n\nimport {type AppServerResult, startAppServerSupervisor} from './appServerSupervisor.js'\nimport {type DevServerManifest} from './registry.js'\nimport {startDevServerRegistration} from './startDevServerRegistration.js'\nimport {\n  startWorkbenchDevServer,\n  startWorkbenchRemoteCoordinator,\n} from './startWorkbenchDevServer.js'\n\n/** How long teardown runs before re-raising the signal to force-exit — enough for\n * Vite/watchers to close, short enough not to strand a backgrounded process. */\nconst SHUTDOWN_GRACE_MS = 5000\n\n// Bind-only addresses ('0.0.0.0', '::') aren't routable in every browser (notably\n// Windows); the displayed URL falls back to localhost. The bind address is untouched.\nfunction toDisplayHost(host: string | undefined): string {\n  if (!host || host === '0.0.0.0' || host === '::' || host === '[::]') {\n    return 'localhost'\n  }\n  return host\n}\n\nexport interface StartWorkbenchDevOptions {\n  /** Resolved app id for the registry entry (the CLI owns id resolution). */\n  appId: string | undefined\n  /** Directory for the workbench Vite server's dependency cache. */\n  cacheDir: string\n  /** CLI-domain `app.id`/`deployment.appId` deprecation check, run before registering. */\n  checkForDeprecatedAppId: () => void\n  cliConfig: CliConfig\n  /** Extract the project manifest to inline into the registry (studio-vs-app handled by the CLI). */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  httpHost: string | undefined\n  httpPort: number\n  isApp: boolean\n  output: Output\n  reactStrictMode: boolean\n  /** Start the app/studio dev server — the CLI owns the server, this orchestrates it. */\n  startAppServer: (params: {\n    announceUrl: boolean\n    cliConfig: CliConfig\n    httpPort: number\n  }) => Promise<AppServerResult>\n  workDir: string\n}\n\n/**\n * Orchestrate the dev servers a workbench project needs: a singleton workbench\n * Vite server plus the app/studio dev server it renders, wired to the dev-server\n * registry so view/service edits re-sync live.\n *\n * A running workbench claims the configured port, so the app server binds the\n * next one. If the workbench can't start (package or port unavailable), the app\n * server falls back to the configured port and announces its own URL, exactly as\n * a plain `sanity dev` would.\n */\nexport async function startWorkbenchDev(\n  options: StartWorkbenchDevOptions,\n): Promise<{close: () => Promise<void>}> {\n  const {\n    appId,\n    cacheDir,\n    checkForDeprecatedAppId,\n    cliConfig,\n    extractManifest,\n    httpHost,\n    httpPort,\n    isApp,\n    output,\n    reactStrictMode,\n    startAppServer,\n    workDir,\n  } = options\n\n  // The remote can't render itself, so it runs as a plain app server (not the\n  // shell) that still claims the lock and bridges the registry, so app\n  // `sanity dev`s register into it.\n  if (process.env.SANITY_INTERNAL_IS_WORKBENCH_REMOTE === 'true') {\n    const remote = await startAppServer({announceUrl: true, cliConfig, httpPort})\n    if (!remote.started) return {close: async () => {}}\n\n    const addr = remote.server.httpServer?.address()\n    const port =\n      (typeof addr === 'object' && addr ? addr.port : remote.server.config.server.port) ?? httpPort\n    const coordinator = startWorkbenchRemoteCoordinator({httpHost, port, server: remote.server})\n\n    return {\n      close: async () => {\n        await coordinator.close()\n        await remote.close()\n      },\n    }\n  }\n\n  // Unwound in reverse on any failure or on close(): the watcher stops before\n  // the app server, and the supervisor waits out an in-flight rebuild.\n  const closers: Array<() => Promise<void>> = []\n  const disposeAll = async () => {\n    for (const close of closers.splice(0).toReversed()) {\n      await close().catch(() => {})\n    }\n  }\n\n  const workbench = await startWorkbenchDevServer({\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort,\n    output,\n    reactStrictMode,\n    workDir,\n  })\n  closers.push(workbench.close)\n\n  // A running workbench owns the configured port; the app server takes the next.\n  // Without one it claims the configured port and announces its own URL.\n  const appPort = workbench.workbenchAvailable ? workbench.workbenchPort + 1 : httpPort\n  const announceUrl = !workbench.workbenchAvailable\n\n  let closing: Promise<void> | undefined\n  const close = () => {\n    closing ??= (async () => {\n      process.off('SIGINT', onSignal)\n      process.off('SIGTERM', onSignal)\n      await disposeAll()\n    })()\n    return closing\n  }\n\n  const supervised = await startAppServerSupervisor({\n    cliConfig,\n    start: (config) => startAppServer({announceUrl, cliConfig: config, httpPort: appPort}),\n    workDir,\n  }).catch(async (err) => {\n    await disposeAll()\n    throw err\n  })\n\n  if (!supervised.started) {\n    // The app server already reported why (e.g. missing organization id). Hand\n    // back a close that releases the workbench lock; nothing else came up.\n    return {close}\n  }\n  const {supervisor} = supervised\n  closers.push(supervisor.close)\n\n  try {\n    // The deprecated-id check and manifest extractor are CLI-domain, injected here.\n    checkForDeprecatedAppId()\n    const registration = await startDevServerRegistration({\n      appId,\n      cliConfig,\n      extractManifest,\n      isApp,\n      onInterfaceSetChange: () => supervisor.rebuild(),\n      output,\n      server: supervisor.server,\n      workDir,\n    })\n    closers.push(registration.close)\n  } catch (err) {\n    // Registration runs after both servers are up; a failure here would leak the\n    // workbench lock and dev servers without this teardown.\n    await disposeAll()\n    throw err\n  }\n\n  if (workbench.workbenchAvailable) {\n    const workbenchUrl = `http://${toDisplayHost(workbench.httpHost)}:${workbench.workbenchPort}`\n    const addr = supervisor.server.httpServer?.address()\n    const port = typeof addr === 'object' && addr ? addr.port : supervisor.server.config.server.port\n    output.log(\n      `Workbench dev server started at ${styleText(['blue', 'underline'], workbenchUrl)} (app on port ${port})`,\n    )\n  }\n\n  // Trapping the signal disables Node's default exit, and a finished teardown\n  // doesn't guarantee an empty event loop (keep-alive sockets, an extraction\n  // worker mid-run) — so re-raise after teardown to restore conventional signal\n  // exit semantics. A backstop timer force-exits if teardown wedges.\n  function onSignal(signal: NodeJS.Signals) {\n    const graceTimer = setTimeout(() => process.kill(process.pid, signal), SHUTDOWN_GRACE_MS)\n    graceTimer.unref()\n    void close().finally(() => {\n      clearTimeout(graceTimer)\n      process.kill(process.pid, signal)\n    })\n  }\n  process.once('SIGINT', onSignal)\n  process.once('SIGTERM', onSignal)\n\n  return {close}\n}\n"],"names":["styleText","startAppServerSupervisor","startDevServerRegistration","startWorkbenchDevServer","startWorkbenchRemoteCoordinator","SHUTDOWN_GRACE_MS","toDisplayHost","host","startWorkbenchDev","options","appId","cacheDir","checkForDeprecatedAppId","cliConfig","extractManifest","httpHost","httpPort","isApp","output","reactStrictMode","startAppServer","workDir","process","env","SANITY_INTERNAL_IS_WORKBENCH_REMOTE","remote","announceUrl","started","close","addr","server","httpServer","address","port","config","coordinator","closers","disposeAll","splice","toReversed","catch","workbench","push","appPort","workbenchAvailable","workbenchPort","closing","off","onSignal","supervised","start","err","supervisor","registration","onInterfaceSetChange","rebuild","workbenchUrl","log","signal","graceTimer","setTimeout","kill","pid","unref","finally","clearTimeout","once"],"mappings":"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"}

package/dist/actions/dev/startWorkbenchDevServer.js

@@ -0,0 +1,289 @@
+import { isWorkbenchApp, resolveLocalPackage, subdebug } from '@sanity/cli-core';
+import viteReact from '@vitejs/plugin-react';
+import { createServer } from 'vite';
+import { z } from 'zod/mini';
+import { createInterfacesTracker } from './interfaceSetId.js';
+import { acquireWorkbenchLock, getRegisteredServers, readWorkbenchLock, watchRegistry } from './registry.js';
+import { writeWorkbenchRuntime } from './writeWorkbenchRuntime.js';
+const devDebug = subdebug('dev');
+const noop = async ()=>{};
+const toApplicationsPayload = (servers)=>({
+        applications: servers.map(({ host, id, interfaces, manifest, port, projectId, type })=>({
+                host,
+                id,
+                interfaces,
+                manifest,
+                port,
+                projectId,
+                type
+            }))
+    });
+/**
+ * Bridge the dev-server registry into a workbench Vite server's HMR channel so
+ * the page tracks apps as they come and go. A changed interface set means a
+ * rebuilt remote — full-reload to drop the stale remote-entry; otherwise
+ * rebroadcast for a soft reconcile. Returns a detach fn.
+ */ function attachViteDevServerBridge(server) {
+    server.ws.on('sanity:workbench:get-local-applications', (_, client)=>{
+        client.send('sanity:workbench:local-applications', toApplicationsPayload(getRegisteredServers()));
+    });
+    const setTracker = createInterfacesTracker();
+    const registryWatcher = watchRegistry((servers)=>{
+        if (setTracker.hasChanged(servers)) {
+            server.ws.send({
+                type: 'full-reload'
+            });
+            return;
+        }
+        server.ws.send('sanity:workbench:local-applications', toApplicationsPayload(servers));
+    });
+    return ()=>registryWatcher.close();
+}
+/**
+ * Make the workbench remote act as the machine's workbench: claim the singleton
+ * lock so app `sanity dev`s register into it instead of each starting their own,
+ * and bridge the registry so the remote shows the local apps. No-op lock if one
+ * is already held.
+ */ export function startWorkbenchRemoteCoordinator(options) {
+    const { httpHost, port, server } = options;
+    const lock = acquireWorkbenchLock({
+        host: httpHost || 'localhost',
+        port
+    });
+    if (!lock) {
+        const existing = readWorkbenchLock();
+        devDebug('Workbench lock already held by pid %d on port %d; bridging the registry without claiming it', existing?.pid, existing?.port);
+    }
+    const detachBridge = attachViteDevServerBridge(server);
+    return {
+        close: async ()=>{
+            detachBridge();
+            lock?.release();
+        }
+    };
+}
+/**
+ * Start the workbench dev server when federation is enabled and the workbench
+ * package is available. If the desired port is already taken — by another
+ * workbench instance or an unrelated process — fall back to running without a
+ * workbench and let the app/studio dev server claim the configured port.
+ */ export async function startWorkbenchDevServer(options) {
+    const { cacheDir, cliConfig, httpHost, httpPort: workbenchPort, output, reactStrictMode, workDir } = options;
+    // Workbench is opted into solely by calling `unstable_defineApp`.
+    if (!isWorkbenchApp(cliConfig?.app)) {
+        devDebug('Not a workbench app, skipping workbench dev server');
+        return {
+            close: noop,
+            httpHost,
+            workbenchAvailable: false,
+            workbenchPort
+        };
+    }
+    let workbenchAvailable = false;
+    try {
+        await resolveLocalPackage('sanity/workbench', workDir);
+        workbenchAvailable = true;
+    } catch  {
+        devDebug('Workbench not available, skipping workbench dev server');
+    }
+    if (!workbenchAvailable) {
+        return {
+            close: noop,
+            httpHost,
+            workbenchAvailable,
+            workbenchPort
+        };
+    }
+    // Acquire an exclusive lock — only one workbench per machine.
+    // Uses O_EXCL which is atomic at the OS level, preventing races when
+    // multiple `sanity dev` processes start simultaneously (e.g. via turbo).
+    const workbenchLock = acquireWorkbenchLock({
+        host: httpHost || 'localhost',
+        port: workbenchPort
+    });
+    if (!workbenchLock) {
+        const existing = readWorkbenchLock();
+        devDebug('Workbench already running at pid %d on port %d, skipping', existing?.pid, existing?.port);
+        return {
+            close: noop,
+            httpHost: existing?.host ?? httpHost,
+            workbenchAvailable: true,
+            workbenchPort: existing?.port ?? workbenchPort
+        };
+    }
+    // The lock is already held; an exception here (runtime-file write failure,
+    // invalid remote URL) would otherwise leak it until the next acquire prunes
+    // the stale PID.
+    let result;
+    try {
+        result = await createWorkbenchViteServer({
+            cacheDir,
+            cliConfig,
+            httpHost,
+            output,
+            reactStrictMode,
+            workbenchPort,
+            workDir
+        });
+    } catch (err) {
+        workbenchLock.release();
+        throw err;
+    }
+    if (!result) {
+        workbenchLock.release();
+        return {
+            close: noop,
+            httpHost,
+            workbenchAvailable: false,
+            workbenchPort
+        };
+    }
+    const { actualPort, close } = result;
+    workbenchLock.updatePort(actualPort);
+    return {
+        close: async ()=>{
+            workbenchLock.release();
+            await close();
+        },
+        httpHost,
+        workbenchAvailable,
+        workbenchPort: actualPort
+    };
+}
+async function createWorkbenchViteServer(options) {
+    const { cacheDir, cliConfig, httpHost, output, reactStrictMode, workbenchPort, workDir } = options;
+    const remoteUrl = parseRemoteUrl(process.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL);
+    const organizationId = resolveOrganizationId(cliConfig);
+    devDebug('Writing workbench runtime files');
+    const root = await writeWorkbenchRuntime({
+        cwd: workDir,
+        organizationId,
+        reactStrictMode,
+        remoteUrl
+    });
+    const viteConfig = {
+        // Custom cache directory so sanity's vite cache doesn't conflict with local vite projects
+        cacheDir,
+        configFile: false,
+        define: {
+            __SANITY_STAGING__: process.env.SANITY_INTERNAL_ENV === 'staging',
+            'import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL': JSON.stringify(remoteUrl)
+        },
+        logLevel: 'warn',
+        mode: 'development',
+        optimizeDeps: {
+            // Exclude sanity/workbench (and its transitive dep @sanity/workbench)
+            // from dep pre-bundling so that `import.meta.hot` is available at
+            // runtime — pre-bundled modules do not receive Vite's HMR client
+            // injection, which causes the custom HMR events for local application
+            // discovery to silently not fire.
+            exclude: [
+                'sanity',
+                '@sanity/workbench'
+            ]
+        },
+        // viteReact looks inert here — it transforms none of the host's own modules —
+        // but it's load-bearing for the remotes. It serves the Fast Refresh runtime at
+        // /@react-refresh and injects the preamble that defines window.$RefreshReg$. The
+        // federated remotes loaded into this page are react-refresh transformed, so
+        // without the preamble they throw "can't detect preamble", and without the
+        // runtime their /@react-refresh import (wired by @module-federation/vite's
+        // remoteHmr) fails. Dropping it as dead code broke every panel; see #1262.
+        plugins: [
+            viteReact(),
+            ...remoteUrl ? [
+                remoteManifestPreloadHeaderPlugin(remoteUrl)
+            ] : []
+        ],
+        resolve: {
+            dedupe: [
+                'react',
+                'react-dom'
+            ]
+        },
+        root,
+        server: {
+            host: httpHost,
+            port: workbenchPort,
+            strictPort: false,
+            warmup: {
+                clientFiles: [
+                    './workbench.js'
+                ]
+            }
+        }
+    };
+    devDebug('Creating workbench vite server');
+    const server = await createServer(viteConfig);
+    try {
+        await server.listen();
+    } catch (err) {
+        await server.close();
+        output.warn(`Workbench dev server failed to start: ${err instanceof Error ? err.message : String(err)}`);
+        return undefined;
+    }
+    // Vite may have picked a different port if the desired one was occupied
+    const addr = server.httpServer?.address();
+    const actualPort = typeof addr === 'object' && addr ? addr.port : workbenchPort;
+    // Fire-and-forget: warm the workbench remote's Vite transform pipeline so
+    // the first browser request hits a pre-populated module graph.
+    if (remoteUrl) {
+        fetch(remoteUrl).then((r)=>r.body?.cancel()).catch(()=>{});
+        devDebug('Warming workbench remote at %s', remoteUrl);
+    }
+    const detachBridge = attachViteDevServerBridge(server);
+    return {
+        actualPort,
+        close: async ()=>{
+            detachBridge();
+            await server.close();
+        }
+    };
+}
+// Workbench is opted into via `unstable_defineApp`, which carries the
+// organization ID. Deliberately no fallback (e.g. resolving it from the
+// configured project): the lookup would need an authenticated user and an
+// API round-trip on every startup for something the opt-in already declares.
+const resolveOrganizationId = (cliConfig)=>{
+    if (cliConfig.app?.organizationId) {
+        return cliConfig.app.organizationId;
+    }
+    throw new Error('Workbench requires an organization ID. Pass "organizationId" to unstable_defineApp() in sanity.cli.ts.');
+};
+// Restricts protocol to http(s) so the URL is safe to interpolate into HTML
+// attributes and Link headers downstream.
+const remoteUrlSchema = z.url({
+    normalize: true,
+    protocol: /^https?$/
+});
+function parseRemoteUrl(value) {
+    if (!value) return undefined;
+    const result = remoteUrlSchema.safeParse(value);
+    if (!result.success) {
+        throw new Error(`Invalid SANITY_INTERNAL_WORKBENCH_REMOTE_URL: ${value} (must be an http(s) URL)`);
+    }
+    return result.data;
+}
+/**
+ * Sets a `Link: <remoteUrl>; rel=preload; as=fetch; crossorigin` response header
+ * on the index document so the browser can start fetching the Module Federation
+ * manifest as soon as response headers arrive — before HTML parsing reaches the
+ * in-head preconnect hint. `as=fetch` matches how the federation runtime later
+ * retrieves the JSON manifest, allowing the preload entry to satisfy that fetch.
+ */ function remoteManifestPreloadHeaderPlugin(remoteUrl) {
+    return {
+        apply: 'serve',
+        configureServer (server) {
+            server.middlewares.use((req, res, next)=>{
+                const pathname = (req.url || '/').split('?')[0];
+                if (pathname === '/' || pathname === '/index.html') {
+                    res.setHeader('Link', `<${remoteUrl}>; rel=preload; as=fetch; crossorigin`);
+                }
+                next();
+            });
+        },
+        name: 'sanity:workbench-remote-preload-header'
+    };
+}
+
+//# sourceMappingURL=startWorkbenchDevServer.js.map

package/dist/actions/dev/startWorkbenchDevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/dev/startWorkbenchDevServer.ts"],"sourcesContent":["import {\n  type CliConfig,\n  isWorkbenchApp,\n  type Output,\n  resolveLocalPackage,\n  subdebug,\n} from '@sanity/cli-core'\nimport viteReact from '@vitejs/plugin-react'\nimport {createServer, type InlineConfig, type Plugin, type ViteDevServer} from 'vite'\nimport {z} from 'zod/mini'\n\nimport {createInterfacesTracker} from './interfaceSetId.js'\nimport {\n  acquireWorkbenchLock,\n  type DevServerManifest,\n  getRegisteredServers,\n  readWorkbenchLock,\n  watchRegistry,\n} from './registry.js'\nimport {writeWorkbenchRuntime} from './writeWorkbenchRuntime.js'\n\nconst devDebug = subdebug('dev')\n\nconst noop = async () => {}\n\nconst toApplicationsPayload = (servers: DevServerManifest[]) => ({\n  applications: servers.map(({host, id, interfaces, manifest, port, projectId, type}) => ({\n    host,\n    id,\n    interfaces,\n    manifest,\n    port,\n    projectId,\n    type,\n  })),\n})\n\n/**\n * Bridge the dev-server registry into a workbench Vite server's HMR channel so\n * the page tracks apps as they come and go. A changed interface set means a\n * rebuilt remote — full-reload to drop the stale remote-entry; otherwise\n * rebroadcast for a soft reconcile. Returns a detach fn.\n */\nfunction attachViteDevServerBridge(server: ViteDevServer): () => void {\n  server.ws.on('sanity:workbench:get-local-applications', (_, client) => {\n    client.send(\n      'sanity:workbench:local-applications',\n      toApplicationsPayload(getRegisteredServers()),\n    )\n  })\n\n  const setTracker = createInterfacesTracker()\n  const registryWatcher = watchRegistry((servers) => {\n    if (setTracker.hasChanged(servers)) {\n      server.ws.send({type: 'full-reload'})\n      return\n    }\n    server.ws.send('sanity:workbench:local-applications', toApplicationsPayload(servers))\n  })\n\n  return () => registryWatcher.close()\n}\n\n/**\n * Make the workbench remote act as the machine's workbench: claim the singleton\n * lock so app `sanity dev`s register into it instead of each starting their own,\n * and bridge the registry so the remote shows the local apps. No-op lock if one\n * is already held.\n */\nexport function startWorkbenchRemoteCoordinator(options: {\n  httpHost: string | undefined\n  port: number\n  server: ViteDevServer\n}): {close: () => Promise<void>} {\n  const {httpHost, port, server} = options\n\n  const lock = acquireWorkbenchLock({host: httpHost || 'localhost', port})\n  if (!lock) {\n    const existing = readWorkbenchLock()\n    devDebug(\n      'Workbench lock already held by pid %d on port %d; bridging the registry without claiming it',\n      existing?.pid,\n      existing?.port,\n    )\n  }\n\n  const detachBridge = attachViteDevServerBridge(server)\n\n  return {\n    close: async () => {\n      detachBridge()\n      lock?.release()\n    },\n  }\n}\n\ninterface WorkbenchDevServerResult {\n  close: () => Promise<void>\n  httpHost: string | undefined\n  workbenchAvailable: boolean\n  workbenchPort: number\n}\n\nexport interface StartWorkbenchOptions {\n  /** Dependency-cache dir for the workbench Vite server, kept apart from the user's own. */\n  cacheDir: string\n  cliConfig: CliConfig\n  httpHost: string | undefined\n  httpPort: number\n  output: Output\n  /** Wrap the workbench in React StrictMode; the CLI resolves it (unset collapses to `false`). */\n  reactStrictMode: boolean\n  workDir: string\n}\n\n/**\n * Start the workbench dev server when federation is enabled and the workbench\n * package is available. If the desired port is already taken — by another\n * workbench instance or an unrelated process — fall back to running without a\n * workbench and let the app/studio dev server claim the configured port.\n */\nexport async function startWorkbenchDevServer(\n  options: StartWorkbenchOptions,\n): Promise<WorkbenchDevServerResult> {\n  const {\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort: workbenchPort,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  // Workbench is opted into solely by calling `unstable_defineApp`.\n  if (!isWorkbenchApp(cliConfig?.app)) {\n    devDebug('Not a workbench app, skipping workbench dev server')\n    return {close: noop, httpHost, workbenchAvailable: false, workbenchPort}\n  }\n\n  let workbenchAvailable = false\n\n  try {\n    await resolveLocalPackage('sanity/workbench', workDir)\n    workbenchAvailable = true\n  } catch {\n    devDebug('Workbench not available, skipping workbench dev server')\n  }\n\n  if (!workbenchAvailable) {\n    return {close: noop, httpHost, workbenchAvailable, workbenchPort}\n  }\n\n  // Acquire an exclusive lock — only one workbench per machine.\n  // Uses O_EXCL which is atomic at the OS level, preventing races when\n  // multiple `sanity dev` processes start simultaneously (e.g. via turbo).\n  const workbenchLock = acquireWorkbenchLock({host: httpHost || 'localhost', port: workbenchPort})\n  if (!workbenchLock) {\n    const existing = readWorkbenchLock()\n    devDebug(\n      'Workbench already running at pid %d on port %d, skipping',\n      existing?.pid,\n      existing?.port,\n    )\n    return {\n      close: noop,\n      httpHost: existing?.host ?? httpHost,\n      workbenchAvailable: true,\n      workbenchPort: existing?.port ?? workbenchPort,\n    }\n  }\n\n  // The lock is already held; an exception here (runtime-file write failure,\n  // invalid remote URL) would otherwise leak it until the next acquire prunes\n  // the stale PID.\n  let result: Awaited<ReturnType<typeof createWorkbenchViteServer>>\n  try {\n    result = await createWorkbenchViteServer({\n      cacheDir,\n      cliConfig,\n      httpHost,\n      output,\n      reactStrictMode,\n      workbenchPort,\n      workDir,\n    })\n  } catch (err) {\n    workbenchLock.release()\n    throw err\n  }\n\n  if (!result) {\n    workbenchLock.release()\n    return {close: noop, httpHost, workbenchAvailable: false, workbenchPort}\n  }\n\n  const {actualPort, close} = result\n  workbenchLock.updatePort(actualPort)\n\n  return {\n    close: async () => {\n      workbenchLock.release()\n      await close()\n    },\n    httpHost,\n    workbenchAvailable,\n    workbenchPort: actualPort,\n  }\n}\n\ninterface CreateWorkbenchViteServerOptions {\n  cacheDir: string\n  cliConfig: CliConfig\n  httpHost: string | undefined\n  output: Output\n  reactStrictMode: boolean\n  workbenchPort: number\n  workDir: string\n}\n\ninterface CreateWorkbenchViteServerResult {\n  actualPort: number\n  close: () => Promise<void>\n}\n\nasync function createWorkbenchViteServer(\n  options: CreateWorkbenchViteServerOptions,\n): Promise<CreateWorkbenchViteServerResult | undefined> {\n  const {cacheDir, cliConfig, httpHost, output, reactStrictMode, workbenchPort, workDir} = options\n\n  const remoteUrl = parseRemoteUrl(process.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL)\n\n  const organizationId = resolveOrganizationId(cliConfig)\n\n  devDebug('Writing workbench runtime files')\n  const root = await writeWorkbenchRuntime({\n    cwd: workDir,\n    organizationId,\n    reactStrictMode,\n    remoteUrl,\n  })\n\n  const viteConfig: InlineConfig = {\n    // Custom cache directory so sanity's vite cache doesn't conflict with local vite projects\n    cacheDir,\n    configFile: false,\n    define: {\n      __SANITY_STAGING__: process.env.SANITY_INTERNAL_ENV === 'staging',\n      'import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL': JSON.stringify(remoteUrl),\n    },\n    logLevel: 'warn',\n    mode: 'development',\n    optimizeDeps: {\n      // Exclude sanity/workbench (and its transitive dep @sanity/workbench)\n      // from dep pre-bundling so that `import.meta.hot` is available at\n      // runtime — pre-bundled modules do not receive Vite's HMR client\n      // injection, which causes the custom HMR events for local application\n      // discovery to silently not fire.\n      exclude: ['sanity', '@sanity/workbench'],\n    },\n    // viteReact looks inert here — it transforms none of the host's own modules —\n    // but it's load-bearing for the remotes. It serves the Fast Refresh runtime at\n    // /@react-refresh and injects the preamble that defines window.$RefreshReg$. The\n    // federated remotes loaded into this page are react-refresh transformed, so\n    // without the preamble they throw \"can't detect preamble\", and without the\n    // runtime their /@react-refresh import (wired by @module-federation/vite's\n    // remoteHmr) fails. Dropping it as dead code broke every panel; see #1262.\n    plugins: [viteReact(), ...(remoteUrl ? [remoteManifestPreloadHeaderPlugin(remoteUrl)] : [])],\n    resolve: {dedupe: ['react', 'react-dom']},\n    root,\n    server: {\n      host: httpHost,\n      port: workbenchPort,\n      strictPort: false,\n      warmup: {\n        clientFiles: ['./workbench.js'],\n      },\n    },\n  }\n\n  devDebug('Creating workbench vite server')\n  const server = await createServer(viteConfig)\n  try {\n    await server.listen()\n  } catch (err) {\n    await server.close()\n    output.warn(\n      `Workbench dev server failed to start: ${err instanceof Error ? err.message : String(err)}`,\n    )\n    return undefined\n  }\n\n  // Vite may have picked a different port if the desired one was occupied\n  const addr = server.httpServer?.address()\n  const actualPort = typeof addr === 'object' && addr ? addr.port : workbenchPort\n\n  // Fire-and-forget: warm the workbench remote's Vite transform pipeline so\n  // the first browser request hits a pre-populated module graph.\n  if (remoteUrl) {\n    fetch(remoteUrl)\n      .then((r) => r.body?.cancel())\n      .catch(() => {})\n    devDebug('Warming workbench remote at %s', remoteUrl)\n  }\n\n  const detachBridge = attachViteDevServerBridge(server)\n\n  return {\n    actualPort,\n    close: async () => {\n      detachBridge()\n      await server.close()\n    },\n  }\n}\n\n// Workbench is opted into via `unstable_defineApp`, which carries the\n// organization ID. Deliberately no fallback (e.g. resolving it from the\n// configured project): the lookup would need an authenticated user and an\n// API round-trip on every startup for something the opt-in already declares.\nconst resolveOrganizationId = (cliConfig: CliConfig): string => {\n  if (cliConfig.app?.organizationId) {\n    return cliConfig.app.organizationId\n  }\n\n  throw new Error(\n    'Workbench requires an organization ID. Pass \"organizationId\" to unstable_defineApp() in sanity.cli.ts.',\n  )\n}\n\n// Restricts protocol to http(s) so the URL is safe to interpolate into HTML\n// attributes and Link headers downstream.\nconst remoteUrlSchema = z.url({normalize: true, protocol: /^https?$/})\n\nfunction parseRemoteUrl(value: string | undefined): string | undefined {\n  if (!value) return undefined\n\n  const result = remoteUrlSchema.safeParse(value)\n\n  if (!result.success) {\n    throw new Error(\n      `Invalid SANITY_INTERNAL_WORKBENCH_REMOTE_URL: ${value} (must be an http(s) URL)`,\n    )\n  }\n\n  return result.data\n}\n\n/**\n * Sets a `Link: <remoteUrl>; rel=preload; as=fetch; crossorigin` response header\n * on the index document so the browser can start fetching the Module Federation\n * manifest as soon as response headers arrive — before HTML parsing reaches the\n * in-head preconnect hint. `as=fetch` matches how the federation runtime later\n * retrieves the JSON manifest, allowing the preload entry to satisfy that fetch.\n */\nfunction remoteManifestPreloadHeaderPlugin(remoteUrl: string): Plugin {\n  return {\n    apply: 'serve',\n    configureServer(server) {\n      server.middlewares.use((req, res, next) => {\n        const pathname = (req.url || '/').split('?')[0]\n        if (pathname === '/' || pathname === '/index.html') {\n          res.setHeader('Link', `<${remoteUrl}>; rel=preload; as=fetch; crossorigin`)\n        }\n        next()\n      })\n    },\n    name: 'sanity:workbench-remote-preload-header',\n  }\n}\n"],"names":["isWorkbenchApp","resolveLocalPackage","subdebug","viteReact","createServer","z","createInterfacesTracker","acquireWorkbenchLock","getRegisteredServers","readWorkbenchLock","watchRegistry","writeWorkbenchRuntime","devDebug","noop","toApplicationsPayload","servers","applications","map","host","id","interfaces","manifest","port","projectId","type","attachViteDevServerBridge","server","ws","on","_","client","send","setTracker","registryWatcher","hasChanged","close","startWorkbenchRemoteCoordinator","options","httpHost","lock","existing","pid","detachBridge","release","startWorkbenchDevServer","cacheDir","cliConfig","httpPort","workbenchPort","output","reactStrictMode","workDir","app","workbenchAvailable","workbenchLock","result","createWorkbenchViteServer","err","actualPort","updatePort","remoteUrl","parseRemoteUrl","process","env","SANITY_INTERNAL_WORKBENCH_REMOTE_URL","organizationId","resolveOrganizationId","root","cwd","viteConfig","configFile","define","__SANITY_STAGING__","SANITY_INTERNAL_ENV","JSON","stringify","logLevel","mode","optimizeDeps","exclude","plugins","remoteManifestPreloadHeaderPlugin","resolve","dedupe","strictPort","warmup","clientFiles","listen","warn","Error","message","String","undefined","addr","httpServer","address","fetch","then","r","body","cancel","catch","remoteUrlSchema","url","normalize","protocol","value","safeParse","success","data","apply","configureServer","middlewares","use","req","res","next","pathname","split","setHeader","name"],"mappings":"AAAA,SAEEA,cAAc,EAEdC,mBAAmB,EACnBC,QAAQ,QACH,mBAAkB;AACzB,OAAOC,eAAe,uBAAsB;AAC5C,SAAQC,YAAY,QAA2D,OAAM;AACrF,SAAQC,CAAC,QAAO,WAAU;AAE1B,SAAQC,uBAAuB,QAAO,sBAAqB;AAC3D,SACEC,oBAAoB,EAEpBC,oBAAoB,EACpBC,iBAAiB,EACjBC,aAAa,QACR,gBAAe;AACtB,SAAQC,qBAAqB,QAAO,6BAA4B;AAEhE,MAAMC,WAAWV,SAAS;AAE1B,MAAMW,OAAO,WAAa;AAE1B,MAAMC,wBAAwB,CAACC,UAAkC,CAAA;QAC/DC,cAAcD,QAAQE,GAAG,CAAC,CAAC,EAACC,IAAI,EAAEC,EAAE,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,IAAI,EAAEC,SAAS,EAAEC,IAAI,EAAC,GAAM,CAAA;gBACtFN;gBACAC;gBACAC;gBACAC;gBACAC;gBACAC;gBACAC;YACF,CAAA;IACF,CAAA;AAEA;;;;;CAKC,GACD,SAASC,0BAA0BC,MAAqB;IACtDA,OAAOC,EAAE,CAACC,EAAE,CAAC,2CAA2C,CAACC,GAAGC;QAC1DA,OAAOC,IAAI,CACT,uCACAjB,sBAAsBN;IAE1B;IAEA,MAAMwB,aAAa1B;IACnB,MAAM2B,kBAAkBvB,cAAc,CAACK;QACrC,IAAIiB,WAAWE,UAAU,CAACnB,UAAU;YAClCW,OAAOC,EAAE,CAACI,IAAI,CAAC;gBAACP,MAAM;YAAa;YACnC;QACF;QACAE,OAAOC,EAAE,CAACI,IAAI,CAAC,uCAAuCjB,sBAAsBC;IAC9E;IAEA,OAAO,IAAMkB,gBAAgBE,KAAK;AACpC;AAEA;;;;;CAKC,GACD,OAAO,SAASC,gCAAgCC,OAI/C;IACC,MAAM,EAACC,QAAQ,EAAEhB,IAAI,EAAEI,MAAM,EAAC,GAAGW;IAEjC,MAAME,OAAOhC,qBAAqB;QAACW,MAAMoB,YAAY;QAAahB;IAAI;IACtE,IAAI,CAACiB,MAAM;QACT,MAAMC,WAAW/B;QACjBG,SACE,+FACA4B,UAAUC,KACVD,UAAUlB;IAEd;IAEA,MAAMoB,eAAejB,0BAA0BC;IAE/C,OAAO;QACLS,OAAO;YACLO;YACAH,MAAMI;QACR;IACF;AACF;AAqBA;;;;;CAKC,GACD,OAAO,eAAeC,wBACpBP,OAA8B;IAE9B,MAAM,EACJQ,QAAQ,EACRC,SAAS,EACTR,QAAQ,EACRS,UAAUC,aAAa,EACvBC,MAAM,EACNC,eAAe,EACfC,OAAO,EACR,GAAGd;IAEJ,kEAAkE;IAClE,IAAI,CAACrC,eAAe8C,WAAWM,MAAM;QACnCxC,SAAS;QACT,OAAO;YAACuB,OAAOtB;YAAMyB;YAAUe,oBAAoB;YAAOL;QAAa;IACzE;IAEA,IAAIK,qBAAqB;IAEzB,IAAI;QACF,MAAMpD,oBAAoB,oBAAoBkD;QAC9CE,qBAAqB;IACvB,EAAE,OAAM;QACNzC,SAAS;IACX;IAEA,IAAI,CAACyC,oBAAoB;QACvB,OAAO;YAAClB,OAAOtB;YAAMyB;YAAUe;YAAoBL;QAAa;IAClE;IAEA,8DAA8D;IAC9D,qEAAqE;IACrE,yEAAyE;IACzE,MAAMM,gBAAgB/C,qBAAqB;QAACW,MAAMoB,YAAY;QAAahB,MAAM0B;IAAa;IAC9F,IAAI,CAACM,eAAe;QAClB,MAAMd,WAAW/B;QACjBG,SACE,4DACA4B,UAAUC,KACVD,UAAUlB;QAEZ,OAAO;YACLa,OAAOtB;YACPyB,UAAUE,UAAUtB,QAAQoB;YAC5Be,oBAAoB;YACpBL,eAAeR,UAAUlB,QAAQ0B;QACnC;IACF;IAEA,2EAA2E;IAC3E,4EAA4E;IAC5E,iBAAiB;IACjB,IAAIO;IACJ,IAAI;QACFA,SAAS,MAAMC,0BAA0B;YACvCX;YACAC;YACAR;YACAW;YACAC;YACAF;YACAG;QACF;IACF,EAAE,OAAOM,KAAK;QACZH,cAAcX,OAAO;QACrB,MAAMc;IACR;IAEA,IAAI,CAACF,QAAQ;QACXD,cAAcX,OAAO;QACrB,OAAO;YAACR,OAAOtB;YAAMyB;YAAUe,oBAAoB;YAAOL;QAAa;IACzE;IAEA,MAAM,EAACU,UAAU,EAAEvB,KAAK,EAAC,GAAGoB;IAC5BD,cAAcK,UAAU,CAACD;IAEzB,OAAO;QACLvB,OAAO;YACLmB,cAAcX,OAAO;YACrB,MAAMR;QACR;QACAG;QACAe;QACAL,eAAeU;IACjB;AACF;AAiBA,eAAeF,0BACbnB,OAAyC;IAEzC,MAAM,EAACQ,QAAQ,EAAEC,SAAS,EAAER,QAAQ,EAAEW,MAAM,EAAEC,eAAe,EAAEF,aAAa,EAAEG,OAAO,EAAC,GAAGd;IAEzF,MAAMuB,YAAYC,eAAeC,QAAQC,GAAG,CAACC,oCAAoC;IAEjF,MAAMC,iBAAiBC,sBAAsBpB;IAE7ClC,SAAS;IACT,MAAMuD,OAAO,MAAMxD,sBAAsB;QACvCyD,KAAKjB;QACLc;QACAf;QACAU;IACF;IAEA,MAAMS,aAA2B;QAC/B,0FAA0F;QAC1FxB;QACAyB,YAAY;QACZC,QAAQ;YACNC,oBAAoBV,QAAQC,GAAG,CAACU,mBAAmB,KAAK;YACxD,wDAAwDC,KAAKC,SAAS,CAACf;QACzE;QACAgB,UAAU;QACVC,MAAM;QACNC,cAAc;YACZ,sEAAsE;YACtE,kEAAkE;YAClE,iEAAiE;YACjE,sEAAsE;YACtE,kCAAkC;YAClCC,SAAS;gBAAC;gBAAU;aAAoB;QAC1C;QACA,8EAA8E;QAC9E,+EAA+E;QAC/E,iFAAiF;QACjF,4EAA4E;QAC5E,2EAA2E;QAC3E,2EAA2E;QAC3E,2EAA2E;QAC3EC,SAAS;YAAC7E;eAAiByD,YAAY;gBAACqB,kCAAkCrB;aAAW,GAAG,EAAE;SAAE;QAC5FsB,SAAS;YAACC,QAAQ;gBAAC;gBAAS;aAAY;QAAA;QACxChB;QACAzC,QAAQ;YACNR,MAAMoB;YACNhB,MAAM0B;YACNoC,YAAY;YACZC,QAAQ;gBACNC,aAAa;oBAAC;iBAAiB;YACjC;QACF;IACF;IAEA1E,SAAS;IACT,MAAMc,SAAS,MAAMtB,aAAaiE;IAClC,IAAI;QACF,MAAM3C,OAAO6D,MAAM;IACrB,EAAE,OAAO9B,KAAK;QACZ,MAAM/B,OAAOS,KAAK;QAClBc,OAAOuC,IAAI,CACT,CAAC,sCAAsC,EAAE/B,eAAegC,QAAQhC,IAAIiC,OAAO,GAAGC,OAAOlC,MAAM;QAE7F,OAAOmC;IACT;IAEA,wEAAwE;IACxE,MAAMC,OAAOnE,OAAOoE,UAAU,EAAEC;IAChC,MAAMrC,aAAa,OAAOmC,SAAS,YAAYA,OAAOA,KAAKvE,IAAI,GAAG0B;IAElE,0EAA0E;IAC1E,+DAA+D;IAC/D,IAAIY,WAAW;QACboC,MAAMpC,WACHqC,IAAI,CAAC,CAACC,IAAMA,EAAEC,IAAI,EAAEC,UACpBC,KAAK,CAAC,KAAO;QAChBzF,SAAS,kCAAkCgD;IAC7C;IAEA,MAAMlB,eAAejB,0BAA0BC;IAE/C,OAAO;QACLgC;QACAvB,OAAO;YACLO;YACA,MAAMhB,OAAOS,KAAK;QACpB;IACF;AACF;AAEA,sEAAsE;AACtE,wEAAwE;AACxE,0EAA0E;AAC1E,6EAA6E;AAC7E,MAAM+B,wBAAwB,CAACpB;IAC7B,IAAIA,UAAUM,GAAG,EAAEa,gBAAgB;QACjC,OAAOnB,UAAUM,GAAG,CAACa,cAAc;IACrC;IAEA,MAAM,IAAIwB,MACR;AAEJ;AAEA,4EAA4E;AAC5E,0CAA0C;AAC1C,MAAMa,kBAAkBjG,EAAEkG,GAAG,CAAC;IAACC,WAAW;IAAMC,UAAU;AAAU;AAEpE,SAAS5C,eAAe6C,KAAyB;IAC/C,IAAI,CAACA,OAAO,OAAOd;IAEnB,MAAMrC,SAAS+C,gBAAgBK,SAAS,CAACD;IAEzC,IAAI,CAACnD,OAAOqD,OAAO,EAAE;QACnB,MAAM,IAAInB,MACR,CAAC,8CAA8C,EAAEiB,MAAM,yBAAyB,CAAC;IAErF;IAEA,OAAOnD,OAAOsD,IAAI;AACpB;AAEA;;;;;;CAMC,GACD,SAAS5B,kCAAkCrB,SAAiB;IAC1D,OAAO;QACLkD,OAAO;QACPC,iBAAgBrF,MAAM;YACpBA,OAAOsF,WAAW,CAACC,GAAG,CAAC,CAACC,KAAKC,KAAKC;gBAChC,MAAMC,WAAW,AAACH,CAAAA,IAAIX,GAAG,IAAI,GAAE,EAAGe,KAAK,CAAC,IAAI,CAAC,EAAE;gBAC/C,IAAID,aAAa,OAAOA,aAAa,eAAe;oBAClDF,IAAII,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE3D,UAAU,qCAAqC,CAAC;gBAC5E;gBACAwD;YACF;QACF;QACAI,MAAM;IACR;AACF"}

package/dist/actions/dev/writeWorkbenchRuntime.js

@@ -0,0 +1,67 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { subdebug } from '@sanity/cli-core';
+const devDebug = subdebug('dev');
+const workbenchJsTemplate = `\
+// This file is auto-generated on 'sanity dev'
+// Modifications to this file are automatically discarded
+import {renderWorkbench} from "sanity/workbench"
+
+renderWorkbench(
+  document.getElementById("workbench"),
+  {organizationId: %SANITY_WORKBENCH_ORGANIZATION_ID%},
+  {reactStrictMode: %SANITY_WORKBENCH_REACT_STRICT_MODE%}
+)
+`;
+const indexHtmlTemplate = `\
+<!DOCTYPE html>
+<!-- This file is auto-generated on 'sanity dev' -->
+<!-- Modifications to this file are automatically discarded -->
+<html>
+  <head>
+    <meta charset="UTF-8" />
+%SANITY_WORKBENCH_PREFETCH_HINTS%
+  </head>
+  <body>
+    <div id="workbench"></div>
+    <script type="module" src="./workbench.js"></script>
+  </body>
+</html>
+`;
+/**
+ * Generates the `.sanity/workbench` directory with static entry files for
+ * the workbench Vite dev server.
+ *
+ * @param cwd - Current working directory (Sanity root dir)
+ * @returns The absolute path to the written workbench runtime directory
+ * @internal
+ */ export async function writeWorkbenchRuntime(options) {
+    const { cwd, organizationId, reactStrictMode, remoteUrl } = options;
+    const workbenchDir = path.join(cwd, '.sanity', 'workbench');
+    const workbenchJs = workbenchJsTemplate.replace(/%SANITY_WORKBENCH_ORGANIZATION_ID%/, organizationId === undefined ? 'undefined' : JSON.stringify(organizationId)).replace(/%SANITY_WORKBENCH_REACT_STRICT_MODE%/, JSON.stringify(reactStrictMode));
+    const prefetchHints = buildPrefetchHints(remoteUrl);
+    const indexHtml = indexHtmlTemplate.replace(/%SANITY_WORKBENCH_PREFETCH_HINTS%/, prefetchHints);
+    devDebug('Making workbench runtime directory');
+    await fs.mkdir(workbenchDir, {
+        recursive: true
+    });
+    devDebug('Writing workbench.js to workbench runtime directory');
+    await fs.writeFile(path.join(workbenchDir, 'workbench.js'), workbenchJs);
+    devDebug('Writing index.html to workbench runtime directory');
+    await fs.writeFile(path.join(workbenchDir, 'index.html'), indexHtml);
+    return workbenchDir;
+}
+function buildPrefetchHints(remoteUrl) {
+    if (!remoteUrl) return '';
+    try {
+        const url = new URL(remoteUrl);
+        return [
+            `    <link rel="preconnect" href="${url.origin}" />`,
+            `    <link rel="preload" as="fetch" href="${url.toString()}" crossorigin />`
+        ].join('\n');
+    } catch  {
+        return '';
+    }
+}
+
+//# sourceMappingURL=writeWorkbenchRuntime.js.map

package/dist/actions/dev/writeWorkbenchRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/dev/writeWorkbenchRuntime.ts"],"sourcesContent":["import fs from 'node:fs/promises'\nimport path from 'node:path'\n\nimport {subdebug} from '@sanity/cli-core'\n\nconst devDebug = subdebug('dev')\n\nconst workbenchJsTemplate = `\\\n// This file is auto-generated on 'sanity dev'\n// Modifications to this file are automatically discarded\nimport {renderWorkbench} from \"sanity/workbench\"\n\nrenderWorkbench(\n  document.getElementById(\"workbench\"),\n  {organizationId: %SANITY_WORKBENCH_ORGANIZATION_ID%},\n  {reactStrictMode: %SANITY_WORKBENCH_REACT_STRICT_MODE%}\n)\n`\n\nconst indexHtmlTemplate = `\\\n<!DOCTYPE html>\n<!-- This file is auto-generated on 'sanity dev' -->\n<!-- Modifications to this file are automatically discarded -->\n<html>\n  <head>\n    <meta charset=\"UTF-8\" />\n%SANITY_WORKBENCH_PREFETCH_HINTS%\n  </head>\n  <body>\n    <div id=\"workbench\"></div>\n    <script type=\"module\" src=\"./workbench.js\"></script>\n  </body>\n</html>\n`\n\n/**\n * Generates the `.sanity/workbench` directory with static entry files for\n * the workbench Vite dev server.\n *\n * @param cwd - Current working directory (Sanity root dir)\n * @returns The absolute path to the written workbench runtime directory\n * @internal\n */\nexport async function writeWorkbenchRuntime(options: {\n  cwd: string\n  organizationId?: string\n  reactStrictMode: boolean\n  remoteUrl?: string\n}): Promise<string> {\n  const {cwd, organizationId, reactStrictMode, remoteUrl} = options\n  const workbenchDir = path.join(cwd, '.sanity', 'workbench')\n\n  const workbenchJs = workbenchJsTemplate\n    .replace(\n      /%SANITY_WORKBENCH_ORGANIZATION_ID%/,\n      organizationId === undefined ? 'undefined' : JSON.stringify(organizationId),\n    )\n    .replace(/%SANITY_WORKBENCH_REACT_STRICT_MODE%/, JSON.stringify(reactStrictMode))\n\n  const prefetchHints = buildPrefetchHints(remoteUrl)\n\n  const indexHtml = indexHtmlTemplate.replace(/%SANITY_WORKBENCH_PREFETCH_HINTS%/, prefetchHints)\n\n  devDebug('Making workbench runtime directory')\n  await fs.mkdir(workbenchDir, {recursive: true})\n\n  devDebug('Writing workbench.js to workbench runtime directory')\n  await fs.writeFile(path.join(workbenchDir, 'workbench.js'), workbenchJs)\n\n  devDebug('Writing index.html to workbench runtime directory')\n  await fs.writeFile(path.join(workbenchDir, 'index.html'), indexHtml)\n\n  return workbenchDir\n}\n\nfunction buildPrefetchHints(remoteUrl: string | undefined): string {\n  if (!remoteUrl) return ''\n\n  try {\n    const url = new URL(remoteUrl)\n    return [\n      `    <link rel=\"preconnect\" href=\"${url.origin}\" />`,\n      `    <link rel=\"preload\" as=\"fetch\" href=\"${url.toString()}\" crossorigin />`,\n    ].join('\\n')\n  } catch {\n    return ''\n  }\n}\n"],"names":["fs","path","subdebug","devDebug","workbenchJsTemplate","indexHtmlTemplate","writeWorkbenchRuntime","options","cwd","organizationId","reactStrictMode","remoteUrl","workbenchDir","join","workbenchJs","replace","undefined","JSON","stringify","prefetchHints","buildPrefetchHints","indexHtml","mkdir","recursive","writeFile","url","URL","origin","toString"],"mappings":"AAAA,OAAOA,QAAQ,mBAAkB;AACjC,OAAOC,UAAU,YAAW;AAE5B,SAAQC,QAAQ,QAAO,mBAAkB;AAEzC,MAAMC,WAAWD,SAAS;AAE1B,MAAME,sBAAsB,CAAC;;;;;;;;;;AAU7B,CAAC;AAED,MAAMC,oBAAoB,CAAC;;;;;;;;;;;;;;AAc3B,CAAC;AAED;;;;;;;CAOC,GACD,OAAO,eAAeC,sBAAsBC,OAK3C;IACC,MAAM,EAACC,GAAG,EAAEC,cAAc,EAAEC,eAAe,EAAEC,SAAS,EAAC,GAAGJ;IAC1D,MAAMK,eAAeX,KAAKY,IAAI,CAACL,KAAK,WAAW;IAE/C,MAAMM,cAAcV,oBACjBW,OAAO,CACN,sCACAN,mBAAmBO,YAAY,cAAcC,KAAKC,SAAS,CAACT,iBAE7DM,OAAO,CAAC,wCAAwCE,KAAKC,SAAS,CAACR;IAElE,MAAMS,gBAAgBC,mBAAmBT;IAEzC,MAAMU,YAAYhB,kBAAkBU,OAAO,CAAC,qCAAqCI;IAEjFhB,SAAS;IACT,MAAMH,GAAGsB,KAAK,CAACV,cAAc;QAACW,WAAW;IAAI;IAE7CpB,SAAS;IACT,MAAMH,GAAGwB,SAAS,CAACvB,KAAKY,IAAI,CAACD,cAAc,iBAAiBE;IAE5DX,SAAS;IACT,MAAMH,GAAGwB,SAAS,CAACvB,KAAKY,IAAI,CAACD,cAAc,eAAeS;IAE1D,OAAOT;AACT;AAEA,SAASQ,mBAAmBT,SAA6B;IACvD,IAAI,CAACA,WAAW,OAAO;IAEvB,IAAI;QACF,MAAMc,MAAM,IAAIC,IAAIf;QACpB,OAAO;YACL,CAAC,iCAAiC,EAAEc,IAAIE,MAAM,CAAC,IAAI,CAAC;YACpD,CAAC,yCAAyC,EAAEF,IAAIG,QAAQ,GAAG,gBAAgB,CAAC;SAC7E,CAACf,IAAI,CAAC;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workbench-cli",
-  "version": "1.1.0-beta.0",
+  "version": "1.1.1",
   "description": "Internal implementation detail of the Sanity CLI's unstable workbench support. Not intended for direct use.",
   "homepage": "https://github.com/sanity-io/cli",
   "bugs": "https://github.com/sanity-io/cli/issues",
@@ -44,6 +44,31 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@module-federation/vite": "1.16.11",
+    "@vitejs/plugin-react": "^6.0.3",
+    "vite": "^8.1.0",
+    "zod": "^4.4.3",
+    "@sanity/cli-core": "^2.1.1"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.1.0",
+    "@sanity/pkg-utils": "^10.5.8",
+    "@swc/cli": "^0.8.1",
+    "@swc/core": "^1.15.41",
+    "@types/node": "^22.20.0",
+    "@vitest/coverage-istanbul": "^4.1.9",
+    "eslint": "^10.4.1",
+    "publint": "^0.3.21",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.9",
+    "@repo/package.config": "0.0.1",
+    "@repo/tsconfig": "3.70.0",
+    "@sanity/eslint-config-cli": "^1.1.2"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
   "scripts": {
     "build": "swc --delete-dir-on-start --strip-leading-paths --out-dir dist/ src --ignore '**/*.test.ts' --ignore '**/__tests__/**'",
     "build:types": "pkg-utils build --emitDeclarationOnly",
@@ -55,29 +80,5 @@
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "watch": "swc --delete-dir-on-start --strip-leading-paths --out-dir dist/ --watch src"
-  },
-  "dependencies": {
-    "@module-federation/vite": "1.16.0",
-    "@sanity/cli-core": "workspace:^",
-    "vite": "catalog:",
-    "zod": "catalog:"
-  },
-  "devDependencies": {
-    "@eslint/compat": "catalog:",
-    "@repo/package.config": "workspace:*",
-    "@repo/tsconfig": "workspace:*",
-    "@sanity/eslint-config-cli": "workspace:^",
-    "@sanity/pkg-utils": "catalog:",
-    "@swc/cli": "catalog:",
-    "@swc/core": "catalog:",
-    "@types/node": "catalog:",
-    "@vitest/coverage-istanbul": "catalog:",
-    "eslint": "catalog:",
-    "publint": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
-  },
-  "engines": {
-    "node": ">=22.12"
   }
-}
+}